@earendil-works/pi-durable 0.99.1 → 0.99.2

package/dist/harness/types.d.ts

@@ -1,6 +1,9 @@
-import type { Context, JsonValue } from "@earendil-works/chord";
-import type { CacheRetention, Message, Models, ModelThinkingLevel, Tool, ToolResultMessage, Transport, UserMessage } from "@earendil-works/pi-ai";
-import type { ConversationId, ConversationOwnership, ConversationRecord, Cursor, DocumentObserver, DocumentReader, EntryDraft, EntryId, EntryQuery, EntryRecord, JsonObject, Page, Session, SubmissionId, SubmissionRecord, Task, TaskId, TaskOptions, TaskRecord, TaskState, Tx } from "../types.ts";
+import type { AttachedReplicatedState, Context, JsonValue } from "@earendil-works/chord";
+import type { AssistantMessage, CacheRetention, Message, Models, ModelThinkingLevel, Tool, ToolCall, ToolResultMessage, Transport, Usage, UserMessage } from "@earendil-works/pi-ai";
+import type { ExecutionEnv } from "../env/index.ts";
+import type { ConversationId, ConversationOwnership, ConversationRecord, Cursor, DocumentObserver, DocumentReader, EntryDraft, EntryId, EntryQuery, EntryRecord, JsonObject, Page, Session, SubmissionId, SubmissionRecord, Task, TaskId, TaskOptions, TaskRecord, TaskState, Tx, WatchHandle } from "../types.ts";
+import type { UsageState } from "./usage.ts";
+import type { ConversationView } from "./view.ts";
 /** Provider and model ID resolved through pi-ai `Models`. */
 export type ModelRef = {
     readonly provider: string;
@@ -51,13 +54,27 @@ export type AnyTask = {
         readonly hooks?: object;
     };
 };
+/** Options of `Conversation.abort()`. */
+export type ConversationAbortOptions = {
+    /**
+     * Cross background boundaries: mark every live task reached ignoring the background flag when the abort is admitted,
+     * withdraw the queued inputs of every conversation reached, and wait until those tasks are terminal and the
+     * conversation is ordinarily idle. Background work created afterwards is neither marked nor awaited.
+     */
+    readonly background?: boolean;
+};
 /** Hook handler map declared by a task definition. */
 export type HooksOf<K> = K extends Task<infer _I, infer _S, infer _R, infer H> ? H : never;
-/** Invocation-bound conversation operations available to tools. */
+/**
+ * Invocation-bound conversation operations for tasks and tools. Rejects after the invocation ends; passive entries are
+ * written with ordinary transaction writes instead.
+ */
 export interface ConversationHandle {
     readonly id: ConversationId;
     submit(submission: InputSubmissionDraft, context: Context): Promise<Submission>;
-    abort(context: Context): Promise<void>;
+    /** `Conversation.abort()`: withdraw queued inputs, abort the ordinary ownership scope, and wait until it is idle. */
+    abort(context: Context, options?: ConversationAbortOptions): Promise<void>;
+    /** Resolve when the conversation's ordinary ownership scope has no live non-background task. */
     waitForIdle(context: Context): Promise<void>;
 }
 /** Post-tools controls requested by a tool result. */
@@ -66,19 +83,42 @@ export type ToolControl = {
     readonly terminate?: true;
     readonly handoff?: string;
 };
+/** Remark about a call for the model and the UI, such as truncation or a spill path; never part of the tool's data. */
+export type ToolDiagnostic = {
+    readonly severity: "info" | "warn" | "error";
+    readonly message: string;
+    readonly code?: string;
+};
 export type ToolExecutionResult = {
+    /** Omitted: the retained `output()` text becomes the content. */
     readonly content?: ToolResultMessage["content"];
     readonly isError?: boolean;
+    /** Omitted: the last `details()` value becomes the details. */
     readonly details?: JsonValue;
+    /** Added after those recorded through `api.diagnostic()`. */
+    readonly diagnostics?: readonly ToolDiagnostic[];
+    /** Spend of the execution itself, such as a model call; stored on the result and in `pi.usage.tools`. */
+    readonly usage?: Usage;
     readonly control?: ToolControl;
 };
