@bastani/atomic 0.9.9 → 0.9.10-alpha.1

package/dist/modes/interactive-engine/create-isolated-runtime.js

@@ -0,0 +1,56 @@
+import { basename } from "node:path";
+import { createAgentSessionRuntime, } from "../../core/agent-session-runtime.js";
+import { RpcClient } from "../rpc/rpc-client.js";
+import { buildInteractiveEngineArgs } from "./engine-args.js";
+import { IsolatedInteractiveRuntime } from "./isolated-runtime.js";
+export async function createIsolatedInteractiveRuntime(options) {
+    const executableName = basename(process.execPath).toLowerCase();
+    const launchedByRuntime = ["bun", "bun.exe", "node", "node.exe"].includes(executableName);
+    const cliPath = launchedByRuntime ? process.argv[1] : "";
+    if (launchedByRuntime && !cliPath)
+        throw new Error("Cannot start isolated interactive engine: Atomic entrypoint is unavailable");
+    let isolatedRuntime;
+    const pendingDiagnostics = [];
+    let callbackActive = false;
+    const client = new RpcClient({
+        cliPath,
+        cwd: options.sessionManager.getCwd(),
+        runtimeExecutable: process.execPath,
+        args: buildInteractiveEngineArgs(options.parsed, options.sessionManager, options.resources),
+        env: {
+            ATOMIC_CODING_AGENT_DIR: options.localRuntime.services.agentDir,
+            ...(options.parsed.apiKey ? { ATOMIC_INTERACTIVE_ENGINE_API_KEY: options.parsed.apiKey } : {}),
+        },
+        interactiveEngine: {
+            onDiagnostic: (diagnostic) => isolatedRuntime
+                ? isolatedRuntime.emitDiagnostic(diagnostic)
+                : pendingDiagnostics.push(diagnostic),
+            onActivityChange: (active) => {
+                callbackActive = active;
+                isolatedRuntime?.setEngineCallbackActive(active);
+            },
+        },
+    });
+    try {
+        await client.start();
+    }
+    catch (error) {
+        await client.stop();
+        throw error;
+    }
+    isolatedRuntime = new IsolatedInteractiveRuntime(options.localRuntime, options.createRuntime, client);
+    isolatedRuntime.setEngineCallbackActive(callbackActive);
+    for (const diagnostic of pendingDiagnostics)
+        isolatedRuntime.emitDiagnostic(diagnostic);
+    return isolatedRuntime;
+}
+export async function createRuntimeForMode(createRuntime, cwd, agentDir, sessionManager, isolateInteractiveHost, hasInlineExtensionFactories, parsed, resources) {
+    if (isolateInteractiveHost && hasInlineExtensionFactories) {
+        throw new Error("Interactive engine isolation cannot serialize inline extension factories; load the extension from a module path instead.");
+    }
+    const localRuntime = await createAgentSessionRuntime(createRuntime, { cwd, agentDir, sessionManager });
+    if (!isolateInteractiveHost)
+        return localRuntime;
+    return createIsolatedInteractiveRuntime({ localRuntime, createRuntime, parsed, sessionManager, resources });
+}
+//# sourceMappingURL=create-isolated-runtime.js.map

package/dist/modes/interactive-engine/create-isolated-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-isolated-runtime.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/create-isolated-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { basename } from \"node:path\";\nimport type { Args } from \"../../cli/args.ts\";\nimport {\n\tcreateAgentSessionRuntime,\n\ttype AgentSessionRuntime,\n\ttype CreateAgentSessionRuntimeFactory,\n} from \"../../core/agent-session-runtime.ts\";\nimport type { SessionManager } from \"../../core/session-manager.ts\";\nimport { RpcClient } from \"../rpc/rpc-client.ts\";\nimport { buildInteractiveEngineArgs, type InteractiveEngineResourcePaths } from \"./engine-args.ts\";\nimport type { ActivityWatchdogDiagnostic } from \"./activity-watchdog.ts\";\nimport { IsolatedInteractiveRuntime } from \"./isolated-runtime.ts\";\n\nexport async function createIsolatedInteractiveRuntime(options: {\n\tlocalRuntime: AgentSessionRuntime;\n\tcreateRuntime: CreateAgentSessionRuntimeFactory;\n\tparsed: Args;\n\tsessionManager: SessionManager;\n\tresources: InteractiveEngineResourcePaths;\n}): Promise<IsolatedInteractiveRuntime> {\n\tconst executableName = basename(process.execPath).toLowerCase();\n\tconst launchedByRuntime = [\"bun\", \"bun.exe\", \"node\", \"node.exe\"].includes(executableName);\n\tconst cliPath = launchedByRuntime ? process.argv[1] : \"\";\n\tif (launchedByRuntime && !cliPath) throw new Error(\"Cannot start isolated interactive engine: Atomic entrypoint is unavailable\");\n\tlet isolatedRuntime: IsolatedInteractiveRuntime | undefined;\n\tconst pendingDiagnostics: ActivityWatchdogDiagnostic[] = [];\n\tlet callbackActive = false;\n\tconst client = new RpcClient({\n\t\tcliPath,\n\t\tcwd: options.sessionManager.getCwd(),\n\t\truntimeExecutable: process.execPath,\n\t\targs: buildInteractiveEngineArgs(options.parsed, options.sessionManager, options.resources),\n\t\tenv: {\n\t\t\tATOMIC_CODING_AGENT_DIR: options.localRuntime.services.agentDir,\n\t\t\t...(options.parsed.apiKey ? { ATOMIC_INTERACTIVE_ENGINE_API_KEY: options.parsed.apiKey } : {}),\n\t\t},\n\t\tinteractiveEngine: {\n\t\t\tonDiagnostic: (diagnostic) => isolatedRuntime\n\t\t\t\t? isolatedRuntime.emitDiagnostic(diagnostic)\n\t\t\t\t: pendingDiagnostics.push(diagnostic),\n\t\t\tonActivityChange: (active) => {\n\t\t\t\tcallbackActive = active;\n\t\t\t\tisolatedRuntime?.setEngineCallbackActive(active);\n\t\t\t},\n\t\t},\n\t});\n\ttry {\n\t\tawait client.start();\n\t} catch (error) {\n\t\tawait client.stop();\n\t\tthrow error;\n\t}\n\tisolatedRuntime = new IsolatedInteractiveRuntime(options.localRuntime, options.createRuntime, client);\n\tisolatedRuntime.setEngineCallbackActive(callbackActive);\n\tfor (const diagnostic of pendingDiagnostics) isolatedRuntime.emitDiagnostic(diagnostic);\n\treturn isolatedRuntime;\n}\n\nexport async function createRuntimeForMode(\n\tcreateRuntime: CreateAgentSessionRuntimeFactory,\n\tcwd: string,\n\tagentDir: string,\n\tsessionManager: SessionManager,\n\tisolateInteractiveHost: boolean,\n\thasInlineExtensionFactories: boolean,\n\tparsed: Args,\n\tresources: InteractiveEngineResourcePaths,\n): Promise<AgentSessionRuntime> {\n\tif (isolateInteractiveHost && hasInlineExtensionFactories) {\n\t\tthrow new Error(\"Interactive engine isolation cannot serialize inline extension factories; load the extension from a module path instead.\");\n\t}\n\tconst localRuntime = await createAgentSessionRuntime(createRuntime, { cwd, agentDir, sessionManager });\n\tif (!isolateInteractiveHost) return localRuntime;\n\treturn createIsolatedInteractiveRuntime({ localRuntime, createRuntime, parsed, sessionManager, resources });\n}\n"]}

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

