devframe 0.9.4 → 0.9.5

package/dist/{_shared-BPovvJW8.d.mts → _shared-CsBsnhuO.d.mts}

@@ -1,4 +1,4 @@
-import { F as DevframeDefinition, G as McpRouteOptions, I as DevframeDeploymentKind, t as ConnectionMeta } from "./context-_i51nYOs.mjs";
+import { F as DevframeDefinition, G as McpRouteOptions, I as DevframeDeploymentKind, t as ConnectionMeta } from "./context-c0OlSc12.mjs";
 //#region src/adapters/_shared.d.ts
 /**
  * Resolve the mount base path for a devframe's SPA. Hosted adapters

package/dist/adapters/build.d.mts

@@ -1,5 +1,5 @@
-import { F as DevframeDefinition, V as DevframeSnapshotRpcEntry, o as DevframeNodeContext } from "../context-_i51nYOs.mjs";
-import { o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
+import { F as DevframeDefinition, V as DevframeSnapshotRpcEntry, o as DevframeNodeContext } from "../context-c0OlSc12.mjs";
+import { o as StaticAssetsSource } from "../remote-assets-B13_vRkJ.mjs";
 //#region src/adapters/build.d.ts
 interface CreateBuildOptions {
   /** Output directory. Defaults to `dist-static`. */
