@caupulican/pi-adaptative 0.81.42 → 0.81.43

package/dist/core/background-tool-task-controller.d.ts

@@ -0,0 +1,88 @@
+import type { BackgroundToolCallContext, BackgroundToolCallHandoff } from "@caupulican/pi-agent-core";
+import type { SessionManager } from "@caupulican/pi-agent-core/node";
+import type { Usage } from "@caupulican/pi-ai";
+import type { ArtifactStore } from "./context/context-artifacts.ts";
+export declare const DEFAULT_BACKGROUND_TOOL_CALL_AFTER_MS = 15000;
+export declare const BACKGROUND_TOOL_TASK_CUSTOM_TYPE = "background_tool_task";
+export type BackgroundToolTaskStatus = "running" | "completed" | "failed" | "canceled";
+export interface BackgroundToolTaskRecord {
+    sessionId: string;
+    taskId: string;
+    toolCallId: string;
+    toolName: string;
+    status: BackgroundToolTaskStatus;
+    startedAt: string;
+    completedAt?: string;
+    elapsedBeforeHandoffMs: number;
+    summary: string;
+    output: string;
+    artifactId?: string;
+    usage?: Usage;
+    cancellationRequested?: boolean;
+}
+export interface BackgroundToolTaskLiveView {
+    taskId: string;
+    toolCallId: string;
+    toolName: string;
+    description: string;
+}
+export interface BackgroundToolTerminalMessage {
+    customType: "background-tool-completion";
+    content: string;
+    display: true;
+    details: {
+        taskId: string;
+        status: BackgroundToolTaskStatus;
+        toolName: string;
+        artifactId?: string;
+    };
+}
+export interface BackgroundToolTaskControllerDeps {
+    getSessionId(): string;
+    getArtifactStore(): ArtifactStore | undefined;
+    /** Durable task records on the active branch, newest first, without rebuilding full model context. */
+    loadPersistedRecordsNewestFirst?(): readonly unknown[];
+    persist(record: BackgroundToolTaskRecord): void;
+    notifyTerminal(record: BackgroundToolTaskRecord, options: {
+        wakeParent: boolean;
+    }): Promise<void> | void;
+    onLiveTasksChanged?(tasks: readonly BackgroundToolTaskLiveView[]): void;
+    recordUsage?(taskId: string, usage: Usage): void;
+    onError?(message: string, error: unknown): void;
+    now?(): Date;
+}
+/** Read only task records on the active branch without allocating or hydrating the full branch context. */
+export declare function loadBackgroundToolTaskRecordsNewestFirst(sessionManager: Pick<SessionManager, "getLatestCustomEntryOnBranch">): unknown[];
+export declare function createBackgroundToolTerminalMessage(record: BackgroundToolTaskRecord): BackgroundToolTerminalMessage;
+/**
+ * Session-owned registry for foreground tool calls transferred into background execution.
+ * It emits edge records for durability and a replace-style live-task signal for UI consumers.
+ */
+export declare class BackgroundToolTaskController {
+    private readonly deps;
+    private readonly tasks;
+    private readonly handoffRequests;
+    private readonly pendingNotifications;
+    private nextTaskId;
+    private disposed;
+    constructor(deps: BackgroundToolTaskControllerDeps);
+    handoff(context: BackgroundToolCallContext): BackgroundToolCallHandoff | undefined;
+    list(): BackgroundToolTaskRecord[];
+    wait(taskId: string, signal?: AbortSignal): Promise<BackgroundToolTaskRecord>;
+    cancel(taskId: string): boolean;
+    subscribeHandoffRequest(toolCallId: string, request: () => void): () => void;
+    requestHandoff(toolCallId?: string): number;
+    waitForNotifications(): Promise<void>;
+    shutdown(): Promise<void>;
+    private settle;
+    private settleRejected;
+    private restorePersistedTasks;
+    private createState;
+    private finishState;
+    private persist;
+    private notify;
+    private emitLiveTasks;
+    private pruneTerminalTasks;
+    private now;
+}
+//# sourceMappingURL=background-tool-task-controller.d.ts.map

package/dist/core/background-tool-task-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-tool-task-controller.d.ts","sourceRoot":"","sources":["../../src/core/background-tool-task-controller.ts"],"names":[],"mappings":"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"}

package/dist/core/background-tool-task-controller.js

