graph_view
Render a scoped epistemic subgraph from a particle store to inspect subject neighborhoods, query hits, contradictions, or manifest sections with render-time confidence and provenance.
Instructions
Render one scoped epistemic subgraph of the particle store.
Scope is mandatory — pass exactly one of ``subject_id`` / ``query`` /
``inconsistency_id`` / ``manifest``+``section`` (a whole-store render
does not exist; the anti-hairball invariant). Every
epistemic quantity in the result (effective confidence, contested
badges, as-of visibility, utility evidence) is computed at render time
by the engine and never stored.
Args:
subject_id: Neighbourhood scope — this Subject, its particles, and
subjects reachable within ``hops`` via multi-subject particles.
Accepts a subject id or an exact (case-insensitive) canonical
name / alias; the render's ``scope_ref`` is the resolved id.
query: Retrieval-set scope — the top-K hits of the existing query
ranking rendered as their subjects plus the hit particles
("the picture of the knowledge the agent consulted").
inconsistency_id: Evidence scope — a contradiction's
picture: the INCONSISTENCY particle as the anchor, its two
disputant beliefs shown with their true statuses (the
quarantined side included), their subjects and sources. Accepts
a full particle id or a unique prefix (a contested badge's
``inconsistency_id`` is the usual source).
manifest: With ``section``, projection scope — an
manifest section's deterministic selection rendered as
a graph. The manifest path resolves on the engine host.
section: The manifest section's ``region`` id, or its exact
(case-insensitive) title.
hops: Neighbourhood radius for subject scope (clamped to
``graph.max_hops``).
history: Also include retired supersession-chain ancestors, rendered
as ghosts.
as_of: ISO-8601 past instant (a bare date means start of that day,
UTC): render the graph as believed at T. A future
instant is rejected.
max_nodes: Per-call node cap (clamped to ``graph.max_nodes``).
store: Store handle to render from; ``"default"`` is the
canonical store.
all_projects: On a server bound to one project, render from
the whole store instead of that project's view. The result says so.
No effect on an unbound server.
Returns:
The ``GraphData`` render as JSON — ``nodes`` (subjects with display
aggregates), ``edges`` (multi-subject particles), ``particles``
(per-particle epistemics payloads keyed by id), ``supersessions``,
the ``census``, and human-readable ``disclosures`` for any cap that
bound. When ``engine.base_url`` is configured, a ``url`` field
additionally deep-links the same scope on the unified web UI
(``/app#/browse?…``) so the operator can open the
interactive picture — the default stdio install has no HTTP server,
so the field is additive, never assumed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hops | No | ||
| as_of | No | ||
| query | No | ||
| store | No | default | |
| history | No | ||
| section | No | ||
| manifest | No | ||
| max_nodes | No | ||
| subject_id | No | ||
| all_projects | No | ||
| inconsistency_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||