@earendil-works/pi-agent-core 0.85.1 → 0.86.1

package/dist/harness/pico3/kinds/job.d.ts

@@ -0,0 +1,44 @@
+import type { Kind, KindConfig, ProcessSpec } from "../types.ts";
+export type JobInput = {
+    [K in keyof ProcessSpec]: ProcessSpec[K];
+} & {
+    notify: boolean;
+    rerun: boolean;
+    every?: number;
+    notBefore?: number;
+};
+export type JobCheckpoint = {
+    phase: "waiting";
+    untilMs: number;
+    occurrence: number;
+} | {
+    phase: "spawning";
+    key: string;
+    occurrence: number;
+} | {
+    phase: "running";
+    key: string;
+    occurrence: number;
+};
+export type JobOutput = {
+    stdout?: string;
+    stderr?: string;
+    droppedStdout?: number;
+    droppedStderr?: number;
+    exitCode?: number;
+    occurrence?: number;
+};
+export type JobResult = {
+    exitCode: number;
+    occurrences: number;
+    stdout: string;
+    stderr: string;
+};
+export type JobFailure = {
+    reason: "spawn" | "interrupted";
+    detail: string;
+};
+export declare const job: Readonly<Kind<JobInput, JobCheckpoint, JobResult, JobFailure, {
+    killed: boolean;
+}, object, KindConfig<import("../types.ts").ConfigShape, import("../types.ts").ConfigShape>, JobOutput, import("../types.ts").TaskTx>>;
+//# sourceMappingURL=job.d.ts.map

package/dist/harness/pico3/kinds/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../../../src/harness/pico3/kinds/job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,IAAI,EAAE,UAAU,EAAE,WAAW,EAAsC,MAAM,aAAa,CAAC;AAEjH,MAAM,MAAM,QAAQ,GAAG;KAAG,CAAC,IAAI,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC;CAAE,GAAG;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,aAAa,GACtB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AACzD,MAAM,MAAM,SAAS,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAClG,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA0D7E,eAAO,MAAM,GAAG;;sIAAyB,CAAC","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport type { Completion, Kind, KindConfig, ProcessSpec, ProcessStatus, Runtime, Step, Task } from \"../types.ts\";\n\nexport type JobInput = { [K in keyof ProcessSpec]: ProcessSpec[K] } & {\n\tnotify: boolean;\n\trerun: boolean;\n\tevery?: number;\n\tnotBefore?: number;\n};\nexport type JobCheckpoint =\n\t| { phase: \"waiting\"; untilMs: number; occurrence: number }\n\t| { phase: \"spawning\"; key: string; occurrence: number }\n\t| { phase: \"running\"; key: string; occurrence: number };\nexport type JobOutput = {\n\tstdout?: string;\n\tstderr?: string;\n\tdroppedStdout?: number;\n\tdroppedStderr?: number;\n\texitCode?: number;\n\toccurrence?: number;\n};\nexport type JobResult = { exitCode: number; occurrences: number; stdout: string; stderr: string };\nexport type JobFailure = { reason: \"spawn\" | \"interrupted\"; detail: string };\ntype JobTask = Task<JobInput, JobCheckpoint>;\ntype JobStep = Step<JobCheckpoint, JobResult, JobFailure>;\nconst failed = (reason: JobFailure[\"reason\"], detail: string): Completion<JobResult, JobFailure> => ({\n\tstatus: \"failed\",\n\tfailure: { reason, detail },\n});\nconst notice = (text: string, now: number) => ({\n\tkind: \"pi.notice\",\n\tmodel: [{ role: \"user\" as const, content: text, timestamp: now }],\n});\n\nconst jobKind: Kind<\n\tJobInput,\n\tJobCheckpoint,\n\tJobResult,\n\tJobFailure,\n\t{ killed: boolean },\n\tobject,\n\tKindConfig,\n\tJobOutput\n> = {\n\tname: \"pi.job\",\n\tslot: () => ({}),\n\tdescribe: (task) => ({\n\t\tstage: task.checkpoint?.phase ?? \"starting\",\n\t\t...(task.slot ?? {}),\n\t}),\n\tinflight: [\"spawning\", \"running\"],\n\tphases: {\n\t\tasync waiting(task, runtime, ctx) {\n\t\t\tawait runtime.sleep(task.checkpoint.untilMs, ctx);\n\t\t\treturn spawn(task, task.checkpoint.occurrence, runtime, ctx);\n\t\t},\n\t\tasync spawning(task, runtime, ctx) {\n\t\t\treturn reconcile(task, task.checkpoint, runtime, ctx);\n\t\t},\n\t\tasync running(task, runtime, ctx) {\n\t\t\treturn reconcile(task, task.checkpoint, runtime, ctx);\n\t\t},\n\t},\n\tasync initial(task, runtime, ctx) {\n\t\tif (runtime.processHost === undefined) return { done: () => failed(\"spawn\", \"no process host\") };\n\t\tconst now = runtime.now();\n\t\tconst untilMs = task.input.notBefore ?? now;\n\t\tif (untilMs > now) return { next: { phase: \"waiting\", untilMs, occurrence: 1 } };\n\t\treturn spawn(task, 1, runtime, ctx);\n\t},\n\tasync abort(task, runtime, ctx) {\n\t\tconst checkpoint = task.checkpoint;\n\t\tif (checkpoint === undefined || checkpoint.phase === \"waiting\" || runtime.processHost === undefined)\n\t\t\treturn async () => ({ killed: false });\n\t\tawait runtime.processHost.kill(checkpoint.key, \"SIGTERM\", ctx);\n\t\tawait runtime.sleep(runtime.now() + 5000, ctx);\n\t\tawait runtime.processHost.kill(checkpoint.key, \"SIGKILL\", ctx);\n\t\treturn async () => ({ killed: true });\n\t},\n};\nexport const job = Object.freeze(jobKind);\n\nasync function spawn(task: JobTask, occurrence: number, runtime: Runtime, ctx: Context): Promise<JobStep> {\n\tconst key = `${task.id}:${occurrence}`;\n\tawait runtime.commit((tx) => tx.checkpoint({ phase: \"spawning\", key, occurrence }), ctx);\n\ttry {\n\t\tawait runtime.processHost!.start(key, task.input, ctx);\n\t} catch (error) {\n\t\tif (ctx.abortSignal?.aborted) throw error;\n\t\treturn {\n\t\t\tdone: async (tx, current) => {\n\t\t\t\tif (task.input.notify)\n\t\t\t\t\tawait tx.write(\n\t\t\t\t\t\tcurrent.conversationId,\n\t\t\t\t\t\tnotice(`job ${task.id} failed to start: ${String(error)}`, runtime.now()),\n\t\t\t\t\t);\n\t\t\t\treturn failed(\"spawn\", String(error));\n\t\t\t},\n\t\t};\n\t}\n\tawait runtime.commit((tx) => tx.checkpoint({ phase: \"running\", key, occurrence }), ctx);\n\treturn poll(task, key, occurrence, runtime, ctx);\n}\n\nasync function reconcile(\n\ttask: JobTask,\n\tcheckpoint: Extract<JobCheckpoint, { phase: \"spawning\" | \"running\" }>,\n\truntime: Runtime,\n\tctx: Context,\n): Promise<JobStep> {\n\tif (runtime.processHost === undefined) return { done: () => failed(\"interrupted\", \"no process host after restart\") };\n\tlet status: ProcessStatus;\n\ttry {\n\t\tstatus = await runtime.processHost.status(checkpoint.key, ctx);\n\t} catch (error) {\n\t\treturn { done: () => failed(\"interrupted\", `host status failed: ${String(error)}`) };\n\t}\n\tif (status.status === \"unknown\") {\n\t\tif (!task.input.rerun) return { done: () => failed(\"interrupted\", \"process outcome unknown\") };\n\t\treturn spawn(task, checkpoint.occurrence, runtime, ctx);\n\t}\n\tif (checkpoint.phase === \"spawning\") {\n\t\tawait runtime.commit(\n\t\t\t(tx) => tx.checkpoint({ phase: \"running\", key: checkpoint.key, occurrence: checkpoint.occurrence }),\n\t\t\tctx,\n\t\t);\n\t}\n\treturn poll(task, checkpoint.key, checkpoint.occurrence, runtime, ctx);\n}\n\nasync function poll(task: JobTask, key: string, occurrence: number, runtime: Runtime, ctx: Context): Promise<JobStep> {\n\tfor (let attempt = 0; ; attempt++) {\n\t\tlet status: ProcessStatus;\n\t\ttry {\n\t\t\tstatus = await runtime.processHost!.status(key, ctx);\n\t\t} catch (error) {\n\t\t\treturn { done: () => failed(\"interrupted\", `host status failed: ${String(error)}`) };\n\t\t}\n\t\tif (status.status === \"unknown\") {\n\t\t\tif (!task.input.rerun) return { done: () => failed(\"interrupted\", \"process outcome unknown\") };\n\t\t\treturn spawn(task, occurrence, runtime, ctx);\n\t\t}\n\t\tconst snapshot = status;\n\t\tawait runtime.commit((tx, current) => {\n\t\t\tconst output = tx.slot({ id: current.id, kind: jobKind });\n\t\t\toutput.stdout = snapshot.stdout;\n\t\t\toutput.stderr = snapshot.stderr;\n\t\t\toutput.droppedStdout = snapshot.droppedStdout;\n\t\t\toutput.droppedStderr = snapshot.droppedStderr;\n\t\t\tif (snapshot.status === \"exited\") output.exitCode = snapshot.exitCode;\n\t\t}, ctx);\n\t\tif (snapshot.status === \"exited\") {\n\t\t\tconst { exitCode, stdout, stderr } = snapshot;\n\t\t\tif (task.input.every === undefined) {\n\t\t\t\treturn {\n\t\t\t\t\tdone: async (tx, current) => {\n\t\t\t\t\t\tif (task.input.notify)\n\t\t\t\t\t\t\tawait tx.write(\n\t\t\t\t\t\t\t\tcurrent.conversationId,\n\t\t\t\t\t\t\t\tnotice(`job ${task.id} exited with code ${exitCode}`, runtime.now()),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\treturn { status: \"completed\", result: { exitCode, occurrences: occurrence, stdout, stderr } };\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst untilMs = runtime.now() + task.input.every;\n\t\t\treturn {\n\t\t\t\tnext: async (tx, current) => {\n\t\t\t\t\tif (task.input.notify)\n\t\t\t\t\t\tawait tx.write(\n\t\t\t\t\t\t\tcurrent.conversationId,\n\t\t\t\t\t\t\tnotice(`job ${task.id} occurrence ${occurrence} exited with code ${exitCode}`, runtime.now()),\n\t\t\t\t\t\t);\n\t\t\t\t\tconst output = tx.slot({ id: current.id, kind: jobKind });\n\t\t\t\t\toutput.stdout = \"\";\n\t\t\t\t\toutput.stderr = \"\";\n\t\t\t\t\toutput.droppedStdout = 0;\n\t\t\t\t\toutput.droppedStderr = 0;\n\t\t\t\t\tdelete output.exitCode;\n\t\t\t\t\toutput.occurrence = occurrence + 1;\n\t\t\t\t\treturn { phase: \"waiting\", untilMs, occurrence: occurrence + 1 };\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\tawait runtime.sleep(runtime.now() + Math.min(1000, 100 * 2 ** Math.min(attempt, 4)), ctx);\n\t}\n}\n"]}

