@caupulican/pi-adaptative 0.81.41 → 0.81.43

package/dist/core/tools/tool-task.js

@@ -0,0 +1,93 @@
+import { Type } from "typebox";
+const MAX_TASK_ID_CHARS = 128;
+const MAX_LISTED_TASKS = 32;
+const schema = Type.Object({
+    action: Type.String({
+        enum: ["list", "wait", "cancel"],
+        description: "List once, wait once for a dependency, or cancel. Never poll.",
+    }),
+    taskId: Type.Optional(Type.String({
+        maxLength: MAX_TASK_ID_CHARS,
+        description: "Task id; required for wait/cancel.",
+    })),
+}, { additionalProperties: false });
+function validTaskId(value) {
+    const taskId = value?.trim();
+    if (!taskId || taskId.length > MAX_TASK_ID_CHARS)
+        return undefined;
+    return taskId;
+}
+function listText(records) {
+    if (records.length === 0)
+        return "No background tool tasks in this session.";
+    const included = records.slice(-MAX_LISTED_TASKS);
+    const omitted = records.length - included.length;
+    return [
+        ...included.map((record) => `${record.taskId}: ${record.status} — ${record.summary}`),
+        ...(omitted > 0 ? [`${omitted} older task(s) omitted from this bounded snapshot.`] : []),
+        "Do not poll. Continue independent work, or call wait once only when a running task is a dependency.",
+    ].join("\n");
+}
+export function createToolTaskToolDefinition(deps) {
+    return {
+        name: "tool_task",
+        label: "tool_task",
+        description: "List, wait for, or cancel this session's background tool calls. Continue other work; wait is event-driven, never poll.",
+        promptSnippet: "Event-driven background tool control; wait once, never poll.",
+        parameters: schema,
+        async execute(_toolCallId, input, signal) {
+            if (input.action === "list") {
+                const records = deps.list();
+                return {
+                    content: [{ type: "text", text: listText(records) }],
+                    details: { kind: "list", count: records.length },
+                };
+            }
+            const taskId = validTaskId(input.taskId);
+            if (!taskId) {
+                return {
+                    content: [{ type: "text", text: `${input.action} requires a valid taskId.` }],
+                    details: { kind: "error", reason: "invalid_task_id" },
+                };
+            }
+            if (input.action === "cancel") {
+                const canceled = deps.cancel(taskId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: canceled
+                                ? `Cancellation requested for ${taskId}.`
+                                : `No running background tool task named ${taskId}.`,
+                        },
+                    ],
+                    details: {
+                        kind: "cancel",
+                        taskId,
+                        ...(canceled ? {} : { reason: "not_running" }),
+                    },
+                };
+            }
+            try {
+                const record = await deps.wait(taskId, signal);
+                return {
+                    content: [{ type: "text", text: record.output || record.summary }],
+                    details: {
+                        kind: "wait",
+                        taskId,
+                        status: record.status,
+                        ...(record.artifactId ? { artifactId: record.artifactId } : {}),
+                    },
+                };
+            }
+            catch (error) {
+                const reason = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [{ type: "text", text: reason }],
+                    details: { kind: "error", taskId, reason },
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=tool-task.js.map

package/dist/core/tools/tool-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-task.js","sourceRoot":"","sources":["../../../src/core/tools/tool-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAI5C,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CACzB;IACC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;QAChC,WAAW,EAAE,+DAA+D;KAC5E,CAAC;IACF,MAAM,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC;QACX,SAAS,EAAE,iBAAiB;QAC5B,WAAW,EAAE,oCAAoC;KACjD,CAAC,CACF;CACD,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAC/B,CAAC;AAmBF,SAAS,WAAW,CAAC,KAAyB;IAC7C,MAAM,MAAM,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB;QAAE,OAAO,SAAS,CAAC;IACnE,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,OAA4C;IAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,2CAA2C,CAAC;IAC7E,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IACjD,OAAO;QACN,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACrF,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,oDAAoD,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,qGAAqG;KACrG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAA0B;IACtE,OAAO;QACN,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,WAAW,EACV,wHAAwH;QACzH,aAAa,EAAE,8DAA8D;QAC7E,UAAU,EAAE,MAAM;QAClB,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,KAAY,EAAE,MAAM;YAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,OAAO;oBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC7D,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;iBACzD,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACb,OAAO;oBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,2BAA2B,EAAE,CAAC;oBACtF,OAAO,EAAE,EAAE,IAAI,EAAE,OAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAE;iBAC9D,CAAC;YACH,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACrC,OAAO;oBACN,OAAO,EAAE;wBACR;4BACC,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,QAAQ;gCACb,CAAC,CAAC,8BAA8B,MAAM,GAAG;gCACzC,CAAC,CAAC,yCAAyC,MAAM,GAAG;yBACrD;qBACD;oBACD,OAAO,EAAE;wBACR,IAAI,EAAE,QAAiB;wBACvB,MAAM;wBACN,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;qBAC9C;iBACD,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC/C,OAAO;oBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC3E,OAAO,EAAE;wBACR,IAAI,EAAE,MAAe;wBACrB,MAAM;wBACN,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC/D;iBACD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,OAAO;oBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBAClD,OAAO,EAAE,EAAE,IAAI,EAAE,OAAgB,EAAE,MAAM,EAAE,MAAM,EAAE;iBACnD,CAAC;YACH,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["import { type Static, Type } from \"typebox\";\nimport type { BackgroundToolTaskRecord } from \"../background-tool-task-controller.ts\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\n\nconst MAX_TASK_ID_CHARS = 128;\nconst MAX_LISTED_TASKS = 32;\n\nconst schema = Type.Object(\n\t{\n\t\taction: Type.String({\n\t\t\tenum: [\"list\", \"wait\", \"cancel\"],\n\t\t\tdescription: \"List once, wait once for a dependency, or cancel. Never poll.\",\n\t\t}),\n\t\ttaskId: Type.Optional(\n\t\t\tType.String({\n\t\t\t\tmaxLength: MAX_TASK_ID_CHARS,\n\t\t\t\tdescription: \"Task id; required for wait/cancel.\",\n\t\t\t}),\n\t\t),\n\t},\n\t{ additionalProperties: false },\n);\n\ntype Input = Static<typeof schema>;\n\nexport interface ToolTaskDependencies {\n\tlist(): BackgroundToolTaskRecord[];\n\twait(taskId: string, signal?: AbortSignal): Promise<BackgroundToolTaskRecord>;\n\tcancel(taskId: string): boolean;\n}\n\nexport interface ToolTaskDetails {\n\tkind: \"list\" | \"wait\" | \"cancel\" | \"error\";\n\tcount?: number;\n\ttaskId?: string;\n\tstatus?: BackgroundToolTaskRecord[\"status\"];\n\tartifactId?: string;\n\treason?: string;\n}\n\nfunction validTaskId(value: string | undefined): string | undefined {\n\tconst taskId = value?.trim();\n\tif (!taskId || taskId.length > MAX_TASK_ID_CHARS) return undefined;\n\treturn taskId;\n}\n\nfunction listText(records: readonly BackgroundToolTaskRecord[]): string {\n\tif (records.length === 0) return \"No background tool tasks in this session.\";\n\tconst included = records.slice(-MAX_LISTED_TASKS);\n\tconst omitted = records.length - included.length;\n\treturn [\n\t\t...included.map((record) => `${record.taskId}: ${record.status} — ${record.summary}`),\n\t\t...(omitted > 0 ? [`${omitted} older task(s) omitted from this bounded snapshot.`] : []),\n\t\t\"Do not poll. Continue independent work, or call wait once only when a running task is a dependency.\",\n\t].join(\"\\n\");\n}\n\nexport function createToolTaskToolDefinition(deps: ToolTaskDependencies): ToolDefinition<typeof schema> {\n\treturn {\n\t\tname: \"tool_task\",\n\t\tlabel: \"tool_task\",\n\t\tdescription:\n\t\t\t\"List, wait for, or cancel this session's background tool calls. Continue other work; wait is event-driven, never poll.\",\n\t\tpromptSnippet: \"Event-driven background tool control; wait once, never poll.\",\n\t\tparameters: schema,\n\t\tasync execute(_toolCallId, input: Input, signal) {\n\t\t\tif (input.action === \"list\") {\n\t\t\t\tconst records = deps.list();\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\" as const, text: listText(records) }],\n\t\t\t\t\tdetails: { kind: \"list\" as const, count: records.length },\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tconst taskId = validTaskId(input.taskId);\n\t\t\tif (!taskId) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\" as const, text: `${input.action} requires a valid taskId.` }],\n\t\t\t\t\tdetails: { kind: \"error\" as const, reason: \"invalid_task_id\" },\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tif (input.action === \"cancel\") {\n\t\t\t\tconst canceled = deps.cancel(taskId);\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\t\t\ttext: canceled\n\t\t\t\t\t\t\t\t? `Cancellation requested for ${taskId}.`\n\t\t\t\t\t\t\t\t: `No running background tool task named ${taskId}.`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: {\n\t\t\t\t\t\tkind: \"cancel\" as const,\n\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\t...(canceled ? {} : { reason: \"not_running\" }),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst record = await deps.wait(taskId, signal);\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\" as const, text: record.output || record.summary }],\n\t\t\t\t\tdetails: {\n\t\t\t\t\t\tkind: \"wait\" as const,\n\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\tstatus: record.status,\n\t\t\t\t\t\t...(record.artifactId ? { artifactId: record.artifactId } : {}),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t} catch (error) {\n\t\t\t\tconst reason = error instanceof Error ? error.message : String(error);\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\" as const, text: reason }],\n\t\t\t\t\tdetails: { kind: \"error\" as const, taskId, reason },\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t};\n}\n"]}

package/dist/core/tools/windows-shell-engine.d.ts

@@ -1,15 +1,20 @@
 /**
- * The `python-engine` tier: per-command spawn of the bundled `pi-shell-engine` (D3 in the
- * blueprint). Wires the frozen §1.2/§1.3 stdin-JSON-request / 0x1e-framed-stdout protocol into a
- * `BashOperations`, threads `WindowsShellState` through both directions (D4), and degrades to a
- * named, actionable error when the Python runtime is not ready — the PowerShell floor keeps
- * working regardless (the router never routes simple commands here when the engine is off).
+ * Persistent Windows Python shell-engine sessions.
+ *
+ * One coordinator process is keyed to each agent session. Requests are serialized as JSON lines;
+ * Node remains the sole owner of cwd/environment state and derives each request only after the
+ * preceding terminal frame has been applied. Command bytes stream on stdout, followed by a
+ * request-specific output barrier. A correlated control frame arrives on stderr. Requiring both
+ * channels before settlement prevents cross-pipe tail loss and stale-frame reuse.
+ *
+ * Timeout, abort, protocol failure, or coordinator death resets the whole process tree. The next
+ * request starts a clean coordinator from the last state Node actually acknowledged.
  */
 import type { ChildProcess, SpawnOptions } from "node:child_process";
 import { type PythonRuntimeOutcome } from "../python-runtime.ts";
 import type { BashOperations } from "./bash.ts";
 import { type WindowsShellState } from "./windows-shell-state.ts";
-/** The full §1.3 control-frame shape. */
+/** State/result fields returned for every completed engine command. */
 export interface WindowsShellEngineFrame {
     exitCode: number;
     cwd: string;
@@ -31,12 +36,13 @@ export interface WindowsShellEngineOptions {
     engineScriptPath?: string;
     /** Override for tests: the per-session state store lookup. Default: the shared module store. */
     getState?: (sessionKey: string) => WindowsShellState;
-    /** Override for tests: spawns the engine child process. Default: `spawnProcess` (cross-spawn on win32). */
+    /** Override for tests: spawns the persistent coordinator. Default: `spawnProcess`. */
     spawn?: (command: string, args: string[], options: SpawnOptions) => ChildProcess;
+    /** Override for tests: selected PowerShell host used to adapt `.ps1` external commands. */
+    resolvePowerShellPath?: () => string;
 }
-/**
- * Create the `python-engine` tier `BashOperations` for one bash-tool session. `exec`'s `command`
- * argument is the RAW Bash source from the `python-engine` route (never PowerShell-translated).
- */
+/** Kill and forget a Python coordinator. The next call for this key starts a clean process. */
+export declare function disposeWindowsShellEngineSession(key: string): void;
+/** Create the Python-engine tier for one bash-tool session. */
 export declare function createWindowsShellEngineOperations(sessionKey: string, options?: WindowsShellEngineOptions): BashOperations;
 //# sourceMappingURL=windows-shell-engine.d.ts.map

package/dist/core/tools/windows-shell-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"windows-shell-engine.d.ts","sourceRoot":"","sources":["../../../src/core/tools/windows-shell-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKrE,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAKN,KAAK,iBAAiB,EACtB,MAAM,0BAA0B,CAAC;AAIlC,0CAAyC;AACzC,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,WAAW,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,YAAY,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAIlD;CACD;AAmCD,MAAM,WAAW,yBAAyB;IACzC,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACrD,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACrD,2GAA2G;IAC3G,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;CACjF;AAUD;;;GAGG;AACH,wBAAgB,kCAAkC,CACjD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,yBAA8B,GACrC,cAAc,CAwFhB","sourcesContent":["/**\n * The `python-engine` tier: per-command spawn of the bundled `pi-shell-engine` (D3 in the\n * blueprint). Wires the frozen §1.2/§1.3 stdin-JSON-request / 0x1e-framed-stdout protocol into a\n * `BashOperations`, threads `WindowsShellState` through both directions (D4), and degrades to a\n * named, actionable error when the Python runtime is not ready — the PowerShell floor keeps\n * working regardless (the router never routes simple commands here when the engine is off).\n */\n\nimport type { ChildProcess, SpawnOptions } from \"node:child_process\";\nimport { join } from \"node:path\";\nimport { getBundledResourcesDir } from \"../../config.ts\";\nimport { spawnProcess, waitForChildProcessWithTermination } from \"../../utils/child-process.ts\";\nimport { getShellEnv, trackDetachedChildPid, untrackDetachedChildPid } from \"../../utils/shell.ts\";\nimport { ensurePythonRuntime, type PythonRuntimeOutcome } from \"../python-runtime.ts\";\nimport { isRecordObject } from \"../util/value-guards.ts\";\nimport type { BashOperations } from \"./bash.ts\";\nimport {\n\tapplyEngineFrame,\n\tgetOrCreateWindowsShellState,\n\tmergeEffectiveEnv,\n\tresolveEffectiveCwd,\n\ttype WindowsShellState,\n} from \"./windows-shell-state.ts\";\n\nconst ENGINE_FRAME_SENTINEL = 0x1e;\n\n/** The full §1.3 control-frame shape. */\nexport interface WindowsShellEngineFrame {\n\texitCode: number;\n\tcwd: string;\n\tenvDelta: Record<string, string | null>;\n\tunsupported: { code: \"unsupported\"; construct: string; message: string } | null;\n}\n\nexport class WindowsShellEngineFailure extends Error {\n\treadonly capturedOutput: string;\n\n\tconstructor(message: string, capturedOutput: string) {\n\t\tsuper(message);\n\t\tthis.name = \"WindowsShellEngineFailure\";\n\t\tthis.capturedOutput = capturedOutput;\n\t}\n}\n\nfunction resolveEngineScriptPath(): string {\n\treturn join(getBundledResourcesDir(), \"runtimes\", \"pi-shell-engine\", \"main.py\");\n}\n\nconst MAX_CONTROL_FRAME_BYTES = 64 * 1024;\n\n/** Parse the terminal frame from the dedicated control stream. Command output is never retained here. */\nfunction parseControlFrame(buffer: Buffer): WindowsShellEngineFrame | undefined {\n\tif (buffer.length < 2 || buffer[buffer.length - 1] !== ENGINE_FRAME_SENTINEL) return undefined;\n\tconst openIndex = buffer.lastIndexOf(ENGINE_FRAME_SENTINEL, buffer.length - 2);\n\tif (openIndex === -1) return undefined;\n\ttry {\n\t\tconst raw: unknown = JSON.parse(buffer.subarray(openIndex + 1, buffer.length - 1).toString(\"utf8\"));\n\t\tif (!isRecordObject(raw)) return undefined;\n\t\tif (typeof raw.exitCode !== \"number\" || !Number.isInteger(raw.exitCode)) return undefined;\n\t\tif (typeof raw.cwd !== \"string\" || !isRecordObject(raw.envDelta)) return undefined;\n\t\tif (raw.unsupported !== null && !isRecordObject(raw.unsupported)) return undefined;\n\t\tif (\n\t\t\traw.unsupported !== null &&\n\t\t\t(raw.unsupported.code !== \"unsupported\" ||\n\t\t\t\ttypeof raw.unsupported.construct !== \"string\" ||\n\t\t\t\ttypeof raw.unsupported.message !== \"string\")\n\t\t)\n\t\t\treturn undefined;\n\t\tfor (const value of Object.values(raw.envDelta)) {\n\t\t\tif (value !== null && typeof value !== \"string\") return undefined;\n\t\t}\n\t\treturn raw as unknown as WindowsShellEngineFrame;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport interface WindowsShellEngineOptions {\n\t/** Override for tests: resolves the Python runtime outcome. Default: `ensurePythonRuntime`. */\n\tresolveRuntime?: () => Promise<PythonRuntimeOutcome>;\n\t/** Override for tests: absolute path to the engine's `main.py`. Default: the bundled runtime. */\n\tengineScriptPath?: string;\n\t/** Override for tests: the per-session state store lookup. Default: the shared module store. */\n\tgetState?: (sessionKey: string) => WindowsShellState;\n\t/** Override for tests: spawns the engine child process. Default: `spawnProcess` (cross-spawn on win32). */\n\tspawn?: (command: string, args: string[], options: SpawnOptions) => ChildProcess;\n}\n\nfunction degradationError(\n\toutcome: Extract<PythonRuntimeOutcome, { status: \"offline\" | \"uv-unavailable\" | \"python-unavailable\" }>,\n) {\n\treturn new Error(\n\t\t`The Windows shell engine (Python) is unavailable: ${outcome.reason} The simple-command PowerShell floor still works; fix the Python runtime (uv/network) to restore pipelines, redirection, expansion, and chaining.`,\n\t);\n}\n\n/**\n * Create the `python-engine` tier `BashOperations` for one bash-tool session. `exec`'s `command`\n * argument is the RAW Bash source from the `python-engine` route (never PowerShell-translated).\n */\nexport function createWindowsShellEngineOperations(\n\tsessionKey: string,\n\toptions: WindowsShellEngineOptions = {},\n): BashOperations {\n\tconst resolveRuntime = options.resolveRuntime ?? (() => ensurePythonRuntime({ silent: true }));\n\tconst engineScriptPath = options.engineScriptPath ?? resolveEngineScriptPath();\n\tconst getState = options.getState ?? getOrCreateWindowsShellState;\n\tconst spawn = options.spawn ?? spawnProcess;\n\n\treturn {\n\t\tasync exec(command, cwd, { onData, signal, timeout, env }) {\n\t\t\tconst runtime = await resolveRuntime();\n\t\t\tif (runtime.status !== \"ready\") throw degradationError(runtime);\n\n\t\t\tconst state = getState(sessionKey);\n\t\t\tconst effectiveCwd = resolveEffectiveCwd(state, cwd);\n\t\t\tconst effectiveEnv = mergeEffectiveEnv(state, env ?? getShellEnv());\n\t\t\tconst timeoutMs = timeout !== undefined && timeout > 0 ? timeout * 1000 : undefined;\n\t\t\t// The engine's own soft deadline must fire and emit its cooperative exit-124 frame (which\n\t\t\t// preserves partial output) BEFORE the hard tree-kill backstop below, or the hard kill\n\t\t\t// always wins the race and the soft path never gets to run. Give it a head start; the hard\n\t\t\t// kill still bounds a hung engine that never reads its own deadline.\n\t\t\tconst requestTimeoutMs = timeoutMs !== undefined ? Math.max(timeoutMs - 500, 500) : undefined;\n\n\t\t\tconst request = {\n\t\t\t\tcommand,\n\t\t\t\tcwd: effectiveCwd,\n\t\t\t\tenv: effectiveEnv,\n\t\t\t\t...(requestTimeoutMs !== undefined ? { timeoutMs: requestTimeoutMs } : {}),\n\t\t\t};\n\n\t\t\tconst child = spawn(runtime.pythonPath, [\"-B\", engineScriptPath], {\n\t\t\t\tcwd: effectiveCwd,\n\t\t\t\tenv: {\n\t\t\t\t\t...effectiveEnv,\n\t\t\t\t\tPYTHONDONTWRITEBYTECODE: \"1\",\n\t\t\t\t\tPYTHONIOENCODING: \"utf-8\",\n\t\t\t\t\tPYTHONUNBUFFERED: \"1\",\n\t\t\t\t\tPYTHONUTF8: \"1\",\n\t\t\t\t},\n\t\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t\t});\n\t\t\tif (child.pid) trackDetachedChildPid(child.pid);\n\n\t\t\tlet controlBuffer: Buffer<ArrayBufferLike> = Buffer.alloc(0);\n\t\t\tlet controlOverflow = false;\n\n\t\t\t// Command output is the data stream: forward it immediately and never retain a\n\t\t\t// second full copy merely to find the terminal frame.\n\t\t\tchild.stdout?.on(\"data\", (chunk: Buffer) => {\n\t\t\t\tonData(chunk);\n\t\t\t});\n\t\t\t// stderr is the bounded control stream. The Python engine routes command stderr\n\t\t\t// into stdout, so this channel contains only the terminal frame/diagnostics.\n\t\t\tchild.stderr?.on(\"data\", (chunk: Buffer) => {\n\t\t\t\tif (controlOverflow) return;\n\t\t\t\tif (controlBuffer.length + chunk.length > MAX_CONTROL_FRAME_BYTES) {\n\t\t\t\t\tcontrolOverflow = true;\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tcontrolBuffer = Buffer.concat([controlBuffer, chunk]);\n\t\t\t});\n\n\t\t\ttry {\n\t\t\t\tchild.stdin?.end(JSON.stringify(request), \"utf8\");\n\t\t\t\tconst terminal = await waitForChildProcessWithTermination(child, {\n\t\t\t\t\tsignal,\n\t\t\t\t\ttimeoutMs,\n\t\t\t\t\tkillGraceMs: 2_000,\n\t\t\t\t});\n\t\t\t\tif (signal?.aborted) throw new Error(\"aborted\");\n\n\t\t\t\tconst frame = controlOverflow ? undefined : parseControlFrame(controlBuffer);\n\t\t\t\tif (!frame) {\n\t\t\t\t\tconst capturedOutput = controlOverflow\n\t\t\t\t\t\t? `control frame exceeded ${MAX_CONTROL_FRAME_BYTES} bytes`\n\t\t\t\t\t\t: controlBuffer.toString(\"utf8\");\n\t\t\t\t\tthrow new WindowsShellEngineFailure(\n\t\t\t\t\t\t`Windows shell engine failed (process exit ${terminal.code ?? \"null\"}) without a parseable control frame.\\n${capturedOutput}`,\n\t\t\t\t\t\tcapturedOutput,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tapplyEngineFrame(state, frame);\n\t\t\t\tif (frame.unsupported) throw new Error(frame.unsupported.message);\n\t\t\t\treturn { exitCode: frame.exitCode };\n\t\t\t} finally {\n\t\t\t\tif (child.pid) untrackDetachedChildPid(child.pid);\n\t\t\t}\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"windows-shell-engine.d.ts","sourceRoot":"","sources":["../../../src/core/tools/windows-shell-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMrE,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,EAKN,KAAK,iBAAiB,EACtB,MAAM,0BAA0B,CAAC;AAMlC,uEAAuE;AACvE,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,WAAW,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChF;AAiCD,qBAAa,yBAA0B,SAAQ,KAAK;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,YAAY,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAIlD;CACD;AAsED,MAAM,WAAW,yBAAyB;IACzC,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACrD,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACrD,sFAAsF;IACtF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IACjF,2FAA2F;IAC3F,qBAAqB,CAAC,EAAE,MAAM,MAAM,CAAC;CACrC;AAoSD,+FAA+F;AAC/F,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKlE;AAED,+DAA+D;AAC/D,wBAAgB,kCAAkC,CACjD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,yBAA8B,GACrC,cAAc,CAQhB"}