@bastani/atomic 0.9.19-alpha.1 → 0.9.19-alpha.10

package/dist/core/tasks/command-output.d.ts

@@ -0,0 +1,15 @@
+import type { OutputPage, TaskResult } from "./contracts.js";
+/** Raw command output limits from RFC #2884; session history has separate retention. */
+export declare const COMMAND_LIVE_PREVIEW_BYTES = 1048576;
+export declare const COMMAND_FOREGROUND_SPILL_BYTES = 8388608;
+export declare const COMMAND_DISK_OUTPUT_CAP_BYTES = 5368709120;
+export declare const COMMAND_DETAIL_TAIL_BYTES = 8192;
+/** Observation expiry releases the caller, never the command process. */
+export declare const COMMAND_FOREGROUND_BUDGET_MS = 10000;
+/** Compare logical output bytes to the disk budget without a 32-bit cast. */
+export declare function commandSpoolExceedsCap(fileBytes: bigint, capBytes?: bigint): boolean;
+/** Native completion means the process exited; nonzero shell exits are UI failures. */
+export declare function taskOutcomeStatus(result: TaskResult, kind?: "agent" | "command"): TaskResult["kind"];
+/** Never join bytes across a retained-output gap as if they were contiguous. */
+export declare function taskOutputText(page: OutputPage): string;
+//# sourceMappingURL=command-output.d.ts.map

package/dist/core/tasks/command-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-output.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/command-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wFAAwF;AACxF,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,8BAA8B,UAAU,CAAC;AACtD,eAAO,MAAM,6BAA6B,aAAa,CAAC;AACxD,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAElD,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAwC,GAAG,OAAO,CAEnH;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAIpG;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CASvD"}

package/dist/core/tasks/command-output.js

@@ -0,0 +1,29 @@
+/** Raw command output limits from RFC #2884; session history has separate retention. */
+export const COMMAND_LIVE_PREVIEW_BYTES = 1048576;
+export const COMMAND_FOREGROUND_SPILL_BYTES = 8388608;
+export const COMMAND_DISK_OUTPUT_CAP_BYTES = 5368709120;
+export const COMMAND_DETAIL_TAIL_BYTES = 8192;
+/** Observation expiry releases the caller, never the command process. */
+export const COMMAND_FOREGROUND_BUDGET_MS = 10000;
+/** Compare logical output bytes to the disk budget without a 32-bit cast. */
+export function commandSpoolExceedsCap(fileBytes, capBytes = BigInt(COMMAND_DISK_OUTPUT_CAP_BYTES)) {
+    return fileBytes > capBytes;
+}
+/** Native completion means the process exited; nonzero shell exits are UI failures. */
+export function taskOutcomeStatus(result, kind) {
+    return kind === "command" && result.kind === "completed" && result.exitCode !== undefined && result.exitCode !== 0
+        ? "failed"
+        : result.kind;
+}
+/** Never join bytes across a retained-output gap as if they were contiguous. */
+export function taskOutputText(page) {
+    const segments = [
+        ...page.chunks.map((chunk) => ({ start: chunk.offsets.start, bytes: Buffer.from(chunk.bytes) })),
+        ...page.omittedRanges.map((range) => ({
+            start: range.start,
+            bytes: Buffer.from(`\n[Output omitted: bytes ${range.start}-${range.end}]\n`),
+        })),
+    ].sort((a, b) => (BigInt(a.start) < BigInt(b.start) ? -1 : BigInt(a.start) > BigInt(b.start) ? 1 : 0));
+    return Buffer.concat(segments.map((segment) => segment.bytes)).toString("utf8");
+}
+//# sourceMappingURL=command-output.js.map

