mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-04-26 17:06:22 +02:00
Refactor agent provenance so that the decision (thought + tool selection) and the result (observation) are separate DAG entities: Question ← Analysis+ToolUse ← Observation ← ... ← Conclusion Analysis gains tg:ToolUse as a mixin RDF type and is emitted before tool execution via an on_action callback in react(). This ensures sub-traces (e.g. GraphRAG) appear after their parent Analysis in the streaming event order. Observation becomes a standalone prov:Entity with tg:Observation type, emitted after tool execution. The linear DAG chain runs through Observation — subsequent iterations and the Conclusion derive from it, not from the Analysis. message_id is populated on streaming AgentResponse for thought and observation chunks, using the provenance URI of the entity being built. This lets clients group streamed chunks by entity. Wire changes: - provenance/agent.py: Add ToolUse type, new agent_observation_triples(), remove observation from iteration - agent_manager.py: Add on_action callback between reason() and tool execution - orchestrator/pattern_base.py: Split emit, wire message_id, chain through observation URIs - orchestrator/react_pattern.py: Emit Analysis via on_action before tool runs - agent/react/service.py: Same for non-orchestrator path - api/explainability.py: New Observation class, updated dispatch and chain walker - api/types.py: Add message_id to AgentThought/AgentObservation - cli: Render Observation separately, [analysis: tool] labels |
||
|---|---|---|
| .. | ||
| __init__.py | ||
| conftest.py | ||
| test_agent_service_non_streaming.py | ||
| test_agent_step_arguments.py | ||
| test_aggregator.py | ||
| test_completion_dispatch.py | ||
| test_conversation_state.py | ||
| test_explainability_parsing.py | ||
| test_mcp_tool_auth.py | ||
| test_meta_router.py | ||
| test_pattern_base_subagent.py | ||
| test_provenance_triples.py | ||
| test_react_processor.py | ||
| test_reasoning_engine.py | ||
| test_tool_coordination.py | ||
| test_tool_filter.py | ||
| test_tool_service.py | ||
| test_tool_service_lifecycle.py | ||