package/dist/harness/pico3/kinds/job.js

@@ -0,0 +1,143 @@
+const failed = (reason, detail) => ({
+    status: "failed",
+    failure: { reason, detail },
+});
+const notice = (text, now) => ({
+    kind: "pi.notice",
+    model: [{ role: "user", content: text, timestamp: now }],
+});
+const jobKind = {
+    name: "pi.job",
+    slot: () => ({}),
+    describe: (task) => ({
+        stage: task.checkpoint?.phase ?? "starting",
+        ...(task.slot ?? {}),
+    }),
+    inflight: ["spawning", "running"],
+    phases: {
+        async waiting(task, runtime, ctx) {
+            await runtime.sleep(task.checkpoint.untilMs, ctx);
+            return spawn(task, task.checkpoint.occurrence, runtime, ctx);
+        },
+        async spawning(task, runtime, ctx) {
+            return reconcile(task, task.checkpoint, runtime, ctx);
+        },
+        async running(task, runtime, ctx) {
+            return reconcile(task, task.checkpoint, runtime, ctx);
+        },
+    },
+    async initial(task, runtime, ctx) {
+        if (runtime.processHost === undefined)
+            return { done: () => failed("spawn", "no process host") };
+        const now = runtime.now();
+        const untilMs = task.input.notBefore ?? now;
+        if (untilMs > now)
+            return { next: { phase: "waiting", untilMs, occurrence: 1 } };
+        return spawn(task, 1, runtime, ctx);
+    },
+    async abort(task, runtime, ctx) {
+        const checkpoint = task.checkpoint;
+        if (checkpoint === undefined || checkpoint.phase === "waiting" || runtime.processHost === undefined)
+            return async () => ({ killed: false });
+        await runtime.processHost.kill(checkpoint.key, "SIGTERM", ctx);
+        await runtime.sleep(runtime.now() + 5000, ctx);
+        await runtime.processHost.kill(checkpoint.key, "SIGKILL", ctx);
+        return async () => ({ killed: true });
+    },
+};
+export const job = Object.freeze(jobKind);
+async function spawn(task, occurrence, runtime, ctx) {
+    const key = `${task.id}:${occurrence}`;
+    await runtime.commit((tx) => tx.checkpoint({ phase: "spawning", key, occurrence }), ctx);
+    try {
+        await runtime.processHost.start(key, task.input, ctx);
+    }
+    catch (error) {
+        if (ctx.abortSignal?.aborted)
+            throw error;
+        return {
+            done: async (tx, current) => {
+                if (task.input.notify)
+                    await tx.write(current.conversationId, notice(`job ${task.id} failed to start: ${String(error)}`, runtime.now()));
+                return failed("spawn", String(error));
+            },
+        };
+    }
+    await runtime.commit((tx) => tx.checkpoint({ phase: "running", key, occurrence }), ctx);
+    return poll(task, key, occurrence, runtime, ctx);
+}
+async function reconcile(task, checkpoint, runtime, ctx) {
+    if (runtime.processHost === undefined)
+        return { done: () => failed("interrupted", "no process host after restart") };
+    let status;
+    try {
+        status = await runtime.processHost.status(checkpoint.key, ctx);
+    }
+    catch (error) {
+        return { done: () => failed("interrupted", `host status failed: ${String(error)}`) };
+    }
+    if (status.status === "unknown") {
+        if (!task.input.rerun)
+            return { done: () => failed("interrupted", "process outcome unknown") };
+        return spawn(task, checkpoint.occurrence, runtime, ctx);
+    }
+    if (checkpoint.phase === "spawning") {
+        await runtime.commit((tx) => tx.checkpoint({ phase: "running", key: checkpoint.key, occurrence: checkpoint.occurrence }), ctx);
+    }
+    return poll(task, checkpoint.key, checkpoint.occurrence, runtime, ctx);
+}
+async function poll(task, key, occurrence, runtime, ctx) {
+    for (let attempt = 0;; attempt++) {
+        let status;
+        try {
+            status = await runtime.processHost.status(key, ctx);
+        }
+        catch (error) {
+            return { done: () => failed("interrupted", `host status failed: ${String(error)}`) };
+        }
+        if (status.status === "unknown") {
+            if (!task.input.rerun)
+                return { done: () => failed("interrupted", "process outcome unknown") };
+            return spawn(task, occurrence, runtime, ctx);
+        }
+        const snapshot = status;
+        await runtime.commit((tx, current) => {
+            const output = tx.slot({ id: current.id, kind: jobKind });
+            output.stdout = snapshot.stdout;
+            output.stderr = snapshot.stderr;
+            output.droppedStdout = snapshot.droppedStdout;
+            output.droppedStderr = snapshot.droppedStderr;
+            if (snapshot.status === "exited")
+                output.exitCode = snapshot.exitCode;
+        }, ctx);
+        if (snapshot.status === "exited") {
+            const { exitCode, stdout, stderr } = snapshot;
+            if (task.input.every === undefined) {
+                return {
+                    done: async (tx, current) => {
+                        if (task.input.notify)
+                            await tx.write(current.conversationId, notice(`job ${task.id} exited with code ${exitCode}`, runtime.now()));
+                        return { status: "completed", result: { exitCode, occurrences: occurrence, stdout, stderr } };
+                    },
+                };
+            }
+            const untilMs = runtime.now() + task.input.every;
+            return {
+                next: async (tx, current) => {
+                    if (task.input.notify)
+                        await tx.write(current.conversationId, notice(`job ${task.id} occurrence ${occurrence} exited with code ${exitCode}`, runtime.now()));
+                    const output = tx.slot({ id: current.id, kind: jobKind });
+                    output.stdout = "";
+                    output.stderr = "";
+                    output.droppedStdout = 0;
+                    output.droppedStderr = 0;
+                    delete output.exitCode;
+                    output.occurrence = occurrence + 1;
+                    return { phase: "waiting", untilMs, occurrence: occurrence + 1 };
+                },
+            };
+        }
+        await runtime.sleep(runtime.now() + Math.min(1000, 100 * 2 ** Math.min(attempt, 4)), ctx);
+    }
+}
+//# sourceMappingURL=job.js.map