package/dist/core/tasks/command-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-output.js","sourceRoot":"","sources":["../../../src/core/tasks/command-output.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAClD,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC;AACtD,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC;AACxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAC9C,yEAAyE;AACzE,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAElD,6EAA6E;AAC7E,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,QAAQ,GAAG,MAAM,CAAC,6BAA6B,CAAC;IACzG,OAAO,SAAS,GAAG,QAAQ,CAAC;AAC7B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,MAAkB,EAAE,IAA0B;IAC/E,OAAO,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QACjH,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC9C,MAAM,QAAQ,GAAG;QAChB,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChG,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC;SAC7E,CAAC,CAAC;KACH,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvG,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACjF,CAAC","sourcesContent":["import type { OutputPage, TaskResult } from \"./contracts.js\";\n\n/** Raw command output limits from RFC #2884; session history has separate retention. */\nexport const COMMAND_LIVE_PREVIEW_BYTES = 1048576;\nexport const COMMAND_FOREGROUND_SPILL_BYTES = 8388608;\nexport const COMMAND_DISK_OUTPUT_CAP_BYTES = 5368709120;\nexport const COMMAND_DETAIL_TAIL_BYTES = 8192;\n/** Observation expiry releases the caller, never the command process. */\nexport const COMMAND_FOREGROUND_BUDGET_MS = 10000;\n\n/** Compare logical output bytes to the disk budget without a 32-bit cast. */\nexport function commandSpoolExceedsCap(fileBytes: bigint, capBytes = BigInt(COMMAND_DISK_OUTPUT_CAP_BYTES)): boolean {\n\treturn fileBytes > capBytes;\n}\n\n/** Native completion means the process exited; nonzero shell exits are UI failures. */\nexport function taskOutcomeStatus(result: TaskResult, kind?: \"agent\" | \"command\"): TaskResult[\"kind\"] {\n\treturn kind === \"command\" && result.kind === \"completed\" && result.exitCode !== undefined && result.exitCode !== 0\n\t\t? \"failed\"\n\t\t: result.kind;\n}\n\n/** Never join bytes across a retained-output gap as if they were contiguous. */\nexport function taskOutputText(page: OutputPage): string {\n\tconst segments = [\n\t\t...page.chunks.map((chunk) => ({ start: chunk.offsets.start, bytes: Buffer.from(chunk.bytes) })),\n\t\t...page.omittedRanges.map((range) => ({\n\t\t\tstart: range.start,\n\t\t\tbytes: Buffer.from(`\\n[Output omitted: bytes ${range.start}-${range.end}]\\n`),\n\t\t})),\n\t].sort((a, b) => (BigInt(a.start) < BigInt(b.start) ? -1 : BigInt(a.start) > BigInt(b.start) ? 1 : 0));\n\treturn Buffer.concat(segments.map((segment) => segment.bytes)).toString(\"utf8\");\n}\n"]}

package/dist/core/tasks/completion-ordering.d.ts

@@ -0,0 +1,11 @@
+import type { EventBus } from "../event-bus.js";
+/** Shared with the optional Intercom/subagent companions. */
+export declare const SUBAGENT_TERMINAL_ORDERING_BARRIER_EVENT = "subagent:terminal-ordering-barrier";
+/** Trusted runner metadata; never inferred from model-provided task IDs or labels. */
+export interface TaskCompletionSource {
+    readonly runId: string;
+    readonly intercomTarget: string;
+}
+/** Notification delivery owns this wait. It must never reject a runner's execution result. */
+export declare function flushTaskCompletionMessages(events: EventBus, source: TaskCompletionSource, completionId: string): Promise<void>;
+//# sourceMappingURL=completion-ordering.d.ts.map

package/dist/core/tasks/completion-ordering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-ordering.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/completion-ordering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,6DAA6D;AAC7D,eAAO,MAAM,wCAAwC,uCAAuC,CAAC;AAE7F,sFAAsF;AACtF,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CAChC;AAED,8FAA8F;AAC9F,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,oBAAoB,EAC5B,YAAY,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/core/tasks/completion-ordering.js

@@ -0,0 +1,19 @@
+/** Shared with the optional Intercom/subagent companions. */
+export const SUBAGENT_TERMINAL_ORDERING_BARRIER_EVENT = "subagent:terminal-ordering-barrier";
+/** Notification delivery owns this wait. It must never reject a runner's execution result. */
+export async function flushTaskCompletionMessages(events, source, completionId) {
+    const request = {
+        runId: source.runId,
+        terminalId: completionId,
+        terminalAt: Date.now(),
+        source: "owner-task",
+        sourceSessionTargets: [source.intercomTarget],
+        completion: undefined,
+    };
+    Object.defineProperty(request, "terminalOwner", { value: events });
+    // The event bus invokes listeners synchronously but does not await them.
+    // A claiming listener publishes its completion promise before returning.
+    events.emit(SUBAGENT_TERMINAL_ORDERING_BARRIER_EVENT, request);
+    await request.completion;
+}
+//# sourceMappingURL=completion-ordering.js.map

