@namzu/sdk 32.0.0 → 33.0.0

package/dist/run/workspace-fingerprint.js

@@ -41,10 +41,10 @@
  * told to edit something it had already edited.
  *
  * So: a non-zero exit from any git invocation, a repository with no commits,
- * a timeout, or output past the size cap all produce `null` rather than a
- * partial hash. A truncated diff that hashed successfully would be the worst
- * outcome available here, because two different workspaces truncated at the
- * same point collide.
+ * a timeout, an executor-reported truncated stream, or output past the size
+ * cap all produce `null` rather than a partial hash. A truncated diff that
+ * hashed successfully would be the worst outcome available here, because two
+ * different workspaces truncated at the same point collide.
  */
 import { createHash } from 'node:crypto';
 import { lstat, readFile, readlink } from 'node:fs/promises';
@@ -108,6 +108,8 @@ export async function fingerprintWorkspace(options) {
         // this function: it has no basis for a comparison.
         if (result.exitCode !== 0)
             return null;
+        if (result.stdoutTruncated === true || result.stderrTruncated === true)
+            return null;
         if (Buffer.byteLength(result.stdout, 'utf8') > maxBytes)
             return null;
         return result.stdout;

package/dist/run/workspace-fingerprint.js.map

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

package/dist/runtime/bidi/index.d.ts

@@ -1,5 +1,5 @@
 export { createMockBidiProvider } from './mock.js';
 export type { MockBidiScript, MockBidiSession } from './mock.js';
-export { startBidiRun } from './session.js';
+export { BidiSessionCloseTimeoutError, startBidiRun } from './session.js';
 export type { BidiRun, BidiRunParams } from './session.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/bidi/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/bidi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/bidi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,4BAA4B,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACzE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/runtime/bidi/index.js

@@ -1,3 +1,3 @@
 export { createMockBidiProvider } from './mock.js';
-export { startBidiRun } from './session.js';
+export { BidiSessionCloseTimeoutError, startBidiRun } from './session.js';
 //# sourceMappingURL=index.js.map

package/dist/runtime/bidi/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/bidi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/bidi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAElD,OAAO,EAAE,4BAA4B,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA"}

package/dist/runtime/bidi/session.d.ts

@@ -2,6 +2,10 @@ import type { BidiConnectParams, BidiProvider, BidiRunEvent, BidiSession } from
 import type { RunId } from '../../types/ids/index.js';
 import type { ToolRegistryContract } from '../../types/tool/index.js';
 import { type Logger } from '../../utils/logger.js';
+export declare class BidiSessionCloseTimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
 /**
  * Run tools for a duplex session.
  *
@@ -27,7 +31,17 @@ export interface BidiRunParams {
     readonly connect: BidiConnectParams;
     readonly workingDirectory: string;
     readonly env?: Record<string, string>;
+    /**
+     * Owns the complete run lifetime, not only connection establishment.
+     * Aborting it closes the provider session, ends local events and revokes
+     * every tool context without mutating the caller-owned controller.
+     */
     readonly signal?: AbortSignal;
+    /**
+     * How long `close()` waits for provider cleanup after fencing locally.
+     * Defaults to five seconds. `0` preserves an unbounded provider-close wait.
+     */
+    readonly closeTimeoutMs?: number;
     readonly log?: Logger;
     /** Overrides the generated id, so a host can correlate its own. */
     readonly runId?: RunId;
@@ -38,6 +52,11 @@ export interface BidiRun {
     events(): AsyncIterable<BidiRunEvent>;
     /** Push input from the human. */
     send(input: Parameters<BidiSession['send']>[0]): Promise<void>;
+    /**
+     * Fence the local run immediately, abort tool contexts and close the
+     * provider once. It does not wait for tool code that ignores cancellation;
+     * provider cleanup is observed for `BidiRunParams.closeTimeoutMs`.
+     */
     close(): Promise<void>;
 }
 export declare function startBidiRun(params: BidiRunParams): Promise<BidiRun>;

package/dist/runtime/bidi/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/runtime/bidi/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAIlF,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,uBAAuB,CAAA;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACtB;AAED,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,qEAAqE;IACrE,MAAM,IAAI,aAAa,CAAC,YAAY,CAAC,CAAA;IACrC,iCAAiC;IACjC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA0J1E"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/runtime/bidi/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAIlF,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,uBAAuB,CAAA;AAKlE,qBAAa,4BAA6B,SAAQ,KAAK;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAMtC;AAgBD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACtB;AAED,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,qEAAqE;IACrE,MAAM,IAAI,aAAa,CAAC,YAAY,CAAC,CAAA;IACrC,iCAAiC;IACjC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAsQ1E"}

