@devframes/hub 0.9.7 → 0.9.9

package/dist/{context-D5JSW_X5.d.mts → context-Di-fhMKP.d.mts}

@@ -1,4 +1,4 @@
-import { b as DevframeDockEntryIcon, k as DevframeViewIframe, l as DevframeCommandsHost, m as DevframeDockActivation, w as DevframeDocksHost } from "./settings-D7whfcx2.mjs";
+import { A as DevframeViewIframe, T as DevframeDocksHost, b as DevframeDockEntryIcon, l as DevframeCommandsHost, m as DevframeDockActivation } from "./settings-CWHPzCWS.mjs";
 import { CreateHostContextOptions } from "devframe/node";
 import { DevframeDefinition, DevframeHost, DevframeNodeContext, EventEmitter } from "devframe/types";
 import { ChildProcess } from "node:child_process";
@@ -154,13 +154,13 @@ interface DevframeMessageHandle {
   dismiss: () => Promise<void>;
 }
 /**
- * Extra fields accepted by the per-level message shortcuts —
+ * Extra fields accepted by the per-level message shortcuts:
  * everything on {@link DevframeMessageEntryInput} except the
  * `message` and `level` the shortcut itself provides.
  */
 type DevframeMessageShortcutInput = Omit<DevframeMessageEntryInput, 'message' | 'level'>;
 /**
- * Per-level shortcuts shared by the client and the node host —
+ * Per-level shortcuts shared by the client and the node host:
  * `messages.info('...')` is `messages.add({ message: '...', level: 'info' })`.
  */
 interface DevframeMessagesLevelShortcuts {
@@ -197,7 +197,7 @@ interface DevframeMessagesListDelta {
   entries: DevframeMessageEntry[];
   /** Ids removed since the cursor (empty when `full`) */
   removedIds: string[];
-  /** The version cursor — pass back as `since` on the next call */
+  /** The version cursor; pass back as `since` on the next call */
   version: number;
   /**
    * When `true`, `entries` is the complete snapshot and any locally cached
@@ -262,7 +262,7 @@ interface DevframeTerminalsHost {
    * {@link DevframePtyTerminalSession.resize}, TUI-capable. The session is
    * marked `interactive`, so a hub-aware terminal UI (e.g. the terminals
    * plugin) surfaces it as writable rather than read-only. Powered by
-   * `zigpty` — where its native bindings can't load, it degrades to
+   * `zigpty`; where its native bindings can't load, it degrades to
    * pipe-based terminal emulation.
    */
   startPtySession: (executeOptions: DevframePtyExecuteOptions, terminal: Omit<DevframeTerminalSessionBase, 'status'>) => Promise<DevframePtyTerminalSession>;
@@ -284,7 +284,7 @@ interface DevframeTerminalSessionBase {
   /**
    * Whether the session may be restarted in place (re-running its command).
    * Defaults to `true`. Set `false` for sessions whose lifecycle is owned
-   * elsewhere — e.g. a one-shot build, or a server (like code-server) that
+   * elsewhere, e.g. a one-shot build, or a server (like code-server) that
    * should be restarted through its own controls rather than by re-spawning
    * the raw process. A hub-aware terminal UI hides its restart affordance for
    * these, and `hub:terminals:restart` rejects them.
@@ -302,7 +302,7 @@ interface DevframeChildProcessExecuteOptions {
   env?: Record<string, string>;
 }
 /**
- * The settled outcome of a {@link DevframeChildProcessTerminalSession} run —
+ * The settled outcome of a {@link DevframeChildProcessTerminalSession} run:
  * stdout/stderr captured separately (unlike the session's merged display
  * `stream`), plus the process's exit code (`undefined` if it was killed by a
  * signal before exiting).
@@ -313,7 +313,7 @@ interface DevframeChildProcessOutput {
   exitCode: number | undefined;
 }
 /**
- * A live handle on a child process's outcome — mirrors the ergonomics of
+ * A live handle on a child process's outcome, mirroring the ergonomics of
  * `tinyexec`'s `Result` (a promise-like paired with synchronous accessors) so
  * callers migrating from a `tinyexec`/`execa`-based subprocess API (e.g.
  * Nuxt DevTools' `startSubprocess().getResult()`) can adopt
@@ -334,11 +334,11 @@ interface DevframeChildProcessTerminalSession extends DevframeTerminalSession {
   getChildProcess: () => ChildProcess | undefined;
   /**
    * Get a live handle on the current run's outcome. Reflects the most recent
-   * `restart()` — call it again after restarting to track the new run.
+   * `restart()`; call it again after restarting to track the new run.
    */
   getResult: () => DevframeChildProcessResult;
   terminate: () => Promise<void>;
-  /** Throws `DF8206` once the session's output stream has closed (after a natural exit or `terminate()`) — drop it with `ctx.terminals.remove(session)` and start a fresh session instead. */
+  /** Throws `DF8206` once the session's output stream has closed (after a natural exit or `terminate()`); drop it with `ctx.terminals.remove(session)` and start a fresh session instead. */
   restart: () => Promise<void>;
 }
 interface DevframePtyExecuteOptions {
@@ -351,6 +351,23 @@ interface DevframePtyExecuteOptions {
   /** Initial row count. Default: 24. */
   rows?: number;
 }
+/**
+ * The settled outcome of a {@link DevframePtyTerminalSession} run. PTYs merge
+ * stdout and stderr into one terminal output stream, so the captured text is
+ * exposed as a single `output` value.
+ */
+interface DevframePtyOutput {
+  output: string;
+  exitCode: number | undefined;
+  signal: number | undefined;
+}
+/** A live handle on the current PTY run's merged output and process state. */
+interface DevframePtyResult extends PromiseLike<DevframePtyOutput> {
+  readonly pid: number | undefined;
+  /** `undefined` while the process is running or after a signal kill. */
+  readonly exitCode: number | undefined;
+  readonly killed: boolean;
+}
 interface DevframePtyTerminalSession extends DevframeTerminalSession {
   type: 'pty';
   interactive: true;
@@ -361,8 +378,13 @@ interface DevframePtyTerminalSession extends DevframeTerminalSession {
   resize: (cols: number, rows: number) => void;
   /** Current foreground process name, when the backend can resolve it. */
   getProcessName: () => string | undefined;
+  /**
+   * Get a live handle on the current run's outcome. Call it again after
+   * `restart()` to track the new run.
+   */
+  getResult: () => DevframePtyResult;
   terminate: () => Promise<void>;
-  /** Throws `DF8206` once the session's output stream has closed (after a natural exit or `terminate()`) — drop it with `ctx.terminals.remove(session)` and start a fresh session instead. */
+  /** Throws `DF8206` once the session's output stream has closed (after a natural exit or `terminate()`); drop it with `ctx.terminals.remove(session)` and start a fresh session instead. */
   restart: () => Promise<void>;
 }
 //#endregion
@@ -377,7 +399,7 @@ interface InstallDevframeOptions {
    * this to customize the entry's `category`, override the icon, hide it
    * via `when` (or only its dock-bar button via `visibility`), etc. Takes
    * precedence over the definition's own {@link DevframeDefinition.dock}
-   * defaults. Cannot change `id`, `type`, or `url` — those are derived from
+   * defaults. Cannot change `id`, `type`, or `url`, which are derived from
    * the devframe definition.
    */
   dock?: Partial<Omit<DevframeViewIframe, 'id' | 'type' | 'url'>>;
@@ -419,7 +441,7 @@ declare module 'devframe/types' {
      * Ask the active viewer to switch its focused dock to `dockId`, optionally
      * carrying `params` for the target dock to interpret (e.g.
      * `{ sessionId }` for the terminals dock). Any connected client may call
-     * it — a mounted devframe in its own iframe steers the host shell's dock
+     * it, so a mounted devframe in its own iframe steers the host shell's dock
      * selection. Handled by {@link import('./rpc-builtins').hubDocksActivate}.
      */
     'hub:docks:activate': (input: {
@@ -455,7 +477,7 @@ declare module 'devframe/types' {
   }
 }
 /**
- * Hub-augmented node context — extends devframe's framework-neutral
+ * Hub-augmented node context that extends devframe's framework-neutral
  * `DevframeNodeContext` with the hub-level subsystems (`docks`,
  * `terminals`, `messages`, `commands`).
  *
@@ -464,7 +486,7 @@ declare module 'devframe/types' {
  * filesystem reveal, etc.) ship as kit-registered RPC functions rather
  * than as part of this surface. JSON-render is an opt-in integration
  * (`@devframes/json-render`) that augments any devframe context and
- * contributes its own dock type — use `createJsonRenderView` from
+ * contributes its own dock type; use `createJsonRenderView` from
  * `@devframes/json-render/node`.
  */
 interface DevframeHubContext extends DevframeNodeContext {
@@ -477,13 +499,13 @@ interface DevframeHubContext extends DevframeNodeContext {
    * Install a {@link DevframeDefinition} into this hub: serve its SPA at the
    * resolved base, synthesize an iframe dock from its metadata, and run its
    * `setup(ctx)`. The imperative counterpart to `initHub`'s declarative
-   * `devframes` list — call it from a hub host's `configure(ctx)`, or wherever
+   * `devframes` list. Call it from a hub host's `configure(ctx)`, or wherever
    * you hold the context, to plug an extra devframe in.
    */
   install: (devframe: DevframeDefinition, options?: InstallDevframeOptions) => Promise<void>;
 }
 /**
- * Options for {@link createHubContext} — devframe's
+ * Options for {@link createHubContext}: devframe's
  * {@link CreateHostContextOptions} plus any hub-level additions kits layer on
  * through declaration merging.
  */
@@ -496,4 +518,4 @@ interface CreateHubContextOptions extends CreateHostContextOptions {}
  */
 declare function createHubContext(options: CreateHubContextOptions): Promise<DevframeHubContext>;
 //#endregion
-export { DevframeMessageHandle as C, DevframeMessagesHost as D, DevframeMessagesClient as E, DevframeMessagesLevelShortcuts as O, DevframeMessageFilePosition as S, DevframeMessageShortcutInput as T, DevframeMessageCommandAction as _, DevframeChildProcessExecuteOptions as a, DevframeMessageEntryFrom as b, DevframeChildProcessTerminalSession as c, DevframeTerminalSession as d, DevframeTerminalSessionBase as f, DevframeMessageActivateAction as g, DevframeMessageAction as h, InstallDevframeOptions as i, DevframeMessagesListDelta as k, DevframePtyExecuteOptions as l, DevframeTerminalsHost as m, DevframeHubContext as n, DevframeChildProcessOutput as o, DevframeTerminalStatus as p, createHubContext as r, DevframeChildProcessResult as s, CreateHubContextOptions as t, DevframePtyTerminalSession as u, DevframeMessageElementPosition as v, DevframeMessageLevel as w, DevframeMessageEntryInput as x, DevframeMessageEntry as y };
+export { DevframeMessagesLevelShortcuts as A, DevframeMessageEntryInput as C, DevframeMessageShortcutInput as D, DevframeMessageLevel as E, DevframeMessagesClient as O, DevframeMessageEntryFrom as S, DevframeMessageHandle as T, DevframeMessageAction as _, DevframeChildProcessExecuteOptions as a, DevframeMessageElementPosition as b, DevframeChildProcessTerminalSession as c, DevframePtyResult as d, DevframePtyTerminalSession as f, DevframeTerminalsHost as g, DevframeTerminalStatus as h, InstallDevframeOptions as i, DevframeMessagesListDelta as j, DevframeMessagesHost as k, DevframePtyExecuteOptions as l, DevframeTerminalSessionBase as m, DevframeHubContext as n, DevframeChildProcessOutput as o, DevframeTerminalSession as p, createHubContext as r, DevframeChildProcessResult as s, CreateHubContextOptions as t, DevframePtyOutput as u, DevframeMessageActivateAction as v, DevframeMessageFilePosition as w, DevframeMessageEntry as x, DevframeMessageCommandAction as y };

package/dist/{index-DhxIxS-Q.d.mts → index-faD2d5iX.d.mts}

@@ -1,5 +1,5 @@
-import "./context-D5JSW_X5.mjs";
-import "./settings-D7whfcx2.mjs";
+import "./context-Di-fhMKP.mjs";
+import "./settings-CWHPzCWS.mjs";
 import { RpcDefinitionsFilter, RpcDefinitionsToFunctions } from "devframe/rpc";
 import { ConnectionMeta as ConnectionMeta$1, DevframeCapabilities, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeHost as DevframeHost$1, DevframeNodeRpcSession, DevframeRpcClientFunctions, DevframeRpcServerFunctions, DevframeRpcSharedStates, DevframeViewHost, EventEmitter as EventEmitter$1, EventUnsubscribe, EventsMap, RpcBroadcastOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost } from "devframe/types";
 export { RpcStreamingHost as S, RpcFunctionsHost as _, DevframeHost$1 as a, RpcStreamingChannel as b, DevframeRpcServerFunctions as c, EventEmitter$1 as d, EventUnsubscribe as f, RpcDefinitionsToFunctions as g, RpcDefinitionsFilter as h, DevframeDiagnosticsLogger as i, DevframeRpcSharedStates as l, RpcBroadcastOptions as m, DevframeCapabilities as n, DevframeNodeRpcSession as o, EventsMap as p, DevframeDiagnosticsHost as r, DevframeRpcClientFunctions as s, ConnectionMeta$1 as t, DevframeViewHost as u, RpcSharedStateGetOptions as v, RpcStreamingChannelOptions as x, RpcSharedStateHost as y };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { C as DevframeMessageHandle, D as DevframeMessagesHost, E as DevframeMessagesClient, O as DevframeMessagesLevelShortcuts, S as DevframeMessageFilePosition, T as DevframeMessageShortcutInput, _ as DevframeMessageCommandAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageEntryFrom, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, g as DevframeMessageActivateAction, h as DevframeMessageAction, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalStatus, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyTerminalSession, v as DevframeMessageElementPosition, w as DevframeMessageLevel, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "./context-D5JSW_X5.mjs";
-import { A as DevframeViewLauncher, C as DevframeDocksActiveState, D as DevframeViewCustomRender, E as DevframeViewBuiltin, F as RemoteDockOptions, M as FrameSubTabsConfig, N as NavTarget, O as DevframeViewGroup, P as RemoteConnectionInfo, S as DevframeDockUserEntry, T as DevframeViewAction, _ as DevframeDockEntry, a as DevframeCommandEntry, b as DevframeDockEntryIcon, c as DevframeCommandShortcutOverrides, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, g as DevframeDockEntriesGrouped, h as DevframeDockBadgeVariant, i as DevframeCommandBase, j as DevframeViewLauncherStatus, k as DevframeViewIframe, l as DevframeCommandsHost, m as DevframeDockActivation, n as DevframeClientCommand, o as DevframeCommandHandle, p as ClientScriptEntry, r as DevframeCommandAgentOptions, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings, u as DevframeCommandsHostEvents, v as DevframeDockEntryBase, w as DevframeDocksHost, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "./settings-D7whfcx2.mjs";
-import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "./index-DhxIxS-Q.mjs";
+import { A as DevframeMessagesLevelShortcuts, C as DevframeMessageEntryInput, D as DevframeMessageShortcutInput, E as DevframeMessageLevel, O as DevframeMessagesClient, S as DevframeMessageEntryFrom, T as DevframeMessageHandle, _ as DevframeMessageAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageElementPosition, c as DevframeChildProcessTerminalSession, d as DevframePtyResult, f as DevframePtyTerminalSession, g as DevframeTerminalsHost, h as DevframeTerminalStatus, j as DevframeMessagesListDelta, k as DevframeMessagesHost, l as DevframePtyExecuteOptions, m as DevframeTerminalSessionBase, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalSession, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyOutput, v as DevframeMessageActivateAction, w as DevframeMessageFilePosition, x as DevframeMessageEntry, y as DevframeMessageCommandAction } from "./context-Di-fhMKP.mjs";
+import { A as DevframeViewIframe, C as DevframeDockUserEntry, D as DevframeViewBuiltin, E as DevframeViewAction, F as RemoteConnectionInfo, I as RemoteDockOptions, M as DevframeViewLauncherStatus, N as FrameSubTabsConfig, O as DevframeViewCustomRender, P as NavTarget, S as DevframeDockPanelState, T as DevframeDocksHost, _ as DevframeDockEntry, a as DevframeCommandEntry, b as DevframeDockEntryIcon, c as DevframeCommandShortcutOverrides, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, g as DevframeDockEntriesGrouped, h as DevframeDockBadgeVariant, i as DevframeCommandBase, j as DevframeViewLauncher, k as DevframeViewGroup, l as DevframeCommandsHost, m as DevframeDockActivation, n as DevframeClientCommand, o as DevframeCommandHandle, p as ClientScriptEntry, r as DevframeCommandAgentOptions, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings, u as DevframeCommandsHostEvents, v as DevframeDockEntryBase, w as DevframeDocksActiveState, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "./settings-CWHPzCWS.mjs";
+import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "./index-faD2d5iX.mjs";
 import { WhenContext, WhenExpression } from "devframe/utils/when";
 //#region src/define.d.ts
 declare const defineHubRpcFunction: <NAME extends string, TYPE extends import("devframe/rpc").RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends import("devframe/rpc").RpcArgsSchema | undefined = undefined, const RS extends import("devframe/rpc").RpcReturnSchema | undefined = undefined>(definition: import("devframe/rpc").RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeHubContext>) => import("devframe/rpc").RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeHubContext>;
@@ -12,4 +12,4 @@ declare function defineDockEntry<const T extends DevframeDockUserEntry, const W
   visibility?: WhenExpression<WhenContext, V>;
 }): T;
 //#endregion
-export { type ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, type DevframeChildProcessExecuteOptions, type DevframeChildProcessOutput, type DevframeChildProcessResult, type DevframeChildProcessTerminalSession, type DevframeClientCommand, type DevframeCommandAgentOptions, type DevframeCommandBase, type DevframeCommandEntry, type DevframeCommandHandle, type DevframeCommandKeybinding, type DevframeCommandShortcutOverrides, type DevframeCommandsHost, type DevframeCommandsHostEvents, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockActivation, type DevframeDockBadgeVariant, type DevframeDockEntriesGrouped, type DevframeDockEntry, type DevframeDockEntryBase, type DevframeDockEntryCategory, type DevframeDockEntryIcon, type DevframeDockEntryRegistry, type DevframeDockUserEntry, type DevframeDocksActiveState, type DevframeDocksHost, type DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, type DevframeMessageAction, type DevframeMessageActivateAction, type DevframeMessageCommandAction, type DevframeMessageElementPosition, type DevframeMessageEntry, type DevframeMessageEntryFrom, type DevframeMessageEntryInput, type DevframeMessageFilePosition, type DevframeMessageHandle, type DevframeMessageLevel, type DevframeMessageShortcutInput, type DevframeMessagesClient, type DevframeMessagesHost, type DevframeMessagesLevelShortcuts, type DevframeMessagesListDelta, type DevframeNodeRpcSession, type DevframePtyExecuteOptions, type DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeServerCommandEntry, type DevframeServerCommandInput, type DevframeTerminalSession, type DevframeTerminalSessionBase, type DevframeTerminalStatus, type DevframeTerminalsHost, type DevframeViewAction, type DevframeViewBuiltin, type DevframeViewCustomRender, type DevframeViewGroup, type DevframeViewHost, type DevframeViewIframe, type DevframeViewLauncher, type DevframeViewLauncherStatus, type EventEmitter, type EventUnsubscribe, type EventsMap, type FrameSubTabsConfig, type NavTarget, type RemoteConnectionInfo, type RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, defineCommand, defineDockEntry, defineHubRpcFunction };
+export { type ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, type DevframeChildProcessExecuteOptions, type DevframeChildProcessOutput, type DevframeChildProcessResult, type DevframeChildProcessTerminalSession, type DevframeClientCommand, type DevframeCommandAgentOptions, type DevframeCommandBase, type DevframeCommandEntry, type DevframeCommandHandle, type DevframeCommandKeybinding, type DevframeCommandShortcutOverrides, type DevframeCommandsHost, type DevframeCommandsHostEvents, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockActivation, type DevframeDockBadgeVariant, type DevframeDockEntriesGrouped, type DevframeDockEntry, type DevframeDockEntryBase, type DevframeDockEntryCategory, type DevframeDockEntryIcon, type DevframeDockEntryRegistry, type DevframeDockPanelState, type DevframeDockUserEntry, type DevframeDocksActiveState, type DevframeDocksHost, type DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, type DevframeMessageAction, type DevframeMessageActivateAction, type DevframeMessageCommandAction, type DevframeMessageElementPosition, type DevframeMessageEntry, type DevframeMessageEntryFrom, type DevframeMessageEntryInput, type DevframeMessageFilePosition, type DevframeMessageHandle, type DevframeMessageLevel, type DevframeMessageShortcutInput, type DevframeMessagesClient, type DevframeMessagesHost, type DevframeMessagesLevelShortcuts, type DevframeMessagesListDelta, type DevframeNodeRpcSession, type DevframePtyExecuteOptions, type DevframePtyOutput, type DevframePtyResult, type DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeServerCommandEntry, type DevframeServerCommandInput, type DevframeTerminalSession, type DevframeTerminalSessionBase, type DevframeTerminalStatus, type DevframeTerminalsHost, type DevframeViewAction, type DevframeViewBuiltin, type DevframeViewCustomRender, type DevframeViewGroup, type DevframeViewHost, type DevframeViewIframe, type DevframeViewLauncher, type DevframeViewLauncherStatus, type EventEmitter, type EventUnsubscribe, type EventsMap, type FrameSubTabsConfig, type NavTarget, type RemoteConnectionInfo, type RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, defineCommand, defineDockEntry, defineHubRpcFunction };

package/dist/node/index.d.mts

@@ -1,5 +1,5 @@
-import { C as DevframeMessageHandle, D as DevframeMessagesHost$1, T as DevframeMessageShortcutInput, a as DevframeChildProcessExecuteOptions, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, i as InstallDevframeOptions, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost$1, n as DevframeHubContext, r as createHubContext, t as CreateHubContextOptions, u as DevframePtyTerminalSession, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "../context-D5JSW_X5.mjs";
-import { S as DevframeDockUserEntry, _ as DevframeDockEntry, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, l as DevframeCommandsHost$1, o as DevframeCommandHandle, p as ClientScriptEntry, t as DevframeDocksUserSettings, w as DevframeDocksHost$1 } from "../settings-D7whfcx2.mjs";
+import { C as DevframeMessageEntryInput, D as DevframeMessageShortcutInput, T as DevframeMessageHandle, a as DevframeChildProcessExecuteOptions, c as DevframeChildProcessTerminalSession, f as DevframePtyTerminalSession, g as DevframeTerminalsHost$1, i as InstallDevframeOptions, j as DevframeMessagesListDelta, k as DevframeMessagesHost$1, l as DevframePtyExecuteOptions, m as DevframeTerminalSessionBase, n as DevframeHubContext, p as DevframeTerminalSession, r as createHubContext, t as CreateHubContextOptions, x as DevframeMessageEntry } from "../context-Di-fhMKP.mjs";
+import { C as DevframeDockUserEntry, T as DevframeDocksHost$1, _ as DevframeDockEntry, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, l as DevframeCommandsHost$1, o as DevframeCommandHandle, p as ClientScriptEntry, t as DevframeDocksUserSettings } from "../settings-CWHPzCWS.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { SharedState } from "devframe/utils/shared-state";
 //#region src/node/host-commands.d.ts
@@ -9,7 +9,7 @@ declare class DevframeCommandsHost implements DevframeCommandsHost$1 {
   readonly events: DevframeCommandsHost$1['events'];
   /**
    * Lazy agent projection: `ctx.agent` queries this provider at list/invoke
-   * time, deriving tools from {@link commands} on demand — the commands map
+   * time, deriving tools from {@link commands} on demand, so the commands map
    * stays the single source of truth, nothing is mirrored or kept in sync.
    */
   private readonly agentProvider;
@@ -27,7 +27,7 @@ declare class DevframeCommandsHost implements DevframeCommandsHost$1 {
    * agent-flagged, handler-bearing command (children included) becomes a
    * callable tool. Queried lazily by the provider registered in the
    * constructor. `when` clauses evaluate client-side only and are not
-   * enforced here — opting in a `when`-gated command is a deliberate author
+   * enforced here; opting in a `when`-gated command is a deliberate author
    * decision (documented on `DevframeCommandAgentOptions`).
    */
   private collectAgentTools;
@@ -52,7 +52,7 @@ declare class DevframeDocksHost implements DevframeDocksHost$1 {
   update(view: DevframeDockUserEntry): void;
   activate(dockId: string, params?: Record<string, unknown>): void;
   /**
-   * Warn (don't throw — a client-runtime `resolveClientModule` override may still cover
+   * Warn (don't throw, since a client-runtime `resolveClientModule` override may still cover
    * it) when a dock declares a **bare-specifier** client script on a host
    * that advertises no `staticConfig.dock.clientModuleResolution`: the
    * browser cannot resolve a bare npm specifier natively, so the script is
@@ -79,7 +79,7 @@ declare class DevframeMessagesHost implements DevframeMessagesHost$1 {
   private _clock;
   /**
    * The tick of the newest removal record dropped from the capped
-   * `removals` log — cursors older than this can't get a reliable delta
+   * `removals` log; cursors older than this can't get a reliable delta
    * and fall back to a full snapshot in {@link listSince}.
    */
   private _removalsTrimmedAt;
@@ -113,14 +113,23 @@ declare class DevframeTerminalsHost implements DevframeTerminalsHost$1 {
   private _channel?;
   constructor(context: DevframeHubContext);
   /**
-   * Lazily acquire the streaming channel — `context.rpc` isn't assigned
+   * Lazily acquire the streaming channel, since `context.rpc` isn't assigned
    * until after every host is constructed, so we can't grab it in the
    * constructor.
    */
   private getStreamingChannel;
+  /**
+   * Per-run stream lifecycle shared by the child-process and PTY paths: guards
+   * the single-close/error transition and keeps the session's `status` in step
+   * with the process lifecycle (a hub-aware client sees `running` →
+   * `stopped`/`error` instead of a value frozen at spawn time).
+   */
+  private createStreamLifecycle;
   register(session: DevframeTerminalSession): DevframeTerminalSession;
   update(patch: PartialWithoutId<DevframeTerminalSession>): void;
   remove(session: DevframeTerminalSession): void;
+  /** Drain a session's output stream into its scrollback buffer and streaming sink. */
+  private pumpStream;
   private bindStream;
   startChildProcess(executeOptions: DevframeChildProcessExecuteOptions, terminal: Omit<DevframeTerminalSessionBase, 'status'>): Promise<DevframeChildProcessTerminalSession>;
   startPtySession(executeOptions: DevframePtyExecuteOptions, terminal: Omit<DevframeTerminalSessionBase, 'status'>): Promise<DevframePtyTerminalSession>;
@@ -128,7 +137,7 @@ declare class DevframeTerminalsHost implements DevframeTerminalsHost$1 {
 //#endregion
 //#region src/node/rpc-builtins.d.ts
 /**
- * `hub:commands:execute` — Invoke a registered server command by id. The
+ * `hub:commands:execute`: Invoke a registered server command by id. The
  * arguments after `id` are forwarded to the command's `handler(...)`.
  * Returns whatever the handler returns.
  *
@@ -151,7 +160,7 @@ declare const hubCommandsExecute: {
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, ...args: any[]], Promise<unknown>>> | undefined;
 };
 /**
- * `hub:messages:add` — Add a message from a browser client into the hub's
+ * `hub:messages:add`: Add a message from a browser client into the hub's
  * messages subsystem. Marked `from: 'browser'`. Returns the serializable
  * entry (the mutation handle stays server-side).
  *
@@ -174,7 +183,7 @@ declare const hubMessagesAdd: {
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>>> | undefined;
 };
-/** `hub:messages:update` — Patch a message by id; returns the updated entry (or `undefined`). */
+/** `hub:messages:update`: Patch a message by id; returns the updated entry (or `undefined`). */
 declare const hubMessagesUpdate: {
   name: "hub:messages:update";
   type?: "action" | undefined;
@@ -190,7 +199,7 @@ declare const hubMessagesUpdate: {
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>>> | undefined;
 };
-/** `hub:messages:remove` — Remove a message by id. */
+/** `hub:messages:remove`: Remove a message by id. */
 declare const hubMessagesRemove: {
   name: "hub:messages:remove";
   type?: "action" | undefined;
@@ -206,7 +215,7 @@ declare const hubMessagesRemove: {
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>> | undefined;
 };
-/** `hub:messages:clear` — Remove every message. */
+/** `hub:messages:clear`: Remove every message. */
 declare const hubMessagesClear: {
   name: "hub:messages:clear";
   type?: "action" | undefined;
@@ -223,7 +232,7 @@ declare const hubMessagesClear: {
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], Promise<void>>> | undefined;
 };
 /**
- * `hub:terminals:write` — Send input to an interactive PTY session spawned
+ * `hub:terminals:write`: Send input to an interactive PTY session spawned
  * via `ctx.terminals.startPtySession`. Lets a hub-aware terminal UI (e.g. the
  * terminals plugin) drive a session owned by another plugin.
  */
@@ -242,7 +251,7 @@ declare const hubTerminalsWrite: {
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, data: string], Promise<void>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, data: string], Promise<void>>> | undefined;
 };
-/** `hub:terminals:resize` — Resize an interactive PTY session by id. */
+/** `hub:terminals:resize`: Resize an interactive PTY session by id. */
 declare const hubTerminalsResize: {
   name: "hub:terminals:resize";
   type?: "action" | undefined;
@@ -259,7 +268,7 @@ declare const hubTerminalsResize: {
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, cols: number, rows: number], Promise<void>>> | undefined;
 };
 /**
- * `hub:terminals:terminate` — Kill a session's process while keeping the
+ * `hub:terminals:terminate`: Kill a session's process while keeping the
  * session registered (its output/scrollback stays). Works for both read-only
  * child-process and interactive PTY sessions, letting a hub-aware terminal UI
  * force-kill a session owned by another plugin.
@@ -280,7 +289,7 @@ declare const hubTerminalsTerminate: {
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>> | undefined;
 };
 /**
- * `hub:terminals:restart` — Re-run a session's command in place. Rejected for
+ * `hub:terminals:restart`: Re-run a session's command in place. Rejected for
  * sessions registered with `restartable: false`, whose lifecycle is owned
  * elsewhere.
  */
@@ -300,7 +309,7 @@ declare const hubTerminalsRestart: {
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>> | undefined;
 };
 /**
- * `hub:terminals:remove` — Kill a session's process (when it still owns one)
+ * `hub:terminals:remove`: Kill a session's process (when it still owns one)
  * and drop it from the registry, disposing its output stream. Lets a hub-aware
  * terminal UI discard a stopped aggregated session.
  */
@@ -320,13 +329,13 @@ declare const hubTerminalsRemove: {
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>> | undefined;
 };
 /**
- * `hub:docks:activate` — Ask the active viewer to switch its focused dock to
+ * `hub:docks:activate`: Ask the active viewer to switch its focused dock to
  * `dockId`, optionally carrying `params` for the target dock to interpret
  * (e.g. `{ sessionId }` for the terminals dock to focus a session).
  *
  * Any connected client may call it, which is the point: a mounted devframe
  * running in its own iframe (on its own RPC client) can steer the host shell's
- * dock selection — client-local state it otherwise can't reach. The hub
+ * dock selection, client-local state it otherwise can't reach. The hub
  * broadcasts the request live to connected clients (the host shell switches)
  * and mirrors it into the `devframe:docks:active` shared state (a dock that
  * mounts in response still converges on it).

package/dist/node/index.mjs

@@ -1,9 +1,9 @@
-import { _ as DevframeDocksHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeMessagesHost, h as DevframeTerminalsHost, i as hubDocksActivate, l as hubTerminalsRemove, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize, v as DevframeCommandsHost } from "../context-C3hUUCC1.mjs";
+import { _ as DevframeDocksHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeMessagesHost, h as DevframeTerminalsHost, i as hubDocksActivate, l as hubTerminalsRemove, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize, v as DevframeCommandsHost } from "../context-D4L966cN.mjs";
 import "ufo";
 import "pathe";
 import "node:process";
-import { builtinModules } from "node:module";
 import "node:fs";
+import { builtinModules } from "node:module";
 import "node:url";
 import assert from "node:assert";
 import "node:path";

package/dist/node/initiate.d.mts

@@ -1,5 +1,5 @@
-import { i as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-D5JSW_X5.mjs";
-import { r as DEVFRAMES_HUB_BASE } from "../constants-C5t0DeZ0.mjs";
+import { i as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-Di-fhMKP.mjs";
+import { r as DEVFRAMES_HUB_BASE } from "../constants-Coo1p3ja.mjs";
 import { DevframeInstanceRecord } from "devframe/internal";
 import { ConnectionMeta, DevframeDefinition, DevframeServiceInput, DevframeSseOptions, DevframeStorageScope, DevframeWsOptions, McpRouteOptions } from "devframe/types";
 import { DevframeAuthHandler } from "devframe/node/auth";
@@ -20,14 +20,14 @@ type Arrayable<T> = T | readonly T[];
  * One dock-type → prebuilt renderer-module registration for
  * {@link InitHubOptions.renderers}. The hub serves the module at
  * `<base>__renderers/<type>.mjs` and publishes it in the renderer manifest
- * (the `devframe:dock-renderers` shared-state slot), so any viewer — the
- * reference UI, a community viewer, a hand-rolled host page — lazily imports
+ * (the `devframe:dock-renderers` shared-state slot), so any viewer (the
+ * reference UI, a community viewer, a hand-rolled host page) lazily imports
  * it the first time a dock of that `type` needs rendering.
  *
  * The module must be a **self-contained browser ES module** (its framework
  * and styles bundled in) whose {@link DockRendererRegistration.importName}
  * export is a ready `DockRenderer`. Renderer packages ship a node helper
- * returning this shape — e.g. `jsonRenderUiRenderer()` from
+ * returning this shape, e.g. `jsonRenderUiRenderer()` from
  * `@devframes/json-render-ui/hub`.
  */
 interface DockRendererRegistration {
@@ -43,7 +43,7 @@ interface DockRendererRegistration {
   importName?: string;
 }
 /**
- * The UI slot of a hub instance — pure data, zero policy. The hub itself is
+ * The UI slot of a hub instance: pure data, zero policy. The hub itself is
  * headless: whoever fills this slot decides what a viewer looks like.
  * `@devframes/hub-ui` ships the reference implementation (`createUi()`);
  * Vite DevTools or any community viewer supplies its own object to the same
@@ -52,14 +52,14 @@ interface DockRendererRegistration {
 interface DevframeHubUi {
   /**
    * A standalone viewer SPA (built with relative asset paths) served at the
-   * hub base itself — open `<base>` in a tab and the devtools are there.
+   * hub base itself; open `<base>` in a tab and the devtools are there.
    */
   viewer?: {
     /** Directory of the prebuilt viewer SPA. */
     distDir: string;
   };
   /**
-   * A prebuilt, self-contained script served at `<base>embedded.js` — the
+   * A prebuilt, self-contained script served at `<base>embedded.js`: the
    * floating-devtools bootstrap a host page loads with one
    * `<script type="module" src="<base>embedded.js">` tag. Visibility policy
    * (always-on, keyboard-summoned, …) belongs entirely to this entry.
@@ -77,8 +77,8 @@ interface DevframeHubUi {
    */
   assets?: Record<string, () => string | Uint8Array>;
   /**
-   * A setup hook run once during hub init with the hub context — the UI
-   * slot's chance to publish its own static, boot-time config through the
+   * A setup hook run once during hub init with the hub context, giving the UI
+   * slot a chance to publish its own static, boot-time config through the
    * generic `ctx.staticConfig` (serialized into `ConnectionMeta.configs`).
    * The reference UI's `createUi()` uses it to set
    * `ctx.staticConfig.ui = { branding, … }`, reaching every mounted frame and
@@ -98,7 +98,7 @@ interface InitHubOptions {
    */
   version?: string;
   /**
-   * Mount base the hub answers under — required so the mount path is
+   * Mount base the hub answers under, required so the mount path is
    * explicit at the call site (pass the exported {@link DEVFRAMES_HUB_BASE}
    * for the conventional `/__devframes/`). Every mounted devframe lives at
    * `<base><id>/`, so the host app needs exactly one catch-all route. The
@@ -118,19 +118,19 @@ interface InitHubOptions {
    * Host-level wire services to install, on top of whatever the mounted
    * devframes declare. Constructed (option sets merged) at the pre-setup
    * barrier, so every devframe's `setup` sees them ready. Reach for this to
-   * configure a shared service centrally — e.g.
+   * configure a shared service centrally, e.g.
    * `services: [createShikiService({ themes })]`.
    */
   services?: DevframeServiceInput[];
   /**
    * Extra RPC declarations registered at context creation, alongside the
-   * hub built-ins — forwarded to `createHubContext`'s
+   * hub built-ins, forwarded to `createHubContext`'s
    * `builtinRpcDeclarations`. Declarative mode only (a pre-built `context`
    * already made this choice).
    */
   rpcDeclarations?: CreateHubContextOptions['builtinRpcDeclarations'];
   /**
-   * Bring your own hub context instead of `devframes` — for hosts that
+   * Bring your own hub context instead of `devframes`, for hosts that
    * assemble `createHubContext` + `ctx.install` themselves (with their own
    * `DevframeHost` serving the frames). The instance then serves only the
    * hub-level endpoints (`__connection.json`, `__index.json`,
@@ -139,14 +139,14 @@ interface InitHubOptions {
    */
   context?: DevframeHubContext;
   /**
-   * Runs once the context exists and every `devframes` entry is mounted —
+   * Runs once the context exists and every `devframes` entry is mounted;
    * register docks, commands, terminals, and messages surfaces here.
    */
   configure?: (ctx: DevframeHubContext) => void | Promise<void>;
-  /** See {@link DevframeHubUi} — omitted, the hub stays fully headless. */
+  /** See {@link DevframeHubUi}; omitted, the hub stays fully headless. */
   ui?: DevframeHubUi;
   /**
-   * Prebuilt dock-renderer modules to serve and advertise — the composition
+   * Prebuilt dock-renderer modules to serve and advertise: the composition
    * seam that hands a renderer package (e.g. `@devframes/json-render-ui`) to
    * a prebuilt viewer. Each {@link DockRendererRegistration} is served at
    * `<base>__renderers/<type>.mjs` and published in the renderer manifest;
@@ -175,11 +175,11 @@ interface InitHubOptions {
    * > `ws.sidecar` (auto-port side-car) > the host driving upgrades itself,
    * while `url` overrides the advertisement (tunnel pattern) and `route`
    * renames the upgrade segment (default `__ws`). Pass `false` to serve no
-   * WebSocket at all — clients connect over SSE instead (`backend: 'sse'`).
+   * WebSocket at all, so clients connect over SSE instead (`backend: 'sse'`).
    */
   ws?: DevframeWsOptions | false;
   /**
-   * SSE RPC endpoint control, same contract as `initDevframe` — enabled by
+   * SSE RPC endpoint control, same contract as `initDevframe`, enabled by
    * default at `<base>__sse` as the more portable transport alongside the
    * WebSocket. Pass `false` to disable, or a {@link DevframeSseOptions} to
    * rename the route.
@@ -195,9 +195,14 @@ interface InitHubOptions {
    */
   auth?: boolean | DevframeAuthHandler;
   /**
-   * Expose the **aggregate** MCP endpoint at `<base>__mcp` — one
+   * Expose the **aggregate** MCP endpoint at `<base>__mcp`: one
    * Streamable-HTTP server over the shared context's whole tool registry
-   * (ids are already namespaced per plugin). Disabled by default.
+   * (ids are already namespaced per plugin). Disabled by default; `true`
+   * mounts it with the loopback origin gate (trusting same-machine callers),
+   * an object opts into an {@link McpRouteOptions.authorization} identity
+   * check. A mounted devframe's own `mcp` setting is ignored: the hub's
+   * aggregate route covers them all (`DF8005` warns when one asks for MCP
+   * while this is off).
    */
   mcp?: boolean | McpRouteOptions;
   /**
@@ -217,14 +222,14 @@ interface InitHubOptions {
   register?: boolean | Partial<DevframeInstanceRecord>;
   /**
    * Advertise that this host runtime resolves **bare-specifier** client
-   * scripts (`ClientScriptEntry.importFrom` naming an npm module) — a URL
+   * scripts (`ClientScriptEntry.importFrom` naming an npm module): a URL
    * template whose `{specifier}` token is replaced with the specifier,
    * published as `ConnectionMeta.configs.dock.clientModuleResolution` and
    * applied by every client-script loader. Declare it only when the host can
-   * actually serve npm modules to the browser — a Vite host passes
+   * actually serve npm modules to the browser; a Vite host passes
    * `'/@id/{specifier}'` to route imports through its own module graph
    * (`@devframes/vite/hub` does). Left undeclared, registering a
-   * bare-specifier client script warns `DF8111` — ship a self-contained
+   * bare-specifier client script warns `DF8111`; ship a self-contained
    * bundle and pass its URL instead.
    */
   clientModuleResolution?: string;
@@ -240,12 +245,12 @@ interface InitHubOptions {
 interface HubInstance {
   /**
    * The normalized mount base this hub answers under (leading and trailing
-   * slash, e.g. `/__devframes/`). Reference it when wiring the mount — route
-   * guards, middleware path checks — instead of repeating the string literal.
+   * slash, e.g. `/__devframes/`). Reference it when wiring the mount (route
+   * guards, middleware path checks) instead of repeating the string literal.
    */
   base: string;
   /**
-   * Web-standard request handler for the whole hub — mount it on one
+   * Web-standard request handler for the whole hub; mount it on one
    * catch-all route under {@link HubInstance.base}.
    */
   handler: (request: Request) => Promise<Response>;
@@ -253,7 +258,7 @@ interface HubInstance {
   nodeMiddleware: (req: IncomingMessage, res: ServerResponse, next?: (err?: unknown) => void) => void;
   /**
    * Route a host server's `upgrade` events to the shared RPC socket,
-   * returning a detach function — the manual counterpart to the `server`
+   * returning a detach function, the manual counterpart to the `server`
    * option, for hosts that get their `node:http` server only after the hub
    * exists. Available on the default tier; a configured transport (`server`,
    * `ws.port`, `ws.sidecar`, `ws.url`) already owns the socket and reports
@@ -276,14 +281,14 @@ interface HubInstance {
   close: () => Promise<void>;
 }
 /**
- * Initiate a hub instance — the whole multi-devframe devtools surface
+ * Initiate a hub instance: the whole multi-devframe devtools surface
  * behind one framework-agnostic, web-standard handler. Every mounted
  * devframe shares one context (merged RPC registry, shared state, docks /
  * terminals / messages / commands), one WebSocket transport, and one Auth;
  * the instance serves each frame's SPA at `<base><id>/`, the discovery
  * endpoints (`__connection.json`, `__index.json`, `__client-imports.js`),
  * the aggregate MCP route, and whatever the {@link DevframeHubUi} slot
- * provides — the hub itself stays headless.
+ * provides, while the hub itself stays headless.
  *
  * The factory is synchronous and initializes eagerly, and binds no port of
  * its own: the WebSocket follows `server` / `ws` (see