@devframes/plugin-inspect 0.9.8 → 0.9.9

package/README.md

@@ -7,8 +7,8 @@
 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
+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
@@ -21,7 +21,7 @@ framework-neutral client (`connectDevframe`, `rpc.sharedState`) with a Vue + Vit
 pnpx @devframes/plugin-inspect
 ```
 
-Opens the inspector against a fresh standalone devframe connection — useful as a
+Opens 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
@@ -56,7 +56,7 @@ All functions are namespaced `devframes:plugin:inspect:*`:
 | `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. |
+| `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

package/dist/cli.d.mts

@@ -1,7 +1,7 @@
 import { CacHandle } from "devframe/adapters/cac";
 //#region src/cli.d.ts
 /**
- * Build the standalone CLI for the inspector — backs the package `bin`
+ * Build the standalone CLI for the inspector; backs the package `bin`
  * (`devframe-inspect`) and `pnpx @devframes/plugin-inspect`. Wraps the
  * default {@link createInspectDevframe} definition with devframe's
  * `dev` / `build` / `mcp` command shell.

package/dist/cli.mjs

@@ -1,8 +1,8 @@
-import { t as createInspectDevframe } from "./src-DM5I2krP.mjs";
+import { t as createInspectDevframe } from "./src-CrLV9vzl.mjs";
 import { createCac } from "devframe/adapters/cac";
 //#region src/cli.ts
 /**
-* Build the standalone CLI for the inspector — backs the package `bin`
+* Build the standalone CLI for the inspector; backs the package `bin`
 * (`devframe-inspect`) and `pnpx @devframes/plugin-inspect`. Wraps the
 * default {@link createInspectDevframe} definition with devframe's
 * `dev` / `build` / `mcp` command shell.

package/dist/client/index.d.mts

@@ -1,4 +1,4 @@
-import { a as RpcFunctionAgentInfo, i as InvokeResult, n as DevframeInspectCommandInfo, o as RpcFunctionInfo, r as DevframeInspectInstanceInfo, t as AgentManifest } from "../types-CiRcsiuh.mjs";
+import { a as RpcFunctionAgentInfo, i as InvokeResult, n as DevframeInspectCommandInfo, o as RpcFunctionInfo, r as DevframeInspectInstanceInfo, t as AgentManifest } from "../types-DS3xLMMU.mjs";
 import { DevframeConnectionStatus, DevframeRpcClient, DevframeRpcClientOptions } from "devframe/client";
 //#region src/client/index.d.ts
 /**

package/dist/{index-BeAbhMoX.d.mts → index-DhCFtfqC.d.mts}

@@ -1,4 +1,4 @@
-import "./types-CiRcsiuh.mjs";
+import "./types-DS3xLMMU.mjs";
 import { DevframeDefinition } from "devframe";
 //#region src/index.d.ts
 interface InspectDevframeOptions {
@@ -17,7 +17,7 @@ interface InspectDevframeOptions {
   port?: number;
   /**
    * Require the trust handshake on the standalone server. Enabled by
-   * default — `--open` embeds the current OTP in the opened URL, so the
+   * default; `--open` embeds the current OTP in the opened URL, so the
    * tab authenticates automatically without extra prompts. Hosted adapters
    * manage their own auth and ignore this.
    */

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-import { i as InvokeResult, o as RpcFunctionInfo } from "./types-CiRcsiuh.mjs";
-import { n as createInspectDevframe, t as InspectDevframeOptions } from "./index-BeAbhMoX.mjs";
+import { i as InvokeResult, o as RpcFunctionInfo } from "./types-DS3xLMMU.mjs";
+import { n as createInspectDevframe, t as InspectDevframeOptions } from "./index-DhCFtfqC.mjs";
 export { InspectDevframeOptions, type InvokeResult, type RpcFunctionInfo, createInspectDevframe, createInspectDevframe as default };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { t as createInspectDevframe } from "./src-DM5I2krP.mjs";
+import { t as createInspectDevframe } from "./src-CrLV9vzl.mjs";
 export { createInspectDevframe, createInspectDevframe as default };

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-import { t as serverFunctions } from "../rpc-IoEVPxbU.mjs";
+import { t as serverFunctions } from "../rpc-CiPeBIvA.mjs";
 //#region src/node/index.ts
 /**
 * Register the inspector's introspection RPC functions on a devframe

package/dist/rpc/index.d.mts

@@ -1,5 +1,5 @@
-import { i as InvokeResult, n as DevframeInspectCommandInfo, o as RpcFunctionInfo, r as DevframeInspectInstanceInfo } from "../types-CiRcsiuh.mjs";
-import "../index-BeAbhMoX.mjs";
+import { i as InvokeResult, n as DevframeInspectCommandInfo, o as RpcFunctionInfo, r as DevframeInspectInstanceInfo } from "../types-DS3xLMMU.mjs";
+import "../index-DhCFtfqC.mjs";
 import { RpcDefinitionsToFunctions } from "devframe/rpc";
 //#region src/rpc/index.d.ts
 /**

package/dist/rpc/index.mjs

@@ -1,2 +1,2 @@
-import { t as serverFunctions } from "../rpc-IoEVPxbU.mjs";
+import { t as serverFunctions } from "../rpc-CiPeBIvA.mjs";
 export { serverFunctions };

package/dist/{rpc-IoEVPxbU.mjs → rpc-CiPeBIvA.mjs}

@@ -43,15 +43,15 @@ const diagnostics = defineDiagnostics({
 	docsBase: "https://devfra.me/errors",
 	codes: {
 		DP_INSPECT_0001: {
-			why: (p) => `Cannot invoke "${p.name}" — no RPC function with that name is registered on this connection.`,
+			why: (p) => `Cannot invoke "${p.name}": no RPC function with that name is registered on this connection.`,
 			fix: "Call `devframes:plugin:inspect:list-functions` to see the registered names, or check for a typo."
 		},
 		DP_INSPECT_0002: {
-			why: (p) => `Refusing to invoke "${p.name}" — only read-only "query" and "static" functions are invokable from the inspector, but this one is "${p.type}".`,
+			why: (p) => `Refusing to invoke "${p.name}": only read-only "query" and "static" functions are invokable from the inspector, but this one is "${p.type}".`,
 			fix: "The inspector deliberately blocks `action`/`event` functions to avoid triggering side effects. Invoke those through their own UI instead."
 		},
 		DP_INSPECT_0003: {
-			why: (p) => `Cannot execute command "${p.id}" — this connection has no hub commands host.`,
+			why: (p) => `Cannot execute command "${p.id}": this connection has no hub commands host.`,
 			fix: "Commands are a `@devframes/hub` feature. Mount this devframe inside a hub that registers commands via `ctx.commands.register()`, or check `devframes:plugin:inspect:list-commands` (returns an empty list outside a hub)."
 		}
 	}
@@ -76,7 +76,7 @@ function resolveHubCommands(ctx) {
 * serializable shape the inspector sends over RPC, recursing into
 * children. `hasHandler` survives the projection even though the hub's
 * own `commands.list()` strips `handler` entirely before it's callable
-* from here — reading the raw command straight off `host.commands`
+* from here; reading the raw command straight off `host.commands`
 * preserves that flag.
 */
 function projectCommand(cmd) {
@@ -95,7 +95,7 @@ function projectCommand(cmd) {
 /**
 * Execute a hub command by id and return a result envelope, mirroring
 * `devframes:plugin:inspect:invoke`. Unlike that function, this one is not
-* gated to read-only types — a command is, by construction, something a
+* gated to read-only types, since a command is, by construction, something a
 * user explicitly runs (unlike an arbitrary RPC `action`, which may be a
 * side effect the inspector shouldn't fire unprompted).
 *
@@ -137,7 +137,7 @@ const INVOKABLE_TYPES$1 = /* @__PURE__ */ new Set(["query", "static"]);
 /**
 * Invoke a read-only RPC function by name and return a result envelope.
 *
-* Deliberately gated to `query` / `static` functions — `action` and
+* Deliberately gated to `query` / `static` functions, because `action` and
 * `event` functions may carry side effects, so the inspector refuses to
 * fire them (`DP_INSPECT_0002`). Uses structured-clone serialization
 * (default) so arbitrary return values round-trip without the strict-JSON
@@ -205,9 +205,9 @@ const invokeAgentTool = defineInspectRpc({
 //#endregion
 //#region src/rpc/functions/list-commands.ts
 /**
-* Enumerate every command registered on the hub's commands host — id,
+* Enumerate every command registered on the hub's commands host (id,
 * title, description, icon, category, whether it carries its own handler,
-* and nested children — when this connection is mounted inside a hub
+* and nested children) when this connection is mounted inside a hub
 * (`@devframes/hub`). Returns an empty list on a plain devframe connection,
 * so the inspector's Commands tab degrades gracefully rather than erroring.
 * `snapshot: true` bakes the (possibly empty) list into the static dump so
@@ -242,7 +242,7 @@ const FALLBACK_SCHEMA = Object.freeze({
 * Uses the schema's own [Standard JSON Schema](https://standardschema.dev/)
 * converter (`~standard.jsonSchema`, implemented by e.g. zod 4) when the
 * validator provides one, and degrades to a permissive object schema
-* otherwise (e.g. valibot, which has no native converter) — so introspection
+* otherwise (e.g. valibot, which has no native converter), so introspection
 * never throws and never pulls in a converter library for a validator devframe
 * doesn't otherwise depend on.
 */
@@ -290,7 +290,7 @@ const listFunctions = defineInspectRpc({
 	jsonSerializable: true,
 	snapshot: true,
 	agent: {
-		description: "List every RPC function registered on this devframe connection, with metadata (name, type, JSON-serializable/snapshot flags, args/return schema, agent exposure). Read-only — the canonical way to discover what the running devframe can do.",
+		description: "List every RPC function registered on this devframe connection, with metadata (name, type, JSON-serializable/snapshot flags, args/return schema, agent exposure). Read-only, the canonical way to discover what the running devframe can do.",
 		title: "List RPC functions"
 	},
 	setup: (ctx) => ({ handler: async () => {
@@ -330,11 +330,11 @@ const listFunctions = defineInspectRpc({
 /**
 * Enumerate every devframe dev server currently running on this machine,
 * discovered through the shared instance registry (`~/.devframe/instances/`)
-* with a `__connection.json` liveness probe — the same discovery that backs
+* with a `__connection.json` liveness probe, the same discovery that backs
 * the `devframe connect` bin. Powers the inspector's read-only Instances tab.
 *
 * Deliberately **not** `snapshot` (the set of live processes is meaningless
-* baked into a static dump — the Instances tab is hidden in `build`/`spa`
+* baked into a static dump, so the Instances tab is hidden in `build`/`spa`
 * mode) and **not** agent-exposed (the `devframe connect` bin already offers
 * instance discovery to agents over MCP, so exposing it here would duplicate
 * that surface).

package/dist/{src-DM5I2krP.mjs → src-CrLV9vzl.mjs}

@@ -2,12 +2,12 @@ import { setupInspect } from "./node/index.mjs";
 import { defineDevframe } from "devframe";
 //#region package.json
 var name = "@devframes/plugin-inspect";
-var version = "0.9.8";
+var version = "0.9.9";
 var description = "Devframe plugin that inspects the RPC registry, shared state, and agent surface of a connection.";
 var homepage = "https://github.com/devframes/devframe#readme";
 //#endregion
 //#region src/index.ts
-/** Default devframe id — drives the hosted mount path `/__<id>/`. */
+/** Default devframe id, driving the hosted mount path `/__<id>/`. */
 const DEFAULT_ID = "devframes_plugin_inspect";
 const distDir = {
 	package: `${name}--assets`,
@@ -37,6 +37,11 @@ function createInspectDevframe(options = {}) {
 			command: id,
 			port: options.port ?? 9012,
 			distDir,
+			/**
+			* Gate the standalone server by default; `maybeOpenBrowser` folds the
+			* current OTP into the `--open` URL so the tab lands already trusted.
+			* Hosted adapters (Vite/hub) supply their own auth layer and ignore this.
+			*/
 			auth: options.auth ?? true
 		},
 		dock: { category: "~builtin" },

package/dist/{types-CiRcsiuh.d.mts → types-DS3xLMMU.d.mts}

@@ -14,14 +14,14 @@ interface RpcFunctionAgentInfo {
 }
 /**
  * Serializable description of a single registered RPC function. Returned
- * by `devframes:plugin:inspect:list-functions`. JSON-safe by construction
- * — Standard Schema args/return schemas are projected to JSON Schema (best
+ * by `devframes:plugin:inspect:list-functions`. JSON-safe by construction:
+ * Standard Schema args/return schemas are projected to JSON Schema (best
  * effort), never sent as live objects.
  */
 interface RpcFunctionInfo {
   /** Full namespaced function name (e.g. `my-plugin:do-thing`). */
   name: string;
-  /** Function type — `query`, `static`, `action`, or `event`. */
+  /** Function type: `query`, `static`, `action`, or `event`. */
   type: 'query' | 'static' | 'action' | 'event';
   /** Whether args/return are declared strictly JSON-serializable. */
   jsonSerializable: boolean;
@@ -52,7 +52,7 @@ interface RpcFunctionInfo {
  * Serializable projection of a single command registered on a hub's
  * commands host (`DevframeServerCommandEntry`/`DevframeCommandBase` in
  * `@devframes/hub`), returned by `devframes:plugin:inspect:list-commands`.
- * Populated only when this connection is mounted inside a hub — a plain
+ * Populated only when this connection is mounted inside a hub; a plain
  * devframe connection (no hub) returns an empty list.
  */
 interface DevframeInspectCommandInfo {
@@ -74,7 +74,7 @@ interface DevframeInspectCommandInfo {
 /**
  * Serializable projection of a single running devframe instance discovered
  * in the machine-wide instance registry (`~/.devframe/instances/`), returned
- * by `devframes:plugin:inspect:list-instances`. A live, node-only view — the
+ * by `devframes:plugin:inspect:list-instances`. A live, node-only view; the
  * inspector's Instances tab renders these as a read-only directory of the
  * other devframes running alongside this one.
  */
@@ -89,7 +89,7 @@ interface DevframeInspectInstanceInfo {
   origin: string;
   /** Base path the devframe is mounted at (trailing slash). */
   basePath: string;
-  /** Full SPA URL (`origin` + `basePath`) — the link the tab opens. */
+  /** Full SPA URL (`origin` + `basePath`), the link the tab opens. */
   url: string;
   /** Process id of the instance's dev server. */
   pid: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/plugin-inspect",
   "type": "module",
-  "version": "0.9.8",
+  "version": "0.9.9",
   "description": "Devframe plugin that inspects the RPC registry, shared state, and agent surface of a connection.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -36,8 +36,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/plugin-inspect--assets": "0.9.8",
-    "devframe": "0.9.8",
+    "@devframes/plugin-inspect--assets": "0.9.9",
+    "devframe": "0.9.9",
     "vite": "^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
@@ -53,9 +53,9 @@
   },
   "devDependencies": {
     "@antfu/design": "^0.4.0",
-    "@devframes/hub": "0.9.8",
-    "@devframes/plugin-inspect--assets": "0.9.8",
-    "@devframes/vite": "0.9.8",
+    "@devframes/hub": "0.9.9",
+    "@devframes/plugin-inspect--assets": "0.9.9",
+    "@devframes/vite": "0.9.9",
     "@iconify-json/ph": "^1.2.2",
     "@standard-schema/spec": "^1.1.0",
     "@storybook/addon-docs": "^10.5.10",
@@ -63,7 +63,7 @@
     "@unocss/preset-icons": "^66.8.1",
     "@vitejs/plugin-vue": "^6.0.8",
     "colorjs.io": "^0.7.1",
-    "devframe": "0.9.8",
+    "devframe": "0.9.9",
     "floating-vue": "^5.2.2",
     "h3": "^2.0.1-rc.29",
     "reka-ui": "^2.10.4",