@theokit/sdk 4.63.4 → 5.0.0-next.2

package/dist/errors-base-B5g01neU.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The root of the SDK error hierarchy, and the two types it is built from.
+ *
+ * A LEAF module on purpose: every other error in this package extends `TheokitAgentError`, and
+ * `errors.ts` re-exports the ones that live in their own files. If the root lived in that catalogue,
+ * each sibling would import it from a file that imports the sibling — a cycle madge reports and
+ * `tests/architecture/no-cycles-at-all.test.ts` fails on. `types/messages-base.ts` exists for the
+ * same reason, one layer over.
+ *
+ * Re-exported from `errors.ts`, so `@theokit/sdk/errors` is unchanged and consumers keep catching
+ * `TheokitAgentError` from where the README tells them to.
+ *
+ * NOTE ON THE MODULE TAG: this header deliberately carries no internal-visibility tag, and does not
+ * even name one — TypeScript attaches a file-leading docblock to the FIRST declaration below it, and
+ * `stripInternal: true` (tsconfig.base) then deletes that declaration from the emitted `.d.ts`.
+ * `tsc --noEmit` stays clean and the declaration rollup fails with `"X" is not exported by "..."`.
+ * Measured twice on this file on 2026-09-01: once with the tag, and again when the comment
+ * EXPLAINING the trap quoted the tag verbatim and re-armed it.
+ */
+/**
+ * Finite, machine-readable error codes for provider-originated errors
+ * (ADR D66). Consumers can `switch (err.metadata?.code)` exhaustively
+ * — adding a new variant is an explicit decision + test coverage.
+ *
+ * @public
+ */
+type ErrorCode = "rate_limit" | "auth_failed" | "invalid_request" | "timeout" | "server_error" | "context_too_long" | "content_filtered" | "model_unavailable" | "network" | "quota_exceeded" | "unknown";
+/**
+ * Structured context for errors that originated from a provider HTTP
+ * call (ADR D65). Lets callers retry with the right backoff (`retryAfter`),
+ * surface actionable diagnostics (`provider`, `endpoint`), and inspect the
+ * raw response body when needed (`raw`, capped at ~2KB by the mapper).
+ *
+ * @public
+ */
+interface ErrorMetadata {
+    /** Provider canonical name (e.g., `"anthropic"`, `"openai"`, `"openrouter"`, `"gemini"`). */
+    provider: string;
+    /** HTTP endpoint that failed (e.g., `"/v1/messages"`, `"/v1/chat/completions"`). */
+    endpoint: string;
+    /** Machine-readable error code (finite enum). */
+    code: ErrorCode;
+    /** HTTP status code if applicable. */
+    statusCode?: number;
+    /** Seconds to wait before retry, per provider's `retry-after` header (numeric form only). */
+    retryAfter?: number;
+    /** Raw response body for debugging (truncated to ~2KB by the mapper). */
+    raw?: unknown;
+}
+/**
+ * Base class for all errors thrown by `@theokit/sdk`.
+ *
+ * Use `isRetryable` to drive retry/backoff logic. `code` and `protoErrorCode`
+ * are populated for server-originated errors when available. `metadata`
+ * (ADR D65) carries structured `{ provider, endpoint, code, ... }` when
+ * the error originated from a provider HTTP call.
+ *
+ * @public
+ */
+declare class TheokitAgentError extends Error {
+    readonly name: string;
+    readonly isRetryable: boolean;
+    readonly code?: string;
+    readonly protoErrorCode?: string;
+    readonly metadata?: ErrorMetadata;
+    constructor(message: string, options?: {
+        isRetryable?: boolean;
+        code?: string;
+        protoErrorCode?: string;
+        cause?: unknown;
+        metadata?: ErrorMetadata;
+    });
+}
+
+export { type ErrorMetadata as E, TheokitAgentError as T, type ErrorCode as a };

package/dist/errors-base.d.ts