@@ -0,0 +1,10 @@
+import type { Args } from "../../cli/args.ts";
+import type { SessionManager } from "../../core/session-manager.ts";
+export interface InteractiveEngineResourcePaths {
+    extensions?: readonly string[];
+    promptTemplates?: readonly string[];
+    skills?: readonly string[];
+    themes?: readonly string[];
+}
+export declare function buildInteractiveEngineArgs(parsed: Args, sessionManager: SessionManager, resources: InteractiveEngineResourcePaths): string[];
+//# sourceMappingURL=engine-args.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-args.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,WAAW,8BAA8B;IAC9C,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAYD,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,IAAI,EACZ,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,8BAA8B,GACvC,MAAM,EAAE,CAoCV"}

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

@@ -0,0 +1,55 @@
+function appendValue(args, flag, value) {
+    if (value === undefined || value === false)
+        return;
+    args.push(flag);
+    if (value !== true)
+        args.push(String(value));
+}
+function appendValues(args, flag, values) {
+    for (const value of values ?? [])
+        args.push(flag, value);
+}
+export function buildInteractiveEngineArgs(parsed, sessionManager, resources) {
+    const args = [];
+    const sessionFile = sessionManager.getSessionFile();
+    if (parsed.noSession || !sessionFile)
+        args.push("--no-session");
+    else
+        args.push("--session", sessionFile);
+    appendValue(args, "--session-dir", parsed.sessionDir);
+    appendValue(args, "--provider", parsed.provider);
+    appendValue(args, "--model", parsed.model);
+    appendValue(args, "--thinking", parsed.thinking);
+    appendValue(args, "--context-window", parsed.contextWindow);
+    appendValue(args, "--system-prompt", parsed.systemPrompt);
+    appendValues(args, "--append-system-prompt", parsed.appendSystemPrompt);
+    if (parsed.models)
+        appendValue(args, "--models", parsed.models.join(","));
+    if (parsed.tools)
+        appendValue(args, "--tools", parsed.tools.join(","));
+    if (parsed.excludeTools)
+        appendValue(args, "--exclude-tools", parsed.excludeTools.join(","));
+    appendValue(args, "--no-tools", parsed.noTools);
+    appendValue(args, "--no-builtin-tools", parsed.noBuiltinTools);
+    appendValues(args, "--extension", resources.extensions);
+    appendValue(args, "--no-extensions", parsed.noExtensions);
+    appendValues(args, "--skill", resources.skills);
+    appendValue(args, "--no-skills", parsed.noSkills);
+    appendValues(args, "--prompt-template", resources.promptTemplates);
+    appendValue(args, "--no-prompt-templates", parsed.noPromptTemplates);
+    appendValues(args, "--theme", resources.themes);
+    appendValue(args, "--no-themes", parsed.noThemes);
+    appendValue(args, "--no-context-files", parsed.noContextFiles);
+    appendValue(args, "--offline", parsed.offline);
+    appendValue(args, "--verbose", parsed.verbose);
+    if (parsed.projectTrustOverride !== undefined) {
+        args.push(parsed.projectTrustOverride ? "--approve" : "--no-approve");
+    }
+    for (const [name, value] of parsed.unknownFlags) {
+        args.push(`--${name}`);
+        if (value !== true)
+            args.push(String(value));
+    }
+    return args;
+}
+//# sourceMappingURL=engine-args.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-args.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-args.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Args } from \"../../cli/args.ts\";\nimport type { SessionManager } from \"../../core/session-manager.ts\";\n\nexport interface InteractiveEngineResourcePaths {\n\textensions?: readonly string[];\n\tpromptTemplates?: readonly string[];\n\tskills?: readonly string[];\n\tthemes?: readonly string[];\n}\n\nfunction appendValue(args: string[], flag: string, value: boolean | number | string | undefined): void {\n\tif (value === undefined || value === false) return;\n\targs.push(flag);\n\tif (value !== true) args.push(String(value));\n}\n\nfunction appendValues(args: string[], flag: string, values: readonly string[] | undefined): void {\n\tfor (const value of values ?? []) args.push(flag, value);\n}\n\nexport function buildInteractiveEngineArgs(\n\tparsed: Args,\n\tsessionManager: SessionManager,\n\tresources: InteractiveEngineResourcePaths,\n): string[] {\n\tconst args: string[] = [];\n\tconst sessionFile = sessionManager.getSessionFile();\n\tif (parsed.noSession || !sessionFile) args.push(\"--no-session\");\n\telse args.push(\"--session\", sessionFile);\n\tappendValue(args, \"--session-dir\", parsed.sessionDir);\n\tappendValue(args, \"--provider\", parsed.provider);\n\tappendValue(args, \"--model\", parsed.model);\n\tappendValue(args, \"--thinking\", parsed.thinking);\n\tappendValue(args, \"--context-window\", parsed.contextWindow);\n\tappendValue(args, \"--system-prompt\", parsed.systemPrompt);\n\tappendValues(args, \"--append-system-prompt\", parsed.appendSystemPrompt);\n\tif (parsed.models) appendValue(args, \"--models\", parsed.models.join(\",\"));\n\tif (parsed.tools) appendValue(args, \"--tools\", parsed.tools.join(\",\"));\n\tif (parsed.excludeTools) appendValue(args, \"--exclude-tools\", parsed.excludeTools.join(\",\"));\n\tappendValue(args, \"--no-tools\", parsed.noTools);\n\tappendValue(args, \"--no-builtin-tools\", parsed.noBuiltinTools);\n\tappendValues(args, \"--extension\", resources.extensions);\n\tappendValue(args, \"--no-extensions\", parsed.noExtensions);\n\tappendValues(args, \"--skill\", resources.skills);\n\tappendValue(args, \"--no-skills\", parsed.noSkills);\n\tappendValues(args, \"--prompt-template\", resources.promptTemplates);\n\tappendValue(args, \"--no-prompt-templates\", parsed.noPromptTemplates);\n\tappendValues(args, \"--theme\", resources.themes);\n\tappendValue(args, \"--no-themes\", parsed.noThemes);\n\tappendValue(args, \"--no-context-files\", parsed.noContextFiles);\n\tappendValue(args, \"--offline\", parsed.offline);\n\tappendValue(args, \"--verbose\", parsed.verbose);\n\tif (parsed.projectTrustOverride !== undefined) {\n\t\targs.push(parsed.projectTrustOverride ? \"--approve\" : \"--no-approve\");\n\t}\n\tfor (const [name, value] of parsed.unknownFlags) {\n\t\targs.push(`--${name}`);\n\t\tif (value !== true) args.push(String(value));\n\t}\n\treturn args;\n}\n"]}