package/dist/harness/pico3/kinds/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../../../../src/harness/pico3/kinds/job.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport type { Completion, Kind, KindConfig, ProcessSpec, ProcessStatus, Runtime, Step, Task } from \"../types.ts\";\n\nexport type JobInput = { [K in keyof ProcessSpec]: ProcessSpec[K] } & {\n\tnotify: boolean;\n\trerun: boolean;\n\tevery?: number;\n\tnotBefore?: number;\n};\nexport type JobCheckpoint =\n\t| { phase: \"waiting\"; untilMs: number; occurrence: number }\n\t| { phase: \"spawning\"; key: string; occurrence: number }\n\t| { phase: \"running\"; key: string; occurrence: number };\nexport type JobOutput = {\n\tstdout?: string;\n\tstderr?: string;\n\tdroppedStdout?: number;\n\tdroppedStderr?: number;\n\texitCode?: number;\n\toccurrence?: number;\n};\nexport type JobResult = { exitCode: number; occurrences: number; stdout: string; stderr: string };\nexport type JobFailure = { reason: \"spawn\" | \"interrupted\"; detail: string };\ntype JobTask = Task<JobInput, JobCheckpoint>;\ntype JobStep = Step<JobCheckpoint, JobResult, JobFailure>;\nconst failed = (reason: JobFailure[\"reason\"], detail: string): Completion<JobResult, JobFailure> => ({\n\tstatus: \"failed\",\n\tfailure: { reason, detail },\n});\nconst notice = (text: string, now: number) => ({\n\tkind: \"pi.notice\",\n\tmodel: [{ role: \"user\" as const, content: text, timestamp: now }],\n});\n\nconst jobKind: Kind<\n\tJobInput,\n\tJobCheckpoint,\n\tJobResult,\n\tJobFailure,\n\t{ killed: boolean },\n\tobject,\n\tKindConfig,\n\tJobOutput\n> = {\n\tname: \"pi.job\",\n\tslot: () => ({}),\n\tdescribe: (task) => ({\n\t\tstage: task.checkpoint?.phase ?? \"starting\",\n\t\t...(task.slot ?? {}),\n\t}),\n\tinflight: [\"spawning\", \"running\"],\n\tphases: {\n\t\tasync waiting(task, runtime, ctx) {\n\t\t\tawait runtime.sleep(task.checkpoint.untilMs, ctx);\n\t\t\treturn spawn(task, task.checkpoint.occurrence, runtime, ctx);\n\t\t},\n\t\tasync spawning(task, runtime, ctx) {\n\t\t\treturn reconcile(task, task.checkpoint, runtime, ctx);\n\t\t},\n\t\tasync running(task, runtime, ctx) {\n\t\t\treturn reconcile(task, task.checkpoint, runtime, ctx);\n\t\t},\n\t},\n\tasync initial(task, runtime, ctx) {\n\t\tif (runtime.processHost === undefined) return { done: () => failed(\"spawn\", \"no process host\") };\n\t\tconst now = runtime.now();\n\t\tconst untilMs = task.input.notBefore ?? now;\n\t\tif (untilMs > now) return { next: { phase: \"waiting\", untilMs, occurrence: 1 } };\n\t\treturn spawn(task, 1, runtime, ctx);\n\t},\n\tasync abort(task, runtime, ctx) {\n\t\tconst checkpoint = task.checkpoint;\n\t\tif (checkpoint === undefined || checkpoint.phase === \"waiting\" || runtime.processHost === undefined)\n\t\t\treturn async () => ({ killed: false });\n\t\tawait runtime.processHost.kill(checkpoint.key, \"SIGTERM\", ctx);\n\t\tawait runtime.sleep(runtime.now() + 5000, ctx);\n\t\tawait runtime.processHost.kill(checkpoint.key, \"SIGKILL\", ctx);\n\t\treturn async () => ({ killed: true });\n\t},\n};\nexport const job = Object.freeze(jobKind);\n\nasync function spawn(task: JobTask, occurrence: number, runtime: Runtime, ctx: Context): Promise<JobStep> {\n\tconst key = `${task.id}:${occurrence}`;\n\tawait runtime.commit((tx) => tx.checkpoint({ phase: \"spawning\", key, occurrence }), ctx);\n\ttry {\n\t\tawait runtime.processHost!.start(key, task.input, ctx);\n\t} catch (error) {\n\t\tif (ctx.abortSignal?.aborted) throw error;\n\t\treturn {\n\t\t\tdone: async (tx, current) => {\n\t\t\t\tif (task.input.notify)\n\t\t\t\t\tawait tx.write(\n\t\t\t\t\t\tcurrent.conversationId,\n\t\t\t\t\t\tnotice(`job ${task.id} failed to start: ${String(error)}`, runtime.now()),\n\t\t\t\t\t);\n\t\t\t\treturn failed(\"spawn\", String(error));\n\t\t\t},\n\t\t};\n\t}\n\tawait runtime.commit((tx) => tx.checkpoint({ phase: \"running\", key, occurrence }), ctx);\n\treturn poll(task, key, occurrence, runtime, ctx);\n}\n\nasync function reconcile(\n\ttask: JobTask,\n\tcheckpoint: Extract<JobCheckpoint, { phase: \"spawning\" | \"running\" }>,\n\truntime: Runtime,\n\tctx: Context,\n): Promise<JobStep> {\n\tif (runtime.processHost === undefined) return { done: () => failed(\"interrupted\", \"no process host after restart\") };\n\tlet status: ProcessStatus;\n\ttry {\n\t\tstatus = await runtime.processHost.status(checkpoint.key, ctx);\n\t} catch (error) {\n\t\treturn { done: () => failed(\"interrupted\", `host status failed: ${String(error)}`) };\n\t}\n\tif (status.status === \"unknown\") {\n\t\tif (!task.input.rerun) return { done: () => failed(\"interrupted\", \"process outcome unknown\") };\n\t\treturn spawn(task, checkpoint.occurrence, runtime, ctx);\n\t}\n\tif (checkpoint.phase === \"spawning\") {\n\t\tawait runtime.commit(\n\t\t\t(tx) => tx.checkpoint({ phase: \"running\", key: checkpoint.key, occurrence: checkpoint.occurrence }),\n\t\t\tctx,\n\t\t);\n\t}\n\treturn poll(task, checkpoint.key, checkpoint.occurrence, runtime, ctx);\n}\n\nasync function poll(task: JobTask, key: string, occurrence: number, runtime: Runtime, ctx: Context): Promise<JobStep> {\n\tfor (let attempt = 0; ; attempt++) {\n\t\tlet status: ProcessStatus;\n\t\ttry {\n\t\t\tstatus = await runtime.processHost!.status(key, ctx);\n\t\t} catch (error) {\n\t\t\treturn { done: () => failed(\"interrupted\", `host status failed: ${String(error)}`) };\n\t\t}\n\t\tif (status.status === \"unknown\") {\n\t\t\tif (!task.input.rerun) return { done: () => failed(\"interrupted\", \"process outcome unknown\") };\n\t\t\treturn spawn(task, occurrence, runtime, ctx);\n\t\t}\n\t\tconst snapshot = status;\n\t\tawait runtime.commit((tx, current) => {\n\t\t\tconst output = tx.slot({ id: current.id, kind: jobKind });\n\t\t\toutput.stdout = snapshot.stdout;\n\t\t\toutput.stderr = snapshot.stderr;\n\t\t\toutput.droppedStdout = snapshot.droppedStdout;\n\t\t\toutput.droppedStderr = snapshot.droppedStderr;\n\t\t\tif (snapshot.status === \"exited\") output.exitCode = snapshot.exitCode;\n\t\t}, ctx);\n\t\tif (snapshot.status === \"exited\") {\n\t\t\tconst { exitCode, stdout, stderr } = snapshot;\n\t\t\tif (task.input.every === undefined) {\n\t\t\t\treturn {\n\t\t\t\t\tdone: async (tx, current) => {\n\t\t\t\t\t\tif (task.input.notify)\n\t\t\t\t\t\t\tawait tx.write(\n\t\t\t\t\t\t\t\tcurrent.conversationId,\n\t\t\t\t\t\t\t\tnotice(`job ${task.id} exited with code ${exitCode}`, runtime.now()),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\treturn { status: \"completed\", result: { exitCode, occurrences: occurrence, stdout, stderr } };\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst untilMs = runtime.now() + task.input.every;\n\t\t\treturn {\n\t\t\t\tnext: async (tx, current) => {\n\t\t\t\t\tif (task.input.notify)\n\t\t\t\t\t\tawait tx.write(\n\t\t\t\t\t\t\tcurrent.conversationId,\n\t\t\t\t\t\t\tnotice(`job ${task.id} occurrence ${occurrence} exited with code ${exitCode}`, runtime.now()),\n\t\t\t\t\t\t);\n\t\t\t\t\tconst output = tx.slot({ id: current.id, kind: jobKind });\n\t\t\t\t\toutput.stdout = \"\";\n\t\t\t\t\toutput.stderr = \"\";\n\t\t\t\t\toutput.droppedStdout = 0;\n\t\t\t\t\toutput.droppedStderr = 0;\n\t\t\t\t\tdelete output.exitCode;\n\t\t\t\t\toutput.occurrence = occurrence + 1;\n\t\t\t\t\treturn { phase: \"waiting\", untilMs, occurrence: occurrence + 1 };\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\tawait runtime.sleep(runtime.now() + Math.min(1000, 100 * 2 ** Math.min(attempt, 4)), ctx);\n\t}\n}\n"]}

package/dist/harness/pico3/kinds/plugin.d.ts