@@ -0,0 +1,73 @@
+/**
+ * The root of the SDK error hierarchy, and the two types it is built from.
+ *
+ * A LEAF module on purpose: every other error in this package extends `TheokitAgentError`, and
+ * `errors.ts` re-exports the ones that live in their own files. If the root lived in that catalogue,
+ * each sibling would import it from a file that imports the sibling — a cycle madge reports and
+ * `tests/architecture/no-cycles-at-all.test.ts` fails on. `types/messages-base.ts` exists for the
+ * same reason, one layer over.
+ *
+ * Re-exported from `errors.ts`, so `@theokit/sdk/errors` is unchanged and consumers keep catching
+ * `TheokitAgentError` from where the README tells them to.
+ *
+ * NOTE ON THE MODULE TAG: this header deliberately carries no internal-visibility tag, and does not
+ * even name one — TypeScript attaches a file-leading docblock to the FIRST declaration below it, and
+ * `stripInternal: true` (tsconfig.base) then deletes that declaration from the emitted `.d.ts`.
+ * `tsc --noEmit` stays clean and the declaration rollup fails with `"X" is not exported by "..."`.
+ * Measured twice on this file on 2026-09-01: once with the tag, and again when the comment
+ * EXPLAINING the trap quoted the tag verbatim and re-armed it.
+ */
+/**
+ * Finite, machine-readable error codes for provider-originated errors
+ * (ADR D66). Consumers can `switch (err.metadata?.code)` exhaustively
+ * — adding a new variant is an explicit decision + test coverage.
+ *
+ * @public
+ */
+export type ErrorCode = "rate_limit" | "auth_failed" | "invalid_request" | "timeout" | "server_error" | "context_too_long" | "content_filtered" | "model_unavailable" | "network" | "quota_exceeded" | "unknown";
+/**
+ * Structured context for errors that originated from a provider HTTP
+ * call (ADR D65). Lets callers retry with the right backoff (`retryAfter`),
+ * surface actionable diagnostics (`provider`, `endpoint`), and inspect the
+ * raw response body when needed (`raw`, capped at ~2KB by the mapper).
+ *
+ * @public
+ */
+export interface ErrorMetadata {
+    /** Provider canonical name (e.g., `"anthropic"`, `"openai"`, `"openrouter"`, `"gemini"`). */
+    provider: string;
+    /** HTTP endpoint that failed (e.g., `"/v1/messages"`, `"/v1/chat/completions"`). */
+    endpoint: string;
+    /** Machine-readable error code (finite enum). */
+    code: ErrorCode;
+    /** HTTP status code if applicable. */
+    statusCode?: number;
+    /** Seconds to wait before retry, per provider's `retry-after` header (numeric form only). */
+    retryAfter?: number;
+    /** Raw response body for debugging (truncated to ~2KB by the mapper). */
+    raw?: unknown;
+}
+/**
+ * Base class for all errors thrown by `@theokit/sdk`.
+ *
+ * Use `isRetryable` to drive retry/backoff logic. `code` and `protoErrorCode`
+ * are populated for server-originated errors when available. `metadata`
+ * (ADR D65) carries structured `{ provider, endpoint, code, ... }` when
+ * the error originated from a provider HTTP call.
+ *
+ * @public
+ */
+export declare class TheokitAgentError extends Error {
+    readonly name: string;
+    readonly isRetryable: boolean;
+    readonly code?: string;
+    readonly protoErrorCode?: string;
+    readonly metadata?: ErrorMetadata;
+    constructor(message: string, options?: {
+        isRetryable?: boolean;
+        code?: string;
+        protoErrorCode?: string;
+        cause?: unknown;
+        metadata?: ErrorMetadata;
+    });
+}

package/dist/errors.cjs

@@ -1,86 +1,89 @@
 'use strict';
 
