@namzu/sdk 43.0.0 → 44.0.0

package/dist/runtime/query/session-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-storage.js","sourceRoot":"","sources":["../../../src/runtime/query/session-storage.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/steering.d.ts

@@ -7,9 +7,9 @@ export declare function isOperatorUserMessage(message: Message): message is User
  * The gap this closes is narrow and was documented rather than fixed:
  * `AgentManager` has had `queueMessage` / `drainMessages` for a while, and
  * nothing in the iteration loop ever read them — the type says so in as many
- * words. So a host watching a run go the wrong way had two options, and both
+ * words. So a host watching a turn go the wrong way had two options, and both
  * are worse than they sound. Cancel and start over throws away every tool
- * result the run had already paid for. Reject through the review gate only
+ * result the turn had already paid for. Reject through the review gate only
  * works if a tool call happens to be pending approval, and it says "no" when
  * the host wanted to say "yes, but look at this first".
  *
@@ -62,7 +62,7 @@ export declare class SteeringBinding implements SteeringChannel {
  * as something the tool said — so a steer saying "stop and ask me first" would
  * look like output from `bash`.
  *
- * This is NOT the untrusted-content envelope. The host operating the run is
+ * This is NOT the untrusted-content envelope. The host operating the turn is
  * the one party whose words the agent SHOULD act on; framing them as material
  * to be worked with rather than followed would inverting the very thing the
  * host is trying to do. Different party, different frame, on purpose.
@@ -82,6 +82,12 @@ onDelivered?: () => void): readonly Message[];
 /** What the model reads when a background job it started has ended. */
 export declare function formatJobNote(text: string): string;
 export declare function formatSteeringNote(text: string): string;
+/**
+ * The operator guidance the last steering note in a tool result carries, or
+ * `undefined` when the result carries none. The inverse of
+ * {@link formatSteeringNote} applied by {@link attachSteering}.
+ */
+export declare function readSteeringNote(content: string): string | undefined;
 /**
  * Append the guidance to the last tool result in a settled batch.
  *

package/dist/runtime/query/steering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/steering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAExE,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,WAAW,CAQ9E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzB,yDAAyD;IACzD,KAAK,IAAI,MAAM,GAAG,SAAS,CAAA;IAE3B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CACzB;AAED,qBAAa,eAAgB,YAAW,eAAe;IACtD,OAAO,CAAC,MAAM,CAAe;IAE7B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB,KAAK,IAAI,MAAM,GAAG,SAAS;IAO3B,IAAI,OAAO,IAAI,OAAO,CAErB;CACD;AAED;;;;;;;;;;;;GAYG;AACH,+EAA+E;AAC/E,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;AAChC;;;;;;;;GAQG;AACH,WAAW,CAAC,EAAE,MAAM,IAAI,GACtB,SAAS,OAAO,EAAE,CAqBpB;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,EAAE,eAAe,GAAG,SAAS;AACpC,4EAA4E;AAC5E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAClC,SAAS,OAAO,EAAE,CAkCpB"}
+{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/steering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAExE,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,WAAW,CAQ9E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzB,yDAAyD;IACzD,KAAK,IAAI,MAAM,GAAG,SAAS,CAAA;IAE3B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CACzB;AAED,qBAAa,eAAgB,YAAW,eAAe;IACtD,OAAO,CAAC,MAAM,CAAe;IAE7B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB,KAAK,IAAI,MAAM,GAAG,SAAS;IAO3B,IAAI,OAAO,IAAI,OAAO,CAErB;CACD;AAED;;;;;;;;;;;;GAYG;AACH,+EAA+E;AAC/E,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;AAChC;;;;;;;;GAQG;AACH,WAAW,CAAC,EAAE,MAAM,IAAI,GACtB,SAAS,OAAO,EAAE,CAqBpB;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAKD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,EAAE,eAAe,GAAG,SAAS;AACpC,4EAA4E;AAC5E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAClC,SAAS,OAAO,EAAE,CAkCpB"}

package/dist/runtime/query/steering.js

@@ -34,7 +34,7 @@ export class SteeringBinding {
  * as something the tool said — so a steer saying "stop and ask me first" would
  * look like output from `bash`.
  *
- * This is NOT the untrusted-content envelope. The host operating the run is
+ * This is NOT the untrusted-content envelope. The host operating the turn is
  * the one party whose words the agent SHOULD act on; framing them as material
  * to be worked with rather than followed would inverting the very thing the
  * host is trying to do. Different party, different frame, on purpose.
@@ -79,8 +79,18 @@ onDelivered) {
 export function formatJobNote(text) {
     return `\n\n[Background job update]\n${text}`;
 }
+const STEERING_NOTE_HEADER = '\n\n[Message from the operator, received while this tool was running]\n';
 export function formatSteeringNote(text) {
-    return `\n\n[Message from the operator, received while this tool was running]\n${text}`;
+    return `${STEERING_NOTE_HEADER}${text}`;
+}
+/**
+ * The operator guidance the last steering note in a tool result carries, or
+ * `undefined` when the result carries none. The inverse of
+ * {@link formatSteeringNote} applied by {@link attachSteering}.
+ */
+export function readSteeringNote(content) {
+    const at = content.lastIndexOf(STEERING_NOTE_HEADER);
+    return at < 0 ? undefined : content.slice(at + STEERING_NOTE_HEADER.length);
 }
 /**
  * Append the guidance to the last tool result in a settled batch.

package/dist/runtime/query/steering.js.map

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

package/dist/runtime/query/token-budget.d.ts

@@ -1,7 +1,21 @@
-import type { TokenBudget } from '../../run/token-budget.js';
-import type { RunId } from '../../types/ids/index.js';
-import type { RunState } from '../../types/run/state.js';
+import { type SessionTokenBudget, type SessionTokenBudgetStore } from '../../store/budget/index.js';
+import type { TurnId } from '../../types/ids/index.js';
+import type { TurnBudgetBinding } from '../../types/session/turn.js';
 import type { QueryParams } from './index.js';
-/** Resolve one authority before any model request or recovered tool dispatch. */
-export declare function resolveQueryBudget(params: QueryParams, runId: RunId, selected?: RunState): Promise<TokenBudget>;
+/** The ledger reference a checkpoint (or a selected resume state) carries. */
+export interface SavedBudgetReference {
+    readonly binding?: TurnBudgetBinding;
+    readonly accountId?: string;
+}
+/**
+ * Resolve one ledger authority before any model request or recovered tool
+ * dispatch.
+ *
+ * The ledger is keyed by `(rootSessionId, rootTurnId)`: a root turn opens its
+ * own ledger with its own limit; a child session's turns bind to the key of
+ * the root turn that spawned them (they are handed that account); a resumed
+ * paused turn reuses its key. A limit that changes between two turns of one
+ * session is therefore two ledgers, never a mismatch.
+ */
+export declare function resolveQueryBudget(params: QueryParams, turnId: TurnId, store: SessionTokenBudgetStore, saved?: SavedBudgetReference): Promise<SessionTokenBudget>;
 //# sourceMappingURL=token-budget.d.ts.map

