devframe 0.9.7 → 0.9.9

package/dist/index.d.mts

@@ -1,23 +1,21 @@
-import "./index-BzyopqxV.mjs";
-import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-CMdPYhOx.mjs";
-import { d as DevframeRpcConnection, f as DevframeRpcConnectionRequest, p as DevframeRpcTransportKind, u as DevframeNodeRpcSessionMeta } from "./ws-server-Di2oqr4q.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-BhBzOXVa.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";
+import "./index-pIVt92jP.mjs";
+import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-Dq4i156u.mjs";
+import { c as DevframeNodeRpcSessionMeta, d as DevframeRpcTransportKind, l as DevframeRpcConnection, u as DevframeRpcConnectionRequest } from "./ws-server-D2nv68Hg.mjs";
+import { $ as DevframeServiceScopeOf, At as AgentManifest, B as DevframeSetupInfo, Bt as EventEmitter, Ct as DevframeDiagnosticsLogger, F as DevframeDefinition, Ft as AgentToolInput, G as McpAuthorization, H as DevframeSnapshotRpcInputs, Ht as EventsMap, I as DevframeDeploymentKind, It as AgentToolProvider, J as DevframeServiceDescriptor, K as McpRouteOptions, L as DevframeDockDefaults, Lt as AgentToolProviderHandle, Mt as AgentResourceContent, Nt as AgentResourceInput, P as DevframeCliOptions, Pt as AgentTool, Q as DevframeServiceOf, R as DevframeDuplicationStrategy, Rt as DevframeAgentHost, St as DevframeDiagnosticsHost, U as DevframeSseOptions, V as DevframeSnapshotRpcEntry, Vt as EventUnsubscribe, W as DevframeWsOptions, X as DevframeServiceInput, Y as DevframeServiceId, Z as DevframeServiceMeta, _t as DevframeRpcClientFunctions, a as DevframeConnectionConfigsRegistry, at as DevframeScopedNodeRpc, bt as DevframeHost, c as RpcBroadcastOptions, ct as DevframeSettingsRegistry, d as RpcSharedStateHost, dt as ScopedClientFunctions, et as DevframeServicesHost, f as RpcStreamingChannel, ft as ScopedRpcFn, gt as DevframeViewHost, ht as SettingsForNamespace, i as DevframeCapabilities, it as DevframeScopedNodeContext, jt as AgentResource, kt as AgentHandle, l as RpcFunctionsHost, lt as DevframeSettingsStore, m as RpcStreamingHost, mt as ScopedSharedStates, n as ConnectionMetaSse, nt as DevframeServicesScopeRegistry, o as DevframeNodeContext, ot as DevframeScopedStreamingHost, p as RpcStreamingChannelOptions, pt as ScopedServerFunctions, q as DevframeServiceDefinition, r as ConnectionMetaWebsocket, rt as DevframeServicesState, s as DevframeNodeRpcSession, st as DevframeSettings, t as ConnectionMeta, tt as DevframeServicesRegistry, u as RpcSharedStateGetOptions, ut as ScopedBroadcastOptions, vt as DevframeRpcServerFunctions, xt as DevframeStorageScope, yt as DevframeRpcSharedStates, z as DevframeRpcOptions, zt as DevframeAgentHostEvents } from "./context-4AIVRLYF.mjs";
+import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "./remote-assets-eBvSKZMS.mjs";
+import { i as DevframeDefineDiagnosticsOptions } from "./nostics-0sKe5HIj.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>;
 /**
- * Identity helper that types a devframe definition — the primary authoring
+ * Identity helper that types a devframe definition, the primary authoring
  * 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).
+ * @deprecated Read {@link DevframeDefinition.clientAssets} from the definition
+ * directly. This helper is internal machinery that was never meant to be part
+ * of the public API and is scheduled for removal.
  */
 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, resolveClientAssets };
+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 McpAuthorization, 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

@@ -1,22 +1,21 @@
 import { t as createDefineWrapperWithContext } from "./define-BLWPsH6y.mjs";
+import { t as resolveClientAssets$1 } from "./client-assets-DNdhagGm.mjs";
 //#region src/define.ts
 const defineRpcFunction = createDefineWrapperWithContext();
 /**
-* Identity helper that types a devframe definition — the primary authoring
+* Identity helper that types a devframe definition, the primary authoring
 * entry point. Import it from the package root: `import { defineDevframe } from 'devframe'`.
 */
 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).
+* @deprecated Read {@link DevframeDefinition.clientAssets} from the definition
+* directly. This helper is internal machinery that was never meant to be part
+* of the public API and is scheduled for removal.
 */
 function resolveClientAssets(d) {
-	return d.clientAssets ?? d.cli?.distDir;
+	return resolveClientAssets$1(d);
 }
 //#endregion
 export { defineDevframe, defineRpcFunction, resolveClientAssets };

