cordis-plugin-graph

A DSH / Cordis Web plugin that adds a Plugin graph tab to
Settings → Plugins, next to Plugin list. It renders a live, zoomable
Cytoscape graph of the running Cordis runtime —
including what a static package graph can't show: which provider actually
resolved each inject, what's disabled, and tool calls flowing through in
real time.

What you see

Two planes (toggle: client / host / both):

• client — the renderer Cordis context, inspected in-process: every
  dsh-client-ui-* plugin, the slot renderer, connection, theme, locale,
  settings.
• host — the engine context (sessions, agents, tools, model adapters,
  persistence), polled from a same-origin route the host half serves. Falls
  back gracefully to client-only where no web server is reachable (packaged
  desktop, headless).

Nodes = plugin fibers, coloured by lifecycle phase
(active / pending / loading / failed / unloading / disposed) plus
disabled for a Loader row turned off — so the graph shows the whole
composition, not only what's running. Size scales with services provided.

Edges, individually toggleable:

• requires (inject) — a fiber's hard inject, drawn to the fiber that
  actually resolved it.
• provides to — the reverse.
• nested in (Loader tree) — Loader-tree parent (composition / inheritance).

Runtime activity — while the host plane is shown, a live feed of the last
tool executions (from a tools/result subscription), and the tool node pulses
on each call. Run an agent task and watch it move through the graph.

Click a node → module specifier, Loader entry id, provided services, live
effect labels. Search by name/module. Recapture after a live enable/disable.

Install

dsh plugin add cordis-plugin-graph

Restart the Host; the tab appears under Settings → Plugins. See
install/INSTALL.md for GitHub / local-dir installs
and ACRYL Desktop.

Portability

Uses only upstream primitives — settings.plugins.tab, the public
@deepseek-ai/cordis context API, and (optionally) tools + webServer
scoped injects that degrade independently. Works in any web-profile
deployment: ACRYL or stock DSH Desktop.

The renderer-plane inspection walk (src/inspect.ts) started as a trimmed
port of acryl-desktop's plugin-architecture-inspector.ts — pure
@deepseek-ai/cordis public API.

Build

pnpm install
pnpm run build      # lib/index.js + lib/inspect.js (host), lib/client.js (browser, cytoscape bundled)
pnpm run check      # build + typecheck + tests

License

MIT