graph_view
Render a scoped epistemic subgraph from the particle store by subject, query, inconsistency, or manifest section, with confidence, contested badges, and as-of visibility computed at render time.
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 is a relative name under the engine's
``graph.manifest_root``; with that unset the scope is refused.
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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "graph_view"
}
}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 | |||