-var chunk4ZHTIJNE_cjs = require('./chunk-4ZHTIJNE.cjs');
-require('./chunk-XL7Q7HB2.cjs');
-require('./chunk-EG4QM7ZJ.cjs');
+var chunkJ7J7J2GN_cjs = require('./chunk-J7J7J2GN.cjs');
+require('./chunk-6LHQPOMI.cjs');
 
 
 
 Object.defineProperty(exports, "AgentDisposedError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.AgentDisposedError; }
+  get: function () { return chunkJ7J7J2GN_cjs.AgentDisposedError; }
 });
 Object.defineProperty(exports, "AgentRunError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.AgentRunError; }
+  get: function () { return chunkJ7J7J2GN_cjs.AgentRunError; }
 });
 Object.defineProperty(exports, "AuthenticationError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.AuthenticationError; }
+  get: function () { return chunkJ7J7J2GN_cjs.AuthenticationError; }
 });
 Object.defineProperty(exports, "BudgetExceededError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.BudgetExceededError; }
+  get: function () { return chunkJ7J7J2GN_cjs.BudgetExceededError; }
 });
 Object.defineProperty(exports, "ConfigurationError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.ConfigurationError; }
+  get: function () { return chunkJ7J7J2GN_cjs.ConfigurationError; }
 });
 Object.defineProperty(exports, "CredentialPoolExhaustedError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.CredentialPoolExhaustedError; }
+  get: function () { return chunkJ7J7J2GN_cjs.CredentialPoolExhaustedError; }
 });
 Object.defineProperty(exports, "IntegrationNotConnectedError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.IntegrationNotConnectedError; }
+  get: function () { return chunkJ7J7J2GN_cjs.IntegrationNotConnectedError; }
 });
 Object.defineProperty(exports, "InvalidTaskIdError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.InvalidTaskIdError; }
+  get: function () { return chunkJ7J7J2GN_cjs.InvalidTaskIdError; }
 });
 Object.defineProperty(exports, "MemoryAdapterError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.MemoryAdapterError; }
+  get: function () { return chunkJ7J7J2GN_cjs.MemoryAdapterError; }
 });
 Object.defineProperty(exports, "NetworkError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.NetworkError; }
+  get: function () { return chunkJ7J7J2GN_cjs.NetworkError; }
 });
 Object.defineProperty(exports, "RateLimitError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.RateLimitError; }
+  get: function () { return chunkJ7J7J2GN_cjs.RateLimitError; }
+});
+Object.defineProperty(exports, "StructuredOutputError", {
+  enumerable: true,
+  get: function () { return chunkJ7J7J2GN_cjs.StructuredOutputError; }
 });
 Object.defineProperty(exports, "TaskNotFoundError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.TaskNotFoundError; }
+  get: function () { return chunkJ7J7J2GN_cjs.TaskNotFoundError; }
 });
 Object.defineProperty(exports, "TheokitAgentError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.TheokitAgentError; }
+  get: function () { return chunkJ7J7J2GN_cjs.TheokitAgentError; }
 });
 Object.defineProperty(exports, "UnknownAgentError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.UnknownAgentError; }
+  get: function () { return chunkJ7J7J2GN_cjs.UnknownAgentError; }
 });
 Object.defineProperty(exports, "UnsupportedBudgetOperationError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.UnsupportedBudgetOperationError; }
+  get: function () { return chunkJ7J7J2GN_cjs.UnsupportedBudgetOperationError; }
 });
 Object.defineProperty(exports, "UnsupportedRunOperationError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.UnsupportedRunOperationError; }
+  get: function () { return chunkJ7J7J2GN_cjs.UnsupportedRunOperationError; }
 });
 Object.defineProperty(exports, "UnsupportedTaskOperationError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.UnsupportedTaskOperationError; }
+  get: function () { return chunkJ7J7J2GN_cjs.UnsupportedTaskOperationError; }
 });
 Object.defineProperty(exports, "coerceToKnownAgentRunErrorCode", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.coerceToKnownAgentRunErrorCode; }
+  get: function () { return chunkJ7J7J2GN_cjs.coerceToKnownAgentRunErrorCode; }
 });
 Object.defineProperty(exports, "isTransientError", {
   enumerable: true,
-  get: function () { return chunk4ZHTIJNE_cjs.isTransientError; }
+  get: function () { return chunkJ7J7J2GN_cjs.isTransientError; }
 });
 //# sourceMappingURL=errors.cjs.map
 //# sourceMappingURL=errors.cjs.map

