@devframes/hub 0.5.4 → 0.6.0-beta.2

package/dist/context-CXN9eDXS.d.mts

@@ -0,0 +1,343 @@
+import { M as JsonRenderSpec, N as JsonRenderer, b as DevframeDocksHost, c as DevframeCommandsHost, f as BuiltinDocksOptions, v as DevframeDockEntryIcon } from "./settings-DJs3n2p1.mjs";
+import { CreateHostContextOptions } from "devframe/node";
+import { DevframeHost, DevframeNodeContext, EventEmitter } from "devframe/types";
+import { ChildProcess } from "node:child_process";
+
+//#region src/types/messages.d.ts
+type DevframeMessageLevel = 'info' | 'warn' | 'error' | 'success' | 'debug';
+type DevframeMessageEntryFrom = 'server' | 'browser';
+interface DevframeMessageElementPosition {
+  /** CSS selector for the element */
+  selector?: string;
+  /** Bounding box of the element */
+  boundingBox?: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+  /** Human-readable description of the element */
+  description?: string;
+}
+interface DevframeMessageFilePosition {
+  /** Absolute or relative file path */
+  file: string;
+  /** Line number (1-based) */
+  line?: number;
+  /** Column number (1-based) */
+  column?: number;
+}
+interface DevframeMessageEntry {
+  /**
+   * Unique identifier for this message entry (auto-generated if not provided)
+   */
+  id: string;
+  /**
+   * Short title or summary of the message
+   */
+  message: string;
+  /**
+   * Optional detailed description or explanation
+   */
+  description?: string;
+  /**
+   * Severity level, determines color and icon
+   */
+  level: DevframeMessageLevel;
+  /**
+   * Optional stack trace string
+   */
+  stacktrace?: string;
+  /**
+   * Optional DOM element position info (e.g., for a11y issues)
+   */
+  elementPosition?: DevframeMessageElementPosition;
+  /**
+   * Optional source file position info (e.g., for lint errors)
+   */
+  filePosition?: DevframeMessageFilePosition;
+  /**
+   * Whether this message should also appear as a toast notification
+   */
+  notify?: boolean;
+  /**
+   * Origin of the message entry, automatically set by the context
+   */
+  from: DevframeMessageEntryFrom;
+  /**
+   * Grouping category (e.g., 'a11y', 'lint', 'runtime', 'test')
+   */
+  category?: string;
+  /**
+   * Optional tags/labels for filtering
+   */
+  labels?: string[];
+  /**
+   * Time in ms to auto-dismiss the toast notification (client-side)
+   */
+  autoDismiss?: number;
+  /**
+   * Time in ms to auto-delete this message entry (server-side)
+   */
+  autoDelete?: number;
+  /**
+   * Timestamp when the message was created (auto-generated if not provided)
+   */
+  timestamp: number;
+  /**
+   * Status of the message entry (e.g., 'loading' while an operation is in progress).
+   * Defaults to 'idle' when not specified.
+   */
+  status?: 'loading' | 'idle';
+}
+/**
+ * Input type for creating a message entry.
+ * `id`, `timestamp`, and `from` are auto-filled by the host.
+ */
+type DevframeMessageEntryInput = Omit<DevframeMessageEntry, 'id' | 'timestamp' | 'from'> & {
+  id?: string;
+  timestamp?: number;
+};
+interface DevframeMessageHandle {
+  /** The underlying message entry data */
+  readonly entry: DevframeMessageEntry;
+  /** Shortcut to entry.id */
+  readonly id: string;
+  /** Partial update of this message entry */
+  update: (patch: Partial<DevframeMessageEntryInput>) => Promise<DevframeMessageEntry | undefined>;
+  /** Remove this message entry */
+  dismiss: () => Promise<void>;
+}
+/**
+ * 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 —
+ * `messages.info('...')` is `messages.add({ message: '...', level: 'info' })`.
+ */
+interface DevframeMessagesLevelShortcuts {
+  /** Shortcut for `add({ message, level: 'info', ...extra })` */
+  info: (message: string, extra?: DevframeMessageShortcutInput) => Promise<DevframeMessageHandle>;
+  /** Shortcut for `add({ message, level: 'warn', ...extra })` */
+  warn: (message: string, extra?: DevframeMessageShortcutInput) => Promise<DevframeMessageHandle>;
+  /** Shortcut for `add({ message, level: 'error', ...extra })` */
+  error: (message: string, extra?: DevframeMessageShortcutInput) => Promise<DevframeMessageHandle>;
+  /** Shortcut for `add({ message, level: 'success', ...extra })` */
+  success: (message: string, extra?: DevframeMessageShortcutInput) => Promise<DevframeMessageHandle>;
+  /** Shortcut for `add({ message, level: 'debug', ...extra })` */
+  debug: (message: string, extra?: DevframeMessageShortcutInput) => Promise<DevframeMessageHandle>;
+}
+interface DevframeMessagesClient extends DevframeMessagesLevelShortcuts {
+  /**
+   * Add a message entry. Returns a Promise resolving to a handle for subsequent updates/dismissal.
+   * Can be used without `await` for fire-and-forget usage.
+   */
+  add: (input: DevframeMessageEntryInput) => Promise<DevframeMessageHandle>;
+  /** Remove a message entry by id */
+  remove: (id: string) => Promise<void>;
+  /** Clear all message entries */
+  clear: () => Promise<void>;
+}
+/**
+ * A snapshot or delta of the message list, as returned by
+ * {@link DevframeMessagesHost.listSince}. Consumers apply `removedIds`
+ * first, then upsert `entries`, and pass `version` back as `since` on the
+ * next call.
+ */
+interface DevframeMessagesListDelta {
+  /** Entries added or updated since the cursor (or all entries when `full`) */
+  entries: DevframeMessageEntry[];
+  /** Ids removed since the cursor (empty when `full`) */
+  removedIds: string[];
+  /** The version cursor — pass back as `since` on the next call */
+  version: number;
+  /**
+   * When `true`, `entries` is the complete snapshot and any locally cached
+   * list must be reset before applying it.
+   */
+  full: boolean;
+}
+interface DevframeMessagesHost extends DevframeMessagesLevelShortcuts {
+  readonly entries: Map<string, DevframeMessageEntry>;
+  readonly events: EventEmitter<{
+    'message:added': (entry: DevframeMessageEntry) => void;
+    'message:updated': (entry: DevframeMessageEntry) => void;
+    'message:removed': (id: string) => void;
+    'message:cleared': () => void;
+  }>;
+  /**
+   * Add a new message entry. If an entry with the same `id` already exists, it will be updated instead.
+   * Returns a handle for subsequent updates/dismissal. Can be used without `await` for fire-and-forget.
+   */
+  add: (entry: DevframeMessageEntryInput) => Promise<DevframeMessageHandle>;
+  /**
+   * Update an existing message entry by id (partial update)
+   */
+  update: (id: string, patch: Partial<DevframeMessageEntryInput>) => Promise<DevframeMessageEntry | undefined>;
+  /**
+   * Remove a message entry by id
+   */
+  remove: (id: string) => Promise<void>;
+  /**
+   * Clear all message entries
+   */
+  clear: () => Promise<void>;
+  /**
+   * Read the message list incrementally. Pass the `version` from the
+   * previous result as `since` to receive only the entries modified and the
+   * ids removed after that point; pass `null`/`undefined` for the initial
+   * full snapshot. When the host can no longer compute a reliable delta for
+   * the given cursor (trimmed removal history, or a cursor from another host
+   * incarnation), the result carries `full: true` with the complete list.
+   */
+  listSince: (since?: number | null) => DevframeMessagesListDelta;
+}
+//#endregion
+//#region src/types/terminals.d.ts
+interface DevframeTerminalsHost {
+  readonly sessions: Map<string, DevframeTerminalSession>;
+  readonly events: EventEmitter<{
+    'terminal:session:updated': (session: DevframeTerminalSession) => void;
+  }>;
+  register: (session: DevframeTerminalSession) => DevframeTerminalSession;
+  update: (session: DevframeTerminalSession) => void;
+  /**
+   * Spawn a read-only child process (pipe-backed, output only). Use this for
+   * long-running logs and dev servers that don't need input.
+   */
+  startChildProcess: (executeOptions: DevframeChildProcessExecuteOptions, terminal: Omit<DevframeTerminalSessionBase, 'status'>) => Promise<DevframeChildProcessTerminalSession>;
+  /**
+   * Spawn a fully interactive pseudo-terminal (PTY) any plugin can drive:
+   * keystrokes via {@link DevframePtyTerminalSession.write}, live layout via
+   * {@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
+   * pipe-based terminal emulation.
+   */
+  startPtySession: (executeOptions: DevframePtyExecuteOptions, terminal: Omit<DevframeTerminalSessionBase, 'status'>) => Promise<DevframePtyTerminalSession>;
+}
+type DevframeTerminalStatus = 'running' | 'stopped' | 'error';
+interface DevframeTerminalSessionBase {
+  id: string;
+  title: string;
+  description?: string;
+  status: DevframeTerminalStatus;
+  icon?: DevframeDockEntryIcon;
+  /**
+   * Whether the session accepts input (keystrokes + resize). `true` for
+   * {@link DevframeTerminalsHost.startPtySession} sessions; absent/`false`
+   * for pipe-backed, output-only ones. A hub-aware terminal UI reads this to
+   * decide whether to enable stdin and wire resize.
+   */
+  interactive?: boolean;
+}
+interface DevframeTerminalSession extends DevframeTerminalSessionBase {
+  buffer?: string[];
+  stream?: ReadableStream<string>;
+}
+interface DevframeChildProcessExecuteOptions {
+  command: string;
+  args: string[];
+  cwd?: string;
+  env?: Record<string, string>;
+}
+interface DevframeChildProcessTerminalSession extends DevframeTerminalSession {
+  type: 'child-process';
+  executeOptions: DevframeChildProcessExecuteOptions;
+  getChildProcess: () => ChildProcess | undefined;
+  terminate: () => Promise<void>;
+  restart: () => Promise<void>;
+}
+interface DevframePtyExecuteOptions {
+  command: string;
+  args?: string[];
+  cwd?: string;
+  env?: Record<string, string>;
+  /** Initial column count. Default: 80. */
+  cols?: number;
+  /** Initial row count. Default: 24. */
+  rows?: number;
+}
+interface DevframePtyTerminalSession extends DevframeTerminalSession {
+  type: 'pty';
+  interactive: true;
+  executeOptions: DevframePtyExecuteOptions;
+  /** Send keystrokes / raw input to the PTY. */
+  write: (data: string) => void;
+  /** Resize the PTY (emits SIGWINCH so TUIs relayout). */
+  resize: (cols: number, rows: number) => void;
+  /** Current foreground process name, when the backend can resolve it. */
+  getProcessName: () => string | undefined;
+  terminate: () => Promise<void>;
+  restart: () => Promise<void>;
+}
+//#endregion
+//#region src/node/context.d.ts
+declare module 'devframe/types' {
+  interface DevframeRpcClientFunctions {
+    /**
+     * Server→client notification that terminal sessions changed. Broadcast
+     * by the hub context; a hub-aware client re-reads terminal state in
+     * response. Do not register manually.
+     *
+     * @internal
+     */
+    'devframe:terminals:updated': () => Promise<void>;
+    /**
+     * Server→client notification that the message list changed. Broadcast
+     * by the hub context; a hub-aware client re-reads message state in
+     * response. Do not register manually.
+     *
+     * @internal
+     */
+    'devframe:messages:updated': () => Promise<void>;
+  }
+}
+/**
+ * Hub-augmented node context — extends devframe's framework-neutral
+ * `DevframeNodeContext` with the hub-level subsystems (`docks`,
+ * `terminals`, `messages`, `commands`) and the `createJsonRenderer`
+ * factory.
+ *
+ * Framework kits further extend this with their own slots (e.g.
+ * `viteConfig`, `viteServer`). Host-specific capabilities (editor open,
+ * filesystem reveal, etc.) ship as kit-registered RPC functions rather
+ * than as part of this surface.
+ */
+interface DevframeHubContext extends DevframeNodeContext {
+  readonly host: DevframeHost;
+  docks: DevframeDocksHost;
+  terminals: DevframeTerminalsHost;
+  messages: DevframeMessagesHost;
+  commands: DevframeCommandsHost;
+  /**
+   * Create a JsonRenderer handle for building json-render powered UIs.
+   */
+  createJsonRenderer: (spec: JsonRenderSpec) => JsonRenderer;
+}
+interface CreateHubContextOptions extends CreateHostContextOptions {
+  /**
+   * Gate the hub's synthesized built-in dock entries (`~terminals`,
+   * `~messages`, `~settings`). Each entry defaults to present; set one to
+   * `false` to suppress it — e.g. when mounting `@devframes/plugin-terminals`
+   * or `@devframes/plugin-messages`, which replace the built-in tabs.
+   *
+   * Omitting this option keeps all three built-ins.
+   *
+   * @default { terminals: true, messages: true, settings: true }
+   */
+  builtinDocks?: BuiltinDocksOptions;
+}
+/**
+ * Create a hub-level node context: wraps devframe's `createHostContext`,
+ * attaches the hub hosts (`docks`, `terminals`, `messages`, `commands`),
+ * registers the hub's built-in RPC commands, and wires the shared-state
+ * synchronization that powers a hub-aware client UI.
+ */
+declare function createHubContext(options: CreateHubContextOptions): Promise<DevframeHubContext>;
+//#endregion
+export { DevframeMessagesListDelta as C, DevframeMessagesLevelShortcuts as S, DevframeMessageHandle as _, DevframeChildProcessTerminalSession as a, DevframeMessagesClient as b, DevframeTerminalSession as c, DevframeTerminalsHost as d, DevframeMessageElementPosition as f, DevframeMessageFilePosition as g, DevframeMessageEntryInput as h, DevframeChildProcessExecuteOptions as i, DevframeTerminalSessionBase as l, DevframeMessageEntryFrom as m, DevframeHubContext as n, DevframePtyExecuteOptions as o, DevframeMessageEntry as p, createHubContext as r, DevframePtyTerminalSession as s, CreateHubContextOptions as t, DevframeTerminalStatus as u, DevframeMessageLevel as v, DevframeMessagesHost as x, DevframeMessageShortcutInput as y };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { A as JsonRenderer, C as DevframeViewJsonRender, D as RemoteDockOptions, E as RemoteConnectionInfo, F as DevframeMessageFilePosition, I as DevframeMessageHandle, L as DevframeMessageLevel, M as DevframeMessageEntry, N as DevframeMessageEntryFrom, O as JsonRenderElement, P as DevframeMessageEntryInput, R as DevframeMessagesClient, S as DevframeViewIframe, T as DevframeViewLauncherStatus, _ as DevframeDocksHost, a as DevframeChildProcessTerminalSession, b as DevframeViewCustomRender, c as DevframeTerminalStatus, d as DevframeDockEntriesGrouped, f as DevframeDockEntry, g as DevframeDockUserEntry, h as DevframeDockEntryIcon, i as DevframeChildProcessExecuteOptions, j as DevframeMessageElementPosition, k as JsonRenderSpec, l as DevframeTerminalsHost, m as DevframeDockEntryCategory, n as DevframeHubContext, o as DevframeTerminalSession, p as DevframeDockEntryBase, s as DevframeTerminalSessionBase, t as CreateHubContextOptions, u as ClientScriptEntry, v as DevframeViewAction, w as DevframeViewLauncher, x as DevframeViewGroup, y as DevframeViewBuiltin, z as DevframeMessagesHost } from "./context-Dox-G9vt.mjs";
-import { a as DevframeCommandHandle, c as DevframeCommandsHost, d as DevframeServerCommandInput, i as DevframeCommandEntry, l as DevframeCommandsHostEvents, n as DevframeClientCommand, o as DevframeCommandKeybinding, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry } from "./settings-Bp5Ax6Os.mjs";
-import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "./index-BWTfvdqa.mjs";
+import { C as DevframeMessagesListDelta, S as DevframeMessagesLevelShortcuts, _ as DevframeMessageHandle, a as DevframeChildProcessTerminalSession, b as DevframeMessagesClient, c as DevframeTerminalSession, d as DevframeTerminalsHost, f as DevframeMessageElementPosition, g as DevframeMessageFilePosition, h as DevframeMessageEntryInput, i as DevframeChildProcessExecuteOptions, l as DevframeTerminalSessionBase, m as DevframeMessageEntryFrom, n as DevframeHubContext, o as DevframePtyExecuteOptions, p as DevframeMessageEntry, s as DevframePtyTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalStatus, v as DevframeMessageLevel, x as DevframeMessagesHost, y as DevframeMessageShortcutInput } from "./context-CXN9eDXS.mjs";
+import { A as RemoteDockOptions, C as DevframeViewCustomRender, D as DevframeViewLauncher, E as DevframeViewJsonRender, M as JsonRenderSpec, N as JsonRenderer, O as DevframeViewLauncherStatus, S as DevframeViewBuiltin, T as DevframeViewIframe, _ as DevframeDockEntryCategory, a as DevframeCommandHandle, b as DevframeDocksHost, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as BuiltinDocksOptions, g as DevframeDockEntryBase, h as DevframeDockEntry, i as DevframeCommandEntry, j as JsonRenderElement, k as RemoteConnectionInfo, l as DevframeCommandsHostEvents, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as ClientScriptEntry, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockEntryIcon, w as DevframeViewGroup, x as DevframeViewAction, y as DevframeDockUserEntry } from "./settings-DJs3n2p1.mjs";
+import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "./index-Dic9q4eN.mjs";
 import * as _$devframe_rpc0 from "devframe/rpc";
 import { WhenContext, WhenExpression } from "devframe/utils/when";
 
