@earendil-works/pi-durable 1.2.0 → 1.4.0

package/dist/harness/telemetry.d.ts

@@ -0,0 +1,307 @@
+/** Durable's content-free span, event, and metric vocabulary. IDs address durable records, never content. */
+export declare const DURABLE_TELEMETRY_SCHEMA: {
+    readonly version: 1;
+    readonly spans: {
+        readonly "pi.durable.submit": {
+            readonly description: "Public submission admission and its commit. Inputs start root traces linked to their callers; writes are children. Internal admissions emit phase events only.";
+            readonly parents: {
+                readonly kind: "any";
+            };
+            readonly startAttributes: {
+                readonly "submission.type": {
+                    readonly type: "string";
+                    readonly required: true;
+                    readonly values: readonly ["input", "write"];
+                    readonly description: "Submission type.";
+                };
+                readonly "conversation.id": {
+                    readonly type: "number";
+                    readonly required: true;
+                    readonly description: "Conversation ID.";
+                    readonly cardinality: "high";
+                };
+            };
+            readonly endAttributes: {
+                readonly "submission.id": {
+                    readonly type: "number";
+                    readonly description: "Admitted submission ID.";
+                    readonly cardinality: "high";
+                };
+                readonly result: {
+                    readonly type: "string";
+                    readonly values: readonly ["queued", "placed", "done"];
+                    readonly description: "Admission result; stale writes report done.";
+                };
+            };
+            readonly events: {
+                "pi.durable.entry": {
+                    readonly description: "A transcript entry was committed; content remains in the transcript.";
+                    readonly attributes: {
+                        readonly "entry.id": {
+                            readonly type: "number";
+                            readonly required: true;
+                            readonly description: "Transcript entry ID.";
+                            readonly cardinality: "high";
+                        };
+                        readonly "entry.kind": {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "Entry kind.";
+                        };
+                    };
+                };
+                "pi.durable.submission": {
+                    readonly description: "A submission was settled.";
+                    readonly attributes: {
+                        readonly "submission.id": {
+                            readonly type: "number";
+                            readonly required: true;
+                            readonly description: "Submission ID.";
+                            readonly cardinality: "high";
+                        };
+                        readonly status: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly values: readonly ["done", "unanswered"];
+                            readonly description: "Settlement.";
+                        };
+                        readonly "answer.entry_id": {
+                            readonly type: "number";
+                            readonly required: false;
+                            readonly description: "Answer entry ID.";
+                            readonly cardinality: "high";
+                        };
+                    };
+                };
+                "pi.durable.report": {
+                    readonly description: "A report was raised; no error payload is recorded.";
+                    readonly attributes: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "ReportInfo type.";
+                            readonly values: readonly ["session_failed", "task_faulted", "task_parked", "migration_failed", "task_outdated", "task_error", "extension_error", "host_error", "listener_error"];
+                        };
+                        readonly reason: {
+                            readonly type: "string";
+                            readonly required: false;
+                            readonly description: "Fixed report reason, when present.";
+                            readonly values: readonly ["threw", "restart_limit", "missing_task", "incompatible_task"];
+                        };
+                        readonly extension: {
+                            readonly type: "string";
+                            readonly required: false;
+                            readonly description: "Registered extension name, when present.";
+                        };
+                        readonly "task.id": {
+                            readonly type: "number";
+                            readonly required: false;
+                            readonly description: "Task ID, when present.";
+                            readonly cardinality: "high";
+                        };
+                    };
+                };
+            };
+            readonly status: {
+                readonly default: "ok";
+                readonly errorWhen: "Admission failed.";
+            };
+        };
+        readonly "pi.durable.phase": {
+            readonly description: "One task phase invocation, including its decision commit, never a wait or restart.";
+            readonly parents: {
+                readonly kind: "any";
+            };
+            readonly startAttributes: {
+                readonly "task.id": {
+                    readonly type: "number";
+                    readonly required: true;
+                    readonly description: "Task ID.";
+                    readonly cardinality: "high";
+                };
+                readonly "task.name": {
+                    readonly type: "string";
+                    readonly required: true;
+                    readonly description: "Registered task name.";
+                };
+                readonly phase: {
+                    readonly type: "string";
+                    readonly required: true;
+                    readonly description: "Invoked checkpoint phase.";
+                };
+                readonly kind: {
+                    readonly type: "string";
+                    readonly required: true;
+                    readonly values: readonly ["run", "abort"];
+                    readonly description: "Invocation kind.";
+                };
+                readonly attempt: {
+                    readonly type: "number";
+                    readonly required: false;
+                    readonly description: "Checkpoint attempt, when present.";
+                };
+                readonly resumed: {
+                    readonly type: "boolean";
+                    readonly required: true;
+                    readonly description: "First invocation of a task loaded in this process.";
+                };
+            };
+            readonly endAttributes: {
+                readonly outcome: {
+                    readonly type: "string";
+                    readonly description: "next=<phase>, waiting, sleeping, done, faulted, or aborted.";
+                };
+                readonly "tool.name": {
+                    readonly type: "string";
+                    readonly description: "Called tool name.";
+                };
+                readonly "tool.call_id": {
+                    readonly type: "string";
+                    readonly description: "Transcript tool call ID.";
+                    readonly cardinality: "high";
+                };
+            };
+            readonly events: {
+                readonly "pi.durable.entry": {
+                    readonly description: "A transcript entry was committed; content remains in the transcript.";
+                    readonly attributes: {
+                        readonly "entry.id": {
+                            readonly type: "number";
+                            readonly required: true;
+                            readonly description: "Transcript entry ID.";
+                            readonly cardinality: "high";
+                        };
+                        readonly "entry.kind": {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "Entry kind.";
+                        };
+                    };
+                };
+                readonly "pi.durable.submission": {
+                    readonly description: "A submission was settled.";
+                    readonly attributes: {
+                        readonly "submission.id": {
+                            readonly type: "number";
+                            readonly required: true;
+                            readonly description: "Submission ID.";
+                            readonly cardinality: "high";
+                        };
+                        readonly status: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly values: readonly ["done", "unanswered"];
+                            readonly description: "Settlement.";
+                        };
+                        readonly "answer.entry_id": {
+                            readonly type: "number";
+                            readonly required: false;
+                            readonly description: "Answer entry ID.";
+                            readonly cardinality: "high";
+                        };
+                    };
+                };
+                readonly "pi.durable.report": {
+                    readonly description: "A report was raised; no error payload is recorded.";
+                    readonly attributes: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "ReportInfo type.";
+                            readonly values: readonly ["session_failed", "task_faulted", "task_parked", "migration_failed", "task_outdated", "task_error", "extension_error", "host_error", "listener_error"];
+                        };
+                        readonly reason: {
+                            readonly type: "string";
+                            readonly required: false;
+                            readonly description: "Fixed report reason, when present.";
+                            readonly values: readonly ["threw", "restart_limit", "missing_task", "incompatible_task"];
+                        };
+                        readonly extension: {
+                            readonly type: "string";
+                            readonly required: false;
+                            readonly description: "Registered extension name, when present.";
+                        };
+                        readonly "task.id": {
+                            readonly type: "number";
+                            readonly required: false;
+                            readonly description: "Task ID, when present.";
+                            readonly cardinality: "high";
+                        };
+                    };
+                };
+                readonly "pi.durable.checkpoint": {
+                    readonly description: "The running checkpoint's phase changed while the invocation continued.";
+                    readonly attributes: {
+                        readonly phase: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "Committed checkpoint phase.";
+                        };
+                    };
+                };
+                readonly "pi.durable.replay": {
+                    readonly description: "A nested tool call was answered from its stored result.";
+                    readonly attributes: {
+                        readonly "tool.name": {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "Called tool name.";
+                        };
+                    };
+                };
+            };
+            readonly status: {
+                readonly default: "ok";
+                readonly errorWhen: "Faulted, failed, and orphaned outcomes use task_faulted, task_failed, and task_orphaned with a diagnostic capped at 500 characters. Aborted outcomes keep status ok.";
+            };
+        };
+    };
+    readonly metrics: {
+        readonly "pi.durable.reports": {
+            readonly kind: "counter";
+            readonly description: "Reports raised, grouped by their fixed ReportInfo type.";
+            readonly attributes: {
+                type: {
+                    readonly type: "string";
+                    readonly required: true;
+                    readonly description: "ReportInfo type.";
+                    readonly values: readonly ["session_failed", "task_faulted", "task_parked", "migration_failed", "task_outdated", "task_error", "extension_error", "host_error", "listener_error"];
+                };
+            };
+        };
+        readonly "pi.durable.phase.duration": {
+            readonly kind: "histogram";
+            readonly unit: "ms";
+            readonly description: "Duration of a phase invocation and its decision commit.";
+            readonly attributes: {
+                readonly task: {
+                    readonly type: "string";
+                    readonly required: true;
+                    readonly description: "Registered task name.";
+                };
+                readonly phase: {
+                    readonly type: "string";
+                    readonly required: true;
+                    readonly description: "Invoked checkpoint phase.";
+                };
+                readonly outcome: {
+                    readonly type: "string";
+                    readonly required: true;
+                    readonly description: "Phase outcome.";
+                };
+            };
+        };
+        readonly "pi.durable.tasks.active": {
+            readonly kind: "upDownCounter";
+            readonly description: "Live tasks held by this Harness; decremented at terminal settlement or close.";
+            readonly attributes: {
+                readonly task: {
+                    readonly type: "string";
+                    readonly required: true;
+                    readonly description: "Registered task name.";
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/harness/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/harness/telemetry.ts"],"names":[],"mappings":"AAgDA,6GAA6G;AAC7G,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAwBxB,kBAAkB;0CAtEjB,sEAAsE;;iCAElF,UAAU;qCAAI,IAAI,EAAE,QAAQ;qCAAE,QAAQ;qCAAQ,WAAW,EAAE,sBAAsB;qCAAE,WAAW,EAAE,MAAM;;iCACtG,YAAY;qCAAI,IAAI,EAAE,QAAQ;qCAAE,QAAQ;qCAAQ,WAAW,EAAE,aAAa;;;;gBAmEpC,uBAAuB;0CAjCjD,2BAA2B;;iCAEvC,eAAe;qCAAI,IAAI,EAAE,QAAQ;qCAAE,QAAQ;qCAAQ,WAAW,EAAE,gBAAgB;qCAAE,WAAW,EAAE,MAAM;;iCACrG,MAAM;qCAAI,IAAI,EAAE,QAAQ;qCAAE,QAAQ;qCAAQ,MAAM,YAAG,MAAM,EAAE,YAAY;qCAAG,WAAW,EAAE,aAAa;;iCACpG,iBAAiB;qCAAI,IAAI,EAAE,QAAQ;qCAAE,QAAQ;qCAAS,WAAW,EAAE,kBAAkB;qCAAE,WAAW,EAAE,MAAM;;;;gBA6B/B,mBAAmB;0CArClF,oDAAoD;;;qCAzBhE,IAAI,EAAE,QAAQ;qCACd,QAAQ;qCACR,WAAW,EAAE,kBAAkB;qCAC/B,MAAM,YACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,gBAAgB;;;qCAIjB,IAAI,EAAE,QAAQ;qCACd,QAAQ;qCACR,WAAW,EAAE,oCAAoC;qCACjD,MAAM,YAAG,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB;;;qCAE1D,IAAI,EAAE,QAAQ;qCAAE,QAAQ;qCAAS,WAAW,EAAE,0CAA0C;;;qCACxF,IAAI,EAAE,QAAQ;qCAAE,QAAQ;qCAAS,WAAW,EAAE,wBAAwB;qCAAE,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAuFxF,IAAI;mCA7Gb,QAAQ;;0CAED,kBAAkB;+CAE9B,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmHjB,CAAC"}

package/dist/harness/telemetry.js

@@ -0,0 +1,136 @@
+import { defineTelemetrySchema } from "@earendil-works/pi-telemetry";
+const entry = {
+    description: "A transcript entry was committed; content remains in the transcript.",
+    attributes: {
+        "entry.id": { type: "number", required: true, description: "Transcript entry ID.", cardinality: "high" },
+        "entry.kind": { type: "string", required: true, description: "Entry kind." },
+    },
+};
+const reportAttributes = {
+    type: {
+        type: "string",
+        required: true,
+        description: "ReportInfo type.",
+        values: [
+            "session_failed",
+            "task_faulted",
+            "task_parked",
+            "migration_failed",
+            "task_outdated",
+            "task_error",
+            "extension_error",
+            "host_error",
+            "listener_error",
+        ],
+    },
+    reason: {
+        type: "string",
+        required: false,
+        description: "Fixed report reason, when present.",
+        values: ["threw", "restart_limit", "missing_task", "incompatible_task"],
+    },
+    extension: { type: "string", required: false, description: "Registered extension name, when present." },
+    "task.id": { type: "number", required: false, description: "Task ID, when present.", cardinality: "high" },
+};
+const report = {
+    description: "A report was raised; no error payload is recorded.",
+    attributes: reportAttributes,
+};
+const submission = {
+    description: "A submission was settled.",
+    attributes: {
+        "submission.id": { type: "number", required: true, description: "Submission ID.", cardinality: "high" },
+        status: { type: "string", required: true, values: ["done", "unanswered"], description: "Settlement." },
+        "answer.entry_id": { type: "number", required: false, description: "Answer entry ID.", cardinality: "high" },
+    },
+};
+/** Durable's content-free span, event, and metric vocabulary. IDs address durable records, never content. */
+export const DURABLE_TELEMETRY_SCHEMA = defineTelemetrySchema({
+    version: 1,
+    spans: {
+        "pi.durable.submit": {
+            description: "Public submission admission and its commit. Inputs start root traces linked to their callers; writes are children. Internal admissions emit phase events only.",
+            parents: { kind: "any" },
+            startAttributes: {
+                "submission.type": {
+                    type: "string",
+                    required: true,
+                    values: ["input", "write"],
+                    description: "Submission type.",
+                },
+                "conversation.id": { type: "number", required: true, description: "Conversation ID.", cardinality: "high" },
+            },
+            endAttributes: {
+                "submission.id": { type: "number", description: "Admitted submission ID.", cardinality: "high" },
+                result: {
+                    type: "string",
+                    values: ["queued", "placed", "done"],
+                    description: "Admission result; stale writes report done.",
+                },
+            },
+            events: { "pi.durable.entry": entry, "pi.durable.submission": submission, "pi.durable.report": report },
+            status: { default: "ok", errorWhen: "Admission failed." },
+        },
+        "pi.durable.phase": {
+            description: "One task phase invocation, including its decision commit, never a wait or restart.",
+            parents: { kind: "any" },
+            startAttributes: {
+                "task.id": { type: "number", required: true, description: "Task ID.", cardinality: "high" },
+                "task.name": { type: "string", required: true, description: "Registered task name." },
+                phase: { type: "string", required: true, description: "Invoked checkpoint phase." },
+                kind: { type: "string", required: true, values: ["run", "abort"], description: "Invocation kind." },
+                attempt: { type: "number", required: false, description: "Checkpoint attempt, when present." },
+                resumed: {
+                    type: "boolean",
+                    required: true,
+                    description: "First invocation of a task loaded in this process.",
+                },
+            },
+            endAttributes: {
+                outcome: { type: "string", description: "next=<phase>, waiting, sleeping, done, faulted, or aborted." },
+                "tool.name": { type: "string", description: "Called tool name." },
+                "tool.call_id": { type: "string", description: "Transcript tool call ID.", cardinality: "high" },
+            },
+            events: {
+                "pi.durable.entry": entry,
+                "pi.durable.submission": submission,
+                "pi.durable.report": report,
+                "pi.durable.checkpoint": {
+                    description: "The running checkpoint's phase changed while the invocation continued.",
+                    attributes: { phase: { type: "string", required: true, description: "Committed checkpoint phase." } },
+                },
+                "pi.durable.replay": {
+                    description: "A nested tool call was answered from its stored result.",
+                    attributes: { "tool.name": { type: "string", required: true, description: "Called tool name." } },
+                },
+            },
+            status: {
+                default: "ok",
+                errorWhen: "Faulted, failed, and orphaned outcomes use task_faulted, task_failed, and task_orphaned with a diagnostic capped at 500 characters. Aborted outcomes keep status ok.",
+            },
+        },
+    },
+    metrics: {
+        "pi.durable.reports": {
+            kind: "counter",
+            description: "Reports raised, grouped by their fixed ReportInfo type.",
+            attributes: { type: reportAttributes.type },
+        },
+        "pi.durable.phase.duration": {
+            kind: "histogram",
+            unit: "ms",
+            description: "Duration of a phase invocation and its decision commit.",
+            attributes: {
+                task: { type: "string", required: true, description: "Registered task name." },
+                phase: { type: "string", required: true, description: "Invoked checkpoint phase." },
+                outcome: { type: "string", required: true, description: "Phase outcome." },
+            },
+        },
+        "pi.durable.tasks.active": {
+            kind: "upDownCounter",
+            description: "Live tasks held by this Harness; decremented at terminal settlement or close.",
+            attributes: { task: { type: "string", required: true, description: "Registered task name." } },
+        },
+    },
+});
+//# sourceMappingURL=telemetry.js.map

package/dist/harness/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/harness/telemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import { defineTelemetrySchema } from \"@earendil-works/pi-telemetry\";\n\nconst entry = {\n\tdescription: \"A transcript entry was committed; content remains in the transcript.\",\n\tattributes: {\n\t\t\"entry.id\": { type: \"number\", required: true, description: \"Transcript entry ID.\", cardinality: \"high\" },\n\t\t\"entry.kind\": { type: \"string\", required: true, description: \"Entry kind.\" },\n\t},\n} as const;\nconst reportAttributes = {\n\ttype: {\n\t\ttype: \"string\",\n\t\trequired: true,\n\t\tdescription: \"ReportInfo type.\",\n\t\tvalues: [\n\t\t\t\"session_failed\",\n\t\t\t\"task_faulted\",\n\t\t\t\"task_parked\",\n\t\t\t\"migration_failed\",\n\t\t\t\"task_outdated\",\n\t\t\t\"task_error\",\n\t\t\t\"extension_error\",\n\t\t\t\"host_error\",\n\t\t\t\"listener_error\",\n\t\t],\n\t},\n\treason: {\n\t\ttype: \"string\",\n\t\trequired: false,\n\t\tdescription: \"Fixed report reason, when present.\",\n\t\tvalues: [\"threw\", \"restart_limit\", \"missing_task\", \"incompatible_task\"],\n\t},\n\textension: { type: \"string\", required: false, description: \"Registered extension name, when present.\" },\n\t\"task.id\": { type: \"number\", required: false, description: \"Task ID, when present.\", cardinality: \"high\" },\n} as const;\nconst report = {\n\tdescription: \"A report was raised; no error payload is recorded.\",\n\tattributes: reportAttributes,\n} as const;\nconst submission = {\n\tdescription: \"A submission was settled.\",\n\tattributes: {\n\t\t\"submission.id\": { type: \"number\", required: true, description: \"Submission ID.\", cardinality: \"high\" },\n\t\tstatus: { type: \"string\", required: true, values: [\"done\", \"unanswered\"], description: \"Settlement.\" },\n\t\t\"answer.entry_id\": { type: \"number\", required: false, description: \"Answer entry ID.\", cardinality: \"high\" },\n\t},\n} as const;\n\n/** Durable's content-free span, event, and metric vocabulary. IDs address durable records, never content. */\nexport const DURABLE_TELEMETRY_SCHEMA = defineTelemetrySchema({\n\tversion: 1,\n\tspans: {\n\t\t\"pi.durable.submit\": {\n\t\t\tdescription:\n\t\t\t\t\"Public submission admission and its commit. Inputs start root traces linked to their callers; writes are children. Internal admissions emit phase events only.\",\n\t\t\tparents: { kind: \"any\" },\n\t\t\tstartAttributes: {\n\t\t\t\t\"submission.type\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tvalues: [\"input\", \"write\"],\n\t\t\t\t\tdescription: \"Submission type.\",\n\t\t\t\t},\n\t\t\t\t\"conversation.id\": { type: \"number\", required: true, description: \"Conversation ID.\", cardinality: \"high\" },\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"submission.id\": { type: \"number\", description: \"Admitted submission ID.\", cardinality: \"high\" },\n\t\t\t\tresult: {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tvalues: [\"queued\", \"placed\", \"done\"],\n\t\t\t\t\tdescription: \"Admission result; stale writes report done.\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tevents: { \"pi.durable.entry\": entry, \"pi.durable.submission\": submission, \"pi.durable.report\": report },\n\t\t\tstatus: { default: \"ok\", errorWhen: \"Admission failed.\" },\n\t\t},\n\t\t\"pi.durable.phase\": {\n\t\t\tdescription: \"One task phase invocation, including its decision commit, never a wait or restart.\",\n\t\t\tparents: { kind: \"any\" },\n\t\t\tstartAttributes: {\n\t\t\t\t\"task.id\": { type: \"number\", required: true, description: \"Task ID.\", cardinality: \"high\" },\n\t\t\t\t\"task.name\": { type: \"string\", required: true, description: \"Registered task name.\" },\n\t\t\t\tphase: { type: \"string\", required: true, description: \"Invoked checkpoint phase.\" },\n\t\t\t\tkind: { type: \"string\", required: true, values: [\"run\", \"abort\"], description: \"Invocation kind.\" },\n\t\t\t\tattempt: { type: \"number\", required: false, description: \"Checkpoint attempt, when present.\" },\n\t\t\t\tresumed: {\n\t\t\t\t\ttype: \"boolean\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"First invocation of a task loaded in this process.\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\toutcome: { type: \"string\", description: \"next=<phase>, waiting, sleeping, done, faulted, or aborted.\" },\n\t\t\t\t\"tool.name\": { type: \"string\", description: \"Called tool name.\" },\n\t\t\t\t\"tool.call_id\": { type: \"string\", description: \"Transcript tool call ID.\", cardinality: \"high\" },\n\t\t\t},\n\t\t\tevents: {\n\t\t\t\t\"pi.durable.entry\": entry,\n\t\t\t\t\"pi.durable.submission\": submission,\n\t\t\t\t\"pi.durable.report\": report,\n\t\t\t\t\"pi.durable.checkpoint\": {\n\t\t\t\t\tdescription: \"The running checkpoint's phase changed while the invocation continued.\",\n\t\t\t\t\tattributes: { phase: { type: \"string\", required: true, description: \"Committed checkpoint phase.\" } },\n\t\t\t\t},\n\t\t\t\t\"pi.durable.replay\": {\n\t\t\t\t\tdescription: \"A nested tool call was answered from its stored result.\",\n\t\t\t\t\tattributes: { \"tool.name\": { type: \"string\", required: true, description: \"Called tool name.\" } },\n\t\t\t\t},\n\t\t\t},\n\t\t\tstatus: {\n\t\t\t\tdefault: \"ok\",\n\t\t\t\terrorWhen:\n\t\t\t\t\t\"Faulted, failed, and orphaned outcomes use task_faulted, task_failed, and task_orphaned with a diagnostic capped at 500 characters. Aborted outcomes keep status ok.\",\n\t\t\t},\n\t\t},\n\t},\n\tmetrics: {\n\t\t\"pi.durable.reports\": {\n\t\t\tkind: \"counter\",\n\t\t\tdescription: \"Reports raised, grouped by their fixed ReportInfo type.\",\n\t\t\tattributes: { type: reportAttributes.type },\n\t\t},\n\t\t\"pi.durable.phase.duration\": {\n\t\t\tkind: \"histogram\",\n\t\t\tunit: \"ms\",\n\t\t\tdescription: \"Duration of a phase invocation and its decision commit.\",\n\t\t\tattributes: {\n\t\t\t\ttask: { type: \"string\", required: true, description: \"Registered task name.\" },\n\t\t\t\tphase: { type: \"string\", required: true, description: \"Invoked checkpoint phase.\" },\n\t\t\t\toutcome: { type: \"string\", required: true, description: \"Phase outcome.\" },\n\t\t\t},\n\t\t},\n\t\t\"pi.durable.tasks.active\": {\n\t\t\tkind: \"upDownCounter\",\n\t\t\tdescription: \"Live tasks held by this Harness; decremented at terminal settlement or close.\",\n\t\t\tattributes: { task: { type: \"string\", required: true, description: \"Registered task name.\" } },\n\t\t},\n\t},\n});\n"]}

package/dist/harness/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/harness/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,kBAAkB,EAAkB,MAAM,uBAAuB,CAAC;AAGpH,OAAO,KAAK,EAA6B,QAAQ,EAAqB,MAAM,uBAAuB,CAAC;AAQpG,OAAO,KAAK,EACX,cAAc,EACd,OAAO,EACP,UAAU,EACV,IAAI,EACJ,MAAM,EAIN,EAAE,EACF,UAAU,EACV,MAAM,aAAa,CAAC;AAarB,OAAO,KAAK,EACX,yBAAyB,EACzB,WAAW,EACX,cAAc,EAEd,mBAAmB,EAEnB,SAAS,EAET,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,MAAM,MAAM,aAAa,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,KAAK,CAAC;CAChB,CAAC;AAEL,MAAM,MAAM,kBAAkB,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE;AACnB,2FAA2F;GACzF;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAQ7G,kFAAkF;AAClF,MAAM,MAAM,eAAe,GAAG;IAC7B,mGAAmG;IACnG,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAChC,oHAAoH;IACpH,MAAM,CAAC,EAAE,kBAAkB,CAAC,yBAAyB,CAAC,CAAC;CACvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,iEAMxB,CAAC;AAKH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,oEAuFnB,CAAC;AAukBH,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAE/E;AAwCD;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,EAAE,EAAE,EAAE,EACN,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,OAAO,CAAC,UAAU,CAAC;IAAE,WAAW,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAAC,CAkBxD"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/harness/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,kBAAkB,EAAkB,MAAM,uBAAuB,CAAC;AAWpH,OAAO,KAAK,EAA6B,QAAQ,EAAqB,MAAM,uBAAuB,CAAC;AASpG,OAAO,KAAK,EACX,cAAc,EACd,OAAO,EACP,UAAU,EACV,IAAI,EACJ,MAAM,EAIN,EAAE,EACF,UAAU,EACV,MAAM,aAAa,CAAC;AAarB,OAAO,KAAK,EACX,yBAAyB,EACzB,WAAW,EACX,cAAc,EAEd,mBAAmB,EAEnB,SAAS,EAET,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,MAAM,MAAM,aAAa,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,KAAK,CAAC;CAChB,CAAC;AAEL,MAAM,MAAM,kBAAkB,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE;AACnB,2FAA2F;GACzF;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAQ7G,kFAAkF;AAClF,MAAM,MAAM,eAAe,GAAG;IAC7B,mGAAmG;IACnG,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAChC,oHAAoH;IACpH,MAAM,CAAC,EAAE,kBAAkB,CAAC,yBAAyB,CAAC,CAAC;CACvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,iEAQxB,CAAC;AAKH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,oEAuFnB,CAAC;AAsnBH,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAE/E;AAwCD;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,EAAE,EAAE,EAAE,EACN,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,OAAO,CAAC,UAAU,CAAC;IAAE,WAAW,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAAC,CAkBxD"}

package/dist/harness/tool.js

@@ -1,6 +1,7 @@
 import { copyJson } from "@earendil-works/chord";
 import { awaitWithContext } from "@earendil-works/chord/context";
 import { overlap } from "@earendil-works/chord/delta";
+import { boundOutput, OutputBuffer, PROGRESS_BYTES_PER_SECOND, Progress, } from "@earendil-works/chord/output";
 import { validateToolArguments } from "@earendil-works/pi-ai/utils/validation";
 import { Compile } from "typebox/compile";
 import { defineDocFamily } from "../documents.js";
@@ -8,10 +9,11 @@ import { AssistantEntry, ToolResultEntry } from "../entries.js";
 import { errorMessage } from "../errors.js";
 import { defineTask } from "../tasks.js";
 import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, utf8ByteLength } from "../truncate.js";
+import { toolExtension } from "./agent.js";
 import { assignJson } from "./json.js";
 import { clearProgress, finishSlot, LiveDoc, removeNestedSlots, toolSlot, } from "./live.js";
-import { boundOutput, OutputBuffer, PROGRESS_BYTES_PER_SECOND, Progress } from "./output.js";
 import { recordUsage } from "./usage.js";
+import { optionalExtension } from "./util.js";
 /**
  * Memo of a tool task that made a nested call, in any attempt, committed before the first admission of each attempt:
  * only then can `pi.live` hold slots below it, which settling removes. A crash between the two only costs a scan.
@@ -28,6 +30,8 @@ export const NestedCallDoc = defineDocFamily({
     scope: "task",
     family: true,
     initial: () => ({}),
+    // The document retires with its task.
+    checkpointWhen: () => false,
 });
 /**
  * Built-in tool task: resolves the called tool among its phase agent's tools, validates, runs `beforeTool`, records intent,
@@ -137,8 +141,13 @@ async function resolveTool(runtime, input, name, context) {
 }
 /** The call: from the input for a nested call, which hooks see with its parent, else from the assistant entry. */
 async function readCall(runtime, input, context) {
-    if (input.kind === "nested")
+    if (input.kind === "nested") {
+        context.telemetry.setAttributes({
+            "tool.name": input.call.name,
+            "tool.call_id": input.call.id,
+        });
         return { ...input.call, parent: { taskId: input.parent, callId: input.parentCallId } };
+    }
     const entry = await runtime.entry(AssistantEntry, input.assistant, context);
     const message = entry?.model?.[0];
     const call = message?.role === "assistant"
@@ -146,6 +155,10 @@ async function readCall(runtime, input, context) {
         : undefined;
     if (call === undefined)
         throw new Error(`Entry ${input.assistant} has no tool call ${input.callId}`);
+    context.telemetry.setAttributes({
+        "tool.name": call.name,
+        "tool.call_id": call.id,
+    });
     return call;
 }
 /** The call's arguments as repaired by the tool; a throwing repair makes them invalid. */
@@ -195,13 +208,21 @@ async function run(runtime, input, call, tool, args, context) {
         if (ended)
             throw new Error(`Tool call ${call.id} has settled`);
     };
+    /** Built for this call, below, so a rerun after recovery gets the conversation's environment at that time. */
+    let env;
     const api = {
         taskId: runtime.taskId,
         conversationId: runtime.conversationId,
         callId: call.id,
         registry: runtime.registry,
         agent: runtime.agent,
-        models: runtime.models,
+        get models() {
+            return runtime.models;
+        },
+        get env() {
+            return env;
+        },
+        now: () => runtime.now(),
         output: (chunk, skipped) => {
             assertLive();
             if (reported.output.push(chunk, skipped))
@@ -285,11 +306,10 @@ async function run(runtime, input, call, tool, args, context) {
     // Execution time of this attempt; a rerun after recovery measures only itself.
     let durationMs;
     try {
-        // Built for this call, so a rerun after recovery gets the conversation's environment at that time.
-        const env = await runtime.env(context);
+        env = await runtime.env(context);
         const startedAt = performance.now();
         try {
-            result = await tool.execute(args, { ...api, env }, context);
+            result = await tool.execute(args, api, context);
         }
         finally {
             durationMs = Math.round(performance.now() - startedAt);
@@ -325,6 +345,25 @@ async function run(runtime, input, call, tool, args, context) {
     for (const waiter of pending)
         waiter.resolve();
 }
+/**
+ * The Harness clock and timers for progress pacing. After the invocation ends nothing more commits, and the clock
+ * answers with the last time it read.
+ */
+function progressClock(runtime) {
+    let last = 0;
+    return {
+        now: () => {
+            try {
+                last = runtime.now();
+            }
+            catch {
+                // The invocation ended.
+            }
+            return last;
+        },
+        setTimer: (callback, delayMs) => runtime.setTimer(callback, delayMs),
+    };
+}
 /**
  * Throttled commits of what the tool reported into its slot, in `pi.live.tools` or `pi.live.nestedTools`, each writing
  * only what changed since the last one; none when `enabled` is false.
@@ -382,7 +421,7 @@ function publishProgress(runtime, reported, enabled, context) {
         // Rejections after an abort mark or close are expected; the committed state stays consistent.
         if (!runtime.signal.aborted)
             runtime.report(error);
-    }, runtime.settings.progress.outputIntervalMs);
+    }, runtime.settings.progress.outputIntervalMs, progressClock(runtime));
 }
 /**
  * The settled result: the tool's result with the retained output and last details as fallbacks, its diagnostics after
@@ -420,7 +459,9 @@ async function finalResult(runtime, input, call, tool, result, reported, context
         else {
             // The model never sees structured output, so its call stands; the host learns of the broken tool.
             final = rest;
-            runtime.report(new Error(broken));
+            // Only names the extension: a failed resolution leaves the report without the name.
+            const extension = await runtime.agent(context).then((agent) => toolExtension(agent, tool.name), () => undefined);
+            runtime.report(new Error(broken), { type: "extension", ...optionalExtension(extension) });
         }
     }
     // Programs get the tool's own value: without a schema, its output. The model reads only `output`, so model-issued
@@ -561,6 +602,7 @@ async function startNestedCall(runtime, parentCallId, name, args, options, conte
         arguments: copyJson(args, { omitUndefinedProperties: true }),
     };
     let id;
+    let replayed = false;
     await runtime.commit(async (tx) => {
         // Opened, or created empty for a key not made yet.
         const state = await tx.doc(NestedCallDoc, runtime.taskId, key, null);
@@ -573,6 +615,7 @@ async function startNestedCall(runtime, parentCallId, name, args, options, conte
             if (!same)
                 throw new Error(`Nested call ${call.id} was already made with another tool or other arguments`);
             id = existing;
+            replayed = state.result !== undefined;
             return undefined;
         }
         const input = {
@@ -603,6 +646,9 @@ async function startNestedCall(runtime, parentCallId, name, args, options, conte
         id = created;
         return undefined;
     }, context);
+    if (replayed) {
+        context.telemetry.addEvent("pi.durable.replay", { "tool.name": name });
+    }
     return id;
 }
 /**