package/dist/runtime/bidi/session.js

@@ -3,30 +3,136 @@ import { toErrorMessage } from '../../utils/error.js';
 import { generateRunId } from '../../utils/id.js';
 import { SCOPE_ATTRIBUTE } from '../../utils/log/types.js';
 import { resolveLogger } from '../../utils/logger.js';
+const DEFAULT_CLOSE_TIMEOUT_MS = 5_000;
+const MAX_TIMER_DELAY_MS = 2_147_483_647;
+export class BidiSessionCloseTimeoutError extends Error {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Duplex provider session close did not settle within ${timeoutMs}ms. The local run is fenced and its tool authority was revoked, but provider cleanup is still unconfirmed.`);
+        this.timeoutMs = timeoutMs;
+        this.name = 'BidiSessionCloseTimeoutError';
+    }
+}
+async function waitForProviderClose(pending, timeoutMs) {
+    if (timeoutMs === 0)
+        return await pending;
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new BidiSessionCloseTimeoutError(timeoutMs)), timeoutMs);
+        timer.unref?.();
+    });
+    try {
+        await Promise.race([pending, timeout]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
 export async function startBidiRun(params) {
+    params.signal?.throwIfAborted();
+    const closeTimeoutMs = params.closeTimeoutMs ?? DEFAULT_CLOSE_TIMEOUT_MS;
+    if (!Number.isInteger(closeTimeoutMs) ||
+        closeTimeoutMs < 0 ||
+        closeTimeoutMs > MAX_TIMER_DELAY_MS) {
+        throw new RangeError(`BidiRunParams.closeTimeoutMs must be an integer from 0 through ${MAX_TIMER_DELAY_MS}`);
+    }
     const runId = params.runId ?? generateRunId();
     const log = resolveLogger(params.log).child({
         [SCOPE_ATTRIBUTE]: 'runtime/bidi/session',
         [NAMZU.RUN_ID]: runId,
     });
-    const session = await params.provider.connect({
+    const lifetime = new AbortController();
+    const queue = [];
+    let wake;
+    let closed = false;
+    let session;
+    let transportCloseRequested = false;
+    let transportClosePromise;
+    const requestTransportClose = () => {
+        transportCloseRequested = true;
+        if (!session)
+            return Promise.resolve();
+        if (!transportClosePromise) {
+            const ownedSession = session;
+            transportClosePromise = Promise.resolve().then(async () => await ownedSession.close());
+        }
+        return transportClosePromise;
+    };
+    const beginClose = (reason, closeTransport) => {
+        if (!closed) {
+            closed = true;
+            lifetime.abort(reason);
+            wake?.();
+        }
+        if (closeTransport) {
+            void requestTransportClose().catch((error) => {
+                log.warn('Duplex provider session close failed', {
+                    'exception.message': toErrorMessage(error),
+                });
+            });
+        }
+    };
+    const onCallerAbort = () => beginClose(params.signal?.reason, true);
+    params.signal?.addEventListener('abort', onCallerAbort, { once: true });
+    lifetime.signal.addEventListener('abort', () => params.signal?.removeEventListener('abort', onCallerAbort), { once: true });
+    const connecting = Promise.resolve()
+        .then(async () => await params.provider.connect({
         ...params.connect,
-        ...(params.signal ? { signal: params.signal } : {}),
+        signal: lifetime.signal,
+    }))
+        .then((connected) => {
+        session = connected;
+        if (transportCloseRequested) {
+            void requestTransportClose().catch((error) => {
+                log.warn('Late duplex provider session close failed', {
+                    'exception.message': toErrorMessage(error),
+                });
+            });
+        }
+        return connected;
     });
+    let removeConnectAbort;
+    const connectionAbort = new Promise((_, reject) => {
+        const rejectFromLifetime = () => reject(lifetime.signal.reason);
+        removeConnectAbort = () => lifetime.signal.removeEventListener('abort', rejectFromLifetime);
+        if (lifetime.signal.aborted)
+            rejectFromLifetime();
+        else
+            lifetime.signal.addEventListener('abort', rejectFromLifetime, { once: true });
+    });
+    let activeSession;
+    try {
+        activeSession = await Promise.race([connecting, connectionAbort]);
+        lifetime.signal.throwIfAborted();
+    }
+    catch (error) {
+        removeConnectAbort?.();
+        params.signal?.removeEventListener('abort', onCallerAbort);
+        if (lifetime.signal.aborted) {
+            void connecting.catch(() => undefined);
+            throw lifetime.signal.reason;
+        }
+        throw error;
+    }
+    removeConnectAbort?.();
     // One generation of work. Bumped by every interruption, so a tool that
     // started under an older generation knows its answer is stale without
     // needing a handle on the call that cancelled it.
     let generation = 0;
-    const inflight = new Set();
-    const queue = [];
-    let wake;
+    const executionIds = new Set();
     const emit = (event) => {
+        if (closed)
+            return false;
         queue.push(event);
         wake?.();
+        return true;
     };
     const executeCall = async (call) => {
         const startedUnder = generation;
-        emit({ type: 'tool_started', runId, toolUseId: call.id, toolName: call.name });
+        if (!emit({ type: 'tool_started', runId, toolUseId: call.id, toolName: call.name })) {
+            return;
+        }
         let output;
         let isError = false;
         try {
@@ -40,7 +146,7 @@ export async function startBidiRun(params) {
             const context = {
                 runId,
                 workingDirectory: params.workingDirectory,
-                abortSignal: params.signal ?? new AbortController().signal,
+                abortSignal: lifetime.signal,
                 env: params.env ?? {},
                 log: (level, message) => log[level](message),
                 toolUseId: call.id,
@@ -53,12 +159,21 @@ export async function startBidiRun(params) {
             output = toErrorMessage(err);
             isError = true;
         }
+        if (closed)
+            return;
         if (startedUnder !== generation) {
             // The human spoke over the model while this ran. Delivering the
             // answer now would put it in a conversation that has moved on.
             emit({ type: 'tool_abandoned', runId, toolUseId: call.id, toolName: call.name });
             return;
         }
+        // Entering the provider send is the publication commit point. A later
+        // conversational interruption cannot recall a write already handed to
+        // the provider, but closing the run still closes the whole session and
+        // fences the local terminal event.
+        await activeSession.sendToolResult(call.id, output, isError);
+        if (closed)
+            return;
         emit({
             type: 'tool_completed',
             runId,
@@ -67,12 +182,12 @@ export async function startBidiRun(params) {
             output,
             isError,
         });
-        await session.sendToolResult(call.id, output, isError);
     };
-    let closed = false;
     const pump = (async () => {
         try {
-            for await (const event of session.events()) {
+            for await (const event of activeSession.events()) {
+                if (closed)
+                    break;
                 switch (event.type) {
                     case 'text':
                         emit({ type: 'text', runId, text: event.text });
@@ -81,13 +196,18 @@ export async function startBidiRun(params) {
                         emit({ type: 'audio', runId, data: event.data, mediaType: event.mediaType });
                         break;
                     case 'tool_call': {
+                        if (executionIds.has(event.id)) {
+                            const error = new Error(`Duplex provider repeated tool-call id "${event.id}". Re-executing it could repeat a side effect, so the session was closed.`);
+                            emit({ type: 'error', runId, message: error.message });
+                            beginClose(error, true);
+                            break;
+                        }
+                        executionIds.add(event.id);
                         // Started, not awaited: awaiting here would stall the very
                         // stream an interruption arrives on.
-                        const running = executeCall(event).catch((err) => {
+                        void executeCall(event).catch((err) => {
                             emit({ type: 'error', runId, message: toErrorMessage(err) });
                         });
-                        inflight.add(running);
-                        void running.finally(() => inflight.delete(running));
                         break;
                     }
                     case 'turn_complete':
@@ -106,7 +226,7 @@ export async function startBidiRun(params) {
                             runId,
                             ...(event.reason !== undefined ? { reason: event.reason } : {}),
                         });
-                        closed = true;
+                        beginClose(new Error(event.reason ?? 'the duplex provider session closed'), false);
                         break;
                     default: {
                         const _exhaustive = event;
@@ -118,14 +238,17 @@ export async function startBidiRun(params) {
             }
         }
         catch (err) {
-            emit({ type: 'error', runId, message: toErrorMessage(err) });
+            if (!closed) {
+                emit({ type: 'error', runId, message: toErrorMessage(err) });
+                beginClose(err, true);
+            }
         }
         finally {
-            closed = true;
-            // Let a consumer parked on the queue notice the end.
-            wake?.();
+            if (!closed)
+                beginClose(new Error('the duplex provider event stream ended'), true);
         }
     })();
+    void pump.catch(() => undefined);
     async function* events() {
         while (true) {
             while (queue.length > 0) {
@@ -144,15 +267,16 @@ export async function startBidiRun(params) {
     return {
         runId,
         events,
-        send: (input) => session.send(input),
+        send: async (input) => {
+            lifetime.signal.throwIfAborted();
+            // As with tool results, entering the provider send is the atomic
+            // publication boundary. A caller must not retry merely because the
+            // lifetime changed after the provider accepted the input.
+            await activeSession.send(input);
+        },
         close: async () => {
-            await session.close();
-            closed = true;
-            wake?.();
-            // Tools still running are awaited, so a close cannot leave one
-            // writing into a session nobody is reading.
-            await Promise.allSettled([...inflight]);
-            await pump.catch(() => undefined);
+            beginClose(new Error('the duplex run was closed by its host'), true);
+            await waitForProviderClose(requestTransportClose(), closeTimeoutMs);
         },
     };
 }

package/dist/runtime/bidi/session.js.map

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

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

@@ -1,4 +1,5 @@
 import type { Span } from '@opentelemetry/api';
+import type { AuthorizationGate } from '../../authorization/gate.js';
 import type { WorkingStateManager } from '../../compaction/manager.js';
 import type { PluginLifecycleManager } from '../../plugin/lifecycle.js';
 import type { ProbeEnforcement } from '../../probe/registry.js';
@@ -8,6 +9,7 @@ import type { InvocationState } from '../../types/invocation/index.js';
 import { type Message, type ToolResultContent } from '../../types/message/index.js';
 import type { PermissionMode } from '../../types/permission/index.js';
 import type { ChatCompletionResponse } from '../../types/provider/index.js';
+import type { AuditEventInput } from '../../types/run/audit.js';
 import type { RunEvent } from '../../types/run/index.js';
 import type { Sandbox } from '../../types/sandbox/index.js';
 import type { RequestToolPause, SkillRegistryRef, ToolContext, ToolRegistryContract } from '../../types/tool/index.js';
@@ -17,6 +19,20 @@ import type { Logger } from '../../utils/logger.js';
 import { type BackgroundJobRegistry } from '../jobs/registry.js';
 import type { ToolResultObservation } from './project-instructions.js';
 export type EmitEvent = (event: RunEvent) => Promise<void>;
+/**
+ * Executor-owned, single-use preparation of one provider tool-call batch.
+ *
+ * Consumers may inspect `reviewCalls`; only the creating executor can consume
+ * the opaque call preparations. This keeps schema transforms, plugin rewrites,
+ * authorization and execution on one value instead of reparsing between them.
+ */
+export interface PreparedToolBatch {
+    readonly reviewCalls: readonly {
+        readonly id: string;
+        readonly name: string;
+        readonly input: unknown;
+    }[];
+}
 /**
  * Default per-tool deadline. Long enough for a real build or test run,
  * short enough that a wedged tool does not hold a turn open indefinitely.
@@ -165,6 +181,17 @@ export interface ToolExecutorConfig {
      * reaches it. See {@link RepairToolCall}.
      */
     repairToolCall?: RepairToolCall;
+    /**
+     * Operator policy applied to calls dispatched by another tool.
+     *
+     * Model-issued calls are reviewed by the iteration orchestrator. Nested
+     * calls cannot open a second durable review while their parent is already
+     * executing, so only an explicit `allow` may proceed; `deny` and `review`
+     * both fail closed before the registry is touched.
+     */
+    authorizationGate?: AuthorizationGate;
+    /** Durable refusal sink paired with {@link authorizationGate}. */
+    recordAudit?: (input: AuditEventInput) => Promise<unknown>;
 }
 /** What one tool call produced, before it becomes a message. */
 export interface ToolCallOutcome {
@@ -221,6 +248,7 @@ export declare class ToolExecutor {
     private workingStateManager?;
     private probes;
     private parentSpan?;
+    private readonly preparedBatches;
     /** Set per turn by the orchestrator; see {@link setStepAllowedTools}. */
     private stepAllowedTools?;
     private readonly readPaths;
@@ -321,7 +349,18 @@ export declare class ToolExecutor {
      */
     private effectiveAllowedTools;
     private resolvePermissionMode;
-    executeBatch(response: ChatCompletionResponse, denials?: ToolCallDenials, prior?: PriorToolResults): Promise<ToolExecutionBatch>;
+    /** Evaluate the run's operator policy against one already-prepared value. */
+    evaluatePreparedAuthorization(toolName: string, input: unknown): import("../../public-types.js").GateEvaluationResult | undefined;
+    /**
+     * Resolve repairs and pre-tool hooks, then decode each call exactly once.
+     * The returned projection is what policy and a human review; execution later
+     * consumes the registry-owned preparations rather than parsing again.
+     */
+    prepareBatchForReview(response: ChatCompletionResponse): Promise<PreparedToolBatch>;
+    /** Re-prepare only calls whose raw input a reviewer actually changed. */
+    reprepareBatchForReview(response: ChatCompletionResponse, previous: PreparedToolBatch, changedCallIds: ReadonlySet<string>): Promise<PreparedToolBatch>;
+    private publishPreparedBatch;
+    executeBatch(response: ChatCompletionResponse, denials?: ToolCallDenials, prior?: PriorToolResults, preparedBatch?: PreparedToolBatch): Promise<ToolExecutionBatch>;
     private runBatch;
     /**
      * Run a tool on behalf of another tool, and put it on the record.
@@ -362,6 +401,8 @@ export declare class ToolExecutor {
      */
     private executeWithDeadline;
     private runPreToolHook;
+    private prepareNestedCall;
+    private prepareDirectCall;
     private interpretPreToolResults;
     /**
      * Turn the call the model issued into a name and a parsed input, giving
@@ -416,6 +457,7 @@ export declare class ToolExecutor {
      */
     private recordDenial;
     private recordSyntheticHookOutcome;
+    private recordSyntheticPreparation;
     /**
      * Bound the rich channel, or leave it alone when no cap is configured.
      *

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

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