package/dist/errors.d.cts

@@ -1,3 +1,4 @@
-export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, g as BudgetExceededError, C as ConfigurationError, u as CredentialPoolExhaustedError, m as ErrorCode, E as ErrorMetadata, I as IntegrationNotConnectedError, n as InvalidTaskIdError, K as KnownAgentRunErrorCode, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, T as TheokitAgentError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError, v as coerceToKnownAgentRunErrorCode, t as isTransientError } from './errors-BgJH9PHi.cjs';
-import './run-BYSHf58D.cjs';
+export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, g as BudgetExceededError, C as ConfigurationError, s as CredentialPoolExhaustedError, I as IntegrationNotConnectedError, m as InvalidTaskIdError, K as KnownAgentRunErrorCode, M as MemoryAdapterError, n as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, S as StructuredOutputError, t as StructuredOutputErrorCode, T as TaskNotFoundError, U as UnknownAgentError, o as UnsupportedBudgetOperationError, p as UnsupportedRunOperationError, q as UnsupportedTaskOperationError, u as coerceToKnownAgentRunErrorCode, r as isTransientError } from './errors-DrDEgyz1.cjs';
+export { a as ErrorCode, E as ErrorMetadata, T as TheokitAgentError } from './errors-base-B5g01neU.cjs';
+import './run-CTAdRU3U.cjs';
 import 'zod';

package/dist/errors.d.ts

@@ -1,3 +1,4 @@
-export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, g as BudgetExceededError, C as ConfigurationError, u as CredentialPoolExhaustedError, m as ErrorCode, E as ErrorMetadata, I as IntegrationNotConnectedError, n as InvalidTaskIdError, K as KnownAgentRunErrorCode, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, T as TheokitAgentError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError, v as coerceToKnownAgentRunErrorCode, t as isTransientError } from './errors-C5fJUqLk.js';
-import './run-BYSHf58D.js';
+export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, g as BudgetExceededError, C as ConfigurationError, s as CredentialPoolExhaustedError, I as IntegrationNotConnectedError, m as InvalidTaskIdError, K as KnownAgentRunErrorCode, M as MemoryAdapterError, n as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, S as StructuredOutputError, t as StructuredOutputErrorCode, T as TaskNotFoundError, U as UnknownAgentError, o as UnsupportedBudgetOperationError, p as UnsupportedRunOperationError, q as UnsupportedTaskOperationError, u as coerceToKnownAgentRunErrorCode, r as isTransientError } from './errors-CLOAyuiv.js';
+export { a as ErrorCode, E as ErrorMetadata, T as TheokitAgentError } from './errors-base-B5g01neU.js';
+import './run-CTAdRU3U.js';
 import 'zod';

package/dist/errors.js

@@ -1,5 +1,4 @@
-export { AgentDisposedError, AgentRunError, AuthenticationError, BudgetExceededError, ConfigurationError, CredentialPoolExhaustedError, IntegrationNotConnectedError, InvalidTaskIdError, MemoryAdapterError, NetworkError, RateLimitError, TaskNotFoundError, TheokitAgentError, UnknownAgentError, UnsupportedBudgetOperationError, UnsupportedRunOperationError, UnsupportedTaskOperationError, coerceToKnownAgentRunErrorCode, isTransientError } from './chunk-ZZMZWBR6.js';
-import './chunk-D4CUGAKZ.js';
-import './chunk-XEQ3TM66.js';
+export { AgentDisposedError, AgentRunError, AuthenticationError, BudgetExceededError, ConfigurationError, CredentialPoolExhaustedError, IntegrationNotConnectedError, InvalidTaskIdError, MemoryAdapterError, NetworkError, RateLimitError, StructuredOutputError, TaskNotFoundError, TheokitAgentError, UnknownAgentError, UnsupportedBudgetOperationError, UnsupportedRunOperationError, UnsupportedTaskOperationError, coerceToKnownAgentRunErrorCode, isTransientError } from './chunk-ALUN2B4W.js';
+import './chunk-CZJ6Q7CW.js';
 //# sourceMappingURL=errors.js.map
 //# sourceMappingURL=errors.js.map