package/dist/modes/interactive-engine/engine-child-liveness.d.ts

@@ -0,0 +1,7 @@
+export interface InteractiveEngineLiveness {
+    ready(): void;
+    bound(): void;
+    stop(): void;
+}
+export declare function startInteractiveEngineLiveness(write: (line: string) => void): InteractiveEngineLiveness;
+//# sourceMappingURL=engine-child-liveness.d.ts.map

package/dist/modes/interactive-engine/engine-child-liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-child-liveness.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-child-liveness.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,yBAAyB;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;CACb;AAID,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,yBAAyB,CAsCvG"}

package/dist/modes/interactive-engine/engine-child-liveness.js

@@ -0,0 +1,50 @@
+import { setCallbackActivityReporter } from "../../core/callback-activity.js";
+import { writeRawStdoutControl } from "../../core/output-guard.js";
+import { startParentProcessGuardian } from "../../utils/shell.js";
+import { INTERACTIVE_ENGINE_PROTOCOL_VERSION, serializeInteractiveEngineMessage, } from "./protocol.js";
+let activeLiveness;
+export function startInteractiveEngineLiveness(write) {
+    if (activeLiveness)
+        return activeLiveness;
+    if (process.env.ATOMIC_INTERACTIVE_ENGINE_CHILD !== "1")
+        return { ready: () => { }, bound: () => { }, stop: () => { } };
+    const hostPid = Number.parseInt(process.env.ATOMIC_INTERACTIVE_ENGINE_HOST_PID ?? "", 10);
+    const stopGuardian = Number.isSafeInteger(hostPid) && hostPid > 0
+        ? startParentProcessGuardian(hostPid, process.env.ATOMIC_INTERACTIVE_ENGINE_GUARD_FILE)
+        : async () => { };
+    const send = (message) => {
+        write(serializeInteractiveEngineMessage(message));
+    };
+    setCallbackActivityReporter({
+        started: (activity) => writeRawStdoutControl(serializeInteractiveEngineMessage({ type: "engine_activity_started", activity })),
+        finished: (activityId) => send({ type: "engine_activity_finished", activityId }),
+    });
+    const heartbeat = setInterval(() => send({ type: "engine_heartbeat", at: performance.now() }), 50);
+    heartbeat.unref?.();
+    let readySent = false;
+    let boundSent = false;
+    const liveness = {
+        ready: () => {
+            if (readySent)
+                return;
+            readySent = true;
+            send({ type: "engine_ready", protocolVersion: INTERACTIVE_ENGINE_PROTOCOL_VERSION, pid: process.pid });
+        },
+        bound: () => {
+            if (boundSent)
+                return;
+            boundSent = true;
+            send({ type: "engine_bound" });
+        },
+        stop: () => {
+            clearInterval(heartbeat);
+            setCallbackActivityReporter(undefined);
+            void stopGuardian();
+            if (activeLiveness === liveness)
+                activeLiveness = undefined;
+        },
+    };
+    activeLiveness = liveness;
+    return liveness;
+}
+//# sourceMappingURL=engine-child-liveness.js.map

package/dist/modes/interactive-engine/engine-child-liveness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-child-liveness.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-child-liveness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACN,mCAAmC,EACnC,iCAAiC,GACjC,MAAM,eAAe,CAAC;AAQvB,IAAI,cAAqD,CAAC;AAE1D,MAAM,UAAU,8BAA8B,CAAC,KAA6B;IAC3E,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,+BAA+B,KAAK,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IACrH,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1F,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAChE,CAAC,CAAC,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC;QACvF,CAAC,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IAClB,MAAM,IAAI,GAAG,CAAC,OAAgE,EAAE,EAAE;QACjF,KAAK,CAAC,iCAAiC,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC;IACF,2BAA2B,CAAC;QAC3B,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,qBAAqB,CAAC,iCAAiC,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9H,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,UAAU,EAAE,CAAC;KAChF,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACnG,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IACpB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,QAAQ,GAA8B;QAC3C,KAAK,EAAE,GAAG,EAAE;YACX,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,mCAAmC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACxG,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACX,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACV,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,2BAA2B,CAAC,SAAS,CAAC,CAAC;YACvC,KAAK,YAAY,EAAE,CAAC;YACpB,IAAI,cAAc,KAAK,QAAQ;gBAAE,cAAc,GAAG,SAAS,CAAC;QAC7D,CAAC;KACD,CAAC;IACF,cAAc,GAAG,QAAQ,CAAC;IAC1B,OAAO,QAAQ,CAAC;AACjB,CAAC","sourcesContent":["import { setCallbackActivityReporter } from \"../../core/callback-activity.ts\";\nimport { writeRawStdoutControl } from \"../../core/output-guard.ts\";\nimport { startParentProcessGuardian } from \"../../utils/shell.ts\";\nimport {\n\tINTERACTIVE_ENGINE_PROTOCOL_VERSION,\n\tserializeInteractiveEngineMessage,\n} from \"./protocol.ts\";\n\nexport interface InteractiveEngineLiveness {\n\tready(): void;\n\tbound(): void;\n\tstop(): void;\n}\n\nlet activeLiveness: InteractiveEngineLiveness | undefined;\n\nexport function startInteractiveEngineLiveness(write: (line: string) => void): InteractiveEngineLiveness {\n\tif (activeLiveness) return activeLiveness;\n\tif (process.env.ATOMIC_INTERACTIVE_ENGINE_CHILD !== \"1\") return { ready: () => {}, bound: () => {}, stop: () => {} };\n\tconst hostPid = Number.parseInt(process.env.ATOMIC_INTERACTIVE_ENGINE_HOST_PID ?? \"\", 10);\n\tconst stopGuardian = Number.isSafeInteger(hostPid) && hostPid > 0\n\t\t? startParentProcessGuardian(hostPid, process.env.ATOMIC_INTERACTIVE_ENGINE_GUARD_FILE)\n\t\t: async () => {};\n\tconst send = (message: Parameters<typeof serializeInteractiveEngineMessage>[0]) => {\n\t\twrite(serializeInteractiveEngineMessage(message));\n\t};\n\tsetCallbackActivityReporter({\n\t\tstarted: (activity) => writeRawStdoutControl(serializeInteractiveEngineMessage({ type: \"engine_activity_started\", activity })),\n\t\tfinished: (activityId) => send({ type: \"engine_activity_finished\", activityId }),\n\t});\n\tconst heartbeat = setInterval(() => send({ type: \"engine_heartbeat\", at: performance.now() }), 50);\n\theartbeat.unref?.();\n\tlet readySent = false;\n\tlet boundSent = false;\n\tconst liveness: InteractiveEngineLiveness = {\n\t\tready: () => {\n\t\t\tif (readySent) return;\n\t\t\treadySent = true;\n\t\t\tsend({ type: \"engine_ready\", protocolVersion: INTERACTIVE_ENGINE_PROTOCOL_VERSION, pid: process.pid });\n\t\t},\n\t\tbound: () => {\n\t\t\tif (boundSent) return;\n\t\t\tboundSent = true;\n\t\t\tsend({ type: \"engine_bound\" });\n\t\t},\n\t\tstop: () => {\n\t\t\tclearInterval(heartbeat);\n\t\t\tsetCallbackActivityReporter(undefined);\n\t\t\tvoid stopGuardian();\n\t\t\tif (activeLiveness === liveness) activeLiveness = undefined;\n\t\t},\n\t};\n\tactiveLiveness = liveness;\n\treturn liveness;\n}\n"]}

