How harsh-sharma-2002/agentic-harnesss works
Agent Harness accepts natural-language requests through a Streamlit UI or HTTP API, routes them through a shared Base Agent, and returns a unified answer. Specialized execution stays in private graphs: Text2SQL checks cached schema, discovers missing metadata, validates and executes SQL, verifies results, then produces a grounded response; Web Search performs a single search and summarizes results. Shared LLM and event modules support reasoning and runtime visibility. The README documents the major SQL stages and UI-to-API flow; unsampled internals are represented at their source directories, and no unshown implementation details are assumed.
Main entry points: graph.py SQL execution graph · call_llm.py Shared LLM · orchestrator_node.py Intent router · handoff_node.py Agent handoff
Components 28
User interfaces
- Streamlit UI
ui/streamlit_app.py - FastAPI service
src/api/app.py - Query endpoint
src/api/routes/query.py - HTTP contracts
src/api/models.py
Request orchestration
- Base graph
src/agents/base/base_agent/graph.py - Intent router
src/agents/base/base_agent/nodes/orchestrator_node.py - Agent handoff
src/agents/base/base_agent/nodes/handoff_node.py - Global request state
src/agents/base/base_agent/state.py
Text2SQL agent
- SQL execution graph
src/agents/text2sql/sql_agent/graph.py - Private SQL state
src/agents/text2sql/sql_agent/state.py - Schema context check
src/agents/text2sql/sql_agent/nodes/context_check.py - Schema registry
src/agents/text2sql/sql_agent/nodes/load_registry_node.py - Schema discovery
src/agents/text2sql/sql_agent/nodes/discovery_node.py - Registry update
src/agents/text2sql/sql_agent/nodes/update_registry_node.py - SQL reasoner
src/agents/text2sql/sql_agent/nodes/sql_reasoner_node.py - SQL validator
src/agents/text2sql/sql_agent/nodes/validator_node.py - SQL executor
src/agents/text2sql/sql_agent/nodes/executor_node.py - Result verifier
src/agents/text2sql/sql_agent/nodes/verifier_node.py - Grounded response
src/agents/text2sql/sql_agent/nodes/response_node.py
Web search agent
- Web agent graph
src/agents/web_search/web_agent/graph.py - Search operation
src/agents/web_search/web_agent/nodes/search_node.py - Search response
src/agents/web_search/web_agent/nodes/response_node.py
Shared runtime
- Shared LLM
src/agents/core/call_llm.py - Execution events
src/core/events.py
Other components
- User
- Application database
- Web search service
- Ollama model
Connections 37
- User → Streamlit UI: submits request
- Streamlit UI → FastAPI service: sends HTTP
- User → FastAPI service: submits query
- FastAPI service → Query endpoint: mounts router
src/api/app.py - Query endpoint → HTTP contracts: uses contracts
src/api/routes/query.py - Query endpoint → Base graph: invokes graph
src/api/routes/query.py - Base graph → Intent router: runs routing node
src/agents/base/base_agent/graph.py - Base graph → Agent handoff: runs handoff node
src/agents/base/base_agent/graph.py - Intent router → Shared LLM: classifies request
src/agents/base/base_agent/nodes/orchestrator_node.py - Intent router → Global request state: updates routing state
src/agents/base/base_agent/nodes/orchestrator_node.py - Agent handoff → SQL execution graph: dispatches SQL
src/agents/base/base_agent/nodes/handoff_node.py - Agent handoff → Web agent graph: dispatches search
src/agents/base/base_agent/nodes/handoff_node.py - Agent handoff → Global request state: translates public result
src/agents/base/base_agent/nodes/handoff_node.py - SQL execution graph → Schema context check: checks schema context
- SQL execution graph → Schema registry: loads and updates
src/agents/text2sql/sql_agent/graph.py - SQL execution graph → Schema discovery: discovers missing schema
src/agents/text2sql/sql_agent/graph.py - SQL execution graph → Registry update: persists schema knowledge
src/agents/text2sql/sql_agent/graph.py - SQL execution graph → SQL reasoner: reasons over request
src/agents/text2sql/sql_agent/graph.py - SQL execution graph → SQL validator: validates candidate SQL
- SQL execution graph → SQL executor: executes validated SQL
src/agents/text2sql/sql_agent/graph.py - SQL execution graph → Result verifier: verifies results
- SQL execution graph → Grounded response: generates final answer
src/agents/text2sql/sql_agent/graph.py - SQL executor → Application database: runs SQL
src/agents/text2sql/sql_agent/nodes/executor_node.py - Schema context check → Shared LLM: assesses sufficiency
src/agents/text2sql/sql_agent/nodes/context_check.py - Schema discovery → Shared LLM: plans discovery
src/agents/text2sql/sql_agent/nodes/discovery_node.py - SQL reasoner → Shared LLM: proposes SQL
src/agents/text2sql/sql_agent/nodes/sql_reasoner_node.py - Grounded response → Shared LLM: composes response
src/agents/text2sql/sql_agent/nodes/response_node.py - Web agent graph → Search operation: runs search node
src/agents/web_search/web_agent/graph.py - Web agent graph → Search response: runs response node
src/agents/web_search/web_agent/graph.py - Search operation → Shared LLM: forms search query
src/agents/web_search/web_agent/nodes/search_node.py - Search operation → Web search service: searches web
src/agents/web_search/web_agent/nodes/search_node.py - Search response → Shared LLM: summarizes results
src/agents/web_search/web_agent/nodes/response_node.py - Shared LLM → Ollama model: invokes model
src/agents/core/call_llm.py - FastAPI service → Execution events: emits lifecycle events
src/api/app.py - Intent router → Execution events: emits routing events
src/agents/base/base_agent/nodes/orchestrator_node.py - SQL executor → Execution events: emits execution events
src/agents/text2sql/sql_agent/nodes/executor_node.py - Search operation → Execution events: emits search events
src/agents/web_search/web_agent/nodes/search_node.py