@bastani/atomic 0.9.9 → 0.9.10

package/dist/modes/interactive-engine/protocol.d.ts

@@ -0,0 +1,184 @@
+import type { CallbackActivity } from "../../core/callback-activity.ts";
+import type { HostInputFormField, HostSessionPickerRow } from "../../core/extensions/ui-types.ts";
+import type { KeyId } from "../../core/keybindings.ts";
+export declare const INTERACTIVE_ENGINE_PROTOCOL_VERSION = 1;
+export declare const INTERACTIVE_ENGINE_MAX_FRAME_BYTES = 1048576;
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type JsonValue = boolean | JsonObject | JsonValue[] | null | number | string;
+export interface SerializableOverlayOptions {
+    anchor?: string;
+    col?: number | string;
+    margin?: number | {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    maxHeight?: number | string;
+    maxWidth?: number | string;
+    minHeight?: number;
+    minWidth?: number;
+    offsetX?: number;
+    offsetY?: number;
+    row?: number | string;
+    width?: number | string;
+}
+/**
+ * Allowlisted terminal-mode controls a remote custom component may ask the host
+ * to apply to the real host TTY. Deliberately NOT a raw byte channel: the child
+ * names an intent and the host owns the concrete escape sequence, so a buggy or
+ * compromised child can only toggle these two documented modes.
+ */
+export type EngineTerminalControl = {
+    kind: "mouse-scroll-tracking";
+    enabled: boolean;
+} | {
+    kind: "autowrap";
+    enabled: boolean;
+};
+export interface EngineExtensionShortcut {
+    key: string;
+    description?: string;
+}
+export type SerializableKeybindingsConfig = Record<string, KeyId | KeyId[]>;
+export interface EngineKeybindingState {
+    userBindings: SerializableKeybindingsConfig;
+    effectiveBindings: SerializableKeybindingsConfig;
+    shortcuts: EngineExtensionShortcut[];
+}
+export type InteractiveEngineMessage = {
+    type: "engine_ready";
+    protocolVersion: typeof INTERACTIVE_ENGINE_PROTOCOL_VERSION;
+    pid: number;
+} | {
+    type: "engine_bound";
+} | {
+    type: "engine_keybindings_reloaded";
+    state: EngineKeybindingState;
+} | {
+    type: "engine_heartbeat";
+    at: number;
+} | {
+    type: "engine_activity_started";
+    activity: CallbackActivity;
+} | {
+    type: "engine_activity_finished";
+    activityId: string;
+} | {
+    type: "engine_custom_open";
+    componentId: string;
+    overlay: boolean;
+    deferInlineCustomUiFocus?: boolean;
+    overlayOptions?: SerializableOverlayOptions;
+    widgetKey?: string;
+    widgetPlacement?: "aboveEditor" | "belowEditor";
+} | {
+    type: "engine_custom_close";
+    componentId: string;
+} | {
+    type: "engine_custom_frame";
+    componentId: string;
+    requestId: number;
+    lines: string[];
+} | {
+    type: "engine_custom_invalidate";
+    componentId: string;
+} | {
+    type: "engine_custom_done";
+    componentId: string;
+    result?: JsonValue;
+} | {
+    type: "engine_custom_terminal";
+    componentId: string;
+    control: EngineTerminalControl;
+} | {
+    type: "engine_custom_control";
+    componentId: string;
+    action: "focus" | "hide" | "show" | "unfocus";
+} | {
+    type: "engine_session_picker_open";
+    componentId: string;
+    sessions: HostSessionPickerRow[];
+    showRenameHint?: boolean;
+} | {
+    type: "engine_session_picker_update";
+    componentId: string;
+    sessions: HostSessionPickerRow[];
+} | {
+    type: "engine_session_picker_error";
+    componentId: string;
+    message: string;
+} | {
+    type: "engine_session_picker_close";
+    componentId: string;
+} | {
+    type: "engine_input_form_open";
+    componentId: string;
+    title: string;
+    fields: HostInputFormField[];
+};
+export type InteractiveEngineCommand = {
+    type: "engine_custom_render";
+    componentId: string;
+    requestId: number;
+    width: number;
+    rows: number;
+} | {
+    type: "engine_custom_input";
+    componentId: string;
+    data: string;
+} | {
+    type: "engine_custom_dispose";
+    componentId: string;
+} | {
+    type: "engine_tool_render";
+    componentId: string;
+    requestId: number;
+    width: number;
+    toolName: string;
+    toolCallId: string;
+    args: JsonValue;
+    result?: JsonObject;
+    executionStarted: boolean;
+    argsComplete: boolean;
+    isPartial: boolean;
+    expanded: boolean;
+    showImages: boolean;
+    imageWidthCells: number;
+} | {
+    type: "engine_message_render";
+    componentId: string;
+    requestId: number;
+    width: number;
+    message: JsonObject;
+    expanded: boolean;
+} | {
+    type: "engine_render_dispose";
+    componentId: string;
+} | {
+    type: "engine_session_picker_select";
+    componentId: string;
+    path: string;
+} | {
+    type: "engine_session_picker_cancel";
+    componentId: string;
+} | {
+    type: "engine_session_picker_delete";
+    componentId: string;
+    path: string;
+} | {
+    type: "engine_input_form_submit";
+    componentId: string;
+    values: Record<string, string>;
+} | {
+    type: "engine_input_form_cancel";
+    componentId: string;
+};
+export declare function isJsonValue(value: object | boolean | null | number | string): value is JsonValue;
+export declare function parseInteractiveEngineMessage(line: string): InteractiveEngineMessage | undefined;
+export declare function parseInteractiveEngineCommand(line: string): InteractiveEngineCommand | undefined;
+export declare function serializeInteractiveEngineFrame(message: InteractiveEngineMessage | InteractiveEngineCommand): string;
+export declare const serializeInteractiveEngineMessage: typeof serializeInteractiveEngineFrame;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/modes/interactive-engine/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/protocol.ts"],"names":[],"mappings":"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"}

package/dist/modes/interactive-engine/protocol.js

@@ -0,0 +1,254 @@
+export const INTERACTIVE_ENGINE_PROTOCOL_VERSION = 1;
+export const INTERACTIVE_ENGINE_MAX_FRAME_BYTES = 1_048_576;
+const ACTIVITY_KINDS = [
+    "extension.hook", "renderer", "tool.execute", "tool.prepare", "workflow.ctx_tool",
+    "workflow.run", "workflow.stage_adapter",
+];
+export function isJsonValue(value) {
+    if (value === null || typeof value !== "object")
+        return true;
+    if (Array.isArray(value))
+        return value.every((item) => isJsonValue(item));
+    return Object.values(value).every((item) => item !== undefined && isJsonValue(item));
+}
+function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isActivityKind(value) {
+    return typeof value === "string" && ACTIVITY_KINDS.includes(value);
+}
+function isCallbackActivity(value) {
+    return isJsonObject(value) && typeof value.id === "string" && isActivityKind(value.kind) &&
+        typeof value.name === "string" && typeof value.startedAt === "number";
+}
+function parseEngineTerminalControl(value) {
+    if (value === undefined || !isJsonObject(value) || typeof value.enabled !== "boolean")
+        return undefined;
+    if (value.kind === "mouse-scroll-tracking" || value.kind === "autowrap") {
+        return { kind: value.kind, enabled: value.enabled };
+    }
+    return undefined;
+}
+const SESSION_PICKER_MESSAGE_COLORS = ["success", "warning", "accent", "error"];
+function parseSessionPickerRow(value) {
+    if (!isJsonObject(value))
+        return undefined;
+    const { path, id, cwd, createdAt, modifiedAt, messageCount, firstMessage, allMessagesText, name, messageColor } = value;
+    if (typeof path !== "string" || typeof id !== "string" || typeof cwd !== "string" ||
+        typeof createdAt !== "number" || typeof modifiedAt !== "number" ||
+        typeof messageCount !== "number" || typeof firstMessage !== "string")
+        return undefined;
+    if (allMessagesText !== undefined && typeof allMessagesText !== "string")
+        return undefined;
+    if (name !== undefined && typeof name !== "string")
+        return undefined;
+    if (messageColor !== undefined && !SESSION_PICKER_MESSAGE_COLORS.includes(messageColor))
+        return undefined;
+    return {
+        path, id, cwd, createdAt, modifiedAt, messageCount, firstMessage,
+        ...(allMessagesText !== undefined ? { allMessagesText } : {}),
+        ...(name !== undefined ? { name } : {}),
+        ...(messageColor !== undefined ? { messageColor: messageColor } : {}),
+    };
+}
+function parseSessionPickerRows(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const rows = [];
+    for (const entry of value) {
+        const row = parseSessionPickerRow(entry);
+        if (!row)
+            return undefined;
+        rows.push(row);
+    }
+    return rows;
+}
+const INPUT_FORM_FIELD_TYPES = ["string", "text", "number", "integer", "boolean", "select"];
+function parseInputFormFields(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const fields = [];
+    for (const entry of value) {
+        if (!isJsonObject(entry))
+            return undefined;
+        const { name, type, description, required, choices, placeholder, initialValue } = entry;
+        if (typeof name !== "string" || !INPUT_FORM_FIELD_TYPES.includes(type) || typeof initialValue !== "string")
+            return undefined;
+        if (description !== undefined && typeof description !== "string")
+            return undefined;
+        if (required !== undefined && typeof required !== "boolean")
+            return undefined;
+        if (choices !== undefined && (!Array.isArray(choices) || !choices.every((choice) => typeof choice === "string")))
+            return undefined;
+        if (placeholder !== undefined && typeof placeholder !== "string")
+            return undefined;
+        fields.push({ name, type: type, initialValue,
+            ...(typeof description === "string" ? { description } : {}),
+            ...(typeof required === "boolean" ? { required } : {}),
+            ...(Array.isArray(choices) ? { choices: choices } : {}),
+            ...(typeof placeholder === "string" ? { placeholder } : {}) });
+    }
+    return fields;
+}
+function parseStringRecord(value) {
+    if (value === undefined || !isJsonObject(value))
+        return undefined;
+    const entries = Object.entries(value);
+    if (entries.some(([, entry]) => typeof entry !== "string"))
+        return undefined;
+    return Object.fromEntries(entries);
+}
+function parseKeybindingsConfig(value) {
+    if (value === undefined || !isJsonObject(value))
+        return undefined;
+    const config = {};
+    for (const [key, binding] of Object.entries(value)) {
+        if (typeof binding === "string")
+            config[key] = binding;
+        else if (Array.isArray(binding) && binding.every((entry) => typeof entry === "string")) {
+            config[key] = binding;
+        }
+        else
+            return undefined;
+    }
+    return config;
+}
+function parseKeybindingState(value) {
+    if (value === undefined || !isJsonObject(value) || !Array.isArray(value.shortcuts))
+        return undefined;
+    const userBindings = parseKeybindingsConfig(value.userBindings);
+    const effectiveBindings = parseKeybindingsConfig(value.effectiveBindings);
+    if (!userBindings || !effectiveBindings)
+        return undefined;
+    const shortcuts = [];
+    for (const shortcut of value.shortcuts) {
+        if (!isJsonObject(shortcut) || typeof shortcut.key !== "string" ||
+            (shortcut.description !== undefined && typeof shortcut.description !== "string"))
+            return undefined;
+        shortcuts.push({ key: shortcut.key, ...(typeof shortcut.description === "string" ? { description: shortcut.description } : {}) });
+    }
+    return { userBindings, effectiveBindings, shortcuts };
+}
+function parseJsonObject(line) {
+    if (Buffer.byteLength(line, "utf8") > INTERACTIVE_ENGINE_MAX_FRAME_BYTES)
+        return undefined;
+    let value;
+    try {
+        value = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    return isJsonObject(value) ? value : undefined;
+}
+export function parseInteractiveEngineMessage(line) {
+    const value = parseJsonObject(line);
+    if (!value || typeof value.type !== "string")
+        return undefined;
+    switch (value.type) {
+        case "engine_ready":
+            return value.protocolVersion === INTERACTIVE_ENGINE_PROTOCOL_VERSION && typeof value.pid === "number"
+                ? { type: value.type, protocolVersion: INTERACTIVE_ENGINE_PROTOCOL_VERSION, pid: value.pid } : undefined;
+        case "engine_bound": return { type: value.type };
+        case "engine_keybindings_reloaded": {
+            const state = parseKeybindingState(value.state);
+            return state ? { type: value.type, state } : undefined;
+        }
+        case "engine_heartbeat": return typeof value.at === "number" ? { type: value.type, at: value.at } : undefined;
+        case "engine_activity_started": return isCallbackActivity(value.activity) ? { type: value.type, activity: value.activity } : undefined;
+        case "engine_activity_finished": return typeof value.activityId === "string" ? { type: value.type, activityId: value.activityId } : undefined;
+        case "engine_custom_open":
+            return typeof value.componentId === "string" && typeof value.overlay === "boolean"
+                ? { type: value.type, componentId: value.componentId, overlay: value.overlay,
+                    deferInlineCustomUiFocus: value.deferInlineCustomUiFocus === true,
+                    overlayOptions: isJsonObject(value.overlayOptions) ? value.overlayOptions : undefined,
+                    widgetKey: typeof value.widgetKey === "string" ? value.widgetKey : undefined,
+                    widgetPlacement: value.widgetPlacement === "belowEditor" ? "belowEditor" : value.widgetPlacement === "aboveEditor" ? "aboveEditor" : undefined }
+                : undefined;
+        case "engine_custom_close": return typeof value.componentId === "string" ? { type: value.type, componentId: value.componentId } : undefined;
+        case "engine_custom_frame":
+            return typeof value.componentId === "string" && typeof value.requestId === "number" &&
+                Array.isArray(value.lines) && value.lines.every((entry) => typeof entry === "string")
+                ? { type: value.type, componentId: value.componentId, requestId: value.requestId, lines: value.lines } : undefined;
+        case "engine_custom_invalidate": return typeof value.componentId === "string" ? { type: value.type, componentId: value.componentId } : undefined;
+        case "engine_custom_done": return typeof value.componentId === "string" ? { type: value.type, componentId: value.componentId, result: value.result } : undefined;
+        case "engine_custom_terminal": {
+            const control = parseEngineTerminalControl(value.control);
+            return typeof value.componentId === "string" && control
+                ? { type: value.type, componentId: value.componentId, control } : undefined;
+        }
+        case "engine_custom_control":
+            return typeof value.componentId === "string" && ["focus", "hide", "show", "unfocus"].includes(String(value.action))
+                ? { type: value.type, componentId: value.componentId, action: value.action } : undefined;
+        case "engine_session_picker_open": {
+            const sessions = parseSessionPickerRows(value.sessions);
+            return typeof value.componentId === "string" && sessions &&
+                (value.showRenameHint === undefined || typeof value.showRenameHint === "boolean")
+                ? { type: value.type, componentId: value.componentId, sessions,
+                    ...(typeof value.showRenameHint === "boolean" ? { showRenameHint: value.showRenameHint } : {}) }
+                : undefined;
+        }
+        case "engine_session_picker_update": {
+            const sessions = parseSessionPickerRows(value.sessions);
+            return typeof value.componentId === "string" && sessions
+                ? { type: value.type, componentId: value.componentId, sessions } : undefined;
+        }
+        case "engine_session_picker_error":
+            return typeof value.componentId === "string" && typeof value.message === "string"
+                ? { type: value.type, componentId: value.componentId, message: value.message } : undefined;
+        case "engine_session_picker_close":
+            return typeof value.componentId === "string" ? { type: value.type, componentId: value.componentId } : undefined;
+        case "engine_input_form_open": {
+            const fields = parseInputFormFields(value.fields);
+            return typeof value.componentId === "string" && typeof value.title === "string" && fields
+                ? { type: value.type, componentId: value.componentId, title: value.title, fields } : undefined;
+        }
+        default: return undefined;
+    }
+}
+export function parseInteractiveEngineCommand(line) {
+    const value = parseJsonObject(line);
+    if (!value || typeof value.type !== "string" || typeof value.componentId !== "string")
+        return undefined;
+    if (value.type === "engine_custom_render" && typeof value.requestId === "number" && typeof value.width === "number" && typeof value.rows === "number") {
+        return { type: value.type, componentId: value.componentId, requestId: value.requestId, width: value.width, rows: value.rows };
+    }
+    if (value.type === "engine_custom_input" && typeof value.data === "string")
+        return { type: value.type, componentId: value.componentId, data: value.data };
+    if (value.type === "engine_custom_dispose" || value.type === "engine_render_dispose")
+        return { type: value.type, componentId: value.componentId };
+    if ((value.type === "engine_session_picker_select" || value.type === "engine_session_picker_delete") && typeof value.path === "string") {
+        return { type: value.type, componentId: value.componentId, path: value.path };
+    }
+    if (value.type === "engine_session_picker_cancel")
+        return { type: value.type, componentId: value.componentId };
+    if (value.type === "engine_input_form_cancel")
+        return { type: value.type, componentId: value.componentId };
+    if (value.type === "engine_input_form_submit") {
+        const values = parseStringRecord(value.values);
+        return values ? { type: value.type, componentId: value.componentId, values } : undefined;
+    }
+    if (value.type === "engine_tool_render" && typeof value.requestId === "number" && typeof value.width === "number" &&
+        typeof value.toolName === "string" && typeof value.toolCallId === "string" && typeof value.executionStarted === "boolean" &&
+        typeof value.argsComplete === "boolean" && typeof value.isPartial === "boolean" && typeof value.expanded === "boolean" &&
+        typeof value.showImages === "boolean" && typeof value.imageWidthCells === "number") {
+        return { type: value.type, componentId: value.componentId, requestId: value.requestId, width: value.width,
+            toolName: value.toolName, toolCallId: value.toolCallId, args: value.args, result: isJsonObject(value.result) ? value.result : undefined,
+            executionStarted: value.executionStarted, argsComplete: value.argsComplete, isPartial: value.isPartial,
+            expanded: value.expanded, showImages: value.showImages, imageWidthCells: value.imageWidthCells };
+    }
+    if (value.type === "engine_message_render" && typeof value.requestId === "number" && typeof value.width === "number" &&
+        isJsonObject(value.message) && typeof value.expanded === "boolean") {
+        return { type: value.type, componentId: value.componentId, requestId: value.requestId, width: value.width, message: value.message, expanded: value.expanded };
+    }
+    return undefined;
+}
+export function serializeInteractiveEngineFrame(message) {
+    const line = JSON.stringify(message);
+    if (Buffer.byteLength(line, "utf8") > INTERACTIVE_ENGINE_MAX_FRAME_BYTES) {
+        throw new Error("Interactive engine frame exceeds 1 MiB");
+    }
+    return `${line}\n`;
+}
+export const serializeInteractiveEngineMessage = serializeInteractiveEngineFrame;
+//# sourceMappingURL=protocol.js.map

package/dist/modes/interactive-engine/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/protocol.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CallbackActivity, CallbackActivityKind } from \"../../core/callback-activity.ts\";\nimport type { HostInputFormField, HostSessionPickerRow } from \"../../core/extensions/ui-types.ts\";\nimport type { KeyId } from \"../../core/keybindings.ts\";\n\nexport const INTERACTIVE_ENGINE_PROTOCOL_VERSION = 1;\nexport const INTERACTIVE_ENGINE_MAX_FRAME_BYTES = 1_048_576;\n\nexport interface JsonObject {\n\t[key: string]: JsonValue;\n}\n\nexport type JsonValue = boolean | JsonObject | JsonValue[] | null | number | string;\n\nexport interface SerializableOverlayOptions {\n\tanchor?: string;\n\tcol?: number | string;\n\tmargin?: number | { top?: number; right?: number; bottom?: number; left?: number };\n\tmaxHeight?: number | string;\n\tmaxWidth?: number | string;\n\tminHeight?: number;\n\tminWidth?: number;\n\toffsetX?: number;\n\toffsetY?: number;\n\trow?: number | string;\n\twidth?: number | string;\n}\n\n/**\n * Allowlisted terminal-mode controls a remote custom component may ask the host\n * to apply to the real host TTY. Deliberately NOT a raw byte channel: the child\n * names an intent and the host owns the concrete escape sequence, so a buggy or\n * compromised child can only toggle these two documented modes.\n */\nexport type EngineTerminalControl =\n\t| { kind: \"mouse-scroll-tracking\"; enabled: boolean }\n\t| { kind: \"autowrap\"; enabled: boolean };\n\nexport interface EngineExtensionShortcut {\n\tkey: string;\n\tdescription?: string;\n}\n\nexport type SerializableKeybindingsConfig = Record<string, KeyId | KeyId[]>;\n\nexport interface EngineKeybindingState {\n\tuserBindings: SerializableKeybindingsConfig;\n\teffectiveBindings: SerializableKeybindingsConfig;\n\tshortcuts: EngineExtensionShortcut[];\n}\n\nexport type InteractiveEngineMessage =\n\t| { type: \"engine_ready\"; protocolVersion: typeof INTERACTIVE_ENGINE_PROTOCOL_VERSION; pid: number }\n\t| { type: \"engine_bound\" }\n\t| { type: \"engine_keybindings_reloaded\"; state: EngineKeybindingState }\n\t| { type: \"engine_heartbeat\"; at: number }\n\t| { type: \"engine_activity_started\"; activity: CallbackActivity }\n\t| { type: \"engine_activity_finished\"; activityId: string }\n\t| { type: \"engine_custom_open\"; componentId: string; overlay: boolean; deferInlineCustomUiFocus?: boolean; overlayOptions?: SerializableOverlayOptions; widgetKey?: string; widgetPlacement?: \"aboveEditor\" | \"belowEditor\" }\n\t| { type: \"engine_custom_close\"; componentId: string }\n\t| { type: \"engine_custom_frame\"; componentId: string; requestId: number; lines: string[] }\n\t| { type: \"engine_custom_invalidate\"; componentId: string }\n\t| { type: \"engine_custom_done\"; componentId: string; result?: JsonValue }\n\t| { type: \"engine_custom_terminal\"; componentId: string; control: EngineTerminalControl }\n\t| { type: \"engine_custom_control\"; componentId: string; action: \"focus\" | \"hide\" | \"show\" | \"unfocus\" }\n\t| { type: \"engine_session_picker_open\"; componentId: string; sessions: HostSessionPickerRow[]; showRenameHint?: boolean }\n\t| { type: \"engine_session_picker_update\"; componentId: string; sessions: HostSessionPickerRow[] }\n\t| { type: \"engine_session_picker_error\"; componentId: string; message: string }\n\t| { type: \"engine_session_picker_close\"; componentId: string }\n\t| { type: \"engine_input_form_open\"; componentId: string; title: string; fields: HostInputFormField[] };\nexport type InteractiveEngineCommand =\n\t| { type: \"engine_custom_render\"; componentId: string; requestId: number; width: number; rows: number }\n\t| { type: \"engine_custom_input\"; componentId: string; data: string }\n\t| { type: \"engine_custom_dispose\"; componentId: string }\n\t| { type: \"engine_tool_render\"; componentId: string; requestId: number; width: number; toolName: string; toolCallId: string; args: JsonValue; result?: JsonObject; executionStarted: boolean; argsComplete: boolean; isPartial: boolean; expanded: boolean; showImages: boolean; imageWidthCells: number }\n\t| { type: \"engine_message_render\"; componentId: string; requestId: number; width: number; message: JsonObject; expanded: boolean }\n\t| { type: \"engine_render_dispose\"; componentId: string }\n\t| { type: \"engine_session_picker_select\"; componentId: string; path: string }\n\t| { type: \"engine_session_picker_cancel\"; componentId: string }\n\t| { type: \"engine_session_picker_delete\"; componentId: string; path: string }\n\t| { type: \"engine_input_form_submit\"; componentId: string; values: Record<string, string> }\n\t| { type: \"engine_input_form_cancel\"; componentId: string };\n\nconst ACTIVITY_KINDS: readonly CallbackActivityKind[] = [\n\t\"extension.hook\", \"renderer\", \"tool.execute\", \"tool.prepare\", \"workflow.ctx_tool\",\n\t\"workflow.run\", \"workflow.stage_adapter\",\n];\n\nexport function isJsonValue(value: object | boolean | null | number | string): value is JsonValue {\n\tif (value === null || typeof value !== \"object\") return true;\n\tif (Array.isArray(value)) return value.every((item) => isJsonValue(item));\n\treturn Object.values(value).every((item) => item !== undefined && isJsonValue(item));\n}\n\nfunction isJsonObject(value: JsonValue): value is JsonObject {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isActivityKind(value: JsonValue): value is CallbackActivityKind {\n\treturn typeof value === \"string\" && ACTIVITY_KINDS.includes(value as CallbackActivityKind);\n}\n\nfunction isCallbackActivity(value: JsonValue): value is JsonObject & CallbackActivity {\n\treturn isJsonObject(value) && typeof value.id === \"string\" && isActivityKind(value.kind) &&\n\t\ttypeof value.name === \"string\" && typeof value.startedAt === \"number\";\n}\n\nfunction parseEngineTerminalControl(value: JsonValue | undefined): EngineTerminalControl | undefined {\n\tif (value === undefined || !isJsonObject(value) || typeof value.enabled !== \"boolean\") return undefined;\n\tif (value.kind === \"mouse-scroll-tracking\" || value.kind === \"autowrap\") {\n\t\treturn { kind: value.kind, enabled: value.enabled };\n\t}\n\treturn undefined;\n}\n\nconst SESSION_PICKER_MESSAGE_COLORS = [\"success\", \"warning\", \"accent\", \"error\"] as const;\n\nfunction parseSessionPickerRow(value: JsonValue): HostSessionPickerRow | undefined {\n\tif (!isJsonObject(value)) return undefined;\n\tconst { path, id, cwd, createdAt, modifiedAt, messageCount, firstMessage, allMessagesText, name, messageColor } = value;\n\tif (typeof path !== \"string\" || typeof id !== \"string\" || typeof cwd !== \"string\" ||\n\t\ttypeof createdAt !== \"number\" || typeof modifiedAt !== \"number\" ||\n\t\ttypeof messageCount !== \"number\" || typeof firstMessage !== \"string\") return undefined;\n\tif (allMessagesText !== undefined && typeof allMessagesText !== \"string\") return undefined;\n\tif (name !== undefined && typeof name !== \"string\") return undefined;\n\tif (messageColor !== undefined && !SESSION_PICKER_MESSAGE_COLORS.includes(messageColor as typeof SESSION_PICKER_MESSAGE_COLORS[number])) return undefined;\n\treturn {\n\t\tpath, id, cwd, createdAt, modifiedAt, messageCount, firstMessage,\n\t\t...(allMessagesText !== undefined ? { allMessagesText } : {}),\n\t\t...(name !== undefined ? { name } : {}),\n\t\t...(messageColor !== undefined ? { messageColor: messageColor as typeof SESSION_PICKER_MESSAGE_COLORS[number] } : {}),\n\t};\n}\n\nfunction parseSessionPickerRows(value: JsonValue | undefined): HostSessionPickerRow[] | undefined {\n\tif (!Array.isArray(value)) return undefined;\n\tconst rows: HostSessionPickerRow[] = [];\n\tfor (const entry of value) {\n\t\tconst row = parseSessionPickerRow(entry);\n\t\tif (!row) return undefined;\n\t\trows.push(row);\n\t}\n\treturn rows;\n}\n\nconst INPUT_FORM_FIELD_TYPES = [\"string\", \"text\", \"number\", \"integer\", \"boolean\", \"select\"] as const;\n\nfunction parseInputFormFields(value: JsonValue | undefined): HostInputFormField[] | undefined {\n\tif (!Array.isArray(value)) return undefined;\n\tconst fields: HostInputFormField[] = [];\n\tfor (const entry of value) {\n\t\tif (!isJsonObject(entry)) return undefined;\n\t\tconst { name, type, description, required, choices, placeholder, initialValue } = entry;\n\t\tif (typeof name !== \"string\" || !INPUT_FORM_FIELD_TYPES.includes(type as HostInputFormField[\"type\"]) || typeof initialValue !== \"string\") return undefined;\n\t\tif (description !== undefined && typeof description !== \"string\") return undefined;\n\t\tif (required !== undefined && typeof required !== \"boolean\") return undefined;\n\t\tif (choices !== undefined && (!Array.isArray(choices) || !choices.every((choice) => typeof choice === \"string\"))) return undefined;\n\t\tif (placeholder !== undefined && typeof placeholder !== \"string\") return undefined;\n\t\tfields.push({ name, type: type as HostInputFormField[\"type\"], initialValue,\n\t\t\t...(typeof description === \"string\" ? { description } : {}),\n\t\t\t...(typeof required === \"boolean\" ? { required } : {}),\n\t\t\t...(Array.isArray(choices) ? { choices: choices as string[] } : {}),\n\t\t\t...(typeof placeholder === \"string\" ? { placeholder } : {}) });\n\t}\n\treturn fields;\n}\n\nfunction parseStringRecord(value: JsonValue | undefined): Record<string, string> | undefined {\n\tif (value === undefined || !isJsonObject(value)) return undefined;\n\tconst entries = Object.entries(value);\n\tif (entries.some(([, entry]) => typeof entry !== \"string\")) return undefined;\n\treturn Object.fromEntries(entries) as Record<string, string>;\n}\n\nfunction parseKeybindingsConfig(value: JsonValue | undefined): SerializableKeybindingsConfig | undefined {\n\tif (value === undefined || !isJsonObject(value)) return undefined;\n\tconst config: SerializableKeybindingsConfig = {};\n\tfor (const [key, binding] of Object.entries(value)) {\n\t\tif (typeof binding === \"string\") config[key] = binding as SerializableKeybindingsConfig[string];\n\t\telse if (Array.isArray(binding) && binding.every((entry) => typeof entry === \"string\")) {\n\t\t\tconfig[key] = binding as SerializableKeybindingsConfig[string];\n\t\t} else return undefined;\n\t}\n\treturn config;\n}\n\nfunction parseKeybindingState(value: JsonValue | undefined): EngineKeybindingState | undefined {\n\tif (value === undefined || !isJsonObject(value) || !Array.isArray(value.shortcuts)) return undefined;\n\tconst userBindings = parseKeybindingsConfig(value.userBindings);\n\tconst effectiveBindings = parseKeybindingsConfig(value.effectiveBindings);\n\tif (!userBindings || !effectiveBindings) return undefined;\n\tconst shortcuts: EngineExtensionShortcut[] = [];\n\tfor (const shortcut of value.shortcuts) {\n\t\tif (!isJsonObject(shortcut) || typeof shortcut.key !== \"string\" ||\n\t\t\t(shortcut.description !== undefined && typeof shortcut.description !== \"string\")) return undefined;\n\t\tshortcuts.push({ key: shortcut.key, ...(typeof shortcut.description === \"string\" ? { description: shortcut.description } : {}) });\n\t}\n\treturn { userBindings, effectiveBindings, shortcuts };\n}\n\nfunction parseJsonObject(line: string): JsonObject | undefined {\n\tif (Buffer.byteLength(line, \"utf8\") > INTERACTIVE_ENGINE_MAX_FRAME_BYTES) return undefined;\n\tlet value: JsonValue;\n\ttry {\n\t\tvalue = JSON.parse(line) as JsonValue;\n\t} catch {\n\t\treturn undefined;\n\t}\n\treturn isJsonObject(value) ? value : undefined;\n}\n\nexport function parseInteractiveEngineMessage(line: string): InteractiveEngineMessage | undefined {\n\tconst value = parseJsonObject(line);\n\tif (!value || typeof value.type !== \"string\") return undefined;\n\tswitch (value.type) {\n\t\tcase \"engine_ready\":\n\t\t\treturn value.protocolVersion === INTERACTIVE_ENGINE_PROTOCOL_VERSION && typeof value.pid === \"number\"\n\t\t\t\t? { type: value.type, protocolVersion: INTERACTIVE_ENGINE_PROTOCOL_VERSION, pid: value.pid } : undefined;\n\t\tcase \"engine_bound\": return { type: value.type };\n\t\tcase \"engine_keybindings_reloaded\": {\n\t\t\tconst state = parseKeybindingState(value.state);\n\t\t\treturn state ? { type: value.type, state } : undefined;\n\t\t}\n\t\tcase \"engine_heartbeat\": return typeof value.at === \"number\" ? { type: value.type, at: value.at } : undefined;\n\t\tcase \"engine_activity_started\": return isCallbackActivity(value.activity) ? { type: value.type, activity: value.activity } : undefined;\n\t\tcase \"engine_activity_finished\": return typeof value.activityId === \"string\" ? { type: value.type, activityId: value.activityId } : undefined;\n\t\tcase \"engine_custom_open\":\n\t\t\treturn typeof value.componentId === \"string\" && typeof value.overlay === \"boolean\"\n\t\t\t\t? { type: value.type, componentId: value.componentId, overlay: value.overlay,\n\t\t\t\t\tdeferInlineCustomUiFocus: value.deferInlineCustomUiFocus === true,\n\t\t\t\t\toverlayOptions: isJsonObject(value.overlayOptions) ? value.overlayOptions as SerializableOverlayOptions : undefined,\n\t\t\t\t\twidgetKey: typeof value.widgetKey === \"string\" ? value.widgetKey : undefined,\n\t\t\t\t\twidgetPlacement: value.widgetPlacement === \"belowEditor\" ? \"belowEditor\" : value.widgetPlacement === \"aboveEditor\" ? \"aboveEditor\" : undefined }\n\t\t\t\t: undefined;\n\t\tcase \"engine_custom_close\": return typeof value.componentId === \"string\" ? { type: value.type, componentId: value.componentId } : undefined;\n\t\tcase \"engine_custom_frame\":\n\t\t\treturn typeof value.componentId === \"string\" && typeof value.requestId === \"number\" &&\n\t\t\t\tArray.isArray(value.lines) && value.lines.every((entry) => typeof entry === \"string\")\n\t\t\t\t? { type: value.type, componentId: value.componentId, requestId: value.requestId, lines: value.lines } : undefined;\n\t\tcase \"engine_custom_invalidate\": return typeof value.componentId === \"string\" ? { type: value.type, componentId: value.componentId } : undefined;\n\t\tcase \"engine_custom_done\": return typeof value.componentId === \"string\" ? { type: value.type, componentId: value.componentId, result: value.result } : undefined;\n\t\tcase \"engine_custom_terminal\": {\n\t\t\tconst control = parseEngineTerminalControl(value.control);\n\t\t\treturn typeof value.componentId === \"string\" && control\n\t\t\t\t? { type: value.type, componentId: value.componentId, control } : undefined;\n\t\t}\n\t\tcase \"engine_custom_control\":\n\t\t\treturn typeof value.componentId === \"string\" && [\"focus\", \"hide\", \"show\", \"unfocus\"].includes(String(value.action))\n\t\t\t\t? { type: value.type, componentId: value.componentId, action: value.action as \"focus\" | \"hide\" | \"show\" | \"unfocus\" } : undefined;\n\t\tcase \"engine_session_picker_open\": {\n\t\t\tconst sessions = parseSessionPickerRows(value.sessions);\n\t\t\treturn typeof value.componentId === \"string\" && sessions &&\n\t\t\t\t(value.showRenameHint === undefined || typeof value.showRenameHint === \"boolean\")\n\t\t\t\t? { type: value.type, componentId: value.componentId, sessions,\n\t\t\t\t\t...(typeof value.showRenameHint === \"boolean\" ? { showRenameHint: value.showRenameHint } : {}) }\n\t\t\t\t: undefined;\n\t\t}\n\t\tcase \"engine_session_picker_update\": {\n\t\t\tconst sessions = parseSessionPickerRows(value.sessions);\n\t\t\treturn typeof value.componentId === \"string\" && sessions\n\t\t\t\t? { type: value.type, componentId: value.componentId, sessions } : undefined;\n\t\t}\n\t\tcase \"engine_session_picker_error\":\n\t\t\treturn typeof value.componentId === \"string\" && typeof value.message === \"string\"\n\t\t\t\t? { type: value.type, componentId: value.componentId, message: value.message } : undefined;\n\t\tcase \"engine_session_picker_close\":\n\t\t\treturn typeof value.componentId === \"string\" ? { type: value.type, componentId: value.componentId } : undefined;\n\t\tcase \"engine_input_form_open\": {\n\t\t\tconst fields = parseInputFormFields(value.fields);\n\t\t\treturn typeof value.componentId === \"string\" && typeof value.title === \"string\" && fields\n\t\t\t\t? { type: value.type, componentId: value.componentId, title: value.title, fields } : undefined;\n\t\t}\n\t\tdefault: return undefined;\n\t}\n}\n\nexport function parseInteractiveEngineCommand(line: string): InteractiveEngineCommand | undefined {\n\tconst value = parseJsonObject(line);\n\tif (!value || typeof value.type !== \"string\" || typeof value.componentId !== \"string\") return undefined;\n\tif (value.type === \"engine_custom_render\" && typeof value.requestId === \"number\" && typeof value.width === \"number\" && typeof value.rows === \"number\") {\n\t\treturn { type: value.type, componentId: value.componentId, requestId: value.requestId, width: value.width, rows: value.rows };\n\t}\n\tif (value.type === \"engine_custom_input\" && typeof value.data === \"string\") return { type: value.type, componentId: value.componentId, data: value.data };\n\tif (value.type === \"engine_custom_dispose\" || value.type === \"engine_render_dispose\") return { type: value.type, componentId: value.componentId };\n\tif ((value.type === \"engine_session_picker_select\" || value.type === \"engine_session_picker_delete\") && typeof value.path === \"string\") {\n\t\treturn { type: value.type, componentId: value.componentId, path: value.path };\n\t}\n\tif (value.type === \"engine_session_picker_cancel\") return { type: value.type, componentId: value.componentId };\n\tif (value.type === \"engine_input_form_cancel\") return { type: value.type, componentId: value.componentId };\n\tif (value.type === \"engine_input_form_submit\") {\n\t\tconst values = parseStringRecord(value.values);\n\t\treturn values ? { type: value.type, componentId: value.componentId, values } : undefined;\n\t}\n\tif (value.type === \"engine_tool_render\" && typeof value.requestId === \"number\" && typeof value.width === \"number\" &&\n\t\ttypeof value.toolName === \"string\" && typeof value.toolCallId === \"string\" && typeof value.executionStarted === \"boolean\" &&\n\t\ttypeof value.argsComplete === \"boolean\" && typeof value.isPartial === \"boolean\" && typeof value.expanded === \"boolean\" &&\n\t\ttypeof value.showImages === \"boolean\" && typeof value.imageWidthCells === \"number\") {\n\t\treturn { type: value.type, componentId: value.componentId, requestId: value.requestId, width: value.width,\n\t\t\ttoolName: value.toolName, toolCallId: value.toolCallId, args: value.args, result: isJsonObject(value.result) ? value.result : undefined,\n\t\t\texecutionStarted: value.executionStarted, argsComplete: value.argsComplete, isPartial: value.isPartial,\n\t\t\texpanded: value.expanded, showImages: value.showImages, imageWidthCells: value.imageWidthCells };\n\t}\n\tif (value.type === \"engine_message_render\" && typeof value.requestId === \"number\" && typeof value.width === \"number\" &&\n\t\tisJsonObject(value.message) && typeof value.expanded === \"boolean\") {\n\t\treturn { type: value.type, componentId: value.componentId, requestId: value.requestId, width: value.width, message: value.message, expanded: value.expanded };\n\t}\n\treturn undefined;\n}\n\nexport function serializeInteractiveEngineFrame(message: InteractiveEngineMessage | InteractiveEngineCommand): string {\n\tconst line = JSON.stringify(message);\n\tif (Buffer.byteLength(line, \"utf8\") > INTERACTIVE_ENGINE_MAX_FRAME_BYTES) {\n\t\tthrow new Error(\"Interactive engine frame exceeds 1 MiB\");\n\t}\n\treturn `${line}\\n`;\n}\n\nexport const serializeInteractiveEngineMessage = serializeInteractiveEngineFrame;\n"]}