@@ -14,4 +14,4 @@ declare function defineDockEntry<const T extends DevframeDockUserEntry, const W
 }): T;
 declare function defineJsonRenderSpec(spec: JsonRenderSpec): JsonRenderSpec;
 //#endregion
-export { ClientScriptEntry, ConnectionMeta, CreateHubContextOptions, DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, DevframeDiagnosticsDefinition, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockUserEntry, DevframeDocksHost, DevframeDocksUserSettings, DevframeHost, DevframeHubContext, DevframeMessageElementPosition, DevframeMessageEntry, DevframeMessageEntryFrom, DevframeMessageEntryInput, DevframeMessageFilePosition, DevframeMessageHandle, DevframeMessageLevel, DevframeMessagesClient, DevframeMessagesHost, DevframeNodeRpcSession, DevframeRpcClientFunctions, DevframeRpcServerFunctions, DevframeRpcSharedStates, DevframeServerCommandEntry, DevframeServerCommandInput, DevframeTerminalSession, DevframeTerminalSessionBase, DevframeTerminalStatus, DevframeTerminalsHost, DevframeViewAction, DevframeViewBuiltin, DevframeViewCustomRender, DevframeViewGroup, DevframeViewHost, DevframeViewIframe, DevframeViewJsonRender, DevframeViewLauncher, DevframeViewLauncherStatus, EntriesToObject, EventEmitter, EventUnsubscribe, EventsMap, JsonRenderElement, JsonRenderSpec, JsonRenderer, PartialWithoutId, RemoteConnectionInfo, RemoteDockOptions, RpcBroadcastOptions, RpcDefinitionsFilter, RpcDefinitionsToFunctions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, Thenable, defineCommand, defineDockEntry, defineHubRpcFunction, defineJsonRenderSpec };
+export { BuiltinDocksOptions, ClientScriptEntry, ConnectionMeta, CreateHubContextOptions, DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, DevframeDiagnosticsDefinition, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockUserEntry, DevframeDocksHost, DevframeDocksUserSettings, DevframeHost, DevframeHubContext, DevframeMessageElementPosition, DevframeMessageEntry, DevframeMessageEntryFrom, DevframeMessageEntryInput, DevframeMessageFilePosition, DevframeMessageHandle, DevframeMessageLevel, DevframeMessageShortcutInput, DevframeMessagesClient, DevframeMessagesHost, DevframeMessagesLevelShortcuts, DevframeMessagesListDelta, DevframeNodeRpcSession, DevframePtyExecuteOptions, DevframePtyTerminalSession, DevframeRpcClientFunctions, DevframeRpcServerFunctions, DevframeRpcSharedStates, DevframeServerCommandEntry, DevframeServerCommandInput, DevframeTerminalSession, DevframeTerminalSessionBase, DevframeTerminalStatus, DevframeTerminalsHost, DevframeViewAction, DevframeViewBuiltin, DevframeViewCustomRender, DevframeViewGroup, DevframeViewHost, DevframeViewIframe, DevframeViewJsonRender, DevframeViewLauncher, DevframeViewLauncherStatus, EntriesToObject, EventEmitter, EventUnsubscribe, EventsMap, JsonRenderElement, JsonRenderSpec, JsonRenderer, PartialWithoutId, RemoteConnectionInfo, RemoteDockOptions, RpcBroadcastOptions, RpcDefinitionsFilter, RpcDefinitionsToFunctions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, Thenable, defineCommand, defineDockEntry, defineHubRpcFunction, defineJsonRenderSpec };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { i as defineJsonRenderSpec, n as defineDockEntry, r as defineHubRpcFunction, t as defineCommand } from "./define-tHP6fX6A.mjs";
+import { i as defineJsonRenderSpec, n as defineDockEntry, r as defineHubRpcFunction, t as defineCommand } from "./define-Dp-x6d09.mjs";
 export { defineCommand, defineDockEntry, defineHubRpcFunction, defineJsonRenderSpec };