package/dist/modes/interactive-engine/engine-custom-ui.d.ts

@@ -0,0 +1,47 @@
+import { type Component, type OverlayHandle, type OverlayOptions } from "@earendil-works/pi-tui";
+import { TUI } from "@earendil-works/pi-tui";
+import type { KeybindingsManager } from "../../core/keybindings.ts";
+import type { Theme } from "../interactive/theme/theme.ts";
+interface CustomUiOptions {
+    overlay?: boolean;
+    deferInlineCustomUiFocus?: boolean;
+    overlayOptions?: OverlayOptions | (() => OverlayOptions);
+    onHandle?: (handle: OverlayHandle) => void;
+    signal?: AbortSignal;
+}
+export declare class EngineCustomUiService {
+    private readonly widgetIds;
+    private readonly active;
+    private nextId;
+    private readonly write;
+    private readonly keybindings;
+    private readonly stateListeners;
+    setWidget(key: string, factory: ((tui: TUI, theme: Theme) => Component & {
+        dispose?(): void;
+    }) | undefined, placement?: "aboveEditor" | "belowEditor"): void;
+    constructor(write: (line: string) => void, keybindings: KeybindingsManager);
+    custom<T>(factory: (tui: TUI, theme: Theme, keybindings: KeybindingsManager, done: (result: T) => void) => (Component & {
+        dispose?(): void;
+    }) | Promise<Component & {
+        dispose?(): void;
+    }>, options?: CustomUiOptions): Promise<T>;
+    getHostCustomUiState(): {
+        blockingInlineCustomUiDepth: number;
+        blockingInlineCustomUiActive: boolean;
+    };
+    onHostCustomUiStateChange(listener: (state: {
+        blockingInlineCustomUiDepth: number;
+        blockingInlineCustomUiActive: boolean;
+    }) => void): () => void;
+    focusHostInlineCustomUi(): boolean;
+    requestRender(): void;
+    handleLine(line: string): boolean;
+    dispose(): void;
+    private disposeComponent;
+    private notifyState;
+    private remoteHandle;
+    private sendDone;
+    private send;
+}
+export {};
+//# sourceMappingURL=engine-custom-ui.d.ts.map

package/dist/modes/interactive-engine/engine-custom-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-custom-ui.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-custom-ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAiB,MAAM,wBAAwB,CAAC;AAC9H,OAAO,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAa3D,UAAU,eAAe;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,cAAc,CAAC,EAAE,cAAc,GAAG,CAAC,MAAM,cAAc,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AA+ED,qBAAa,qBAAqB;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8G;IAG7I,SAAS,CACR,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,KAAK,SAAS,GAAG;QAAE,OAAO,CAAC,IAAI,IAAI,CAAA;KAAE,CAAC,GAAG,SAAS,EACnF,SAAS,CAAC,EAAE,aAAa,GAAG,aAAa,GACvC,IAAI,CA8BN;IACD,YAAY,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAGzE;IAEK,MAAM,CAAC,CAAC,EACb,OAAO,EAAE,CACR,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,kBAAkB,EAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,KACrB,CAAC,SAAS,GAAG;QAAE,OAAO,CAAC,IAAI,IAAI,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG;QAAE,OAAO,CAAC,IAAI,IAAI,CAAA;KAAE,CAAC,EACnF,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,CAAC,CAAC,CAiDZ;IACD,oBAAoB,IAAI;QAAE,2BAA2B,EAAE,MAAM,CAAC;QAAC,4BAA4B,EAAE,OAAO,CAAA;KAAE,CAGrG;IAED,yBAAyB,CACxB,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,2BAA2B,EAAE,MAAM,CAAC;QAAC,4BAA4B,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GACvG,MAAM,IAAI,CAGZ;IAED,uBAAuB,IAAI,OAAO,CAAqE;IAGvG,aAAa,IAAI,IAAI,CAKpB;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuChC;IAED,OAAO,IAAI,IAAI,CAEd;IACD,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,IAAI;CAGZ"}

package/dist/modes/interactive-engine/engine-custom-ui.js