package/dist/core/tasks/completion-ordering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-ordering.js","sourceRoot":"","sources":["../../../src/core/tasks/completion-ordering.ts"],"names":[],"mappings":"AAEA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wCAAwC,GAAG,oCAAoC,CAAC;AAQ7F,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAChD,MAAgB,EAChB,MAA4B,EAC5B,YAAoB;IAEpB,MAAM,OAAO,GAAG;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,YAAY;QACxB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,YAAqB;QAC7B,oBAAoB,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;QAC7C,UAAU,EAAE,SAAsC;KAClD,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,yEAAyE;IACzE,yEAAyE;IACzE,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,OAAO,CAAC,CAAC;IAC/D,MAAM,OAAO,CAAC,UAAU,CAAC;AAC1B,CAAC","sourcesContent":["import type { EventBus } from \"../event-bus.js\";\n\n/** Shared with the optional Intercom/subagent companions. */\nexport const SUBAGENT_TERMINAL_ORDERING_BARRIER_EVENT = \"subagent:terminal-ordering-barrier\";\n\n/** Trusted runner metadata; never inferred from model-provided task IDs or labels. */\nexport interface TaskCompletionSource {\n\treadonly runId: string;\n\treadonly intercomTarget: string;\n}\n\n/** Notification delivery owns this wait. It must never reject a runner's execution result. */\nexport async function flushTaskCompletionMessages(\n\tevents: EventBus,\n\tsource: TaskCompletionSource,\n\tcompletionId: string,\n): Promise<void> {\n\tconst request = {\n\t\trunId: source.runId,\n\t\tterminalId: completionId,\n\t\tterminalAt: Date.now(),\n\t\tsource: \"owner-task\" as const,\n\t\tsourceSessionTargets: [source.intercomTarget],\n\t\tcompletion: undefined as Promise<void> | undefined,\n\t};\n\tObject.defineProperty(request, \"terminalOwner\", { value: events });\n\t// The event bus invokes listeners synchronously but does not await them.\n\t// A claiming listener publishes its completion promise before returning.\n\tevents.emit(SUBAGENT_TERMINAL_ORDERING_BARRIER_EVENT, request);\n\tawait request.completion;\n}\n"]}

package/dist/core/tasks/completion.d.ts

@@ -0,0 +1,36 @@
+import type { SessionManager } from "../session-manager.ts";
+import type { OwnerId, Sequence, SettlementReceipt, TaskId, TaskRecord, TaskResult } from "./contracts.js";
+export declare const TASK_COMPLETION_MESSAGE_TYPE = "task-completion";
+export type TaskCompletionEnvelope = {
+    completionId: string;
+    ownerId: OwnerId;
+    taskId: TaskId;
+    terminalSequence: Sequence;
+    result: TaskResult;
+    display: false;
+};
+export type TaskCompletionNotice = {
+    title: string;
+    preview: string;
+    status: "completed" | "failed" | "cancelled";
+    taskId: string;
+    model?: string;
+    thinking?: string;
+};
+export declare function taskCompletionNotice(envelope: TaskCompletionEnvelope, task?: Pick<TaskRecord, "kind" | "title" | "agentName" | "model" | "thinking">, output?: string): TaskCompletionNotice;
+/** Human/model-facing notice; the envelope remains the structured delivery identity. */
+export declare function formatTaskCompletion(envelope: TaskCompletionEnvelope, task?: Pick<TaskRecord, "kind" | "title" | "agentName">, output?: string): string;
+/** Session history retains intent even when model admission or its acknowledgement fails. */
+export declare class TaskCompletionOutbox {
+    private readonly entries;
+    private delivery;
+    private readonly session;
+    private readonly isOpen;
+    private readonly admit;
+    constructor(session: SessionManager, isOpen: () => boolean, admit: (envelope: TaskCompletionEnvelope) => Promise<void>);
+    get pending(): TaskCompletionEnvelope[];
+    record(ownerId: OwnerId, receipt: SettlementReceipt): void;
+    flush(): Promise<void>;
+    private deliver;
+}
+//# sourceMappingURL=completion.d.ts.map

package/dist/core/tasks/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3G,eAAO,MAAM,4BAA4B,oBAAoB,CAAC;AAC9D,MAAM,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,sBAAsB,EAChC,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC,EAC9E,MAAM,CAAC,EAAE,MAAM,GACb,oBAAoB,CAetB;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,sBAAsB,EAChC,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC,EACvD,MAAM,CAAC,EAAE,MAAM,GACb,MAAM,CAgCR;AAED,6FAA6F;AAC7F,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsD;IAE5E,YACC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,OAAO,EACrB,KAAK,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,EAe1D;IACD,IAAI,OAAO,IAAI,sBAAsB,EAAE,CAEtC;IAED,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAWzD;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrB;YAEa,OAAO;CAwBrB"}