package/dist/eval.cjs

@@ -1,61 +1,62 @@
 'use strict';
 
-var chunkJ24VJOH3_cjs = require('./chunk-J24VJOH3.cjs');
-var chunk7VT4P3Z4_cjs = require('./chunk-7VT4P3Z4.cjs');
-require('./chunk-3FFAEAUJ.cjs');
-require('./chunk-RMWTPV3M.cjs');
+var chunkUADQJBHR_cjs = require('./chunk-UADQJBHR.cjs');
+var chunkQUAEOKDW_cjs = require('./chunk-QUAEOKDW.cjs');
+require('./chunk-KVSAY6NZ.cjs');
+require('./chunk-Y2KYR2ED.cjs');
 var chunkBUUUWQMB_cjs = require('./chunk-BUUUWQMB.cjs');
-require('./chunk-VLVVJLDH.cjs');
-require('./chunk-VCLBZAZU.cjs');
+require('./chunk-2NE7DTOK.cjs');
+require('./chunk-H6YM3PV6.cjs');
 require('./chunk-BV2MWEMV.cjs');
-require('./chunk-KQ7TS7WW.cjs');
+require('./chunk-D6POWE7E.cjs');
 require('./chunk-GHX4P3V2.cjs');
-require('./chunk-GKEFRLU7.cjs');
-require('./chunk-IAHZCGBE.cjs');
-require('./chunk-ZLQSWSJ2.cjs');
-require('./chunk-KYAJINUI.cjs');
-require('./chunk-O7DK5PBJ.cjs');
-require('./chunk-4OTIXDMU.cjs');
-require('./chunk-UGT7GK7I.cjs');
-require('./chunk-O7LZFG6O.cjs');
+require('./chunk-TMKTSYDS.cjs');
+require('./chunk-LHSWHYF3.cjs');
+require('./chunk-7FDKWDA2.cjs');
+require('./chunk-2HPNT6HH.cjs');
+require('./chunk-FUSDYC2B.cjs');
+require('./chunk-YJNYDJ2T.cjs');
+require('./chunk-24SYBZPL.cjs');
+require('./chunk-QOGNZMHD.cjs');
+require('./chunk-YIFFF23U.cjs');
 require('./chunk-2ZPEDVLM.cjs');
-require('./chunk-7BG5UH3T.cjs');
+require('./chunk-RHZ6HP23.cjs');
 require('./chunk-KRD3GQAA.cjs');
-require('./chunk-2HVF2WJY.cjs');
+require('./chunk-RQMCOFAI.cjs');
 require('./chunk-MUUQ2WFJ.cjs');
-require('./chunk-WJVHMTKB.cjs');
-require('./chunk-6JSIEDKL.cjs');
+require('./chunk-AA27GEYS.cjs');
+require('./chunk-YSTXFWQE.cjs');
 require('./chunk-FRITRLZQ.cjs');
-require('./chunk-4O5TGQBW.cjs');
+require('./chunk-QME6FDFG.cjs');
 var chunkNINIJCHU_cjs = require('./chunk-NINIJCHU.cjs');
-require('./chunk-OHLDPWTA.cjs');
+require('./chunk-UGRS7ZA7.cjs');
 require('./chunk-LKFET5A3.cjs');
-require('./chunk-VJ26EKGJ.cjs');
-require('./chunk-V2BOS4WF.cjs');
-require('./chunk-VKJ7V7EB.cjs');
-require('./chunk-ZSWPZ23K.cjs');
-require('./chunk-XWTLIGO3.cjs');
-require('./chunk-I6HGWHPU.cjs');
-require('./chunk-5HEG4CQH.cjs');
+require('./chunk-IJ7M6GOG.cjs');
+require('./chunk-7A6535RA.cjs');
+require('./chunk-SA6K24NB.cjs');
+require('./chunk-I2PWY7VM.cjs');
+require('./chunk-KTTHHYEW.cjs');
+require('./chunk-Z3NTRKIC.cjs');
+require('./chunk-GZV6AVRL.cjs');
 require('./chunk-A4RAL2ER.cjs');