package/dist/modes/interactive-engine/remote-command-catalog.d.ts

@@ -0,0 +1,33 @@
+import type { RpcClient } from "../rpc/rpc-client.ts";
+import type { RpcSlashCommand } from "../rpc/rpc-types.ts";
+export type RemoteCommandsListener = (commands: readonly RpcSlashCommand[]) => void;
+/**
+ * Tracks the engine child's slash-command catalog (extension commands, prompt
+ * templates, and skills) for the isolated interactive host.
+ *
+ * When {@link isolateInteractiveHost} is on, `main.ts` loads no extensions in
+ * the host session, so `session.extensionRunner.getRegisteredCommands()` is
+ * empty and interactive autocomplete would omit every extension command
+ * (`/workflow`, `/workflows`, `/run`, `/mcp`, …). The commands still live in the
+ * engine child, which answers the `get_commands` RPC. This catalog fetches that
+ * list asynchronously so it never blocks first paint or input, caches the last
+ * good result, and notifies listeners so autocomplete can rebuild.
+ *
+ * A generation guard ensures a slow in-flight fetch cannot clobber the catalog
+ * after a newer refresh (e.g. an engine restart) has already superseded it.
+ */
+export declare class RemoteCommandCatalog {
+    private commands;
+    private readonly listeners;
+    private generation;
+    private readonly client;
+    constructor(client: RpcClient);
+    getCommands(): readonly RpcSlashCommand[];
+    onChange(listener: RemoteCommandsListener): () => void;
+    /**
+     * Kick off a best-effort catalog fetch. Fire-and-forget by design: the caller
+     * (engine bind, restart, reload, new/resume/fork) must not await it.
+     */
+    refresh(): void;
+}
+//# sourceMappingURL=remote-command-catalog.d.ts.map

