@namzu/sdk 43.0.0 → 44.1.0

package/dist/types/agent/base.d.ts

@@ -1,15 +1,18 @@
-import type { TokenBudget } from '../../run/token-budget.js';
 import type { ProjectInstructionContext } from '../../runtime/query/project-instructions.js';
-import type { PathBuilder } from '../../session/workspace/path-builder.js';
+import type { SessionPaths } from '../../session/paths.js';
+import type { SessionTokenBudget } from '../../store/budget/index.js';
+import type { SessionCheckpointStore } from '../../store/checkpoint/index.js';
+import type { SessionLog } from '../../store/session-log/index.js';
 import type { Logger } from '../../utils/logger.js';
-import type { CostInfo, RunExecutionStatus, TokenUsage } from '../common/index.js';
+import type { CostInfo, TokenUsage } from '../common/index.js';
 import type { ResumeHandler } from '../hitl/index.js';
-import type { RunId, SessionId, TenantId } from '../ids/index.js';
+import type { SessionId, TenantId, TurnId } from '../ids/index.js';
 import type { InvocationState } from '../invocation/index.js';
 import type { Message } from '../message/index.js';
 import type { PermissionMode } from '../permission/index.js';
-import type { StopReason } from '../run/stop-reason.js';
 import type { ProjectId, TopicId } from '../session/ids.js';
+import type { StopReason } from '../session/stop-reason.js';
+import type { TurnExecutionStatus } from '../session/turn.js';
 import type { TaskStore } from '../task/index.js';
 import type { ToolAvailability } from '../tool/index.js';
 export type AgentType = 'reactive' | 'pipeline' | 'router' | 'supervisor';