@@ -0,0 +1,276 @@
+import { isKeyRelease } from "@earendil-works/pi-tui";
+import { TUI } from "@earendil-works/pi-tui";
+import { runCallback } from "../../core/callback-activity.js";
+import { theme } from "../interactive/theme/theme.js";
+import { INTERACTIVE_ENGINE_MAX_FRAME_BYTES, isJsonValue, parseInteractiveEngineCommand, serializeInteractiveEngineMessage, } from "./protocol.js";
+class RemoteTerminal {
+    constructor(invalidate, control) {
+        this.columns = 80;
+        this.rows = 24;
+        this.kittyProtocolActive = false;
+        this.invalidate = invalidate;
+        this.control = control;
+    }
+    start() { }
+    stop() { }
+    async drainInput() { }
+    write() { this.invalidate(); }
+    moveBy() { }
+    hideCursor() { }
+    showCursor() { }
+    clearLine() { }
+    clearFromCursor() { }
+    clearScreen() { }
+    setTitle() { }
+    setProgress() { }
+    /** Ask the host to toggle host-TTY mouse-scroll reporting for this component. */
+    setMouseScrollTracking(enabled) {
+        this.control?.({ kind: "mouse-scroll-tracking", enabled });
+    }
+    /** Ask the host to toggle host-TTY autowrap (DECAWM) for this component. */
+    setAutowrap(enabled) {
+        this.control?.({ kind: "autowrap", enabled });
+    }
+}
+function serializableOverlayOptions(options) {
+    const value = typeof options === "function" ? options() : options;
+    if (!value)
+        return undefined;
+    const { anchor, col, margin, maxHeight, minWidth, offsetX, offsetY, row, width } = value;
+    return { anchor, col, margin, maxHeight, minWidth, offsetX, offsetY, row, width };
+}
+function jsonResult(value) {
+    if (value === undefined)
+        return undefined;
+    const encoded = JSON.stringify(value);
+    if (encoded === undefined)
+        return undefined;
+    const decoded = JSON.parse(encoded);
+    if (!isJsonValue(decoded))
+        throw new Error("Custom UI result is not JSON-safe");
+    return decoded;
+}
+function boundedLines(lines) {
+    let remaining = INTERACTIVE_ENGINE_MAX_FRAME_BYTES - 512;
+    const bounded = [];
+    for (const line of lines) {
+        if (remaining <= 0)
+            break;
+        const bytes = Buffer.from(line, "utf8");
+        const next = bytes.length <= remaining ? line : bytes.subarray(0, remaining).toString("utf8");
+        bounded.push(next);
+        remaining -= Buffer.byteLength(next, "utf8");
+    }
+    return bounded;
+}
+export class EngineCustomUiService {
+    setWidget(key, factory, placement) {
+        const previous = this.widgetIds.get(key);
+        if (previous)
+            this.disposeComponent(previous, false);
+        if (!factory)
+            return;
+        const componentId = `remote_widget_${++this.nextId}`;
+        this.widgetIds.set(key, componentId);
+        const terminal = new RemoteTerminal(() => this.send({ type: "engine_custom_invalidate", componentId }));
+        const tui = new TUI(terminal);
+        void runCallback({ kind: "renderer", name: `widget:${key}` }, () => factory(tui, theme)).then((component) => {
+            if (this.widgetIds.get(key) !== componentId) {
+                component.dispose?.();
+                return;
+            }
+            tui.addChild(component);
+            this.active.set(componentId, {
+                component,
+                resolve: () => { },
+                overlay: false,
+                terminal,
+                tui,
+                widgetKey: key,
+            });
+            this.send({ type: "engine_custom_open", componentId, overlay: false, widgetKey: key, widgetPlacement: placement });
+        }).catch((error) => {
+            if (this.widgetIds.get(key) === componentId)
+                this.widgetIds.delete(key);
+            this.send({ type: "engine_custom_frame", componentId, requestId: 0, lines: [`Widget ${key} failed: ${error.message}`] });
+        });
+    }
+    constructor(write, keybindings) {
+        this.widgetIds = new Map();
+        this.active = new Map();
+        this.nextId = 0;
+        this.stateListeners = new Set();
+        this.write = write;
+        this.keybindings = keybindings;
+    }
+    async custom(factory, options) {
+        const componentId = `remote_component_${++this.nextId}`;
+        let resolveCompletion;
+        const completion = new Promise((resolve) => { resolveCompletion = resolve; });
+        let opened = false;
+        let pendingDone;
+        let doneCalled = false;
+        const done = (result) => {
+            if (doneCalled)
+                return;
+            doneCalled = true;
+            pendingDone = result;
+            resolveCompletion(result);
+            if (opened)
+                this.sendDone(componentId, result);
+        };
+        const terminal = new RemoteTerminal(() => this.send({ type: "engine_custom_invalidate", componentId }), (control) => this.send({ type: "engine_custom_terminal", componentId, control }));
+        const tui = new TUI(terminal);
+        const component = await factory(tui, theme, this.keybindings, done);
+        tui.addChild(component);
+        tui.setFocus(component);
+        const record = {
+            component,
+            resolve: (value) => resolveCompletion(value),
+            terminal,
+            tui,
+            overlay: options?.overlay === true,
+        };
+        this.active.set(componentId, record);
+        this.notifyState();
+        opened = true;
+        this.send({
+            type: "engine_custom_open",
+            componentId,
+            overlay: options?.overlay === true,
+            deferInlineCustomUiFocus: options?.deferInlineCustomUiFocus,
+            overlayOptions: serializableOverlayOptions(options?.overlayOptions),
+        });
+        if (options?.onHandle)
+            options.onHandle(this.remoteHandle(componentId));
+        if (doneCalled)
+            this.sendDone(componentId, pendingDone);
+        const onAbort = () => this.disposeComponent(componentId, true);
+        options?.signal?.addEventListener("abort", onAbort, { once: true });
+        try {
+            return await completion;
+        }
+        finally {
+            options?.signal?.removeEventListener("abort", onAbort);
+            this.disposeComponent(componentId, false);
+        }
+    }
+    getHostCustomUiState() {
+        const depth = [...this.active.values()].filter((record) => !record.overlay && !record.widgetKey).length;
+        return { blockingInlineCustomUiDepth: depth, blockingInlineCustomUiActive: depth > 0 };
+    }
+    onHostCustomUiStateChange(listener) {
+        this.stateListeners.add(listener);
+        return () => this.stateListeners.delete(listener);
+    }
+    focusHostInlineCustomUi() { return this.getHostCustomUiState().blockingInlineCustomUiActive; }
+    requestRender() {
+        for (const [componentId, record] of this.active) {
+            if (record.hidden === true)
+                continue;
+            this.send({ type: "engine_custom_invalidate", componentId });
+        }
+    }
+    handleLine(line) {
+        const command = parseInteractiveEngineCommand(line);
+        if (!command)
+            return false;
+        if (!command.type.startsWith("engine_custom_"))
+            return false;
+        const record = this.active.get(command.componentId);
+        if (!record)
+            return true;
+        switch (command.type) {
+            case "engine_custom_render":
+                record.terminal.columns = Math.max(1, command.width);
+                record.terminal.rows = Math.max(1, command.rows);
+                void runCallback({ kind: "renderer", name: command.componentId }, () => record.component.render(record.terminal.columns)).then((lines) => this.send({
+                    type: "engine_custom_frame",
+                    componentId: command.componentId,
+                    requestId: command.requestId,
+                    lines: boundedLines(lines),
+                })).catch((error) => this.send({
+                    type: "engine_custom_frame",
+                    componentId: command.componentId,
+                    requestId: command.requestId,
+                    lines: [`Remote component render failed: ${error.message}`],
+                }));
+                break;
+            case "engine_custom_input":
+                void runCallback({ kind: "renderer", name: command.componentId }, () => {
+                    if (isKeyRelease(command.data) && record.component.wantsKeyRelease !== true)
+                        return;
+                    record.component.handleInput?.(command.data);
+                }).catch(() => undefined);
+                break;
+            case "engine_custom_dispose":
+                this.disposeComponent(command.componentId, true);
+                break;
+        }
+        return true;
+    }
+    dispose() {
+        for (const componentId of [...this.active.keys()])
+            this.disposeComponent(componentId, true);
+    }
+    disposeComponent(componentId, resolve) {
+        const record = this.active.get(componentId);
+        if (!record)
+            return;
+        this.active.delete(componentId);
+        record.component.dispose?.();
+        record.tui.stop();
+        if (record.widgetKey) {
+            if (this.widgetIds.get(record.widgetKey) === componentId)
+                this.widgetIds.delete(record.widgetKey);
+            this.send({ type: "engine_custom_close", componentId });
+        }
+        this.notifyState();
+        if (resolve)
+            record.resolve(undefined);
+    }
+    notifyState() {
+        const state = this.getHostCustomUiState();
+        for (const listener of this.stateListeners)
+            listener(state);
+    }
+    remoteHandle(componentId) {
+        let focused = true;
+        const setHiddenFlag = (value) => {
+            const record = this.active.get(componentId);
+            if (record)
+                record.hidden = value;
+        };
+        return {
+            hide: () => {
+                setHiddenFlag(true);
+                this.send({ type: "engine_custom_control", componentId, action: "hide" });
+            },
+            setHidden: (value) => {
+                setHiddenFlag(value);
+                this.send({ type: "engine_custom_control", componentId, action: value ? "hide" : "show" });
+            },
+            isHidden: () => this.active.get(componentId)?.hidden === true,
+            focus: () => {
+                focused = true;
+                this.send({ type: "engine_custom_control", componentId, action: "focus" });
+            },
+            unfocus: () => {
+                focused = false;
+                this.send({ type: "engine_custom_control", componentId, action: "unfocus" });
+            },
+            isFocused: () => focused,
+        };
+    }
+    sendDone(componentId, result) {
+        this.send({
+            type: "engine_custom_done",
+            componentId,
+            result: jsonResult(result),
+        });
+    }
+    send(message) {
+        this.write(serializeInteractiveEngineMessage(message));
+    }
+}
+//# sourceMappingURL=engine-custom-ui.js.map

