@theokit/sdk 4.53.0 → 4.53.1

package/dist/generate-object-TVQCW2IZ.js

@@ -1,7 +0,0 @@
-export { GenerateObjectError, generateObjectImpl } from './chunk-PLUCC4N5.js';
-import './chunk-I732VEDW.js';
-import './chunk-4VPXM6UU.js';
-import './chunk-HI4ZW62S.js';
-import './chunk-4X3SBHPK.js';
-//# sourceMappingURL=generate-object-TVQCW2IZ.js.map
-//# sourceMappingURL=generate-object-TVQCW2IZ.js.map

package/dist/index-manager-EA6FGIQG.js

@@ -1,12 +0,0 @@
-export { IndexManager } from './chunk-NOS7PTKP.js';
-import './chunk-OXNYIMZZ.js';
-import './chunk-FD2UT76F.js';
-import './chunk-W4FV7JBH.js';
-import './chunk-2XLKLVVR.js';
-import './chunk-CHVSMEKM.js';
-import './chunk-XWCTBGYK.js';
-import './chunk-RIAM53CP.js';
-import './chunk-HI4ZW62S.js';
-import './chunk-4X3SBHPK.js';
-//# sourceMappingURL=index-manager-EA6FGIQG.js.map
-//# sourceMappingURL=index-manager-EA6FGIQG.js.map

package/dist/index-manager-HGGL4DD5.cjs

@@ -1,21 +0,0 @@
-'use strict';
-
-var chunkEQMLJ52C_cjs = require('./chunk-EQMLJ52C.cjs');
-require('./chunk-2RW7K6FN.cjs');
-require('./chunk-MUUQ2WFJ.cjs');
-require('./chunk-QLAWEGTZ.cjs');
-require('./chunk-YLQQX5W2.cjs');
-require('./chunk-2CFEET3Y.cjs');
-require('./chunk-YTO5BRBD.cjs');
-require('./chunk-VKJ7V7EB.cjs');
-require('./chunk-2YGIBOUH.cjs');
-require('./chunk-SXSPMRSV.cjs');
-
-
-
-Object.defineProperty(exports, "IndexManager", {
-  enumerable: true,
-  get: function () { return chunkEQMLJ52C_cjs.IndexManager; }
-});
-//# sourceMappingURL=index-manager-HGGL4DD5.cjs.map
-//# sourceMappingURL=index-manager-HGGL4DD5.cjs.map

package/dist/judge-call-GVIJWQVE.cjs

@@ -1,22 +0,0 @@
-'use strict';
-
-var chunkBWGXYOBZ_cjs = require('./chunk-BWGXYOBZ.cjs');
-require('./chunk-2YGIBOUH.cjs');
-require('./chunk-SXSPMRSV.cjs');
-
-
-
-Object.defineProperty(exports, "JudgeCredentialError", {
-  enumerable: true,
-  get: function () { return chunkBWGXYOBZ_cjs.JudgeCredentialError; }
-});
-Object.defineProperty(exports, "composeJudgePrompt", {
-  enumerable: true,
-  get: function () { return chunkBWGXYOBZ_cjs.composeJudgePrompt; }
-});
-Object.defineProperty(exports, "judgeCallImpl", {
-  enumerable: true,
-  get: function () { return chunkBWGXYOBZ_cjs.judgeCallImpl; }
-});
-//# sourceMappingURL=judge-call-GVIJWQVE.cjs.map
-//# sourceMappingURL=judge-call-GVIJWQVE.cjs.map

package/dist/judge-call-QMKGC2ZK.js

@@ -1,5 +0,0 @@
-export { JudgeCredentialError, composeJudgePrompt, judgeCallImpl } from './chunk-N43XLTHZ.js';
-import './chunk-HI4ZW62S.js';
-import './chunk-4X3SBHPK.js';
-//# sourceMappingURL=judge-call-QMKGC2ZK.js.map
-//# sourceMappingURL=judge-call-QMKGC2ZK.js.map