package/dist/{instance-registry-BjlMQbFB.mjs → instance-registry-C7-41RSp.mjs}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B4iAMlE-.mjs";
-import { t as diagnostics } from "./diagnostics-BXWW3VK-.mjs";
+import { t as diagnostics } from "./diagnostics-BMfN8mb1.mjs";
 import process from "node:process";
 import { join } from "pathe";
 import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
@@ -16,9 +16,9 @@ const DEVFRAME_INSTANCES_DIR_ENV = "DEVFRAME_INSTANCES_DIR";
 /** Environment variable disabling instance registration entirely. */
 const DEVFRAME_DISABLE_INSTANCE_REGISTRY_ENV = "DEVFRAME_DISABLE_INSTANCE_REGISTRY";
 /**
-* Resolve the registry directory: `~/.devframe/instances/` by default —
-* the framework's own global dir, deliberately outside the per-app
-* `~/.<appName>/devframe/` storage convention since the registry spans apps —
+* Resolve the registry directory: `~/.devframe/instances/` by default
+* (the framework's own global dir, deliberately outside the per-app
+* `~/.<appName>/devframe/` storage convention since the registry spans apps),
 * overridable via `DEVFRAME_INSTANCES_DIR`.
 */
 function resolveInstancesDir(override) {
@@ -40,7 +40,7 @@ function isRegistryDisabled() {
 * The record is written atomically to `<dir>/<pid>-<port>.json` and removed
 * by {@link DevframeInstanceRegistration.unregister}. Records surviving a
 * crash are pruned by readers whose liveness probe fails. Registration never
-* throws — a write failure degrades to a coded warning (`DF0045`), since a
+* throws; a write failure degrades to a coded warning (`DF0045`), since a
 * dev server must not die over discovery metadata.
 */
 function registerDevframeInstance(record, options = {}) {
@@ -75,7 +75,7 @@ function registerDevframeInstance(record, options = {}) {
 }
 /**
 * Read every record in the registry directory, dropping unparseable files.
-* Liveness is the caller's concern — see {@link probeDevframeInstance}.
+* Liveness is the caller's concern; see {@link probeDevframeInstance}.
 */
 function readDevframeInstances(options = {}) {
 	const dir = resolveInstancesDir(options.instancesDir);
@@ -94,8 +94,8 @@ function readDevframeInstances(options = {}) {
 }
 /**
 * Dialable-origin candidates for a recorded origin. A `localhost` bind is
-* ambiguous — the server may listen on `127.0.0.1`, `::1`, or both, and
-* HTTP clients differ in which family they try — so probe the explicit
+* ambiguous: the server may listen on `127.0.0.1`, `::1`, or both, and
+* HTTP clients differ in which family they try, so probe the explicit
 * addresses too and adopt whichever answers.
 */
 function originCandidates(origin) {

package/dist/{instance-shell-Bh4l9Vz_.d.mts → instance-shell-7Z52PE4_.d.mts}

@@ -1,6 +1,6 @@
-import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "./ws-server-Di2oqr4q.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-BhBzOXVa.mjs";
-import "./index-DcKxIMoI.mjs";
+import { c as DevframeNodeRpcSessionMeta, l as DevframeRpcConnection, n as WsOriginRegistry } from "./ws-server-D2nv68Hg.mjs";
+import { U as DevframeSseOptions, W as DevframeWsOptions, _t as DevframeRpcClientFunctions, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta, vt as DevframeRpcServerFunctions, wt as DevframeAuthHandler } from "./context-4AIVRLYF.mjs";
+import "./index-pKl67H6w.mjs";
 import { BirpcGroup } from "birpc";
 import { NodeAdapter } from "crossws/adapters/node";
 import { Buffer } from "node:buffer";
@@ -10,7 +10,7 @@ import { H3 } from "h3";
 //#region src/node/instance-registry.d.ts
 /**
  * One running devframe instance, as recorded in the instance registry.
- * Records are self-describing JSON — additive fields are safe.
+ * Records are self-describing JSON, so additive fields are safe.
  */
 interface DevframeInstanceRecord {
   /** Process id of the dev server. */
@@ -58,7 +58,7 @@ interface DevframeInstanceRegistration {
  * The record is written atomically to `<dir>/<pid>-<port>.json` and removed
  * by {@link DevframeInstanceRegistration.unregister}. Records surviving a
  * crash are pruned by readers whose liveness probe fails. Registration never
- * throws — a write failure degrades to a coded warning (`DF0045`), since a
+ * throws; a write failure degrades to a coded warning (`DF0045`), since a
  * dev server must not die over discovery metadata.
  */
 declare function registerDevframeInstance(record: DevframeInstanceRecord, options?: {
@@ -85,7 +85,7 @@ declare function listLiveDevframeInstances(options?: {
 //#endregion
 //#region src/node/instance-shell.d.ts
 /**
- * The live handle for a bound HTTP + WebSocket RPC server — what the
+ * The live handle for a bound HTTP + WebSocket RPC server: what the
  * side-car / shared-server tiers produce and what {@link createDevServer}
  * re-exposes through its own return contract.
  */
@@ -101,7 +101,7 @@ interface StartedServer {
   ws?: NodeAdapter;
   rpcGroup: BirpcGroup<DevframeRpcClientFunctions, DevframeRpcServerFunctions, false>;
   /**
-   * The {@link ConnectionMeta} descriptor for this server — the same shape a
+   * The {@link ConnectionMeta} descriptor for this server, the same shape a
    * `__connection.json` route should serve so a devframe client's
    * `resolveWsUrl` can dial back in.
    */
@@ -111,15 +111,15 @@ interface StartedServer {
 /**
  * How the instance's RPC socket is bound:
  *
- * - `sidecar` — its own HTTP+WS server on a dedicated port (`ws.port` /
+ * - `sidecar`: its own HTTP+WS server on a dedicated port (`ws.port` /
  *   `ws.sidecar`), advertised with that port.
- * - `server` — a shared upgrade route on the host's `node:http` server.
- * - `external` — no local transport: `ws.url` alone names a server that owns
+ * - `server`: a shared upgrade route on the host's `node:http` server.
+ * - `external`: no local transport; `ws.url` alone names a server that owns
  *   both the socket and its auth.
- * - `unbound` — the transport exists but nothing is bound to it yet; the host
+ * - `unbound`: the transport exists but nothing is bound to it yet; the host
  *   drives it through {@link InstanceShell.handleUpgrade} /
  *   {@link InstanceShell.attach}.
- * - `disabled` — `ws: false`: no WebSocket at all; clients connect over the
+ * - `disabled` (`ws: false`): no WebSocket at all; clients connect over the
  *   SSE endpoint instead (`backend: 'sse'`).
  */
 type InstanceWsTier = 'sidecar' | 'server' | 'external' | 'unbound' | 'disabled';
@@ -154,9 +154,9 @@ interface CreateInstanceShellOptions<TContext extends DevframeNodeContext> {
   auth?: boolean | DevframeAuthHandler;
   /** Host `node:http` server to share the WS upgrade with. */
   server?: Server;
-  /** Explicit WebSocket control — see {@link DevframeWsOptions}. `false` disables the socket (SSE-only). */
+  /** Explicit WebSocket control; see {@link DevframeWsOptions}. `false` disables the socket (SSE-only). */
   ws?: DevframeWsOptions | false;
-  /** SSE endpoint control — enabled by default; `false` disables, an object renames the route. */
+  /** SSE endpoint control, enabled by default; `false` disables, an object renames the route. */
   sse?: boolean | DevframeSseOptions;
   /** Bind host for a side-car WebSocket server. Default: `localhost`. */
   host?: string;
@@ -177,7 +177,7 @@ interface CreateInstanceShellOptions<TContext extends DevframeNodeContext> {
   resolveSidecarPort?: (host: string) => Promise<number>;
   /**
    * Publish this instance in the global registry (`~/.devframe/instances/`)
-   * once its public origin is known — a dynamic import so the registry code
+   * once its public origin is known, via a dynamic import so the registry code
    * stays out of instances that opt out. Omit to skip registration.
    */
   register?: InstanceRegisterConfig;
@@ -190,7 +190,7 @@ interface CreateInstanceShellOptions<TContext extends DevframeNodeContext> {
 }
 /**
  * The identity a shell needs to publish itself in the global instance
- * registry — the parts it can't derive on its own. The shell fills in
+ * registry: the parts it can't derive on its own. The shell fills in
  * `pid` / `origin` / `port` / `basePath` / `mcp` / `startedAt` once the
  * origin resolves, then merges {@link InstanceRegisterConfig.overrides} last.
  */
@@ -240,8 +240,8 @@ declare function samePath(a: string, b: string): boolean;
  * The shared machinery behind `initDevframe` and `initHub`: one mount base,
  * one h3 app, one lazily-derived public origin (and the auth banner that waits
  * for it), one WebSocket binding, and the fetch / connect-middleware pair that
- * serves them. Each factory supplies only what makes it itself — its context,
- * its routes, its diagnostics — through `init` / `mount`.
+ * serves them. Each factory supplies only what makes it itself (its context,
+ * its routes, its diagnostics) through `init` / `mount`.
  *
  * Nothing here listens on a port unless a side-car was explicitly requested:
  * the default tier leaves the socket `unbound`, so a host chains it onto its