package/dist/modes/interactive-engine/engine-custom-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-custom-ui.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-custom-ui.ts"],"names":[],"mappings":"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","sourcesContent":["import { isKeyRelease, type Component, type OverlayHandle, type OverlayOptions, type Terminal } from \"@earendil-works/pi-tui\";\nimport { TUI } from \"@earendil-works/pi-tui\";\nimport { runCallback } from \"../../core/callback-activity.ts\";\nimport type { KeybindingsManager } from \"../../core/keybindings.ts\";\nimport type { Theme } from \"../interactive/theme/theme.ts\";\nimport { theme } from \"../interactive/theme/theme.ts\";\nimport {\n\tINTERACTIVE_ENGINE_MAX_FRAME_BYTES,\n\tisJsonValue,\n\tparseInteractiveEngineCommand,\n\tserializeInteractiveEngineMessage,\n\ttype EngineTerminalControl,\n\ttype InteractiveEngineMessage,\n\ttype JsonValue,\n\ttype SerializableOverlayOptions,\n} from \"./protocol.ts\";\n\ninterface CustomUiOptions {\n\toverlay?: boolean;\n\tdeferInlineCustomUiFocus?: boolean;\n\toverlayOptions?: OverlayOptions | (() => OverlayOptions);\n\tonHandle?: (handle: OverlayHandle) => void;\n\tsignal?: AbortSignal;\n}\n\ninterface ActiveComponent {\n\tcomponent: Component & { dispose?(): void };\n\tresolve: (value: JsonValue | undefined) => void;\n\toverlay: boolean;\n\tterminal: RemoteTerminal;\n\ttui: TUI;\n\twidgetKey?: string;\n\t/**\n\t * Overlay visibility as last driven through the remote OverlayHandle.\n\t * Hidden components are skipped by the extension-level `requestRender()`\n\t * broadcast (#1856) — invalidating a hidden overlay only produced host\n\t * render work and terminal writes for frames the user cannot see.\n\t */\n\thidden?: boolean;\n}\n\nclass RemoteTerminal implements Terminal {\n\tcolumns = 80;\n\trows = 24;\n\tkittyProtocolActive = false;\n\tprivate readonly invalidate: () => void;\n\tprivate readonly control: ((control: EngineTerminalControl) => void) | undefined;\n\tconstructor(invalidate: () => void, control?: (control: EngineTerminalControl) => void) {\n\t\tthis.invalidate = invalidate;\n\t\tthis.control = control;\n\t}\n\tstart(): void {}\n\tstop(): void {}\n\tasync drainInput(): Promise<void> {}\n\twrite(): void { this.invalidate(); }\n\tmoveBy(): void {}\n\thideCursor(): void {}\n\tshowCursor(): void {}\n\tclearLine(): void {}\n\tclearFromCursor(): void {}\n\tclearScreen(): void {}\n\tsetTitle(): void {}\n\tsetProgress(): void {}\n\t/** Ask the host to toggle host-TTY mouse-scroll reporting for this component. */\n\tsetMouseScrollTracking(enabled: boolean): void {\n\t\tthis.control?.({ kind: \"mouse-scroll-tracking\", enabled });\n\t}\n\t/** Ask the host to toggle host-TTY autowrap (DECAWM) for this component. */\n\tsetAutowrap(enabled: boolean): void {\n\t\tthis.control?.({ kind: \"autowrap\", enabled });\n\t}\n}\n\nfunction serializableOverlayOptions(options: CustomUiOptions[\"overlayOptions\"]): SerializableOverlayOptions | undefined {\n\tconst value = typeof options === \"function\" ? options() : options;\n\tif (!value) return undefined;\n\tconst { anchor, col, margin, maxHeight, minWidth, offsetX, offsetY, row, width } = value;\n\treturn { anchor, col, margin, maxHeight, minWidth, offsetX, offsetY, row, width };\n}\n\nfunction jsonResult(value: object | boolean | null | number | string | undefined): JsonValue | undefined {\n\tif (value === undefined) return undefined;\n\tconst encoded = JSON.stringify(value);\n\tif (encoded === undefined) return undefined;\n\tconst decoded = JSON.parse(encoded) as JsonValue;\n\tif (!isJsonValue(decoded)) throw new Error(\"Custom UI result is not JSON-safe\");\n\treturn decoded;\n}\n\nfunction boundedLines(lines: string[]): string[] {\n\tlet remaining = INTERACTIVE_ENGINE_MAX_FRAME_BYTES - 512;\n\tconst bounded: string[] = [];\n\tfor (const line of lines) {\n\t\tif (remaining <= 0) break;\n\t\tconst bytes = Buffer.from(line, \"utf8\");\n\t\tconst next = bytes.length <= remaining ? line : bytes.subarray(0, remaining).toString(\"utf8\");\n\t\tbounded.push(next);\n\t\tremaining -= Buffer.byteLength(next, \"utf8\");\n\t}\n\treturn bounded;\n}\n\nexport class EngineCustomUiService {\n\tprivate readonly widgetIds = new Map<string, string>();\n\tprivate readonly active = new Map<string, ActiveComponent>();\n\tprivate nextId = 0;\n\tprivate readonly write: (line: string) => void;\n\tprivate readonly keybindings: KeybindingsManager;\n\tprivate readonly stateListeners = new Set<(state: { blockingInlineCustomUiDepth: number; blockingInlineCustomUiActive: boolean }) => void>();\n\n\n\tsetWidget(\n\t\tkey: string,\n\t\tfactory: ((tui: TUI, theme: Theme) => Component & { dispose?(): void }) | undefined,\n\t\tplacement?: \"aboveEditor\" | \"belowEditor\",\n\t): void {\n\t\tconst previous = this.widgetIds.get(key);\n\t\tif (previous) this.disposeComponent(previous, false);\n\t\tif (!factory) return;\n\t\tconst componentId = `remote_widget_${++this.nextId}`;\n\t\tthis.widgetIds.set(key, componentId);\n\t\tconst terminal = new RemoteTerminal(() => this.send({ type: \"engine_custom_invalidate\", componentId }));\n\t\tconst tui = new TUI(terminal);\n\t\tvoid runCallback(\n\t\t\t{ kind: \"renderer\", name: `widget:${key}` },\n\t\t\t() => factory(tui, theme),\n\t\t).then((component) => {\n\t\t\tif (this.widgetIds.get(key) !== componentId) {\n\t\t\t\tcomponent.dispose?.();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\ttui.addChild(component);\n\t\t\tthis.active.set(componentId, {\n\t\t\t\tcomponent,\n\t\t\t\tresolve: () => {},\n\t\t\t\toverlay: false,\n\t\t\t\tterminal,\n\t\t\t\ttui,\n\t\t\t\twidgetKey: key,\n\t\t\t});\n\t\t\tthis.send({ type: \"engine_custom_open\", componentId, overlay: false, widgetKey: key, widgetPlacement: placement });\n\t\t}).catch((error: Error) => {\n\t\t\tif (this.widgetIds.get(key) === componentId) this.widgetIds.delete(key);\n\t\t\tthis.send({ type: \"engine_custom_frame\", componentId, requestId: 0, lines: [`Widget ${key} failed: ${error.message}`] });\n\t\t});\n\t}\n\tconstructor(write: (line: string) => void, keybindings: KeybindingsManager) {\n\t\tthis.write = write;\n\t\tthis.keybindings = keybindings;\n\t}\n\n\tasync custom<T>(\n\t\tfactory: (\n\t\t\ttui: TUI,\n\t\t\ttheme: Theme,\n\t\t\tkeybindings: KeybindingsManager,\n\t\t\tdone: (result: T) => void,\n\t\t) => (Component & { dispose?(): void }) | Promise<Component & { dispose?(): void }>,\n\t\toptions?: CustomUiOptions,\n\t): Promise<T> {\n\t\tconst componentId = `remote_component_${++this.nextId}`;\n\t\tlet resolveCompletion!: (value: T) => void;\n\t\tconst completion = new Promise<T>((resolve) => { resolveCompletion = resolve; });\n\t\tlet opened = false;\n\t\tlet pendingDone: T | undefined;\n\t\tlet doneCalled = false;\n\t\tconst done = (result: T): void => {\n\t\t\tif (doneCalled) return;\n\t\t\tdoneCalled = true;\n\t\t\tpendingDone = result;\n\t\t\tresolveCompletion(result);\n\t\t\tif (opened) this.sendDone(componentId, result);\n\t\t};\n\t\tconst terminal = new RemoteTerminal(\n\t\t\t() => this.send({ type: \"engine_custom_invalidate\", componentId }),\n\t\t\t(control) => this.send({ type: \"engine_custom_terminal\", componentId, control }),\n\t\t);\n\t\tconst tui = new TUI(terminal);\n\t\tconst component = await factory(tui, theme, this.keybindings, done);\n\t\ttui.addChild(component);\n\t\ttui.setFocus(component);\n\t\tconst record: ActiveComponent = {\n\t\t\tcomponent,\n\t\t\tresolve: (value) => resolveCompletion(value as T),\n\t\t\tterminal,\n\t\t\ttui,\n\t\t\toverlay: options?.overlay === true,\n\t\t};\n\t\tthis.active.set(componentId, record);\n\t\tthis.notifyState();\n\t\topened = true;\n\t\tthis.send({\n\t\t\ttype: \"engine_custom_open\",\n\t\t\tcomponentId,\n\t\t\toverlay: options?.overlay === true,\n\t\t\tdeferInlineCustomUiFocus: options?.deferInlineCustomUiFocus,\n\t\t\toverlayOptions: serializableOverlayOptions(options?.overlayOptions),\n\t\t});\n\t\tif (options?.onHandle) options.onHandle(this.remoteHandle(componentId));\n\t\tif (doneCalled) this.sendDone(componentId, pendingDone as T);\n\t\tconst onAbort = () => this.disposeComponent(componentId, true);\n\t\toptions?.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\ttry {\n\t\t\treturn await completion;\n\t\t} finally {\n\t\t\toptions?.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\tthis.disposeComponent(componentId, false);\n\t\t}\n\t}\n\tgetHostCustomUiState(): { blockingInlineCustomUiDepth: number; blockingInlineCustomUiActive: boolean } {\n\t\tconst depth = [...this.active.values()].filter((record) => !record.overlay && !record.widgetKey).length;\n\t\treturn { blockingInlineCustomUiDepth: depth, blockingInlineCustomUiActive: depth > 0 };\n\t}\n\n\tonHostCustomUiStateChange(\n\t\tlistener: (state: { blockingInlineCustomUiDepth: number; blockingInlineCustomUiActive: boolean }) => void,\n\t): () => void {\n\t\tthis.stateListeners.add(listener);\n\t\treturn () => this.stateListeners.delete(listener);\n\t}\n\n\tfocusHostInlineCustomUi(): boolean { return this.getHostCustomUiState().blockingInlineCustomUiActive; }\n\n\n\trequestRender(): void {\n\t\tfor (const [componentId, record] of this.active) {\n\t\t\tif (record.hidden === true) continue;\n\t\t\tthis.send({ type: \"engine_custom_invalidate\", componentId });\n\t\t}\n\t}\n\n\thandleLine(line: string): boolean {\n\t\tconst command = parseInteractiveEngineCommand(line);\n\t\tif (!command) return false;\n\t\tif (!command.type.startsWith(\"engine_custom_\")) return false;\n\t\tconst record = this.active.get(command.componentId);\n\t\tif (!record) return true;\n\t\tswitch (command.type) {\n\t\t\tcase \"engine_custom_render\":\n\t\t\t\trecord.terminal.columns = Math.max(1, command.width);\n\t\t\t\trecord.terminal.rows = Math.max(1, command.rows);\n\t\t\t\tvoid runCallback(\n\t\t\t\t\t{ kind: \"renderer\", name: command.componentId },\n\t\t\t\t\t() => record.component.render(record.terminal.columns),\n\t\t\t\t).then((lines) => this.send({\n\t\t\t\t\ttype: \"engine_custom_frame\",\n\t\t\t\t\tcomponentId: command.componentId,\n\t\t\t\t\trequestId: command.requestId,\n\t\t\t\t\tlines: boundedLines(lines),\n\t\t\t\t})).catch((error: Error) => this.send({\n\t\t\t\t\ttype: \"engine_custom_frame\",\n\t\t\t\t\tcomponentId: command.componentId,\n\t\t\t\t\trequestId: command.requestId,\n\t\t\t\t\tlines: [`Remote component render failed: ${error.message}`],\n\t\t\t\t}));\n\t\t\t\tbreak;\n\t\t\tcase \"engine_custom_input\":\n\t\t\t\tvoid runCallback(\n\t\t\t\t\t{ kind: \"renderer\", name: command.componentId },\n\t\t\t\t\t() => {\n\t\t\t\t\t\tif (isKeyRelease(command.data) && record.component.wantsKeyRelease !== true) return;\n\t\t\t\t\t\trecord.component.handleInput?.(command.data);\n\t\t\t\t\t},\n\t\t\t\t).catch(() => undefined);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_custom_dispose\":\n\t\t\t\tthis.disposeComponent(command.componentId, true);\n\t\t\t\tbreak;\n\t\t}\n\t\treturn true;\n\t}\n\n\tdispose(): void {\n\t\tfor (const componentId of [...this.active.keys()]) this.disposeComponent(componentId, true);\n\t}\n\tprivate disposeComponent(componentId: string, resolve: boolean): void {\n\t\tconst record = this.active.get(componentId);\n\t\tif (!record) return;\n\t\tthis.active.delete(componentId);\n\t\trecord.component.dispose?.();\n\t\trecord.tui.stop();\n\t\tif (record.widgetKey) {\n\t\t\tif (this.widgetIds.get(record.widgetKey) === componentId) this.widgetIds.delete(record.widgetKey);\n\t\t\tthis.send({ type: \"engine_custom_close\", componentId });\n\t\t}\n\t\tthis.notifyState();\n\t\tif (resolve) record.resolve(undefined);\n\t}\n\tprivate notifyState(): void {\n\t\tconst state = this.getHostCustomUiState();\n\t\tfor (const listener of this.stateListeners) listener(state);\n\t}\n\n\n\tprivate remoteHandle(componentId: string): OverlayHandle {\n\t\tlet focused = true;\n\t\tconst setHiddenFlag = (value: boolean): void => {\n\t\t\tconst record = this.active.get(componentId);\n\t\t\tif (record) record.hidden = value;\n\t\t};\n\t\treturn {\n\t\t\thide: () => {\n\t\t\t\tsetHiddenFlag(true);\n\t\t\t\tthis.send({ type: \"engine_custom_control\", componentId, action: \"hide\" });\n\t\t\t},\n\t\t\tsetHidden: (value) => {\n\t\t\t\tsetHiddenFlag(value);\n\t\t\t\tthis.send({ type: \"engine_custom_control\", componentId, action: value ? \"hide\" : \"show\" });\n\t\t\t},\n\t\t\tisHidden: () => this.active.get(componentId)?.hidden === true,\n\t\t\tfocus: () => {\n\t\t\t\tfocused = true;\n\t\t\t\tthis.send({ type: \"engine_custom_control\", componentId, action: \"focus\" });\n\t\t\t},\n\t\t\tunfocus: () => {\n\t\t\t\tfocused = false;\n\t\t\t\tthis.send({ type: \"engine_custom_control\", componentId, action: \"unfocus\" });\n\t\t\t},\n\t\t\tisFocused: () => focused,\n\t\t};\n\t}\n\n\tprivate sendDone<T>(componentId: string, result: T): void {\n\t\tthis.send({\n\t\t\ttype: \"engine_custom_done\",\n\t\t\tcomponentId,\n\t\t\tresult: jsonResult(result as object | boolean | null | number | string | undefined),\n\t\t});\n\t}\n\n\tprivate send(message: InteractiveEngineMessage): void {\n\t\tthis.write(serializeInteractiveEngineMessage(message));\n\t}\n}\n"]}

package/dist/modes/interactive-engine/engine-input-form.d.ts

@@ -0,0 +1,13 @@
+import type { HostInputFormRequest } from "../../core/extensions/ui-types.ts";
+/** Child-side owner for host-native input forms. */
+export declare class EngineInputFormService {
+    private readonly active;
+    private readonly write;
+    private nextId;
+    constructor(write: (line: string) => void);
+    open(request: HostInputFormRequest): Promise<Record<string, string> | undefined>;
+    handleLine(line: string): boolean;
+    dispose(): void;
+    private send;
+}
+//# sourceMappingURL=engine-input-form.d.ts.map

package/dist/modes/interactive-engine/engine-input-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-input-form.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-input-form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAY9E,oDAAoD;AACpD,qBAAa,sBAAsB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,MAAM,CAAK;IACnB,YAAY,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAExC;IAED,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAgB/E;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQhC;IAED,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,CAAC,IAAI;CAGZ"}