-require('./chunk-5VB22SYX.cjs');
-var chunkUU36SHFY_cjs = require('./chunk-UU36SHFY.cjs');
+require('./chunk-DQZU7JK6.cjs');
+var chunkBJUJT5ED_cjs = require('./chunk-BJUJT5ED.cjs');
 require('./chunk-ZF2LDKQQ.cjs');
-require('./chunk-RFMBZPOW.cjs');
-require('./chunk-UALX2J2Q.cjs');
-require('./chunk-43ZQRWAP.cjs');
-require('./chunk-AKJP2STZ.cjs');
-require('./chunk-4CLOXP6H.cjs');
-require('./chunk-DXGZ2NUG.cjs');
+require('./chunk-HCT4HPCL.cjs');
+require('./chunk-JLRLCBJ4.cjs');
+require('./chunk-SYVWE64W.cjs');
+require('./chunk-GGZ5GPE3.cjs');
+require('./chunk-HW7SEELD.cjs');
+require('./chunk-ATT276RD.cjs');
 require('./chunk-3EE6LVWT.cjs');
-require('./chunk-JPBKYL3B.cjs');
-require('./chunk-HCZD23VS.cjs');
-require('./chunk-6HKGLTJI.cjs');
-require('./chunk-XJCXEKMD.cjs');
-require('./chunk-52NKC5HT.cjs');
-require('./chunk-4ZHTIJNE.cjs');
-require('./chunk-XL7Q7HB2.cjs');
-var chunkEG4QM7ZJ_cjs = require('./chunk-EG4QM7ZJ.cjs');
+require('./chunk-ANMJJD6D.cjs');
+require('./chunk-QC55H6RJ.cjs');
+require('./chunk-NVXXWAU7.cjs');
+require('./chunk-4NLCWGH7.cjs');
+require('./chunk-EXTRW7GW.cjs');
+require('./chunk-HUFSABUZ.cjs');
+var chunkJ7J7J2GN_cjs = require('./chunk-J7J7J2GN.cjs');
+var chunk6LHQPOMI_cjs = require('./chunk-6LHQPOMI.cjs');
 var zod = require('zod');
 var crypto = require('crypto');
 