package/dist/node/index.d.mts

@@ -1,5 +1,5 @@
-import { I as DevframeMessageHandle, M as DevframeMessageEntry, P as DevframeMessageEntryInput, S as DevframeViewIframe, _ as DevframeDocksHost$1, a as DevframeChildProcessTerminalSession, f as DevframeDockEntry, g as DevframeDockUserEntry, i as DevframeChildProcessExecuteOptions, l as DevframeTerminalsHost$1, n as DevframeHubContext, o as DevframeTerminalSession, r as createHubContext, s as DevframeTerminalSessionBase, t as CreateHubContextOptions, u as ClientScriptEntry, z as DevframeMessagesHost$1 } from "../context-Dox-G9vt.mjs";
-import { a as DevframeCommandHandle, c as DevframeCommandsHost$1, d as DevframeServerCommandInput, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry } from "../settings-Bp5Ax6Os.mjs";
+import { C as DevframeMessagesListDelta, _ as DevframeMessageHandle, a as DevframeChildProcessTerminalSession, c as DevframeTerminalSession, d as DevframeTerminalsHost$1, h as DevframeMessageEntryInput, i as DevframeChildProcessExecuteOptions, l as DevframeTerminalSessionBase, n as DevframeHubContext, o as DevframePtyExecuteOptions, p as DevframeMessageEntry, r as createHubContext, s as DevframePtyTerminalSession, t as CreateHubContextOptions, x as DevframeMessagesHost$1, y as DevframeMessageShortcutInput } from "../context-CXN9eDXS.mjs";
+import { T as DevframeViewIframe, a as DevframeCommandHandle, b as DevframeDocksHost$1, c as DevframeCommandsHost$1, d as DevframeServerCommandInput, f as BuiltinDocksOptions, h as DevframeDockEntry, p as ClientScriptEntry, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, y as DevframeDockUserEntry } from "../settings-DJs3n2p1.mjs";
 import * as _$devframe_rpc0 from "devframe/rpc";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { DevframeDefinition } from "devframe/types";