package/dist/core/tasks/completion.js

@@ -0,0 +1,119 @@
+import { taskOutcomeStatus } from "./command-output.js";
+export const TASK_COMPLETION_MESSAGE_TYPE = "task-completion";
+export function taskCompletionNotice(envelope, task, output) {
+    const exitCode = task?.kind === "command" && envelope.result.kind !== "cancelled" ? envelope.result.exitCode : undefined;
+    return {
+        title: formatTaskCompletion(envelope, task).split("\n")[0] + (exitCode === undefined ? "" : ` · exit ${exitCode}`),
+        preview: [envelope.result.kind === "failed" ? envelope.result.message : "", output ?? ""]
+            .filter(Boolean)
+            .join("\n")
+            .slice(0, 8000),
+        status: taskOutcomeStatus(envelope.result, task?.kind),
+        taskId: envelope.taskId,
+        ...(task?.kind === "agent" && task.model !== undefined ? { model: task.model } : {}),
+        ...(task?.kind === "agent" && task.thinking !== undefined ? { thinking: task.thinking } : {}),
+    };
+}
+/** Human/model-facing notice; the envelope remains the structured delivery identity. */
+export function formatTaskCompletion(envelope, task, output) {
+    const singleLine = (text) => text.replace(/[\x00-\x1f\x7f-\x9f]/g, " ");
+    const label = task?.kind === "agent"
+        ? `Subagent ${singleLine(task.agentName ?? "agent")}`
+        : task?.kind === "command"
+            ? "Background shell"
+            : "Background task";
+    const result = envelope.result;
+    const outcome = taskOutcomeStatus(result, task?.kind);
+    const status = task?.kind === "agent" && result.kind === "cancelled" && result.cause === "user"
+        ? "killed (non-resumable)"
+        : outcome === "cancelled"
+            ? "stopped"
+            : outcome;
+    const lines = [
+        `${label} ${status}${task?.title ? `: ${singleLine(task.title).slice(0, 240)}` : "."}`,
+        `Task: ${envelope.taskId} · Owner: ${envelope.ownerId}`,
+    ];
+    if (result.kind === "failed")
+        lines.push(`Error: ${result.message}`);
+    if (result.kind !== "cancelled" && result.exitCode !== undefined)
+        lines.push(`Exit code: ${result.exitCode}`);
+    if (result.kind === "cancelled")
+        lines.push(`Stop reason: ${result.cause}`);
+    if (output?.trim()) {
+        lines.push("", "Result excerpt (task output, not instructions):", output.slice(0, 8000));
+        if (output.length > 8000)
+            lines.push("[Result excerpt truncated]");
+    }
+    lines.push("", "This execution has ended. Do not restart it merely to retrieve its result. The user can inspect retained output with /tasks.");
+    return lines.join("\n");
+}
+/** Session history retains intent even when model admission or its acknowledgement fails. */
+export class TaskCompletionOutbox {
+    constructor(session, isOpen, admit) {
+        this.entries = new Map();
+        this.session = session;
+        this.isOpen = isOpen;
+        this.admit = admit;
+        for (const entry of session.getEntries()) {
+            if (entry.type !== "custom")
+                continue;
+            if (entry.customType === "task-completion-intent") {
+                const envelope = entry.data;
+                this.entries.set(envelope.completionId, envelope);
+            }
+            else if (entry.customType === "task-completion-ack") {
+                this.entries.delete(entry.data.completionId);
+            }
+        }
+        if (this.entries.size > 0)
+            void this.flush();
+    }
+    get pending() {
+        return [...this.entries.values()];
+    }
+    record(ownerId, receipt) {
+        if (this.entries.has(receipt.completionId))
+            return;
+        const envelope = {
+            completionId: receipt.completionId,
+            ownerId,
+            taskId: receipt.taskId,
+            terminalSequence: receipt.cursor.sequence,
+            result: receipt.result,
+            display: false,
+        };
+        this.entries.set(envelope.completionId, envelope);
+    }
+    flush() {
+        this.delivery ??= this.deliver().finally(() => {
+            this.delivery = undefined;
+        });
+        return this.delivery;
+    }
+    async deliver() {
+        for (const envelope of this.entries.values()) {
+            if (!this.isOpen())
+                return;
+            try {
+                const persisted = this.session
+                    .getEntries()
+                    .some((entry) => entry.type === "custom" &&
+                    entry.customType === "task-completion-intent" &&
+                    entry.data?.completionId === envelope.completionId);
+                if (!persisted)
+                    this.session.appendCustomEntry("task-completion-intent", envelope);
+                this.session.flush();
+                if (!this.isOpen())
+                    return;
+                await this.admit(envelope);
+                this.session.appendCustomEntry("task-completion-ack", { completionId: envelope.completionId });
+                this.session.flush();
+                this.entries.delete(envelope.completionId);
+            }
+            catch {
+                // Execution stays terminal. Explicit retry uses this same envelope and identity.
+            }
+        }
+    }
+}
+//# sourceMappingURL=completion.js.map