package/dist/registry-GC7BQMSV.js

@@ -1,9 +0,0 @@
-export { __getSubscribersCountForTests, __resetTaskRegistryForTests, cancel, configure, get, list, submit, subscribe } from './chunk-7TB5U7RK.js';
-import './chunk-K2BQQ445.js';
-import './chunk-ZSJPRPN7.js';
-import './chunk-JJZ4NIAG.js';
-import './chunk-CHVSMEKM.js';
-import './chunk-HI4ZW62S.js';
-import './chunk-4X3SBHPK.js';
-//# sourceMappingURL=registry-GC7BQMSV.js.map
-//# sourceMappingURL=registry-GC7BQMSV.js.map

package/dist/registry-UBY26R4I.cjs

@@ -1,46 +0,0 @@
-'use strict';
-
-var chunk6DCTL32L_cjs = require('./chunk-6DCTL32L.cjs');
-require('./chunk-BUUUWQMB.cjs');
-require('./chunk-NFATC6ZF.cjs');
-require('./chunk-7HQVDLFI.cjs');
-require('./chunk-2CFEET3Y.cjs');
-require('./chunk-2YGIBOUH.cjs');
-require('./chunk-SXSPMRSV.cjs');
-
-
-
-Object.defineProperty(exports, "__getSubscribersCountForTests", {
-  enumerable: true,
-  get: function () { return chunk6DCTL32L_cjs.__getSubscribersCountForTests; }
-});
-Object.defineProperty(exports, "__resetTaskRegistryForTests", {
-  enumerable: true,
-  get: function () { return chunk6DCTL32L_cjs.__resetTaskRegistryForTests; }
-});
-Object.defineProperty(exports, "cancel", {
-  enumerable: true,
-  get: function () { return chunk6DCTL32L_cjs.cancel; }
-});
-Object.defineProperty(exports, "configure", {
-  enumerable: true,
-  get: function () { return chunk6DCTL32L_cjs.configure; }
-});
-Object.defineProperty(exports, "get", {
-  enumerable: true,
-  get: function () { return chunk6DCTL32L_cjs.get; }
-});
-Object.defineProperty(exports, "list", {
-  enumerable: true,
-  get: function () { return chunk6DCTL32L_cjs.list; }
-});
-Object.defineProperty(exports, "submit", {
-  enumerable: true,
-  get: function () { return chunk6DCTL32L_cjs.submit; }
-});
-Object.defineProperty(exports, "subscribe", {
-  enumerable: true,
-  get: function () { return chunk6DCTL32L_cjs.subscribe; }
-});
-//# sourceMappingURL=registry-UBY26R4I.cjs.map
-//# sourceMappingURL=registry-UBY26R4I.cjs.map

package/dist/session-transcript-SKIRBEJE.js

@@ -1,5 +0,0 @@
-export { SessionTranscript, defaultBaseDir, encodeProjectDir, expandTilde, readTranscript, reconstructMessages, safeSessionId, transcriptPath, transcriptRoot, writeTranscript } from './chunk-C4EU627W.js';
-import './chunk-CHVSMEKM.js';
-import './chunk-4X3SBHPK.js';
-//# sourceMappingURL=session-transcript-SKIRBEJE.js.map
-//# sourceMappingURL=session-transcript-SKIRBEJE.js.map

package/dist/session-transcript-TNAJ4O3M.cjs