@@ -23,12 +23,25 @@ declare class DevframeCommandsHost implements DevframeCommandsHost$1 {
 //#region src/node/host-docks.d.ts
 declare class DevframeDocksHost implements DevframeDocksHost$1 {
   readonly context: DevframeHubContext;
+  /**
+   * Per-entry toggles for the synthesized built-in dock entries. An omitted
+   * (or `undefined`) flag keeps that built-in; only an explicit `false`
+   * suppresses it.
+   */
+  private readonly builtinDocks;
   readonly views: DevframeDocksHost$1['views'];
   readonly events: DevframeDocksHost$1['events'];
   userSettings: SharedState<DevframeDocksUserSettings>;
   /** Dock-id → allocated remote token + resolved options. */
   private readonly remoteDocks;
-  constructor(context: DevframeHubContext);
+  constructor(context: DevframeHubContext,
+  /**
+   * Per-entry toggles for the synthesized built-in dock entries. An omitted
+   * (or `undefined`) flag keeps that built-in; only an explicit `false`
+   * suppresses it.
+   */
+
+  builtinDocks?: BuiltinDocksOptions);
   init(): Promise<void>;
   values({
     includeBuiltin
@@ -59,12 +72,25 @@ declare class DevframeMessagesHost implements DevframeMessagesHost$1 {
   }>;
   private _autoDeleteTimers;
   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
+   * and fall back to a full snapshot in {@link listSince}.
+   */
+  private _removalsTrimmedAt;
   private _tick;
+  private _recordRemoval;
   constructor(context: DevframeHubContext);
   add(input: DevframeMessageEntryInput): Promise<DevframeMessageHandle>;
   update(id: string, patch: Partial<DevframeMessageEntryInput>): Promise<DevframeMessageEntry | undefined>;
   remove(id: string): Promise<void>;
+  info(message: string, extra?: DevframeMessageShortcutInput): Promise<DevframeMessageHandle>;
+  warn(message: string, extra?: DevframeMessageShortcutInput): Promise<DevframeMessageHandle>;
+  error(message: string, extra?: DevframeMessageShortcutInput): Promise<DevframeMessageHandle>;
+  success(message: string, extra?: DevframeMessageShortcutInput): Promise<DevframeMessageHandle>;
+  debug(message: string, extra?: DevframeMessageShortcutInput): Promise<DevframeMessageHandle>;
   clear(): Promise<void>;
+  listSince(since?: number | null): DevframeMessagesListDelta;
   private _createHandle;
 }
 //#endregion
@@ -92,6 +118,7 @@ declare class DevframeTerminalsHost implements DevframeTerminalsHost$1 {
   remove(session: DevframeTerminalSession): void;
   private bindStream;
   startChildProcess(executeOptions: DevframeChildProcessExecuteOptions, terminal: Omit<DevframeTerminalSessionBase, 'status'>): Promise<DevframeChildProcessTerminalSession>;
+  startPtySession(executeOptions: DevframePtyExecuteOptions, terminal: Omit<DevframeTerminalSessionBase, 'status'>): Promise<DevframePtyTerminalSession>;
 }
 //#endregion
 //#region src/node/mount-devframe.d.ts
@@ -144,6 +171,114 @@ declare const hubCommandsExecute: {
   __cache?: WeakMap<object, _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, ...args: any[]], Promise<unknown>>>> | undefined;
   __promise?: _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, ...args: any[]], Promise<unknown>>> | undefined;
 };
+/**
+ * `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).
+ *
+ * Pairs with the client-side {@link import('../client').createDevframeClientHost}
+ * context, whose `messages` client dispatches through these built-ins so a
+ * dock client script can report into the same feed the server writes to.
+ */
+declare const hubMessagesAdd: {
+  name: "hub:messages:add";
+  type?: "action" | undefined;
+  cacheable?: boolean;
+  args?: undefined;
+  returns?: undefined;
+  jsonSerializable?: boolean;
+  agent?: _$devframe.RpcFunctionAgentOptions;
+  setup?: ((context: DevframeHubContext) => _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>>>) | undefined;
+  handler?: ((input: DevframeMessageEntryInput) => Promise<DevframeMessageEntry>) | undefined;
+  dump?: _$devframe_rpc0.RpcDump<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>, DevframeHubContext> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>>>> | undefined;
+  __promise?: _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>>> | 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;
+  cacheable?: boolean;
+  args?: undefined;
+  returns?: undefined;
+  jsonSerializable?: boolean;
+  agent?: _$devframe.RpcFunctionAgentOptions;
+  setup?: ((context: DevframeHubContext) => _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>>>) | undefined;
+  handler?: ((id: string, patch: Partial<DevframeMessageEntryInput>) => Promise<DevframeMessageEntry | undefined>) | undefined;
+  dump?: _$devframe_rpc0.RpcDump<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>, DevframeHubContext> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>>>> | undefined;
+  __promise?: _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>>> | undefined;
+};
+/** `hub:messages:remove` — Remove a message by id. */
+declare const hubMessagesRemove: {
+  name: "hub:messages:remove";
+  type?: "action" | undefined;
+  cacheable?: boolean;
+  args?: undefined;
+  returns?: undefined;
+  jsonSerializable?: boolean;
+  agent?: _$devframe.RpcFunctionAgentOptions;
+  setup?: ((context: DevframeHubContext) => _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string], Promise<void>>>) | undefined;
+  handler?: ((id: string) => Promise<void>) | undefined;
+  dump?: _$devframe_rpc0.RpcDump<[id: string], Promise<void>, DevframeHubContext> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string], Promise<void>>>> | undefined;
+  __promise?: _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string], Promise<void>>> | undefined;
+};
+/** `hub:messages:clear` — Remove every message. */
+declare const hubMessagesClear: {
+  name: "hub:messages:clear";
+  type?: "action" | undefined;
+  cacheable?: boolean;
+  args?: undefined;
+  returns?: undefined;
+  jsonSerializable?: boolean;
+  agent?: _$devframe.RpcFunctionAgentOptions;
+  setup?: ((context: DevframeHubContext) => _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[], Promise<void>>>) | undefined;
+  handler?: (() => Promise<void>) | undefined;
+  dump?: _$devframe_rpc0.RpcDump<[], Promise<void>, DevframeHubContext> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[], Promise<void>>>> | undefined;
+  __promise?: _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[], Promise<void>>> | undefined;
+};
+/**
+ * `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.
+ */
+declare const hubTerminalsWrite: {
+  name: "hub:terminals:write";
+  type?: "action" | undefined;
+  cacheable?: boolean;
+  args?: undefined;
+  returns?: undefined;
+  jsonSerializable?: boolean;
+  agent?: _$devframe.RpcFunctionAgentOptions;
+  setup?: ((context: DevframeHubContext) => _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, data: string], Promise<void>>>) | undefined;
+  handler?: ((id: string, data: string) => Promise<void>) | undefined;
+  dump?: _$devframe_rpc0.RpcDump<[id: string, data: string], Promise<void>, DevframeHubContext> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, data: string], Promise<void>>>> | undefined;
+  __promise?: _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, data: string], Promise<void>>> | undefined;
+};
+/** `hub:terminals:resize` — Resize an interactive PTY session by id. */
+declare const hubTerminalsResize: {
+  name: "hub:terminals:resize";
+  type?: "action" | undefined;
+  cacheable?: boolean;
+  args?: undefined;
+  returns?: undefined;
+  jsonSerializable?: boolean;
+  agent?: _$devframe.RpcFunctionAgentOptions;
+  setup?: ((context: DevframeHubContext) => _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, cols: number, rows: number], Promise<void>>>) | undefined;
+  handler?: ((id: string, cols: number, rows: number) => Promise<void>) | undefined;
+  dump?: _$devframe_rpc0.RpcDump<[id: string, cols: number, rows: number], Promise<void>, DevframeHubContext> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, cols: number, rows: number], Promise<void>>>> | undefined;
+  __promise?: _$devframe_rpc0.Thenable<_$devframe_rpc0.RpcFunctionSetupResult<[id: string, cols: number, rows: number], Promise<void>>> | undefined;
+};
 /**
  * Framework-neutral RPC declarations auto-registered by
  * {@link createHubContext}. Provide additional RPCs by passing your own
@@ -162,4 +297,4 @@ declare const builtinHubRpcDeclarations: readonly RpcFunctionDefinitionAny[];
  */
 declare function createSimpleClientScript(fn: string | ((ctx: any) => void)): ClientScriptEntry;
 //#endregion
-export { CreateHubContextOptions, DevframeCommandsHost, DevframeDocksHost, DevframeHubContext, DevframeMessagesHost, DevframeTerminalsHost, MountDevframeOptions, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, mountDevframe };
+export { CreateHubContextOptions, DevframeCommandsHost, DevframeDocksHost, DevframeHubContext, DevframeMessagesHost, DevframeTerminalsHost, MountDevframeOptions, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, hubMessagesAdd, hubMessagesClear, hubMessagesRemove, hubMessagesUpdate, hubTerminalsResize, hubTerminalsWrite, mountDevframe };