package/dist/runtime/query/token-budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/token-budget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAK5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,iFAAiF;AACjF,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,QAAQ,GACjB,OAAO,CAAC,WAAW,CAAC,CA0GtB"}
+{"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/token-budget.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAE5B,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,EAC9B,KAAK,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CA8C7B"}

package/dist/runtime/query/token-budget.js

@@ -1,29 +1,16 @@
-import { join } from 'node:path';
-import { DefaultPathBuilder } from '../../session/workspace/path-builder.js';
-import { DiskCheckpointStore } from '../../store/run/checkpoint-disk.js';
-import { openTokenBudget } from '../../store/run/token-budget-disk.js';
-import { validateTokenBudgetBinding } from '../../types/run/token-budget-store.js';
-/** Resolve one authority before any model request or recovered tool dispatch. */
-export async function resolveQueryBudget(params, runId, selected) {
-    let saved = selected;
-    if (params.resumeFromCheckpoint && !saved) {
-        const paths = params.pathBuilder ??
-            new DefaultPathBuilder(join(params.workingDirectory ?? process.cwd(), '.namzu'));
-        const scope = {
-            tenantId: params.tenantId,
-            projectId: params.projectId,
-            sessionId: params.sessionId,
-            runId,
-            parentRunId: params.parentRunId,
-        };
-        const store = params.checkpointStore ??
-            new DiskCheckpointStore({
-                baseDir: join(paths.sessionDir(params.projectId, params.sessionId), 'runs'),
-            }, scope);
-        saved = (await store.readCheckpoint(scope, params.resumeFromCheckpoint)) ?? undefined;
-        if (!saved)
-            throw new Error('Cannot restore a token budget from a missing checkpoint.');
-    }
+import { openSessionTokenBudget, } from '../../store/budget/index.js';
+import { asSessionId, asTurnId } from '../../utils/id.js';
+/**
+ * Resolve one ledger authority before any model request or recovered tool
+ * dispatch.
+ *
+ * The ledger is keyed by `(rootSessionId, rootTurnId)`: a root turn opens its
+ * own ledger with its own limit; a child session's turns bind to the key of
+ * the root turn that spawned them (they are handed that account); a resumed
+ * paused turn reuses its key. A limit that changes between two turns of one
+ * session is therefore two ledgers, never a mismatch.
+ */
+export async function resolveQueryBudget(params, turnId, store, saved) {
     const schedulerBudget = params.taskScheduler?.budget;
     if (params.taskScheduler && !schedulerBudget) {
         throw new Error('A task scheduler must expose its shared token budget account.');
@@ -32,69 +19,51 @@ export async function resolveQueryBudget(params, runId, selected) {
         throw new Error('Query and task scheduler must share the same token budget account.');
     }
     const provided = params.budget ?? schedulerBudget;
-    const binding = saved?.budgetBinding === undefined ? undefined : validateTokenBudgetBinding(saved.budgetBinding);
-    if (binding &&
-        saved?.budgetAccountId !== undefined &&
-        saved.budgetAccountId !== binding.accountId) {
+    const binding = saved?.binding === undefined ? undefined : validateBinding(saved.binding);
+    if (binding && saved?.accountId !== undefined && saved.accountId !== binding.accountId) {
         throw new Error('Checkpoint token budget account references disagree.');
     }
-    if (binding &&
-        (binding.scope.tenantId !== params.tenantId || binding.scope.projectId !== params.projectId)) {
-        throw new Error('Checkpoint token budget belongs to a different tenant or project.');
-    }
-    if (binding && binding.scope.runId === runId && binding.scope.sessionId !== params.sessionId) {
-        throw new Error('Checkpoint token budget belongs to a different root session.');
-    }
     if (provided) {
-        const providedBinding = provided.binding;
-        if (providedBinding &&
-            (providedBinding.scope.tenantId !== params.tenantId ||
-                providedBinding.scope.projectId !== params.projectId ||
-                (providedBinding.scope.runId === runId &&
-                    providedBinding.scope.sessionId !== params.sessionId))) {
-            throw new Error('Supplied token budget belongs to a different root scope.');
-        }
-        if (saved?.budgetAccountId && saved.budgetAccountId !== provided.accountId) {
+        if (saved?.accountId && saved.accountId !== provided.accountId) {
             throw new Error('Resume requires the original token budget account.');
         }
         if (binding &&
-            (binding.accountId !== provided.accountId || binding.scope.runId !== provided.rootRunId)) {
+            (binding.accountId !== provided.accountId ||
+                binding.rootSessionId !== provided.scope.rootSessionId ||
+                binding.rootTurnId !== provided.scope.rootTurnId)) {
             throw new Error('Checkpoint and supplied token budget authority disagree.');
         }
-        if (binding &&
-            (!providedBinding ||
-                binding.scope.tenantId !== providedBinding.scope.tenantId ||
-                binding.scope.projectId !== providedBinding.scope.projectId ||
-                binding.scope.sessionId !== providedBinding.scope.sessionId ||
-                binding.scope.runId !== providedBinding.scope.runId)) {
-            throw new Error('Checkpoint and supplied token budget root scopes disagree.');
-        }
-        provided.bindRun(runId);
-        narrowToRunLimit(provided, params.runConfig.tokenBudget);
+        provided.bindTurn(params.sessionId, turnId);
+        narrowToTurnLimit(provided, params.turnConfig.tokenBudget);
         return provided;
     }
-    if (saved?.budgetAccountId && !binding) {
+    if (saved?.accountId && !binding) {
         throw new Error('This checkpoint used an in-memory token budget. Supply its current authoritative budget to resume.');
     }
-    const budget = await openTokenBudget({
-        store: params.tokenBudgetStore,
-        pathBuilder: params.pathBuilder,
-        workingDirectory: params.workingDirectory,
-        scope: binding?.scope ?? {
-            tenantId: params.tenantId,
-            projectId: params.projectId,
-            sessionId: params.sessionId,
-            runId,
-        },
-        limit: binding && binding.scope.runId !== runId ? undefined : params.runConfig.tokenBudget,
-        accountId: binding?.accountId,
-        requireExisting: binding !== undefined,
+    const ownRoot = binding === undefined || binding.rootTurnId === turnId;
+    const budget = await openSessionTokenBudget({
+        store,
+        scope: binding
+            ? { rootSessionId: binding.rootSessionId, rootTurnId: binding.rootTurnId }
+            : { rootSessionId: params.sessionId, rootTurnId: turnId },
+        ...(ownRoot ? { limit: params.turnConfig.tokenBudget } : {}),
+        ...(binding ? { accountId: binding.accountId, requireExisting: true } : {}),
     });
-    budget.bindRun(runId);
-    narrowToRunLimit(budget, params.runConfig.tokenBudget);
+    budget.bindTurn(params.sessionId, turnId);
+    narrowToTurnLimit(budget, params.turnConfig.tokenBudget);
     return budget;
 }
-function narrowToRunLimit(budget, limit) {
+function validateBinding(binding) {
+    if (typeof binding.accountId !== 'string' || binding.accountId.length === 0) {
+        throw new Error('Checkpoint token budget binding has no account.');
+    }
+    return {
+        rootSessionId: asSessionId(binding.rootSessionId),
+        rootTurnId: asTurnId(binding.rootTurnId),
+        accountId: binding.accountId,
+    };
+}
+function narrowToTurnLimit(budget, limit) {
     if (limit > 0 && (budget.limit === 0 || limit < budget.limit))
         budget.narrow(limit);
 }

package/dist/runtime/query/token-budget.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../../../src/runtime/query/token-budget.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../../../src/runtime/query/token-budget.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/tool-call-budget.d.ts

@@ -1,17 +1,18 @@
-import type { RunId } from '../../types/ids/index.js';
-import type { RunEvent } from '../../types/run/index.js';
+import type { TurnId } from '../../types/ids/index.js';
+import type { SessionRecord } from '../../types/session/records.js';
+import type { SessionEventDraft } from './events.js';
 export declare function assertMaxToolCalls(limit: number | undefined): void;
-/** A run-owned admission ledger; durability belongs to the run's event store. */
+/** A turn-owned admission ledger; durability belongs to the session log. */
 export declare class ToolCallBudget {
     private readonly limit;
-    private readonly runId;
+    private readonly turnId;
     private readonly emit;
     private readonly read?;
     private used;
     private initialized?;
     private chain;
     private failed;
-    constructor(limit: number, runId: RunId, emit: (event: RunEvent) => Promise<void>, read?: (() => Promise<readonly RunEvent[]>) | undefined);
+    constructor(limit: number, turnId: TurnId, emit: (event: SessionEventDraft) => Promise<void>, read?: (() => Promise<readonly SessionRecord[]>) | undefined);
     private initialize;
     /** Reserve before work, never refund. A refused group consumes no new slots. */
     admit(count: number, kind: 'batch' | 'nested' | 'retry', signal: AbortSignal): Promise<string | undefined>;

package/dist/runtime/query/tool-call-budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call-budget.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/tool-call-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAExD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIlE;AAED,iFAAiF;AACjF,qBAAa,cAAc;IAOzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IATvB,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,MAAM,CAAS;gBAGL,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,EACxC,IAAI,CAAC,GAAE,MAAM,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,aAAA;YAK7C,UAAU;IA4CxB,gFAAgF;IAC1E,KAAK,CACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,EAClC,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAwC9B"}
+{"version":3,"file":"tool-call-budget.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/tool-call-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIlE;AAED,4EAA4E;AAC5E,qBAAa,cAAc;IAOzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IATvB,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,MAAM,CAAS;gBAGL,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,EACjD,IAAI,CAAC,GAAE,MAAM,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,aAAA;YAKlD,UAAU;IA2CxB,gFAAgF;IAC1E,KAAK,CACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,EAClC,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAwC9B"}

package/dist/runtime/query/tool-call-budget.js

@@ -3,33 +3,31 @@ export function assertMaxToolCalls(limit) {
         throw new RangeError('maxToolCalls must be a nonnegative safe integer.');
     }
 }
-/** A run-owned admission ledger; durability belongs to the run's event store. */
+/** A turn-owned admission ledger; durability belongs to the session log. */
 export class ToolCallBudget {
     limit;
-    runId;
+    turnId;
     emit;
     read;
     used = 0;
     initialized;
     chain = Promise.resolve();
     failed;
-    constructor(limit, runId, emit, read) {
+    constructor(limit, turnId, emit, read) {
         this.limit = limit;
-        this.runId = runId;
+        this.turnId = turnId;
         this.emit = emit;
         this.read = read;
         assertMaxToolCalls(limit);
     }
     async initialize() {
-        const events = (await this.read?.()) ?? [];
+        // The session log is read strictly (every record chained to the one
+        // before it), so it is complete; this turn's records are the ledger.
+        const events = ((await this.read?.()) ?? []).filter((record) => record.turnId === this.turnId);
         if (events.length > 100_000)
-            throw new Error('Tool-call budget recovery exceeds 100000 events.');
+            throw new Error('Tool-call budget recovery exceeds 100000 records.');
         let initialized = false;
-        let expectedSeq = 0;
         for (const event of events) {
-            // A replayed transcript must be complete and belong to this run.
-            if (event.runId !== this.runId || event.seq !== ++expectedSeq)
-                throw new Error('Tool-call budget recovery requires a complete run event log.');
             if (event.type === 'tool_calls_admitted') {
                 if (!Number.isSafeInteger(event.count) ||
                     event.count < 0 ||
@@ -53,7 +51,7 @@ export class ToolCallBudget {
         if (!initialized) {
             await this.emit({
                 type: 'tool_calls_admitted',
-                runId: this.runId,
+                turnId: this.turnId,
                 kind: 'initialize',
                 count: 0,
                 used: 0,
@@ -86,7 +84,7 @@ export class ToolCallBudget {
             try {
                 await this.emit({
                     type: 'tool_calls_admitted',
-                    runId: this.runId,
+                    turnId: this.turnId,
                     kind,
                     count,
                     used,

package/dist/runtime/query/tool-call-budget.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call-budget.js","sourceRoot":"","sources":["../../../src/runtime/query/tool-call-budget.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-call-budget.js","sourceRoot":"","sources":["../../../src/runtime/query/tool-call-budget.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/tool-executions.d.ts

@@ -0,0 +1,26 @@
+import type { SessionLog } from '../../store/session-log/index.js';
+import type { TurnId } from '../../types/ids/index.js';
+import type { SessionRecord } from '../../types/session/records.js';
+import type { ToolExecutionSnapshot } from '../../types/session/tool-execution.js';
+/**
+ * Collects the latest execution boundary of selected tool calls from one
+ * turn's records: metadata only, never retained output bodies beyond the
+ * completion's own result.
+ */
+export declare class ToolExecutionCollector {
+    private readonly turnId;
+    private started;
+    private readonly wanted;
+    private readonly records;
+    constructor(turnId: TurnId, ids: readonly string[]);
+    accept(record: SessionRecord): void;
+    /** Complete only when the turn's beginning was seen and the whole log verified. */
+    finish(complete?: boolean): ToolExecutionSnapshot;
+}
+/**
+ * Read the latest recorded execution boundary of selected tool calls of one
+ * turn. The log is read strictly, so absence of a start is proof only when
+ * the snapshot is `complete`.
+ */
+export declare function readToolExecutions(log: SessionLog, turnId: TurnId, ids: readonly string[], signal?: AbortSignal): Promise<ToolExecutionSnapshot>;
+//# sourceMappingURL=tool-executions.d.ts.map

package/dist/runtime/query/tool-executions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executions.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/tool-executions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAEX,qBAAqB,EACrB,MAAM,uCAAuC,CAAA;AAE9C;;;;GAIG;AACH,qBAAa,sBAAsB;IAMjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;gBAG/C,MAAM,EAAE,MAAM,EAC/B,GAAG,EAAE,SAAS,MAAM,EAAE;IAMvB,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAwBnC,mFAAmF;IACnF,MAAM,CAAC,QAAQ,UAAO,GAAG,qBAAqB;CAG9C;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAUhC"}

package/dist/runtime/query/tool-executions.js

@@ -0,0 +1,66 @@
+/**
+ * Collects the latest execution boundary of selected tool calls from one
+ * turn's records: metadata only, never retained output bodies beyond the
+ * completion's own result.
+ */
+export class ToolExecutionCollector {
+    turnId;
+    started = false;
+    wanted;
+    records = new Map();
+    constructor(turnId, ids) {
+        this.turnId = turnId;
+        if (ids.length > 4096)
+            throw new Error('Tool recovery exceeds the 4096-call scan limit.');
+        this.wanted = new Set(ids);
+    }
+    accept(record) {
+        if (record.turnId !== this.turnId)
+            return;
+        if (record.type === 'turn_started')
+            this.started = true;
+        if (record.type !== 'tool_executing' && record.type !== 'tool_completed')
+            return;
+        const event = record;
+        if (typeof event.toolUseId !== 'string' || typeof event.toolName !== 'string')
+            throw new Error('Tool recovery found an invalid tool identity.');
+        if (!this.wanted.has(event.toolUseId))
+            return;
+        const identity = { toolUseId: event.toolUseId, toolName: event.toolName };
+        if (record.type === 'tool_executing') {
+            // A later start invalidates an earlier completion, including retries.
+            this.records.set(event.toolUseId, { ...identity, status: 'started' });
+            return;
+        }
+        if (typeof event.result !== 'string' || typeof event.isError !== 'boolean')
+            throw new Error('Tool recovery found an invalid completion.');
+        this.records.set(event.toolUseId, {
+            ...identity,
+            status: 'completed',
+            result: event.result,
+            isError: event.isError,
+        });
+    }
+    /** Complete only when the turn's beginning was seen and the whole log verified. */
+    finish(complete = true) {
+        return { complete: complete && this.started, records: this.records };
+    }
+}
+/**
+ * Read the latest recorded execution boundary of selected tool calls of one
+ * turn. The log is read strictly, so absence of a start is proof only when
+ * the snapshot is `complete`.
+ */
+export async function readToolExecutions(log, turnId, ids, signal) {
+    signal?.throwIfAborted();
+    const collector = new ToolExecutionCollector(turnId, ids);
+    const walk = log.read({ mode: 'strict' });
+    for (;;) {
+        signal?.throwIfAborted();
+        const step = await walk.next();
+        if (step.done)
+            return collector.finish(step.value.intact && step.value.tornBytes === 0);
+        collector.accept(step.value.record);
+    }
+}
+//# sourceMappingURL=tool-executions.js.map

package/dist/runtime/query/tool-executions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executions.js","sourceRoot":"","sources":["../../../src/runtime/query/tool-executions.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/tool-grants.d.ts

@@ -24,10 +24,10 @@ export interface ToolGrantKeys {
  */
 export declare function toolGrantKeys(call: Pick<ToolCallSummary, 'name' | 'input'>): ToolGrantKeys;
 /**
- * Grants recorded during one run.
+ * Grants recorded during one turn.
  *
- * Run-scoped, not persisted: an approval is a statement about this run's
- * work, and carrying it into a later run would be reuse nobody agreed to.
+ * Turn-scoped, not persisted: an approval is a statement about this turn's
+ * work, and carrying it into a later turn would be reuse nobody agreed to.
  * The durable half is the checkpointed decision, which is evidence of what
  * was approved, not a standing permission.
  */

package/dist/runtime/query/tool-grants.js

@@ -14,10 +14,10 @@ export function toolGrantKeys(call) {
     };
 }
 /**
- * Grants recorded during one run.
+ * Grants recorded during one turn.
  *
- * Run-scoped, not persisted: an approval is a statement about this run's
- * work, and carrying it into a later run would be reuse nobody agreed to.
+ * Turn-scoped, not persisted: an approval is a statement about this turn's
+ * work, and carrying it into a later turn would be reuse nobody agreed to.
  * The durable half is the checkpointed decision, which is evidence of what
  * was approved, not a standing permission.
  */

package/dist/runtime/query/tool-output-budget.d.ts

@@ -8,7 +8,7 @@
  * Nothing capped tool output before this. `read` returned a whole file when
  * `limit` was omitted, `bash` allowed a 100 MB buffer, and the MCP adapter
  * joined every text block uncapped — so a 2 MB lockfile became ~500k tokens
- * in a single `tool_result` and the run died on a provider error with
+ * in a single `tool_result` and the turn died on a provider error with
  * everything lost.
  */
 export declare const DEFAULT_MAX_TOOL_OUTPUT_CHARS = 40000;
@@ -79,7 +79,7 @@ export interface ApplyToolOutputBudgetOptions {
  * Retention keeps the original while bounding its model-visible preview.
  * The host owns the recovery route and its permissions; a spill path is not
  * proof that workspace read/grep tools can access it. Middle-elision is the
- * fallback for a run with no directory to write to.
+ * fallback for a turn with no directory to write to.
  *
  * The preview keeps head AND tail because the two ends carry different
  * information: the head has the schema/opening of a document, the tail has