@@ -0,0 +1,470 @@
+import { formatArtifactNotice, packToolOutput } from "./context/tool-output-packer.js";
+import { hasOnlyKeys, isPlainRecord } from "./util/value-guards.js";
+export const DEFAULT_BACKGROUND_TOOL_CALL_AFTER_MS = 15_000;
+export const BACKGROUND_TOOL_TASK_CUSTOM_TYPE = "background_tool_task";
+const MAX_RETAINED_TERMINAL_TASKS = 64;
+const MAX_INLINE_OUTPUT_BYTES = 32 * 1024;
+const MAX_INLINE_OUTPUT_LINES = 400;
+const MAX_SUMMARY_CHARS = 200;
+const TASK_ID_PATTERN = /^tool-task-([1-9]\d*)$/;
+const RECORD_KEYS = [
+    "sessionId",
+    "taskId",
+    "toolCallId",
+    "toolName",
+    "status",
+    "startedAt",
+    "completedAt",
+    "elapsedBeforeHandoffMs",
+    "summary",
+    "output",
+    "artifactId",
+    "usage",
+    "cancellationRequested",
+];
+/** Read only task records on the active branch without allocating or hydrating the full branch context. */
+export function loadBackgroundToolTaskRecordsNewestFirst(sessionManager) {
+    const records = [];
+    let fromId;
+    for (;;) {
+        const entry = sessionManager.getLatestCustomEntryOnBranch(BACKGROUND_TOOL_TASK_CUSTOM_TYPE, fromId);
+        if (!entry)
+            return records;
+        records.push(entry.data);
+        if (entry.parentId === null)
+            return records;
+        fromId = entry.parentId;
+    }
+}
+export function createBackgroundToolTerminalMessage(record) {
+    return {
+        customType: "background-tool-completion",
+        content: [
+            "Background tool terminal handoff:",
+            `- ${record.taskId}: ${record.status} (tool=${record.toolName})`,
+            "This terminal event woke the owning session. Retrieve the result once with tool_task action=wait if it is needed; never poll.",
+        ].join("\n"),
+        display: true,
+        details: {
+            taskId: record.taskId,
+            status: record.status,
+            toolName: record.toolName,
+            ...(record.artifactId ? { artifactId: record.artifactId } : {}),
+        },
+    };
+}
+function renderCompletionOutput(completion) {
+    const blocks = completion.result.content.map((block) => block.type === "text" ? block.text : "[Image output retained outside the foreground transcript]");
+    return blocks.join("\n") || "Tool completed without text output.";
+}
+function oneLine(value) {
+    return value
+        .replace(/[\r\n]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function summaryFor(status, toolName, output) {
+    const prefix = `${toolName} ${status}`;
+    const firstLine = oneLine(output);
+    if (!firstLine)
+        return prefix;
+    const remaining = Math.max(0, MAX_SUMMARY_CHARS - prefix.length - 2);
+    return `${prefix}: ${firstLine.slice(0, remaining)}`;
+}
+function taskNumber(taskId) {
+    const match = TASK_ID_PATTERN.exec(taskId);
+    if (!match)
+        return undefined;
+    const value = Number(match[1]);
+    return Number.isSafeInteger(value) && value > 0 ? value : undefined;
+}
+function cloneUsage(value) {
+    if (!isPlainRecord(value))
+        return undefined;
+    const cost = value.cost;
+    if (!isPlainRecord(cost))
+        return undefined;
+    const fields = ["input", "output", "cacheRead", "cacheWrite", "totalTokens"];
+    const costFields = ["input", "output", "cacheRead", "cacheWrite", "total"];
+    if (fields.some((field) => typeof value[field] !== "number" || !Number.isFinite(value[field])) ||
+        costFields.some((field) => typeof cost[field] !== "number" || !Number.isFinite(cost[field]))) {
+        return undefined;
+    }
+    return {
+        input: value.input,
+        output: value.output,
+        cacheRead: value.cacheRead,
+        cacheWrite: value.cacheWrite,
+        totalTokens: value.totalTokens,
+        cost: {
+            input: cost.input,
+            output: cost.output,
+            cacheRead: cost.cacheRead,
+            cacheWrite: cost.cacheWrite,
+            total: cost.total,
+        },
+    };
+}
+function decodeRecord(value, sessionId) {
+    if (!isPlainRecord(value) || !hasOnlyKeys(value, RECORD_KEYS))
+        return undefined;
+    if (value.sessionId !== sessionId ||
+        typeof value.taskId !== "string" ||
+        taskNumber(value.taskId) === undefined ||
+        typeof value.toolCallId !== "string" ||
+        value.toolCallId.length === 0 ||
+        typeof value.toolName !== "string" ||
+        value.toolName.length === 0 ||
+        (value.status !== "running" &&
+            value.status !== "completed" &&
+            value.status !== "failed" &&
+            value.status !== "canceled") ||
+        typeof value.startedAt !== "string" ||
+        !Number.isFinite(Date.parse(value.startedAt)) ||
+        (value.completedAt !== undefined &&
+            (typeof value.completedAt !== "string" || !Number.isFinite(Date.parse(value.completedAt)))) ||
+        (value.status !== "running" && value.completedAt === undefined) ||
+        typeof value.elapsedBeforeHandoffMs !== "number" ||
+        !Number.isFinite(value.elapsedBeforeHandoffMs) ||
+        value.elapsedBeforeHandoffMs < 0 ||
+        typeof value.summary !== "string" ||
+        typeof value.output !== "string" ||
+        (value.artifactId !== undefined &&
+            (typeof value.artifactId !== "string" || !/^[0-9a-f]{1,64}$/.test(value.artifactId))) ||
+        (value.cancellationRequested !== undefined && typeof value.cancellationRequested !== "boolean")) {
+        return undefined;
+    }
+    const usage = value.usage === undefined ? undefined : cloneUsage(value.usage);
+    if (value.usage !== undefined && !usage)
+        return undefined;
+    return {
+        sessionId,
+        taskId: value.taskId,
+        toolCallId: value.toolCallId,
+        toolName: value.toolName,
+        status: value.status,
+        startedAt: value.startedAt,
+        ...(value.completedAt ? { completedAt: value.completedAt } : {}),
+        elapsedBeforeHandoffMs: value.elapsedBeforeHandoffMs,
+        summary: value.summary,
+        output: value.output,
+        ...(value.artifactId ? { artifactId: value.artifactId } : {}),
+        ...(usage ? { usage } : {}),
+        ...(value.cancellationRequested !== undefined ? { cancellationRequested: value.cancellationRequested } : {}),
+    };
+}
+/**
+ * Session-owned registry for foreground tool calls transferred into background execution.
+ * It emits edge records for durability and a replace-style live-task signal for UI consumers.
+ */
+export class BackgroundToolTaskController {
+    constructor(deps) {
+        this.tasks = new Map();
+        this.handoffRequests = new Map();
+        this.pendingNotifications = new Set();
+        this.nextTaskId = 1;
+        this.disposed = false;
+        this.deps = deps;
+        this.restorePersistedTasks();
+    }
+    handoff(context) {
+        if (this.disposed || context.toolCall.name === "tool_task")
+            return undefined;
+        const sessionId = this.deps.getSessionId();
+        const taskId = `tool-task-${this.nextTaskId++}`;
+        const startedAt = this.now().toISOString();
+        const record = {
+            sessionId,
+            taskId,
+            toolCallId: context.toolCall.id,
+            toolName: context.toolCall.name,
+            status: "running",
+            startedAt,
+            elapsedBeforeHandoffMs: context.elapsedMs,
+            summary: `${context.toolCall.name} running in the background`,
+            output: "",
+        };
+        const state = this.createState(record, context.cancel);
+        this.tasks.set(taskId, state);
+        if (!this.persist(record)) {
+            this.tasks.delete(taskId);
+            return undefined;
+        }
+        this.emitLiveTasks();
+        context.completion.then((completion) => this.settle(state, completion), (error) => this.settleRejected(state, error));
+        return {
+            result: {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            `Tool ${context.toolCall.name} exceeded ${Math.max(1, Math.round(context.elapsedMs / 1000))}s and continues as session task ${taskId}.`,
+                            "Continue independent work. If its result is a dependency, call tool_task once with action=wait and this taskId; the wait is event-driven. Never poll.",
+                        ].join("\n"),
+                    },
+                ],
+                details: { sessionId, taskId, status: "running" },
+            },
+        };
+    }
+    list() {
+        return [...this.tasks.values()].map((state) => ({ ...state.record }));
+    }
+    wait(taskId, signal) {
+        const state = this.tasks.get(taskId);
+        if (!state)
+            return Promise.reject(new Error(`Unknown background tool task: ${taskId}`));
+        if (state.record.status !== "running")
+            return Promise.resolve({ ...state.record });
+        state.waitingConsumers++;
+        let waiting = true;
+        const releaseWaiter = () => {
+            if (!waiting)
+                return;
+            waiting = false;
+            state.waitingConsumers--;
+        };
+        if (!signal) {
+            return state.terminal.then((record) => {
+                releaseWaiter();
+                return { ...record };
+            });
+        }
+        if (signal.aborted) {
+            releaseWaiter();
+            return Promise.reject(signal.reason ?? new Error("Operation aborted"));
+        }
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                signal.removeEventListener("abort", onAbort);
+                releaseWaiter();
+                reject(signal.reason ?? new Error("Operation aborted"));
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+            state.terminal.then((record) => {
+                signal.removeEventListener("abort", onAbort);
+                releaseWaiter();
+                resolve({ ...record });
+            });
+        });
+    }
+    cancel(taskId) {
+        const state = this.tasks.get(taskId);
+        if (!state || state.record.status !== "running")
+            return false;
+        state.cancellationRequested = true;
+        state.record = { ...state.record, cancellationRequested: true };
+        try {
+            state.cancel();
+        }
+        catch (error) {
+            this.deps.onError?.(`Failed to cancel background tool task ${taskId}`, error);
+        }
+        return true;
+    }
+    subscribeHandoffRequest(toolCallId, request) {
+        if (this.disposed)
+            return () => { };
+        const requests = this.handoffRequests.get(toolCallId) ?? new Set();
+        requests.add(request);
+        this.handoffRequests.set(toolCallId, requests);
+        return () => {
+            requests.delete(request);
+            if (requests.size === 0)
+                this.handoffRequests.delete(toolCallId);
+        };
+    }
+    requestHandoff(toolCallId) {
+        if (this.disposed)
+            return 0;
+        const requested = toolCallId
+            ? [...(this.handoffRequests.get(toolCallId) ?? [])]
+            : [...this.handoffRequests.values()].flatMap((requests) => [...requests]);
+        for (const request of requested)
+            request();
+        return requested.length;
+    }
+    async waitForNotifications() {
+        await Promise.allSettled([...this.pendingNotifications]);
+    }
+    async shutdown() {
+        if (!this.disposed) {
+            this.disposed = true;
+            this.handoffRequests.clear();
+            for (const state of this.tasks.values()) {
+                if (state.record.status !== "running")
+                    continue;
+                state.cancellationRequested = true;
+                try {
+                    state.cancel();
+                }
+                catch (error) {
+                    this.deps.onError?.(`Failed to cancel background tool task ${state.record.taskId}`, error);
+                }
+                this.finishState(state, "canceled", "Session ended before the background tool completed.", undefined, false);
+            }
+        }
+        await this.waitForNotifications();
+    }
+    settle(state, completion) {
+        if (state.record.status !== "running")
+            return;
+        const status = state.cancellationRequested ? "canceled" : completion.isError ? "failed" : "completed";
+        const output = renderCompletionOutput(completion);
+        this.finishState(state, status, output, completion.result.usage, true);
+    }
+    settleRejected(state, error) {
+        if (state.record.status !== "running")
+            return;
+        const status = state.cancellationRequested ? "canceled" : "failed";
+        const output = error instanceof Error ? error.message : String(error);
+        this.finishState(state, status, output, undefined, true);
+    }
+    restorePersistedTasks() {
+        const load = this.deps.loadPersistedRecordsNewestFirst;
+        if (!load)
+            return;
+        let values;
+        try {
+            values = load();
+        }
+        catch (error) {
+            this.deps.onError?.("Failed to load persisted background tool tasks", error);
+            return;
+        }
+        const sessionId = this.deps.getSessionId();
+        const seenTaskIds = new Set();
+        const latestRecords = [];
+        let highestTaskNumber = 0;
+        for (const value of values) {
+            if (!isPlainRecord(value) || value.sessionId !== sessionId || typeof value.taskId !== "string")
+                continue;
+            const numericTaskId = taskNumber(value.taskId);
+            if (numericTaskId === undefined)
+                continue;
+            highestTaskNumber = Math.max(highestTaskNumber, numericTaskId);
+            if (seenTaskIds.has(value.taskId))
+                continue;
+            seenTaskIds.add(value.taskId);
+            const record = decodeRecord(value, sessionId);
+            if (record)
+                latestRecords.push(record);
+        }
+        this.nextTaskId = highestTaskNumber + 1;
+        latestRecords.sort((left, right) => taskNumber(left.taskId) - taskNumber(right.taskId));
+        for (const record of latestRecords) {
+            const state = this.createState(record, () => { });
+            this.tasks.set(record.taskId, state);
+            if (record.status !== "running") {
+                state.resolveTerminal(record);
+                continue;
+            }
+            this.finishState(state, "failed", "The session resumed after the owning process ended; the original tool completion is unavailable.", undefined, false);
+        }
+        this.pruneTerminalTasks();
+        this.emitLiveTasks();
+    }
+    createState(record, cancel) {
+        let resolveTerminal;
+        const terminal = new Promise((resolve) => {
+            resolveTerminal = resolve;
+        });
+        return {
+            record: { ...record },
+            cancel,
+            cancellationRequested: record.cancellationRequested ?? false,
+            waitingConsumers: 0,
+            terminal,
+            resolveTerminal: resolveTerminal,
+            artifactHolderId: `background-tool-task:${record.sessionId}:${record.taskId}`,
+        };
+    }
+    finishState(state, status, rawOutput, usage, notify) {
+        const packed = packToolOutput({
+            toolName: state.record.toolName,
+            rawContent: rawOutput,
+            sessionEntryId: state.record.taskId,
+            createdAtTurn: 0,
+            reproducible: false,
+            truncation: { maxBytes: MAX_INLINE_OUTPUT_BYTES, maxLines: MAX_INLINE_OUTPUT_LINES },
+        }, this.deps.getArtifactStore(), state.artifactHolderId);
+        const output = packed.artifactId
+            ? `${packed.content}\n\n[${formatArtifactNotice(packed.artifactId)}]`
+            : packed.content;
+        const record = {
+            ...state.record,
+            status,
+            completedAt: this.now().toISOString(),
+            summary: summaryFor(status, state.record.toolName, output),
+            output,
+            ...(packed.artifactId ? { artifactId: packed.artifactId } : {}),
+            ...(usage ? { usage } : {}),
+            ...(state.cancellationRequested ? { cancellationRequested: true } : {}),
+        };
+        state.record = record;
+        this.persist(record);
+        if (usage)
+            this.deps.recordUsage?.(record.taskId, usage);
+        state.resolveTerminal(record);
+        this.emitLiveTasks();
+        this.pruneTerminalTasks();
+        if (notify)
+            this.notify(record, state.waitingConsumers === 0);
+    }
+    persist(record) {
+        try {
+            this.deps.persist({ ...record });
+            return true;
+        }
+        catch (error) {
+            this.deps.onError?.(`Failed to persist background tool task ${record.taskId}`, error);
+            return false;
+        }
+    }
+    notify(record, wakeParent) {
+        let notification;
+        try {
+            notification = Promise.resolve(this.deps.notifyTerminal({ ...record }, { wakeParent }));
+        }
+        catch (error) {
+            this.deps.onError?.(`Failed to notify terminal background tool task ${record.taskId}`, error);
+            return;
+        }
+        this.pendingNotifications.add(notification);
+        notification.then(() => this.pendingNotifications.delete(notification), (error) => {
+            this.pendingNotifications.delete(notification);
+            this.deps.onError?.(`Failed to notify terminal background tool task ${record.taskId}`, error);
+        });
+    }
+    emitLiveTasks() {
+        const tasks = [...this.tasks.values()]
+            .filter((state) => state.record.status === "running")
+            .map((state) => ({
+            taskId: state.record.taskId,
+            toolCallId: state.record.toolCallId,
+            toolName: state.record.toolName,
+            description: state.record.summary,
+        }));
+        try {
+            this.deps.onLiveTasksChanged?.(tasks);
+        }
+        catch (error) {
+            this.deps.onError?.("Failed to emit background tool task level signal", error);
+        }
+    }
+    pruneTerminalTasks() {
+        const terminal = [...this.tasks.values()].filter((state) => state.record.status !== "running");
+        for (const state of terminal.slice(0, Math.max(0, terminal.length - MAX_RETAINED_TERMINAL_TASKS))) {
+            this.tasks.delete(state.record.taskId);
+            if (!state.record.artifactId)
+                continue;
+            const store = this.deps.getArtifactStore();
+            store?.removeReference(state.record.artifactId, state.artifactHolderId);
+            store?.cleanup();
+        }
+    }
+    now() {
+        return this.deps.now?.() ?? new Date();
+    }
+}
+//# sourceMappingURL=background-tool-task-controller.js.map