@@ -0,0 +1,15 @@
+import { type JsonValue, type Kind } from "../types.ts";
+export type PluginInput = {
+    handler: string;
+    input: JsonValue;
+};
+type PluginCheckpoint = {
+    phase: "started";
+};
+type PluginFailure = {
+    reason: "missing_handler" | "threw";
+    detail: string;
+};
+export declare const plugin: Readonly<Kind<PluginInput, PluginCheckpoint, import("@earendil-works/chord").JsonValue, PluginFailure, null, object, import("../types.ts").KindConfig<import("../types.ts").ConfigShape, import("../types.ts").ConfigShape>, import("../types.ts").JsonObject, import("../types.ts").TaskTx>>;
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/harness/pico3/kinds/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/harness/pico3/kinds/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,IAAI,EAAgD,MAAM,aAAa,CAAC;AAGtG,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAChE,KAAK,gBAAgB,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAC7C,KAAK,aAAa,GAAG;IAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAkB7E,eAAO,MAAM,MAAM,+RAA4B,CAAC","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport { type JsonValue, type Kind, type Runtime, type Step, type Task, toStored } from \"../types.ts\";\nimport { taskApi } from \"./task-api.ts\";\n\nexport type PluginInput = { handler: string; input: JsonValue };\ntype PluginCheckpoint = { phase: \"started\" };\ntype PluginFailure = { reason: \"missing_handler\" | \"threw\"; detail: string };\n\nconst pluginKind: Kind<PluginInput, PluginCheckpoint, JsonValue, PluginFailure, null> = {\n\tname: \"pi.plugin\",\n\tinflight: [\"started\"],\n\tphases: {\n\t\tasync started(task, runtime, ctx) {\n\t\t\treturn run(task, runtime, ctx);\n\t\t},\n\t},\n\tasync initial(task, runtime, ctx) {\n\t\tawait runtime.commit((tx) => tx.checkpoint({ phase: \"started\" }), ctx);\n\t\treturn run(task, runtime, ctx);\n\t},\n\tasync abort() {\n\t\treturn async () => null;\n\t},\n};\nexport const plugin = Object.freeze(pluginKind);\n\nasync function run(\n\ttask: Task<PluginInput, PluginCheckpoint>,\n\truntime: Runtime,\n\tctx: Context,\n): Promise<Step<PluginCheckpoint, JsonValue, PluginFailure>> {\n\tconst handler = runtime.plugins.get(task.input.handler);\n\tif (handler === undefined) {\n\t\treturn { done: () => ({ status: \"failed\", failure: { reason: \"missing_handler\", detail: task.input.handler } }) };\n\t}\n\ttry {\n\t\tconst result = toStored(await handler(task.input.input, taskApi(task, runtime), ctx));\n\t\treturn { done: () => ({ status: \"completed\", result }) };\n\t} catch (error) {\n\t\tif (ctx.abortSignal?.aborted) throw error;\n\t\treturn { done: () => ({ status: \"failed\", failure: { reason: \"threw\", detail: String(error) } }) };\n\t}\n}\n"]}

package/dist/harness/pico3/kinds/plugin.js

@@ -0,0 +1,35 @@
+import { toStored } from "../types.js";
+import { taskApi } from "./task-api.js";
+const pluginKind = {
+    name: "pi.plugin",
+    inflight: ["started"],
+    phases: {
+        async started(task, runtime, ctx) {
+            return run(task, runtime, ctx);
+        },
+    },
+    async initial(task, runtime, ctx) {
+        await runtime.commit((tx) => tx.checkpoint({ phase: "started" }), ctx);
+        return run(task, runtime, ctx);
+    },
+    async abort() {
+        return async () => null;
+    },
+};
+export const plugin = Object.freeze(pluginKind);
+async function run(task, runtime, ctx) {
+    const handler = runtime.plugins.get(task.input.handler);
+    if (handler === undefined) {
+        return { done: () => ({ status: "failed", failure: { reason: "missing_handler", detail: task.input.handler } }) };
+    }
+    try {
+        const result = toStored(await handler(task.input.input, taskApi(task, runtime), ctx));
+        return { done: () => ({ status: "completed", result }) };
+    }
+    catch (error) {
+        if (ctx.abortSignal?.aborted)
+            throw error;
+        return { done: () => ({ status: "failed", failure: { reason: "threw", detail: String(error) } }) };
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/harness/pico3/kinds/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../src/harness/pico3/kinds/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAiE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAMxC,MAAM,UAAU,GAAwE;IACvF,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,CAAC,SAAS,CAAC;IACrB,MAAM,EAAE;QACP,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE;YACjC,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAAA,CAC/B;KACD;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE;QACjC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACvE,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAAA,CAC/B;IACD,KAAK,CAAC,KAAK,GAAG;QACb,OAAO,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;IAAA,CACxB;CACD,CAAC;AACF,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAEhD,KAAK,UAAU,GAAG,CACjB,IAAyC,EACzC,OAAgB,EAChB,GAAY,EACgD;IAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IACnH,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACtF,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,GAAG,CAAC,WAAW,EAAE,OAAO;YAAE,MAAM,KAAK,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACpG,CAAC;AAAA,CACD","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport { type JsonValue, type Kind, type Runtime, type Step, type Task, toStored } from \"../types.ts\";\nimport { taskApi } from \"./task-api.ts\";\n\nexport type PluginInput = { handler: string; input: JsonValue };\ntype PluginCheckpoint = { phase: \"started\" };\ntype PluginFailure = { reason: \"missing_handler\" | \"threw\"; detail: string };\n\nconst pluginKind: Kind<PluginInput, PluginCheckpoint, JsonValue, PluginFailure, null> = {\n\tname: \"pi.plugin\",\n\tinflight: [\"started\"],\n\tphases: {\n\t\tasync started(task, runtime, ctx) {\n\t\t\treturn run(task, runtime, ctx);\n\t\t},\n\t},\n\tasync initial(task, runtime, ctx) {\n\t\tawait runtime.commit((tx) => tx.checkpoint({ phase: \"started\" }), ctx);\n\t\treturn run(task, runtime, ctx);\n\t},\n\tasync abort() {\n\t\treturn async () => null;\n\t},\n};\nexport const plugin = Object.freeze(pluginKind);\n\nasync function run(\n\ttask: Task<PluginInput, PluginCheckpoint>,\n\truntime: Runtime,\n\tctx: Context,\n): Promise<Step<PluginCheckpoint, JsonValue, PluginFailure>> {\n\tconst handler = runtime.plugins.get(task.input.handler);\n\tif (handler === undefined) {\n\t\treturn { done: () => ({ status: \"failed\", failure: { reason: \"missing_handler\", detail: task.input.handler } }) };\n\t}\n\ttry {\n\t\tconst result = toStored(await handler(task.input.input, taskApi(task, runtime), ctx));\n\t\treturn { done: () => ({ status: \"completed\", result }) };\n\t} catch (error) {\n\t\tif (ctx.abortSignal?.aborted) throw error;\n\t\treturn { done: () => ({ status: \"failed\", failure: { reason: \"threw\", detail: String(error) } }) };\n\t}\n}\n"]}

package/dist/harness/pico3/kinds/post-tools.d.ts

@@ -0,0 +1,22 @@
+import type { Context } from "@earendil-works/chord";
+import { type CoreKind, type HookInfo, type Id } from "../types.ts";
+export type PostToolsInput = {
+    inputs: Id[];
+    assistant: Id;
+    tools: Id[];
+};
+export type PostToolsResult = {
+    successor?: Id;
+    ended?: "terminate" | "handoff";
+};
+export interface PostToolsHooks {
+    afterTools(assistant: Id, results: Id[], info: HookInfo, ctx: Context): void | Promise<void>;
+}
+export declare const postToolsConfig: {
+    readonly sticky: {
+        readonly steeringMode: "all" | "one-at-a-time";
+        readonly followUpMode: "all" | "one-at-a-time";
+    };
+};
+export declare const postTools: CoreKind<PostToolsInput, never, PostToolsResult, never, null, PostToolsHooks, typeof postToolsConfig>;
+//# sourceMappingURL=post-tools.d.ts.map

