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