@@ -1,50 +0,0 @@
-'use strict';
-
-var chunkECPL5RV6_cjs = require('./chunk-ECPL5RV6.cjs');
-require('./chunk-2CFEET3Y.cjs');
-require('./chunk-SXSPMRSV.cjs');
-
-
-
-Object.defineProperty(exports, "SessionTranscript", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.SessionTranscript; }
-});
-Object.defineProperty(exports, "defaultBaseDir", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.defaultBaseDir; }
-});
-Object.defineProperty(exports, "encodeProjectDir", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.encodeProjectDir; }
-});
-Object.defineProperty(exports, "expandTilde", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.expandTilde; }
-});
-Object.defineProperty(exports, "readTranscript", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.readTranscript; }
-});
-Object.defineProperty(exports, "reconstructMessages", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.reconstructMessages; }
-});
-Object.defineProperty(exports, "safeSessionId", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.safeSessionId; }
-});
-Object.defineProperty(exports, "transcriptPath", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.transcriptPath; }
-});
-Object.defineProperty(exports, "transcriptRoot", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.transcriptRoot; }
-});
-Object.defineProperty(exports, "writeTranscript", {
-  enumerable: true,
-  get: function () { return chunkECPL5RV6_cjs.writeTranscript; }
-});
-//# sourceMappingURL=session-transcript-TNAJ4O3M.cjs.map
-//# sourceMappingURL=session-transcript-TNAJ4O3M.cjs.map

package/dist/stream-object-QMNR3YFF.js

@@ -1,7 +0,0 @@
-export { StreamObjectError, streamObjectImpl } from './chunk-E6T264NS.js';
-import './chunk-I732VEDW.js';
-import './chunk-4VPXM6UU.js';
-import './chunk-HI4ZW62S.js';
-import './chunk-4X3SBHPK.js';
-//# sourceMappingURL=stream-object-QMNR3YFF.js.map
-//# sourceMappingURL=stream-object-QMNR3YFF.js.map

package/dist/stream-object-T4DAMNVB.cjs

@@ -1,20 +0,0 @@
-'use strict';
-
-var chunkV45L2OYP_cjs = require('./chunk-V45L2OYP.cjs');
-require('./chunk-EUBGGYPH.cjs');
-require('./chunk-WJVHMTKB.cjs');
-require('./chunk-2YGIBOUH.cjs');
-require('./chunk-SXSPMRSV.cjs');
-
-
-
-Object.defineProperty(exports, "StreamObjectError", {
-  enumerable: true,
-  get: function () { return chunkV45L2OYP_cjs.StreamObjectError; }
-});
-Object.defineProperty(exports, "streamObjectImpl", {
-  enumerable: true,
-  get: function () { return chunkV45L2OYP_cjs.streamObjectImpl; }
-});
-//# sourceMappingURL=stream-object-T4DAMNVB.cjs.map
-//# sourceMappingURL=stream-object-T4DAMNVB.cjs.map

package/dist/subagents-loader-3CXBQWWY.cjs

@@ -1,15 +0,0 @@
-'use strict';
-
-var chunkRTLUZKDL_cjs = require('./chunk-RTLUZKDL.cjs');
-require('./chunk-44IISBRZ.cjs');
-require('./chunk-2YGIBOUH.cjs');
-require('./chunk-SXSPMRSV.cjs');
-
-
-
-Object.defineProperty(exports, "loadSubagents", {
-  enumerable: true,
-  get: function () { return chunkRTLUZKDL_cjs.loadSubagents; }
-});
-//# sourceMappingURL=subagents-loader-3CXBQWWY.cjs.map
-//# sourceMappingURL=subagents-loader-3CXBQWWY.cjs.map

package/dist/subagents-loader-WN2SB6PV.js

@@ -1,6 +0,0 @@
-export { loadSubagents } from './chunk-XGYI2KQH.js';
-import './chunk-5XXUYU3M.js';
-import './chunk-HI4ZW62S.js';
-import './chunk-4X3SBHPK.js';
-//# sourceMappingURL=subagents-loader-WN2SB6PV.js.map
-//# sourceMappingURL=subagents-loader-WN2SB6PV.js.map

package/docs/error-codes.md