package/dist/harness/pico3/kinds/post-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tools.d.ts","sourceRoot":"","sources":["../../../../src/harness/pico3/kinds/post-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,EAAE,EAAyB,MAAM,aAAa,CAAC;AAG3F,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAAC,SAAS,EAAE,EAAE,CAAC;IAAC,KAAK,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG;IAAE,SAAS,CAAC,EAAE,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,CAAC;AAClF,MAAM,WAAW,cAAc;IAC9B,UAAU,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7F;AACD,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX,eAAO,MAAM,SAAS,EAAE,QAAQ,CAC/B,cAAc,EACd,KAAK,EACL,eAAe,EACf,KAAK,EACL,IAAI,EACJ,cAAc,EACd,OAAO,eAAe,CA4ItB,CAAC","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport type { AssistantMessage, ToolCall } from \"@earendil-works/pi-ai\";\nimport { type CoreKind, type HookInfo, type Id, type Stored, toStored } from \"../types.ts\";\nimport type { ToolTaskResult } from \"./tool.ts\";\n\nexport type PostToolsInput = { inputs: Id[]; assistant: Id; tools: Id[] };\nexport type PostToolsResult = { successor?: Id; ended?: \"terminate\" | \"handoff\" };\nexport interface PostToolsHooks {\n\tafterTools(assistant: Id, results: Id[], info: HookInfo, ctx: Context): void | Promise<void>;\n}\nexport const postToolsConfig = {\n\tsticky: {\n\t\tsteeringMode: \"one-at-a-time\" as \"all\" | \"one-at-a-time\",\n\t\tfollowUpMode: \"one-at-a-time\" as \"all\" | \"one-at-a-time\",\n\t},\n} as const;\n\nexport const postTools: CoreKind<\n\tPostToolsInput,\n\tnever,\n\tPostToolsResult,\n\tnever,\n\tnull,\n\tPostToolsHooks,\n\ttypeof postToolsConfig\n> = {\n\tname: \"pi.post_tools\",\n\tturn: true,\n\tconfig: postToolsConfig,\n\tphases: {},\n\n\tasync initial(task, rt, ctx) {\n\t\tconst rows = await rt.commit(async (tx) => {\n\t\t\tconst assistant = await tx.entry(task.input.assistant);\n\t\t\tconst calls = ((assistant?.model?.[0] as Stored<AssistantMessage> | undefined)?.content ?? []).filter(\n\t\t\t\t(content): content is Stored<ToolCall> => content.type === \"toolCall\",\n\t\t\t);\n\t\t\treturn Promise.all(\n\t\t\t\ttask.input.tools.map(async (id, index) => {\n\t\t\t\t\tconst toolTask = (await tx.task(id))!;\n\t\t\t\t\tconst call = calls[index]!;\n\t\t\t\t\tif (toolTask.outcome?.status === \"completed\") {\n\t\t\t\t\t\tconst result = toolTask.outcome.result as ToolTaskResult;\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcall,\n\t\t\t\t\t\t\tentry: result.entry as Id | undefined,\n\t\t\t\t\t\t\tcontrol: result.control,\n\t\t\t\t\t\t\tmissing: undefined as \"orphaned\" | \"aborted\" | undefined,\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\tif (toolTask.outcome?.status === \"aborted\") {\n\t\t\t\t\t\tconst aborted = toolTask.outcome.result as { entry?: Id };\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcall,\n\t\t\t\t\t\t\tentry: aborted.entry,\n\t\t\t\t\t\t\tcontrol: undefined,\n\t\t\t\t\t\t\tmissing: aborted.entry === undefined ? (\"aborted\" as const) : undefined,\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\treturn { call, entry: undefined, control: undefined, missing: \"orphaned\" as const };\n\t\t\t\t}),\n\t\t\t);\n\t\t}, ctx);\n\t\tconst results = rows.map((row) => row.entry).filter((entry): entry is Id => entry !== undefined);\n\t\tawait rt.hooks.each(ctx, (hook, api) => hook.afterTools?.(task.input.assistant, results, api, ctx));\n\n\t\treturn {\n\t\t\tdone: async (tx, current) => {\n\t\t\t\tconst conversationId = current.conversationId;\n\t\t\t\tconst head = await tx.newestEntry(conversationId, { withHead: true });\n\t\t\t\tconst state = tx.rewindable(conversationId);\n\t\t\t\tconst selectedTools = [...state.selectedTools];\n\t\t\t\tlet terminate = false;\n\t\t\t\tlet handoff: string | undefined;\n\t\t\t\tfor (const row of rows) {\n\t\t\t\t\tfor (const name of row.control?.addTools ?? [])\n\t\t\t\t\t\tif (!selectedTools.includes(name)) selectedTools.push(name);\n\t\t\t\t\tif (row.control?.terminate) terminate = true;\n\t\t\t\t\tif (row.control?.handoff !== undefined) handoff = row.control.handoff;\n\t\t\t\t}\n\t\t\t\tif (selectedTools.length !== state.selectedTools.length) {\n\t\t\t\t\tstate.selectedTools = selectedTools;\n\t\t\t\t\ttx.emit({ type: \"config.changed\", keys: [\"selectedTools\"] });\n\t\t\t\t}\n\t\t\t\tfor (const row of rows) {\n\t\t\t\t\tif (row.missing === undefined) continue;\n\t\t\t\t\ttx.appendEntry(conversationId, {\n\t\t\t\t\t\tkind: \"pi.tool_result\",\n\t\t\t\t\t\tmodel: [\n\t\t\t\t\t\t\ttoStored({\n\t\t\t\t\t\t\t\trole: \"toolResult\" as const,\n\t\t\t\t\t\t\t\ttoolCallId: row.call.id,\n\t\t\t\t\t\t\t\ttoolName: row.call.name,\n\t\t\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: `Tool result unavailable: task ${row.missing}.` }],\n\t\t\t\t\t\t\t\tisError: true,\n\t\t\t\t\t\t\t\ttimestamp: rt.now(),\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t],\n\t\t\t\t\t\tdata: { diagnostics: [{ severity: \"error\", message: row.missing, code: row.missing }] },\n\t\t\t\t\t});\n\t\t\t\t\ttx.emit({\n\t\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\t\tsource: \"post_tools\",\n\t\t\t\t\t\tmessage: `synthesized ${row.missing} tool result for ${row.call.id}`,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tlet headBoundary = head?.id;\n\t\t\t\tif (handoff !== undefined) {\n\t\t\t\t\theadBoundary = tx.appendEntry(conversationId, {\n\t\t\t\t\t\tkind: \"pi.handoff\",\n\t\t\t\t\t\thead: \"self\",\n\t\t\t\t\t\tmodel: [{ role: \"user\", content: handoff, timestamp: rt.now() }],\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (handoff !== undefined || terminate) {\n\t\t\t\t\ttx.sticky(conversationId).turn = { tools: [] };\n\t\t\t\t\tawait tx.resolveInputs(task.input.inputs, { status: \"done\", answer: task.input.assistant });\n\t\t\t\t\ttx.emit({ type: \"turn.ended\", inputs: task.input.inputs, status: \"done\", answer: task.input.assistant });\n\t\t\t\t\tconst { triggers } = await tx.boundary(conversationId, \"final\", headBoundary);\n\t\t\t\t\tif (triggers.length > 0) tx.emit({ type: \"turn.started\", inputs: triggers });\n\t\t\t\t\tconst ended = handoff !== undefined ? \"handoff\" : \"terminate\";\n\t\t\t\t\treturn {\n\t\t\t\t\t\tstatus: \"completed\",\n\t\t\t\t\t\tresult:\n\t\t\t\t\t\t\ttriggers.length > 0\n\t\t\t\t\t\t\t\t? { ended, successor: tx.createTask({ kind: \"pi.generation\", input: { inputs: triggers } }) }\n\t\t\t\t\t\t\t\t: { ended },\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tconst { triggers, terminated } = await tx.boundary(conversationId, \"postTools\", headBoundary);\n\t\t\t\tif (terminated) {\n\t\t\t\t\ttx.sticky(conversationId).turn = { tools: [] };\n\t\t\t\t\tawait tx.resolveInputs(task.input.inputs, { status: \"unanswered\", reason: \"terminated\" });\n\t\t\t\t\ttx.emit({ type: \"turn.ended\", inputs: task.input.inputs, status: \"unanswered\", reason: \"terminated\" });\n\t\t\t\t\tif (triggers.length > 0) tx.emit({ type: \"turn.started\", inputs: triggers });\n\t\t\t\t\treturn {\n\t\t\t\t\t\tstatus: \"completed\",\n\t\t\t\t\t\tresult:\n\t\t\t\t\t\t\ttriggers.length > 0\n\t\t\t\t\t\t\t\t? { successor: tx.createTask({ kind: \"pi.generation\", input: { inputs: triggers } }) }\n\t\t\t\t\t\t\t\t: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tstatus: \"completed\",\n\t\t\t\t\tresult: {\n\t\t\t\t\t\tsuccessor: tx.createTask({\n\t\t\t\t\t\t\tkind: \"pi.generation\",\n\t\t\t\t\t\t\tinput: { inputs: [...task.input.inputs, ...triggers] },\n\t\t\t\t\t\t}),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t},\n\t\t};\n\t},\n\n\tasync abort(task) {\n\t\treturn async (tx, current) => {\n\t\t\ttx.sticky(current.conversationId).turn = { tools: [] };\n\t\t\tawait tx.resolveInputs(task.input.inputs, { status: \"unanswered\", reason: \"aborted\" });\n\t\t\ttx.emit({ type: \"turn.ended\", inputs: task.input.inputs, status: \"unanswered\", reason: \"aborted\" });\n\t\t\treturn null;\n\t\t};\n\t},\n};\n"]}

package/dist/harness/pico3/kinds/post-tools.js

