agentenkit 0.3.0 → 0.5.0

package/dist/core/types.d.ts

@@ -3,8 +3,9 @@ import type { AgentRunState } from './state.js';
 /** Lifecycle of a thread. Durable truth lives in Storage.threads; the kv copy
  *  (`agent:state:{threadId}`) is a hot cache the engine polls (§2.1, §3.4). */
 export type ExecutionState = 'IDLE'
-/** Accepted and waiting for a worker; written by the Go runtime. It becomes
- *  RUNNING the moment a worker picks the job up. */
+/** Accepted and waiting for a worker. It becomes RUNNING the moment a
+ *  worker picks the job up, and goes back to QUEUED while a failed run
+ *  waits for its retry. */
  | 'QUEUED' | 'RUNNING' | 'WAITING_FOR_INPUT' | 'CANCELLED' | 'COMPLETED' | 'FAILED';
 export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
 /** Generation flavor of a handle / spawned subagent (§4). */
@@ -16,6 +17,21 @@ export interface ThreadDTO {
     createdAt: Date;
     updatedAt: Date;
 }
+/** One compare-and-set on a thread's state (§3.4). It lands only while the
+ *  thread is in one of `from` AND still belongs to `runId`, so a run that has
+ *  been stopped or replaced can never move the thread again: its write simply
+ *  loses. */
+export interface ThreadTransition {
+    from: ExecutionState[];
+    to: ExecutionState;
+    /** The run the caller acts for. The transition lands only while the
+     *  thread's current run is this one, or the thread has no run recorded yet
+     *  (a thread from before run ids were stored). Omitted means any run. */
+    runId?: string;
+    /** Makes the thread belong to a new run: set by run admission. Omitted
+     *  keeps the current one. */
+    newRunId?: string;
+}
 export interface MessageDTO {
     id: string;
     threadId: string;
@@ -36,10 +52,30 @@ export interface NewMessage {
  *  engine via Kv.incr before append (§3.4). */
 export interface AgentEvent {
     threadId: string;
+    /** The thread record's order, minted by the store on insert. 0 for a
+     *  notice, which is never stored. */
     seq: number;
     type: string;
     payload: unknown;
     createdAt: Date;
+    /** The run the entry belongs to, when it belongs to one. */
+    runId?: string | null;
+}
+/** An entry for the thread record, before the store gives it its seq. */
+export interface NewThreadEvent {
+    type: string;
+    payload: unknown;
+    runId?: string | null;
+    /** When it happened; now when omitted. */
+    createdAt?: Date;
+}
+/** Which record entries to read back: all of them by default, oldest first. */
+export interface ThreadEventFilter {
+    types?: string[];
+    runId?: string;
+    /** Only entries after this seq. */
+    after?: number;
+    limit?: number;
 }
 /** The durable record of ONE agent run (§2.9): when it started, how it ended,
  *  what it cost. Keyed by the run id the platform already mints to fence stale
@@ -64,8 +100,12 @@ export interface RunRecord {
     stopReason?: string | null;
     /** Why it failed, when it did. Previously dropped on the floor (§2.8). */
     error?: string | null;
-    /** When the run was accepted and enqueued. */
+    /** When a worker first started work on it. Until then (a QUEUED run) the
+     *  time it was accepted. */
     startedAt: Date;
+    /** When the run was accepted and enqueued (§2.8): a queued run's wait
+     *  shows while it lasts. Null on records from before the QUEUED stage. */
+    enqueuedAt?: Date | null;
     endedAt?: Date | null;
     /** endedAt - startedAt, denormalised so a listing never recomputes it. A
      *  parked run legitimately spans however long the human took (§2.5). */
@@ -73,6 +113,13 @@ export interface RunRecord {
     /** Milliseconds between enqueue and a worker starting work — the number that
      *  says whether workers are keeping up (§2.8). */
     queuedMs?: number | null;
+    /** When the spec's `onSettle` ran for this run (§5.6). A run settles exactly
+     *  once: whoever ends it, or the late-settle sweep. Unset until then. */
+    settledAt?: Date | null;
+    /** When a settle claimed the run and started its hook. Cleared when the
+     *  settle ends; one left behind for long is a settler that died, and the
+     *  next settle takes the run over. */
+    settlingAt?: Date | null;
     /** Loop iterations completed, summed across every segment of the run. */
     steps: number;
     inputTokens: number;
@@ -92,6 +139,10 @@ export interface RunRecord {
     providerOptions?: Record<string, unknown> | null;
     /** A nested run's capped result, handed back to its parent (§2.7). */
     result?: unknown;
+    /** The caps the run was dispatched with (§4, §2.1), kept so a run
+     *  re-dispatched from its record keeps them. */
+    costBudgetMicros?: number | null;
+    maxSteps?: number | null;
 }
 export interface NewRunRecord {
     id: string;
@@ -105,6 +156,15 @@ export interface NewRunRecord {
     /** Defaults to 0 — a dispatched run. */
     depth?: number;
     parentRunId?: string | null;
+    /** A dispatched run opens QUEUED; a nested run starts RUNNING (the
+     *  default). */
+    state?: ExecutionState;
+    /** When a dispatched run was accepted. */
+    enqueuedAt?: Date | null;
+    /** The caps the run was dispatched with (§4, §2.1), kept so a run
+     *  re-dispatched from its record keeps them. */
+    costBudgetMicros?: number | null;
+    maxSteps?: number | null;
 }
 export type RunPatch = Partial<Omit<RunRecord, 'id' | 'threadId'>>;
 /** Cumulative token AND money attribution across every run on a thread (§4).
@@ -121,17 +181,32 @@ export interface UsageTotals {
     /** Summed cost in millionths of one `currency` unit: 1_000_000 is one
      *  dollar when the currency is USD. */
     costMicros: number;
-    /** The unit `costMicros` is in, absent when nothing was priced. One
-     *  deployment should price in ONE currency: these are summed, not
-     *  converted. */
+    /** The unit `costMicros` is in: the first currency priced, absent when
+     *  nothing was. Money is never converted, so a call priced in another
+     *  currency is left out of `costMicros` and counted in `unpriced`; `costs`
+     *  has every currency's own total. */
     currency?: string;
-    /** How many calls had no cost, because no pricer answered for them. Above
-     *  zero, `costMicros` is a floor and not the whole bill. */
+    /** How many calls `costMicros` leaves out: calls no pricer answered for,
+     *  and calls priced in another currency. Above zero, `costMicros` is a
+     *  floor and not the whole bill. */
     unpriced: number;
-    /** The same spend grouped by agent and model: one line per pair, which is
-     *  the shape a bill wants. Summing the lines gives the totals above. */
+    /** The money per currency, in the order each was first seen. One run is
+     *  only ever priced in one currency (a second one is refused when the call
+     *  is recorded), so a run's bill has at most one entry; a thread whose
+     *  pricer changed currency between runs can have more. */
+    costs?: CurrencyCost[];
+    /** The same spend grouped by agent, model and currency: one line per agent
+     *  and model, which is the shape a bill wants. Summing the lines of one
+     *  currency gives that currency's entry in `costs`. */
     lines: UsageLine[];
 }
+/** The money spent in one currency (§4). */
+export interface CurrencyCost {
+    currency: string;
+    costMicros: number;
+    /** How many calls were priced in this currency. */
+    calls: number;
+}
 /** One agent's spend on one model, summed over its calls (§4). This is the
  *  bill line a credit system charges for. */
 export interface UsageLine {
@@ -141,6 +216,9 @@ export interface UsageLine {
     /** The registry key; `modelId` is the wire id it resolved to. */
     model?: string | null;
     modelId?: string | null;
+    /** The unit `costMicros` is in, absent when none of the line's calls was
+     *  priced. */
+    currency?: string;
     inputTokens: number;
     cacheReadInputTokens: number;
     cacheWriteInputTokens: number;
@@ -176,7 +254,12 @@ export type UsageKind =
 /** The summary the platform writes to keep the prompt inside the model's
  *  window (§2.6). Nobody asked for it, so it is worth being able to see
  *  what it costs on its own. */
- | 'compaction';
+ | 'compaction'
+/** A built-in tool (§ built-in tools): one row per use of a paid service
+ *  (a search, a page read), with `model` = `tool:<tool name>` and
+ *  `modelId` = the adapter, and one per model call a tool makes itself
+ *  (reading a page with a question). */
+ | 'tool';
 /** The money one model call cost. */
 export interface Cost {
     /** Millionths of one `currency` unit: 1_000_000 is one dollar when the
@@ -268,6 +351,13 @@ export declare function mergeProviderOptions(base?: ProviderOptions, override?:
 /** Dispatch ticket for the queue (§2.8). At-least-once — consumers must be
  *  idempotent. `agent` resolves via `AgentCore.getAgent`; when missing, the
  *  default handle executes. */
+/** Why a job was enqueued (see `RunJob.kind`):
+ *  - `retry`: the same run trying again after a failure (§2.8);
+ *  - `redrive`: a job that found the run lock held by an older run;
+ *  - `resume`: a parked run continuing after an answer (§2.5);
+ *  - `expiry`: a park's own deadline (§2.5);
+ *  - `reclaim`: an orphaned thread re-dispatched (§2.5). */
+export type JobKind = 'retry' | 'redrive' | 'resume' | 'expiry' | 'reclaim';
 export interface RunJob {
     threadId: string;
     model: string;
@@ -277,9 +367,19 @@ export interface RunJob {
      *  been replaced by a newer run and must not execute. Omitted on legacy
      *  dispatches, which keep the old no-identity behavior. */
     runId?: string;
+    /** Names THIS enqueue of the run: a fresh dispatch, a retry, a resume each
+     *  get their own. A queue that delivers one job twice delivers the same
+     *  id, which is how the run lock tells a duplicate apart from another
+     *  delivery of the same run (§3.4). Stamped by `enqueueJob`; absent on
+     *  jobs written before it. */
+    dispatchId?: string;
     /** Epoch ms at enqueue. The worker subtracts it on pickup to record how long
      *  the job waited — the number that says whether workers keep up (§2.9). */
     enqueuedAt?: number;
+    /** Why the job exists, so a queue can log it, order it and cap only the
+     *  kind that brings new work in. Absent is a fresh dispatch from `run`, the
+     *  only kind a depth cap refuses. */
+    kind?: JobKind;
     /** The run's state (§2.10), so a worker rehydrates exactly what the caller
      *  attached — hours later, in another process, after an approval. */
     state?: AgentRunState;
@@ -288,6 +388,15 @@ export interface RunJob {
      *  cap the caller asked for. */
     costBudgetMicros?: number;
     providerOptions?: ProviderOptions;
+    /** The run's own step cap, when the caller set one (§2.1). */
+    maxSteps?: number;
+    /** The caller's tenant, opaque to the platform. A queue that spreads its
+     *  claims across partitions keeps one tenant's backlog from starving the
+     *  others. */
+    partitionKey?: string;
+    /** Epoch ms of the run's first dispatch, carried onto every retry and
+     *  resume so the run keeps its place in line. */
+    dispatchedAt?: number;
 }
 /** Identifies a nested run well enough to re-enter its loop (§2.7). Persisted
  *  in the INPUT_REQUIRED payload so a resume never has to read it back. */
@@ -313,6 +422,11 @@ export interface ResumeInfo {
      *  closure that is long gone. Without it every storage call after an
      *  approval loses whatever the caller attached, tenant scope included. */
     state?: AgentRunState;
+    /** The run's own step cap (§2.1), so a resumed segment keeps it. */
+    maxSteps?: number;
+    /** Epoch ms of the run's first dispatch, so a resume keeps its place in
+     *  line. */
+    dispatchedAt?: number;
 }
 /** A model identity after resolution: the real provider instance (created
  *  lazily per run) and the declared context window, which feeds the §2.6
@@ -340,6 +454,29 @@ export interface SubagentsConfig {
     /** Extra tools merged into every spawned subagent's toolset
      *  (HITL-wrapped identically to the parent's tools). */
     tools?: ToolSet;
+    /** Named specialists (§2.7). When set, `spawnSubagent` must name one of
+     *  them: the child takes the profile's persona, model, tools and step cap
+     *  instead of the shared defaults above. The model still writes the brief;
+     *  the profile says who reads it. */
+    profiles?: Record<string, SubagentProfile>;
+}
+/** One named specialist a run may delegate to. */
+export interface SubagentProfile {
+    /** Shown to the model beside the name, so it can choose. */
+    description?: string;
+    /** The child's static persona; `systemFn` wins when set. */
+    system?: string;
+    systemFn?: import('../ports/runtime.js').SystemFn;
+    /** Edits the child's prompt per step; see PrepareStepFn. */
+    prepareStep?: import('../ports/runtime.js').PrepareStepFn;
+    /** Registry key; absent falls back to the config's `model`, then the
+     *  default. */
+    model?: string;
+    /** The child's own tools, HITL-wrapped like the parent's. They replace the
+     *  shared `tools` above. */
+    tools?: ToolSet;
+    /** Caps the child's round trips; 0 or absent keeps `subagentMaxSteps`. */
+    maxSteps?: number;
 }
 export interface AgentConfig {
     /** How long a parked HITL request stays answerable (§2.5) — expiry turns
@@ -360,6 +497,12 @@ export interface AgentConfig {
      *  it would strand the user's message — so it comes back once the previous
      *  run has let go. */
     runRedriveDelaySeconds: number;
+    /** A failed run waits this long before its first retry, twice as long each
+     *  time after, up to `runRetryBackoffMaxMs`, with up to a quarter of jitter
+     *  so a fleet that failed together does not retry together (§2.8). 0 retries
+     *  at once. */
+    runRetryBackoffMs: number;
+    runRetryBackoffMaxMs: number;
     /** Default per-run token budget (input + output) when neither the execute
      *  input nor the agent spec declares one. `undefined` = unbounded apart
      *  from `maxSteps` (§2.1 safety cap). */
@@ -412,9 +555,50 @@ export interface AgentConfig {
     /** Per-model native windows below the ceiling (§2.6) — merged over defaults.
      *  A `contextWindow` declared via `resolveModel` wins over this table. */
     nativeWindows?: Record<string, number>;
-    /** Lease (seconds) for the per-thread run lock — must exceed the longest
-     *  possible run segment; parked HITL waits hold NO lock (§2.8, §3.4). */
+    /** Lease (seconds) for the per-thread run lock. The holder renews it every
+     *  sixth of the lease while it holds it, so an expired lock means a dead
+     *  worker; parked HITL waits hold NO lock (§2.8, §3.4). */
     runLockLeaseSeconds: number;
+    /** Bounds one model round trip in wall time (ms). A model that accepts the
+     *  call and never answers ends that step like any failed step, and the run
+     *  takes the retry policy (§2.8). 0 means no bound. */
+    stepTimeoutMs: number;
+    /** Bounds one worker segment in wall time (ms). Past it the run ends FAILED
+     *  with stopReason `timeout`, rather than holding the worker. 0 means no
+     *  bound. */
+    segmentTimeoutMs: number;
+    /** The longest a job may wait in the queue (ms). A job picked up later
+     *  fails its run with the reason, instead of doing work nobody is waiting
+     *  for any more. 0 means no limit. */
+    maxQueueWaitMs: number;
+    /** How long a run stream is kept after its segment ends (ms). A tab that
+     *  reconnects within it resumes inside the stream; one that comes later
+     *  gets a snapshot, which has the final text in the messages. */
+    streamGraceMs: number;
+    /** How long a stream lives if nothing ever closes it (ms): the last guard
+     *  when the worker and the sweep both failed. */
+    streamTtlMs: number;
+    /** How long stream events wait to be appended together (ms). A step end,
+     *  a tool result, a park and a close go out at once. 0 sends every event
+     *  as it comes. */
+    streamFlushMs: number;
+    /** Append at once when this many stream events are waiting. */
+    streamFlushEvents: number;
+    /** The most characters a built-in tool hands the model in one result: a
+     *  page's text, a reader's answer. Past it the text is cut and the result
+     *  says `truncated: true`, so one huge page cannot fill the context window
+     *  or the database. Default 20,000. */
+    builtinToolResultCapChars: number;
+    /** A thread's sandbox ends after it has sat unused this long, and the
+     *  next call makes a fresh one. Default 30 minutes. */
+    sandboxIdleTtlMs: number;
+    /** A thread's sandbox ends this long after it was made, however much it
+     *  is used: the backstop on what one sandbox can cost. Default 24 hours. */
+    sandboxMaxLifetimeMs: number;
+    /** Refuse a new run (RUN_REFUSED, reason `queue_full`) once this many jobs
+     *  are ready and waiting (§2.8). Needs a queue that can count; one that
+     *  cannot is never refused on. 0 means no cap. */
+    maxQueueDepth: number;
     /** Billing pre-execution check (§4). Return `{ ok: false, error }` to reject
      *  a run. The check can publish on the thread (a credit warning, a reset
      *  date) so every client sees why; the platform also publishes RUN_REFUSED
@@ -434,11 +618,26 @@ export interface AgentConfig {
  *  caller. `publishEvent(type, payload, { durable })` — durable by default. */
 export interface BillingCheck {
     threadId: string;
+    /** Set at pickup; absent at dispatch, where the run has no id yet. */
+    runId?: string;
     state: AgentRunState;
+    /** When the check runs. `dispatch` is inside `run`, before anything is
+     *  written: a refusal means the run never exists. `pickup` is when a worker
+     *  takes the job (a first dispatch, a retry, a resume): a refusal fails the
+     *  run. */
+    stage: 'dispatch' | 'pickup';
+    /** The caps the job carries, at pickup only. The check may LOWER either and
+     *  the segment runs with the lowered cap; raising is ignored. */
+    budget?: RunBudget;
     publishEvent: (type: string, payload: unknown, options?: {
         durable?: boolean;
     }) => Promise<AgentEvent>;
 }
+/** The money and step cap a segment runs with. 0 is no cap from this level. */
+export interface RunBudget {
+    costBudgetMicros: number;
+    maxSteps: number;
+}
 export declare const DEFAULT_CONFIG: AgentConfig;
 export declare function resolveConfig(partial?: Partial<AgentConfig>): AgentConfig;
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

@@ -16,6 +16,8 @@ export const DEFAULT_CONFIG = {
     runMaxAttempts: 3,
     stopPollMs: 500,
     runRedriveDelaySeconds: 2,
+    runRetryBackoffMs: 5_000,
+    runRetryBackoffMaxMs: 120_000,
     subagentMaxDepth: 2,
     subagentMaxConcurrent: 3,
     subagentMaxSteps: 10,
@@ -28,7 +30,18 @@ export const DEFAULT_CONFIG = {
     contextTailShare: 0.25,
     compactionModel: 'gpt-4o-mini',
     promptCaching: true,
-    runLockLeaseSeconds: 30 * 60,
+    runLockLeaseSeconds: 2 * 60,
+    stepTimeoutMs: 0,
+    segmentTimeoutMs: 0,
+    maxQueueWaitMs: 0,
+    maxQueueDepth: 0,
+    streamGraceMs: 10 * 60_000,
+    streamTtlMs: 24 * 60 * 60_000,
+    streamFlushMs: 50,
+    streamFlushEvents: 32,
+    builtinToolResultCapChars: 20_000,
+    sandboxIdleTtlMs: 30 * 60_000,
+    sandboxMaxLifetimeMs: 24 * 60 * 60_000,
 };
 export function resolveConfig(partial) {
     const config = { ...DEFAULT_CONFIG, ...partial };
@@ -45,9 +58,24 @@ export function resolveConfig(partial) {
         // The poll is the only thing that delivers a stop to a running worker (§2.1)
         throw new Error(`Invalid config: stopPollMs (${config.stopPollMs}) must be an integer of at least 1`);
     }
+    for (const key of ['runRetryBackoffMs', 'runRetryBackoffMaxMs']) {
+        if (!Number.isInteger(config[key]) || config[key] < 0) {
+            throw new Error(`Invalid config: ${key} (${config[key]}) must be a non-negative integer`);
+        }
+    }
     if (!Number.isInteger(config.runRedriveDelaySeconds) || config.runRedriveDelaySeconds < 0) {
         throw new Error(`Invalid config: runRedriveDelaySeconds (${config.runRedriveDelaySeconds}) must be a non-negative integer`);
     }
+    for (const key of ['streamGraceMs', 'streamTtlMs', 'streamFlushEvents', 'builtinToolResultCapChars', 'sandboxIdleTtlMs', 'sandboxMaxLifetimeMs']) {
+        if (!Number.isInteger(config[key]) || config[key] < 1) {
+            throw new Error(`Invalid config: ${key} (${config[key]}) must be an integer of at least 1`);
+        }
+    }
+    for (const key of ['stepTimeoutMs', 'segmentTimeoutMs', 'maxQueueWaitMs', 'maxQueueDepth', 'streamFlushMs']) {
+        if (!Number.isFinite(config[key]) || config[key] < 0) {
+            throw new Error(`Invalid config: ${key} (${config[key]}) must not be negative`);
+        }
+    }
     if (!Number.isInteger(config.runLockLeaseSeconds) || config.runLockLeaseSeconds < 1) {
         // The lease is the only thing that heals a crashed worker's lock — a
         // zero/fractional value would deadlock the thread forever (§3.4)

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAoSA,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAClC,IAAsB,EACtB,QAA0B;IAE1B,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3B,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;AAClC,CAAC;AAkED;kDACkD;AAClD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAoB,EAAE,GAAW,EAAU,EAAE,CAClE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAmHlE,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,SAAS,EAAE,EAAE,GAAG,MAAM;IACtB,cAAc,EAAE,MAAM;IACtB,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,CAAC;IACjB,UAAU,EAAE,GAAG;IACf,sBAAsB,EAAE,CAAC;IACzB,gBAAgB,EAAE,CAAC;IACnB,qBAAqB,EAAE,CAAC;IACxB,gBAAgB,EAAE,EAAE;IACpB,sBAAsB,EAAE,KAAK;IAC7B,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,KAAK;IACtB,oBAAoB,EAAE,OAAO;IAC7B,0BAA0B,EAAE,MAAM;IAClC,iBAAiB,EAAE,GAAG;IACtB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,aAAa;IAC9B,aAAa,EAAE,IAAI;IACnB,mBAAmB,EAAE,EAAE,GAAG,EAAE;CAC7B,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,OAA8B;IAC1D,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;IACjD,IAAI,MAAM,CAAC,gBAAgB,GAAG,CAAC,IAAI,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7E,6EAA6E;QAC7E,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,CAAC,gBAAgB,qCAAqC,MAAM,CAAC,QAAQ,GAAG,CACpH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5B,0EAA0E;QAC1E,qDAAqD;QACrD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QAClE,6EAA6E;QAC7E,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,CAAC,UAAU,oCAAoC,CACrF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,sBAAsB,CAAC,IAAI,MAAM,CAAC,sBAAsB,GAAG,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CACb,2CAA2C,MAAM,CAAC,sBAAsB,kCAAkC,CAC3G,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,MAAM,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC;QACpF,qEAAqE;QACrE,iEAAiE;QACjE,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,CAAC,mBAAmB,oCAAoC,CACvG,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/usage.d.ts

@@ -1,4 +1,4 @@
-import type { NewUsage, UsageTotals } from './types.js';
+import type { NewUsage, UsageLine, UsageTotals } from './types.js';
 import type { RuntimePorts } from '../ports/runtime.js';
 /** Token attribution (§4): the four canonical counters. Same shape as
  *  UsageTotals. */
@@ -71,15 +71,63 @@ export declare function providerMeta(meta?: ProviderMetadataLike, response?: {
  *  price list is not. Storage failures are logged for the same reason — the
  *  tokens of a stopped run were still spent. */
 export declare function recordCall(deps: RuntimePorts, threadId: string, usage: NewUsage): Promise<NewUsage>;
+/** What a run has spent, main agent and nested runs together (§2.7): its
+ *  tokens, its money and the one currency that money is in. Shared by
+ *  reference so a child's spend counts against the run's caps the moment it
+ *  happens — a budget that ignores delegated work is not a budget.
+ *
+ *  A run's ledger starts from what the run already spent (`seedRunLedger`):
+ *  its earlier segments, before a park or a retry, count against the same
+ *  caps. After that it is kept in memory, so the caps are checked without
+ *  reading every usage row back after every step. */
+export declare class RunLedger {
+    tokensUsed: number;
+    costMicros: number;
+    currency: string | undefined;
+    /** Price one call, store its row and book it (§4). A run is priced in one
+     *  currency: a call priced in another is stored unpriced, with an error
+     *  logged, rather than mixed into a bill that cannot add it up. */
+    record(deps: RuntimePorts, threadId: string, usage: NewUsage): Promise<NewUsage>;
+}
+/** Start a ledger from the run's usage rows (§4). A failed read is logged and
+ *  the ledger starts from zero: a run is not failed over its caps'
+ *  bookkeeping. */
+export declare function seedRunLedger(deps: RuntimePorts, threadId: string, runId?: string): Promise<RunLedger>;
 /** Zero totals — what a thread with no usage rows reports. */
 export declare const emptyTotals: () => UsageTotals;
+/** One grouped row, as a SQL adapter reads it: a line, the currency its
+ *  cost is in, its summed total tokens and how many of its calls were
+ *  unpriced. */
+export interface UsageGroup {
+    line: UsageLine;
+    currency?: string | null;
+    totalTokens: number;
+    unpriced: number;
+}
+/** Rebuilds UsageTotals from grouped rows that a SQL adapter read GROUP BY
+ *  agent, model AND currency. Grouping by currency is what keeps a sum honest;
+ *  merging here is what keeps one agent's spend on one model a single line.
+ *
+ *  The rules, the same in every adapter and in the Go runtime: `costMicros`
+ *  is summed in the first currency seen, and a group priced in another
+ *  currency counts as unpriced there instead of being added. `costs` keeps
+ *  every currency's own total. A line takes the currency of the first priced
+ *  group on it; a group priced in a different currency gets a line of its
+ *  own, and unpriced groups join the first line of their agent and model. */
+export declare class UsageMerger {
+    private readonly out;
+    private readonly lines;
+    private readonly costs;
+    add(g: UsageGroup): void;
+    totals(): UsageTotals;
+}
 /** Sum usage rows into the shape `total` must return: the four counters, the
  *  money, and one line per agent and model.
  *
- *  A storage adapter that can group in the database should do that instead.
- *  This is for the ones that cannot, and for anyone writing their own adapter:
- *  feed every matching row through it and you get exactly what the port
- *  promises, lines in first-seen order. */
+ *  A storage adapter that can group in the database should do that instead
+ *  (see UsageMerger). This is for the ones that cannot, and for anyone writing
+ *  their own adapter: feed every matching row through it and you get exactly
+ *  what the port promises, lines in first-seen order. */
 export declare function sumUsage(rows: Iterable<NewUsage>): UsageTotals;
 export {};
 //# sourceMappingURL=usage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/core/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;mBACmB;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;+CAE+C;AAC/C,MAAM,MAAM,oBAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,GACnD,SAAS,CAAC;AAEd,KAAK,SAAS,GAAG;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,SAAS,CAAC;AASd;;;;;;;;;;;uEAWuE;AACvE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,gBAAgB,CAsBlB;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAEjF;AAGD;;;2BAG2B;AAC3B,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAKpE;AAED;;0BAE0B;AAC1B,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAKrF;AAED;;;gCAGgC;AAChC,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,IAAI,CACL,QAAQ,EACN,aAAa,GACb,sBAAsB,GACtB,uBAAuB,GACvB,cAAc,GACd,iBAAiB,GACjB,aAAa,CAChB,CAUA;AAED;;;wCAGwC;AACxC,wBAAgB,YAAY,CAC1B,IAAI,CAAC,EAAE,oBAAoB,EAC3B,QAAQ,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAOrC;AAED;;;;;;;;;gDASgD;AAChD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,QAAQ,CAAC,CAgBnB;AAGD,8DAA8D;AAC9D,eAAO,MAAM,WAAW,QAAO,WAQ7B,CAAC;AAEH;;;;;;2CAM2C;AAC3C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,WAAW,CAwC9D"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/core/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;mBACmB;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;+CAE+C;AAC/C,MAAM,MAAM,oBAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,GACnD,SAAS,CAAC;AAEd,KAAK,SAAS,GAAG;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,SAAS,CAAC;AASd;;;;;;;;;;;uEAWuE;AACvE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,gBAAgB,CAuBlB;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAEjF;AAGD;;;2BAG2B;AAC3B,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAKpE;AAED;;0BAE0B;AAC1B,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAKrF;AAED;;;gCAGgC;AAChC,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,IAAI,CACL,QAAQ,EACN,aAAa,GACb,sBAAsB,GACtB,uBAAuB,GACvB,cAAc,GACd,iBAAiB,GACjB,aAAa,CAChB,CAUA;AAED;;;wCAGwC;AACxC,wBAAgB,YAAY,CAC1B,IAAI,CAAC,EAAE,oBAAoB,EAC3B,QAAQ,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAOrC;AAED;;;;;;;;;gDASgD;AAIhD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,QAAQ,CAAC,CAInB;AA0BD;;;;;;;;qDAQqD;AACrD,qBAAa,SAAS;IACpB,UAAU,SAAK;IACf,UAAU,SAAK;IACf,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B;;uEAEmE;IAC7D,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;CAgBvF;AAED;;mBAEmB;AACnB,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAY5G;AAGD,8DAA8D;AAC9D,eAAO,MAAM,WAAW,QAAO,WAQ7B,CAAC;AAEH;;gBAEgB;AAChB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;6EAS6E;AAC7E,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;IAyDxB,MAAM,IAAI,WAAW;CAGtB;AAED;;;;;;yDAMyD;AACzD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,WAAW,CAwB9D"}