package/dist/core/background-tool-task-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-tool-task-controller.js","sourceRoot":"","sources":["../../src/core/background-tool-task-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tBackgroundToolCallCompletion,\n\tBackgroundToolCallContext,\n\tBackgroundToolCallHandoff,\n} from \"@caupulican/pi-agent-core\";\nimport type { SessionManager } from \"@caupulican/pi-agent-core/node\";\nimport type { Usage } from \"@caupulican/pi-ai\";\nimport type { ArtifactStore } from \"./context/context-artifacts.ts\";\nimport { formatArtifactNotice, packToolOutput } from \"./context/tool-output-packer.ts\";\nimport { hasOnlyKeys, isPlainRecord } from \"./util/value-guards.ts\";\n\nexport const DEFAULT_BACKGROUND_TOOL_CALL_AFTER_MS = 15_000;\nexport const BACKGROUND_TOOL_TASK_CUSTOM_TYPE = \"background_tool_task\";\n\nconst MAX_RETAINED_TERMINAL_TASKS = 64;\nconst MAX_INLINE_OUTPUT_BYTES = 32 * 1024;\nconst MAX_INLINE_OUTPUT_LINES = 400;\nconst MAX_SUMMARY_CHARS = 200;\nconst TASK_ID_PATTERN = /^tool-task-([1-9]\\d*)$/;\nconst RECORD_KEYS = [\n\t\"sessionId\",\n\t\"taskId\",\n\t\"toolCallId\",\n\t\"toolName\",\n\t\"status\",\n\t\"startedAt\",\n\t\"completedAt\",\n\t\"elapsedBeforeHandoffMs\",\n\t\"summary\",\n\t\"output\",\n\t\"artifactId\",\n\t\"usage\",\n\t\"cancellationRequested\",\n] as const;\n\nexport type BackgroundToolTaskStatus = \"running\" | \"completed\" | \"failed\" | \"canceled\";\n\nexport interface BackgroundToolTaskRecord {\n\tsessionId: string;\n\ttaskId: string;\n\ttoolCallId: string;\n\ttoolName: string;\n\tstatus: BackgroundToolTaskStatus;\n\tstartedAt: string;\n\tcompletedAt?: string;\n\telapsedBeforeHandoffMs: number;\n\tsummary: string;\n\toutput: string;\n\tartifactId?: string;\n\tusage?: Usage;\n\tcancellationRequested?: boolean;\n}\n\nexport interface BackgroundToolTaskLiveView {\n\ttaskId: string;\n\ttoolCallId: string;\n\ttoolName: string;\n\tdescription: string;\n}\n\nexport interface BackgroundToolTerminalMessage {\n\tcustomType: \"background-tool-completion\";\n\tcontent: string;\n\tdisplay: true;\n\tdetails: {\n\t\ttaskId: string;\n\t\tstatus: BackgroundToolTaskStatus;\n\t\ttoolName: string;\n\t\tartifactId?: string;\n\t};\n}\n\nexport interface BackgroundToolTaskControllerDeps {\n\tgetSessionId(): string;\n\tgetArtifactStore(): ArtifactStore | undefined;\n\t/** Durable task records on the active branch, newest first, without rebuilding full model context. */\n\tloadPersistedRecordsNewestFirst?(): readonly unknown[];\n\tpersist(record: BackgroundToolTaskRecord): void;\n\tnotifyTerminal(record: BackgroundToolTaskRecord, options: { wakeParent: boolean }): Promise<void> | void;\n\tonLiveTasksChanged?(tasks: readonly BackgroundToolTaskLiveView[]): void;\n\trecordUsage?(taskId: string, usage: Usage): void;\n\tonError?(message: string, error: unknown): void;\n\tnow?(): Date;\n}\n\ninterface BackgroundToolTaskState {\n\trecord: BackgroundToolTaskRecord;\n\tcancel: () => void;\n\tcancellationRequested: boolean;\n\twaitingConsumers: number;\n\tterminal: Promise<BackgroundToolTaskRecord>;\n\tresolveTerminal: (record: BackgroundToolTaskRecord) => void;\n\tartifactHolderId: string;\n}\n\n/** Read only task records on the active branch without allocating or hydrating the full branch context. */\nexport function loadBackgroundToolTaskRecordsNewestFirst(\n\tsessionManager: Pick<SessionManager, \"getLatestCustomEntryOnBranch\">,\n): unknown[] {\n\tconst records: unknown[] = [];\n\tlet fromId: string | undefined;\n\tfor (;;) {\n\t\tconst entry = sessionManager.getLatestCustomEntryOnBranch(BACKGROUND_TOOL_TASK_CUSTOM_TYPE, fromId);\n\t\tif (!entry) return records;\n\t\trecords.push(entry.data);\n\t\tif (entry.parentId === null) return records;\n\t\tfromId = entry.parentId;\n\t}\n}\n\nexport function createBackgroundToolTerminalMessage(record: BackgroundToolTaskRecord): BackgroundToolTerminalMessage {\n\treturn {\n\t\tcustomType: \"background-tool-completion\",\n\t\tcontent: [\n\t\t\t\"Background tool terminal handoff:\",\n\t\t\t`- ${record.taskId}: ${record.status} (tool=${record.toolName})`,\n\t\t\t\"This terminal event woke the owning session. Retrieve the result once with tool_task action=wait if it is needed; never poll.\",\n\t\t].join(\"\\n\"),\n\t\tdisplay: true,\n\t\tdetails: {\n\t\t\ttaskId: record.taskId,\n\t\t\tstatus: record.status,\n\t\t\ttoolName: record.toolName,\n\t\t\t...(record.artifactId ? { artifactId: record.artifactId } : {}),\n\t\t},\n\t};\n}\n\nfunction renderCompletionOutput(completion: BackgroundToolCallCompletion): string {\n\tconst blocks = completion.result.content.map((block) =>\n\t\tblock.type === \"text\" ? block.text : \"[Image output retained outside the foreground transcript]\",\n\t);\n\treturn blocks.join(\"\\n\") || \"Tool completed without text output.\";\n}\n\nfunction oneLine(value: string): string {\n\treturn value\n\t\t.replace(/[\\r\\n]+/g, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\nfunction summaryFor(status: BackgroundToolTaskStatus, toolName: string, output: string): string {\n\tconst prefix = `${toolName} ${status}`;\n\tconst firstLine = oneLine(output);\n\tif (!firstLine) return prefix;\n\tconst remaining = Math.max(0, MAX_SUMMARY_CHARS - prefix.length - 2);\n\treturn `${prefix}: ${firstLine.slice(0, remaining)}`;\n}\n\nfunction taskNumber(taskId: string): number | undefined {\n\tconst match = TASK_ID_PATTERN.exec(taskId);\n\tif (!match) return undefined;\n\tconst value = Number(match[1]);\n\treturn Number.isSafeInteger(value) && value > 0 ? value : undefined;\n}\n\nfunction cloneUsage(value: unknown): Usage | undefined {\n\tif (!isPlainRecord(value)) return undefined;\n\tconst cost = value.cost;\n\tif (!isPlainRecord(cost)) return undefined;\n\tconst fields = [\"input\", \"output\", \"cacheRead\", \"cacheWrite\", \"totalTokens\"] as const;\n\tconst costFields = [\"input\", \"output\", \"cacheRead\", \"cacheWrite\", \"total\"] as const;\n\tif (\n\t\tfields.some((field) => typeof value[field] !== \"number\" || !Number.isFinite(value[field])) ||\n\t\tcostFields.some((field) => typeof cost[field] !== \"number\" || !Number.isFinite(cost[field]))\n\t) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\tinput: value.input as number,\n\t\toutput: value.output as number,\n\t\tcacheRead: value.cacheRead as number,\n\t\tcacheWrite: value.cacheWrite as number,\n\t\ttotalTokens: value.totalTokens as number,\n\t\tcost: {\n\t\t\tinput: cost.input as number,\n\t\t\toutput: cost.output as number,\n\t\t\tcacheRead: cost.cacheRead as number,\n\t\t\tcacheWrite: cost.cacheWrite as number,\n\t\t\ttotal: cost.total as number,\n\t\t},\n\t};\n}\n\nfunction decodeRecord(value: unknown, sessionId: string): BackgroundToolTaskRecord | undefined {\n\tif (!isPlainRecord(value) || !hasOnlyKeys(value, RECORD_KEYS)) return undefined;\n\tif (\n\t\tvalue.sessionId !== sessionId ||\n\t\ttypeof value.taskId !== \"string\" ||\n\t\ttaskNumber(value.taskId) === undefined ||\n\t\ttypeof value.toolCallId !== \"string\" ||\n\t\tvalue.toolCallId.length === 0 ||\n\t\ttypeof value.toolName !== \"string\" ||\n\t\tvalue.toolName.length === 0 ||\n\t\t(value.status !== \"running\" &&\n\t\t\tvalue.status !== \"completed\" &&\n\t\t\tvalue.status !== \"failed\" &&\n\t\t\tvalue.status !== \"canceled\") ||\n\t\ttypeof value.startedAt !== \"string\" ||\n\t\t!Number.isFinite(Date.parse(value.startedAt)) ||\n\t\t(value.completedAt !== undefined &&\n\t\t\t(typeof value.completedAt !== \"string\" || !Number.isFinite(Date.parse(value.completedAt)))) ||\n\t\t(value.status !== \"running\" && value.completedAt === undefined) ||\n\t\ttypeof value.elapsedBeforeHandoffMs !== \"number\" ||\n\t\t!Number.isFinite(value.elapsedBeforeHandoffMs) ||\n\t\tvalue.elapsedBeforeHandoffMs < 0 ||\n\t\ttypeof value.summary !== \"string\" ||\n\t\ttypeof value.output !== \"string\" ||\n\t\t(value.artifactId !== undefined &&\n\t\t\t(typeof value.artifactId !== \"string\" || !/^[0-9a-f]{1,64}$/.test(value.artifactId))) ||\n\t\t(value.cancellationRequested !== undefined && typeof value.cancellationRequested !== \"boolean\")\n\t) {\n\t\treturn undefined;\n\t}\n\tconst usage = value.usage === undefined ? undefined : cloneUsage(value.usage);\n\tif (value.usage !== undefined && !usage) return undefined;\n\treturn {\n\t\tsessionId,\n\t\ttaskId: value.taskId,\n\t\ttoolCallId: value.toolCallId,\n\t\ttoolName: value.toolName,\n\t\tstatus: value.status,\n\t\tstartedAt: value.startedAt,\n\t\t...(value.completedAt ? { completedAt: value.completedAt } : {}),\n\t\telapsedBeforeHandoffMs: value.elapsedBeforeHandoffMs,\n\t\tsummary: value.summary,\n\t\toutput: value.output,\n\t\t...(value.artifactId ? { artifactId: value.artifactId } : {}),\n\t\t...(usage ? { usage } : {}),\n\t\t...(value.cancellationRequested !== undefined ? { cancellationRequested: value.cancellationRequested } : {}),\n\t};\n}\n\n/**\n * Session-owned registry for foreground tool calls transferred into background execution.\n * It emits edge records for durability and a replace-style live-task signal for UI consumers.\n */\nexport class BackgroundToolTaskController {\n\tprivate readonly deps: BackgroundToolTaskControllerDeps;\n\tprivate readonly tasks = new Map<string, BackgroundToolTaskState>();\n\tprivate readonly handoffRequests = new Map<string, Set<() => void>>();\n\tprivate readonly pendingNotifications = new Set<Promise<void>>();\n\tprivate nextTaskId = 1;\n\tprivate disposed = false;\n\n\tconstructor(deps: BackgroundToolTaskControllerDeps) {\n\t\tthis.deps = deps;\n\t\tthis.restorePersistedTasks();\n\t}\n\n\thandoff(context: BackgroundToolCallContext): BackgroundToolCallHandoff | undefined {\n\t\tif (this.disposed || context.toolCall.name === \"tool_task\") return undefined;\n\t\tconst sessionId = this.deps.getSessionId();\n\t\tconst taskId = `tool-task-${this.nextTaskId++}`;\n\t\tconst startedAt = this.now().toISOString();\n\t\tconst record: BackgroundToolTaskRecord = {\n\t\t\tsessionId,\n\t\t\ttaskId,\n\t\t\ttoolCallId: context.toolCall.id,\n\t\t\ttoolName: context.toolCall.name,\n\t\t\tstatus: \"running\",\n\t\t\tstartedAt,\n\t\t\telapsedBeforeHandoffMs: context.elapsedMs,\n\t\t\tsummary: `${context.toolCall.name} running in the background`,\n\t\t\toutput: \"\",\n\t\t};\n\t\tconst state = this.createState(record, context.cancel);\n\t\tthis.tasks.set(taskId, state);\n\t\tif (!this.persist(record)) {\n\t\t\tthis.tasks.delete(taskId);\n\t\t\treturn undefined;\n\t\t}\n\t\tthis.emitLiveTasks();\n\t\tcontext.completion.then(\n\t\t\t(completion) => this.settle(state, completion),\n\t\t\t(error) => this.settleRejected(state, error),\n\t\t);\n\n\t\treturn {\n\t\t\tresult: {\n\t\t\t\tcontent: [\n\t\t\t\t\t{\n\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\ttext: [\n\t\t\t\t\t\t\t`Tool ${context.toolCall.name} exceeded ${Math.max(1, Math.round(context.elapsedMs / 1000))}s and continues as session task ${taskId}.`,\n\t\t\t\t\t\t\t\"Continue independent work. If its result is a dependency, call tool_task once with action=wait and this taskId; the wait is event-driven. Never poll.\",\n\t\t\t\t\t\t].join(\"\\n\"),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tdetails: { sessionId, taskId, status: \"running\" as const },\n\t\t\t},\n\t\t};\n\t}\n\n\tlist(): BackgroundToolTaskRecord[] {\n\t\treturn [...this.tasks.values()].map((state) => ({ ...state.record }));\n\t}\n\n\twait(taskId: string, signal?: AbortSignal): Promise<BackgroundToolTaskRecord> {\n\t\tconst state = this.tasks.get(taskId);\n\t\tif (!state) return Promise.reject(new Error(`Unknown background tool task: ${taskId}`));\n\t\tif (state.record.status !== \"running\") return Promise.resolve({ ...state.record });\n\t\tstate.waitingConsumers++;\n\t\tlet waiting = true;\n\t\tconst releaseWaiter = (): void => {\n\t\t\tif (!waiting) return;\n\t\t\twaiting = false;\n\t\t\tstate.waitingConsumers--;\n\t\t};\n\t\tif (!signal) {\n\t\t\treturn state.terminal.then((record) => {\n\t\t\t\treleaseWaiter();\n\t\t\t\treturn { ...record };\n\t\t\t});\n\t\t}\n\t\tif (signal.aborted) {\n\t\t\treleaseWaiter();\n\t\t\treturn Promise.reject(signal.reason ?? new Error(\"Operation aborted\"));\n\t\t}\n\t\treturn new Promise<BackgroundToolTaskRecord>((resolve, reject) => {\n\t\t\tconst onAbort = (): void => {\n\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\n\t\t\t\treleaseWaiter();\n\t\t\t\treject(signal.reason ?? new Error(\"Operation aborted\"));\n\t\t\t};\n\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\tstate.terminal.then((record) => {\n\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\n\t\t\t\treleaseWaiter();\n\t\t\t\tresolve({ ...record });\n\t\t\t});\n\t\t});\n\t}\n\n\tcancel(taskId: string): boolean {\n\t\tconst state = this.tasks.get(taskId);\n\t\tif (!state || state.record.status !== \"running\") return false;\n\t\tstate.cancellationRequested = true;\n\t\tstate.record = { ...state.record, cancellationRequested: true };\n\t\ttry {\n\t\t\tstate.cancel();\n\t\t} catch (error) {\n\t\t\tthis.deps.onError?.(`Failed to cancel background tool task ${taskId}`, error);\n\t\t}\n\t\treturn true;\n\t}\n\n\tsubscribeHandoffRequest(toolCallId: string, request: () => void): () => void {\n\t\tif (this.disposed) return () => {};\n\t\tconst requests = this.handoffRequests.get(toolCallId) ?? new Set<() => void>();\n\t\trequests.add(request);\n\t\tthis.handoffRequests.set(toolCallId, requests);\n\t\treturn () => {\n\t\t\trequests.delete(request);\n\t\t\tif (requests.size === 0) this.handoffRequests.delete(toolCallId);\n\t\t};\n\t}\n\n\trequestHandoff(toolCallId?: string): number {\n\t\tif (this.disposed) return 0;\n\t\tconst requested = toolCallId\n\t\t\t? [...(this.handoffRequests.get(toolCallId) ?? [])]\n\t\t\t: [...this.handoffRequests.values()].flatMap((requests) => [...requests]);\n\t\tfor (const request of requested) request();\n\t\treturn requested.length;\n\t}\n\n\tasync waitForNotifications(): Promise<void> {\n\t\tawait Promise.allSettled([...this.pendingNotifications]);\n\t}\n\n\tasync shutdown(): Promise<void> {\n\t\tif (!this.disposed) {\n\t\t\tthis.disposed = true;\n\t\t\tthis.handoffRequests.clear();\n\t\t\tfor (const state of this.tasks.values()) {\n\t\t\t\tif (state.record.status !== \"running\") continue;\n\t\t\t\tstate.cancellationRequested = true;\n\t\t\t\ttry {\n\t\t\t\t\tstate.cancel();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.deps.onError?.(`Failed to cancel background tool task ${state.record.taskId}`, error);\n\t\t\t\t}\n\t\t\t\tthis.finishState(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"canceled\",\n\t\t\t\t\t\"Session ended before the background tool completed.\",\n\t\t\t\t\tundefined,\n\t\t\t\t\tfalse,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tawait this.waitForNotifications();\n\t}\n\n\tprivate settle(state: BackgroundToolTaskState, completion: BackgroundToolCallCompletion): void {\n\t\tif (state.record.status !== \"running\") return;\n\t\tconst status = state.cancellationRequested ? \"canceled\" : completion.isError ? \"failed\" : \"completed\";\n\t\tconst output = renderCompletionOutput(completion);\n\t\tthis.finishState(state, status, output, completion.result.usage, true);\n\t}\n\n\tprivate settleRejected(state: BackgroundToolTaskState, error: unknown): void {\n\t\tif (state.record.status !== \"running\") return;\n\t\tconst status = state.cancellationRequested ? \"canceled\" : \"failed\";\n\t\tconst output = error instanceof Error ? error.message : String(error);\n\t\tthis.finishState(state, status, output, undefined, true);\n\t}\n\n\tprivate restorePersistedTasks(): void {\n\t\tconst load = this.deps.loadPersistedRecordsNewestFirst;\n\t\tif (!load) return;\n\t\tlet values: readonly unknown[];\n\t\ttry {\n\t\t\tvalues = load();\n\t\t} catch (error) {\n\t\t\tthis.deps.onError?.(\"Failed to load persisted background tool tasks\", error);\n\t\t\treturn;\n\t\t}\n\t\tconst sessionId = this.deps.getSessionId();\n\t\tconst seenTaskIds = new Set<string>();\n\t\tconst latestRecords: BackgroundToolTaskRecord[] = [];\n\t\tlet highestTaskNumber = 0;\n\t\tfor (const value of values) {\n\t\t\tif (!isPlainRecord(value) || value.sessionId !== sessionId || typeof value.taskId !== \"string\") continue;\n\t\t\tconst numericTaskId = taskNumber(value.taskId);\n\t\t\tif (numericTaskId === undefined) continue;\n\t\t\thighestTaskNumber = Math.max(highestTaskNumber, numericTaskId);\n\t\t\tif (seenTaskIds.has(value.taskId)) continue;\n\t\t\tseenTaskIds.add(value.taskId);\n\t\t\tconst record = decodeRecord(value, sessionId);\n\t\t\tif (record) latestRecords.push(record);\n\t\t}\n\t\tthis.nextTaskId = highestTaskNumber + 1;\n\t\tlatestRecords.sort((left, right) => taskNumber(left.taskId)! - taskNumber(right.taskId)!);\n\t\tfor (const record of latestRecords) {\n\t\t\tconst state = this.createState(record, () => {});\n\t\t\tthis.tasks.set(record.taskId, state);\n\t\t\tif (record.status !== \"running\") {\n\t\t\t\tstate.resolveTerminal(record);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tthis.finishState(\n\t\t\t\tstate,\n\t\t\t\t\"failed\",\n\t\t\t\t\"The session resumed after the owning process ended; the original tool completion is unavailable.\",\n\t\t\t\tundefined,\n\t\t\t\tfalse,\n\t\t\t);\n\t\t}\n\t\tthis.pruneTerminalTasks();\n\t\tthis.emitLiveTasks();\n\t}\n\n\tprivate createState(record: BackgroundToolTaskRecord, cancel: () => void): BackgroundToolTaskState {\n\t\tlet resolveTerminal: ((terminalRecord: BackgroundToolTaskRecord) => void) | undefined;\n\t\tconst terminal = new Promise<BackgroundToolTaskRecord>((resolve) => {\n\t\t\tresolveTerminal = resolve;\n\t\t});\n\t\treturn {\n\t\t\trecord: { ...record },\n\t\t\tcancel,\n\t\t\tcancellationRequested: record.cancellationRequested ?? false,\n\t\t\twaitingConsumers: 0,\n\t\t\tterminal,\n\t\t\tresolveTerminal: resolveTerminal!,\n\t\t\tartifactHolderId: `background-tool-task:${record.sessionId}:${record.taskId}`,\n\t\t};\n\t}\n\n\tprivate finishState(\n\t\tstate: BackgroundToolTaskState,\n\t\tstatus: Exclude<BackgroundToolTaskStatus, \"running\">,\n\t\trawOutput: string,\n\t\tusage: Usage | undefined,\n\t\tnotify: boolean,\n\t): void {\n\t\tconst packed = packToolOutput(\n\t\t\t{\n\t\t\t\ttoolName: state.record.toolName,\n\t\t\t\trawContent: rawOutput,\n\t\t\t\tsessionEntryId: state.record.taskId,\n\t\t\t\tcreatedAtTurn: 0,\n\t\t\t\treproducible: false,\n\t\t\t\ttruncation: { maxBytes: MAX_INLINE_OUTPUT_BYTES, maxLines: MAX_INLINE_OUTPUT_LINES },\n\t\t\t},\n\t\t\tthis.deps.getArtifactStore(),\n\t\t\tstate.artifactHolderId,\n\t\t);\n\t\tconst output = packed.artifactId\n\t\t\t? `${packed.content}\\n\\n[${formatArtifactNotice(packed.artifactId)}]`\n\t\t\t: packed.content;\n\t\tconst record: BackgroundToolTaskRecord = {\n\t\t\t...state.record,\n\t\t\tstatus,\n\t\t\tcompletedAt: this.now().toISOString(),\n\t\t\tsummary: summaryFor(status, state.record.toolName, output),\n\t\t\toutput,\n\t\t\t...(packed.artifactId ? { artifactId: packed.artifactId } : {}),\n\t\t\t...(usage ? { usage } : {}),\n\t\t\t...(state.cancellationRequested ? { cancellationRequested: true } : {}),\n\t\t};\n\t\tstate.record = record;\n\t\tthis.persist(record);\n\t\tif (usage) this.deps.recordUsage?.(record.taskId, usage);\n\t\tstate.resolveTerminal(record);\n\t\tthis.emitLiveTasks();\n\t\tthis.pruneTerminalTasks();\n\t\tif (notify) this.notify(record, state.waitingConsumers === 0);\n\t}\n\n\tprivate persist(record: BackgroundToolTaskRecord): boolean {\n\t\ttry {\n\t\t\tthis.deps.persist({ ...record });\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tthis.deps.onError?.(`Failed to persist background tool task ${record.taskId}`, error);\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tprivate notify(record: BackgroundToolTaskRecord, wakeParent: boolean): void {\n\t\tlet notification: Promise<void>;\n\t\ttry {\n\t\t\tnotification = Promise.resolve(this.deps.notifyTerminal({ ...record }, { wakeParent }));\n\t\t} catch (error) {\n\t\t\tthis.deps.onError?.(`Failed to notify terminal background tool task ${record.taskId}`, error);\n\t\t\treturn;\n\t\t}\n\t\tthis.pendingNotifications.add(notification);\n\t\tnotification.then(\n\t\t\t() => this.pendingNotifications.delete(notification),\n\t\t\t(error) => {\n\t\t\t\tthis.pendingNotifications.delete(notification);\n\t\t\t\tthis.deps.onError?.(`Failed to notify terminal background tool task ${record.taskId}`, error);\n\t\t\t},\n\t\t);\n\t}\n\n\tprivate emitLiveTasks(): void {\n\t\tconst tasks = [...this.tasks.values()]\n\t\t\t.filter((state) => state.record.status === \"running\")\n\t\t\t.map((state) => ({\n\t\t\t\ttaskId: state.record.taskId,\n\t\t\t\ttoolCallId: state.record.toolCallId,\n\t\t\t\ttoolName: state.record.toolName,\n\t\t\t\tdescription: state.record.summary,\n\t\t\t}));\n\t\ttry {\n\t\t\tthis.deps.onLiveTasksChanged?.(tasks);\n\t\t} catch (error) {\n\t\t\tthis.deps.onError?.(\"Failed to emit background tool task level signal\", error);\n\t\t}\n\t}\n\n\tprivate pruneTerminalTasks(): void {\n\t\tconst terminal = [...this.tasks.values()].filter((state) => state.record.status !== \"running\");\n\t\tfor (const state of terminal.slice(0, Math.max(0, terminal.length - MAX_RETAINED_TERMINAL_TASKS))) {\n\t\t\tthis.tasks.delete(state.record.taskId);\n\t\t\tif (!state.record.artifactId) continue;\n\t\t\tconst store = this.deps.getArtifactStore();\n\t\t\tstore?.removeReference(state.record.artifactId, state.artifactHolderId);\n\t\t\tstore?.cleanup();\n\t\t}\n\t}\n\n\tprivate now(): Date {\n\t\treturn this.deps.now?.() ?? new Date();\n\t}\n}\n"]}

package/dist/core/bash-execution-controller.d.ts

@@ -33,6 +33,7 @@ export interface BashExecutionOptions {
 export declare class BashExecutionController {
     private _bashAbortControllers;
     private _pendingBashMessages;
+    private readonly shellSessionKey;
     private readonly deps;
     constructor(deps: BashExecutionControllerDeps);
     executeBash(command: string, onChunk?: (chunk: string) => void, options?: BashExecutionOptions): Promise<BashResult>;