@@ -0,0 +1,145 @@
+import { toStored } from "../types.js";
+export const postToolsConfig = {
+    sticky: {
+        steeringMode: "one-at-a-time",
+        followUpMode: "one-at-a-time",
+    },
+};
+export const postTools = {
+    name: "pi.post_tools",
+    turn: true,
+    config: postToolsConfig,
+    phases: {},
+    async initial(task, rt, ctx) {
+        const rows = await rt.commit(async (tx) => {
+            const assistant = await tx.entry(task.input.assistant);
+            const calls = (assistant?.model?.[0]?.content ?? []).filter((content) => content.type === "toolCall");
+            return Promise.all(task.input.tools.map(async (id, index) => {
+                const toolTask = (await tx.task(id));
+                const call = calls[index];
+                if (toolTask.outcome?.status === "completed") {
+                    const result = toolTask.outcome.result;
+                    return {
+                        call,
+                        entry: result.entry,
+                        control: result.control,
+                        missing: undefined,
+                    };
+                }
+                if (toolTask.outcome?.status === "aborted") {
+                    const aborted = toolTask.outcome.result;
+                    return {
+                        call,
+                        entry: aborted.entry,
+                        control: undefined,
+                        missing: aborted.entry === undefined ? "aborted" : undefined,
+                    };
+                }
+                return { call, entry: undefined, control: undefined, missing: "orphaned" };
+            }));
+        }, ctx);
+        const results = rows.map((row) => row.entry).filter((entry) => entry !== undefined);
+        await rt.hooks.each(ctx, (hook, api) => hook.afterTools?.(task.input.assistant, results, api, ctx));
+        return {
+            done: async (tx, current) => {
+                const conversationId = current.conversationId;
+                const head = await tx.newestEntry(conversationId, { withHead: true });
+                const state = tx.rewindable(conversationId);
+                const selectedTools = [...state.selectedTools];
+                let terminate = false;
+                let handoff;
+                for (const row of rows) {
+                    for (const name of row.control?.addTools ?? [])
+                        if (!selectedTools.includes(name))
+                            selectedTools.push(name);
+                    if (row.control?.terminate)
+                        terminate = true;
+                    if (row.control?.handoff !== undefined)
+                        handoff = row.control.handoff;
+                }
+                if (selectedTools.length !== state.selectedTools.length) {
+                    state.selectedTools = selectedTools;
+                    tx.emit({ type: "config.changed", keys: ["selectedTools"] });
+                }
+                for (const row of rows) {
+                    if (row.missing === undefined)
+                        continue;
+                    tx.appendEntry(conversationId, {
+                        kind: "pi.tool_result",
+                        model: [
+                            toStored({
+                                role: "toolResult",
+                                toolCallId: row.call.id,
+                                toolName: row.call.name,
+                                content: [{ type: "text", text: `Tool result unavailable: task ${row.missing}.` }],
+                                isError: true,
+                                timestamp: rt.now(),
+                            }),
+                        ],
+                        data: { diagnostics: [{ severity: "error", message: row.missing, code: row.missing }] },
+                    });
+                    tx.emit({
+                        type: "warning",
+                        source: "post_tools",
+                        message: `synthesized ${row.missing} tool result for ${row.call.id}`,
+                    });
+                }
+                let headBoundary = head?.id;
+                if (handoff !== undefined) {
+                    headBoundary = tx.appendEntry(conversationId, {
+                        kind: "pi.handoff",
+                        head: "self",
+                        model: [{ role: "user", content: handoff, timestamp: rt.now() }],
+                    });
+                }
+                if (handoff !== undefined || terminate) {
+                    tx.sticky(conversationId).turn = { tools: [] };
+                    await tx.resolveInputs(task.input.inputs, { status: "done", answer: task.input.assistant });
+                    tx.emit({ type: "turn.ended", inputs: task.input.inputs, status: "done", answer: task.input.assistant });
+                    const { triggers } = await tx.boundary(conversationId, "final", headBoundary);
+                    if (triggers.length > 0)
+                        tx.emit({ type: "turn.started", inputs: triggers });
+                    const ended = handoff !== undefined ? "handoff" : "terminate";
+                    return {
+                        status: "completed",
+                        result: triggers.length > 0
+                            ? { ended, successor: tx.createTask({ kind: "pi.generation", input: { inputs: triggers } }) }
+                            : { ended },
+                    };
+                }
+                const { triggers, terminated } = await tx.boundary(conversationId, "postTools", headBoundary);
+                if (terminated) {
+                    tx.sticky(conversationId).turn = { tools: [] };
+                    await tx.resolveInputs(task.input.inputs, { status: "unanswered", reason: "terminated" });
+                    tx.emit({ type: "turn.ended", inputs: task.input.inputs, status: "unanswered", reason: "terminated" });
+                    if (triggers.length > 0)
+                        tx.emit({ type: "turn.started", inputs: triggers });
+                    return {
+                        status: "completed",
+                        result: triggers.length > 0
+                            ? { successor: tx.createTask({ kind: "pi.generation", input: { inputs: triggers } }) }
+                            : {},
+                    };
+                }
+                return {
+                    status: "completed",
+                    result: {
+                        successor: tx.createTask({
+                            kind: "pi.generation",
+                            input: { inputs: [...task.input.inputs, ...triggers] },
+                        }),
+                    },
+                };
+            },
+        };
+    },
+    async abort(task) {
+        return async (tx, current) => {
+            tx.sticky(current.conversationId).turn = { tools: [] };
+            await tx.resolveInputs(task.input.inputs, { status: "unanswered", reason: "aborted" });
+            tx.emit({ type: "turn.ended", inputs: task.input.inputs, status: "unanswered", reason: "aborted" });
+            return null;
+        };
+    },
+};
+//# sourceMappingURL=post-tools.js.map

