trustgraph/tests/unit/test_gateway
Cyber MacGeddon 2e83413cbe Add agent explainability instrumentation and unify envelope field naming
Addresses recommendations from the UX developer's agent experience report.
Adds provenance predicates, DAG structure changes, error resilience, and
a published OWL ontology.

Explainability additions:

- Tool candidates: tg:toolCandidate on Analysis events lists the tools
  visible to the LLM for each iteration (names only, descriptions in config)
- Termination reason: tg:terminationReason on Conclusion/Synthesis events
  (final-answer, plan-complete, subagents-complete)
- Step counter: tg:stepNumber on iteration events
- Pattern decision: new tg:PatternDecision entity in the DAG between
  session and first iteration, carrying tg:pattern and tg:taskType
- Latency: tg:llmDurationMs on Analysis events, tg:toolDurationMs on
  Observation events
- Token counts on events: tg:inToken/tg:outToken/tg:llmModel on
  Grounding, Focus, Synthesis, and Analysis events
- Tool/parse errors: tg:toolError on Observation events with tg:Error
  mixin type. Parse failures return as error observations instead of
  crashing the agent, giving it a chance to retry.

Envelope unification:

- Rename chunk_type to message_type across AgentResponse schema,
  translator, SDK types, socket clients, CLI, and all tests.
  Agent and RAG services now both use message_type on the wire.

Ontology:

- specs/ontology/trustgraph.ttl — OWL vocabulary covering all 26 classes,
  7 object properties, and 36+ datatype properties including new predicates.

DAG structure tests:

- tests/unit/test_provenance/test_dag_structure.py verifies the
  wasDerivedFrom chain for GraphRAG, DocumentRAG, and all three agent
  patterns (react, plan, supervisor) including the pattern-decision link.
2026-04-13 16:12:45 +01:00
..
test_auth.py Test suite executed from CI pipeline (#433) 2025-07-14 14:57:44 +01:00
test_config_receiver.py Refactor: Derive consumer behaviour from queue class (#772) 2026-04-09 09:55:41 +01:00
test_core_import_export_roundtrip.py Fix Metadata/EntityEmbeddings schema migration tail and add regression tests (#777) 2026-04-10 20:43:45 +01:00
test_dispatch_config.py Pub/sub abstraction: decouple from Pulsar (#751) 2026-04-01 20:16:53 +01:00
test_dispatch_manager.py fix: prevent duplicate dispatcher creation race condition in invoke_global_service (#715) 2026-04-06 11:14:32 +01:00
test_dispatch_mux.py Fix websocket error responses in Mux dispatcher (#726) 2026-03-28 10:58:28 +00:00
test_dispatch_requestor.py Fix tests (#593) 2025-12-19 08:53:21 +00:00
test_dispatch_sender.py Fix tests (#593) 2025-12-19 08:53:21 +00:00
test_dispatch_serialize.py Changed schema for Value -> Term, majorly breaking change (#622) 2026-01-27 13:48:08 +00:00
test_endpoint_constant.py Test suite executed from CI pipeline (#433) 2025-07-14 14:57:44 +01:00
test_endpoint_manager.py Test suite executed from CI pipeline (#433) 2025-07-14 14:57:44 +01:00
test_endpoint_metrics.py Test suite executed from CI pipeline (#433) 2025-07-14 14:57:44 +01:00
test_endpoint_socket.py Fix import export graceful shutdown (#476) 2025-08-28 13:39:28 +01:00
test_endpoint_stream.py Test suite executed from CI pipeline (#433) 2025-07-14 14:57:44 +01:00
test_endpoint_variable.py Test suite executed from CI pipeline (#433) 2025-07-14 14:57:44 +01:00
test_entity_contexts_import_dispatcher.py Fix Metadata/EntityEmbeddings schema migration tail and add regression tests (#777) 2026-04-10 20:43:45 +01:00
test_explain_triples.py Add agent explainability instrumentation and unify envelope field naming 2026-04-13 16:12:45 +01:00
test_graph_embeddings_import_dispatcher.py Fix Metadata/EntityEmbeddings schema migration tail and add regression tests (#777) 2026-04-10 20:43:45 +01:00
test_rows_import_dispatcher.py Remove redundant metadata (#685) 2026-03-11 10:51:39 +00:00
test_running.py Test suite executed from CI pipeline (#433) 2025-07-14 14:57:44 +01:00
test_service.py Fix Metadata/EntityEmbeddings schema migration tail and add regression tests (#777) 2026-04-10 20:43:45 +01:00
test_socket_graceful_shutdown.py Fix test async warnings (#601) 2026-01-06 22:09:34 +00:00
test_streaming_translators.py Pub/sub abstraction: decouple from Pulsar (#751) 2026-04-01 20:16:53 +01:00
test_text_document_translator.py Pub/sub abstraction: decouple from Pulsar (#751) 2026-04-01 20:16:53 +01:00