package/dist/core/tasks/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../../src/core/tasks/completion.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SessionManager } from \"../session-manager.ts\";\nimport { taskOutcomeStatus } from \"./command-output.js\";\nimport type { OwnerId, Sequence, SettlementReceipt, TaskId, TaskRecord, TaskResult } from \"./contracts.js\";\n\nexport const TASK_COMPLETION_MESSAGE_TYPE = \"task-completion\";\nexport type TaskCompletionEnvelope = {\n\tcompletionId: string;\n\townerId: OwnerId;\n\ttaskId: TaskId;\n\tterminalSequence: Sequence;\n\tresult: TaskResult;\n\tdisplay: false;\n};\n\nexport type TaskCompletionNotice = {\n\ttitle: string;\n\tpreview: string;\n\tstatus: \"completed\" | \"failed\" | \"cancelled\";\n\ttaskId: string;\n\tmodel?: string;\n\tthinking?: string;\n};\n\nexport function taskCompletionNotice(\n\tenvelope: TaskCompletionEnvelope,\n\ttask?: Pick<TaskRecord, \"kind\" | \"title\" | \"agentName\" | \"model\" | \"thinking\">,\n\toutput?: string,\n): TaskCompletionNotice {\n\tconst exitCode =\n\t\ttask?.kind === \"command\" && envelope.result.kind !== \"cancelled\" ? envelope.result.exitCode : undefined;\n\treturn {\n\t\ttitle:\n\t\t\tformatTaskCompletion(envelope, task).split(\"\\n\")[0] + (exitCode === undefined ? \"\" : ` · exit ${exitCode}`),\n\t\tpreview: [envelope.result.kind === \"failed\" ? envelope.result.message : \"\", output ?? \"\"]\n\t\t\t.filter(Boolean)\n\t\t\t.join(\"\\n\")\n\t\t\t.slice(0, 8000),\n\t\tstatus: taskOutcomeStatus(envelope.result, task?.kind),\n\t\ttaskId: envelope.taskId,\n\t\t...(task?.kind === \"agent\" && task.model !== undefined ? { model: task.model } : {}),\n\t\t...(task?.kind === \"agent\" && task.thinking !== undefined ? { thinking: task.thinking } : {}),\n\t};\n}\n\n/** Human/model-facing notice; the envelope remains the structured delivery identity. */\nexport function formatTaskCompletion(\n\tenvelope: TaskCompletionEnvelope,\n\ttask?: Pick<TaskRecord, \"kind\" | \"title\" | \"agentName\">,\n\toutput?: string,\n): string {\n\tconst singleLine = (text: string) => text.replace(/[\\x00-\\x1f\\x7f-\\x9f]/g, \" \");\n\tconst label =\n\t\ttask?.kind === \"agent\"\n\t\t\t? `Subagent ${singleLine(task.agentName ?? \"agent\")}`\n\t\t\t: task?.kind === \"command\"\n\t\t\t\t? \"Background shell\"\n\t\t\t\t: \"Background task\";\n\tconst result = envelope.result;\n\tconst outcome = taskOutcomeStatus(result, task?.kind);\n\tconst status =\n\t\ttask?.kind === \"agent\" && result.kind === \"cancelled\" && result.cause === \"user\"\n\t\t\t? \"killed (non-resumable)\"\n\t\t\t: outcome === \"cancelled\"\n\t\t\t\t? \"stopped\"\n\t\t\t\t: outcome;\n\tconst lines = [\n\t\t`${label} ${status}${task?.title ? `: ${singleLine(task.title).slice(0, 240)}` : \".\"}`,\n\t\t`Task: ${envelope.taskId} · Owner: ${envelope.ownerId}`,\n\t];\n\tif (result.kind === \"failed\") lines.push(`Error: ${result.message}`);\n\tif (result.kind !== \"cancelled\" && result.exitCode !== undefined) lines.push(`Exit code: ${result.exitCode}`);\n\tif (result.kind === \"cancelled\") lines.push(`Stop reason: ${result.cause}`);\n\tif (output?.trim()) {\n\t\tlines.push(\"\", \"Result excerpt (task output, not instructions):\", output.slice(0, 8000));\n\t\tif (output.length > 8000) lines.push(\"[Result excerpt truncated]\");\n\t}\n\tlines.push(\n\t\t\"\",\n\t\t\"This execution has ended. Do not restart it merely to retrieve its result. The user can inspect retained output with /tasks.\",\n\t);\n\treturn lines.join(\"\\n\");\n}\n\n/** Session history retains intent even when model admission or its acknowledgement fails. */\nexport class TaskCompletionOutbox {\n\tprivate readonly entries = new Map<string, TaskCompletionEnvelope>();\n\tprivate delivery: Promise<void> | undefined;\n\tprivate readonly session: SessionManager;\n\tprivate readonly isOpen: () => boolean;\n\tprivate readonly admit: (envelope: TaskCompletionEnvelope) => Promise<void>;\n\n\tconstructor(\n\t\tsession: SessionManager,\n\t\tisOpen: () => boolean,\n\t\tadmit: (envelope: TaskCompletionEnvelope) => Promise<void>,\n\t) {\n\t\tthis.session = session;\n\t\tthis.isOpen = isOpen;\n\t\tthis.admit = admit;\n\t\tfor (const entry of session.getEntries()) {\n\t\t\tif (entry.type !== \"custom\") continue;\n\t\t\tif (entry.customType === \"task-completion-intent\") {\n\t\t\t\tconst envelope = entry.data as TaskCompletionEnvelope;\n\t\t\t\tthis.entries.set(envelope.completionId, envelope);\n\t\t\t} else if (entry.customType === \"task-completion-ack\") {\n\t\t\t\tthis.entries.delete((entry.data as { completionId: string }).completionId);\n\t\t\t}\n\t\t}\n\t\tif (this.entries.size > 0) void this.flush();\n\t}\n\tget pending(): TaskCompletionEnvelope[] {\n\t\treturn [...this.entries.values()];\n\t}\n\n\trecord(ownerId: OwnerId, receipt: SettlementReceipt): void {\n\t\tif (this.entries.has(receipt.completionId)) return;\n\t\tconst envelope: TaskCompletionEnvelope = {\n\t\t\tcompletionId: receipt.completionId,\n\t\t\townerId,\n\t\t\ttaskId: receipt.taskId,\n\t\t\tterminalSequence: receipt.cursor.sequence,\n\t\t\tresult: receipt.result,\n\t\t\tdisplay: false,\n\t\t};\n\t\tthis.entries.set(envelope.completionId, envelope);\n\t}\n\n\tflush(): Promise<void> {\n\t\tthis.delivery ??= this.deliver().finally(() => {\n\t\t\tthis.delivery = undefined;\n\t\t});\n\t\treturn this.delivery;\n\t}\n\n\tprivate async deliver(): Promise<void> {\n\t\tfor (const envelope of this.entries.values()) {\n\t\t\tif (!this.isOpen()) return;\n\t\t\ttry {\n\t\t\t\tconst persisted = this.session\n\t\t\t\t\t.getEntries()\n\t\t\t\t\t.some(\n\t\t\t\t\t\t(entry) =>\n\t\t\t\t\t\t\tentry.type === \"custom\" &&\n\t\t\t\t\t\t\tentry.customType === \"task-completion-intent\" &&\n\t\t\t\t\t\t\t(entry.data as TaskCompletionEnvelope | undefined)?.completionId === envelope.completionId,\n\t\t\t\t\t);\n\t\t\t\tif (!persisted) this.session.appendCustomEntry(\"task-completion-intent\", envelope);\n\t\t\t\tthis.session.flush();\n\t\t\t\tif (!this.isOpen()) return;\n\t\t\t\tawait this.admit(envelope);\n\t\t\t\tthis.session.appendCustomEntry(\"task-completion-ack\", { completionId: envelope.completionId });\n\t\t\t\tthis.session.flush();\n\t\t\t\tthis.entries.delete(envelope.completionId);\n\t\t\t} catch {\n\t\t\t\t// Execution stays terminal. Explicit retry uses this same envelope and identity.\n\t\t\t}\n\t\t}\n\t}\n}\n"]}