@@ -18,11 +21,11 @@ export interface BaseAgentConfig {
     model: string;
     tokenBudget: number;
     /** Aggregate authority inherited by descendants; supplied independently of the numeric local cap. */
-    budget?: TokenBudget;
+    budget?: SessionTokenBudget;
     timeoutMs: number;
-    /** See {@link import('../run/config.js').AgentRunConfig.streamIdleTimeoutMs}. */
+    /** See {@link import('../session/config.js').TurnConfig.streamIdleTimeoutMs}. */
     streamIdleTimeoutMs?: number;
-    /** See {@link import('../run/config.js').AgentRunConfig.maxRequestRichContentBytes}. */
+    /** See {@link import('../session/config.js').TurnConfig.maxRequestRichContentBytes}. */
     maxRequestRichContentBytes?: number;
     /** Maximum stored-attachment materialization time; defaults to one minute. `0` disables. */
     attachmentResolveTimeoutMs?: number;
@@ -32,23 +35,43 @@ export interface BaseAgentConfig {
     costLimitUsd?: number;
     permissionMode?: PermissionMode;
     /**
-     * Durable run/checkpoint layout for this agent invocation.
+     * Checkpoint retention for this agent's turn. See
+     * {@link import('../session/config.js').TurnConfig.pruneKeepLast}; absent
+     * keeps every checkpoint, as before.
+     */
+    pruneKeepLast?: number;
+    /**
+     * The durable layout for this agent invocation: where its session log,
+     * checkpoints, ledgers and tasks live (`~/.namzu/projects/<slug>/…`).
      *
-     * Absent preserves the kernel default rooted at the run's working
-     * directory. Hosts with a central application home pass one builder here;
-     * every concrete agent forwards it to the same `query()` boundary.
+     * Absent: `SessionPaths` under `resolveNamzuHome()`, unless
+     * {@link BaseAgentConfig.sessionLog} is an `InMemorySessionLog`, in which
+     * case the session writes nothing to disk.
+     */
+    paths?: SessionPaths;
+    /**
+     * The session log this agent's turns append to. See `QueryParams.sessionLog`.
+     *
+     * An `InMemorySessionLog` with no `paths` keeps the whole session in
+     * memory: its checkpoints and its token ledger too, and every child
+     * session it delegates to (`AgentTaskContext.childStorage`).
+     */
+    sessionLog?: SessionLog;
+    /**
+     * Where this agent's turns keep their checkpoints. See
+     * `QueryParams.checkpointStore`.
      */
-    pathBuilder?: PathBuilder;
+    checkpointStore?: SessionCheckpointStore;
     /**
-     * Run-level sandbox limits and workspace ownership.
+     * Turn-level sandbox limits and workspace ownership.
      *
      * A provider alone only says HOW commands are confined. This field says
      * WHAT it is rooted at; `working-directory` makes sandbox-aware tools act
-     * on the run's declared workspace instead of a disposable empty tree.
+     * on the turn's declared workspace instead of a disposable empty tree.
      */
-    sandbox?: import('../run/config.js').AgentRunConfig['sandbox'];
+    sandbox?: import('../session/config.js').TurnConfig['sandbox'];
     /**
-     * The tools this run may use, narrowing whatever its registry holds.
+     * The tools this turn may use, narrowing whatever its registry holds.
      *
      * `allowedTools` existed on `QueryParams` and on `ToolContext` and
      * nowhere on the path a delegation takes — so a supervisor handing a
@@ -62,12 +85,12 @@ export interface BaseAgentConfig {
      * tools and let it call any of them by name.
      */
     /**
-     * Text queued for this run since its last turn, drained at the boundary.
+     * Text queued for this turn since its last turn, drained at the boundary.
      *
      * A callback rather than an array, because the queue is owned by
      * whoever accepts the messages — `AgentManager` for a delegated child, a
-     * host for a top-level run — and an array captured at config time would
-     * be whatever was queued before the run started.
+     * host for a top-level turn — and an array captured at config time would
+     * be whatever was queued before the turn started.
      *
      * It exists because two public APIs could accept text and silently never
      * deliver it. `AgentManager.continueTask` and `queueMessage` pushed onto
@@ -76,7 +99,7 @@ export interface BaseAgentConfig {
      * unmounted from the coordinator tools because of it. The steering
      * channel had the mirror-image hole: it can only ride on a tool result,
      * so guidance queued during a turn that called no tools stayed pending
-     * until the run ended.
+     * until the turn ended.
      */
     inboundMessages?: () => import('../message/index.js').Message[];
     /** Live project policy, flushed independently of human continuation text. */
@@ -88,7 +111,7 @@ export interface BaseAgentConfig {
      *
      * See {@link import('../../runtime/query/index.js').QueryParams.toolResultGuardrails}.
      * On the BASE config rather than one agent's, because a delegated child is
-     * a fresh run with its own executor: a switch that reached this agent and
+     * a fresh turn with its own executor: a switch that reached this agent and
      * not its children would leave the default on in exactly the half a host
      * would be trying to change. Absent installs the shipped default; an empty
      * array installs none.
@@ -100,13 +123,13 @@ export interface BaseAgentConfig {
      * shape as `parentSpan`, `resumeHandler` and `env`. The value it stamps is
      * the spawning context's (`AgentTaskContext.toolResultGuardrails`), which
      * `SupervisorAgent` fills from this field and the delegation tools fill
-     * from the run's own `ToolContext`; a spawn that supplies
+     * from the turn's own `ToolContext`; a spawn that supplies
      * `configOverrides.toolResultGuardrails` replaces it rather than merging,
      * so a host can still hand one child a different set — including none.
      */
     toolResultGuardrails?: readonly import('../guardrail/index.js').ToolResultGuardrailSpec[];
     /**
-     * Tools this run may NOT use, subtracted from whatever it would
+     * Tools this turn may NOT use, subtracted from whatever it would
      * otherwise have.
      *
      * Separate from `allowedTools` because they answer different
@@ -117,14 +140,14 @@ export interface BaseAgentConfig {
      * an agent that later gains a tool.
      */
     deniedTools?: readonly string[];
-    /** Persona for this run, overriding what the agent's definition supplies. */
+    /** Persona for this turn, overriding what the agent's definition supplies. */
     persona?: import('../persona/index.js').AgentPersona;
     /**
-     * Override the logger this run's `AbstractAgent.bindRun` uses instead of
-     * the logger the agent was CONSTRUCTED with. Same reason `thinking` and
-     * `effort` are declared here rather than per-config: every concrete agent
-     * builds its `runConfig` by hand-listing fields, and a field absent from a
-     * hand-listed literal is dropped in silence. A host that wants one run's
+     * Override the logger this turn uses instead of the logger the agent was
+     * CONSTRUCTED with. Same reason `thinking` and `effort` are declared here
+     * rather than per-config: every concrete agent builds its `turnConfig` by
+     * hand-listing fields, and a field absent from a hand-listed literal is
+     * dropped in silence. A host that wants one turn's
      * output routed differently — without reconstructing the agent — sets this.
      */
     logger?: Logger;
@@ -136,7 +159,7 @@ export interface BaseAgentConfig {
      * **Configuration, not credentials** — and that is a property of the
      * CHANNEL rather than a judgement about any particular value. This map is
      * copied into every child, is readable by any tool that can run a command,
-     * and enters a model's context and the run transcript the moment something
+     * and enters a model's context and the turn transcript the moment something
      * echoes it. Nothing here is scoped, redacted, or revocable.
      *
      * A value that authenticates to a host belongs on the brokered credential
@@ -153,11 +176,11 @@ export interface BaseAgentConfig {
     env?: Record<string, string>;
     /**
      * Thinking mode and response-effort level for every model call this agent
-     * makes. See {@link import('../run/config.js').AgentRunConfig} for what
+     * makes. See {@link import('../session/config.js').TurnConfig} for what
      * each one controls and why they are siblings.
      *
      * They are declared HERE, on the shared base, rather than on each agent
-     * config that happens to want them. Every agent builds its `AgentRunConfig`
+     * config that happens to want them. Every agent builds its `TurnConfig`
      * by hand-listing fields, and a field absent from a hand-listed literal is
      * dropped in silence — which is exactly how `thinking` came to be settable
      * only through the raw kernel entry point while every ergonomic one quietly
@@ -184,7 +207,7 @@ export interface BaseAgentConfig {
      */
     idempotencyKey?: string;
     /**
-     * Long-lived goal scope for the run. Required at runtime — agents reject
+     * Long-lived goal scope for the turn. Required at runtime — agents reject
      * configs missing this (`'X requires sessionId, projectId, and tenantId
      * in config'`).
      *
@@ -195,23 +218,26 @@ export interface BaseAgentConfig {
      */
     projectId?: ProjectId;
     /**
-     * Topic the run belongs to. Optional at the TYPE level for the same
+     * Topic the turn belongs to. Optional at the TYPE level for the same
      * reason as `projectId` — {@link AgentManager} stamps this field after
      * `configBuilder` returns so `configBuilder` implementations do not
      * need to be updated before this tightens. Tightening to required
      * lands with the `AgentFactoryOptions` triple refactor.
      */
     topicId?: TopicId;
-    /** Session under which the run executes. See `projectId` for the tightening plan. */
+    /** Session under which the turn executes. See `projectId` for the tightening plan. */
     sessionId?: SessionId;
     /** Isolation boundary (Convention #17). See `projectId` for the tightening plan. */
     tenantId?: TenantId;
-    parentRunId?: RunId;
+    /** Present on a child session: the session that delegated it. */
+    parentSessionId?: SessionId;
+    /** Present on a child session: the parent turn whose tool call spawned it. */
+    parentTurnId?: TurnId;
     depth?: number;
     contextLevel?: AgentContextLevel;
     /** Shared invocation state passed through agent hierarchies */
     invocationState?: InvocationState;
-    /** Span a delegated run hangs off. Absent for a top-level run. */
+    /** Span a delegated session hangs off. Absent for a top-level turn. */
     parentSpan?: import('@opentelemetry/api').Span;
     /**
      * Where this agent takes a decision it cannot make alone — a tool that
@@ -267,9 +293,10 @@ export interface AgentInput {
 }
 export interface BaseAgentResult {
     /** Aggregate tree accounting, separate from this invocation's own usage. */
-    budget?: ReturnType<TokenBudget['summary']>;
-    runId: RunId;
-    status: RunExecutionStatus;
+    budget?: ReturnType<SessionTokenBudget['summary']>;
+    sessionId: SessionId;
+    turnId: TurnId;
+    status: TurnExecutionStatus;
     stopReason?: StopReason;
     usage: TokenUsage;
     cost: CostInfo;
@@ -278,9 +305,9 @@ export interface BaseAgentResult {
     messages: Message[];
     result?: string;
     /**
-     * The schema-validated answer, when the run was configured to produce one.
+     * The schema-validated answer, when the turn was configured to produce one.
      *
-     * `Run.structuredOutput` has carried this all along and every ergonomic
+     * `Turn.structuredOutput` has carried this all along and every ergonomic
      * boundary above it dropped the value three lines from its caller: an
      * archetype's result literal did not copy it, `runAgent` did not even
      * forward the config that produces it, and both delegation tools handed a
@@ -289,7 +316,7 @@ export interface BaseAgentResult {
      * model re-parse what it had just caused to be serialized.
      *
      * `unknown` rather than a generic, deliberately. The schema lives on the
-     * run's config and a result type parameter would have to be threaded
+     * turn's config and a result type parameter would have to be threaded
      * through every archetype, both delegation tools and the task record to
      * reach here — and at the delegation boundary the parent does not hold the
      * child's schema anyway, so the parameter would be `unknown` again at the

package/dist/types/agent/base.d.ts.map

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

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

@@ -1,21 +1,21 @@
-import type { RunEventListener } from '../run/index.js';
+import type { SessionEventListener } from '../session/events.js';
 import type { AgentCapabilities, AgentInput, AgentMetadata, AgentType, BaseAgentConfig, BaseAgentResult } from './base.js';
 export interface Agent<TConfig extends BaseAgentConfig = BaseAgentConfig, TResult extends BaseAgentResult = BaseAgentResult> {
     readonly type: AgentType;
     readonly metadata: AgentMetadata;
-    run(input: AgentInput, config: TConfig, listener?: RunEventListener): Promise<TResult>;
+    run(input: AgentInput, config: TConfig, listener?: SessionEventListener): Promise<TResult>;
     /**
-     * A shell of this agent that one run may have to itself.
+     * A shell of this agent that one turn may have to itself.
      *
-     * An agent instance holds per-run state — an abort controller, the id of
-     * the run in flight — and refuses a second concurrent `run` because of it.
-     * That refusal is correct for a host calling `run` twice on purpose: two
-     * overlapping runs would share one abort controller, so cancelling either
-     * kills both.
+     * An agent instance holds per-turn state — an abort controller, the id of
+     * the turn in flight — and refuses a second concurrent `run` call because
+     * of it. That refusal is correct for a host calling `run` twice on purpose:
+     * two overlapping turns would share one abort controller, so cancelling
+     * either kills both.
      *
      * It is wrong for delegation, which is why this exists. `AgentRegistry`
      * hands out ONE instance per registered id, so a fan-out naming the same
-     * `agent_id` four times drove four runs at one shell: one worked and three
+     * `agent_id` four times drove four turns at one shell: one worked and three
      * died with `ConcurrentInvocationError`. The prescribed remedy — "construct
      * a second instance" — was unreachable from there, because the definition
      * owns the instance and the caller only has an id.
@@ -24,7 +24,7 @@ export interface Agent<TConfig extends BaseAgentConfig = BaseAgentConfig, TResul
      * falls back to the shared one and the refusal stands, which is loud rather
      * than wrong. `AbstractAgent` implements it for every agent built on it.
      */
-    forRun?(): Agent<TConfig, TResult>;
+    forTurn?(): Agent<TConfig, TResult>;
     cancel(): Promise<void>;
     getCapabilities(): AgentCapabilities;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/types/agent/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EACX,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,WAAW,CAAA;AAElB,MAAM,WAAW,KAAK,CACrB,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe;IAEjD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAEhC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEtF;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAElC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,eAAe,IAAI,iBAAiB,CAAA;CACpC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/types/agent/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EACX,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,WAAW,CAAA;AAElB,MAAM,WAAW,KAAK,CACrB,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe;IAEjD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAEhC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE1F;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAEnC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,eAAe,IAAI,iBAAiB,CAAA;CACpC"}

package/dist/types/agent/delegate.d.ts

@@ -32,7 +32,7 @@ export interface DelegateRequest {
      *
      * Forwarded for the reason the `Agent` tool gives for forwarding it to a
      * local child: a delegate that cannot see it runs against different
-     * services than the run that launched it, silently. A remote delegate
+     * services than the turn that launched it, silently. A remote delegate
      * may well ignore it, which is its business.
      */
     readonly env?: Readonly<Record<string, string>>;
@@ -42,7 +42,7 @@ export interface DelegateRequest {
  *
  * `status` is the delegate's own answer and is the only authority a foreign
  * delegate has — there is no second layer to cross-check it against the way
- * a local run's `TaskHandle.state` and `BaseAgentResult.status` check each
+ * a local turn's `TaskHandle.state` and `BaseAgentResult.status` check each
  * other. `DelegatingTaskScheduler` maps this onto BOTH so that
  * `taskSucceeded` and `taskFailed` keep working unchanged; that mapping is
  * the whole reason this type is this small.

package/dist/types/agent/factory.d.ts

@@ -10,14 +10,14 @@ export interface AgentDefinition {
      * Build a fresh agent for a single spawn.
      *
      * `typedAgent` is ONE instance, and an instance refuses a second
-     * concurrent run because it holds per-run state. So a delegation fan-out
+     * concurrent run because it holds per-turn state. So a delegation fan-out
      * naming the same `agent_id` four times ran one child and lost three to
      * `ConcurrentInvocationError` — while `create_task`'s own description tells
      * a model that exactly this fan-out is the thing to do.
      *
      * The manager prefers this over `typedAgent` for every spawn. Supply it
      * when your agent needs real construction arguments; agents built on
-     * `AbstractAgent` already get a working default from `Agent.forRun`, so
+     * `AbstractAgent` already get a working default from `Agent.forTurn`, so
      * most hosts need nothing here.
      *
      * `configBuilder` is not a substitute: it produces a fresh CONFIG per
@@ -64,8 +64,10 @@ export interface AgentFactoryOptions {
     providerConfig?: Record<string, unknown>;
     agentDefinitions?: AgentDefinition[];
     taskRouter?: TaskRouterConfig;
-    runId?: string;
-    parentRunId?: string;
+    sessionId?: string;
+    turnId?: string;
+    parentSessionId?: string;
+    parentTurnId?: string;
     depth?: number;
 }
 //# sourceMappingURL=factory.d.ts.map

package/dist/types/agent/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/types/agent/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AACpF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAEtC,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,SAAS,CAAA;IACf,UAAU,EAAE,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,CAAA;IAEnD;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,EAAE,MAAM,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,CAAA;IAE3D,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAE5F,YAAY,CAAC,EAAE,iBAAiB,CAAA;CAChC;AAED,MAAM,WAAW,mBAAmB;IACnC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IAEpC,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAExC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;IAEpC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAE7B,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/types/agent/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AACpF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAEtC,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,SAAS,CAAA;IACf,UAAU,EAAE,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,CAAA;IAEnD;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,EAAE,MAAM,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,CAAA;IAE3D,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAE5F,YAAY,CAAC,EAAE,iBAAiB,CAAA;CAChC;AAED,MAAM,WAAW,mBAAmB;IACnC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IAEpC,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAExC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;IAEpC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAE7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd"}

package/dist/types/agent/manager.d.ts

@@ -1,7 +1,7 @@
-import type { RunId, TaskId } from '../ids/index.js';
+import type { SessionId, TaskId } from '../ids/index.js';
 import type { Message } from '../message/index.js';
-import type { CancelCause } from '../run/cancel-cause.js';
-import type { RunEventListener } from '../run/events.js';
+import type { CancelCause } from '../session/cancel-cause.js';
+import type { SessionEventListener } from '../session/events.js';
 import type { AgentLifecycleListener } from './lifecycle-event.js';
 import type { AgentTask, AgentTaskContext, AgentTaskState, SendMessageOptions } from './task.js';
 /**
@@ -9,14 +9,14 @@ import type { AgentTask, AgentTaskContext, AgentTaskState, SendMessageOptions }
  * Concrete implementation: `AgentManager` in `manager/agent/lifecycle.ts`.
  */
 export interface AgentManagerContract {
-    sendMessage(options: SendMessageOptions, context: AgentTaskContext, listener?: RunEventListener): Promise<AgentTask>;
+    sendMessage(options: SendMessageOptions, context: AgentTaskContext, listener?: SessionEventListener): Promise<AgentTask>;
     cancel(taskId: TaskId, cause?: CancelCause): void;
     /**
      * Defaults to `'parent'` when a caller names nothing, because this call
      * site IS a parent abandoning its children — unlike `AbstractAgent.cancel`,
      * where the caller could be anyone.
      */
-    cancelAll(parentRunId: RunId, cause?: CancelCause): void;
+    cancelAll(parentSessionId: SessionId, cause?: CancelCause): void;
     /**
      * Queue a message for a running task.
      *
@@ -48,7 +48,7 @@ export interface AgentManagerContract {
     drainMessages(taskId: TaskId): Message[];
     waitForCompletion(taskId: TaskId): Promise<void>;
     getInstance(taskId: TaskId): AgentTask | undefined;
-    listByParent(parentRunId: RunId): AgentTask[];
+    listByParent(parentSessionId: SessionId): AgentTask[];
     listActive(): AgentTask[];
     getState(taskId: TaskId): AgentTaskState | undefined;
     on(listener: AgentLifecycleListener): void;

package/dist/types/agent/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/types/agent/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEhG;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,WAAW,CACV,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,SAAS,CAAC,CAAA;IAErB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IACjD;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAExD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,wDAAwD;IACxD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACpD,2EAA2E;IAC3E,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAAA;IAExC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;IAClD,YAAY,CAAC,WAAW,EAAE,KAAK,GAAG,SAAS,EAAE,CAAA;IAC7C,UAAU,IAAI,SAAS,EAAE,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;IAEpD,EAAE,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC1C,GAAG,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAE3C,OAAO,IAAI,IAAI,CAAA;IACf,OAAO,IAAI,IAAI,CAAA;CACf"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/types/agent/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEhG;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,WAAW,CACV,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,CAAA;IAErB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IACjD;;;;OAIG;IACH,SAAS,CAAC,eAAe,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAEhE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,wDAAwD;IACxD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACpD,2EAA2E;IAC3E,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAAA;IAExC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;IAClD,YAAY,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,EAAE,CAAA;IACrD,UAAU,IAAI,SAAS,EAAE,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;IAEpD,EAAE,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC1C,GAAG,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAE3C,OAAO,IAAI,IAAI,CAAA;IACf,OAAO,IAAI,IAAI,CAAA;CACf"}

package/dist/types/agent/pipeline.d.ts

@@ -1,11 +1,12 @@
-import type { TokenBudget } from '../../run/token-budget.js';
-import type { RunId } from '../ids/index.js';
+import type { SessionTokenBudget } from '../../store/budget/index.js';
+import type { SessionId, TurnId } from '../ids/index.js';
 import type { LLMProvider } from '../provider/index.js';
 import type { BaseAgentConfig, BaseAgentResult } from './base.js';
 export interface StepContext {
     /** Shared authority; reserve a child scope before invoking another agent. */
-    budget: TokenBudget;
-    runId: RunId;
+    budget: SessionTokenBudget;
+    sessionId: SessionId;
+    turnId: TurnId;
     stepIndex: number;
     totalSteps: number;
     previousResults: Map<string, unknown>;

package/dist/types/agent/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/types/agent/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAEjE,MAAM,WAAW,WAAW;IAC3B,6EAA6E;IAC7E,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAChE,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9D,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CACjC;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC3D,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC3D,WAAW,EAAE,kBAAkB,EAAE,CAAA;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;CAClB"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/types/agent/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAEjE,MAAM,WAAW,WAAW;IAC3B,6EAA6E;IAC7E,MAAM,EAAE,kBAAkB,CAAA;IAC1B,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAChE,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9D,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CACjC;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC3D,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC3D,WAAW,EAAE,kBAAkB,EAAE,CAAA;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;CAClB"}

package/dist/types/agent/reactive.d.ts

@@ -7,9 +7,8 @@ import type { InputGuardrailSpec, OutputGuardrailSpec } from '../guardrail/index
 import type { ResumeHandler } from '../hitl/index.js';
 import type { AgentPersona } from '../persona/index.js';
 import type { LLMProvider } from '../provider/index.js';
-import type { CheckpointStore } from '../run/checkpoint-store.js';
-import type { BeforeStep, PrepareStepChain, StepResult, StopCondition } from '../run/index.js';
 import type { SandboxProvider } from '../sandbox/index.js';
+import type { BeforeStep, PrepareStepChain, StepResult, StopCondition } from '../session/index.js';
 import type { Skill } from '../skills/index.js';
 import type { StructuredOutputConfig } from '../structured-output/index.js';
 import type { ToolRegistryContract } from '../tool/index.js';
@@ -18,13 +17,13 @@ import type { BaseAgentConfig, BaseAgentResult } from './base.js';
 import type { WorkingMemoryProvider } from './working-memory.js';
 export interface ReactiveAgentConfig extends BaseAgentConfig {
     systemPrompt?: string;
-    /** Provider-hosted search for this run; the selected driver must support it. */
+    /** Provider-hosted search for this turn; the selected driver must support it. */
     webSearch?: {
         mode: 'live' | 'cached';
     };
     persona?: AgentPersona;
     /**
-     * Channel a host uses to hand guidance to this run's current turn.
+     * Channel a host uses to hand guidance to this turn's current turn.
      *
      * Present here for the same reason it is on `SupervisorAgentConfig`, and
      * the reason that file gives twice already: a capability the kernel
@@ -52,7 +51,7 @@ export interface ReactiveAgentConfig extends BaseAgentConfig {
     /**
      * Optional ephemeral sandbox provider. When set, drainQuery creates
      * a sandbox via `provider.create()` before the iteration loop and
-     * routes filesystem / shell tool calls through it; on run end the
+     * routes filesystem / shell tool calls through it; on turn end the
      * SDK calls `sandbox.destroy()`. Hosts that want a per-task
      * container shared across supervisor + every child specialist run
      * pass the SAME provider instance to all of them — caching layered
@@ -61,6 +60,10 @@ export interface ReactiveAgentConfig extends BaseAgentConfig {
     sandboxProvider?: SandboxProvider;
     /** See {@link QueryParams.sandboxTeardownTimeoutMs}. */
     sandboxTeardownTimeoutMs?: number;
+    /** See {@link QueryParams.outsideRootAccess}. Default `'refuse'`. */
+    outsideRootAccess?: 'refuse' | 'review';
+    /** See {@link QueryParams.sandboxEscape}. Default `'refuse'`. */
+    sandboxEscape?: 'refuse' | 'review';
     /**
      * Optional structured-compaction config. Omitted ⇒ byte-identical run path
      * (no `WorkingStateManager`, compaction early-returns). Mirrors the field
@@ -82,7 +85,7 @@ export interface ReactiveAgentConfig extends BaseAgentConfig {
      * `AgentManager` spawns and what the estate's own applications call —
      * and it forwarded none of them. So a per-tool deadline, a provider
      * retry policy, a guardrail, a stop condition: all of it was reachable
-     * only by dropping down to `query()` and rebuilding the run wiring by
+     * only by dropping down to `query()` and rebuilding the turn wiring by
      * hand. Features that a consumer cannot reach are features that do not
      * exist for them.
      *
@@ -91,7 +94,6 @@ export interface ReactiveAgentConfig extends BaseAgentConfig {
      */
     resumeHandler?: ResumeHandler;
     retry?: QueryParams['retry'];
-    emergencySave?: boolean;
     toolTimeoutMs?: number;
     toolRetryBackoff?: QueryParams['toolRetryBackoff'];
     maxToolConcurrency?: number;
@@ -116,10 +118,9 @@ export interface ReactiveAgentConfig extends BaseAgentConfig {
     structuredOutput?: StructuredOutputConfig;
     inputGuardrails?: readonly InputGuardrailSpec[];
     outputGuardrails?: readonly OutputGuardrailSpec[];
-    checkpointStore?: CheckpointStore;
     /**
-     * Span this run should hang off, when it is a delegated one. Absent for
-     * a top-level run, which correctly starts its own root trace.
+     * Span this turn should hang off, when it is a delegated one. Absent for
+     * a top-level turn, which correctly starts its own root trace.
      */
     parentSpan?: import('@opentelemetry/api').Span;
 }

package/dist/types/agent/reactive.d.ts.map

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

package/dist/types/agent/router.d.ts

@@ -12,7 +12,7 @@ export interface RoutingDecision {
      * Tokens the routing call itself spent, summed over any retries.
      *
      * Routing runs before the delegate's run exists, so it has no
-     * `RunPersistence` to accumulate into. Reporting it here lets the
+     * `TurnRecorder` to accumulate into. Reporting it here lets the
      * router report its own model usage. The separate budget summary includes
      * both routing and every delegated descendant.
      */