@@ -7,8 +7,9 @@ interface CreateBuildOptions {
   /**
    * Override the SPA dist to copy into `outDir` — a local directory or a
    * remote-assets declaration (materialized in full at build time). When
-   * omitted the adapter reads `devframe.cli?.distDir` — authors typically
-   * set this once on the definition itself.
+   * omitted the adapter reads `devframe.clientAssets` (or the deprecated
+   * `devframe.cli?.distDir`) — authors typically set this once on the
+   * definition itself.
    */
   distDir?: StaticAssetsSource;
   /**

package/dist/adapters/build.mjs

@@ -1,10 +1,11 @@
 import { s as colors } from "../nostics-CzECRXpE.mjs";
 import { n as strictJsonStringify } from "../serialization-BGzEwAdr.mjs";
+import { resolveClientAssets } from "../index.mjs";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
 import { t as collectStaticRpcDump } from "../static-DV_qUSRS.mjs";
 import { n as structuredCloneStringify } from "../structured-clone-CbAV5rFI.mjs";
 import { t as diagnostics } from "../diagnostics-BXWW3VK-.mjs";
-import { t as createHostContext } from "../context-CQW0lSw8.mjs";
+import { t as createHostContext } from "../context-Bc5S40Qt.mjs";
 import { t as resolveStaticAssetsSource } from "../remote-assets-DezQmPQU.mjs";
 import { t as createH3DevframeHost } from "../host-h3-fRbF9yor.mjs";
 import process from "node:process";
@@ -26,8 +27,8 @@ import fs$1 from "node:fs/promises";
 async function createBuild(d, options = {}) {
 	if (d.capabilities?.build === false && !options.force) throw diagnostics.DF0042({ id: d.id });
 	const outDir = resolve(options.outDir ?? "dist-static");
-	const distSource = options.distDir ?? d.cli?.distDir;
-	if (!distSource) throw new Error(`[devframe] createBuild: no distDir for "${d.id}". Set \`cli.distDir\` on the definition or pass it as an option.`);
+	const distSource = options.distDir ?? resolveClientAssets(d);
+	if (!distSource) throw new Error(`[devframe] createBuild: no client assets for "${d.id}". Set \`clientAssets\` on the definition or pass it as an option.`);
 	if (existsSync(outDir)) await fs$1.rm(outDir, { recursive: true });
 	await fs$1.mkdir(outDir, { recursive: true });
 	const host = createH3DevframeHost({

package/dist/adapters/cac.d.mts

@@ -1,4 +1,4 @@
-import { Dt as parseCliFlags, Et as defineCliFlags, F as DevframeDefinition, Tt as InferCliFlags, wt as CliFlagsSchema } from "../context-_i51nYOs.mjs";
+import { Dt as parseCliFlags, Et as defineCliFlags, F as DevframeDefinition, Tt as InferCliFlags, wt as CliFlagsSchema } from "../context-c0OlSc12.mjs";
 import { CAC } from "cac";
 import { H3 } from "h3";
 //#region src/adapters/cac.d.ts

package/dist/adapters/cac.mjs

@@ -1,7 +1,7 @@
 import { s as colors } from "../nostics-CzECRXpE.mjs";
 import { r as resolveDevServerPort } from "../_shared-BM3PdYli.mjs";
 import { createBuild } from "./build.mjs";
-import { t as createDevServer } from "../dev-lpIvwagf.mjs";
+import { t as createDevServer } from "../dev-BRQA42Lh.mjs";
 import process from "node:process";
 import cac$1 from "cac";
 //#region src/adapters/flags.ts

package/dist/adapters/dev.d.mts

@@ -1,8 +1,8 @@
 import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "../ws-server-DLtEoLdR.mjs";
-import { Ct as DevframeAuthHandler, F as DevframeDefinition, G as McpRouteOptions, U as DevframeSseOptions, W as DevframeWsOptions, s as DevframeNodeRpcSession } from "../context-_i51nYOs.mjs";
-import { o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
-import { c as StartedServer } from "../instance-shell-BHvBIGP4.mjs";
-import { a as resolveMcpConnectionMeta, i as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-BPovvJW8.mjs";
+import { Ct as DevframeAuthHandler, F as DevframeDefinition, G as McpRouteOptions, U as DevframeSseOptions, W as DevframeWsOptions, s as DevframeNodeRpcSession } from "../context-c0OlSc12.mjs";
+import { o as StaticAssetsSource } from "../remote-assets-B13_vRkJ.mjs";
+import { c as StartedServer } from "../instance-shell-CPuYY8pw.mjs";
+import { a as resolveMcpConnectionMeta, i as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-CsBsnhuO.mjs";
 import { H3 } from "h3";
 //#region src/adapters/dev.d.ts
 interface CreateDevServerOptions {
@@ -21,11 +21,12 @@ interface CreateDevServerOptions {
    */
   flags?: Record<string, unknown>;
   /**
-   * Override `def.cli?.distDir`. When neither this option nor
-   * `def.cli?.distDir` is set, the dev server runs in **bridge mode** —
-   * only `__connection.json` and the WS endpoint are mounted; the SPA
-   * is expected to be hosted elsewhere (e.g. by a parent Vite/Nuxt
-   * dev server via `devframeViteBridge` from `@devframes/vite`).
+   * Override the definition's `clientAssets` (or deprecated `cli.distDir`).
+   * When neither this option nor the definition's client assets are set, the
+   * dev server runs in **bridge mode** — only `__connection.json` and the WS
+   * endpoint are mounted; the SPA is expected to be hosted elsewhere (e.g. by
+   * a parent Vite/Nuxt dev server via `devframeViteBridge` from
+   * `@devframes/vite`).
    */
   distDir?: StaticAssetsSource;
   /**
@@ -117,7 +118,7 @@ interface CreateDevServerOptions {
  * h3 + WebSocket RPC + (optionally) the author's SPA mounted at the
  * resolved base path.
  *
- * When `distDir` is omitted (and `def.cli?.distDir` is unset) the
+ * When `distDir` is omitted (and the definition's client assets are unset) the
  * server runs in **bridge mode**: only `__connection.json` and the WS
  * endpoint are mounted, with no SPA mount. The SPA is expected to be
  * hosted elsewhere (e.g. by a parent Vite/Nuxt dev server) — see

package/dist/adapters/dev.mjs

@@ -1,3 +1,3 @@
 import { i as resolveMcpConnectionMeta, r as resolveDevServerPort } from "../_shared-BM3PdYli.mjs";
-import { t as createDevServer } from "../dev-lpIvwagf.mjs";
+import { t as createDevServer } from "../dev-BRQA42Lh.mjs";
 export { createDevServer, resolveDevServerPort, resolveMcpConnectionMeta };

package/dist/adapters/embedded.d.mts

@@ -1,4 +1,4 @@
-import { F as DevframeDefinition, o as DevframeNodeContext } from "../context-_i51nYOs.mjs";
+import { F as DevframeDefinition, o as DevframeNodeContext } from "../context-c0OlSc12.mjs";
 //#region src/adapters/embedded.d.ts
 interface CreateEmbeddedOptions {
   /** Target context the devframe is registered into. Required. */

package/dist/adapters/initiate.d.mts

@@ -1,7 +1,7 @@
 import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "../ws-server-DLtEoLdR.mjs";
-import { Ct as DevframeAuthHandler, F as DevframeDefinition, G as McpRouteOptions, U as DevframeSseOptions, W as DevframeWsOptions, bt as DevframeStorageScope, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta } from "../context-_i51nYOs.mjs";
-import { o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
-import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-BHvBIGP4.mjs";
+import { Ct as DevframeAuthHandler, F as DevframeDefinition, G as McpRouteOptions, U as DevframeSseOptions, W as DevframeWsOptions, bt as DevframeStorageScope, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta } from "../context-c0OlSc12.mjs";
+import { o as StaticAssetsSource } from "../remote-assets-B13_vRkJ.mjs";
+import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-CPuYY8pw.mjs";
 import { Buffer } from "node:buffer";
 import { IncomingMessage, Server, ServerResponse } from "node:http";
 import { Duplex } from "node:stream";
@@ -18,10 +18,11 @@ interface InitDevframeOptions {
    */
   base: string;
   /**
-   * Override `def.cli?.distDir`. When neither is set — or `false` is passed
-   * to suppress the definition's own `distDir` — the handler runs in
-   * **bridge mode**: only `__connection.json`, the WS endpoint, and the MCP
-   * route (when enabled) are served; the SPA is hosted elsewhere.
+   * Override the definition's `clientAssets` (or deprecated `cli.distDir`).
+   * When neither is set — or `false` is passed to suppress the definition's
+   * own client assets — the handler runs in **bridge mode**: only
+   * `__connection.json`, the WS endpoint, and the MCP route (when enabled) are
+   * served; the SPA is hosted elsewhere.
    */
   distDir?: StaticAssetsSource | false;
   /**

package/dist/adapters/initiate.mjs

@@ -1,2 +1,2 @@
-import { n as getInstanceInternals, r as initDevframe } from "../dev-lpIvwagf.mjs";
+import { n as getInstanceInternals, r as initDevframe } from "../dev-BRQA42Lh.mjs";
 export { getInstanceInternals, initDevframe };

package/dist/adapters/mcp.d.mts

@@ -1,4 +1,4 @@
-import { F as DevframeDefinition, o as DevframeNodeContext } from "../context-_i51nYOs.mjs";
+import { F as DevframeDefinition, o as DevframeNodeContext } from "../context-c0OlSc12.mjs";
 import { H3 } from "h3";
 import "@modelcontextprotocol/server";
 //#region src/adapters/mcp/build-server.d.ts

package/dist/adapters/mcp.mjs

@@ -1,2 +1,2 @@
-import { i as createMcpServer, n as mountMcpHttp, r as createMcpFetchHandler } from "../http-BKiqHcXX.mjs";
+import { i as createMcpServer, n as mountMcpHttp, r as createMcpFetchHandler } from "../http-D7wWuy7-.mjs";
 export { createMcpFetchHandler, createMcpServer, mountMcpHttp };

package/dist/client/index.d.mts

@@ -1,6 +1,6 @@
 import { f as RpcCacheManager, p as RpcCacheOptions } from "../index-DOg4S5wk.mjs";
 import { _ as RpcFunctionDefinition, w as RpcFunctionsCollector } from "../types-BBLeGfpt.mjs";
-import { Q as DevframeServiceScopeOf, X as DevframeServiceMeta, _t as DevframeRpcServerFunctions, b as StreamSink, d as RpcSharedStateHost, dt as ScopedRpcFn, ft as ScopedServerFunctions, gt as DevframeRpcClientFunctions, k as SharedState, mt as SettingsForNamespace, nt as DevframeServicesState, ot as DevframeSettings, pt as ScopedSharedStates, t as ConnectionMeta, u as RpcSharedStateGetOptions, y as StreamReader, zt as EventEmitter } from "../context-_i51nYOs.mjs";
+import { Q as DevframeServiceScopeOf, X as DevframeServiceMeta, _t as DevframeRpcServerFunctions, b as StreamSink, d as RpcSharedStateHost, dt as ScopedRpcFn, ft as ScopedServerFunctions, gt as DevframeRpcClientFunctions, k as SharedState, mt as SettingsForNamespace, nt as DevframeServicesState, ot as DevframeSettings, pt as ScopedSharedStates, t as ConnectionMeta, u as RpcSharedStateGetOptions, y as StreamReader, zt as EventEmitter } from "../context-c0OlSc12.mjs";
 import { t as SseRpcChannelOptions } from "../sse-client-CdGD_B8_.mjs";
 import { t as WsRpcChannelOptions } from "../ws-client-Bo2t6hES.mjs";
 import { BirpcOptions, BirpcReturn } from "birpc";

package/dist/client/index.mjs

@@ -15,7 +15,7 @@ import { createBirpc } from "birpc";
 * broadcast notifications — so these names live in one place instead of
 * scattered string literals.
 *
-* **Keep this in sync with [`docs/guide/events.md`](../../../docs/guide/events.md)**
+* **Keep this in sync with [`docs/content/1.guide/20.events.md`](../../../docs/content/1.guide/20.events.md)**
 * (the "Core devframe events" section): every name here appears in that page's
 * tables, and every name there resolves to an entry here. Add, rename, or
 * remove a name in both places in the same change, and reference

package/dist/constants.d.mts

@@ -5,7 +5,7 @@
  * broadcast notifications — so these names live in one place instead of
  * scattered string literals.
  *
- * **Keep this in sync with [`docs/guide/events.md`](../../../docs/guide/events.md)**
+ * **Keep this in sync with [`docs/content/1.guide/20.events.md`](../../../docs/content/1.guide/20.events.md)**
  * (the "Core devframe events" section): every name here appears in that page's
  * tables, and every name there resolves to an entry here. Add, rename, or
  * remove a name in both places in the same change, and reference

package/dist/constants.mjs

@@ -1,4 +1,4 @@
-import { t as DEVFRAME_EVENTS } from "./events-DKfSmoTj.mjs";
+import { t as DEVFRAME_EVENTS } from "./events-DzolaBEs.mjs";
 //#region src/constants.ts
 const DEVFRAME_CONNECTION_META_FILENAME = "__connection.json";
 /**

package/dist/{context-CQW0lSw8.mjs → context-Bc5S40Qt.mjs}

@@ -2,10 +2,10 @@ import { i as defineDiagnostics } from "./nostics-CzECRXpE.mjs";
 import { t as diagnostics } from "./diagnostics-CD8nlgll.mjs";
 import { RpcFunctionsCollectorBase } from "./rpc/index.mjs";
 import { defineRpcFunction } from "./index.mjs";
-import { t as DEVFRAME_EVENTS } from "./events-DKfSmoTj.mjs";
+import { t as DEVFRAME_EVENTS } from "./events-DzolaBEs.mjs";
 import { DEVFRAME_SERVICES_STATE_KEY } from "./constants.mjs";
 import { t as diagnostics$1 } from "./diagnostics-BXWW3VK-.mjs";
-import { r as createEventEmitter, t as DevframeAgentHost } from "./host-agent-B84av916.mjs";
+import { r as createEventEmitter, t as DevframeAgentHost } from "./host-agent-DbPWo0Bl.mjs";
 import { n as createDebug, t as resolveStaticAssetsSource } from "./remote-assets-DezQmPQU.mjs";
 import { t as createStorage } from "./storage-BXNVhKyR.mjs";
 import { createRequire } from "node:module";

package/dist/{context-BUJGvlje.mjs → context-Cx9V9Grq.mjs}

@@ -1,6 +1,6 @@
 import { n as randomToken } from "./crypto-token-XCqTSMg9.mjs";
 import { t as createStorage } from "./storage-BXNVhKyR.mjs";
-import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "./revoke-3Q6aDKWk.mjs";
+import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "./revoke-PihtvVil.mjs";
 import { join } from "pathe";
 //#region src/node/hub-internals/context.ts
 const internalContextMap = /* @__PURE__ */ new WeakMap();

package/dist/{context-CO7eZHJy.d.mts → context-DO0Qu1O8.d.mts}

@@ -1,4 +1,4 @@
-import { k as SharedState, o as DevframeNodeContext } from "./context-_i51nYOs.mjs";
+import { k as SharedState, o as DevframeNodeContext } from "./context-c0OlSc12.mjs";
 //#region src/node/hub-internals/context.d.ts
 interface InternalAnonymousAuthStorage {
   trusted: Record<string, {

package/dist/{context-_i51nYOs.d.mts → context-c0OlSc12.d.mts}

@@ -1,7 +1,7 @@
 import { d as RpcFunctionsCollectorBase } from "./index-DOg4S5wk.mjs";
 import { _ as RpcFunctionDefinition, v as RpcFunctionDefinitionAny } from "./types-BBLeGfpt.mjs";
 import { d as DevframeRpcConnection, u as DevframeNodeRpcSessionMeta } from "./ws-server-DLtEoLdR.mjs";
-import { a as RemoteAssetsStore, o as StaticAssetsSource } from "./remote-assets-Bg4gCUZ_.mjs";
+import { a as RemoteAssetsStore, o as StaticAssetsSource } from "./remote-assets-B13_vRkJ.mjs";
 import { m as defineDiagnostics } from "./nostics-SPGDgHEP.mjs";
 import { BirpcReturn } from "birpc";
 import { StandardSchemaV1 } from "@standard-schema/spec";
@@ -444,8 +444,8 @@ interface DevframeHost {
    * for cross-origin or sandboxed iframes. Implementations serve the same
    * meta they expose at the hub's own base.
    *
-   * Optional in the type, but a host that mounts a devframe with a servable
-   * `distDir` yet omits this hook triggers a `DF8106` diagnostic, since the
+   * Optional in the type, but a host that mounts a devframe with servable
+   * `clientAssets` yet omits this hook triggers a `DF8106` diagnostic, since the
    * SPA's `./__connection.json` fetch would otherwise fall through and break
    * silently. A static-snapshot host that bakes the meta into its served files
    * can implement it as a no-op to acknowledge this intentionally.
@@ -1234,10 +1234,11 @@ interface DevframeCliOptions {
    */
   mcp?: boolean | McpRouteOptions;
   /**
-   * Author's SPA dist — served as the devframe's UI. A local directory, or
-   * a {@link StaticAssetsSource} remote declaration (`{ package, version }`)
-   * served through devframe's caching CDN back-proxy so the assets need not
-   * ship inside the node package.
+   * Author's SPA dist — served as the devframe's UI.
+   *
+   * @deprecated Moved to the top-level {@link DevframeDefinition.clientAssets}.
+   * Set `clientAssets` on the definition instead. This field is still read as a
+   * fallback when `clientAssets` is unset, so existing definitions keep working.
    */
   distDir?: StaticAssetsSource;
   /**
@@ -1357,7 +1358,7 @@ interface DevframeDefinition {
    * consuming app's.
    *
    * - **Remote assets** — becomes the default `resolveFrom` for any remote
-   *   {@link StaticAssetsSource} the devframe hosts (its `cli.distDir`, and
+   *   {@link StaticAssetsSource} the devframe hosts (its `clientAssets`, and
    *   every `ctx.views.hostStatic` call) that doesn't set one explicitly, so a
    *   locally installed copy of the assets package is served with zero
    *   network. A per-asset `resolveFrom` still wins, and an explicit
@@ -1434,6 +1435,17 @@ interface DevframeDefinition {
    * `client.services.has(pkg)` and degrade.
    */
   services?: DevframeServiceInput[];
+  /**
+   * Author's SPA dist — served as the devframe's UI. A local directory, or
+   * a {@link StaticAssetsSource} remote declaration (`{ package, version }`)
+   * served through devframe's caching CDN back-proxy so the assets need not
+   * ship inside the node package.
+   *
+   * Consumed by every adapter that serves the UI (`dev`, `build`, `vite`,
+   * `next`, and the hub install path). When unset, the deprecated
+   * {@link DevframeCliOptions.distDir} is read as a fallback.
+   */
+  clientAssets?: StaticAssetsSource;
   /** RPC-level configuration for this devframe (see {@link DevframeRpcOptions}). */
   rpc?: DevframeRpcOptions;
   /** Server-side setup — the primary entrypoint. Runs in every runtime. */

package/dist/{dev-lpIvwagf.mjs → dev-BRQA42Lh.mjs}

@@ -1,10 +1,11 @@
+import { resolveClientAssets } from "./index.mjs";
 import { DEVFRAME_CONNECTION_META_FILENAME } from "./constants.mjs";
 import { t as diagnostics } from "./diagnostics-BXWW3VK-.mjs";
-import { t as createHostContext } from "./context-CQW0lSw8.mjs";
+import { t as createHostContext } from "./context-Bc5S40Qt.mjs";
 import { t as resolveStaticAssetsSource } from "./remote-assets-DezQmPQU.mjs";
 import { i as resolveMcpConnectionMeta, n as resolveBasePath, r as resolveDevServerPort, t as normalizeBasePath } from "./_shared-BM3PdYli.mjs";
 import { t as createH3DevframeHost } from "./host-h3-fRbF9yor.mjs";
-import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, t as createInstanceShell } from "./instance-shell-B-uevnK-.mjs";
+import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, t as createInstanceShell } from "./instance-shell-fB5PyVtR.mjs";
 import { open } from "./utils/open.mjs";
 import { mountStaticHandler } from "./utils/serve-static.mjs";
 import { createServer } from "node:http";
@@ -37,7 +38,7 @@ function getInstanceInternals(handler) {
 */
 function initDevframe(def, options) {
 	const base = normalizeBasePath(options.base);
-	const distDir = options.distDir === false ? void 0 : options.distDir ?? def.cli?.distDir;
+	const distDir = options.distDir === false ? void 0 : options.distDir ?? resolveClientAssets(def);
 	const app = options.app ?? new H3();
 	const host = options.host ?? def.cli?.host ?? "localhost";
 	const shell = createInstanceShell({
@@ -91,7 +92,7 @@ function initDevframe(def, options) {
 				const mcpPath = joinURL(base, mcpMeta.path);
 				let mountMcpHttp;
 				try {
-					({mountMcpHttp} = await import("./http-BKiqHcXX.mjs").then((n) => n.t));
+					({mountMcpHttp} = await import("./http-D7wWuy7-.mjs").then((n) => n.t));
 				} catch (error) {
 					const reason = error instanceof Error ? error.message : String(error);
 					throw diagnostics.DF0017({
@@ -142,7 +143,7 @@ function initDevframe(def, options) {
 * h3 + WebSocket RPC + (optionally) the author's SPA mounted at the
 * resolved base path.
 *
-* When `distDir` is omitted (and `def.cli?.distDir` is unset) the
+* When `distDir` is omitted (and the definition's client assets are unset) the
 * server runs in **bridge mode**: only `__connection.json` and the WS
 * endpoint are mounted, with no SPA mount. The SPA is expected to be
 * hosted elsewhere (e.g. by a parent Vite/Nuxt dev server) — see

package/dist/{events-DKfSmoTj.mjs → events-DzolaBEs.mjs}

@@ -5,7 +5,7 @@
 * broadcast notifications — so these names live in one place instead of
 * scattered string literals.
 *
-* **Keep this in sync with [`docs/guide/events.md`](../../../docs/guide/events.md)**
+* **Keep this in sync with [`docs/content/1.guide/20.events.md`](../../../docs/content/1.guide/20.events.md)**
 * (the "Core devframe events" section): every name here appears in that page's
 * tables, and every name there resolves to an entry here. Add, rename, or
 * remove a name in both places in the same change, and reference

package/dist/{host-agent-B84av916.mjs → host-agent-DbPWo0Bl.mjs}

@@ -1,4 +1,4 @@
-import { t as DEVFRAME_EVENTS } from "./events-DKfSmoTj.mjs";
+import { t as DEVFRAME_EVENTS } from "./events-DzolaBEs.mjs";
 import { t as diagnostics } from "./diagnostics-BXWW3VK-.mjs";
 //#region src/utils/events.ts
 /**

package/dist/{http-BKiqHcXX.mjs → http-D7wWuy7-.mjs}

@@ -1,9 +1,9 @@
 import { n as __exportAll } from "./rolldown-runtime-B4iAMlE-.mjs";
 import { t as Diagnostic } from "./nostics-CzECRXpE.mjs";
-import { t as DEVFRAME_EVENTS } from "./events-DKfSmoTj.mjs";
+import { t as DEVFRAME_EVENTS } from "./events-DzolaBEs.mjs";
 import { i as isAllowedOrigin } from "./ws-server-BdSLrhxE.mjs";
 import { t as diagnostics } from "./diagnostics-BXWW3VK-.mjs";
-import { t as createHostContext } from "./context-CQW0lSw8.mjs";
+import { t as createHostContext } from "./context-Bc5S40Qt.mjs";
 import { t as toAgentToolName } from "./agent-tool-name-EgfoFO8C.mjs";
 import { randomUUID } from "node:crypto";
 import process from "node:process";

package/dist/{index-CEvd-YXD.d.mts → index-B_DPNIT4.d.mts}

@@ -1,5 +1,5 @@
-import { k as SharedState, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "./context-_i51nYOs.mjs";
-import { n as InternalAnonymousAuthStorage } from "./context-CO7eZHJy.mjs";
+import { k as SharedState, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "./context-c0OlSc12.mjs";
+import { n as InternalAnonymousAuthStorage } from "./context-DO0Qu1O8.mjs";
 //#region src/node/auth/revoke.d.ts
 /**
  * Flip `isTrusted` to false on any live WS clients connected with `token`

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import "./index-DOg4S5wk.mjs";
 import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-BBLeGfpt.mjs";
 import { d as DevframeRpcConnection, f as DevframeRpcConnectionRequest, p as DevframeRpcTransportKind, u as DevframeNodeRpcSessionMeta } from "./ws-server-DLtEoLdR.mjs";
-import { $ as DevframeServicesHost, At as AgentResource, B as DevframeSetupInfo, Bt as EventUnsubscribe, F as DevframeDefinition, Ft as AgentToolProvider, G as McpRouteOptions, H as DevframeSnapshotRpcInputs, I as DevframeDeploymentKind, It as AgentToolProviderHandle, J as DevframeServiceId, K as DevframeServiceDefinition, L as DevframeDockDefaults, Lt as DevframeAgentHost, Mt as AgentResourceInput, Nt as AgentTool, Ot as AgentHandle, P as DevframeCliOptions, Pt as AgentToolInput, Q as DevframeServiceScopeOf, R as DevframeDuplicationStrategy, Rt as DevframeAgentHostEvents, St as DevframeDiagnosticsLogger, U as DevframeSseOptions, V as DevframeSnapshotRpcEntry, Vt as EventsMap, W as DevframeWsOptions, X as DevframeServiceMeta, Y as DevframeServiceInput, Z as DevframeServiceOf, _t as DevframeRpcServerFunctions, a as DevframeConnectionConfigsRegistry, at as DevframeScopedStreamingHost, bt as DevframeStorageScope, c as RpcBroadcastOptions, ct as DevframeSettingsStore, d as RpcSharedStateHost, dt as ScopedRpcFn, et as DevframeServicesRegistry, f as RpcStreamingChannel, ft as ScopedServerFunctions, gt as DevframeRpcClientFunctions, ht as DevframeViewHost, i as DevframeCapabilities, it as DevframeScopedNodeRpc, jt as AgentResourceContent, kt as AgentManifest, l as RpcFunctionsHost, lt as ScopedBroadcastOptions, m as RpcStreamingHost, mt as SettingsForNamespace, n as ConnectionMetaSse, nt as DevframeServicesState, o as DevframeNodeContext, ot as DevframeSettings, p as RpcStreamingChannelOptions, pt as ScopedSharedStates, q as DevframeServiceDescriptor, r as ConnectionMetaWebsocket, rt as DevframeScopedNodeContext, s as DevframeNodeRpcSession, st as DevframeSettingsRegistry, t as ConnectionMeta, tt as DevframeServicesScopeRegistry, u as RpcSharedStateGetOptions, ut as ScopedClientFunctions, vt as DevframeRpcSharedStates, xt as DevframeDiagnosticsHost, yt as DevframeHost, z as DevframeRpcOptions, zt as EventEmitter } from "./context-_i51nYOs.mjs";
-import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "./remote-assets-Bg4gCUZ_.mjs";
+import { $ as DevframeServicesHost, At as AgentResource, B as DevframeSetupInfo, Bt as EventUnsubscribe, F as DevframeDefinition, Ft as AgentToolProvider, G as McpRouteOptions, H as DevframeSnapshotRpcInputs, I as DevframeDeploymentKind, It as AgentToolProviderHandle, J as DevframeServiceId, K as DevframeServiceDefinition, L as DevframeDockDefaults, Lt as DevframeAgentHost, Mt as AgentResourceInput, Nt as AgentTool, Ot as AgentHandle, P as DevframeCliOptions, Pt as AgentToolInput, Q as DevframeServiceScopeOf, R as DevframeDuplicationStrategy, Rt as DevframeAgentHostEvents, St as DevframeDiagnosticsLogger, U as DevframeSseOptions, V as DevframeSnapshotRpcEntry, Vt as EventsMap, W as DevframeWsOptions, X as DevframeServiceMeta, Y as DevframeServiceInput, Z as DevframeServiceOf, _t as DevframeRpcServerFunctions, a as DevframeConnectionConfigsRegistry, at as DevframeScopedStreamingHost, bt as DevframeStorageScope, c as RpcBroadcastOptions, ct as DevframeSettingsStore, d as RpcSharedStateHost, dt as ScopedRpcFn, et as DevframeServicesRegistry, f as RpcStreamingChannel, ft as ScopedServerFunctions, gt as DevframeRpcClientFunctions, ht as DevframeViewHost, i as DevframeCapabilities, it as DevframeScopedNodeRpc, jt as AgentResourceContent, kt as AgentManifest, l as RpcFunctionsHost, lt as ScopedBroadcastOptions, m as RpcStreamingHost, mt as SettingsForNamespace, n as ConnectionMetaSse, nt as DevframeServicesState, o as DevframeNodeContext, ot as DevframeSettings, p as RpcStreamingChannelOptions, pt as ScopedSharedStates, q as DevframeServiceDescriptor, r as ConnectionMetaWebsocket, rt as DevframeScopedNodeContext, s as DevframeNodeRpcSession, st as DevframeSettingsRegistry, t as ConnectionMeta, tt as DevframeServicesScopeRegistry, u as RpcSharedStateGetOptions, ut as ScopedClientFunctions, vt as DevframeRpcSharedStates, xt as DevframeDiagnosticsHost, yt as DevframeHost, z as DevframeRpcOptions, zt as EventEmitter } from "./context-c0OlSc12.mjs";
+import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "./remote-assets-B13_vRkJ.mjs";
 import { i as DevframeDefineDiagnosticsOptions } from "./nostics-SPGDgHEP.mjs";
 //#region src/define.d.ts
 declare const defineRpcFunction: <NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeNodeContext>) => RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeNodeContext>;
@@ -11,5 +11,13 @@ declare const defineRpcFunction: <NAME extends string, TYPE extends RpcFunctionT
  * entry point. Import it from the package root: `import { defineDevframe } from 'devframe'`.
  */
 declare function defineDevframe(d: DevframeDefinition): DevframeDefinition;
+/**
+ * Resolve a definition's client assets source — the built SPA served as its
+ * UI. Prefers the top-level {@link DevframeDefinition.clientAssets} and falls
+ * back to the deprecated {@link DevframeCliOptions.distDir}, so both the new
+ * and legacy shapes resolve. Returns `undefined` when neither is set (bridge
+ * mode — the SPA is hosted elsewhere).
+ */
+declare function resolveClientAssets(d: DevframeDefinition): StaticAssetsSource | undefined;
 //#endregion
-export { type AgentHandle, type AgentManifest, type AgentResource, type AgentResourceContent, type AgentResourceInput, type AgentTool, type AgentToolInput, type AgentToolProvider, type AgentToolProviderHandle, type ConnectionMeta, type ConnectionMetaSse, type ConnectionMetaWebsocket, type DevframeAgentHost, type DevframeAgentHostEvents, type DevframeCapabilities, type DevframeCliOptions, type DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, type DevframeDefinition, type DevframeDeploymentKind, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockDefaults, type DevframeDuplicationStrategy, type DevframeHost, type DevframeNodeContext, type DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, type DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, type DevframeRpcOptions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceDefinition, type DevframeServiceDescriptor, type DevframeServiceId, type DevframeServiceInput, type DevframeServiceMeta, type DevframeServiceOf, type DevframeServiceScopeOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeServicesScopeRegistry, type DevframeServicesState, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSnapshotRpcEntry, type DevframeSnapshotRpcInputs, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EventEmitter, type EventUnsubscribe, type EventsMap, type McpRouteOptions, type RemoteAssets, type RemoteAssetsErrorMessage, type RemoteAssetsProvider, type RemoteAssetsProviderCustom, type RemoteAssetsStore, type RpcBroadcastOptions, type RpcFunctionAgentOptions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type ScopedBroadcastOptions, type ScopedClientFunctions, type ScopedRpcFn, type ScopedServerFunctions, type ScopedSharedStates, type SettingsForNamespace, type StaticAssetsSource, defineDevframe, defineRpcFunction };
+export { type AgentHandle, type AgentManifest, type AgentResource, type AgentResourceContent, type AgentResourceInput, type AgentTool, type AgentToolInput, type AgentToolProvider, type AgentToolProviderHandle, type ConnectionMeta, type ConnectionMetaSse, type ConnectionMetaWebsocket, type DevframeAgentHost, type DevframeAgentHostEvents, type DevframeCapabilities, type DevframeCliOptions, type DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, type DevframeDefinition, type DevframeDeploymentKind, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockDefaults, type DevframeDuplicationStrategy, type DevframeHost, type DevframeNodeContext, type DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, type DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, type DevframeRpcOptions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceDefinition, type DevframeServiceDescriptor, type DevframeServiceId, type DevframeServiceInput, type DevframeServiceMeta, type DevframeServiceOf, type DevframeServiceScopeOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeServicesScopeRegistry, type DevframeServicesState, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSnapshotRpcEntry, type DevframeSnapshotRpcInputs, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EventEmitter, type EventUnsubscribe, type EventsMap, type McpRouteOptions, type RemoteAssets, type RemoteAssetsErrorMessage, type RemoteAssetsProvider, type RemoteAssetsProviderCustom, type RemoteAssetsStore, type RpcBroadcastOptions, type RpcFunctionAgentOptions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type ScopedBroadcastOptions, type ScopedClientFunctions, type ScopedRpcFn, type ScopedServerFunctions, type ScopedSharedStates, type SettingsForNamespace, type StaticAssetsSource, defineDevframe, defineRpcFunction, resolveClientAssets };

package/dist/index.mjs

@@ -8,5 +8,15 @@ const defineRpcFunction = createDefineWrapperWithContext();
 function defineDevframe(d) {
 	return d;
 }
+/**
+* Resolve a definition's client assets source — the built SPA served as its
+* UI. Prefers the top-level {@link DevframeDefinition.clientAssets} and falls
+* back to the deprecated {@link DevframeCliOptions.distDir}, so both the new
+* and legacy shapes resolve. Returns `undefined` when neither is set (bridge
+* mode — the SPA is hosted elsewhere).
+*/
+function resolveClientAssets(d) {
+	return d.clientAssets ?? d.cli?.distDir;
+}
 //#endregion
-export { defineDevframe, defineRpcFunction };
+export { defineDevframe, defineRpcFunction, resolveClientAssets };

package/dist/{instance-shell-BHvBIGP4.d.mts → instance-shell-CPuYY8pw.d.mts}

@@ -1,6 +1,6 @@
 import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "./ws-server-DLtEoLdR.mjs";
-import { Ct as DevframeAuthHandler, U as DevframeSseOptions, W as DevframeWsOptions, _t as DevframeRpcServerFunctions, gt as DevframeRpcClientFunctions, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta } from "./context-_i51nYOs.mjs";
-import "./index-CEvd-YXD.mjs";
+import { Ct as DevframeAuthHandler, U as DevframeSseOptions, W as DevframeWsOptions, _t as DevframeRpcServerFunctions, gt as DevframeRpcClientFunctions, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta } from "./context-c0OlSc12.mjs";
+import "./index-B_DPNIT4.mjs";
 import { BirpcGroup } from "birpc";
 import { NodeAdapter } from "crossws/adapters/node";
 import { Buffer } from "node:buffer";

package/dist/{instance-shell-B-uevnK-.mjs → instance-shell-fB5PyVtR.mjs}

@@ -1,6 +1,6 @@
 import "./constants.mjs";
 import { t as diagnostics } from "./diagnostics-BXWW3VK-.mjs";
-import { t as getInternalContext } from "./context-BUJGvlje.mjs";
+import { t as getInternalContext } from "./context-Cx9V9Grq.mjs";
 import { createInteractiveAuth } from "./recipes/interactive-auth.mjs";
 import { createServer } from "node:http";
 import process from "node:process";

package/dist/internal/index.d.mts

@@ -1,9 +1,9 @@
 import { v as RpcFunctionDefinitionAny } from "../types-BBLeGfpt.mjs";
-import { At as AgentResource, Ft as AgentToolProvider, It as AgentToolProviderHandle, Lt as DevframeAgentHost$1, Mt as AgentResourceInput, Nt as AgentTool, Ot as AgentHandle, Pt as AgentToolInput, Rt as DevframeAgentHostEvents, jt as AgentResourceContent, kt as AgentManifest, o as DevframeNodeContext, yt as DevframeHost, zt as EventEmitter } from "../context-_i51nYOs.mjs";
-import { a as RemoteAssetsStore } from "../remote-assets-Bg4gCUZ_.mjs";
-import { a as InstanceShellInit, c as StartedServer, d as samePath, f as DevframeInstanceRecord, h as registerDevframeInstance, i as InstanceShellApi, l as createInstanceShell, m as listLiveDevframeInstances, n as InstanceRegisterConfig, o as InstanceShellInternals, p as DevframeInstanceRegistration, r as InstanceShell, s as InstanceWsTier, t as CreateInstanceShellOptions, u as resolveInstanceRegister } from "../instance-shell-BHvBIGP4.mjs";
-import { n as normalizeBasePath, r as resolveBasePath } from "../_shared-BPovvJW8.mjs";
-import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-CDZoGYiD.mjs";
+import { At as AgentResource, Ft as AgentToolProvider, It as AgentToolProviderHandle, Lt as DevframeAgentHost$1, Mt as AgentResourceInput, Nt as AgentTool, Ot as AgentHandle, Pt as AgentToolInput, Rt as DevframeAgentHostEvents, jt as AgentResourceContent, kt as AgentManifest, o as DevframeNodeContext, yt as DevframeHost, zt as EventEmitter } from "../context-c0OlSc12.mjs";
+import { a as RemoteAssetsStore } from "../remote-assets-B13_vRkJ.mjs";
+import { a as InstanceShellInit, c as StartedServer, d as samePath, f as DevframeInstanceRecord, h as registerDevframeInstance, i as InstanceShellApi, l as createInstanceShell, m as listLiveDevframeInstances, n as InstanceRegisterConfig, o as InstanceShellInternals, p as DevframeInstanceRegistration, r as InstanceShell, s as InstanceWsTier, t as CreateInstanceShellOptions, u as resolveInstanceRegister } from "../instance-shell-CPuYY8pw.mjs";
+import { n as normalizeBasePath, r as resolveBasePath } from "../_shared-CsBsnhuO.mjs";
+import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-Oyz-cJBC.mjs";
 //#region src/node/agent-args.d.ts
 /**
  * How {@link coerceAgentPositionalArgs} treats an args object that carries

package/dist/internal/index.mjs

@@ -1,9 +1,9 @@
 import { n as peekRpcWireFrame, t as createRpcWireCodec } from "../wire-codec-0K-o5MYW.mjs";
 import { t as diagnostics } from "../diagnostics-BXWW3VK-.mjs";
-import { n as coerceAgentPositionalArgs, t as DevframeAgentHost } from "../host-agent-B84av916.mjs";
+import { n as coerceAgentPositionalArgs, t as DevframeAgentHost } from "../host-agent-DbPWo0Bl.mjs";
 import { n as resolveBasePath, t as normalizeBasePath } from "../_shared-BM3PdYli.mjs";
 import { t as createH3DevframeHost } from "../host-h3-fRbF9yor.mjs";
 import { i as registerDevframeInstance, n as listLiveDevframeInstances } from "../instance-registry-BjlMQbFB.mjs";
-import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, r as samePath, t as createInstanceShell } from "../instance-shell-B-uevnK-.mjs";
+import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, r as samePath, t as createInstanceShell } from "../instance-shell-fB5PyVtR.mjs";
 import { t as createContextRpcServer } from "../rpc-core-DlHd276T.mjs";
 export { DevframeAgentHost, coerceAgentPositionalArgs, createContextRpcServer, createH3DevframeHost, createInstanceShell, createRpcWireCodec, diagnostics, listLiveDevframeInstances, normalizeBasePath, normalizeHttpServerUrl, peekRpcWireFrame, registerDevframeInstance, resolveBasePath, resolveInstanceRegister, samePath };

package/dist/node/auth.d.mts

@@ -1,3 +1,3 @@
-import { Ct as DevframeAuthHandler } from "../context-_i51nYOs.mjs";
-import { a as verifyAuthToken, i as refreshTempAuthCode, n as exchangeTempAuthCode, o as revokeActiveConnectionsForToken, r as getTempAuthCode, s as revokeAuthToken, t as buildOtpAuthUrl } from "../index-CEvd-YXD.mjs";
+import { Ct as DevframeAuthHandler } from "../context-c0OlSc12.mjs";
+import { a as verifyAuthToken, i as refreshTempAuthCode, n as exchangeTempAuthCode, o as revokeActiveConnectionsForToken, r as getTempAuthCode, s as revokeAuthToken, t as buildOtpAuthUrl } from "../index-B_DPNIT4.mjs";
 export { DevframeAuthHandler, buildOtpAuthUrl, exchangeTempAuthCode, getTempAuthCode, refreshTempAuthCode, revokeActiveConnectionsForToken, revokeAuthToken, verifyAuthToken };

package/dist/node/auth.mjs

@@ -1,3 +1,3 @@
-import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "../revoke-3Q6aDKWk.mjs";
+import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "../revoke-PihtvVil.mjs";
 import { a as verifyAuthToken, i as refreshTempAuthCode, n as exchangeTempAuthCode, r as getTempAuthCode, t as buildOtpAuthUrl } from "../state-CK9LjrnT.mjs";
 export { buildOtpAuthUrl, exchangeTempAuthCode, getTempAuthCode, refreshTempAuthCode, revokeActiveConnectionsForToken, revokeAuthToken, verifyAuthToken };

package/dist/node/hub-internals.d.mts

@@ -1,3 +1,3 @@
-import { a as internalContextMap, i as getInternalContext, n as InternalAnonymousAuthStorage, r as RemoteTokenRecord, t as DevframeInternalContext } from "../context-CO7eZHJy.mjs";
-import { n as normalizeBasePath, r as resolveBasePath } from "../_shared-BPovvJW8.mjs";
+import { a as internalContextMap, i as getInternalContext, n as InternalAnonymousAuthStorage, r as RemoteTokenRecord, t as DevframeInternalContext } from "../context-DO0Qu1O8.mjs";
+import { n as normalizeBasePath, r as resolveBasePath } from "../_shared-CsBsnhuO.mjs";
 export { type DevframeInternalContext, type InternalAnonymousAuthStorage, type RemoteTokenRecord, getInternalContext, internalContextMap, normalizeBasePath, resolveBasePath };

package/dist/node/hub-internals.mjs

@@ -1,3 +1,3 @@
 import { n as resolveBasePath, t as normalizeBasePath } from "../_shared-BM3PdYli.mjs";
-import { n as internalContextMap, t as getInternalContext } from "../context-BUJGvlje.mjs";
+import { n as internalContextMap, t as getInternalContext } from "../context-Cx9V9Grq.mjs";
 export { getInternalContext, internalContextMap, normalizeBasePath, resolveBasePath };

package/dist/node/index.d.mts

@@ -1,6 +1,6 @@
 import "../index-DOg4S5wk.mjs";
 import { v as RpcFunctionDefinitionAny } from "../types-BBLeGfpt.mjs";
-import { k as SharedState, l as RpcFunctionsHost, o as DevframeNodeContext, yt as DevframeHost } from "../context-_i51nYOs.mjs";
+import { k as SharedState, l as RpcFunctionsHost, o as DevframeNodeContext, yt as DevframeHost } from "../context-c0OlSc12.mjs";
 import { BirpcGroup } from "birpc";
 //#region src/node/context.d.ts
 interface CreateHostContextOptions {

package/dist/node/index.mjs

@@ -1,3 +1,3 @@
-import { t as createHostContext } from "../context-CQW0lSw8.mjs";
+import { t as createHostContext } from "../context-Bc5S40Qt.mjs";
 import { t as createStorage } from "../storage-BXNVhKyR.mjs";
 export { createHostContext, createStorage };

package/dist/recipes/common-rpc-functions.d.mts

@@ -1,6 +1,6 @@
 import "../index-DOg4S5wk.mjs";
 import { E as Thenable, S as RpcFunctionSetupResult, c as RpcDump, g as RpcFunctionAgentOptions } from "../types-BBLeGfpt.mjs";
-import "../context-_i51nYOs.mjs";
+import "../context-c0OlSc12.mjs";
 import { SimpleSchema } from "../utils/simple-schema.mjs";
 //#region src/recipes/common-rpc-functions.d.ts
 /**

package/dist/recipes/interactive-auth.d.mts

@@ -1,5 +1,5 @@
-import { Ct as DevframeAuthHandler, o as DevframeNodeContext } from "../context-_i51nYOs.mjs";
-import "../index-CEvd-YXD.mjs";
+import { Ct as DevframeAuthHandler, o as DevframeNodeContext } from "../context-c0OlSc12.mjs";
+import "../index-B_DPNIT4.mjs";
 //#region src/recipes/interactive-auth.d.ts
 interface CreateInteractiveAuthOptions {
   /**

package/dist/recipes/interactive-auth.mjs

@@ -2,7 +2,7 @@ import { s as colors } from "../nostics-CzECRXpE.mjs";
 import { n as defineRpcFunction } from "../define-BLWPsH6y.mjs";
 import { isAnonymousRpcMethod } from "../constants.mjs";
 import { a as verifyAuthToken, n as exchangeTempAuthCode, r as getTempAuthCode, t as buildOtpAuthUrl } from "../state-CK9LjrnT.mjs";
-import { t as getInternalContext } from "../context-BUJGvlje.mjs";
+import { t as getInternalContext } from "../context-Cx9V9Grq.mjs";
 import { t as s } from "../simple-schema-DQPZrAaZ.mjs";
 //#region src/recipes/interactive-auth.ts
 function defaultBanner(info) {

package/dist/{remote-assets-Bg4gCUZ_.d.mts → remote-assets-B13_vRkJ.d.mts}

@@ -14,7 +14,7 @@
  *   3. The CDN {@link provider} — each requested file streams through to
  *      the browser while being written into the cache.
  *
- * Anywhere a static mount accepts a dist directory (`cli.distDir`,
+ * Anywhere a static mount accepts a dist directory (`clientAssets`,
  * `hostStatic`, `mountStatic`) it also accepts this object — see
  * {@link StaticAssetsSource}.
  */

package/dist/{revoke-3Q6aDKWk.mjs → revoke-PihtvVil.mjs}

@@ -1,4 +1,4 @@
-import { t as DEVFRAME_EVENTS } from "./events-DKfSmoTj.mjs";
+import { t as DEVFRAME_EVENTS } from "./events-DzolaBEs.mjs";
 //#region src/node/auth/revoke.ts
 /**
 * Flip `isTrusted` to false on any live WS clients connected with `token`

package/dist/rpc/transports/ws-bun.d.mts

@@ -1,5 +1,5 @@
 import { n as WsOriginRegistry } from "../../ws-server-DLtEoLdR.mjs";
-import { t as ContextRpcServer } from "../../rpc-core-CDZoGYiD.mjs";
+import { t as ContextRpcServer } from "../../rpc-core-Oyz-cJBC.mjs";
 //#region src/rpc/transports/ws-bun.d.ts
 interface AttachBunWsTransportOptions {
   /** Same contract as `WsRpcTransportOptions.allowedOrigins`. */

package/dist/rpc/transports/ws-deno.d.mts

@@ -1,5 +1,5 @@
 import { n as WsOriginRegistry } from "../../ws-server-DLtEoLdR.mjs";
-import { t as ContextRpcServer } from "../../rpc-core-CDZoGYiD.mjs";
+import { t as ContextRpcServer } from "../../rpc-core-Oyz-cJBC.mjs";
 //#region src/rpc/transports/ws-deno.d.ts
 interface AttachDenoWsTransportOptions {
   /** Same contract as `WsRpcTransportOptions.allowedOrigins`. */

package/dist/{rpc-core-CDZoGYiD.d.mts → rpc-core-Oyz-cJBC.d.mts}

@@ -1,6 +1,6 @@
 import { d as DevframeRpcConnection, u as DevframeNodeRpcSessionMeta } from "./ws-server-DLtEoLdR.mjs";
-import { Ct as DevframeAuthHandler, _t as DevframeRpcServerFunctions, gt as DevframeRpcClientFunctions, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "./context-_i51nYOs.mjs";
-import "./index-CEvd-YXD.mjs";
+import { Ct as DevframeAuthHandler, _t as DevframeRpcServerFunctions, gt as DevframeRpcClientFunctions, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "./context-c0OlSc12.mjs";
+import "./index-B_DPNIT4.mjs";
 import { BirpcGroup, EventOptions } from "birpc";
 //#region src/node/rpc-core.d.ts
 interface CreateContextRpcServerOptions {

package/dist/types/index.d.mts

@@ -1,6 +1,6 @@
 import { g as RpcFunctionAgentOptions } from "../types-BBLeGfpt.mjs";
 import { d as DevframeRpcConnection, f as DevframeRpcConnectionRequest, p as DevframeRpcTransportKind, u as DevframeNodeRpcSessionMeta } from "../ws-server-DLtEoLdR.mjs";
-import { $ as DevframeServicesHost, At as AgentResource, B as DevframeSetupInfo, Bt as EventUnsubscribe, F as DevframeDefinition, Ft as AgentToolProvider, G as McpRouteOptions, H as DevframeSnapshotRpcInputs, I as DevframeDeploymentKind, It as AgentToolProviderHandle, J as DevframeServiceId, K as DevframeServiceDefinition, L as DevframeDockDefaults, Lt as DevframeAgentHost, Mt as AgentResourceInput, Nt as AgentTool, Ot as AgentHandle, P as DevframeCliOptions, Pt as AgentToolInput, Q as DevframeServiceScopeOf, R as DevframeDuplicationStrategy, Rt as DevframeAgentHostEvents, St as DevframeDiagnosticsLogger, U as DevframeSseOptions, V as DevframeSnapshotRpcEntry, Vt as EventsMap, W as DevframeWsOptions, X as DevframeServiceMeta, Y as DevframeServiceInput, Z as DevframeServiceOf, _t as DevframeRpcServerFunctions, a as DevframeConnectionConfigsRegistry, at as DevframeScopedStreamingHost, bt as DevframeStorageScope, c as RpcBroadcastOptions, ct as DevframeSettingsStore, d as RpcSharedStateHost, dt as ScopedRpcFn, et as DevframeServicesRegistry, f as RpcStreamingChannel, ft as ScopedServerFunctions, gt as DevframeRpcClientFunctions, ht as DevframeViewHost, i as DevframeCapabilities, it as DevframeScopedNodeRpc, jt as AgentResourceContent, kt as AgentManifest, l as RpcFunctionsHost, lt as ScopedBroadcastOptions, m as RpcStreamingHost, mt as SettingsForNamespace, n as ConnectionMetaSse, nt as DevframeServicesState, o as DevframeNodeContext, ot as DevframeSettings, p as RpcStreamingChannelOptions, pt as ScopedSharedStates, q as DevframeServiceDescriptor, r as ConnectionMetaWebsocket, rt as DevframeScopedNodeContext, s as DevframeNodeRpcSession, st as DevframeSettingsRegistry, t as ConnectionMeta, tt as DevframeServicesScopeRegistry, u as RpcSharedStateGetOptions, ut as ScopedClientFunctions, vt as DevframeRpcSharedStates, xt as DevframeDiagnosticsHost, yt as DevframeHost, z as DevframeRpcOptions, zt as EventEmitter } from "../context-_i51nYOs.mjs";
-import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "../remote-assets-Bg4gCUZ_.mjs";
+import { $ as DevframeServicesHost, At as AgentResource, B as DevframeSetupInfo, Bt as EventUnsubscribe, F as DevframeDefinition, Ft as AgentToolProvider, G as McpRouteOptions, H as DevframeSnapshotRpcInputs, I as DevframeDeploymentKind, It as AgentToolProviderHandle, J as DevframeServiceId, K as DevframeServiceDefinition, L as DevframeDockDefaults, Lt as DevframeAgentHost, Mt as AgentResourceInput, Nt as AgentTool, Ot as AgentHandle, P as DevframeCliOptions, Pt as AgentToolInput, Q as DevframeServiceScopeOf, R as DevframeDuplicationStrategy, Rt as DevframeAgentHostEvents, St as DevframeDiagnosticsLogger, U as DevframeSseOptions, V as DevframeSnapshotRpcEntry, Vt as EventsMap, W as DevframeWsOptions, X as DevframeServiceMeta, Y as DevframeServiceInput, Z as DevframeServiceOf, _t as DevframeRpcServerFunctions, a as DevframeConnectionConfigsRegistry, at as DevframeScopedStreamingHost, bt as DevframeStorageScope, c as RpcBroadcastOptions, ct as DevframeSettingsStore, d as RpcSharedStateHost, dt as ScopedRpcFn, et as DevframeServicesRegistry, f as RpcStreamingChannel, ft as ScopedServerFunctions, gt as DevframeRpcClientFunctions, ht as DevframeViewHost, i as DevframeCapabilities, it as DevframeScopedNodeRpc, jt as AgentResourceContent, kt as AgentManifest, l as RpcFunctionsHost, lt as ScopedBroadcastOptions, m as RpcStreamingHost, mt as SettingsForNamespace, n as ConnectionMetaSse, nt as DevframeServicesState, o as DevframeNodeContext, ot as DevframeSettings, p as RpcStreamingChannelOptions, pt as ScopedSharedStates, q as DevframeServiceDescriptor, r as ConnectionMetaWebsocket, rt as DevframeScopedNodeContext, s as DevframeNodeRpcSession, st as DevframeSettingsRegistry, t as ConnectionMeta, tt as DevframeServicesScopeRegistry, u as RpcSharedStateGetOptions, ut as ScopedClientFunctions, vt as DevframeRpcSharedStates, xt as DevframeDiagnosticsHost, yt as DevframeHost, z as DevframeRpcOptions, zt as EventEmitter } from "../context-c0OlSc12.mjs";
+import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "../remote-assets-B13_vRkJ.mjs";
 import { i as DevframeDefineDiagnosticsOptions } from "../nostics-SPGDgHEP.mjs";
 export { AgentHandle, AgentManifest, AgentResource, AgentResourceContent, AgentResourceInput, AgentTool, AgentToolInput, AgentToolProvider, AgentToolProviderHandle, ConnectionMeta, ConnectionMetaSse, ConnectionMetaWebsocket, DevframeAgentHost, DevframeAgentHostEvents, DevframeCapabilities, DevframeCliOptions, DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, DevframeDefinition, DevframeDeploymentKind, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeDockDefaults, DevframeDuplicationStrategy, DevframeHost, DevframeNodeContext, DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, DevframeRpcOptions, DevframeRpcServerFunctions, DevframeRpcSharedStates, type DevframeRpcTransportKind, DevframeScopedNodeContext, DevframeScopedNodeRpc, DevframeScopedStreamingHost, DevframeServiceDefinition, DevframeServiceDescriptor, DevframeServiceId, DevframeServiceInput, DevframeServiceMeta, DevframeServiceOf, DevframeServiceScopeOf, DevframeServicesHost, DevframeServicesRegistry, DevframeServicesScopeRegistry, DevframeServicesState, DevframeSettings, DevframeSettingsRegistry, DevframeSettingsStore, DevframeSetupInfo, DevframeSnapshotRpcEntry, DevframeSnapshotRpcInputs, DevframeSseOptions, DevframeStorageScope, DevframeViewHost, DevframeWsOptions, EventEmitter, EventUnsubscribe, EventsMap, McpRouteOptions, RemoteAssets, RemoteAssetsErrorMessage, RemoteAssetsProvider, RemoteAssetsProviderCustom, RemoteAssetsStore, RpcBroadcastOptions, type RpcFunctionAgentOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, ScopedBroadcastOptions, ScopedClientFunctions, ScopedRpcFn, ScopedServerFunctions, ScopedSharedStates, SettingsForNamespace, StaticAssetsSource };

package/dist/utils/events.d.mts

@@ -1,4 +1,4 @@
-import { Vt as EventsMap, zt as EventEmitter } from "../context-_i51nYOs.mjs";
+import { Vt as EventsMap, zt as EventEmitter } from "../context-c0OlSc12.mjs";
 //#region src/utils/events.d.ts
 /**
  * Create event emitter.

package/dist/utils/remote-assets.d.mts

@@ -1,4 +1,4 @@
-import { a as RemoteAssetsStore, o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
+import { a as RemoteAssetsStore, o as StaticAssetsSource } from "../remote-assets-B13_vRkJ.mjs";
 //#region src/utils/remote-assets.d.ts
 /**
  * Normalize a {@link StaticAssetsSource} into something servable: a local

package/dist/utils/serve-static.d.mts

@@ -1,4 +1,4 @@
-import { a as RemoteAssetsStore } from "../remote-assets-Bg4gCUZ_.mjs";
+import { a as RemoteAssetsStore } from "../remote-assets-B13_vRkJ.mjs";
 import { IncomingMessage, ServerResponse } from "node:http";
 import { EventHandler, H3 } from "h3";
 //#region src/utils/serve-static.d.ts

package/dist/utils/serve-static.mjs

@@ -1,4 +1,4 @@
-import { t as DEVFRAME_EVENTS } from "../events-DKfSmoTj.mjs";
+import { t as DEVFRAME_EVENTS } from "../events-DzolaBEs.mjs";
 import { extname, join, normalize, resolve, sep } from "pathe";
 import { createReadStream } from "node:fs";
 import { stat } from "node:fs/promises";

package/dist/utils/shared-state.d.mts

@@ -1,2 +1,2 @@
-import { A as SharedStateEvents, D as ImmutableObject, E as ImmutableMap, M as SharedStatePatch, N as createSharedState, O as ImmutableSet, T as ImmutableArray, j as SharedStateOptions, k as SharedState, w as Immutable } from "../context-_i51nYOs.mjs";
+import { A as SharedStateEvents, D as ImmutableObject, E as ImmutableMap, M as SharedStatePatch, N as createSharedState, O as ImmutableSet, T as ImmutableArray, j as SharedStateOptions, k as SharedState, w as Immutable } from "../context-c0OlSc12.mjs";
 export { Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableSet, SharedState, SharedStateEvents, SharedStateOptions, SharedStatePatch, createSharedState };

package/dist/utils/streaming-channel.d.mts

@@ -1,2 +1,2 @@
-import { C as createStreamSink, S as createStreamReader, _ as CreateStreamSinkOptions, b as StreamSink, g as CreateStreamReaderOptions, h as BufferedChunk, v as StreamErrorPayload, x as StreamSinkEvents, y as StreamReader } from "../context-_i51nYOs.mjs";
+import { C as createStreamSink, S as createStreamReader, _ as CreateStreamSinkOptions, b as StreamSink, g as CreateStreamReaderOptions, h as BufferedChunk, v as StreamErrorPayload, x as StreamSinkEvents, y as StreamReader } from "../context-c0OlSc12.mjs";
 export { BufferedChunk, CreateStreamReaderOptions, CreateStreamSinkOptions, StreamErrorPayload, StreamReader, StreamSink, StreamSinkEvents, createStreamReader, createStreamSink };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "devframe",
   "type": "module",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Framework for building one portable devtool integration that runs in any viewer.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",

package/skills/devframe/SKILL.md

@@ -77,7 +77,7 @@ export default defineDevframe({
   homepage: pkg.homepage,
   description: pkg.description,
   icon: 'ph:magnifying-glass-duotone',
-  cli: { distDir: './client/dist' },
+  clientAssets: './client/dist', // built SPA served as the UI
   setup(ctx) {
     const my = ctx.scope('my-inspector') // preferred — auto-namespaces ids
     my.rpc.register(defineRpcFunction({
@@ -540,7 +540,7 @@ Built-in context: `clientType` (`'embedded' | 'standalone'`), `dockOpen`, `palet
 
 | Subcommand | Action |
 |------------|--------|
-| *(default)* | Dev server (port 9999 or `--port`) — WebSocket RPC, `cli.distDir` served at the base |
+| *(default)* | Dev server (port 9999 or `--port`) — WebSocket RPC, `clientAssets` served at the base |
 | `build` | Static snapshot → `./dist-static/` (`--out-dir`) |
 | `mcp` | stdio MCP server |
 

package/skills/devframe/templates/hub.ts

@@ -6,7 +6,7 @@
 // `hub.handler` is a Web-Standard `(request: Request) => Promise<Response>`;
 // mount it on a catch-all route (Hono, Nitro, Next, SvelteKit, ...) exactly
 // like an `initDevframe` instance. `hub.nodeMiddleware` is the Connect-style
-// form for Vite/Rsbuild. See docs/adapters/initiate.md for the mount snippets
+// form for Vite/Rsbuild. See docs/content/2.adapters/1.initiate.md for the mount snippets
 // and the WebSocket-binding precedence (`ws.port` / `server` / `ws.sidecar` /
 // host-attached `hub.attach(server)`).
 import { createUi } from '@devframes/hub-ui'