@devframes/plugin-inspect
Experimental This devframe is experimental and may change without a major version bump until it stabilizes.
A built-in devframe that inspects its own connection (and, when mounted in a
hub, the hub's): browse every registered RPC function with its metadata,
invoke read-only query/static functions and inspect the results, watch
shared-state keys update live, explore the agent-exposed API, and (while
running against a live backend) list the other devframe dev servers running
alongside it.
Ported in spirit from the RPC & State panels of
vitejs/devtools; rebuilt on devframe's
framework-neutral client (connectDevframe, rpc.sharedState) with a Vue + Vite SPA.
Use it standalone
pnpx @devframes/plugin-inspectOpens the inspector against a fresh standalone devframe connection, useful as a reference and for poking at the introspection RPCs themselves.
Mount into a Vite host
// vite.config.ts
import createInspectDevframe from '@devframes/plugin-inspect'
import { devframeVite } from '@devframes/vite/single'
import { defineConfig } from 'vite'
export default defineConfig({
plugins: [
devframeVite(createInspectDevframe()),
],
})Programmatic
import { createInspectDevframe } from '@devframes/plugin-inspect'
const devframe = createInspectDevframe({ port: 9100 })RPC
All functions are namespaced devframes:plugin:inspect:*:
| Function | Type | What it returns |
|---|---|---|
list-functions |
query (snapshot) |
Every registered RPC function with metadata (type, JSON-serializable/snapshot flags, args/return JSON Schema, agent exposure). |
invoke |
action |
Invokes a read-only query/static function by name and returns a result envelope. Refuses action/event functions. |
list-state-keys |
query (snapshot) |
The keys of every shared-state entry on the connection. |
describe-agent |
query (snapshot) |
The agent manifest: tools and readable resources. |
list-instances |
query (live) |
Every devframe dev server currently running on the machine, discovered through the shared instance registry. Powers the read-only Instances tab. |
The three snapshot query functions are agent-exposed (read-only) and bake into
the static dump, so the inspector still lists functions, state keys, and the
agent-exposed API when deployed as a static SPA. list-instances is live rather
than baked (the set of running processes is meaningless in a static dump), so
the Instances tab appears only against a live backend.