devframe 0.9.0-beta.1 → 0.9.0-beta.3

package/dist/{devframe-Bdd9YXTy.d.mts → devframe-5oblos7I.d.mts}

@@ -1,6 +1,6 @@
-import { d as RpcFunctionsCollectorBase } from "./index-DSCq4M4q.mjs";
-import { _ as RpcFunctionDefinition, v as RpcFunctionDefinitionAny } from "./types-CnJSgRVa.mjs";
-import { d as DevframeRpcConnection, u as DevframeNodeRpcSessionMeta } from "./ws-server-Ces08fjP.mjs";
+import { d as RpcFunctionsCollectorBase } from "./index-tdrk1bzV.mjs";
+import { _ as RpcFunctionDefinition, v as RpcFunctionDefinitionAny } from "./types-Djq7CBXh.mjs";
+import { d as DevframeRpcConnection, u as DevframeNodeRpcSessionMeta } from "./ws-server-D1d3QM9f.mjs";
 import { CAC } from "cac";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 import { BirpcReturn } from "birpc";
@@ -119,9 +119,6 @@ interface EventEmitter<Events extends EventsMap> {
  * Serializable description of an agent-exposed tool. This is the shape
  * returned by the agent host manifest and surfaced over the wire by
  * the `devframe:agent:list-tools` introspection RPC.
- *
- * @experimental The agent-native surface is experimental and may change
- * without a major version bump until it stabilizes.
  */
 interface AgentTool {
   /** Stable identifier. For RPC-backed tools, matches the RPC name. */
@@ -159,8 +156,6 @@ interface AgentTool {
 /**
  * Input accepted by `DevframeAgentHost.registerTool()`. Handler is
  * stripped from the serializable `AgentTool` projection.
- *
- * @experimental
  */
 interface AgentToolInput {
   id: string;
@@ -191,8 +186,6 @@ interface AgentToolInput {
 /**
  * Serializable description of an agent-readable resource. Resources
  * surface structured or textual snapshots of devframe state.
- *
- * @experimental
  */
 interface AgentResource {
   id: string;
@@ -205,8 +198,6 @@ interface AgentResource {
 }
 /**
  * Input accepted by `DevframeAgentHost.registerResource()`.
- *
- * @experimental
  */
 interface AgentResourceInput {
   id: string;
@@ -220,8 +211,6 @@ interface AgentResourceInput {
 }
 /**
  * Payload returned by `AgentResourceInput.read`. Either `text` or `json` must be set.
- *
- * @experimental
  */
 interface AgentResourceContent {
   text?: string;
@@ -231,8 +220,6 @@ interface AgentResourceContent {
 }
 /**
  * Unified view of the agent-exposed surface.
- *
- * @experimental
  */
 interface AgentManifest {
   tools: readonly AgentTool[];
@@ -240,8 +227,6 @@ interface AgentManifest {
 }
 /**
  * Handle returned by `registerTool` / `registerResource`.
- *
- * @experimental
  */
 interface AgentHandle {
   unregister: () => void;
@@ -256,14 +241,10 @@ interface AgentHandle {
  * Providers should namespace tool ids like any other tool; on an id
  * collision the earlier source wins (registered tools, then RPC tools,
  * then providers in registration order).
- *
- * @experimental
  */
 type AgentToolProvider = () => readonly AgentToolInput[];
 /**
  * Handle returned by `registerToolProvider`.
- *
- * @experimental
  */
 interface AgentToolProviderHandle extends AgentHandle {
   /**
@@ -275,8 +256,6 @@ interface AgentToolProviderHandle extends AgentHandle {
 }
 /**
  * Events emitted by `DevframeAgentHost`.
- *
- * @experimental
  */
 interface DevframeAgentHostEvents {
   'agent:tool:registered': (tool: AgentTool) => void;
@@ -294,9 +273,6 @@ interface DevframeAgentHostEvents {
  * RPC functions flagged with `agent` and plugin-registered tools /
  * resources. Consumed by protocol adapters such as the devframe MCP
  * adapter.
- *
- * @experimental The agent-native surface is experimental and may change
- * without a major version bump until it stabilizes.
  */
 interface DevframeAgentHost {
   readonly events: EventEmitter<DevframeAgentHostEvents>;
@@ -1303,8 +1279,6 @@ interface DevframeNodeContext {
   diagnostics: DevframeDiagnosticsHost;
   /**
    * Agent host — aggregates the agent-exposed surface of this devtool.
-   *
-   * @experimental
    */
   agent: DevframeAgentHost;
   /**
@@ -1316,6 +1290,22 @@ interface DevframeNodeContext {
    * absorb setup-order differences between provider and consumer.
    */
   services: DevframeServicesHost;
+  /**
+   * This context's own {@link ConnectionMeta.configs} — static, boot-time
+   * config a host publishes once through the connection handshake and every
+   * client reads read-only. A plain, **non-reactive** object: mutate it
+   * during `setup(ctx)` (a plugin sets its keys, a hub aggregates across
+   * every installed devframe), never during the session — it's serialized
+   * once, after setup, and changing it afterwards reaches no client.
+   *
+   * ```ts
+   * ctx.staticConfig.dock = {
+   *   ...ctx.staticConfig.dock,
+   *   categoryOrder: { ...ctx.staticConfig.dock?.categoryOrder, ...myOrder },
+   * }
+   * ```
+   */
+  staticConfig: Partial<DevframeConnectionConfigsRegistry>;
   /**
    * Create a namespace-scoped view of this context. The returned
    * `ctx.scope('my-plugin')` auto-namespaces every RPC id, shared-state
@@ -1406,7 +1396,7 @@ interface ConnectionMeta {
    * tooling (e.g. an MCP inspector) can discover it without guessing the
    * path. `path` is relative to `__connection.json`'s location, like the
    * WebSocket `path`. `port` is set when the endpoint lives on a side-car
-   * server on its own port (bridge mode — `viteDevBridge`,
+   * server on its own port (bridge mode — `devframeViteBridge`,
    * `@devframes/next`): the client combines the page hostname with `port`
    * and resolves `path` against that origin, mirroring
    * {@link ConnectionMetaWebsocket.port}.
@@ -1457,7 +1447,38 @@ interface ConnectionMeta {
    * token same-origin until the requesting origin has been verified.
    */
   viewerOriginToken?: string;
+  /**
+   * Static, host-declared configuration — baked in once at connect time and
+   * fixed for the life of the server (e.g. a hub's UI rebrand, or its
+   * aggregated dock-bar layout preferences). Read-only from the browser: a
+   * client only ever reads `rpc.connectionMeta.configs`, never writes to it.
+   *
+   * Contrast this with {@link DevframeSettingsRegistry} (`ctx.scope(ns).settings`)
+   * and a hub's `devframe:user-settings` shared-state key — both are
+   * mutable, user-editable, and synced bidirectionally over RPC for the
+   * life of the session. `configs` is the opposite: one-way, immutable,
+   * decided by whoever assembled the server.
+   *
+   * Each key is owned by one package, contributed via declaration merging:
+   *
+   * ```ts
+   * declare module 'devframe/types' {
+   *   interface DevframeConnectionConfigsRegistry {
+   *     'my-key': { some: 'shape' }
+   *   }
+   * }
+   * ```
+   */
+  configs?: Partial<DevframeConnectionConfigsRegistry>;
 }
+/**
+ * Augmentation point for {@link ConnectionMeta.configs}. Empty by default —
+ * a package that wants to publish static, boot-time config through the
+ * connection handshake augments this interface with its own key (see
+ * {@link ConnectionMeta.configs} for the pattern). `@devframes/hub`
+ * augments it with `dock`; `@devframes/hub-ui` augments it with `ui`.
+ */
+interface DevframeConnectionConfigsRegistry {}
 //#endregion
 //#region src/types/utils.d.ts
 type Thenable<T> = T | Promise<T>;
@@ -1601,9 +1622,6 @@ interface DevframeSseOptions {
  * the MCP Streamable-HTTP transport over the same origin as the SPA,
  * exposing the definition's `ctx.agent` tools + shared-state resources to
  * external MCP clients connected to the *running* server.
- *
- * @experimental The agent-native surface is experimental and may change
- * without a major version bump until it stabilizes.
  */
 interface McpRouteOptions {
   /**
@@ -1676,8 +1694,6 @@ interface DevframeCliOptions {
    * - {@link McpRouteOptions} — customise the route path / allowed origins.
    *
    * The `--mcp` / `--no-mcp` CLI flags override this per run.
-   *
-   * @experimental
    */
   mcp?: boolean | McpRouteOptions;
   /** Author's SPA dist directory (served as the devframe's UI). */
@@ -1862,4 +1878,4 @@ interface DevframeDefinition {
   spa?: DevframeSpaOptions;
 }
 //#endregion
-export { DevframeRpcClientFunctions as $, DevframeSettingsRegistry as A, DevframeAgentHost as At, DevframeStorageScope as B, DevframeServiceOf as C, AgentResource as Ct, DevframeScopedNodeRpc as D, AgentToolInput as Dt, DevframeScopedNodeContext as E, AgentTool as Et, ScopedServerFunctions as F, CliFlagsSchema as Ft, DevframeNodeRpcSession as G, DevframeDiagnosticsDefinition as H, ScopedSharedStates as I, InferCliFlags as It, RpcSharedStateGetOptions as J, RpcBroadcastOptions as K, SettingsForNamespace as L, defineCliFlags as Lt, ScopedBroadcastOptions as M, EventEmitter as Mt, ScopedClientFunctions as N, EventUnsubscribe as Nt, DevframeScopedStreamingHost as O, AgentToolProvider as Ot, ScopedRpcFn as P, EventsMap as Pt, RpcStreamingHost as Q, DevframeViewHost as R, parseCliFlags as Rt, DevframeServiceId as S, AgentManifest as St, DevframeServicesRegistry as T, AgentResourceInput as Tt, DevframeDiagnosticsHost as U, DevframeDefineDiagnosticsOptions as V, DevframeDiagnosticsLogger as W, RpcStreamingChannel as X, RpcSharedStateHost as Y, RpcStreamingChannelOptions as Z, ConnectionMeta as _, SharedStateEvents as _t, DevframeDockDefaults as a, StreamErrorPayload as at, DevframeCapabilities as b, createSharedState as bt, DevframeSetupInfo as c, StreamSinkEvents as ct, DevframeWsOptions as d, Immutable as dt, DevframeRpcServerFunctions as et, McpRouteOptions as f, ImmutableArray as ft, Thenable as g, SharedState as gt, PartialWithoutId as h, ImmutableSet as ht, DevframeDeploymentKind as i, CreateStreamSinkOptions as it, DevframeSettingsStore as j, DevframeAgentHostEvents as jt, DevframeSettings as k, AgentToolProviderHandle as kt, DevframeSpaOptions as l, createStreamReader as lt, EntriesToObject as m, ImmutableObject as mt, DevframeCliOptions as n, BufferedChunk as nt, DevframeDuplicationStrategy as o, StreamReader as ot, DevframeAuthHandler as p, ImmutableMap as pt, RpcFunctionsHost as q, DevframeDefinition as r, CreateStreamReaderOptions as rt, DevframeRuntime as s, StreamSink as st, DevframeBrowserContext as t, DevframeRpcSharedStates as tt, DevframeSseOptions as u, createStreamSink as ut, ConnectionMetaSse as v, SharedStateOptions as vt, DevframeServicesHost as w, AgentResourceContent as wt, DevframeNodeContext as x, AgentHandle as xt, ConnectionMetaWebsocket as y, SharedStatePatch as yt, DevframeHost as z };
+export { RpcStreamingHost as $, DevframeSettings as A, AgentToolProviderHandle as At, DevframeHost as B, DevframeServiceId as C, AgentManifest as Ct, DevframeScopedNodeContext as D, AgentTool as Dt, DevframeServicesRegistry as E, AgentResourceInput as Et, ScopedRpcFn as F, EventsMap as Ft, DevframeDiagnosticsLogger as G, DevframeDefineDiagnosticsOptions as H, ScopedServerFunctions as I, CliFlagsSchema as It, RpcFunctionsHost as J, DevframeNodeRpcSession as K, ScopedSharedStates as L, InferCliFlags as Lt, DevframeSettingsStore as M, DevframeAgentHostEvents as Mt, ScopedBroadcastOptions as N, EventEmitter as Nt, DevframeScopedNodeRpc as O, AgentToolInput as Ot, ScopedClientFunctions as P, EventUnsubscribe as Pt, RpcStreamingChannelOptions as Q, SettingsForNamespace as R, defineCliFlags as Rt, DevframeNodeContext as S, AgentHandle as St, DevframeServicesHost as T, AgentResourceContent as Tt, DevframeDiagnosticsDefinition as U, DevframeStorageScope as V, DevframeDiagnosticsHost as W, RpcSharedStateHost as X, RpcSharedStateGetOptions as Y, RpcStreamingChannel as Z, ConnectionMeta as _, SharedState as _t, DevframeDockDefaults as a, CreateStreamSinkOptions as at, DevframeCapabilities as b, SharedStatePatch as bt, DevframeSetupInfo as c, StreamSink as ct, DevframeWsOptions as d, createStreamSink as dt, DevframeRpcClientFunctions as et, McpRouteOptions as f, Immutable as ft, Thenable as g, ImmutableSet as gt, PartialWithoutId as h, ImmutableObject as ht, DevframeDeploymentKind as i, CreateStreamReaderOptions as it, DevframeSettingsRegistry as j, DevframeAgentHost as jt, DevframeScopedStreamingHost as k, AgentToolProvider as kt, DevframeSpaOptions as l, StreamSinkEvents as lt, EntriesToObject as m, ImmutableMap as mt, DevframeCliOptions as n, DevframeRpcSharedStates as nt, DevframeDuplicationStrategy as o, StreamErrorPayload as ot, DevframeAuthHandler as p, ImmutableArray as pt, RpcBroadcastOptions as q, DevframeDefinition as r, BufferedChunk as rt, DevframeRuntime as s, StreamReader as st, DevframeBrowserContext as t, DevframeRpcServerFunctions as tt, DevframeSseOptions as u, createStreamReader as ut, ConnectionMetaSse as v, SharedStateEvents as vt, DevframeServiceOf as w, AgentResource as wt, DevframeConnectionConfigsRegistry as x, createSharedState as xt, ConnectionMetaWebsocket as y, SharedStateOptions as yt, DevframeViewHost as z, parseCliFlags as zt };

package/dist/{diagnostics-DLYH5oD3.mjs → diagnostics-C7IGWppM.mjs}

@@ -38,7 +38,7 @@ const diagnostics = defineDiagnostics({
 		},
 		DF0033: {
 			why: (p) => `Failed to start dev RPC bridge for "${p.id}": ${p.reason}`,
-			fix: "Verify the bridge port is free and the devframe setup function does not throw. Pin a port via `cli.port` / `cli.portRange` on the definition, or via `devMiddleware.port` on `viteDevBridge`."
+			fix: "Verify the bridge port is free and the devframe setup function does not throw. Pin a port via `cli.port` / `cli.portRange` on the definition, or via `port` on `devframeViteBridge` (`@devframes/vite`)."
 		},
 		DF0034: {
 			why: (p) => `Scoped RPC registration for namespace "${p.namespace}" received an already-namespaced function name "${p.name}".`,
@@ -90,7 +90,7 @@ const diagnostics = defineDiagnostics({
 		},
 		DF0052: {
 			why: (p) => `Failed to listen on ${p.host}:${p.port}: ${p.reason}`,
-			fix: "The port is likely already taken by another process (often a previous devframe instance). Free it, or pick another via `--port`, `cli.port` / `cli.portRange` on the definition, or `devMiddleware.port` on `viteDevBridge`. The original node error is available as `error.cause`."
+			fix: "The port is likely already taken by another process (often a previous devframe instance). Free it, or pick another via `--port`, `cli.port` / `cli.portRange` on the definition, or `port` on `devframeViteBridge` (`@devframes/vite`). The original node error is available as `error.cause`."
 		},
 		DF0054: {
 			why: (p) => `connectionMeta() was called before initDevframe("${p.id}") finished initializing.`,

package/dist/{host-agent-CpbAoqBx.mjs → host-agent-BBkKT27Q.mjs}

@@ -1,5 +1,5 @@
-import { t as diagnostics } from "./diagnostics-DLYH5oD3.mjs";
-import { i as createEventEmitter } from "./storage-BcmVEJRc.mjs";
+import { t as diagnostics } from "./diagnostics-C7IGWppM.mjs";
+import { i as createEventEmitter } from "./storage-CaUVrBrG.mjs";
 //#region src/node/agent-args.ts
 /**
 * Map the args payload an agent surface receives (MCP sends an object
@@ -14,8 +14,6 @@ import { i as createEventEmitter } from "./storage-BcmVEJRc.mjs";
 * - without schemas, `arg0`/`arg1`/… keys are collected when present
 * - an empty object becomes a zero-argument call
 * - anything else follows the {@link AgentArgsFallback}
-*
-* @experimental
 */
 function coerceAgentPositionalArgs(args, schemas, fallback = "wrap") {
 	if (Array.isArray(args)) return args;
@@ -43,8 +41,6 @@ function coerceAgentPositionalArgs(args, schemas, fallback = "wrap") {
 * devframe. Auto-discovers RPC functions with an `agent` field from
 * `ctx.rpc.definitions`, and accepts plugin-registered tools /
 * resources via `registerTool` / `registerResource`.
-*
-* @experimental
 */
 var DevframeAgentHost = class {
 	context;

package/dist/{http-DLr_cJZ7.mjs → http-Z0w9baEe.mjs}

@@ -1,8 +1,8 @@
 import { n as __exportAll } from "./rolldown-runtime-JspESFgx.mjs";
 import { i as isAllowedOrigin } from "./ws-server-Bk1hOG3X.mjs";
-import { t as diagnostics } from "./diagnostics-DLYH5oD3.mjs";
-import { t as createHostContext } from "./context-Du11TLcO.mjs";
-import { t as toAgentToolName } from "./agent-tool-name-C3b5vEwJ.mjs";
+import { t as diagnostics } from "./diagnostics-C7IGWppM.mjs";
+import { t as createHostContext } from "./context-b6iSomtv.mjs";
+import { t as toAgentToolName } from "./agent-tool-name-EgfoFO8C.mjs";
 import { randomUUID } from "node:crypto";
 import { Diagnostic } from "nostics";
 import { join } from "pathe";
@@ -190,9 +190,6 @@ function buildMcpServerFromContext(ctx, options) {
 /**
 * Build an MCP server over the agent surface of a devframe definition.
 * Currently supports `stdio` transport only.
-*
-* @experimental The agent-native surface is experimental and may change
-* without a major version bump until it stabilizes.
 */
 async function createMcpServer(definition, options = {}) {
 	const transport = options.transport ?? "stdio";
@@ -463,8 +460,6 @@ function parseResourceUri(uri) {
 * loopback-default DNS-rebinding protection that — unlike the WS upgrade's
 * `isAllowedOrigin` — also rejects `Origin`-less requests, so a route-based
 * endpoint isn't reachable by an arbitrary local process.
-*
-* @experimental
 */
 function createMcpFetchHandler(ctx, options) {
 	const sessions = /* @__PURE__ */ new Map();
@@ -547,8 +542,6 @@ var http_exports = /* @__PURE__ */ __exportAll({ mountMcpHttp: () => mountMcpHtt
 * legitimate MCP 404 (unknown session) isn't swallowed by h3's
 * "Response-with-404 falls through to the next handler" rule (which would
 * otherwise hand the request to the SPA static catch-all).
-*
-* @experimental
 */
 function mountMcpHttp(app, ctx, path, options) {
 	const handler = createMcpFetchHandler(ctx, options);

package/dist/{index-CZRd2K1C.d.mts → index-BzDl02lt.d.mts}

@@ -1,5 +1,5 @@
-import { G as DevframeNodeRpcSession, gt as SharedState, x as DevframeNodeContext } from "./devframe-Bdd9YXTy.mjs";
-import { n as InternalAnonymousAuthStorage } from "./context-CSCwoABx.mjs";
+import { K as DevframeNodeRpcSession, S as DevframeNodeContext, _t as SharedState } from "./devframe-5oblos7I.mjs";
+import { n as InternalAnonymousAuthStorage } from "./context-DV4uWieM.mjs";
 //#region src/node/auth/revoke.d.ts
 /**
  * Flip `isTrusted` to false on any live WS clients connected with `token`

package/dist/{index-DSCq4M4q.d.mts → index-tdrk1bzV.d.mts}

@@ -1,4 +1,4 @@
-import { C as RpcFunctionType, S as RpcFunctionSetupResult, T as RpcReturnSchema, _ as RpcFunctionDefinition, i as RpcArgsSchema, v as RpcFunctionDefinitionAny, w as RpcFunctionsCollector } from "./types-CnJSgRVa.mjs";
+import { C as RpcFunctionType, S as RpcFunctionSetupResult, T as RpcReturnSchema, _ as RpcFunctionDefinition, i as RpcArgsSchema, v as RpcFunctionDefinitionAny, w as RpcFunctionsCollector } from "./types-Djq7CBXh.mjs";
 //#region src/rpc/cache.d.ts
 interface RpcCacheOptions {
   functions: string[];

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { $ as DevframeRpcClientFunctions, A as DevframeSettingsRegistry, At as DevframeAgentHost, B as DevframeStorageScope, C as DevframeServiceOf, Ct as AgentResource, D as DevframeScopedNodeRpc, Dt as AgentToolInput, E as DevframeScopedNodeContext, Et as AgentTool, F as ScopedServerFunctions, G as DevframeNodeRpcSession, H as DevframeDiagnosticsDefinition, I as ScopedSharedStates, J as RpcSharedStateGetOptions, K as RpcBroadcastOptions, L as SettingsForNamespace, M as ScopedBroadcastOptions, Mt as EventEmitter, N as ScopedClientFunctions, Nt as EventUnsubscribe, O as DevframeScopedStreamingHost, Ot as AgentToolProvider, P as ScopedRpcFn, Pt as EventsMap, Q as RpcStreamingHost, R as DevframeViewHost, S as DevframeServiceId, St as AgentManifest, T as DevframeServicesRegistry, Tt as AgentResourceInput, U as DevframeDiagnosticsHost, V as DevframeDefineDiagnosticsOptions, W as DevframeDiagnosticsLogger, X as RpcStreamingChannel, Y as RpcSharedStateHost, Z as RpcStreamingChannelOptions, _ as ConnectionMeta, a as DevframeDockDefaults, b as DevframeCapabilities, c as DevframeSetupInfo, d as DevframeWsOptions, et as DevframeRpcServerFunctions, f as McpRouteOptions, g as Thenable, h as PartialWithoutId, i as DevframeDeploymentKind, j as DevframeSettingsStore, jt as DevframeAgentHostEvents, k as DevframeSettings, kt as AgentToolProviderHandle, l as DevframeSpaOptions, m as EntriesToObject, n as DevframeCliOptions, o as DevframeDuplicationStrategy, q as RpcFunctionsHost, r as DevframeDefinition, s as DevframeRuntime, t as DevframeBrowserContext, tt as DevframeRpcSharedStates, u as DevframeSseOptions, v as ConnectionMetaSse, w as DevframeServicesHost, wt as AgentResourceContent, x as DevframeNodeContext, xt as AgentHandle, y as ConnectionMetaWebsocket, z as DevframeHost } from "./devframe-Bdd9YXTy.mjs";
-import "./index-DSCq4M4q.mjs";
-import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-CnJSgRVa.mjs";
-import { d as DevframeRpcConnection, f as DevframeRpcConnectionRequest, p as DevframeRpcTransportKind, u as DevframeNodeRpcSessionMeta } from "./ws-server-Ces08fjP.mjs";
+import { $ as RpcStreamingHost, A as DevframeSettings, At as AgentToolProviderHandle, B as DevframeHost, C as DevframeServiceId, Ct as AgentManifest, D as DevframeScopedNodeContext, Dt as AgentTool, E as DevframeServicesRegistry, Et as AgentResourceInput, F as ScopedRpcFn, Ft as EventsMap, G as DevframeDiagnosticsLogger, H as DevframeDefineDiagnosticsOptions, I as ScopedServerFunctions, J as RpcFunctionsHost, K as DevframeNodeRpcSession, L as ScopedSharedStates, M as DevframeSettingsStore, Mt as DevframeAgentHostEvents, N as ScopedBroadcastOptions, Nt as EventEmitter, O as DevframeScopedNodeRpc, Ot as AgentToolInput, P as ScopedClientFunctions, Pt as EventUnsubscribe, Q as RpcStreamingChannelOptions, R as SettingsForNamespace, S as DevframeNodeContext, St as AgentHandle, T as DevframeServicesHost, Tt as AgentResourceContent, U as DevframeDiagnosticsDefinition, V as DevframeStorageScope, W as DevframeDiagnosticsHost, X as RpcSharedStateHost, Y as RpcSharedStateGetOptions, Z as RpcStreamingChannel, _ as ConnectionMeta, a as DevframeDockDefaults, b as DevframeCapabilities, c as DevframeSetupInfo, d as DevframeWsOptions, et as DevframeRpcClientFunctions, f as McpRouteOptions, g as Thenable, h as PartialWithoutId, i as DevframeDeploymentKind, j as DevframeSettingsRegistry, jt as DevframeAgentHost, k as DevframeScopedStreamingHost, kt as AgentToolProvider, l as DevframeSpaOptions, m as EntriesToObject, n as DevframeCliOptions, nt as DevframeRpcSharedStates, o as DevframeDuplicationStrategy, q as RpcBroadcastOptions, r as DevframeDefinition, s as DevframeRuntime, t as DevframeBrowserContext, tt as DevframeRpcServerFunctions, u as DevframeSseOptions, v as ConnectionMetaSse, w as DevframeServiceOf, wt as AgentResource, x as DevframeConnectionConfigsRegistry, y as ConnectionMetaWebsocket, z as DevframeViewHost } from "./devframe-5oblos7I.mjs";
+import "./index-tdrk1bzV.mjs";
+import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-Djq7CBXh.mjs";
+import { d as DevframeRpcConnection, f as DevframeRpcConnectionRequest, p as DevframeRpcTransportKind, u as DevframeNodeRpcSessionMeta } from "./ws-server-D1d3QM9f.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>;
 /**
@@ -10,4 +10,4 @@ declare const defineRpcFunction: <NAME extends string, TYPE extends RpcFunctionT
  */
 declare function defineDevframe(d: DevframeDefinition): DevframeDefinition;
 //#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 DevframeBrowserContext, type DevframeCapabilities, type DevframeCliOptions, type DevframeDefineDiagnosticsOptions, type DevframeDefinition, type DevframeDeploymentKind, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockDefaults, type DevframeDuplicationStrategy, type DevframeHost, type DevframeNodeContext, type DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, type DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeRuntime, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceId, type DevframeServiceOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSpaOptions, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, type McpRouteOptions, type PartialWithoutId, 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 Thenable, 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 DevframeBrowserContext, type DevframeCapabilities, type DevframeCliOptions, type DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, type DevframeDefinition, type DevframeDeploymentKind, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockDefaults, type DevframeDuplicationStrategy, type DevframeHost, type DevframeNodeContext, type DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, type DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeRuntime, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceId, type DevframeServiceOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSpaOptions, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, type McpRouteOptions, type PartialWithoutId, 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 Thenable, defineDevframe, defineRpcFunction };

package/dist/{instance-registry-BQqGoDO9.mjs → instance-registry-Du_hbx-j.mjs}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-JspESFgx.mjs";
-import { t as diagnostics } from "./diagnostics-DLYH5oD3.mjs";
+import { t as diagnostics } from "./diagnostics-C7IGWppM.mjs";
 import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "pathe";
 import process from "node:process";
@@ -42,8 +42,6 @@ function isRegistryDisabled() {
 * crash are pruned by readers whose liveness probe fails. Registration never
 * throws — a write failure degrades to a coded warning (`DF0045`), since a
 * dev server must not die over discovery metadata.
-*
-* @experimental
 */
 function registerDevframeInstance(record, options = {}) {
 	const dir = resolveInstancesDir(options.instancesDir);
@@ -78,8 +76,6 @@ function registerDevframeInstance(record, options = {}) {
 /**
 * Read every record in the registry directory, dropping unparseable files.
 * Liveness is the caller's concern — see {@link probeDevframeInstance}.
-*
-* @experimental
 */
 function readDevframeInstances(options = {}) {
 	const dir = resolveInstancesDir(options.instancesDir);
@@ -155,8 +151,6 @@ async function probeDevframeInstance(record, options = {}) {
 * records left behind by killed processes shadow the server currently bound
 * there: per `(port, basePath)` only the newest record survives, older
 * ghosts are pruned with the dead.
-*
-* @experimental
 */
 async function listLiveDevframeInstances(options = {}) {
 	const dir = resolveInstancesDir(options.instancesDir);

package/dist/{instance-shell-DBTXTSjN.d.mts → instance-shell-B-BSVp37.d.mts}

@@ -1,6 +1,6 @@
-import { $ as DevframeRpcClientFunctions, G as DevframeNodeRpcSession, _ as ConnectionMeta, d as DevframeWsOptions, et as DevframeRpcServerFunctions, p as DevframeAuthHandler, u as DevframeSseOptions, x as DevframeNodeContext } from "./devframe-Bdd9YXTy.mjs";
-import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "./ws-server-Ces08fjP.mjs";
-import "./index-CZRd2K1C.mjs";
+import { K as DevframeNodeRpcSession, S as DevframeNodeContext, _ as ConnectionMeta, d as DevframeWsOptions, et as DevframeRpcClientFunctions, p as DevframeAuthHandler, tt as DevframeRpcServerFunctions, u as DevframeSseOptions } from "./devframe-5oblos7I.mjs";
+import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "./ws-server-D1d3QM9f.mjs";
+import "./index-BzDl02lt.mjs";
 import { BirpcGroup } from "birpc";
 import { NodeAdapter } from "crossws/adapters/node";
 import { Buffer } from "node:buffer";
@@ -11,9 +11,6 @@ import { H3 } from "h3";
 /**
  * One running devframe instance, as recorded in the instance registry.
  * Records are self-describing JSON — additive fields are safe.
- *
- * @experimental The agent-native surface is experimental and may change
- * without a major version bump until it stabilizes.
  */
 interface DevframeInstanceRecord {
   /** Process id of the dev server. */
@@ -42,8 +39,6 @@ interface DevframeInstanceRecord {
 }
 /**
  * Handle returned by {@link registerDevframeInstance}.
- *
- * @experimental
  */
 interface DevframeInstanceRegistration {
   /** The registry file backing this registration. */
@@ -65,8 +60,6 @@ interface DevframeInstanceRegistration {
  * crash are pruned by readers whose liveness probe fails. Registration never
  * throws — a write failure degrades to a coded warning (`DF0045`), since a
  * dev server must not die over discovery metadata.
- *
- * @experimental
  */
 declare function registerDevframeInstance(record: DevframeInstanceRecord, options?: {
   instancesDir?: string;
@@ -81,8 +74,6 @@ declare function registerDevframeInstance(record: DevframeInstanceRecord, option
  * records left behind by killed processes shadow the server currently bound
  * there: per `(port, basePath)` only the newest record survives, older
  * ghosts are pruned with the dead.
- *
- * @experimental
  */
 declare function listLiveDevframeInstances(options?: {
   instancesDir?: string;

package/dist/{instance-shell-KRdee1QF.mjs → instance-shell-B0TwOxCl.mjs}

@@ -1,6 +1,6 @@
 import "./constants.mjs";
-import { t as diagnostics } from "./diagnostics-DLYH5oD3.mjs";
-import { t as getInternalContext } from "./context-C33rR7n0.mjs";
+import { t as diagnostics } from "./diagnostics-C7IGWppM.mjs";
+import { t as getInternalContext } from "./context-CMSryXs-.mjs";
 import { createInteractiveAuth } from "./recipes/interactive-auth.mjs";
 import { createServer } from "node:http";
 import process from "node:process";
@@ -83,7 +83,7 @@ async function bindHttpAndWs(options) {
 	const origin = normalizeHttpServerUrl(bindHost, resolvedPort);
 	const internal = getInternalContext(context);
 	const wsUrl = `ws://${formatHostForUrl(bindHost)}:${resolvedPort}${options.path ?? ""}`;
-	if (websocket) internal.wsEndpoint = { url: wsUrl };
+	if (websocket) internal.setWsEndpoint({ url: wsUrl });
 	function connectionMeta() {
 		const jsonSerializableMethods = [];
 		for (const def of rpcHost.definitions.values()) if (def.jsonSerializable === true) jsonSerializableMethods.push(def.name);
@@ -103,7 +103,7 @@ async function bindHttpAndWs(options) {
 		async close() {
 			await closeWs();
 			if (ownsHttpServer) await new Promise((r) => httpServer.close(() => r()));
-			if (websocket && getInternalContext(context).wsEndpoint?.url === wsUrl) getInternalContext(context).wsEndpoint = void 0;
+			if (websocket && getInternalContext(context).wsEndpoint?.url === wsUrl) getInternalContext(context).setWsEndpoint(void 0);
 		}
 	};
 }
@@ -197,7 +197,7 @@ function createInstanceShell(options) {
 		const origin = currentOrigin();
 		if (!cfg || registerPromise || !origin || !meta) return;
 		const resolvedMeta = meta;
-		registerPromise = import("./instance-registry-BQqGoDO9.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
+		registerPromise = import("./instance-registry-Du_hbx-j.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
 			let port = 0;
 			try {
 				const url = new URL(origin);
@@ -257,7 +257,7 @@ function createInstanceShell(options) {
 	let resolvedAuth = false;
 	let corePromise;
 	function ensureCore() {
-		corePromise ??= import("./rpc-core-CqcJkAu9.mjs").then((n) => n.n).then(({ createContextRpcServer }) => createContextRpcServer({
+		corePromise ??= import("./rpc-core-Cva-0pw0.mjs").then((n) => n.n).then(({ createContextRpcServer }) => createContextRpcServer({
 			context: ctx,
 			auth: resolvedAuth,
 			onPeerConnect: options.onPeerConnect,
@@ -298,7 +298,7 @@ function createInstanceShell(options) {
 			allowedOrigins: options.allowedOrigins
 		});
 		if (ws.port != null) return await start(ws.port);
-		const { getPort } = await import("./dist-D8jAMwxU.mjs").then((n) => n.t);
+		const { getPort } = await import("./_shared-CGPVmXUM.mjs").then((n) => n.a);
 		let lastError;
 		for (let attempt = 0; attempt < 3; attempt++) {
 			const port = attempt === 0 && options.resolveSidecarPort ? await options.resolveSidecarPort(sidecarHost) : await getPort({
@@ -347,6 +347,7 @@ function createInstanceShell(options) {
 			...sseEnabled ? { sse: { path: advertisedSsePath } } : {},
 			...result.mcp ? { mcp: result.mcp } : {}
 		};
+		if (Object.keys(ctx.staticConfig).length > 0) meta.configs = ctx.staticConfig;
 		await options.mount?.(ctx, meta, api);
 		maybePrintBanner();
 		maybeRegister();
@@ -434,7 +435,7 @@ function createInstanceShell(options) {
 			const address = server.address();
 			if (typeof address !== "object" || !address) return;
 			const host = options.host ?? (address.address === "::" || address.address === "0.0.0.0" ? "localhost" : address.address);
-			getInternalContext(ctx).wsEndpoint = { url: `ws://${formatHostForUrl(host)}:${address.port}${routePath}` };
+			getInternalContext(ctx).setWsEndpoint({ url: `ws://${formatHostForUrl(host)}:${address.port}${routePath}` });
 		};
 		if (server.listening) record();
 		else server.once("listening", record);