package/dist/harness/pico3/kinds/post-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tools.js","sourceRoot":"","sources":["../../../../src/harness/pico3/kinds/post-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsD,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ3F,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,MAAM,EAAE;QACP,YAAY,EAAE,eAA0C;QACxD,YAAY,EAAE,eAA0C;KACxD;CACQ,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GAQlB;IACH,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,EAAE;IAEV,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE;QAC5B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACvD,MAAM,KAAK,GAAG,CAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAA0C,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CACpG,CAAC,OAAO,EAA+B,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,CACrE,CAAC;YACF,OAAO,OAAO,CAAC,GAAG,CACjB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;gBACzC,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;gBAC3B,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,KAAK,WAAW,EAAE,CAAC;oBAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAwB,CAAC;oBACzD,OAAO;wBACN,IAAI;wBACJ,KAAK,EAAE,MAAM,CAAC,KAAuB;wBACrC,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,OAAO,EAAE,SAA+C;qBACxD,CAAC;gBACH,CAAC;gBACD,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAwB,CAAC;oBAC1D,OAAO;wBACN,IAAI;wBACJ,KAAK,EAAE,OAAO,CAAC,KAAK;wBACpB,OAAO,EAAE,SAAS;wBAClB,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAE,SAAmB,CAAC,CAAC,CAAC,SAAS;qBACvE,CAAC;gBACH,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAmB,EAAE,CAAC;YAAA,CACpF,CAAC,CACF,CAAC;QAAA,CACF,EAAE,GAAG,CAAC,CAAC;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAe,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QACjG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAEpG,OAAO;YACN,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;gBAC5B,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;gBAC9C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtE,MAAM,KAAK,GAAG,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;gBAC5C,MAAM,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;gBAC/C,IAAI,SAAS,GAAG,KAAK,CAAC;gBACtB,IAAI,OAA2B,CAAC;gBAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACxB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE;wBAC7C,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;4BAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC7D,IAAI,GAAG,CAAC,OAAO,EAAE,SAAS;wBAAE,SAAS,GAAG,IAAI,CAAC;oBAC7C,IAAI,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS;wBAAE,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;gBACvE,CAAC;gBACD,IAAI,aAAa,CAAC,MAAM,KAAK,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;oBACzD,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;oBACpC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACxB,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;wBAAE,SAAS;oBACxC,EAAE,CAAC,WAAW,CAAC,cAAc,EAAE;wBAC9B,IAAI,EAAE,gBAAgB;wBACtB,KAAK,EAAE;4BACN,QAAQ,CAAC;gCACR,IAAI,EAAE,YAAqB;gCAC3B,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE;gCACvB,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI;gCACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iCAAiC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC;gCAC3F,OAAO,EAAE,IAAI;gCACb,SAAS,EAAE,EAAE,CAAC,GAAG,EAAE;6BACnB,CAAC;yBACF;wBACD,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE;qBACvF,CAAC,CAAC;oBACH,EAAE,CAAC,IAAI,CAAC;wBACP,IAAI,EAAE,SAAS;wBACf,MAAM,EAAE,YAAY;wBACpB,OAAO,EAAE,eAAe,GAAG,CAAC,OAAO,oBAAoB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;qBACpE,CAAC,CAAC;gBACJ,CAAC;gBACD,IAAI,YAAY,GAAG,IAAI,EAAE,EAAE,CAAC;gBAC5B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC3B,YAAY,GAAG,EAAE,CAAC,WAAW,CAAC,cAAc,EAAE;wBAC7C,IAAI,EAAE,YAAY;wBAClB,IAAI,EAAE,MAAM;wBACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;qBAChE,CAAC,CAAC;gBACJ,CAAC;gBACD,IAAI,OAAO,KAAK,SAAS,IAAI,SAAS,EAAE,CAAC;oBACxC,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;oBAC/C,MAAM,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;oBAC5F,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;oBACzG,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;oBAC9E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;wBAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC7E,MAAM,KAAK,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;oBAC9D,OAAO;wBACN,MAAM,EAAE,WAAW;wBACnB,MAAM,EACL,QAAQ,CAAC,MAAM,GAAG,CAAC;4BAClB,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE;4BAC7F,CAAC,CAAC,EAAE,KAAK,EAAE;qBACb,CAAC;gBACH,CAAC;gBACD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;gBAC9F,IAAI,UAAU,EAAE,CAAC;oBAChB,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;oBAC/C,MAAM,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;oBAC1F,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;oBACvG,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;wBAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC7E,OAAO;wBACN,MAAM,EAAE,WAAW;wBACnB,MAAM,EACL,QAAQ,CAAC,MAAM,GAAG,CAAC;4BAClB,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE;4BACtF,CAAC,CAAC,EAAE;qBACN,CAAC;gBACH,CAAC;gBACD,OAAO;oBACN,MAAM,EAAE,WAAW;oBACnB,MAAM,EAAE;wBACP,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC;4BACxB,IAAI,EAAE,eAAe;4BACrB,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE;yBACtD,CAAC;qBACF;iBACD,CAAC;YAAA,CACF;SACD,CAAC;IAAA,CACF;IAED,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;QACjB,OAAO,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;YAC7B,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACvD,MAAM,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACvF,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACpG,OAAO,IAAI,CAAC;QAAA,CACZ,CAAC;IAAA,CACF;CACD,CAAC","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport type { AssistantMessage, ToolCall } from \"@earendil-works/pi-ai\";\nimport { type CoreKind, type HookInfo, type Id, type Stored, toStored } from \"../types.ts\";\nimport type { ToolTaskResult } from \"./tool.ts\";\n\nexport type PostToolsInput = { inputs: Id[]; assistant: Id; tools: Id[] };\nexport type PostToolsResult = { successor?: Id; ended?: \"terminate\" | \"handoff\" };\nexport interface PostToolsHooks {\n\tafterTools(assistant: Id, results: Id[], info: HookInfo, ctx: Context): void | Promise<void>;\n}\nexport const postToolsConfig = {\n\tsticky: {\n\t\tsteeringMode: \"one-at-a-time\" as \"all\" | \"one-at-a-time\",\n\t\tfollowUpMode: \"one-at-a-time\" as \"all\" | \"one-at-a-time\",\n\t},\n} as const;\n\nexport const postTools: CoreKind<\n\tPostToolsInput,\n\tnever,\n\tPostToolsResult,\n\tnever,\n\tnull,\n\tPostToolsHooks,\n\ttypeof postToolsConfig\n> = {\n\tname: \"pi.post_tools\",\n\tturn: true,\n\tconfig: postToolsConfig,\n\tphases: {},\n\n\tasync initial(task, rt, ctx) {\n\t\tconst rows = await rt.commit(async (tx) => {\n\t\t\tconst assistant = await tx.entry(task.input.assistant);\n\t\t\tconst calls = ((assistant?.model?.[0] as Stored<AssistantMessage> | undefined)?.content ?? []).filter(\n\t\t\t\t(content): content is Stored<ToolCall> => content.type === \"toolCall\",\n\t\t\t);\n\t\t\treturn Promise.all(\n\t\t\t\ttask.input.tools.map(async (id, index) => {\n\t\t\t\t\tconst toolTask = (await tx.task(id))!;\n\t\t\t\t\tconst call = calls[index]!;\n\t\t\t\t\tif (toolTask.outcome?.status === \"completed\") {\n\t\t\t\t\t\tconst result = toolTask.outcome.result as ToolTaskResult;\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcall,\n\t\t\t\t\t\t\tentry: result.entry as Id | undefined,\n\t\t\t\t\t\t\tcontrol: result.control,\n\t\t\t\t\t\t\tmissing: undefined as \"orphaned\" | \"aborted\" | undefined,\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\tif (toolTask.outcome?.status === \"aborted\") {\n\t\t\t\t\t\tconst aborted = toolTask.outcome.result as { entry?: Id };\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcall,\n\t\t\t\t\t\t\tentry: aborted.entry,\n\t\t\t\t\t\t\tcontrol: undefined,\n\t\t\t\t\t\t\tmissing: aborted.entry === undefined ? (\"aborted\" as const) : undefined,\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\treturn { call, entry: undefined, control: undefined, missing: \"orphaned\" as const };\n\t\t\t\t}),\n\t\t\t);\n\t\t}, ctx);\n\t\tconst results = rows.map((row) => row.entry).filter((entry): entry is Id => entry !== undefined);\n\t\tawait rt.hooks.each(ctx, (hook, api) => hook.afterTools?.(task.input.assistant, results, api, ctx));\n\n\t\treturn {\n\t\t\tdone: async (tx, current) => {\n\t\t\t\tconst conversationId = current.conversationId;\n\t\t\t\tconst head = await tx.newestEntry(conversationId, { withHead: true });\n\t\t\t\tconst state = tx.rewindable(conversationId);\n\t\t\t\tconst selectedTools = [...state.selectedTools];\n\t\t\t\tlet terminate = false;\n\t\t\t\tlet handoff: string | undefined;\n\t\t\t\tfor (const row of rows) {\n\t\t\t\t\tfor (const name of row.control?.addTools ?? [])\n\t\t\t\t\t\tif (!selectedTools.includes(name)) selectedTools.push(name);\n\t\t\t\t\tif (row.control?.terminate) terminate = true;\n\t\t\t\t\tif (row.control?.handoff !== undefined) handoff = row.control.handoff;\n\t\t\t\t}\n\t\t\t\tif (selectedTools.length !== state.selectedTools.length) {\n\t\t\t\t\tstate.selectedTools = selectedTools;\n\t\t\t\t\ttx.emit({ type: \"config.changed\", keys: [\"selectedTools\"] });\n\t\t\t\t}\n\t\t\t\tfor (const row of rows) {\n\t\t\t\t\tif (row.missing === undefined) continue;\n\t\t\t\t\ttx.appendEntry(conversationId, {\n\t\t\t\t\t\tkind: \"pi.tool_result\",\n\t\t\t\t\t\tmodel: [\n\t\t\t\t\t\t\ttoStored({\n\t\t\t\t\t\t\t\trole: \"toolResult\" as const,\n\t\t\t\t\t\t\t\ttoolCallId: row.call.id,\n\t\t\t\t\t\t\t\ttoolName: row.call.name,\n\t\t\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: `Tool result unavailable: task ${row.missing}.` }],\n\t\t\t\t\t\t\t\tisError: true,\n\t\t\t\t\t\t\t\ttimestamp: rt.now(),\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t],\n\t\t\t\t\t\tdata: { diagnostics: [{ severity: \"error\", message: row.missing, code: row.missing }] },\n\t\t\t\t\t});\n\t\t\t\t\ttx.emit({\n\t\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\t\tsource: \"post_tools\",\n\t\t\t\t\t\tmessage: `synthesized ${row.missing} tool result for ${row.call.id}`,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tlet headBoundary = head?.id;\n\t\t\t\tif (handoff !== undefined) {\n\t\t\t\t\theadBoundary = tx.appendEntry(conversationId, {\n\t\t\t\t\t\tkind: \"pi.handoff\",\n\t\t\t\t\t\thead: \"self\",\n\t\t\t\t\t\tmodel: [{ role: \"user\", content: handoff, timestamp: rt.now() }],\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (handoff !== undefined || terminate) {\n\t\t\t\t\ttx.sticky(conversationId).turn = { tools: [] };\n\t\t\t\t\tawait tx.resolveInputs(task.input.inputs, { status: \"done\", answer: task.input.assistant });\n\t\t\t\t\ttx.emit({ type: \"turn.ended\", inputs: task.input.inputs, status: \"done\", answer: task.input.assistant });\n\t\t\t\t\tconst { triggers } = await tx.boundary(conversationId, \"final\", headBoundary);\n\t\t\t\t\tif (triggers.length > 0) tx.emit({ type: \"turn.started\", inputs: triggers });\n\t\t\t\t\tconst ended = handoff !== undefined ? \"handoff\" : \"terminate\";\n\t\t\t\t\treturn {\n\t\t\t\t\t\tstatus: \"completed\",\n\t\t\t\t\t\tresult:\n\t\t\t\t\t\t\ttriggers.length > 0\n\t\t\t\t\t\t\t\t? { ended, successor: tx.createTask({ kind: \"pi.generation\", input: { inputs: triggers } }) }\n\t\t\t\t\t\t\t\t: { ended },\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tconst { triggers, terminated } = await tx.boundary(conversationId, \"postTools\", headBoundary);\n\t\t\t\tif (terminated) {\n\t\t\t\t\ttx.sticky(conversationId).turn = { tools: [] };\n\t\t\t\t\tawait tx.resolveInputs(task.input.inputs, { status: \"unanswered\", reason: \"terminated\" });\n\t\t\t\t\ttx.emit({ type: \"turn.ended\", inputs: task.input.inputs, status: \"unanswered\", reason: \"terminated\" });\n\t\t\t\t\tif (triggers.length > 0) tx.emit({ type: \"turn.started\", inputs: triggers });\n\t\t\t\t\treturn {\n\t\t\t\t\t\tstatus: \"completed\",\n\t\t\t\t\t\tresult:\n\t\t\t\t\t\t\ttriggers.length > 0\n\t\t\t\t\t\t\t\t? { successor: tx.createTask({ kind: \"pi.generation\", input: { inputs: triggers } }) }\n\t\t\t\t\t\t\t\t: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tstatus: \"completed\",\n\t\t\t\t\tresult: {\n\t\t\t\t\t\tsuccessor: tx.createTask({\n\t\t\t\t\t\t\tkind: \"pi.generation\",\n\t\t\t\t\t\t\tinput: { inputs: [...task.input.inputs, ...triggers] },\n\t\t\t\t\t\t}),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t},\n\t\t};\n\t},\n\n\tasync abort(task) {\n\t\treturn async (tx, current) => {\n\t\t\ttx.sticky(current.conversationId).turn = { tools: [] };\n\t\t\tawait tx.resolveInputs(task.input.inputs, { status: \"unanswered\", reason: \"aborted\" });\n\t\t\ttx.emit({ type: \"turn.ended\", inputs: task.input.inputs, status: \"unanswered\", reason: \"aborted\" });\n\t\t\treturn null;\n\t\t};\n\t},\n};\n"]}

