@xoxoai/checkmate 0.4.27 → 0.5.0

package/dist/ai/message-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-history.js","sourceRoot":"","sources":["../../src/ai/message-history.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,cAAc;IAC1B,MAAM,CAAU,mBAAmB,GAAG,iCAAiC,CAAA;IACvE,MAAM,CAAU,qBAAqB,GAAG,0CAA0C,CAAA;IAClF,MAAM,CAAU,iCAAiC,GAAG,wBAAwB,CAAA;IAE5E,oBAAoB,CAAC,MAAgC;QACpD,OAAO;YACN;gBACC,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;aACtD;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;aACpD;YACD,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;SACjC,CAAA;IACF,CAAC;IAED,qBAAqB,CAAC,eAA8B;QACnD,OAAO;YACN,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,mBAAmB,MAAM,eAAe,EAAE,EAAE,CAAC;SAC/F,CAAA;IACF,CAAC;IAED,uBAAuB,CAAC,UAAkB,EAAE,WAAmB,WAAW;QACzE,OAAO;YACN,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,qBAAqB,EAAE;gBAC5D,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,QAAQ,QAAQ,WAAW,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;aAClG;SACD,CAAA;IACF,CAAC;IAED,4BAA4B,CAAC,QAAkB;QAC9C,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAC5G,CAAC;IAEO,uBAAuB,CAAC,OAAmC;QAClE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChG,OAAO,KAAK,CAAA;QACb,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QACpC,IAAI,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClE,OAAO,KAAK,CAAA;QACb,CAAC;QAED,OAAO,CACN,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,mBAAmB,GAAG,CAAC;YACnE,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,qBAAqB,CACvD,CAAA;IACF,CAAC"}
+{"version":3,"file":"message-history.js","sourceRoot":"","sources":["../../src/ai/message-history.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,cAAc;IAC1B,MAAM,CAAU,mBAAmB,GAAG,iCAAiC,CAAA;IACvE,MAAM,CAAU,qBAAqB,GAAG,0CAA0C,CAAA;IAClF,MAAM,CAAU,iCAAiC,GAAG,wBAAwB,CAAA;IAE5E,oBAAoB,CAAC,MAAgC;QACpD,OAAO;YACN;gBACC,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;aACtD;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;aACpD;SACD,CAAA;IACF,CAAC;IAED,qBAAqB,CAAC,eAA8B;QACnD,OAAO;YACN,OAAO,EAAE;gBACR,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,mBAAmB,MAAM,eAAe,EAAE,EAAE,CAAC;aAC/F;YACD,SAAS,EAAE,IAAI;SACf,CAAA;IACF,CAAC;IAED,uBAAuB,CAAC,UAAkB,EAAE,WAAmB,WAAW;QACzE,OAAO;YACN,OAAO,EAAE;gBACR,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACR,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,qBAAqB,EAAE;oBAC5D,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,QAAQ,QAAQ,WAAW,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;iBAClG;aACD;YACD,SAAS,EAAE,IAAI;SACf,CAAA;IACF,CAAC;IAED,iCAAiC,CAAC,OAAe;QAChD,OAAO;YACN,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,GAAG,cAAc,CAAC,iCAAiC,MAAM,OAAO,EAAE;SAC3E,CAAA;IACF,CAAC"}

package/dist/ai/rate-limit-policy.d.ts

@@ -1,7 +1,9 @@
-import { RuntimeConfig } from '../config/runtime-config.js';
+import { RuntimeConfig } from '../runtime/config.js';
+import type { RuntimeLogger } from '../logging/types.js';
 export declare class RateLimitPolicy {
     private readonly config;
-    constructor(config?: RuntimeConfig);
-    wait(): Promise<void>;
+    private readonly runtimeLogger;
+    constructor(config: RuntimeConfig, runtimeLogger: RuntimeLogger);
+    wait(signal?: AbortSignal): Promise<void>;
 }
 //# sourceMappingURL=rate-limit-policy.d.ts.map

package/dist/ai/rate-limit-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit-policy.d.ts","sourceRoot":"","sources":["../../src/ai/rate-limit-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAG3D,qBAAa,eAAe;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,gBAAsB;IAEnD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAS3B"}
+{"version":3,"file":"rate-limit-policy.d.ts","sourceRoot":"","sources":["../../src/ai/rate-limit-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,qBAAa,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,aAAa;IAGxC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAS/C"}

package/dist/ai/rate-limit-policy.js

@@ -1,17 +1,34 @@
-import { RuntimeConfig } from '../config/runtime-config.js';
-import { logger } from '../logging/index.js';
 export class RateLimitPolicy {
     config;
-    constructor(config = new RuntimeConfig()) {
+    runtimeLogger;
+    constructor(config, runtimeLogger) {
         this.config = config;
+        this.runtimeLogger = runtimeLogger;
     }
-    async wait() {
-        const delay = this.config.getApiRateLimitDelayMs();
+    async wait(signal) {
+        const delay = this.config.rateLimitDelay;
         if (delay <= 0) {
             return;
         }
-        logger.warn(`waiting: ${Math.floor(delay / 1000)} seconds to avoid rate limit`);
-        await new Promise((resolve) => setTimeout(resolve, delay));
+        this.runtimeLogger.warn(`waiting: ${Math.floor(delay / 1000)} seconds to avoid rate limit`);
+        await abortableDelay(delay, signal);
     }
 }
+function abortableDelay(delay, signal) {
+    if (!signal)
+        return new Promise((resolve) => setTimeout(resolve, delay));
+    if (signal.aborted)
+        return Promise.reject(signal.reason);
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, delay);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
 //# sourceMappingURL=rate-limit-policy.js.map

package/dist/ai/rate-limit-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit-policy.js","sourceRoot":"","sources":["../../src/ai/rate-limit-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE5C,MAAM,OAAO,eAAe;IACE;IAA7B,YAA6B,SAAS,IAAI,aAAa,EAAE;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAE7D,KAAK,CAAC,IAAI;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAA;QAClD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAChB,OAAM;QACP,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,8BAA8B,CAAC,CAAA;QAC/E,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAC3D,CAAC;CACD"}
+{"version":3,"file":"rate-limit-policy.js","sourceRoot":"","sources":["../../src/ai/rate-limit-policy.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,eAAe;IAET;IACA;IAFlB,YACkB,MAAqB,EACrB,aAA4B;QAD5B,WAAM,GAAN,MAAM,CAAe;QACrB,kBAAa,GAAb,aAAa,CAAe;IAC3C,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,MAAoB;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAA;QACxC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAChB,OAAM;QACP,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,8BAA8B,CAAC,CAAA;QAC3F,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;CACD;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,MAAoB;IAC1D,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IACxE,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC7B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,OAAO,EAAE,CAAA;QACV,CAAC,EAAE,KAAK,CAAC,CAAA;QACT,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;AACH,CAAC"}

package/dist/ai/tool-response-handler.d.ts

@@ -1,21 +1,16 @@
-import { Step, ResolveStepResult } from '../runtime/types.js';
-import { ToolResponse } from '../tools/registry.js';
-import { ToolCall } from '../tools/types.js';
-import { AiClient } from './client.js';
+import { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
+import { RuntimeConfig } from '../runtime/config.js';
+import type { RuntimeLogger } from '../logging/types.js';
+import { ToolExecution } from '../tools/types.js';
 import { MessageHistory } from './message-history.js';
-import { ResponseProcessor } from './response-processor.js';
-import { ExtensionHost } from '../runtime/extension.js';
 export declare class ToolResponseHandler {
-    private readonly aiClient;
+    private readonly config;
     private readonly messageHistory;
-    private readonly responseProcessor;
-    private readonly extensionHost;
-    constructor(aiClient: AiClient, messageHistory: MessageHistory, responseProcessor: ResponseProcessor, extensionHost: ExtensionHost);
-    handle(toolCallId: string, toolCall: ToolCall, toolResponse: ToolResponse, step: Step, resolveStepResult: ResolveStepResult): Promise<void>;
-    handleMultiple(toolResponses: Array<{
-        toolCallId: string;
-        toolCall: ToolCall;
-        toolResponse: ToolResponse;
-    }>, step: Step, resolveStepResult: ResolveStepResult): Promise<void>;
+    private readonly runtimeLogger;
+    constructor(config: RuntimeConfig, messageHistory: MessageHistory, runtimeLogger: RuntimeLogger);
+    build(toolResults: ToolExecution[]): ChatCompletionMessageParam[];
+    private logModelBoundToolResponse;
+    private logErrorResponse;
+    private isDebugMode;
 }
 //# sourceMappingURL=tool-response-handler.d.ts.map

package/dist/ai/tool-response-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-response-handler.d.ts","sourceRoot":"","sources":["../../src/ai/tool-response-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAEvD,qBAAa,mBAAmB;IAE9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAHb,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,cAAc,EAC9B,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,aAAa;IAGxC,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,IAAI,EACV,iBAAiB,EAAE,iBAAiB,GAClC,OAAO,CAAC,IAAI,CAAC;IAIV,cAAc,CACnB,aAAa,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAC;QAAC,YAAY,EAAE,YAAY,CAAA;KAAE,CAAC,EAC5F,IAAI,EAAE,IAAI,EACV,iBAAiB,EAAE,iBAAiB,GAClC,OAAO,CAAC,IAAI,CAAC;CA0BhB"}
+{"version":3,"file":"tool-response-handler.d.ts","sourceRoot":"","sources":["../../src/ai/tool-response-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,EAAY,aAAa,EAAgB,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,qBAAa,mBAAmB;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,aAAa;IAG9C,KAAK,CAAC,WAAW,EAAE,aAAa,EAAE,GAAG,0BAA0B,EAAE;IAuBjE,OAAO,CAAC,yBAAyB;IAkBjC,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,WAAW;CAGnB"}

package/dist/ai/tool-response-handler.js

@@ -1,41 +1,63 @@
+import { scrub } from '../redaction/scrub.js';
 export class ToolResponseHandler {
-    aiClient;
+    config;
     messageHistory;
-    responseProcessor;
-    extensionHost;
-    constructor(aiClient, messageHistory, responseProcessor, extensionHost) {
-        this.aiClient = aiClient;
+    runtimeLogger;
+    constructor(config, messageHistory, runtimeLogger) {
+        this.config = config;
         this.messageHistory = messageHistory;
-        this.responseProcessor = responseProcessor;
-        this.extensionHost = extensionHost;
+        this.runtimeLogger = runtimeLogger;
     }
-    async handle(toolCallId, toolCall, toolResponse, step, resolveStepResult) {
-        await this.handleMultiple([{ toolCallId, toolCall, toolResponse }], step, resolveStepResult);
-    }
-    async handleMultiple(toolResponses, step, resolveStepResult) {
-        if (toolResponses.length === 0) {
-            return;
+    build(toolResults) {
+        if (toolResults.length === 0) {
+            return [];
         }
-        this.messageHistory.removeEphemeralStateMessages(this.aiClient);
-        for (const { toolCallId, toolResponse } of toolResponses) {
-            await this.aiClient.addToolResponse(toolCallId, toolResponse.response);
+        const messages = [];
+        for (const { toolCallId, toolCall, toolResponse } of toolResults) {
+            this.logModelBoundToolResponse(toolCallId, toolCall, toolResponse);
+            if (toolResponse.status === 'error') {
+                this.logErrorResponse(toolCallId, toolCall, toolResponse);
+            }
+            messages.push({ role: 'tool', tool_call_id: toolCallId, content: toolResponse.response });
         }
-        const executionSummary = buildToolExecutionSummary(toolResponses);
+        const executionSummary = buildToolExecutionSummary(toolResults);
         if (executionSummary) {
-            await this.aiClient.addToolExecutionSummaryMessage(executionSummary);
+            messages.push(this.messageHistory.createToolExecutionSummaryMessage(executionSummary));
+        }
+        return messages;
+    }
+    logModelBoundToolResponse(toolCallId, toolCall, toolResponse) {
+        if (!this.isDebugMode()) {
+            return;
         }
-        await this.extensionHost.handleToolResponses({
-            aiClient: this.aiClient,
-            step,
-            resolveStepResult,
-            toolResponses,
-        });
-        const nextResponse = await this.aiClient.sendToolResponseWithRetry();
-        await this.responseProcessor.handleResponse(nextResponse, step, resolveStepResult);
+        this.runtimeLogger.debug([
+            'tool response returned to model:',
+            `tool_call_id: ${toolCallId}`,
+            `tool: ${toolCall.name}`,
+            `status: ${toolResponse.status}`,
+            `arguments: ${safePreview(JSON.stringify(toolCall.arguments ?? {}), 1_000)}`,
+            `response: ${safePreview(toolResponse.response, 2_000)}`,
+            `snapshot: ${formatSnapshotMetadata(toolResponse.snapshot)}`,
+        ].join('\n'));
+    }
+    logErrorResponse(toolCallId, toolCall, toolResponse) {
+        const responseLine = this.isDebugMode()
+            ? 'response: logged at debug level'
+            : `response: ${safePreview(toolResponse.response, 2_000)}`;
+        this.runtimeLogger.warn([
+            'tool response error:',
+            `tool_call_id: ${toolCallId}`,
+            `tool: ${toolCall.name}`,
+            `arguments: ${safePreview(JSON.stringify(toolCall.arguments ?? {}), 1_000)}`,
+            responseLine,
+        ].join('\n'));
+    }
+    isDebugMode() {
+        return this.config.logLevel === 'debug';
     }
 }
-function buildToolExecutionSummary(toolResponses) {
-    const summaryLines = toolResponses.map(({ toolCall, toolResponse }) => formatToolExecutionSummary(toolCall, toolResponse));
+function buildToolExecutionSummary(toolResults) {
+    const summaryLines = toolResults.map(({ toolCall, toolResponse }) => formatToolExecutionSummary(toolCall, toolResponse));
     return summaryLines.join('\n');
 }
 function formatToolExecutionSummary(toolCall, toolResponse) {
@@ -45,6 +67,15 @@ function formatToolExecutionSummary(toolCall, toolResponse) {
     }
     return `- successfully executed: ${toolCall.name} ${serializedArguments}`;
 }
+function formatSnapshotMetadata(snapshot) {
+    if (!snapshot) {
+        return 'none';
+    }
+    return `present (${snapshot.length} chars, content logged by SnapshotService)`;
+}
+function safePreview(value, maxLength) {
+    return truncateText(scrub(value), maxLength);
+}
 function truncateText(value, maxLength) {
     if (value.length <= maxLength) {
         return value;

package/dist/ai/tool-response-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-response-handler.js","sourceRoot":"","sources":["../../src/ai/tool-response-handler.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,mBAAmB;IAEb;IACA;IACA;IACA;IAJlB,YACkB,QAAkB,EAClB,cAA8B,EAC9B,iBAAoC,EACpC,aAA4B;QAH5B,aAAQ,GAAR,QAAQ,CAAU;QAClB,mBAAc,GAAd,cAAc,CAAgB;QAC9B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,kBAAa,GAAb,aAAa,CAAe;IAC3C,CAAC;IAEJ,KAAK,CAAC,MAAM,CACX,UAAkB,EAClB,QAAkB,EAClB,YAA0B,EAC1B,IAAU,EACV,iBAAoC;QAEpC,MAAM,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAA;IAC7F,CAAC;IAED,KAAK,CAAC,cAAc,CACnB,aAA4F,EAC5F,IAAU,EACV,iBAAoC;QAEpC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAM;QACP,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAE/D,KAAK,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,aAAa,EAAE,CAAC;YAC1D,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;QACvE,CAAC;QAED,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAA;QACjE,IAAI,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,gBAAgB,CAAC,CAAA;QACrE,CAAC;QAED,MAAM,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC;YAC5C,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI;YACJ,iBAAiB;YACjB,aAAa;SACb,CAAC,CAAA;QAEF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,yBAAyB,EAAE,CAAA;QACpE,MAAM,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAA;IACnF,CAAC;CACD;AAED,SAAS,yBAAyB,CACjC,aAA4F;IAE5F,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,CACrE,0BAA0B,CAAC,QAAQ,EAAE,YAAY,CAAC,CAClD,CAAA;IACD,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAkB,EAAE,YAA0B;IACjF,MAAM,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAA;IACvF,IAAI,YAAY,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QACrC,OAAO,sBAAsB,QAAQ,CAAC,IAAI,IAAI,mBAAmB,OAAO,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAA;IACnH,CAAC;IAED,OAAO,4BAA4B,QAAQ,CAAC,IAAI,IAAI,mBAAmB,EAAE,CAAA;AAC1E,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,SAAiB;IACrD,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAA;IACb,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,CAAA;AAC7C,CAAC"}
+{"version":3,"file":"tool-response-handler.js","sourceRoot":"","sources":["../../src/ai/tool-response-handler.ts"],"names":[],"mappings":"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"}

package/dist/ai/turn-processor.d.ts

@@ -0,0 +1,34 @@
+import { ChatCompletion } from 'openai/resources/chat/completions';
+import { RuntimeConfig } from '../runtime/config.js';
+import { InternalStepEvidence } from '../runtime/internal-step-evidence.js';
+import type { StepControl } from '../runtime/scenario-control.js';
+import { Step, TurnOutcome } from '../runtime/types.js';
+import type { RuntimeLogger } from '../logging/types.js';
+import { LoopDetector } from '../tools/loop-detector.js';
+import { ToolRegistry } from '../tools/registry.js';
+export type TurnProcessorDependencies = {
+    config: RuntimeConfig;
+    toolRegistry: ToolRegistry;
+    loopDetector: LoopDetector;
+    evidence: Pick<InternalStepEvidence, 'recordAssistantMessage' | 'recordToolCall'>;
+    logger: RuntimeLogger;
+};
+export type Turn = {
+    response: ChatCompletion;
+    step: Step;
+    turn: number;
+    control?: StepControl;
+};
+export declare class TurnProcessor {
+    private readonly toolDispatcher;
+    private readonly toolResponseHandler;
+    private readonly messageHandler;
+    private readonly rateLimitPolicy;
+    private readonly evidence;
+    constructor({ config, toolRegistry, loopDetector, evidence, logger: runtimeLogger }: TurnProcessorDependencies);
+    process({ response, step, turn, control }: Turn): Promise<TurnOutcome>;
+    private recordAssistantMessage;
+    private parseToolArguments;
+    private formatChoiceContext;
+}
+//# sourceMappingURL=turn-processor.d.ts.map

package/dist/ai/turn-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-processor.d.ts","sourceRoot":"","sources":["../../src/ai/turn-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,EAAqB,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAOnD,MAAM,MAAM,yBAAyB,GAAG;IACvC,MAAM,EAAE,aAAa,CAAA;IACrB,YAAY,EAAE,YAAY,CAAA;IAC1B,YAAY,EAAE,YAAY,CAAA;IAC1B,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,wBAAwB,GAAG,gBAAgB,CAAC,CAAA;IACjF,MAAM,EAAE,aAAa,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,IAAI,GAAG;IAClB,QAAQ,EAAE,cAAc,CAAA;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyE;gBAEtF,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,yBAAyB;IAQxG,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAiE5E,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,mBAAmB;CAY3B"}

package/dist/ai/turn-processor.js

@@ -0,0 +1,107 @@
+import { ToolDispatcher, ToolDispatchError } from '../tools/dispatcher.js';
+import { LoopDetectedError } from '../tools/loop-detector.js';
+import { MessageHandler } from './message-handler.js';
+import { MessageHistory } from './message-history.js';
+import { RateLimitPolicy } from './rate-limit-policy.js';
+import { ToolResponseHandler } from './tool-response-handler.js';
+export class TurnProcessor {
+    toolDispatcher;
+    toolResponseHandler;
+    messageHandler;
+    rateLimitPolicy;
+    evidence;
+    constructor({ config, toolRegistry, loopDetector, evidence, logger: runtimeLogger }) {
+        this.toolDispatcher = new ToolDispatcher(toolRegistry, loopDetector, runtimeLogger, config.logLevel === 'debug');
+        this.toolResponseHandler = new ToolResponseHandler(config, new MessageHistory(), runtimeLogger);
+        this.messageHandler = new MessageHandler(runtimeLogger);
+        this.rateLimitPolicy = new RateLimitPolicy(config, runtimeLogger);
+        this.evidence = evidence;
+    }
+    async process({ response, step, turn, control }) {
+        await this.rateLimitPolicy.wait(control?.signal);
+        if (!response.choices || response.choices.length === 0) {
+            throw new Error(`No choices found in response:\n${JSON.stringify(response, null, 2)}`);
+        }
+        const choice = response.choices[0];
+        this.recordAssistantMessage(choice, turn);
+        const toolCalls = (choice.message.tool_calls ?? []).filter((toolCall) => toolCall.type === 'function');
+        if (toolCalls.length === 0) {
+            return this.messageHandler.handle(choice, step);
+        }
+        const toolResults = [];
+        for (const toolCall of toolCalls) {
+            const parsedToolCall = {
+                name: toolCall.function.name,
+                arguments: this.parseToolArguments(toolCall.function.arguments || '{}', toolCall.id, toolCall.function.name, choice, response, step),
+            };
+            let toolResponse;
+            try {
+                const context = control ? { step, turn, signal: control.signal, control } : { step, turn };
+                toolResponse =
+                    (await this.toolDispatcher.dispatch(parsedToolCall, context)) ??
+                        noOutputResponse(parsedToolCall.name);
+            }
+            catch (error) {
+                if (error instanceof LoopDetectedError) {
+                    return { kind: 'stuck', reason: 'loop-detected' };
+                }
+                throw new ToolDispatchError([
+                    `Tool dispatch failed: ${parsedToolCall.name}`,
+                    `tool_call_id: ${toolCall.id}`,
+                    `arguments: ${preview(parsedToolCall.arguments, 1_000)}`,
+                    this.formatChoiceContext(choice, response, step),
+                    `original_error: ${error instanceof Error ? error.message : String(error)}`,
+                ].join('\n'), { cause: error });
+            }
+            this.evidence.recordToolCall(turn, parsedToolCall, toolResponse);
+            if (toolResponse.assertion) {
+                return { kind: 'assertion', ...toolResponse.assertion };
+            }
+            toolResults.push({ toolCallId: toolCall.id, toolCall: parsedToolCall, toolResponse });
+        }
+        return { kind: 'continue', toolResults, messages: this.toolResponseHandler.build(toolResults) };
+    }
+    recordAssistantMessage(choice, turn) {
+        if (typeof choice.message.content === 'string' && choice.message.content.trim().length > 0) {
+            this.evidence.recordAssistantMessage(turn, choice.message.content);
+        }
+    }
+    parseToolArguments(rawArguments, toolCallId, toolName, choice, response, step) {
+        try {
+            return JSON.parse(rawArguments);
+        }
+        catch (error) {
+            throw new ToolDispatchError([
+                `Malformed tool arguments for ${toolName}`,
+                `tool_call_id: ${toolCallId}`,
+                `raw_arguments: ${preview(rawArguments, 1_000)}`,
+                this.formatChoiceContext(choice, response, step),
+                `original_error: ${error instanceof Error ? error.message : String(error)}`,
+            ].join('\n'), { cause: error });
+        }
+    }
+    formatChoiceContext(choice, response, step) {
+        return [
+            `step_action: ${step.action}`,
+            `step_expect: ${step.expect}`,
+            `response_id: ${response.id}`,
+            `response_model: ${response.model}`,
+            `choice_index: ${choice.index}`,
+            `finish_reason: ${choice.finish_reason}`,
+            `assistant_content: ${preview(choice.message.content, 1_000)}`,
+            `assistant_refusal: ${preview(choice.message.refusal, 1_000)}`,
+        ].join('\n');
+    }
+}
+function noOutputResponse(toolName) {
+    return { name: toolName, response: 'tool completed without output', snapshot: null, status: 'success' };
+}
+function preview(value, maxLength) {
+    const text = typeof value === 'string' ? value : JSON.stringify(value);
+    const safeText = (text ?? String(value))
+        .replace(/data:image\/[a-zA-Z0-9.+-]+;base64,[A-Za-z0-9+/=]+/g, '[image omitted]')
+        .replace(/[A-Za-z0-9+/]{200,}={0,2}/g, '[base64 omitted]')
+        .replace(/sk-[A-Za-z0-9_-]+/g, '[secret omitted]');
+    return safeText.length <= maxLength ? safeText : `${safeText.slice(0, maxLength - 3)}...`;
+}
+//# sourceMappingURL=turn-processor.js.map

package/dist/ai/turn-processor.js.map

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

package/dist/api/allocate-run-identity.d.ts

@@ -0,0 +1,8 @@
+import { type RunIdentity } from '../evidence/layout.js';
+import type { PreparedRun } from './prepare-run.js';
+export type AllocatePreparedRunIdentityOptions = Readonly<{
+    now?: () => Date;
+    random?: () => Uint8Array;
+}>;
+export declare function allocateRunIdentity(prepared: PreparedRun, options?: AllocatePreparedRunIdentityOptions): Promise<RunIdentity>;
+//# sourceMappingURL=allocate-run-identity.d.ts.map

package/dist/api/allocate-run-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocate-run-identity.d.ts","sourceRoot":"","sources":["../../src/api/allocate-run-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACzG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,MAAM,kCAAkC,GAAG,QAAQ,CAAC;IACzD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,UAAU,CAAA;CACzB,CAAC,CAAA;AAEF,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,kCAAuC,GAC9C,OAAO,CAAC,WAAW,CAAC,CAOtB"}

package/dist/api/allocate-run-identity.js

@@ -0,0 +1,10 @@
+import { allocateRunIdentity as allocateEvidenceIdentity } from '../evidence/layout.js';
+export function allocateRunIdentity(prepared, options = {}) {
+    return allocateEvidenceIdentity({
+        invocationRoot: prepared.invocationRoot,
+        outputDirectory: prepared.outputDirectory,
+        scenarioId: prepared.request.scenario.id,
+        ...options,
+    });
+}
+//# sourceMappingURL=allocate-run-identity.js.map

package/dist/api/allocate-run-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocate-run-identity.js","sourceRoot":"","sources":["../../src/api/allocate-run-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,IAAI,wBAAwB,EAAoB,MAAM,uBAAuB,CAAA;AAQzG,MAAM,UAAU,mBAAmB,CAClC,QAAqB,EACrB,UAA8C,EAAE;IAEhD,OAAO,wBAAwB,CAAC;QAC/B,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QACxC,GAAG,OAAO;KACV,CAAC,CAAA;AACH,CAAC"}

package/dist/api/execute-prepared-run.d.ts

@@ -0,0 +1,22 @@
+import { type DriverModuleImporter } from '../drivers/loader.js';
+import { EvidenceStore } from '../evidence/store.js';
+import type { RunIdentity } from '../evidence/layout.js';
+import { type RuntimeLogger } from '../logging/types.js';
+import { type ScenarioRunnerFactory } from '../runtime/scenario-runner.js';
+import type { ExecutionResultV1 } from '../contracts/types.js';
+import type { EnvironmentReader } from '../config/secrets.js';
+import type { PreparedRun } from './prepare-run.js';
+export type ExecutePreparedRunOptions = Readonly<{
+    signal?: AbortSignal;
+    readEnvironment?: EnvironmentReader;
+    importDriver?: DriverModuleImporter;
+    logger?: RuntimeLogger;
+    createRunner?: ScenarioRunnerFactory;
+    now?: () => number;
+    setTimer?: typeof setTimeout;
+    clearTimer?: typeof clearTimeout;
+    createStore?: (options: ConstructorParameters<typeof EvidenceStore>[0]) => EvidenceStore;
+    onCleanupStarted?: () => void;
+}>;
+export declare function executePreparedRun(prepared: PreparedRun, identity: RunIdentity, options?: ExecutePreparedRunOptions): Promise<ExecutionResultV1>;
+//# sourceMappingURL=execute-prepared-run.d.ts.map

package/dist/api/execute-prepared-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-prepared-run.d.ts","sourceRoot":"","sources":["../../src/api/execute-prepared-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAItE,OAAO,EAAe,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAGvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAChD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,eAAe,CAAC,EAAE,iBAAiB,CAAA;IACnC,YAAY,CAAC,EAAE,oBAAoB,CAAA;IACnC,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,UAAU,CAAA;IAC5B,UAAU,CAAC,EAAE,OAAO,YAAY,CAAA;IAChC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,aAAa,CAAA;IACxF,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;CAC7B,CAAC,CAAA;AAEF,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,yBAA8B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAyF5B"}

package/dist/api/execute-prepared-run.js

@@ -0,0 +1,160 @@
+import { loadValidatedDriver } from '../drivers/loader.js';
+import { EvidenceStore } from '../evidence/store.js';
+import { TerminalFinalizer } from '../evidence/terminal-finalizer.js';
+import { createInvocationLogger } from '../logging/invocation-logger.js';
+import { silentLogger } from '../logging/types.js';
+import { DiagnosticSanitizer } from '../redaction/diagnostic-sanitizer.js';
+import { awaitDriverBoundary, DriverBoundaryError } from '../runtime/driver-boundary.js';
+import { ScenarioControl } from '../runtime/scenario-control.js';
+import { runScenario } from '../runtime/scenario-runner.js';
+import { ScenarioState } from '../runtime/scenario-state.js';
+import { ScenarioUsageTracker } from '../runtime/usage-tracker.js';
+export async function executePreparedRun(prepared, identity, options = {}) {
+    const now = options.now ?? Date.now;
+    const control = new ScenarioControl({
+        timeoutMs: prepared.effectiveLimits.scenarioTimeoutMs,
+        signal: options.signal,
+        now,
+        setTimer: options.setTimer,
+        clearTimer: options.clearTimer,
+    });
+    const usageTracker = new ScenarioUsageTracker(prepared.effectiveLimits.budgetTokens);
+    const state = new ScenarioState({
+        request: prepared.request,
+        identity,
+        driver: { id: prepared.driver.id, contractVersion: prepared.driver.descriptor.driverContractVersion },
+        policy: { id: prepared.policy.id, effectiveLimits: prepared.effectiveLimits },
+        now,
+    });
+    let store;
+    try {
+        const resolvedSecrets = resolveSecrets(prepared, options.readEnvironment);
+        const exactSecrets = [...resolvedSecrets.values.values()];
+        const sanitizer = new DiagnosticSanitizer(exactSecrets);
+        const logger = createInvocationLogger(options.logger ?? silentLogger, sanitizer);
+        store = (options.createStore ?? ((storeOptions) => new EvidenceStore(storeOptions)))({
+            invocationRoot: prepared.invocationRoot,
+            identity,
+            policy: prepared.policy.evidence,
+            stepIds: prepared.request.scenario.steps.map((step) => step.id),
+            driverDescriptor: prepared.driver.descriptor,
+            exactSecrets,
+            now: () => new Date(now()),
+        });
+        try {
+            await store.writeInvocation(prepared.request);
+        }
+        catch (error) {
+            store.markPartial();
+            state.recordLifecycleFailure('evidence-write-failed', {
+                code: 'evidence.write-failed',
+                path: '/evidence',
+                message: sanitizer.error(error),
+            });
+            state.markNotStarted();
+            const candidate = state.buildCandidateResult({
+                usage: usageTracker.usage(),
+                evidence: { state: store.state, references: store.committedReferences },
+            });
+            return (await new TerminalFinalizer(store).finalize(candidate)).result;
+        }
+        if (resolvedSecrets.error) {
+            state.recordLifecycleFailure('driver-start-failed', {
+                code: 'secret.unavailable',
+                path: '/secretBindings',
+                message: sanitizer.error(resolvedSecrets.error),
+            });
+            state.markNotStarted();
+        }
+        else {
+            const driver = await loadDriver(prepared, control, state, sanitizer, now, options.importDriver);
+            if (driver) {
+                await runScenario({
+                    driver,
+                    prepared,
+                    state,
+                    control,
+                    store,
+                    usageTracker,
+                    secretValues: resolvedSecrets.values,
+                    apiKey: resolvedSecrets.values.get(prepared.modelEgress.provider.apiKeyBinding),
+                    exactSecrets,
+                    logger,
+                    sanitizer,
+                    createRunner: options.createRunner,
+                    now,
+                    onCleanupStarted: options.onCleanupStarted,
+                });
+            }
+        }
+        await store.finalizeScenario(state.hasFailure ? 'failed' : 'passed');
+        const candidate = state.buildCandidateResult({
+            usage: usageTracker.usage(),
+            evidence: { state: store.state, references: store.committedReferences },
+        });
+        return (await new TerminalFinalizer(store).finalize(candidate)).result;
+    }
+    finally {
+        control.dispose();
+        store?.dispose();
+    }
+}
+async function loadDriver(prepared, control, state, sanitizer, now, importDriver) {
+    const expired = control.poll();
+    if (expired.expired) {
+        state.recordLifecycleFailure(expired.reason, {
+            code: 'scenario.expired',
+            path: '',
+            message: expired.reason,
+        });
+        state.markNotStarted();
+        return undefined;
+    }
+    state.markMutationPossible();
+    try {
+        return await awaitDriverBoundary({
+            operation: 'driver-load',
+            signal: control.signal,
+            deadline: control.deadline,
+            now,
+            reason: () => {
+                const current = control.poll();
+                return current.expired ? current.reason : 'scenario-timeout';
+            },
+            call: () => loadValidatedDriver({
+                invocationRoot: prepared.invocationRoot,
+                packageName: prepared.driver.packageName,
+                descriptor: prepared.driver.descriptor,
+                importModule: importDriver,
+            }),
+        });
+    }
+    catch (error) {
+        const reason = error instanceof DriverBoundaryError ? error.reason : 'driver-load-failed';
+        state.recordLifecycleFailure(reason, {
+            code: reason === 'driver-load-failed' ? 'driver.load-failed' : 'scenario.expired',
+            path: '/driver',
+            message: sanitizer.error(error),
+        });
+        state.markNotStarted();
+        return undefined;
+    }
+}
+function resolveSecrets(prepared, readEnvironment = (name) => process.env[name]) {
+    const values = new Map();
+    for (const [binding, definition] of Object.entries(prepared.secretBindings)) {
+        let value;
+        try {
+            value = readEnvironment(definition.name);
+        }
+        catch (error) {
+            return { values, error: error instanceof Error ? error : new Error(String(error)) };
+        }
+        if (typeof value !== 'string' || value.trim().length === 0) {
+            return { values, error: new Error(`Secret binding '${binding}' is unavailable`) };
+        }
+        values.set(binding, value);
+    }
+    return { values };
+}
+//# sourceMappingURL=execute-prepared-run.js.map