@@ -172,12 +173,13 @@ async function materializeDataset(d) {
 
 // src/internal/eval/single-flight.ts
 var RUNNING = /* @__PURE__ */ new Set();
-var EvalAlreadyRunningError = class extends Error {
+var EvalAlreadyRunningError = class extends chunkJ7J7J2GN_cjs.TheokitAgentError {
   name = "EvalAlreadyRunningError";
   evalName;
   constructor(evalName) {
     super(
-      `Eval "${evalName}" is already running in this process. Use a unique name per concurrent run (D213).`
+      `Eval "${evalName}" is already running in this process. Use a unique name per concurrent run (D213).`,
+      { code: "eval_already_running", isRetryable: false }
     );
     this.evalName = evalName;
   }
@@ -312,7 +314,7 @@ function safeHook(fn) {
   try {
     fn();
   } catch (err) {
-    chunkEG4QM7ZJ_cjs.diag(`[eval] hook threw (ignored): ${err instanceof Error ? err.message : String(err)}
+    chunk6LHQPOMI_cjs.diag(`[eval] hook threw (ignored): ${err instanceof Error ? err.message : String(err)}
 `);
   }
 }
@@ -341,16 +343,16 @@ function probeRow(entry, index) {
 }
 function computeDoneKeys(persist) {
   if (persist.resume !== true) return /* @__PURE__ */ new Set();
-  return chunkUU36SHFY_cjs.readJsonlIds(
+  return chunkBJUJT5ED_cjs.readJsonlIds(
     persist.path,
     (parsed) => parsed.error === void 0 ? persist.key(parsed) : void 0
   );
 }
 function appendRowSafely(path, row) {
   try {
-    chunkUU36SHFY_cjs.appendJsonl(path, row);
+    chunkBJUJT5ED_cjs.appendJsonl(path, row);
   } catch (err) {
-    chunkEG4QM7ZJ_cjs.diag(
+    chunk6LHQPOMI_cjs.diag(
       `[eval] persist append failed (ignored): ${err instanceof Error ? err.message : String(err)}
 `
     );
@@ -416,7 +418,8 @@ function makeAgentForBatch(spec, _entries) {
   }
   return spec;
 }
-async function runManualSlot(idx, entries, spec, scorers, sink, rows, onRow) {
+async function runManualSlot(ctx, spec, idx, rows) {
+  const { entries, scorers, sink, onRow } = ctx;
   const entry = entries[idx];
   if (entry === void 0) return;
   if (sink.isResumed(entry, idx)) return;
@@ -424,7 +427,8 @@ async function runManualSlot(idx, entries, spec, scorers, sink, rows, onRow) {
   rows[idx] = row;
   onRow(row, idx);
 }
-async function runRowsManually(entries, spec, scorers, concurrency, signal, onRow, sink) {
+async function runRowsManually(ctx, spec) {
+  const { entries, concurrency, signal } = ctx;
   const rows = new Array(entries.length);
   const state = { cursor: 0 };
   const worker = async () => {
@@ -432,7 +436,7 @@ async function runRowsManually(entries, spec, scorers, concurrency, signal, onRo
       if (signal?.aborted === true) return;
       const idx = state.cursor;
       state.cursor += 1;
-      await runManualSlot(idx, entries, spec, scorers, sink, rows, onRow);
+      await runManualSlot(ctx, spec, idx, rows);
     }
   };
   const workers = Array.from({ length: Math.min(concurrency, entries.length) }, () => worker());
@@ -482,7 +486,8 @@ async function scoreBatchOutput(br, expected, scorers) {
   }
   return scoreEntries;
 }
-async function runRowsViaBatch(entries, agentOptions, scorers, concurrency, signal, onRow, sink) {
+async function runRowsViaBatch(ctx, agentOptions) {
+  const { entries, scorers, concurrency, signal, onRow, sink } = ctx;
   const pending = [];
   for (let i = 0; i < entries.length; i += 1) {
     const entry = entries[i];
@@ -535,21 +540,11 @@ async function runEval(options, runOpts) {
       safeHook(() => hooks?.afterRow?.(row, i));
     };
     const sink = makeRowSink(runOpts?.persist, runOpts?.classify);
-    let rows;
-    if (isAgentInstance(options.agent) || typeof options.agent === "function") {
-      rows = await runRowsManually(
-        indexed,
-        options.agent,
-        scorers,
-        concurrency,
-        signal,
-        onRow,
-        sink
-      );
-    } else {
-      const batchOpts = makeAgentForBatch(options.agent, indexed);
-      rows = await runRowsViaBatch(indexed, batchOpts, scorers, concurrency, signal, onRow, sink);
-    }
+    const runCtx = { entries: indexed, scorers, concurrency, signal, onRow, sink };
+    const rows = await (isAgentInstance(options.agent) || typeof options.agent === "function" ? runRowsManually(
+      runCtx,
+      options.agent
+    ) : runRowsViaBatch(runCtx, makeAgentForBatch(options.agent, indexed)));
     const finalRows = trials > 1 ? collapseTrials(rows, trials) : rows;
     const aggregate = computeAggregate(finalRows);
     const endedAt = Date.now();
@@ -576,7 +571,7 @@ async function runEval(options, runOpts) {
 }
 
 // src/internal/eval/assert.ts
-var EvalThresholdError = class extends Error {
+var EvalThresholdError = class extends chunkJ7J7J2GN_cjs.TheokitAgentError {
   name = "EvalThresholdError";
   /** The eval's name (`EvalRun.name`). */
   evalName;
@@ -588,7 +583,8 @@ var EvalThresholdError = class extends Error {
     );
     super(
       `Eval "${evalName}" failed ${failures.length} threshold${failures.length === 1 ? "" : "s"}:
-${lines.join("\n")}`
+${lines.join("\n")}`,
+      { code: "eval_threshold_failed", isRetryable: false }
     );
     this.evalName = evalName;
     this.failures = failures;
@@ -631,13 +627,13 @@ function assertEval(run, thresholds) {
 // src/internal/eval/code-runner.ts
 var ARTIFACT_PATCH = ".theo-artifact.patch";
 async function captureArtifact(sandbox, repoDir) {
-  const dir = chunkJ24VJOH3_cjs.shellEscapePosix(repoDir);
+  const dir = chunkUADQJBHR_cjs.shellEscapePosix(repoDir);
   const diffRes = await sandbox.execute(`git -C ${dir} diff`);
   const diff = diffRes.stdout;
   if (diff.length === 0) return { diff: "", applies: false };
   await sandbox.uploadFile(`${repoDir}/${ARTIFACT_PATCH}`, diff);
   const check = await sandbox.execute(
-    `git -C ${dir} apply --check --reverse ${chunkJ24VJOH3_cjs.shellEscapePosix(ARTIFACT_PATCH)}`
+    `git -C ${dir} apply --check --reverse ${chunkUADQJBHR_cjs.shellEscapePosix(ARTIFACT_PATCH)}`
   );
   return { diff, applies: check.exitCode === 0 };
 }
@@ -784,7 +780,7 @@ function makeDefaultEmbedder(opts) {
   let runtime;
   return (texts) => {
     if (runtime === void 0) {
-      runtime = chunk7VT4P3Z4_cjs.openRouterMemoryEmbeddingProviderAdapter.create(embedderCreateOptions(opts));
+      runtime = chunkQUAEOKDW_cjs.openRouterMemoryEmbeddingProviderAdapter.create(embedderCreateOptions(opts));
     }
     return runtime.then((rt) => rt.embed(texts));
   };
@@ -930,7 +926,7 @@ var Scorers = {
    * that rejects shell metacharacters in `execute` is unsupported for this scorer.
    */
   verifyGate(opts) {
-    const { sandbox = new chunkJ24VJOH3_cjs.LocalSandbox(), repoDir, failToPass, passToPass, command } = opts;
+    const { sandbox = new chunkUADQJBHR_cjs.LocalSandbox(), repoDir, failToPass, passToPass, command } = opts;
     return {
       name: "verify-gate",
       score: async () => {
@@ -938,7 +934,7 @@ var Scorers = {
         if (cmd.length === 0) {
           return { score: 0, reason: "verify_gate_empty_command" };
         }
-        const r = await sandbox.execute(`cd ${chunkJ24VJOH3_cjs.shellEscapePosix(repoDir)} && ${cmd}`);
+        const r = await sandbox.execute(`cd ${chunkUADQJBHR_cjs.shellEscapePosix(repoDir)} && ${cmd}`);
         if (r.exitCode === 0) return { score: 1 };
         return { score: 0, reason: `exit=${r.exitCode} ${r.stderr.slice(0, 200)}`.trim() };
       }
@@ -1029,11 +1025,11 @@ var Eval = class _Eval {
 
 Object.defineProperty(exports, "JsonlParseError", {
   enumerable: true,
-  get: function () { return chunkUU36SHFY_cjs.JsonlParseError; }
+  get: function () { return chunkBJUJT5ED_cjs.JsonlParseError; }
 });
 Object.defineProperty(exports, "loadJsonl", {
   enumerable: true,
-  get: function () { return chunkUU36SHFY_cjs.loadJsonl; }
+  get: function () { return chunkBJUJT5ED_cjs.loadJsonl; }
 });
 exports.Eval = Eval;
 exports.EvalAlreadyRunningError = EvalAlreadyRunningError;