@@ -1,179 +0,0 @@
----
-type: Error Reference
-title: AgentRunError code reference
-description: The canonical AgentRunError.code union plus the provider-to-code mapping for OpenAI, Anthropic, Vertex, Bedrock and Ollama.
-resource: https://github.com/usetheodev/theokit-sdk/blob/main/wiki/reference/error-codes.md
-tags: [errors, providers, retry, shipped-to-npm]
-generated: { by: human:paulohenriquevn, at: 2026-08-05T00:00:00Z }
-status: stable
-sources:
-  - id: mappers
-    resource: packages/sdk/src/internal/error-mappers/
-    title: Per-provider mapping implementations — the authoritative list
-  - id: adrs
-    resource: ADRs D311-D314, D65-D68
-    title: Error-system architecture decisions
----
-
-# `@theokit/sdk` Error Codes Reference
-
-Canonical reference for `AgentRunError.code` values + provider-to-code mapping (Production-Readiness #3, ADRs D311-D314).
-
-## `AgentRunErrorCode` union (16 codes)
-
-| Code | Origin | Retriable | When |
-|---|---|:---:|---|
-| `auth_failed` | provider HTTP 401/403 | no | bad API key, revoked token |
-| `rate_limit` | provider HTTP 429 | **yes** | back off using `retryAfterMs` |
-| `quota_exceeded` | provider HTTP 402 / billing body code | no | billing limit hit |
-| `invalid_request` | provider HTTP 400 (generic) | no | malformed payload |
-| `invalid_model` | provider HTTP 400 + "model not found" | no | model id wrong/unavailable |
-| `context_too_long` | provider 400 + context_length code | no | input exceeds model window |
-| `content_filtered` | provider safety filter | no | safety filter blocked |
-| `safety_blocked` | provider safety filter (alias) | no | reserved for stricter mapping |
-| `model_unavailable` | provider 400 + model_unavailable code | no | model temporarily unavailable |
-| `timeout` | HTTP 408 | **yes** | retry with backoff |
-| `network` | DNS/TCP/transport | **yes** | retry with backoff |
-| `server_error` | HTTP 5xx | **yes** | retry with backoff |
-| `provider_unreachable` | DNS/TCP/timeout/5xx (alias) | **yes** | reserved for stricter mapping |
-| `tool_runtime_error` | tool handler throw inside dispatch | no | bug in handler |
-| `aborted` | `AbortSignal` fired (Phase 4) | no | user/lifecycle cancel |
-| `unknown` | unmapped | no | provider returned shape we don't recognize |
-
-## Exhaustive `switch` pattern
-
-```ts
-import { AgentRunError } from "@theokit/sdk";
-
-try {
-  await agent.send(message);
-} catch (err) {
-  if (!(err instanceof AgentRunError)) throw err;
-  switch (err.code) {
-    case "auth_failed":
-      // bad key — show login UI
-      break;
-    case "rate_limit":
-      if (err.retryAfterMs !== undefined) {
-        setTimeout(retry, err.retryAfterMs);
-      }
-      break;
-    case "quota_exceeded":
-      // billing — upsell page
-      break;
-    case "tool_runtime_error":
-      // handler bug — log + tell user
-      break;
-    case "aborted":
-      // user cancelled — no UI noise
-      break;
-    default:
-      // unknown / new code — generic fallback
-      break;
-  }
-}
-```
-
-## Provider mapping table
-
-### OpenAI (and OpenAI-compat: OpenRouter, DeepSeek, Together, Mistral, Voyage, DeepInfra)
-
-| Status | Body hint | → ErrorCode | → AgentRunErrorCode |
-|---|---|---|---|
-| 401 / 403 | any | `auth_failed` | `auth_failed` |
-| 429 | any | `rate_limit` | `rate_limit` |
-| 402 | any | `invalid_request` | `quota_exceeded` (at AgentRunError layer) |
-| 400 | `code: "context_length_exceeded"` | `context_too_long` | `context_too_long` |
-| 400 | `code: "content_policy_violation"` | `content_filtered` | `content_filtered` |
-| 400 | `code: "model_not_found"` | `model_unavailable` | `model_unavailable` |
-| 400 | `code: "insufficient_quota"` | `invalid_request` | `quota_exceeded` |
-| 400 | other | `invalid_request` | `invalid_request` |
-| 408 | any | `timeout` | `timeout` |
-| 5xx | any | `server_error` | `server_error` |
-| other | any | `unknown` | `unknown` |
-
-### Anthropic
-
-Same status-based map as OpenAI. Body code hints are dialect-specific (`overloaded_error` → `server_error`, etc.) — see `internal/error-mappers/anthropic.ts` for the authoritative list.
-
-### Vertex AI
-
-| GCP status | Canonical | Code |
-|---|---|---|
-| `429` / `RESOURCE_EXHAUSTED` | `RateLimitError` | `rate_limit` |
-| `401` / `UNAUTHENTICATED` | `AuthenticationError` | `auth_failed` |
-| `403` / `PERMISSION_DENIED` | `AuthenticationError` | `auth_failed` |
-| `400` / `INVALID_ARGUMENT` | `ConfigurationError` | `invalid_request` |
-| `408` / `DEADLINE_EXCEEDED` | `NetworkError` | `timeout` |
-| `5xx` | `NetworkError` | `server_error` |
-| other | `UnknownAgentError` | `unknown` |
-
-### Bedrock
-
-| AWS status / type | Canonical | Code |
-|---|---|---|
-| 429 / `ThrottlingException` | `RateLimitError` | `rate_limit` |
-| 401/403 / `AccessDeniedException` | `AuthenticationError` | `auth_failed` |
-| 400 / `ValidationException` | `ConfigurationError` | `invalid_request` |
-| 5xx | `NetworkError` | `server_error` |
-
-### Ollama (local)
-
-| Failure mode | Code |
-|---|---|
-| Connection refused | `network` |
-| Timeout | `timeout` |
-| Unknown response | `unknown` |
-
-Ollama has no billing, no rate limit, no auth → `quota_exceeded`/`rate_limit`/`auth_failed` never fire.
-
-## Fields
-
-```ts
-class AgentRunError extends TheokitAgentError {
-  readonly code: AgentRunErrorCode;
-  readonly provider?: string;
-  readonly raw?: string;
-  readonly requestId?: string;      // x-request-id / request-id header
-  readonly conversationId?: string; // SDK agentId where error fired
-
-  get retriable(): boolean;          // alias for isRetryable
-  get retryAfterMs(): number | undefined;  // metadata.retryAfter * 1000
-  get providerError(): unknown;       // metadata.raw alias
-
-  readonly metadata?: ErrorMetadata;  // full structured context
-}
-```
-
-## `retryAfterMs` semantics
-
-Returns milliseconds derived from `metadata.retryAfter` (seconds). Use with `setTimeout`:
-
-```ts
-if (err.retryAfterMs !== undefined) {
-  setTimeout(retry, err.retryAfterMs);
-}
-```
-
-**EC-11: Use `=== undefined` check, NOT truthy check.** `retryAfterMs === 0` is a legitimate value (provider asked for immediate retry — `setTimeout(0)` is valid).
-
-## Anti-leak invariant
-
-`AgentRunError.message` NEVER contains `providerError` content (raw response body may carry sensitive data — internal field names, log fragments, etc). To inspect the raw body:
-
-```ts
-console.log(err.providerError);    // alias for err.metadata?.raw
-console.log(err.metadata?.raw);    // same value (already redacted via D68)
-```
-
-The redacted body is safe to log — `redactSecrets` strips known secret patterns (API keys, JWT, Authorization headers).
-
-## See also
-
-- `internal/error-mappers/` — per-provider mapping implementations
-- ADRs D311-D314, D65-D68 (the broader error system)
-- [Capability map](./harness-capability-map.md) — where the error classes are exported from
-
-In the wiki: [failure taxonomy](https://github.com/usetheodev/theokit-sdk/blob/main/wiki/sdk/failure-taxonomy.md) turns these codes into a
-response policy (retry vs fail-fast), and [run signals](https://github.com/usetheodev/theokit-sdk/blob/main/wiki/sdk/run-signals.md) places
-`error` among the seven ways a run can end.