package/dist/harness/pico3/kinds/task-api.d.ts

@@ -0,0 +1,3 @@
+import type { Runtime, Task, ToolApi } from "../types.ts";
+export declare function taskApi(task: Task, runtime: Runtime): ToolApi;
+//# sourceMappingURL=task-api.d.ts.map

package/dist/harness/pico3/kinds/task-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-api.d.ts","sourceRoot":"","sources":["../../../../src/harness/pico3/kinds/task-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA0B,OAAO,EAAE,IAAI,EAAW,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3F,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAgD7D","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport type { AnyKind, Id, JsonValue, Runtime, Task, TaskRef, ToolApi } from \"../types.ts\";\n\nexport function taskApi(task: Task, runtime: Runtime): ToolApi {\n\tconst isKind = (value: unknown): value is AnyKind =>\n\t\ttypeof value === \"object\" && value !== null && \"name\" in value && \"initial\" in value;\n\treturn {\n\t\ttaskId: task.id,\n\t\tconversationId: task.conversationId,\n\t\tcallId: \"\",\n\t\tstream: () => {\n\t\t\tthrow new Error(\"stream is only available to tools\");\n\t\t},\n\t\tprogress: () => {\n\t\t\tthrow new Error(\"progress is only available to tools\");\n\t\t},\n\t\tmemo: (() => Promise.reject(new Error(\"memo is only available to tools\"))) as ToolApi[\"memo\"],\n\t\tasync conversation(spec, ctx) {\n\t\t\tconst id = await runtime.createOwnedConversation(spec, ctx);\n\t\t\treturn {\n\t\t\t\tid,\n\t\t\t\tsend: async (input, childContext) => {\n\t\t\t\t\tconst inputId = await runtime.sendOwned(id, input, childContext);\n\t\t\t\t\treturn {\n\t\t\t\t\t\tid: inputId,\n\t\t\t\t\t\twait: (waitContext) => runtime.waitForInput(inputId, waitContext),\n\t\t\t\t\t\tresult: (resultContext) => runtime.commit((tx) => tx.input(inputId), resultContext),\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t\tabort: (childContext) => runtime.abortConversation(id, childContext),\n\t\t\t};\n\t\t},\n\t\ttask: ((\n\t\t\tkind: AnyKind,\n\t\t\tinput: JsonValue,\n\t\t\topts: { background?: true; after?: Id[] },\n\t\t\tctx: Context,\n\t\t): Promise<TaskRef> => {\n\t\t\tif (!isKind(kind)) throw new Error(\"task(): pass a kind token\");\n\t\t\treturn runtime.commit((tx) => tx.createTask(kind, input as never, opts), ctx);\n\t\t}) as ToolApi[\"task\"],\n\t\tgetTask: async (ref, ctx) => (await runtime.commit((tx) => tx.task(ref.id), ctx)) as never,\n\t\twaitForTask: (ref, ctx) => runtime.waitForTask(ref.id, ctx) as never,\n\t\tslot: (ref, ctx) =>\n\t\t\truntime.commit(async (tx) => {\n\t\t\t\tconst storedTask = await tx.task(ref.id);\n\t\t\t\tif (storedTask === undefined) return undefined;\n\t\t\t\treturn (tx.snapshot({ doc: \"sticky\", conversationId: storedTask.conversationId }).tasks[ref.id] ??\n\t\t\t\t\tundefined) as never;\n\t\t\t}, ctx),\n\t};\n}\n"]}

package/dist/harness/pico3/kinds/task-api.js

@@ -0,0 +1,45 @@
+export function taskApi(task, runtime) {
+    const isKind = (value) => typeof value === "object" && value !== null && "name" in value && "initial" in value;
+    return {
+        taskId: task.id,
+        conversationId: task.conversationId,
+        callId: "",
+        stream: () => {
+            throw new Error("stream is only available to tools");
+        },
+        progress: () => {
+            throw new Error("progress is only available to tools");
+        },
+        memo: (() => Promise.reject(new Error("memo is only available to tools"))),
+        async conversation(spec, ctx) {
+            const id = await runtime.createOwnedConversation(spec, ctx);
+            return {
+                id,
+                send: async (input, childContext) => {
+                    const inputId = await runtime.sendOwned(id, input, childContext);
+                    return {
+                        id: inputId,
+                        wait: (waitContext) => runtime.waitForInput(inputId, waitContext),
+                        result: (resultContext) => runtime.commit((tx) => tx.input(inputId), resultContext),
+                    };
+                },
+                abort: (childContext) => runtime.abortConversation(id, childContext),
+            };
+        },
+        task: ((kind, input, opts, ctx) => {
+            if (!isKind(kind))
+                throw new Error("task(): pass a kind token");
+            return runtime.commit((tx) => tx.createTask(kind, input, opts), ctx);
+        }),
+        getTask: async (ref, ctx) => (await runtime.commit((tx) => tx.task(ref.id), ctx)),
+        waitForTask: (ref, ctx) => runtime.waitForTask(ref.id, ctx),
+        slot: (ref, ctx) => runtime.commit(async (tx) => {
+            const storedTask = await tx.task(ref.id);
+            if (storedTask === undefined)
+                return undefined;
+            return (tx.snapshot({ doc: "sticky", conversationId: storedTask.conversationId }).tasks[ref.id] ??
+                undefined);
+        }, ctx),
+    };
+}
+//# sourceMappingURL=task-api.js.map

package/dist/harness/pico3/kinds/task-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-api.js","sourceRoot":"","sources":["../../../../src/harness/pico3/kinds/task-api.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport type { AnyKind, Id, JsonValue, Runtime, Task, TaskRef, ToolApi } from \"../types.ts\";\n\nexport function taskApi(task: Task, runtime: Runtime): ToolApi {\n\tconst isKind = (value: unknown): value is AnyKind =>\n\t\ttypeof value === \"object\" && value !== null && \"name\" in value && \"initial\" in value;\n\treturn {\n\t\ttaskId: task.id,\n\t\tconversationId: task.conversationId,\n\t\tcallId: \"\",\n\t\tstream: () => {\n\t\t\tthrow new Error(\"stream is only available to tools\");\n\t\t},\n\t\tprogress: () => {\n\t\t\tthrow new Error(\"progress is only available to tools\");\n\t\t},\n\t\tmemo: (() => Promise.reject(new Error(\"memo is only available to tools\"))) as ToolApi[\"memo\"],\n\t\tasync conversation(spec, ctx) {\n\t\t\tconst id = await runtime.createOwnedConversation(spec, ctx);\n\t\t\treturn {\n\t\t\t\tid,\n\t\t\t\tsend: async (input, childContext) => {\n\t\t\t\t\tconst inputId = await runtime.sendOwned(id, input, childContext);\n\t\t\t\t\treturn {\n\t\t\t\t\t\tid: inputId,\n\t\t\t\t\t\twait: (waitContext) => runtime.waitForInput(inputId, waitContext),\n\t\t\t\t\t\tresult: (resultContext) => runtime.commit((tx) => tx.input(inputId), resultContext),\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t\tabort: (childContext) => runtime.abortConversation(id, childContext),\n\t\t\t};\n\t\t},\n\t\ttask: ((\n\t\t\tkind: AnyKind,\n\t\t\tinput: JsonValue,\n\t\t\topts: { background?: true; after?: Id[] },\n\t\t\tctx: Context,\n\t\t): Promise<TaskRef> => {\n\t\t\tif (!isKind(kind)) throw new Error(\"task(): pass a kind token\");\n\t\t\treturn runtime.commit((tx) => tx.createTask(kind, input as never, opts), ctx);\n\t\t}) as ToolApi[\"task\"],\n\t\tgetTask: async (ref, ctx) => (await runtime.commit((tx) => tx.task(ref.id), ctx)) as never,\n\t\twaitForTask: (ref, ctx) => runtime.waitForTask(ref.id, ctx) as never,\n\t\tslot: (ref, ctx) =>\n\t\t\truntime.commit(async (tx) => {\n\t\t\t\tconst storedTask = await tx.task(ref.id);\n\t\t\t\tif (storedTask === undefined) return undefined;\n\t\t\t\treturn (tx.snapshot({ doc: \"sticky\", conversationId: storedTask.conversationId }).tasks[ref.id] ??\n\t\t\t\t\tundefined) as never;\n\t\t\t}, ctx),\n\t};\n}\n"]}