package/dist/modes/interactive-engine/remote-command-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-command-catalog.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/remote-command-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,KAAK,IAAI,CAAC;AAEpF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IAEnC,YAAY,MAAM,EAAE,SAAS,EAE5B;IAED,WAAW,IAAI,SAAS,eAAe,EAAE,CAExC;IAED,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAGrD;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI,CAad;CACD"}

package/dist/modes/interactive-engine/remote-command-catalog.js

@@ -0,0 +1,51 @@
+/**
+ * Tracks the engine child's slash-command catalog (extension commands, prompt
+ * templates, and skills) for the isolated interactive host.
+ *
+ * When {@link isolateInteractiveHost} is on, `main.ts` loads no extensions in
+ * the host session, so `session.extensionRunner.getRegisteredCommands()` is
+ * empty and interactive autocomplete would omit every extension command
+ * (`/workflow`, `/workflows`, `/run`, `/mcp`, …). The commands still live in the
+ * engine child, which answers the `get_commands` RPC. This catalog fetches that
+ * list asynchronously so it never blocks first paint or input, caches the last
+ * good result, and notifies listeners so autocomplete can rebuild.
+ *
+ * A generation guard ensures a slow in-flight fetch cannot clobber the catalog
+ * after a newer refresh (e.g. an engine restart) has already superseded it.
+ */
+export class RemoteCommandCatalog {
+    constructor(client) {
+        this.commands = [];
+        this.listeners = new Set();
+        this.generation = 0;
+        this.client = client;
+    }
+    getCommands() {
+        return this.commands;
+    }
+    onChange(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Kick off a best-effort catalog fetch. Fire-and-forget by design: the caller
+     * (engine bind, restart, reload, new/resume/fork) must not await it.
+     */
+    refresh() {
+        const generation = ++this.generation;
+        void this.client
+            .getCommands()
+            .then((commands) => {
+            if (generation !== this.generation)
+                return;
+            this.commands = commands;
+            for (const listener of this.listeners)
+                listener(commands);
+        })
+            .catch(() => {
+            // Best-effort: keep the last good catalog when the child is momentarily
+            // unavailable (e.g. mid-restart). A later refresh will reconcile it.
+        });
+    }
+}
+//# sourceMappingURL=remote-command-catalog.js.map

package/dist/modes/interactive-engine/remote-command-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-command-catalog.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/remote-command-catalog.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,oBAAoB;IAOhC,YAAY,MAAiB;QANrB,aAAQ,GAA+B,EAAE,CAAC;QACjC,cAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;QACvD,eAAU,GAAG,CAAC,CAAC;QAKtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,WAAW;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,QAAQ,CAAC,QAAgC;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,OAAO;QACN,MAAM,UAAU,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC;QACrC,KAAK,IAAI,CAAC,MAAM;aACd,WAAW,EAAE;aACb,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YAClB,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU;gBAAE,OAAO;YAC3C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACzB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;gBAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3D,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACX,wEAAwE;YACxE,qEAAqE;QACtE,CAAC,CAAC,CAAC;IACL,CAAC;CACD","sourcesContent":["import type { RpcClient } from \"../rpc/rpc-client.ts\";\nimport type { RpcSlashCommand } from \"../rpc/rpc-types.ts\";\n\nexport type RemoteCommandsListener = (commands: readonly RpcSlashCommand[]) => void;\n\n/**\n * Tracks the engine child's slash-command catalog (extension commands, prompt\n * templates, and skills) for the isolated interactive host.\n *\n * When {@link isolateInteractiveHost} is on, `main.ts` loads no extensions in\n * the host session, so `session.extensionRunner.getRegisteredCommands()` is\n * empty and interactive autocomplete would omit every extension command\n * (`/workflow`, `/workflows`, `/run`, `/mcp`, …). The commands still live in the\n * engine child, which answers the `get_commands` RPC. This catalog fetches that\n * list asynchronously so it never blocks first paint or input, caches the last\n * good result, and notifies listeners so autocomplete can rebuild.\n *\n * A generation guard ensures a slow in-flight fetch cannot clobber the catalog\n * after a newer refresh (e.g. an engine restart) has already superseded it.\n */\nexport class RemoteCommandCatalog {\n\tprivate commands: readonly RpcSlashCommand[] = [];\n\tprivate readonly listeners = new Set<RemoteCommandsListener>();\n\tprivate generation = 0;\n\n\tprivate readonly client: RpcClient;\n\n\tconstructor(client: RpcClient) {\n\t\tthis.client = client;\n\t}\n\n\tgetCommands(): readonly RpcSlashCommand[] {\n\t\treturn this.commands;\n\t}\n\n\tonChange(listener: RemoteCommandsListener): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => this.listeners.delete(listener);\n\t}\n\n\t/**\n\t * Kick off a best-effort catalog fetch. Fire-and-forget by design: the caller\n\t * (engine bind, restart, reload, new/resume/fork) must not await it.\n\t */\n\trefresh(): void {\n\t\tconst generation = ++this.generation;\n\t\tvoid this.client\n\t\t\t.getCommands()\n\t\t\t.then((commands) => {\n\t\t\t\tif (generation !== this.generation) return;\n\t\t\t\tthis.commands = commands;\n\t\t\t\tfor (const listener of this.listeners) listener(commands);\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\t// Best-effort: keep the last good catalog when the child is momentarily\n\t\t\t\t// unavailable (e.g. mid-restart). A later refresh will reconcile it.\n\t\t\t});\n\t}\n}\n"]}

package/dist/modes/interactive-engine/remote-component.d.ts

@@ -0,0 +1,16 @@
+import type { ExtensionUIContext } from "../../core/extensions/index.ts";
+import type { IsolatedInteractiveRuntime } from "./isolated-runtime.ts";
+export declare class RemoteComponentController {
+    private readonly mounted;
+    private readonly unsubscribe;
+    private readonly terminalModes;
+    private readonly runtime;
+    private readonly ui;
+    constructor(runtime: IsolatedInteractiveRuntime, ui: ExtensionUIContext);
+    dispose(): void;
+    private handleMessage;
+    private open;
+    private close;
+    private control;
+}
+//# sourceMappingURL=remote-component.d.ts.map

package/dist/modes/interactive-engine/remote-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-component.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/remote-component.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AA+GxE,qBAAa,yBAAyB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAE9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqB;IAExC,YACC,OAAO,EAAE,0BAA0B,EACnC,EAAE,EAAE,kBAAkB,EAKtB;IAED,OAAO,IAAI,IAAI,CAQd;IAED,OAAO,CAAC,aAAa;IAsCrB,OAAO,CAAC,IAAI;IAgDZ,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,OAAO;CAUf"}