-/** Operations available to one tool invocation. */
+/** Whether the tools of one round run at once or one after another in call order. */
+export type ToolExecutionMode = "parallel" | "sequential";
+/** How many queued items of one mode a boundary places: the first, or all of them. */
+export type QueueMode = "all" | "one-at-a-time";
+/**
+ * Operations available to one tool invocation. A plain object, so a wrapper can pass `{ ...api, env }` to the tool it
+ * wraps. Every operation rejects after the invocation ends.
+ */
 export interface ToolExecutionApi extends DocumentObserver, DocumentReader {
     readonly taskId: TaskId;
     readonly conversationId: ConversationId;
     readonly callId: string;
+    /** `HarnessOptions.env` unless a wrapper supplies another environment. */
+    readonly env: ExecutionEnv | undefined;
     /** Append running output; it becomes the result content when the result omits `content`. */
     output(chunk: string | Uint8Array): void;
+    /** Record a model-visible remark about this call. */
+    diagnostic(diagnostic: ToolDiagnostic): void;
     /** Replace running details; the last value becomes the result details when the result omits `details`. */
     details(value: JsonValue, context: Context): Promise<void>;
     commit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;
@@ -89,12 +129,20 @@ export interface ToolExecutionApi extends DocumentObserver, DocumentReader {
     }, R, H extends object>(task: Task<I, S, R, H>, input: I, options: Omit<TaskOptions, "conversationId">, context: Context): Promise<TaskId<R>>;
     getTask<R>(id: TaskId<R>, context: Context): Promise<TaskRecord<JsonValue, JsonValue, R> | undefined>;
     waitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;
+    /** Invocation-bound handle of an existing conversation, such as one this tool created in `commit()`. */
     conversation(id: ConversationId, context: Context): Promise<ConversationHandle | undefined>;
 }
 /** Executable tool registered in a registry. Only pi-ai `Tool` fields enter the transcript. */
 export type ToolRegistration = Tool & {
     /** Whether an interrupted execution may rerun on recovery. Default `unsafe`. */
     readonly replay?: "safe" | "unsafe";
+    /** Default: the conversation's `toolExecution`. One sequential call makes its whole round sequential. */
+    readonly executionMode?: ToolExecutionMode;
+    /**
+     * Repair arguments models commonly get wrong before validation, such as a JSON string where an array belongs. Must be
+     * pure and must not mutate `args`: it runs again when a call is retried before its intent is recorded.
+     */
+    prepareArguments?(args: JsonValue): JsonValue;
     readonly outputLimits?: {
         readonly maxBytes?: number;
         readonly maxLines?: number;
@@ -246,10 +294,33 @@ export type ConversationRetryPolicy = {
     baseDelayMs: number;
     maxAgentDelayMs?: number;
 };
+/** Automatic compaction thresholds (spec §8.7); manual compaction ignores `enabled`. */
+export type CompactionPolicy = {
+    /** Threshold and overflow compaction. */
+    enabled: boolean;
+    /** Room kept free for the answer: generation blocks to compact above `contextWindow - reserveTokens`. */
+    reserveTokens: number;
+    /** Approximate size of the recent context a summary keeps verbatim. */
+    keepRecentTokens: number;
+    /** Background compaction starts `backgroundTokens` below the blocking threshold; `0` disables it. */
+    backgroundTokens: number;
+};
+/** Why a compaction runs: `compact()`, a threshold in generation preparation, or a context overflow. */
+export type CompactionReason = "manual" | "threshold" | "overflow";
+/**
+ * `entryId` of a blocking compaction's summary, or the `submissionId` of a conversation-owned compaction's summary
+ * write; both absent when nothing was compacted.
+ */
+export type CompactionResult = {
+    entryId?: EntryId;
+    submissionId?: SubmissionId;
+};
 export type HarnessOptions<Tool extends ToolRegistration = ToolRegistration> = {
     /** pi-ai model access used by generation. */
     readonly models: Models;
     readonly registry: RegistryReader<Tool>;
+    /** Default execution environment offered to tools as `api.env`. */
+    readonly env?: ExecutionEnv;
     readonly now?: () => number;
     /** Receives extension failures that do not fail the calling operation. Must not throw. */
     readonly onReport?: (error: unknown) => void;
@@ -265,11 +336,18 @@ export type TaskInspection = {
         readonly kind: "ready";
         readonly migrates: boolean;
     }
-    /** Pending until these tasks are terminal. */
+    /**
+     * Waits for these live tasks: the live part of its `on`, or, when abort-marked, its live ordinary owned work, which
+     * must end before its abort handler starts.
+     */
      | {
         readonly kind: "waiting";
         readonly on: readonly TaskId[];
     }
+    /** Outcome held until its ordinary owned work drains. */
+     | {
+        readonly kind: "completing";
+    }
     /** No registered definition can take it; aborting it settles it as `orphaned`. */
      | {
         readonly kind: "blocked";
@@ -292,6 +370,8 @@ export type ContextView = {
     readonly head: EntryRecord | undefined;
     /** Raw active entries: the head marker followed by non-head entries from its head through the tail. */
     readonly entries: readonly EntryRecord[];
+    /** Per entry of `entries`, its model messages after edits and excluded stop reasons, before tool result ordering. */
+    readonly contributions: readonly (readonly Message[])[];
     /** Model context for the next provider request. */
     readonly messages: readonly Message[];
 };
@@ -311,19 +391,57 @@ export interface Conversation {
     getRetryPolicy(context: Context): Promise<ConversationRetryPolicy>;
     /** `undefined` removes the configured policy. */
     setRetryPolicy(policy: ConversationRetryPolicy | undefined, context: Context): Promise<void>;
+    /** `parallel` when unset. */
+    getToolExecution(context: Context): Promise<ToolExecutionMode>;
+    /** `undefined` removes the configured mode. */
+    setToolExecution(mode: ToolExecutionMode | undefined, context: Context): Promise<void>;
+    /** `one-at-a-time` when unset. */
+    getSteeringMode(context: Context): Promise<QueueMode>;
+    /** `undefined` removes the configured mode. */
+    setSteeringMode(mode: QueueMode | undefined, context: Context): Promise<void>;
+    /** `one-at-a-time` when unset. */
+    getFollowUpMode(context: Context): Promise<QueueMode>;
+    /** `undefined` removes the configured mode. */
+    setFollowUpMode(mode: QueueMode | undefined, context: Context): Promise<void>;
+    /** `DEFAULT_COMPACTION_POLICY` when unset. */
+    getCompaction(context: Context): Promise<CompactionPolicy>;
+    /** `undefined` removes the configured policy. */
+    setCompaction(policy: CompactionPolicy | undefined, context: Context): Promise<void>;
     /**
-     * Durably admit user input or a passive entry write. Until the inbox exists, a busy conversation rejects every
-     * submission with `ConversationBusy`.
+     * Durably admit user input or a passive entry write. A busy conversation, or one with queued items, queues it in
+     * `pi.inbox`; `whenBusy: "reject"` rejects with `ConversationBusy` instead and writes nothing.
      */
     submit(submission: SubmissionDraft, context: Context): Promise<Submission>;
+    /**
+     * Admit a write of a `pi.reset` entry that starts a new context, carrying `handoff` as a user message when given.
+     * Resolves after admission; while busy, it is placed at the next boundary.
+     */
+    reset(handoff: string | undefined, context: Context): Promise<void>;
+    /**
+     * Admit a manual compaction task and return its ID. It summarizes while the conversation keeps working and places its
+     * summary through a write submission: at once when idle, otherwise at the next boundary (spec §8.7).
+     */
+    compact(instructions: string | undefined, context: Context): Promise<TaskId<CompactionResult>>;
     /** Session commit whose `tx.createTask()` defaults to this conversation. */
     commit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;
     context(context: Context): Promise<ContextView>;
     /** Newest-first fork-aware history of this conversation. */
     entries(query: Omit<EntryQuery, "conversationId">, limit: number, cursor: Cursor | undefined, context: Context): Promise<Page<EntryRecord, Cursor>>;
     fork(at: EntryId, options: ConversationCreateOptions, context: Context): Promise<Conversation>;
-    /** Resolve when no live non-background task belongs to this conversation. */
+    /**
+     * Withdraw queued inputs (queued writes stay), mark every live non-background task of the ordinary ownership scope,
+     * signal them, and resolve once the scope is idle. Background subtrees survive unless `background` is set.
+     */
+    abort(context: Context, options?: ConversationAbortOptions): Promise<void>;
+    /**
+     * Resolve when the ordinary ownership scope has no live non-background task: this conversation and the conversations
+     * owned, transitively, by its non-background tasks.
+     */
     waitForIdle(context: Context): Promise<void>;
+    /** The structural view (spec §9.3) as a disposable read-only Chord state. */
+    viewState(context: Context): Promise<AttachedReplicatedState<ConversationView>>;
+    /** The structural view as a serialized exact-frame watch with bounded pending frames. */
+    watch(context: Context): Promise<WatchHandle<ConversationView>>;
 }
 /** Durable agent harness over one Session. */
 export interface Harness extends Session {
@@ -352,7 +470,63 @@ export interface Harness extends Session {
     abortTask(id: TaskId, context: Context): Promise<"marked" | "terminal">;
     /** Resolve with the terminal receipt; cancelling `context` cancels only this wait. */
     waitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;
-    /** Resolve when no live non-background task exists. */
+    /** Resolve when the ordinary ownership scope of every ownerless conversation has no live non-background task. */
     waitForIdle(context: Context): Promise<void>;
+    /** Session total: every conversation's `pi.usage` summed. */
+    usage(context: Context): Promise<UsageState>;
+}
+/** What a hook may use: committed reads and the asking task's memos, which hooks and the task share. */
+export interface HookApi extends DocumentReader {
+    readonly taskId: TaskId;
+    readonly conversationId: ConversationId;
+    memo<T extends JsonValue>(name: string, context: Context): Promise<T | undefined>;
+    memo<T extends JsonValue>(name: string, candidate: T, context: Context): Promise<T>;
+}
+export type HookResult<T> = T | undefined | Promise<T | undefined>;
+/** Hooks of the built-in generation task. */
+export interface GenerationHooks {
+    /** Before every request attempt, including recovery; the result is used for that request only. */
+    beforeRequest(request: {
+        readonly messages: readonly Message[];
+    }, api: HookApi, context: Context): HookResult<{
+        readonly messages: readonly Message[];
+    }>;
+    /** Every terminal provider message, before classification. */
+    afterResponse(message: AssistantMessage, api: HookApi, context: Context): void | Promise<void>;
+    /** A final answer; the first `continue` appends a user message and continues the run. */
+    onYield(answer: AssistantMessage, api: HookApi, context: Context): HookResult<{
+        readonly continue: UserInput;
+    }>;
+    /** After every tool of the round is terminal; `results` are the round's result entries in call order. */
+    afterTools(assistant: EntryId, results: readonly EntryId[], api: HookApi, context: Context): void | Promise<void>;
+}
+/** Hooks of the built-in tool task. */
+export interface ToolHooks {
+    /** Before intent; the first `block` wins, otherwise `arguments` replace the call's arguments. A throw blocks. */
+    beforeTool(call: ToolCall, api: HookApi, context: Context): HookResult<{
+        readonly arguments?: JsonObject;
+        readonly block?: string;
+    }>;
+    /** After execution, before the result entry; replaces the result. */
+    afterTool(call: ToolCall, result: ToolExecutionResult, api: HookApi, context: Context): HookResult<ToolExecutionResult>;
+}
+/** Hooks of the built-in compaction task. */
+export interface CompactionHooks {
+    /**
+     * After range selection, before summarizing; the first decision wins. `entries` are the active entries the summary
+     * replaces, the head marker first, and `messages` their model context, the summarizer's source; `firstKept` is the
+     * first entry kept verbatim.
+     */
+    beforeCompact(compaction: {
+        readonly reason: CompactionReason;
+        readonly entries: readonly EntryRecord[];
+        readonly messages: readonly Message[];
+        readonly firstKept: EntryId;
+        readonly instructions?: string;
+    }, api: HookApi, context: Context): HookResult<{
+        readonly decline: true;
+    } | {
+        readonly summary: string;
+    }>;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"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"}

package/dist/harness/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Context, JsonValue } from \"@earendil-works/chord\";\nimport type {\n\tCacheRetention,\n\tMessage,\n\tModels,\n\tModelThinkingLevel,\n\tTool,\n\tToolResultMessage,\n\tTransport,\n\tUserMessage,\n} from \"@earendil-works/pi-ai\";\nimport type {\n\tConversationId,\n\tConversationOwnership,\n\tConversationRecord,\n\tCursor,\n\tDocumentObserver,\n\tDocumentReader,\n\tEntryDraft,\n\tEntryId,\n\tEntryQuery,\n\tEntryRecord,\n\tJsonObject,\n\tPage,\n\tSession,\n\tSubmissionId,\n\tSubmissionRecord,\n\tTask,\n\tTaskId,\n\tTaskOptions,\n\tTaskRecord,\n\tTaskState,\n\tTx,\n} from \"../types.ts\";\n\n/** Provider and model ID resolved through pi-ai `Models`. */\nexport type ModelRef = {\n\treadonly provider: string;\n\treadonly modelId: string;\n};\n\nexport type UserInput = UserMessage[\"content\"];\n\n/** Host submission: user input that may start a run, or a passive entry write. */\nexport type SubmissionDraft = {\n\treadonly requestId?: string;\n} & (\n\t| {\n\t\t\treadonly type: \"input\";\n\t\t\treadonly content: UserInput;\n\t\t\treadonly whenBusy?: \"steer\" | \"followUp\" | \"reject\";\n\t\t\treadonly entry?: never;\n\t  }\n\t| {\n\t\t\treadonly type: \"write\";\n\t\t\treadonly entry: EntryDraft;\n\t\t\treadonly content?: never;\n\t\t\treadonly whenBusy?: never;\n\t  }\n);\n\nexport type InputSubmissionDraft = Extract<SubmissionDraft, { readonly type: \"input\" }>;\n\nexport type SettledSubmissionRecord = SubmissionRecord & {\n\treadonly status: \"done\" | \"unanswered\";\n};\n\n/** Awaitable host object for one durably admitted submission. */\nexport interface Submission {\n\treadonly id: SubmissionId;\n\tstatus(context: Context): Promise<SubmissionRecord>;\n\twait(context: Context): Promise<SettledSubmissionRecord>;\n\tabort(context: Context): Promise<\"aborted\" | \"already_placed\" | \"settled\">;\n}\n\nexport type SettledTask<R> = TaskRecord<JsonValue, JsonValue, R> & {\n\treadonly state: Extract<TaskState<JsonValue, R>, { readonly status: \"terminal\" }>;\n};\n\n/** Erased executable task definition stored in the registry. */\nexport type AnyTask = {\n\treadonly definition: {\n\t\treadonly name: string;\n\t\treadonly version: number;\n\t\treadonly initial: unknown;\n\t\treadonly phases: Readonly<Record<string, unknown>>;\n\t\treadonly abort: unknown;\n\t\treadonly migrate?: unknown;\n\t\treadonly hooks?: object;\n\t};\n};\n\n/** Hook handler map declared by a task definition. */\nexport type HooksOf<K> = K extends Task<infer _I, infer _S, infer _R, infer H> ? H : never;\n\n/** Invocation-bound conversation operations available to tools. */\nexport interface ConversationHandle {\n\treadonly id: ConversationId;\n\tsubmit(submission: InputSubmissionDraft, context: Context): Promise<Submission>;\n\tabort(context: Context): Promise<void>;\n\twaitForIdle(context: Context): Promise<void>;\n}\n\n/** Post-tools controls requested by a tool result. */\nexport type ToolControl = {\n\treadonly addTools?: readonly string[];\n\treadonly terminate?: true;\n\treadonly handoff?: string;\n};\n\nexport type ToolExecutionResult = {\n\treadonly content?: ToolResultMessage[\"content\"];\n\treadonly isError?: boolean;\n\treadonly details?: JsonValue;\n\treadonly control?: ToolControl;\n};\n\n/** Operations available to one tool invocation. */\nexport interface ToolExecutionApi extends DocumentObserver, DocumentReader {\n\treadonly taskId: TaskId;\n\treadonly conversationId: ConversationId;\n\treadonly callId: string;\n\t/** Append running output; it becomes the result content when the result omits `content`. */\n\toutput(chunk: string | Uint8Array): void;\n\t/** Replace running details; the last value becomes the result details when the result omits `details`. */\n\tdetails(value: JsonValue, context: Context): Promise<void>;\n\tcommit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;\n\tmemo<T extends JsonValue>(name: string, context: Context): Promise<T | undefined>;\n\tmemo<T extends JsonValue>(name: string, candidate: T, context: Context): Promise<T>;\n\tcreateTask<I, S extends { phase: string }, R, H extends object>(\n\t\ttask: Task<I, S, R, H>,\n\t\tinput: I,\n\t\toptions: Omit<TaskOptions, \"conversationId\">,\n\t\tcontext: Context,\n\t): Promise<TaskId<R>>;\n\tgetTask<R>(id: TaskId<R>, context: Context): Promise<TaskRecord<JsonValue, JsonValue, R> | undefined>;\n\twaitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;\n\tconversation(id: ConversationId, context: Context): Promise<ConversationHandle | undefined>;\n}\n\n/** Executable tool registered in a registry. Only pi-ai `Tool` fields enter the transcript. */\nexport type ToolRegistration = Tool & {\n\t/** Whether an interrupted execution may rerun on recovery. Default `unsafe`. */\n\treadonly replay?: \"safe\" | \"unsafe\";\n\treadonly outputLimits?: {\n\t\treadonly maxBytes?: number;\n\t\treadonly maxLines?: number;\n\t\treadonly retain?: \"head\" | \"tail\";\n\t};\n\texecute(args: JsonValue, api: ToolExecutionApi, context: Context): Promise<ToolExecutionResult>;\n};\n\n/** Token for removing registrations. Work already running keeps using what it started with. */\nexport interface Registration {\n\t/** Idempotent; removes exactly the registrations this token covers. */\n\tdispose(): void;\n}\n\n/** Pure decorator; returns a new tool with the same name and never mutates its input. */\nexport type ToolWrapper<Tool extends ToolRegistration> = (tool: Tool) => Tool;\n\n/** Conversation selection for a scoped hook registration. */\nexport type HookScope = {\n\treadonly conversationId: ConversationId;\n\t/** Also match conversations owned, transitively, by tasks of this conversation. */\n\treadonly subtree?: boolean;\n};\n\n/** Input to system prompt section rendering for one request preparation. */\nexport type PromptInput<Tool extends ToolRegistration> = {\n\treadonly conversationId: ConversationId;\n\t/** Active and registered tools in configured order, as offered in this request. */\n\treadonly tools: readonly Tool[];\n\t/** Sections already in effect after replaying the active transcript. */\n\treadonly shown: Readonly<Record<string, string>>;\n\treadonly model?: ModelRef;\n\treadonly thinkingLevel: ModelThinkingLevel;\n\t/** Committed document reads. */\n\treadonly read: DocumentReader;\n};\n\n/** One registered system prompt section; sections render in registry order before each request. */\nexport type PromptSection<Tool extends ToolRegistration> = {\n\treadonly key: string;\n\trender(input: PromptInput<Tool>, context: Context): string | undefined | Promise<string | undefined>;\n\t/** Default true: wrap the text as `<key>\\n...\\n</key>`. */\n\treadonly tag?: boolean;\n};\n\n/** Pure decorator; returns a new section with the same key and never mutates its input. */\nexport type PromptSectionWrapper<Tool extends ToolRegistration> = (section: PromptSection<Tool>) => PromptSection<Tool>;\n\n/** One registered hook handler map for task `K`. */\nexport type HookRegistration<K extends AnyTask> = {\n\treadonly handlers: Partial<HooksOf<K>>;\n\treadonly scope?: HookScope;\n};\n\n/** Wrapper composition failure found while building a snapshot. */\nexport type RegistryFailure = {\n\treadonly kind: \"tool\" | \"section\";\n\t/** Tool name or section key. */\n\treadonly name: string;\n\treadonly error: unknown;\n};\n\n/** Immutable view of one published registry state. */\nexport interface RegistrySnapshot<Tool extends ToolRegistration = ToolRegistration> {\n\t/** Composed tools in registry order; a tool whose wrapper failed is absent. */\n\ttools(): readonly Tool[];\n\ttool(name: string): Tool | undefined;\n\t/** Base tool names in registry order, including tools whose wrappers fail. */\n\ttoolNames(): readonly string[];\n\ttask(name: string): AnyTask | undefined;\n\t/** Hooks registered for tasks with `task`'s name, in registry order. */\n\thooks<K extends AnyTask>(task: K): readonly HookRegistration<K>[];\n\t/** Composed sections in registry order; a section whose wrapper failed is absent. */\n\tsections(): readonly PromptSection<Tool>[];\n\t/** Wrapper failures of this state. */\n\tfailures(): readonly RegistryFailure[];\n\t/** Conversation setups in registry order, the built-in `pi` setup first. */\n\tconversationSetups(): readonly { readonly key: string; readonly setup: ConversationSetup }[];\n}\n\n/** Read side of a registry consumed by a Harness. */\nexport interface RegistryReader<Tool extends ToolRegistration = ToolRegistration> {\n\t/** Immutable view of the whole current registry. */\n\tsnapshot(): RegistrySnapshot<Tool>;\n\t/** Called synchronously after every publication; wakes the scheduler to reconsider blocked tasks. */\n\tsubscribe(listener: () => void): () => void;\n}\n\n/** Application-owned registry of tools, hooks, tasks, and the system prompt. */\nexport interface Registry<Tool extends ToolRegistration = ToolRegistration> extends RegistryReader<Tool> {\n\treadonly tools: {\n\t\tadd(tool: Tool): Registration;\n\t\t/** `key` identifies the wrapper: it orders wrappers of one tool and keeps its position on re-registration. */\n\t\twrap(name: string, key: string, wrapper: ToolWrapper<Tool>): Registration;\n\t\t/** Composed tools of the current state. */\n\t\tlist(): readonly Tool[];\n\t};\n\treadonly hooks: {\n\t\tadd<K extends AnyTask>(\n\t\t\ttask: K,\n\t\t\thandlers: Partial<HooksOf<K>>,\n\t\t\toptions?: { readonly scope?: HookScope; readonly key?: string },\n\t\t): Registration;\n\t};\n\treadonly tasks: {\n\t\tadd(task: AnyTask): Registration;\n\t\tlist(): readonly AnyTask[];\n\t};\n\treadonly conversations: {\n\t\t/** `key` orders setups and keeps its position on re-registration. */\n\t\tsetup(key: string, setup: ConversationSetup): Registration;\n\t};\n\treadonly systemPrompt: {\n\t\tsection(key: string, render: PromptSection<Tool>[\"render\"], options?: { readonly tag?: boolean }): Registration;\n\t\twrap(key: string, wrapperKey: string, wrapper: PromptSectionWrapper<Tool>): Registration;\n\t\t/** Composed sections of the current state. */\n\t\tsections(): readonly PromptSection<Tool>[];\n\t};\n\t/** Stage registrations and disposals made synchronously by `register`, then publish them at once. Cannot nest. */\n\tbatch(register: () => void): Registration;\n}\n\n/**\n * Stages the documents every new conversation gets. Runs inside every Harness commit that creates or forks a\n * conversation, including raw `Tx` creation, after fork copies and before host `init`. Table reads throw, since the\n * conversation write came first; a fork (`conversation.parent`) already holds its copied documents. A throw fails the\n * creating commit.\n */\nexport type ConversationSetup = (\n\ttx: Tx,\n\tconversation: ConversationRecord,\n\tregistry: RegistrySnapshot,\n) => void | Promise<void>;\n\n/**\n * Runs inside the creating commit, after the conversation and its configuration exist. The conversation creation is\n * already a table write, so table reads here throw `ReadAfterWrite`; document access remains available.\n */\nexport type ConversationInit = (tx: Tx, conversationId: ConversationId) => void | Promise<void>;\n\nexport type ConversationCreateOptions = {\n\treadonly ownership: ConversationOwnership;\n\treadonly init?: ConversationInit;\n};\n\n/** Curated pi-ai request options; absent fields use pi-ai defaults. */\nexport type ConversationStreamOptions = {\n\ttransport?: Transport;\n\ttimeoutMs?: number;\n\t/** Provider/SDK retries inside one request attempt. */\n\tmaxRetries?: number;\n\tmaxRetryDelayMs?: number;\n\theaders?: Record<string, string>;\n\tmetadata?: JsonObject;\n\tcacheRetention?: CacheRetention;\n\tdeferred?: boolean | { window?: \"15m\" | \"1h\" | \"24h\" };\n};\n\n/** Durable generation attempt retries; the JSON shape of pi-ai `RetryPolicy`. */\nexport type ConversationRetryPolicy = {\n\tenabled: boolean;\n\tmaxRetries: number;\n\tbaseDelayMs: number;\n\tmaxAgentDelayMs?: number;\n};\n\nexport type HarnessOptions<Tool extends ToolRegistration = ToolRegistration> = {\n\t/** pi-ai model access used by generation. */\n\treadonly models: Models;\n\treadonly registry: RegistryReader<Tool>;\n\treadonly now?: () => number;\n\t/** Receives extension failures that do not fail the calling operation. Must not throw. */\n\treadonly onReport?: (error: unknown) => void;\n};\n\n/** Live task and what the scheduler would do with it under the current registry. */\nexport type TaskInspection = {\n\treadonly record: TaskRecord<JsonValue, JsonValue, JsonValue>;\n\treadonly state: /** An invocation is active. */\n\t\t| { readonly kind: \"running\" }\n\t\t/** The next scheduling pass reserves it; `migrates` when its definition is newer and has `migrate`. */\n\t\t| { readonly kind: \"ready\"; readonly migrates: boolean }\n\t\t/** Pending until these tasks are terminal. */\n\t\t| { readonly kind: \"waiting\"; readonly on: readonly TaskId[] }\n\t\t/** No registered definition can take it; aborting it settles it as `orphaned`. */\n\t\t| {\n\t\t\t\treadonly kind: \"blocked\";\n\t\t\t\treadonly reason: \"missing_task\" | \"task_too_old\" | \"migration_failed\";\n\t\t\t\treadonly error?: unknown;\n\t\t  };\n};\n\n/** Point-in-time view of live work: unfinished tasks and submissions, read on the Session line. */\nexport type HarnessInspection = {\n\treadonly scheduling: \"paused\" | \"running\" | \"closing\";\n\treadonly tasks: readonly TaskInspection[];\n\t/** Queued and placed submissions, in ID order. */\n\treadonly submissions: readonly SubmissionRecord[];\n\t/** Wrapper failures of the current registry snapshot. */\n\treadonly registry: readonly RegistryFailure[];\n};\n\n/** Raw active transcript and derived model context. */\nexport type ContextView = {\n\t/** Newest applicable head marker, if any. */\n\treadonly head: EntryRecord | undefined;\n\t/** Raw active entries: the head marker followed by non-head entries from its head through the tail. */\n\treadonly entries: readonly EntryRecord[];\n\t/** Model context for the next provider request. */\n\treadonly messages: readonly Message[];\n};\n\n/** Stateless handle for one conversation, bound to the Harness that returned it. Compare handles by `id`. */\nexport interface Conversation {\n\treadonly id: ConversationId;\n\n\tgetModel(context: Context): Promise<ModelRef | undefined>;\n\tsetModel(model: ModelRef | undefined, context: Context): Promise<void>;\n\tgetThinkingLevel(context: Context): Promise<ModelThinkingLevel>;\n\tsetThinkingLevel(level: ModelThinkingLevel, context: Context): Promise<void>;\n\tgetActiveTools(context: Context): Promise<readonly string[]>;\n\tsetActiveTools(names: readonly string[], context: Context): Promise<void>;\n\t/** `{}` when unset. */\n\tgetStreamOptions(context: Context): Promise<ConversationStreamOptions>;\n\tsetStreamOptions(options: ConversationStreamOptions, context: Context): Promise<void>;\n\t/** The default policy when unset. */\n\tgetRetryPolicy(context: Context): Promise<ConversationRetryPolicy>;\n\t/** `undefined` removes the configured policy. */\n\tsetRetryPolicy(policy: ConversationRetryPolicy | undefined, context: Context): Promise<void>;\n\n\t/**\n\t * Durably admit user input or a passive entry write. Until the inbox exists, a busy conversation rejects every\n\t * submission with `ConversationBusy`.\n\t */\n\tsubmit(submission: SubmissionDraft, context: Context): Promise<Submission>;\n\n\t/** Session commit whose `tx.createTask()` defaults to this conversation. */\n\tcommit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;\n\tcontext(context: Context): Promise<ContextView>;\n\t/** Newest-first fork-aware history of this conversation. */\n\tentries(\n\t\tquery: Omit<EntryQuery, \"conversationId\">,\n\t\tlimit: number,\n\t\tcursor: Cursor | undefined,\n\t\tcontext: Context,\n\t): Promise<Page<EntryRecord, Cursor>>;\n\tfork(at: EntryId, options: ConversationCreateOptions, context: Context): Promise<Conversation>;\n\t/** Resolve when no live non-background task belongs to this conversation. */\n\twaitForIdle(context: Context): Promise<void>;\n}\n\n// TODO: decide how Harness exposes subscribeCommits() and subscribeClose(). Their listeners run on the Session line\n// and must not throw or call Session APIs, and Harness close will also join task invocations.\n/** Durable agent harness over one Session. */\nexport interface Harness extends Session {\n\t/**\n\t * Enable task scheduling. Idempotent; throws after close. Calls that wait for progress (`Conversation.submit()`,\n\t * `Submission.wait()`, `waitForTask()`, `waitForIdle()`) enable it too.\n\t */\n\tresume(): void;\n\n\t/** Return the reserved root conversation, creating it with `init` in one commit when absent. */\n\troot(context: Context, options?: { readonly init?: ConversationInit }): Promise<Conversation>;\n\t// Conversation activity (active/idle notifications) is specified with run control in Package 17.\n\tconversation(id: ConversationId, context: Context): Promise<Conversation | undefined>;\n\tcreateConversation(options: ConversationCreateOptions, context: Context): Promise<Conversation>;\n\n\tgetTask<R>(id: TaskId<R>, context: Context): Promise<TaskRecord<JsonValue, JsonValue, R> | undefined>;\n\t/** Live tasks, unsettled submissions, and registry failures. Writes nothing and runs no task code. */\n\tinspect(context: Context): Promise<HarnessInspection>;\n\t/** Reacquire a submission, for example after reopen. */\n\tsubmission(id: SubmissionId, context: Context): Promise<Submission | undefined>;\n\t/** `not_found` for an unknown submission or one of another conversation than `conversationId`. */\n\tabortSubmission(\n\t\tid: SubmissionId,\n\t\tcontext: Context,\n\t\tconversationId?: ConversationId,\n\t): Promise<\"aborted\" | \"already_placed\" | \"settled\" | \"not_found\">;\n\t/**\n\t * Commit the abort mark, signal and join an active run invocation, and schedule the abort invocation. A task whose\n\t * definition cannot take it settles as `orphaned` instead.\n\t */\n\tabortTask(id: TaskId, context: Context): Promise<\"marked\" | \"terminal\">;\n\t/** Resolve with the terminal receipt; cancelling `context` cancels only this wait. */\n\twaitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;\n\t/** Resolve when no live non-background task exists. */\n\twaitForIdle(context: Context): Promise<void>;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AttachedReplicatedState, Context, JsonValue } from \"@earendil-works/chord\";\nimport type {\n\tAssistantMessage,\n\tCacheRetention,\n\tMessage,\n\tModels,\n\tModelThinkingLevel,\n\tTool,\n\tToolCall,\n\tToolResultMessage,\n\tTransport,\n\tUsage,\n\tUserMessage,\n} from \"@earendil-works/pi-ai\";\nimport type { ExecutionEnv } from \"../env/index.ts\";\nimport type {\n\tConversationId,\n\tConversationOwnership,\n\tConversationRecord,\n\tCursor,\n\tDocumentObserver,\n\tDocumentReader,\n\tEntryDraft,\n\tEntryId,\n\tEntryQuery,\n\tEntryRecord,\n\tJsonObject,\n\tPage,\n\tSession,\n\tSubmissionId,\n\tSubmissionRecord,\n\tTask,\n\tTaskId,\n\tTaskOptions,\n\tTaskRecord,\n\tTaskState,\n\tTx,\n\tWatchHandle,\n} from \"../types.ts\";\nimport type { UsageState } from \"./usage.ts\";\nimport type { ConversationView } from \"./view.ts\";\n\n/** Provider and model ID resolved through pi-ai `Models`. */\nexport type ModelRef = {\n\treadonly provider: string;\n\treadonly modelId: string;\n};\n\nexport type UserInput = UserMessage[\"content\"];\n\n/** Host submission: user input that may start a run, or a passive entry write. */\nexport type SubmissionDraft = {\n\treadonly requestId?: string;\n} & (\n\t| {\n\t\t\treadonly type: \"input\";\n\t\t\treadonly content: UserInput;\n\t\t\treadonly whenBusy?: \"steer\" | \"followUp\" | \"reject\";\n\t\t\treadonly entry?: never;\n\t  }\n\t| {\n\t\t\treadonly type: \"write\";\n\t\t\treadonly entry: EntryDraft;\n\t\t\treadonly content?: never;\n\t\t\treadonly whenBusy?: never;\n\t  }\n);\n\nexport type InputSubmissionDraft = Extract<SubmissionDraft, { readonly type: \"input\" }>;\n\nexport type SettledSubmissionRecord = SubmissionRecord & {\n\treadonly status: \"done\" | \"unanswered\";\n};\n\n/** Awaitable host object for one durably admitted submission. */\nexport interface Submission {\n\treadonly id: SubmissionId;\n\tstatus(context: Context): Promise<SubmissionRecord>;\n\twait(context: Context): Promise<SettledSubmissionRecord>;\n\tabort(context: Context): Promise<\"aborted\" | \"already_placed\" | \"settled\">;\n}\n\nexport type SettledTask<R> = TaskRecord<JsonValue, JsonValue, R> & {\n\treadonly state: Extract<TaskState<JsonValue, R>, { readonly status: \"terminal\" }>;\n};\n\n/** Erased executable task definition stored in the registry. */\nexport type AnyTask = {\n\treadonly definition: {\n\t\treadonly name: string;\n\t\treadonly version: number;\n\t\treadonly initial: unknown;\n\t\treadonly phases: Readonly<Record<string, unknown>>;\n\t\treadonly abort: unknown;\n\t\treadonly migrate?: unknown;\n\t\treadonly hooks?: object;\n\t};\n};\n\n/** Options of `Conversation.abort()`. */\nexport type ConversationAbortOptions = {\n\t/**\n\t * Cross background boundaries: mark every live task reached ignoring the background flag when the abort is admitted,\n\t * withdraw the queued inputs of every conversation reached, and wait until those tasks are terminal and the\n\t * conversation is ordinarily idle. Background work created afterwards is neither marked nor awaited.\n\t */\n\treadonly background?: boolean;\n};\n\n/** Hook handler map declared by a task definition. */\nexport type HooksOf<K> = K extends Task<infer _I, infer _S, infer _R, infer H> ? H : never;\n\n/**\n * Invocation-bound conversation operations for tasks and tools. Rejects after the invocation ends; passive entries are\n * written with ordinary transaction writes instead.\n */\nexport interface ConversationHandle {\n\treadonly id: ConversationId;\n\tsubmit(submission: InputSubmissionDraft, context: Context): Promise<Submission>;\n\t/** `Conversation.abort()`: withdraw queued inputs, abort the ordinary ownership scope, and wait until it is idle. */\n\tabort(context: Context, options?: ConversationAbortOptions): Promise<void>;\n\t/** Resolve when the conversation's ordinary ownership scope has no live non-background task. */\n\twaitForIdle(context: Context): Promise<void>;\n}\n\n/** Post-tools controls requested by a tool result. */\nexport type ToolControl = {\n\treadonly addTools?: readonly string[];\n\treadonly terminate?: true;\n\treadonly handoff?: string;\n};\n\n/** Remark about a call for the model and the UI, such as truncation or a spill path; never part of the tool's data. */\nexport type ToolDiagnostic = {\n\treadonly severity: \"info\" | \"warn\" | \"error\";\n\treadonly message: string;\n\treadonly code?: string;\n};\n\nexport type ToolExecutionResult = {\n\t/** Omitted: the retained `output()` text becomes the content. */\n\treadonly content?: ToolResultMessage[\"content\"];\n\treadonly isError?: boolean;\n\t/** Omitted: the last `details()` value becomes the details. */\n\treadonly details?: JsonValue;\n\t/** Added after those recorded through `api.diagnostic()`. */\n\treadonly diagnostics?: readonly ToolDiagnostic[];\n\t/** Spend of the execution itself, such as a model call; stored on the result and in `pi.usage.tools`. */\n\treadonly usage?: Usage;\n\treadonly control?: ToolControl;\n};\n\n/** Whether the tools of one round run at once or one after another in call order. */\nexport type ToolExecutionMode = \"parallel\" | \"sequential\";\n\n/** How many queued items of one mode a boundary places: the first, or all of them. */\nexport type QueueMode = \"all\" | \"one-at-a-time\";\n\n/**\n * Operations available to one tool invocation. A plain object, so a wrapper can pass `{ ...api, env }` to the tool it\n * wraps. Every operation rejects after the invocation ends.\n */\nexport interface ToolExecutionApi extends DocumentObserver, DocumentReader {\n\treadonly taskId: TaskId;\n\treadonly conversationId: ConversationId;\n\treadonly callId: string;\n\t/** `HarnessOptions.env` unless a wrapper supplies another environment. */\n\treadonly env: ExecutionEnv | undefined;\n\t/** Append running output; it becomes the result content when the result omits `content`. */\n\toutput(chunk: string | Uint8Array): void;\n\t/** Record a model-visible remark about this call. */\n\tdiagnostic(diagnostic: ToolDiagnostic): void;\n\t/** Replace running details; the last value becomes the result details when the result omits `details`. */\n\tdetails(value: JsonValue, context: Context): Promise<void>;\n\tcommit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;\n\tmemo<T extends JsonValue>(name: string, context: Context): Promise<T | undefined>;\n\tmemo<T extends JsonValue>(name: string, candidate: T, context: Context): Promise<T>;\n\tcreateTask<I, S extends { phase: string }, R, H extends object>(\n\t\ttask: Task<I, S, R, H>,\n\t\tinput: I,\n\t\toptions: Omit<TaskOptions, \"conversationId\">,\n\t\tcontext: Context,\n\t): Promise<TaskId<R>>;\n\tgetTask<R>(id: TaskId<R>, context: Context): Promise<TaskRecord<JsonValue, JsonValue, R> | undefined>;\n\twaitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;\n\t/** Invocation-bound handle of an existing conversation, such as one this tool created in `commit()`. */\n\tconversation(id: ConversationId, context: Context): Promise<ConversationHandle | undefined>;\n}\n\n/** Executable tool registered in a registry. Only pi-ai `Tool` fields enter the transcript. */\nexport type ToolRegistration = Tool & {\n\t/** Whether an interrupted execution may rerun on recovery. Default `unsafe`. */\n\treadonly replay?: \"safe\" | \"unsafe\";\n\t/** Default: the conversation's `toolExecution`. One sequential call makes its whole round sequential. */\n\treadonly executionMode?: ToolExecutionMode;\n\t/**\n\t * Repair arguments models commonly get wrong before validation, such as a JSON string where an array belongs. Must be\n\t * pure and must not mutate `args`: it runs again when a call is retried before its intent is recorded.\n\t */\n\tprepareArguments?(args: JsonValue): JsonValue;\n\treadonly outputLimits?: {\n\t\treadonly maxBytes?: number;\n\t\treadonly maxLines?: number;\n\t\treadonly retain?: \"head\" | \"tail\";\n\t};\n\texecute(args: JsonValue, api: ToolExecutionApi, context: Context): Promise<ToolExecutionResult>;\n};\n\n/** Token for removing registrations. Work already running keeps using what it started with. */\nexport interface Registration {\n\t/** Idempotent; removes exactly the registrations this token covers. */\n\tdispose(): void;\n}\n\n/** Pure decorator; returns a new tool with the same name and never mutates its input. */\nexport type ToolWrapper<Tool extends ToolRegistration> = (tool: Tool) => Tool;\n\n/** Conversation selection for a scoped hook registration. */\nexport type HookScope = {\n\treadonly conversationId: ConversationId;\n\t/** Also match conversations owned, transitively, by tasks of this conversation. */\n\treadonly subtree?: boolean;\n};\n\n/** Input to system prompt section rendering for one request preparation. */\nexport type PromptInput<Tool extends ToolRegistration> = {\n\treadonly conversationId: ConversationId;\n\t/** Active and registered tools in configured order, as offered in this request. */\n\treadonly tools: readonly Tool[];\n\t/** Sections already in effect after replaying the active transcript. */\n\treadonly shown: Readonly<Record<string, string>>;\n\treadonly model?: ModelRef;\n\treadonly thinkingLevel: ModelThinkingLevel;\n\t/** Committed document reads. */\n\treadonly read: DocumentReader;\n};\n\n/** One registered system prompt section; sections render in registry order before each request. */\nexport type PromptSection<Tool extends ToolRegistration> = {\n\treadonly key: string;\n\trender(input: PromptInput<Tool>, context: Context): string | undefined | Promise<string | undefined>;\n\t/** Default true: wrap the text as `<key>\\n...\\n</key>`. */\n\treadonly tag?: boolean;\n};\n\n/** Pure decorator; returns a new section with the same key and never mutates its input. */\nexport type PromptSectionWrapper<Tool extends ToolRegistration> = (section: PromptSection<Tool>) => PromptSection<Tool>;\n\n/** One registered hook handler map for task `K`. */\nexport type HookRegistration<K extends AnyTask> = {\n\treadonly handlers: Partial<HooksOf<K>>;\n\treadonly scope?: HookScope;\n};\n\n/** Wrapper composition failure found while building a snapshot. */\nexport type RegistryFailure = {\n\treadonly kind: \"tool\" | \"section\";\n\t/** Tool name or section key. */\n\treadonly name: string;\n\treadonly error: unknown;\n};\n\n/** Immutable view of one published registry state. */\nexport interface RegistrySnapshot<Tool extends ToolRegistration = ToolRegistration> {\n\t/** Composed tools in registry order; a tool whose wrapper failed is absent. */\n\ttools(): readonly Tool[];\n\ttool(name: string): Tool | undefined;\n\t/** Base tool names in registry order, including tools whose wrappers fail. */\n\ttoolNames(): readonly string[];\n\ttask(name: string): AnyTask | undefined;\n\t/** Hooks registered for tasks with `task`'s name, in registry order. */\n\thooks<K extends AnyTask>(task: K): readonly HookRegistration<K>[];\n\t/** Composed sections in registry order; a section whose wrapper failed is absent. */\n\tsections(): readonly PromptSection<Tool>[];\n\t/** Wrapper failures of this state. */\n\tfailures(): readonly RegistryFailure[];\n\t/** Conversation setups in registry order, the built-in `pi` setup first. */\n\tconversationSetups(): readonly { readonly key: string; readonly setup: ConversationSetup }[];\n}\n\n/** Read side of a registry consumed by a Harness. */\nexport interface RegistryReader<Tool extends ToolRegistration = ToolRegistration> {\n\t/** Immutable view of the whole current registry. */\n\tsnapshot(): RegistrySnapshot<Tool>;\n\t/** Called synchronously after every publication; wakes the scheduler to reconsider blocked tasks. */\n\tsubscribe(listener: () => void): () => void;\n}\n\n/** Application-owned registry of tools, hooks, tasks, and the system prompt. */\nexport interface Registry<Tool extends ToolRegistration = ToolRegistration> extends RegistryReader<Tool> {\n\treadonly tools: {\n\t\tadd(tool: Tool): Registration;\n\t\t/** `key` identifies the wrapper: it orders wrappers of one tool and keeps its position on re-registration. */\n\t\twrap(name: string, key: string, wrapper: ToolWrapper<Tool>): Registration;\n\t\t/** Composed tools of the current state. */\n\t\tlist(): readonly Tool[];\n\t};\n\treadonly hooks: {\n\t\tadd<K extends AnyTask>(\n\t\t\ttask: K,\n\t\t\thandlers: Partial<HooksOf<K>>,\n\t\t\toptions?: { readonly scope?: HookScope; readonly key?: string },\n\t\t): Registration;\n\t};\n\treadonly tasks: {\n\t\tadd(task: AnyTask): Registration;\n\t\tlist(): readonly AnyTask[];\n\t};\n\treadonly conversations: {\n\t\t/** `key` orders setups and keeps its position on re-registration. */\n\t\tsetup(key: string, setup: ConversationSetup): Registration;\n\t};\n\treadonly systemPrompt: {\n\t\tsection(key: string, render: PromptSection<Tool>[\"render\"], options?: { readonly tag?: boolean }): Registration;\n\t\twrap(key: string, wrapperKey: string, wrapper: PromptSectionWrapper<Tool>): Registration;\n\t\t/** Composed sections of the current state. */\n\t\tsections(): readonly PromptSection<Tool>[];\n\t};\n\t/** Stage registrations and disposals made synchronously by `register`, then publish them at once. Cannot nest. */\n\tbatch(register: () => void): Registration;\n}\n\n/**\n * Stages the documents every new conversation gets. Runs inside every Harness commit that creates or forks a\n * conversation, including raw `Tx` creation, after fork copies and before host `init`. Table reads throw, since the\n * conversation write came first; a fork (`conversation.parent`) already holds its copied documents. A throw fails the\n * creating commit.\n */\nexport type ConversationSetup = (\n\ttx: Tx,\n\tconversation: ConversationRecord,\n\tregistry: RegistrySnapshot,\n) => void | Promise<void>;\n\n/**\n * Runs inside the creating commit, after the conversation and its configuration exist. The conversation creation is\n * already a table write, so table reads here throw `ReadAfterWrite`; document access remains available.\n */\nexport type ConversationInit = (tx: Tx, conversationId: ConversationId) => void | Promise<void>;\n\nexport type ConversationCreateOptions = {\n\treadonly ownership: ConversationOwnership;\n\treadonly init?: ConversationInit;\n};\n\n/** Curated pi-ai request options; absent fields use pi-ai defaults. */\nexport type ConversationStreamOptions = {\n\ttransport?: Transport;\n\ttimeoutMs?: number;\n\t/** Provider/SDK retries inside one request attempt. */\n\tmaxRetries?: number;\n\tmaxRetryDelayMs?: number;\n\theaders?: Record<string, string>;\n\tmetadata?: JsonObject;\n\tcacheRetention?: CacheRetention;\n\tdeferred?: boolean | { window?: \"15m\" | \"1h\" | \"24h\" };\n};\n\n/** Durable generation attempt retries; the JSON shape of pi-ai `RetryPolicy`. */\nexport type ConversationRetryPolicy = {\n\tenabled: boolean;\n\tmaxRetries: number;\n\tbaseDelayMs: number;\n\tmaxAgentDelayMs?: number;\n};\n\n/** Automatic compaction thresholds (spec §8.7); manual compaction ignores `enabled`. */\nexport type CompactionPolicy = {\n\t/** Threshold and overflow compaction. */\n\tenabled: boolean;\n\t/** Room kept free for the answer: generation blocks to compact above `contextWindow - reserveTokens`. */\n\treserveTokens: number;\n\t/** Approximate size of the recent context a summary keeps verbatim. */\n\tkeepRecentTokens: number;\n\t/** Background compaction starts `backgroundTokens` below the blocking threshold; `0` disables it. */\n\tbackgroundTokens: number;\n};\n\n/** Why a compaction runs: `compact()`, a threshold in generation preparation, or a context overflow. */\nexport type CompactionReason = \"manual\" | \"threshold\" | \"overflow\";\n\n/**\n * `entryId` of a blocking compaction's summary, or the `submissionId` of a conversation-owned compaction's summary\n * write; both absent when nothing was compacted.\n */\nexport type CompactionResult = { entryId?: EntryId; submissionId?: SubmissionId };\n\nexport type HarnessOptions<Tool extends ToolRegistration = ToolRegistration> = {\n\t/** pi-ai model access used by generation. */\n\treadonly models: Models;\n\treadonly registry: RegistryReader<Tool>;\n\t/** Default execution environment offered to tools as `api.env`. */\n\treadonly env?: ExecutionEnv;\n\treadonly now?: () => number;\n\t/** Receives extension failures that do not fail the calling operation. Must not throw. */\n\treadonly onReport?: (error: unknown) => void;\n};\n\n/** Live task and what the scheduler would do with it under the current registry. */\nexport type TaskInspection = {\n\treadonly record: TaskRecord<JsonValue, JsonValue, JsonValue>;\n\treadonly state: /** An invocation is active. */\n\t\t| { readonly kind: \"running\" }\n\t\t/** The next scheduling pass reserves it; `migrates` when its definition is newer and has `migrate`. */\n\t\t| { readonly kind: \"ready\"; readonly migrates: boolean }\n\t\t/**\n\t\t * Waits for these live tasks: the live part of its `on`, or, when abort-marked, its live ordinary owned work, which\n\t\t * must end before its abort handler starts.\n\t\t */\n\t\t| { readonly kind: \"waiting\"; readonly on: readonly TaskId[] }\n\t\t/** Outcome held until its ordinary owned work drains. */\n\t\t| { readonly kind: \"completing\" }\n\t\t/** No registered definition can take it; aborting it settles it as `orphaned`. */\n\t\t| {\n\t\t\t\treadonly kind: \"blocked\";\n\t\t\t\treadonly reason: \"missing_task\" | \"task_too_old\" | \"migration_failed\";\n\t\t\t\treadonly error?: unknown;\n\t\t  };\n};\n\n/** Point-in-time view of live work: unfinished tasks and submissions, read on the Session line. */\nexport type HarnessInspection = {\n\treadonly scheduling: \"paused\" | \"running\" | \"closing\";\n\treadonly tasks: readonly TaskInspection[];\n\t/** Queued and placed submissions, in ID order. */\n\treadonly submissions: readonly SubmissionRecord[];\n\t/** Wrapper failures of the current registry snapshot. */\n\treadonly registry: readonly RegistryFailure[];\n};\n\n/** Raw active transcript and derived model context. */\nexport type ContextView = {\n\t/** Newest applicable head marker, if any. */\n\treadonly head: EntryRecord | undefined;\n\t/** Raw active entries: the head marker followed by non-head entries from its head through the tail. */\n\treadonly entries: readonly EntryRecord[];\n\t/** Per entry of `entries`, its model messages after edits and excluded stop reasons, before tool result ordering. */\n\treadonly contributions: readonly (readonly Message[])[];\n\t/** Model context for the next provider request. */\n\treadonly messages: readonly Message[];\n};\n\n/** Stateless handle for one conversation, bound to the Harness that returned it. Compare handles by `id`. */\nexport interface Conversation {\n\treadonly id: ConversationId;\n\n\tgetModel(context: Context): Promise<ModelRef | undefined>;\n\tsetModel(model: ModelRef | undefined, context: Context): Promise<void>;\n\tgetThinkingLevel(context: Context): Promise<ModelThinkingLevel>;\n\tsetThinkingLevel(level: ModelThinkingLevel, context: Context): Promise<void>;\n\tgetActiveTools(context: Context): Promise<readonly string[]>;\n\tsetActiveTools(names: readonly string[], context: Context): Promise<void>;\n\t/** `{}` when unset. */\n\tgetStreamOptions(context: Context): Promise<ConversationStreamOptions>;\n\tsetStreamOptions(options: ConversationStreamOptions, context: Context): Promise<void>;\n\t/** The default policy when unset. */\n\tgetRetryPolicy(context: Context): Promise<ConversationRetryPolicy>;\n\t/** `undefined` removes the configured policy. */\n\tsetRetryPolicy(policy: ConversationRetryPolicy | undefined, context: Context): Promise<void>;\n\t/** `parallel` when unset. */\n\tgetToolExecution(context: Context): Promise<ToolExecutionMode>;\n\t/** `undefined` removes the configured mode. */\n\tsetToolExecution(mode: ToolExecutionMode | undefined, context: Context): Promise<void>;\n\t/** `one-at-a-time` when unset. */\n\tgetSteeringMode(context: Context): Promise<QueueMode>;\n\t/** `undefined` removes the configured mode. */\n\tsetSteeringMode(mode: QueueMode | undefined, context: Context): Promise<void>;\n\t/** `one-at-a-time` when unset. */\n\tgetFollowUpMode(context: Context): Promise<QueueMode>;\n\t/** `undefined` removes the configured mode. */\n\tsetFollowUpMode(mode: QueueMode | undefined, context: Context): Promise<void>;\n\t/** `DEFAULT_COMPACTION_POLICY` when unset. */\n\tgetCompaction(context: Context): Promise<CompactionPolicy>;\n\t/** `undefined` removes the configured policy. */\n\tsetCompaction(policy: CompactionPolicy | undefined, context: Context): Promise<void>;\n\n\t/**\n\t * Durably admit user input or a passive entry write. A busy conversation, or one with queued items, queues it in\n\t * `pi.inbox`; `whenBusy: \"reject\"` rejects with `ConversationBusy` instead and writes nothing.\n\t */\n\tsubmit(submission: SubmissionDraft, context: Context): Promise<Submission>;\n\t/**\n\t * Admit a write of a `pi.reset` entry that starts a new context, carrying `handoff` as a user message when given.\n\t * Resolves after admission; while busy, it is placed at the next boundary.\n\t */\n\treset(handoff: string | undefined, context: Context): Promise<void>;\n\t/**\n\t * Admit a manual compaction task and return its ID. It summarizes while the conversation keeps working and places its\n\t * summary through a write submission: at once when idle, otherwise at the next boundary (spec §8.7).\n\t */\n\tcompact(instructions: string | undefined, context: Context): Promise<TaskId<CompactionResult>>;\n\n\t/** Session commit whose `tx.createTask()` defaults to this conversation. */\n\tcommit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;\n\tcontext(context: Context): Promise<ContextView>;\n\t/** Newest-first fork-aware history of this conversation. */\n\tentries(\n\t\tquery: Omit<EntryQuery, \"conversationId\">,\n\t\tlimit: number,\n\t\tcursor: Cursor | undefined,\n\t\tcontext: Context,\n\t): Promise<Page<EntryRecord, Cursor>>;\n\tfork(at: EntryId, options: ConversationCreateOptions, context: Context): Promise<Conversation>;\n\t/**\n\t * Withdraw queued inputs (queued writes stay), mark every live non-background task of the ordinary ownership scope,\n\t * signal them, and resolve once the scope is idle. Background subtrees survive unless `background` is set.\n\t */\n\tabort(context: Context, options?: ConversationAbortOptions): Promise<void>;\n\t/**\n\t * Resolve when the ordinary ownership scope has no live non-background task: this conversation and the conversations\n\t * owned, transitively, by its non-background tasks.\n\t */\n\twaitForIdle(context: Context): Promise<void>;\n\t/** The structural view (spec §9.3) as a disposable read-only Chord state. */\n\tviewState(context: Context): Promise<AttachedReplicatedState<ConversationView>>;\n\t/** The structural view as a serialized exact-frame watch with bounded pending frames. */\n\twatch(context: Context): Promise<WatchHandle<ConversationView>>;\n}\n\n// TODO: decide how Harness exposes subscribeCommits() and subscribeClose(). Their listeners run on the Session line\n// and must not throw or call Session APIs, and Harness close will also join task invocations.\n/** Durable agent harness over one Session. */\nexport interface Harness extends Session {\n\t/**\n\t * Enable task scheduling. Idempotent; throws after close. Calls that wait for progress (`Conversation.submit()`,\n\t * `Submission.wait()`, `waitForTask()`, `waitForIdle()`) enable it too.\n\t */\n\tresume(): void;\n\n\t/** Return the reserved root conversation, creating it with `init` in one commit when absent. */\n\troot(context: Context, options?: { readonly init?: ConversationInit }): Promise<Conversation>;\n\tconversation(id: ConversationId, context: Context): Promise<Conversation | undefined>;\n\tcreateConversation(options: ConversationCreateOptions, context: Context): Promise<Conversation>;\n\n\tgetTask<R>(id: TaskId<R>, context: Context): Promise<TaskRecord<JsonValue, JsonValue, R> | undefined>;\n\t/** Live tasks, unsettled submissions, and registry failures. Writes nothing and runs no task code. */\n\tinspect(context: Context): Promise<HarnessInspection>;\n\t/** Reacquire a submission, for example after reopen. */\n\tsubmission(id: SubmissionId, context: Context): Promise<Submission | undefined>;\n\t/** `not_found` for an unknown submission or one of another conversation than `conversationId`. */\n\tabortSubmission(\n\t\tid: SubmissionId,\n\t\tcontext: Context,\n\t\tconversationId?: ConversationId,\n\t): Promise<\"aborted\" | \"already_placed\" | \"settled\" | \"not_found\">;\n\t/**\n\t * Commit the abort mark, signal and join an active run invocation, and schedule the abort invocation. A task whose\n\t * definition cannot take it settles as `orphaned` instead.\n\t */\n\tabortTask(id: TaskId, context: Context): Promise<\"marked\" | \"terminal\">;\n\t/** Resolve with the terminal receipt; cancelling `context` cancels only this wait. */\n\twaitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;\n\t/** Resolve when the ordinary ownership scope of every ownerless conversation has no live non-background task. */\n\twaitForIdle(context: Context): Promise<void>;\n\t/** Session total: every conversation's `pi.usage` summed. */\n\tusage(context: Context): Promise<UsageState>;\n}\n\n/** What a hook may use: committed reads and the asking task's memos, which hooks and the task share. */\nexport interface HookApi extends DocumentReader {\n\treadonly taskId: TaskId;\n\treadonly conversationId: ConversationId;\n\tmemo<T extends JsonValue>(name: string, context: Context): Promise<T | undefined>;\n\tmemo<T extends JsonValue>(name: string, candidate: T, context: Context): Promise<T>;\n}\n\nexport type HookResult<T> = T | undefined | Promise<T | undefined>;\n\n/** Hooks of the built-in generation task. */\nexport interface GenerationHooks {\n\t/** Before every request attempt, including recovery; the result is used for that request only. */\n\tbeforeRequest(\n\t\trequest: { readonly messages: readonly Message[] },\n\t\tapi: HookApi,\n\t\tcontext: Context,\n\t): HookResult<{ readonly messages: readonly Message[] }>;\n\t/** Every terminal provider message, before classification. */\n\tafterResponse(message: AssistantMessage, api: HookApi, context: Context): void | Promise<void>;\n\t/** A final answer; the first `continue` appends a user message and continues the run. */\n\tonYield(answer: AssistantMessage, api: HookApi, context: Context): HookResult<{ readonly continue: UserInput }>;\n\t/** After every tool of the round is terminal; `results` are the round's result entries in call order. */\n\tafterTools(assistant: EntryId, results: readonly EntryId[], api: HookApi, context: Context): void | Promise<void>;\n}\n\n/** Hooks of the built-in tool task. */\nexport interface ToolHooks {\n\t/** Before intent; the first `block` wins, otherwise `arguments` replace the call's arguments. A throw blocks. */\n\tbeforeTool(\n\t\tcall: ToolCall,\n\t\tapi: HookApi,\n\t\tcontext: Context,\n\t): HookResult<{ readonly arguments?: JsonObject; readonly block?: string }>;\n\t/** After execution, before the result entry; replaces the result. */\n\tafterTool(\n\t\tcall: ToolCall,\n\t\tresult: ToolExecutionResult,\n\t\tapi: HookApi,\n\t\tcontext: Context,\n\t): HookResult<ToolExecutionResult>;\n}\n\n/** Hooks of the built-in compaction task. */\nexport interface CompactionHooks {\n\t/**\n\t * After range selection, before summarizing; the first decision wins. `entries` are the active entries the summary\n\t * replaces, the head marker first, and `messages` their model context, the summarizer's source; `firstKept` is the\n\t * first entry kept verbatim.\n\t */\n\tbeforeCompact(\n\t\tcompaction: {\n\t\t\treadonly reason: CompactionReason;\n\t\t\treadonly entries: readonly EntryRecord[];\n\t\t\treadonly messages: readonly Message[];\n\t\t\treadonly firstKept: EntryId;\n\t\t\treadonly instructions?: string;\n\t\t},\n\t\tapi: HookApi,\n\t\tcontext: Context,\n\t): HookResult<{ readonly decline: true } | { readonly summary: string }>;\n}\n"]}

package/dist/harness/usage.d.ts

@@ -0,0 +1,18 @@
+import { type Draft, type JsonRepresentation } from "@earendil-works/chord";
+import type { Usage } from "@earendil-works/pi-ai";
+import type { ConversationId, Tx } from "../types.ts";
+/** Ledger of one conversation's own spend: its entries, and compaction summarization attempts, which have none. */
+export type UsageState = {
+    /** Assistant entries and summarization attempts, keyed `provider/modelId`. */
+    models: Record<string, JsonRepresentation<Usage>>;
+    /** Tool results, keyed by tool name; their usage has no model identity. */
+    tools: Record<string, JsonRepresentation<Usage>>;
+};
+export declare const UsageDoc: import("../types.ts").ConversationDocToken<UsageState>;
+/** Add `usage` to one bucket of the conversation's `pi.usage`, in the commit that records the response. */
+export declare function recordUsage(tx: Tx, conversationId: ConversationId, bucket: keyof UsageState, key: string, usage: Usage): Promise<void>;
+/** Add every counter of `usage` to `total`; optional counters are added once either side reports them. */
+export declare function addUsage(total: Draft<Usage> | Usage, usage: Usage): void;
+/** Add every bucket of `state` into `sum`. */
+export declare function addUsageState(sum: UsageState, state: Readonly<UsageState>): void;
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/harness/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,KAAK,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEtD,mHAAmH;AACnH,MAAM,MAAM,UAAU,GAAG;IACxB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;CACjD,CAAC;AAEF,eAAO,MAAM,QAAQ,wDAQnB,CAAC;AAEH,2GAA2G;AAC3G,wBAAsB,WAAW,CAChC,EAAE,EAAE,EAAE,EACN,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,MAAM,UAAU,EACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,0GAA0G;AAC1G,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAaxE;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAchF"}

package/dist/harness/usage.js

@@ -0,0 +1,57 @@
+import { copyJson } from "@earendil-works/chord";
+import { defineDoc } from "../documents.js";
+export const UsageDoc = defineDoc({
+    kind: "pi.usage",
+    version: 1,
+    scope: "conversation",
+    history: "latest",
+    fork: "initial",
+    initial: () => ({ models: {}, tools: {} }),
+    checkpointWhen: () => true,
+});
+/** Add `usage` to one bucket of the conversation's `pi.usage`, in the commit that records the response. */
+export async function recordUsage(tx, conversationId, bucket, key, usage) {
+    const totals = (await tx.doc(UsageDoc, conversationId))[bucket];
+    // Own keys only: a tool may be called `toString`.
+    const total = Object.hasOwn(totals, key) ? totals[key] : undefined;
+    // Providers may leave optional counters `undefined`; drafts take strict JSON.
+    if (total === undefined)
+        totals[key] = copyJson(usage, { omitUndefinedProperties: true });
+    else
+        addUsage(total, usage);
+}
+/** Add every counter of `usage` to `total`; optional counters are added once either side reports them. */
+export function addUsage(total, usage) {
+    total.input += usage.input;
+    total.output += usage.output;
+    total.cacheRead += usage.cacheRead;
+    total.cacheWrite += usage.cacheWrite;
+    total.totalTokens += usage.totalTokens;
+    if (usage.cacheWrite1h !== undefined)
+        total.cacheWrite1h = (total.cacheWrite1h ?? 0) + usage.cacheWrite1h;
+    if (usage.reasoning !== undefined)
+        total.reasoning = (total.reasoning ?? 0) + usage.reasoning;
+    total.cost.input += usage.cost.input;
+    total.cost.output += usage.cost.output;
+    total.cost.cacheRead += usage.cost.cacheRead;
+    total.cost.cacheWrite += usage.cost.cacheWrite;
+    total.cost.total += usage.cost.total;
+}
+/** Add every bucket of `state` into `sum`. */
+export function addUsageState(sum, state) {
+    for (const bucket of ["models", "tools"]) {
+        for (const [key, usage] of Object.entries(state[bucket])) {
+            const total = Object.hasOwn(sum[bucket], key) ? sum[bucket][key] : undefined;
+            // Define rather than assign: assigning a tool named `__proto__` would set the prototype.
+            if (total !== undefined)
+                addUsage(total, usage);
+            else
+                Object.defineProperty(sum[bucket], key, {
+                    value: structuredClone(usage),
+                    enumerable: true,
+                    writable: true,
+                });
+        }
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/harness/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/harness/usage.ts"],"names":[],"mappings":"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","sourcesContent":["import { copyJson, type Draft, type JsonRepresentation } from \"@earendil-works/chord\";\nimport type { Usage } from \"@earendil-works/pi-ai\";\nimport { defineDoc } from \"../documents.ts\";\nimport type { ConversationId, Tx } from \"../types.ts\";\n\n/** Ledger of one conversation's own spend: its entries, and compaction summarization attempts, which have none. */\nexport type UsageState = {\n\t/** Assistant entries and summarization attempts, keyed `provider/modelId`. */\n\tmodels: Record<string, JsonRepresentation<Usage>>;\n\t/** Tool results, keyed by tool name; their usage has no model identity. */\n\ttools: Record<string, JsonRepresentation<Usage>>;\n};\n\nexport const UsageDoc = defineDoc<UsageState>({\n\tkind: \"pi.usage\",\n\tversion: 1,\n\tscope: \"conversation\",\n\thistory: \"latest\",\n\tfork: \"initial\",\n\tinitial: () => ({ models: {}, tools: {} }),\n\tcheckpointWhen: () => true,\n});\n\n/** Add `usage` to one bucket of the conversation's `pi.usage`, in the commit that records the response. */\nexport async function recordUsage(\n\ttx: Tx,\n\tconversationId: ConversationId,\n\tbucket: keyof UsageState,\n\tkey: string,\n\tusage: Usage,\n): Promise<void> {\n\tconst totals = (await tx.doc(UsageDoc, conversationId))[bucket];\n\t// Own keys only: a tool may be called `toString`.\n\tconst total = Object.hasOwn(totals, key) ? totals[key] : undefined;\n\t// Providers may leave optional counters `undefined`; drafts take strict JSON.\n\tif (total === undefined)\n\t\ttotals[key] = copyJson(usage, { omitUndefinedProperties: true }) as JsonRepresentation<Usage>;\n\telse addUsage(total, usage);\n}\n\n/** Add every counter of `usage` to `total`; optional counters are added once either side reports them. */\nexport function addUsage(total: Draft<Usage> | Usage, usage: Usage): void {\n\ttotal.input += usage.input;\n\ttotal.output += usage.output;\n\ttotal.cacheRead += usage.cacheRead;\n\ttotal.cacheWrite += usage.cacheWrite;\n\ttotal.totalTokens += usage.totalTokens;\n\tif (usage.cacheWrite1h !== undefined) total.cacheWrite1h = (total.cacheWrite1h ?? 0) + usage.cacheWrite1h;\n\tif (usage.reasoning !== undefined) total.reasoning = (total.reasoning ?? 0) + usage.reasoning;\n\ttotal.cost.input += usage.cost.input;\n\ttotal.cost.output += usage.cost.output;\n\ttotal.cost.cacheRead += usage.cost.cacheRead;\n\ttotal.cost.cacheWrite += usage.cost.cacheWrite;\n\ttotal.cost.total += usage.cost.total;\n}\n\n/** Add every bucket of `state` into `sum`. */\nexport function addUsageState(sum: UsageState, state: Readonly<UsageState>): void {\n\tfor (const bucket of [\"models\", \"tools\"] as const) {\n\t\tfor (const [key, usage] of Object.entries(state[bucket])) {\n\t\t\tconst total = Object.hasOwn(sum[bucket], key) ? sum[bucket][key] : undefined;\n\t\t\t// Define rather than assign: assigning a tool named `__proto__` would set the prototype.\n\t\t\tif (total !== undefined) addUsage(total, usage);\n\t\t\telse\n\t\t\t\tObject.defineProperty(sum[bucket], key, {\n\t\t\t\t\tvalue: structuredClone(usage),\n\t\t\t\t\tenumerable: true,\n\t\t\t\t\twritable: true,\n\t\t\t\t});\n\t\t}\n\t}\n}\n"]}