@theokit/sdk 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/CHANGELOG.md +1571 -0
  2. package/LICENSE +201 -0
  3. package/README.md +80 -0
  4. package/bin/theokit-migrate-config.mjs +269 -0
  5. package/bin/theokit-migrate-memory.mjs +116 -0
  6. package/dist/agent-builder.d.ts +52 -0
  7. package/dist/agent-factory.d.ts +39 -0
  8. package/dist/agent.d.ts +175 -0
  9. package/dist/batch.d.ts +11 -0
  10. package/dist/budget.d.ts +48 -0
  11. package/dist/cache.d.ts +74 -0
  12. package/dist/cron-1yxL3K2S.d.cts +221 -0
  13. package/dist/cron-BYVdYzob.d.ts +221 -0
  14. package/dist/cron.cjs +14655 -0
  15. package/dist/cron.cjs.map +1 -0
  16. package/dist/cron.d.cts +3 -0
  17. package/dist/cron.d.ts +71 -0
  18. package/dist/cron.js +14652 -0
  19. package/dist/cron.js.map +1 -0
  20. package/dist/define-tool.d.ts +35 -0
  21. package/dist/errors-CK8brCJ1.d.cts +448 -0
  22. package/dist/errors-CvAeEWgE.d.ts +448 -0
  23. package/dist/errors.cjs +255 -0
  24. package/dist/errors.cjs.map +1 -0
  25. package/dist/errors.d.cts +3 -0
  26. package/dist/errors.d.ts +356 -0
  27. package/dist/errors.js +238 -0
  28. package/dist/errors.js.map +1 -0
  29. package/dist/eval.cjs +14826 -0
  30. package/dist/eval.cjs.map +1 -0
  31. package/dist/eval.d.cts +35 -0
  32. package/dist/eval.d.ts +35 -0
  33. package/dist/eval.js +14821 -0
  34. package/dist/eval.js.map +1 -0
  35. package/dist/generate-object.d.ts +67 -0
  36. package/dist/handoff.d.ts +55 -0
  37. package/dist/index.cjs +17127 -0
  38. package/dist/index.cjs.map +1 -0
  39. package/dist/index.d.cts +1878 -0
  40. package/dist/index.d.ts +24 -0
  41. package/dist/index.js +17095 -0
  42. package/dist/index.js.map +1 -0
  43. package/dist/internal/agent-loop/loop-types.d.ts +29 -0
  44. package/dist/internal/agent-loop/loop.d.ts +2 -0
  45. package/dist/internal/agent-loop/message-builders.d.ts +6 -0
  46. package/dist/internal/agent-loop/tool-dispatch.d.ts +4 -0
  47. package/dist/internal/agent-loop/usage-and-cost.d.ts +25 -0
  48. package/dist/internal/budget/calendar-window.d.ts +19 -0
  49. package/dist/internal/budget/compute-cost.d.ts +28 -0
  50. package/dist/internal/budget/enforcement.d.ts +32 -0
  51. package/dist/internal/budget/ledger.d.ts +25 -0
  52. package/dist/internal/budget/normalize-usage.d.ts +27 -0
  53. package/dist/internal/budget/pricing-registry.d.ts +36 -0
  54. package/dist/internal/budget/registry.d.ts +16 -0
  55. package/dist/internal/budget/usage-accumulator.d.ts +31 -0
  56. package/dist/internal/cache/cosine.d.ts +14 -0
  57. package/dist/internal/cache/embed-helper.d.ts +15 -0
  58. package/dist/internal/cache/key.d.ts +15 -0
  59. package/dist/internal/cache/lookup.d.ts +28 -0
  60. package/dist/internal/cache/store-handler.d.ts +24 -0
  61. package/dist/internal/cache/store-json.d.ts +48 -0
  62. package/dist/internal/cache/store.d.ts +54 -0
  63. package/dist/internal/cache/telemetry.d.ts +20 -0
  64. package/dist/internal/cache/ttl.d.ts +11 -0
  65. package/dist/internal/catalog/fixtures.d.ts +16 -0
  66. package/dist/internal/catalog/local-models.d.ts +24 -0
  67. package/dist/internal/cron/run-job.d.ts +1 -0
  68. package/dist/internal/cron/scheduler.d.ts +1 -0
  69. package/dist/internal/cron/store.d.ts +1 -0
  70. package/dist/internal/cron/validate.d.ts +1 -0
  71. package/dist/internal/env.d.ts +1 -0
  72. package/dist/internal/errors/mappers/anthropic.d.ts +30 -0
  73. package/dist/internal/errors/mappers/bedrock.d.ts +16 -0
  74. package/dist/internal/errors/mappers/ollama.d.ts +41 -0
  75. package/dist/internal/errors/mappers/openai-compatible.d.ts +25 -0
  76. package/dist/internal/errors/mappers/shared.d.ts +10 -0
  77. package/dist/internal/errors/mappers/vertex.d.ts +15 -0
  78. package/dist/internal/eval/aggregate.d.ts +9 -0
  79. package/dist/internal/eval/dataset-iter.d.ts +9 -0
  80. package/dist/internal/eval/runner.d.ts +9 -0
  81. package/dist/internal/eval/single-flight.d.ts +16 -0
  82. package/dist/internal/eval/telemetry.d.ts +23 -0
  83. package/dist/internal/fixture-mode.d.ts +16 -0
  84. package/dist/internal/handoff/dispatcher.d.ts +29 -0
  85. package/dist/internal/handoff/registry.d.ts +23 -0
  86. package/dist/internal/handoff/telemetry.d.ts +18 -0
  87. package/dist/internal/handoff/tool-injector.d.ts +34 -0
  88. package/dist/internal/http.d.ts +1 -0
  89. package/dist/internal/ids.d.ts +1 -0
  90. package/dist/internal/judge/judge-call.d.ts +35 -0
  91. package/dist/internal/judge/parse-verdict.d.ts +11 -0
  92. package/dist/internal/judge/types.d.ts +17 -0
  93. package/dist/internal/llm/anthropic-shared.d.ts +89 -0
  94. package/dist/internal/llm/anthropic.d.ts +9 -0
  95. package/dist/internal/llm/bedrock-anthropic.d.ts +36 -0
  96. package/dist/internal/llm/bedrock-token-cache.d.ts +18 -0
  97. package/dist/internal/llm/credential-pool-context.d.ts +11 -0
  98. package/dist/internal/llm/credential-pool-types.d.ts +22 -0
  99. package/dist/internal/llm/credential-pool.d.ts +18 -0
  100. package/dist/internal/llm/fallback-client.d.ts +1 -0
  101. package/dist/internal/llm/fault-injection.d.ts +50 -0
  102. package/dist/internal/llm/finish.d.ts +1 -0
  103. package/dist/internal/llm/model-identifier.d.ts +24 -0
  104. package/dist/internal/llm/ollama-native.d.ts +27 -0
  105. package/dist/internal/llm/openai.d.ts +9 -0
  106. package/dist/internal/llm/pool-aware-client.d.ts +16 -0
  107. package/dist/internal/llm/router.d.ts +17 -0
  108. package/dist/internal/llm/sse.d.ts +9 -0
  109. package/dist/internal/llm/stream-relay.d.ts +17 -0
  110. package/dist/internal/llm/types.d.ts +70 -0
  111. package/dist/internal/llm/vertex-anthropic.d.ts +40 -0
  112. package/dist/internal/llm/vertex-auth.d.ts +30 -0
  113. package/dist/internal/llm/vertex-gemini.d.ts +28 -0
  114. package/dist/internal/llm/vertex-router.d.ts +21 -0
  115. package/dist/internal/mcp/client.d.ts +16 -0
  116. package/dist/internal/memory/active-memory-cache.d.ts +10 -0
  117. package/dist/internal/memory/active-memory.d.ts +45 -0
  118. package/dist/internal/memory/adapters/catalog.d.ts +1 -0
  119. package/dist/internal/memory/adapters/deepinfra-embedding.d.ts +2 -0
  120. package/dist/internal/memory/adapters/mistral-embedding.d.ts +2 -0
  121. package/dist/internal/memory/adapters/ollama-embedding.d.ts +34 -0
  122. package/dist/internal/memory/adapters/openai-compatible.d.ts +23 -0
  123. package/dist/internal/memory/adapters/openai-embedding.d.ts +2 -0
  124. package/dist/internal/memory/adapters/openrouter-embedding.d.ts +2 -0
  125. package/dist/internal/memory/adapters/voyage-embedding.d.ts +2 -0
  126. package/dist/internal/memory/atomic-write.d.ts +7 -0
  127. package/dist/internal/memory/chunk-markdown.d.ts +2 -0
  128. package/dist/internal/memory/circuit-breaker.d.ts +22 -0
  129. package/dist/internal/memory/cwd-mutex.d.ts +1 -0
  130. package/dist/internal/memory/dreaming/diary.d.ts +4 -0
  131. package/dist/internal/memory/dreaming/phases.d.ts +15 -0
  132. package/dist/internal/memory/dreaming/run.d.ts +10 -0
  133. package/dist/internal/memory/embedding-adapter.d.ts +42 -0
  134. package/dist/internal/memory/embedding-cache.d.ts +1 -0
  135. package/dist/internal/memory/index-db.d.ts +10 -0
  136. package/dist/internal/memory/index-manager-dispatch.d.ts +23 -0
  137. package/dist/internal/memory/index-manager.d.ts +68 -0
  138. package/dist/internal/memory/index-schema.d.ts +21 -0
  139. package/dist/internal/memory/lance-index.d.ts +32 -0
  140. package/dist/internal/memory/lance-memory-adapter.d.ts +43 -0
  141. package/dist/internal/memory/markdown-store.d.ts +16 -0
  142. package/dist/internal/memory/memory-index.d.ts +52 -0
  143. package/dist/internal/memory/migrate-sqlite-to-lance.d.ts +15 -0
  144. package/dist/internal/memory/migration.d.ts +9 -0
  145. package/dist/internal/memory/reader.d.ts +8 -0
  146. package/dist/internal/memory/session-loader.d.ts +1 -0
  147. package/dist/internal/memory/session-summary-writer.d.ts +2 -0
  148. package/dist/internal/memory/sqlite-vec-loader.d.ts +3 -0
  149. package/dist/internal/memory/tools.d.ts +14 -0
  150. package/dist/internal/memory/transcript-store.d.ts +1 -0
  151. package/dist/internal/memory/types.d.ts +17 -0
  152. package/dist/internal/memory/vec-index.d.ts +28 -0
  153. package/dist/internal/memory/wiki-loader.d.ts +2 -0
  154. package/dist/internal/observability/tracer-loader.d.ts +20 -0
  155. package/dist/internal/persistence/atomic-write.d.ts +1 -0
  156. package/dist/internal/persistence/conversation-storage-fs.d.ts +37 -0
  157. package/dist/internal/persistence/conversation-storage-memory.d.ts +24 -0
  158. package/dist/internal/persistence/cwd-mutex.d.ts +1 -0
  159. package/dist/internal/persistence/file-lock.d.ts +14 -0
  160. package/dist/internal/persistence/fts5-sanitize.d.ts +16 -0
  161. package/dist/internal/persistence/markdown-config-loader.d.ts +35 -0
  162. package/dist/internal/persistence/paths.d.ts +19 -0
  163. package/dist/internal/persistence/persistence-schema.d.ts +17 -0
  164. package/dist/internal/persistence/schema-version.d.ts +13 -0
  165. package/dist/internal/persistence/sqlite-wal.d.ts +10 -0
  166. package/dist/internal/personality/context.d.ts +17 -0
  167. package/dist/internal/personality/registry.d.ts +17 -0
  168. package/dist/internal/personality/store.d.ts +27 -0
  169. package/dist/internal/personality/switch.d.ts +36 -0
  170. package/dist/internal/personality/types.d.ts +18 -0
  171. package/dist/internal/plugins/context.d.ts +31 -0
  172. package/dist/internal/plugins/manager.d.ts +37 -0
  173. package/dist/internal/plugins/types.d.ts +102 -0
  174. package/dist/internal/providers/builtin/anthropic.d.ts +2 -0
  175. package/dist/internal/providers/builtin/bedrock.d.ts +25 -0
  176. package/dist/internal/providers/builtin/gemini.d.ts +10 -0
  177. package/dist/internal/providers/builtin/index.d.ts +19 -0
  178. package/dist/internal/providers/builtin/llamacpp.d.ts +1 -0
  179. package/dist/internal/providers/builtin/lmstudio.d.ts +1 -0
  180. package/dist/internal/providers/builtin/ollama.d.ts +17 -0
  181. package/dist/internal/providers/builtin/openai.d.ts +2 -0
  182. package/dist/internal/providers/builtin/openrouter.d.ts +2 -0
  183. package/dist/internal/providers/builtin/vertex.d.ts +27 -0
  184. package/dist/internal/providers/discovery.d.ts +14 -0
  185. package/dist/internal/providers/index.d.ts +8 -0
  186. package/dist/internal/providers/registry.d.ts +12 -0
  187. package/dist/internal/providers/types.d.ts +27 -0
  188. package/dist/internal/runtime/abort-utils.d.ts +21 -0
  189. package/dist/internal/runtime/agent-factory-registry.d.ts +16 -0
  190. package/dist/internal/runtime/agent-registry-store.d.ts +61 -0
  191. package/dist/internal/runtime/agent-registry.d.ts +34 -0
  192. package/dist/internal/runtime/agent-session-store.d.ts +3 -0
  193. package/dist/internal/runtime/agent-session.d.ts +2 -0
  194. package/dist/internal/runtime/async-local-storage.d.ts +20 -0
  195. package/dist/internal/runtime/async-semaphore.d.ts +24 -0
  196. package/dist/internal/runtime/budget.d.ts +36 -0
  197. package/dist/internal/runtime/cloud-agent.d.ts +1 -0
  198. package/dist/internal/runtime/cloud-config-serializer.d.ts +3 -0
  199. package/dist/internal/runtime/cloud-payload-types.d.ts +56 -0
  200. package/dist/internal/runtime/cloud-run.d.ts +1 -0
  201. package/dist/internal/runtime/cloud-tool-parity.d.ts +1 -0
  202. package/dist/internal/runtime/context-aggregator.d.ts +26 -0
  203. package/dist/internal/runtime/context-discovery-runner.d.ts +27 -0
  204. package/dist/internal/runtime/context-discovery.d.ts +21 -0
  205. package/dist/internal/runtime/context-frontmatter.d.ts +16 -0
  206. package/dist/internal/runtime/context-import-resolver.d.ts +24 -0
  207. package/dist/internal/runtime/context-loaders.d.ts +42 -0
  208. package/dist/internal/runtime/context-manager.d.ts +11 -0
  209. package/dist/internal/runtime/context-mdc-parser.d.ts +24 -0
  210. package/dist/internal/runtime/default-model.d.ts +1 -0
  211. package/dist/internal/runtime/fixture-events.d.ts +12 -0
  212. package/dist/internal/runtime/fixture-responder.d.ts +1 -0
  213. package/dist/internal/runtime/fixture-run-base.d.ts +45 -0
  214. package/dist/internal/runtime/fixture-scripts.d.ts +21 -0
  215. package/dist/internal/runtime/fixture-types.d.ts +1 -0
  216. package/dist/internal/runtime/fork-agent.d.ts +15 -0
  217. package/dist/internal/runtime/hooks-executor.d.ts +35 -0
  218. package/dist/internal/runtime/hooks-frontmatter.d.ts +26 -0
  219. package/dist/internal/runtime/hooks-source.d.ts +22 -0
  220. package/dist/internal/runtime/live-agent-registry.d.ts +87 -0
  221. package/dist/internal/runtime/local-agent-bootstrap.d.ts +37 -0
  222. package/dist/internal/runtime/local-agent-dispatch.d.ts +57 -0
  223. package/dist/internal/runtime/local-agent-invalidate.d.ts +8 -0
  224. package/dist/internal/runtime/local-agent-memory-direct.d.ts +12 -0
  225. package/dist/internal/runtime/local-agent-memory-hooks.d.ts +41 -0
  226. package/dist/internal/runtime/local-agent-memory.d.ts +1 -0
  227. package/dist/internal/runtime/local-agent-personality-extensions.d.ts +19 -0
  228. package/dist/internal/runtime/local-agent-plugins.d.ts +13 -0
  229. package/dist/internal/runtime/local-agent-runtime-extensions.d.ts +13 -0
  230. package/dist/internal/runtime/local-agent-task-wrap.d.ts +11 -0
  231. package/dist/internal/runtime/local-agent.d.ts +1 -0
  232. package/dist/internal/runtime/local-run.d.ts +1 -0
  233. package/dist/internal/runtime/memory-store.d.ts +4 -0
  234. package/dist/internal/runtime/plugin-frontmatter.d.ts +17 -0
  235. package/dist/internal/runtime/plugins-manager.d.ts +1 -0
  236. package/dist/internal/runtime/post-run-lifecycle.d.ts +1 -0
  237. package/dist/internal/runtime/providers-manager.d.ts +1 -0
  238. package/dist/internal/runtime/real-cloud-run.d.ts +2 -0
  239. package/dist/internal/runtime/real-local-run.d.ts +2 -0
  240. package/dist/internal/runtime/run-registry.d.ts +5 -0
  241. package/dist/internal/runtime/run-until.d.ts +22 -0
  242. package/dist/internal/runtime/shell-tool.d.ts +7 -0
  243. package/dist/internal/runtime/skill-frontmatter.d.ts +1 -0
  244. package/dist/internal/runtime/skills-manager.d.ts +1 -0
  245. package/dist/internal/runtime/spawn-collect.d.ts +8 -0
  246. package/dist/internal/runtime/subagents-loader.d.ts +1 -0
  247. package/dist/internal/runtime/system-prompt/escape.d.ts +1 -0
  248. package/dist/internal/runtime/system-prompt/local-assembly.d.ts +1 -0
  249. package/dist/internal/runtime/system-prompt/pipeline.d.ts +1 -0
  250. package/dist/internal/runtime/system-prompt/providers/active-memory-provider.d.ts +1 -0
  251. package/dist/internal/runtime/system-prompt/providers/base-provider.d.ts +1 -0
  252. package/dist/internal/runtime/system-prompt/providers/context-provider.d.ts +1 -0
  253. package/dist/internal/runtime/system-prompt/providers/memory-provider.d.ts +1 -0
  254. package/dist/internal/runtime/system-prompt/providers/skills-provider.d.ts +1 -0
  255. package/dist/internal/runtime/system-prompt/safe-call.d.ts +1 -0
  256. package/dist/internal/runtime/system-prompt/types.d.ts +5 -0
  257. package/dist/internal/runtime/system-prompt.d.ts +1 -0
  258. package/dist/internal/runtime/validate-agent-options.d.ts +1 -0
  259. package/dist/internal/runtime/workspace-dir.d.ts +9 -0
  260. package/dist/internal/runtime/yaml-frontmatter.d.ts +20 -0
  261. package/dist/internal/scorers/llm-judge.d.ts +24 -0
  262. package/dist/internal/security/index.d.ts +11 -0
  263. package/dist/internal/security/path-guard.d.ts +56 -0
  264. package/dist/internal/security/redact.d.ts +21 -0
  265. package/dist/internal/structured-output-helpers.d.ts +54 -0
  266. package/dist/internal/task/registry.d.ts +61 -0
  267. package/dist/internal/task/ring-buffer.d.ts +10 -0
  268. package/dist/internal/task/store.d.ts +59 -0
  269. package/dist/internal/task/subscribe.d.ts +15 -0
  270. package/dist/internal/task/telemetry.d.ts +27 -0
  271. package/dist/internal/telemetry/adapter-registry.d.ts +2 -0
  272. package/dist/internal/telemetry/adapters/langfuse.d.ts +2 -0
  273. package/dist/internal/telemetry/adapters/posthog.d.ts +2 -0
  274. package/dist/internal/telemetry/adapters/sentry.d.ts +2 -0
  275. package/dist/internal/telemetry/safe-require.d.ts +1 -0
  276. package/dist/internal/telemetry/tracer.d.ts +18 -0
  277. package/dist/internal/tool-dispatch/repair-middleware.d.ts +34 -0
  278. package/dist/internal/tool-dispatch/strip-think.d.ts +22 -0
  279. package/dist/internal/tool-registry/personality-filter.d.ts +37 -0
  280. package/dist/internal/workflow/ctx.d.ts +19 -0
  281. package/dist/internal/workflow/error-shape.d.ts +7 -0
  282. package/dist/internal/workflow/executor.d.ts +15 -0
  283. package/dist/internal/workflow/index.d.ts +12 -0
  284. package/dist/internal/workflow/retry-policy.d.ts +14 -0
  285. package/dist/internal/workflow/run-id.d.ts +9 -0
  286. package/dist/internal/workflow/single-flight.d.ts +18 -0
  287. package/dist/internal/workflow/snapshot-store.d.ts +23 -0
  288. package/dist/internal/workflow/step-agent.d.ts +12 -0
  289. package/dist/internal/workflow/step-branch.d.ts +10 -0
  290. package/dist/internal/workflow/step-dowhile.d.ts +8 -0
  291. package/dist/internal/workflow/step-fn.d.ts +10 -0
  292. package/dist/internal/workflow/step-foreach.d.ts +11 -0
  293. package/dist/internal/workflow/step-parallel.d.ts +17 -0
  294. package/dist/internal/workflow/step-sleep.d.ts +7 -0
  295. package/dist/internal/workflow/telemetry.d.ts +23 -0
  296. package/dist/internal/zod/to-json-schema.d.ts +21 -0
  297. package/dist/memory-adapter-helpers.d.ts +28 -0
  298. package/dist/memory.d.ts +123 -0
  299. package/dist/migrate.d.ts +33 -0
  300. package/dist/path-safety.cjs +126 -0
  301. package/dist/path-safety.cjs.map +1 -0
  302. package/dist/path-safety.d.cts +15 -0
  303. package/dist/path-safety.d.ts +15 -0
  304. package/dist/path-safety.js +120 -0
  305. package/dist/path-safety.js.map +1 -0
  306. package/dist/run-DkCD5DeO.d.cts +2181 -0
  307. package/dist/run-DkCD5DeO.d.ts +2181 -0
  308. package/dist/scorers.d.ts +75 -0
  309. package/dist/security.d.ts +67 -0
  310. package/dist/stream-object.d.ts +74 -0
  311. package/dist/task-store.cjs +237 -0
  312. package/dist/task-store.cjs.map +1 -0
  313. package/dist/task-store.d.cts +8 -0
  314. package/dist/task-store.d.ts +8 -0
  315. package/dist/task-store.js +233 -0
  316. package/dist/task-store.js.map +1 -0
  317. package/dist/task.d.ts +87 -0
  318. package/dist/theokit.d.ts +84 -0
  319. package/dist/tools/_path-scope.d.cts +8 -0
  320. package/dist/tools/_path-scope.d.ts +8 -0
  321. package/dist/tools/_subprocess.d.cts +28 -0
  322. package/dist/tools/_subprocess.d.ts +28 -0
  323. package/dist/tools/git-diff.d.cts +22 -0
  324. package/dist/tools/git-diff.d.ts +22 -0
  325. package/dist/tools/index.d.cts +29 -0
  326. package/dist/tools/index.d.ts +29 -0
  327. package/dist/tools/list-dir.d.cts +26 -0
  328. package/dist/tools/list-dir.d.ts +26 -0
  329. package/dist/tools/read-file.d.cts +31 -0
  330. package/dist/tools/read-file.d.ts +31 -0
  331. package/dist/tools/run-vitest.d.cts +46 -0
  332. package/dist/tools/run-vitest.d.ts +46 -0
  333. package/dist/tools/search-text.d.cts +32 -0
  334. package/dist/tools/search-text.d.ts +32 -0
  335. package/dist/tools.cjs +690 -0
  336. package/dist/tools.cjs.map +1 -0
  337. package/dist/tools.js +683 -0
  338. package/dist/tools.js.map +1 -0
  339. package/dist/trajectory-helpers.d.ts +31 -0
  340. package/dist/types/agent.d.ts +771 -0
  341. package/dist/types/batch.d.ts +112 -0
  342. package/dist/types/budget.d.ts +88 -0
  343. package/dist/types/cache.d.ts +76 -0
  344. package/dist/types/context.d.ts +93 -0
  345. package/dist/types/conversation-storage.d.ts +76 -0
  346. package/dist/types/conversation.d.ts +90 -0
  347. package/dist/types/cron.d.ts +150 -0
  348. package/dist/types/eval.d.ts +132 -0
  349. package/dist/types/goal-events.d.ts +95 -0
  350. package/dist/types/handoff.d.ts +135 -0
  351. package/dist/types/index.d.ts +20 -0
  352. package/dist/types/mcp.d.ts +64 -0
  353. package/dist/types/memory-adapter.d.ts +175 -0
  354. package/dist/types/messages.d.ts +154 -0
  355. package/dist/types/providers.d.ts +102 -0
  356. package/dist/types/run.d.ts +215 -0
  357. package/dist/types/task.d.ts +131 -0
  358. package/dist/types/theokit.d.ts +61 -0
  359. package/dist/types/trajectory.d.ts +49 -0
  360. package/dist/types/updates.d.ts +148 -0
  361. package/dist/types/usage.d.ts +61 -0
  362. package/dist/types/workflow.d.ts +217 -0
  363. package/dist/workflow.cjs +2405 -0
  364. package/dist/workflow.cjs.map +1 -0
  365. package/dist/workflow.d.cts +97 -0
  366. package/dist/workflow.d.ts +97 -0
  367. package/dist/workflow.js +2398 -0
  368. package/dist/workflow.js.map +1 -0
  369. package/package.json +183 -0
@@ -0,0 +1,448 @@
1
+ import { an as RunOperation } from './run-DkCD5DeO.js';
2
+
3
+ /**
4
+ * Public type contract for the Budget enforcement primitive
5
+ * (ADRs D375, D382-D387). The runtime facade lives in `budget.ts`.
6
+ *
7
+ * @public
8
+ */
9
+ /**
10
+ * Scope of a budget — where the charge is attributed. v1 supports
11
+ * `process` (shared global) only; `agent` and `call` reserved for
12
+ * v0.2 multi-tenant scenarios.
13
+ */
14
+ type BudgetScope = "agent" | "call" | "process";
15
+ /**
16
+ * Time window for a budget limit (D382 — UTC calendar-aligned).
17
+ * - `1h` is relative (last 60 minutes).
18
+ * - `1d` / `1w` / `30d` / `365d` are aligned to UTC calendar
19
+ * boundaries (UTC midnight / monday 00:00 UTC / 1st 00:00 UTC).
20
+ */
21
+ type BudgetWindow = "1h" | "1d" | "1w" | "30d" | "365d";
22
+ /**
23
+ * Enforcement mode (D383).
24
+ * - `audit`: log only, never throw, never block.
25
+ * - `warn`: callbacks fire at 80/95/100% thresholds; no throw.
26
+ * - `block`: preflightCheck throws `BudgetExceededError` BEFORE LLM call
27
+ * when would-exceed.
28
+ */
29
+ type BudgetMode = "audit" | "warn" | "block";
30
+ /** A single limit; stacked in an array (D384, ANY exceeded blocks). */
31
+ interface BudgetLimit {
32
+ readonly window: BudgetWindow;
33
+ readonly limitUsd: number;
34
+ }
35
+ /** Threshold event emitted at 80% and 95% in `warn` and `block` modes. */
36
+ interface BudgetThresholdEvent {
37
+ readonly budgetName: string;
38
+ readonly window: BudgetWindow;
39
+ readonly threshold: 0.8 | 0.95;
40
+ readonly spentUsd: number;
41
+ readonly limitUsd: number;
42
+ }
43
+ /** Exceed event emitted at 100% across all modes. */
44
+ interface BudgetExceedEvent {
45
+ readonly budgetName: string;
46
+ readonly window: BudgetWindow;
47
+ readonly spentUsd: number;
48
+ readonly limitUsd: number;
49
+ readonly mode: BudgetMode;
50
+ }
51
+ /** Options for `Budget.create`. */
52
+ interface BudgetOptions {
53
+ /**
54
+ * Identifier. Must match grammar `^[a-z0-9][a-z0-9_-]*$` (EC-7);
55
+ * empty/invalid → `ConfigurationError({ code: "invalid_budget_name" })`.
56
+ */
57
+ readonly name: string;
58
+ readonly scope: BudgetScope;
59
+ /**
60
+ * Stacked limits — at least one is expected for `warn`/`block`. Empty
61
+ * array (EC-19) is allowed → registry-only tracking, callbacks never
62
+ * fire.
63
+ */
64
+ readonly limits: ReadonlyArray<BudgetLimit>;
65
+ /** Default `warn` (D383). */
66
+ readonly mode?: BudgetMode;
67
+ /** Fires at 80% and 95% of any limit. Caller throws are isolated (EC-8). */
68
+ readonly onThreshold?: (event: BudgetThresholdEvent) => void | Promise<void>;
69
+ /** Fires at 100%. Caller throws are isolated (EC-8). */
70
+ readonly onExceed?: (event: BudgetExceedEvent) => void | Promise<void>;
71
+ }
72
+ /** Returned by `Budget.create` and `Budget.get` — read-only view. */
73
+ interface BudgetHandle {
74
+ readonly name: string;
75
+ readonly mode: BudgetMode;
76
+ readonly scope: BudgetScope;
77
+ readonly limits: ReadonlyArray<BudgetLimit>;
78
+ /** Snapshot spend for the given window. */
79
+ spentIn(window: BudgetWindow): number;
80
+ /** Remaining USD before the given window's limit is reached. */
81
+ remainingIn(window: BudgetWindow): number;
82
+ }
83
+ /** Per-window snapshot returned by `Budget.snapshot()`. */
84
+ interface BudgetSnapshot {
85
+ readonly name: string;
86
+ readonly window: BudgetWindow;
87
+ readonly spentUsd: number;
88
+ readonly limitUsd: number;
89
+ readonly ratio: number;
90
+ }
91
+
92
+ /**
93
+ * Finite, machine-readable error codes for provider-originated errors
94
+ * (ADR D66). Consumers can `switch (err.metadata?.code)` exhaustively
95
+ * — adding a new variant is an explicit decision + test coverage.
96
+ *
97
+ * @public
98
+ */
99
+ type ErrorCode = "rate_limit" | "auth_failed" | "invalid_request" | "timeout" | "server_error" | "context_too_long" | "content_filtered" | "model_unavailable" | "network" | "unknown";
100
+ /**
101
+ * Codes used by {@link AgentRunError} (Production-Readiness #3, ADR D311).
102
+ *
103
+ * Superset of {@link ErrorCode} extended with codes that do NOT originate
104
+ * from a provider HTTP response:
105
+ *
106
+ * - `quota_exceeded` — billing limit hit (provider 402 or signalled error)
107
+ * - `tool_runtime_error` — custom tool handler threw inside dispatch
108
+ * - `aborted` — caller's `AbortSignal` fired (Phase 4)
109
+ * - `invalid_model` — model id rejected by provider (400 "model not found")
110
+ * - `safety_blocked` — provider safety filter blocked req or resp
111
+ * - `provider_unreachable` — DNS/TCP/timeout/5xx at transport boundary
112
+ *
113
+ * The `& {}` tail keeps the literal-union ergonomics (autocomplete) while
114
+ * accepting any string for forward compatibility with constructor calls
115
+ * that pass arbitrary code values (legacy callers).
116
+ *
117
+ * @public
118
+ */
119
+ type AgentRunErrorCode = ErrorCode | "quota_exceeded" | "tool_runtime_error" | "aborted" | "invalid_model" | "safety_blocked" | "provider_unreachable" | (string & {});
120
+ /**
121
+ * Structured context for errors that originated from a provider HTTP
122
+ * call (ADR D65). Lets callers retry with the right backoff (`retryAfter`),
123
+ * surface actionable diagnostics (`provider`, `endpoint`), and inspect the
124
+ * raw response body when needed (`raw`, capped at ~2KB by the mapper).
125
+ *
126
+ * @public
127
+ */
128
+ interface ErrorMetadata {
129
+ /** Provider canonical name (e.g., `"anthropic"`, `"openai"`, `"openrouter"`, `"gemini"`). */
130
+ provider: string;
131
+ /** HTTP endpoint that failed (e.g., `"/v1/messages"`, `"/v1/chat/completions"`). */
132
+ endpoint: string;
133
+ /** Machine-readable error code (finite enum). */
134
+ code: ErrorCode;
135
+ /** HTTP status code if applicable. */
136
+ statusCode?: number;
137
+ /** Seconds to wait before retry, per provider's `retry-after` header (numeric form only). */
138
+ retryAfter?: number;
139
+ /** Raw response body for debugging (truncated to ~2KB by the mapper). */
140
+ raw?: unknown;
141
+ }
142
+ /**
143
+ * Base class for all errors thrown by `@theokit/sdk`.
144
+ *
145
+ * Use `isRetryable` to drive retry/backoff logic. `code` and `protoErrorCode`
146
+ * are populated for server-originated errors when available. `metadata`
147
+ * (ADR D65) carries structured `{ provider, endpoint, code, ... }` when
148
+ * the error originated from a provider HTTP call.
149
+ *
150
+ * @public
151
+ */
152
+ declare class TheokitAgentError extends Error {
153
+ readonly name: string;
154
+ readonly isRetryable: boolean;
155
+ readonly code?: string;
156
+ readonly protoErrorCode?: string;
157
+ readonly metadata?: ErrorMetadata;
158
+ constructor(message: string, options?: {
159
+ isRetryable?: boolean;
160
+ code?: string;
161
+ protoErrorCode?: string;
162
+ cause?: unknown;
163
+ metadata?: ErrorMetadata;
164
+ });
165
+ }
166
+ /**
167
+ * Invalid API key, not logged in, insufficient permissions.
168
+ *
169
+ * @public
170
+ */
171
+ declare class AuthenticationError extends TheokitAgentError {
172
+ readonly name: string;
173
+ constructor(message: string, options?: {
174
+ code?: string;
175
+ cause?: unknown;
176
+ metadata?: ErrorMetadata;
177
+ });
178
+ }
179
+ /**
180
+ * Too many requests or usage limits exceeded.
181
+ *
182
+ * @public
183
+ */
184
+ declare class RateLimitError extends TheokitAgentError {
185
+ readonly name: string;
186
+ constructor(message: string, options?: {
187
+ code?: string;
188
+ cause?: unknown;
189
+ metadata?: ErrorMetadata;
190
+ });
191
+ }
192
+ /**
193
+ * Invalid model, bad request parameters, malformed options.
194
+ *
195
+ * @public
196
+ */
197
+ declare class ConfigurationError extends TheokitAgentError {
198
+ readonly name: string;
199
+ constructor(message: string, options?: {
200
+ code?: string;
201
+ cause?: unknown;
202
+ metadata?: ErrorMetadata;
203
+ });
204
+ }
205
+ /**
206
+ * Thrown when creating a cloud agent for a repo whose SCM provider is not
207
+ * connected. Use `helpUrl` to point the user at the right reconnect flow.
208
+ *
209
+ * @public
210
+ */
211
+ declare class IntegrationNotConnectedError extends ConfigurationError {
212
+ readonly name: string;
213
+ readonly provider: string;
214
+ readonly helpUrl: string;
215
+ constructor(message: string, options: {
216
+ provider: string;
217
+ helpUrl: string;
218
+ code?: string;
219
+ cause?: unknown;
220
+ metadata?: ErrorMetadata;
221
+ });
222
+ }
223
+ /**
224
+ * Service unavailable, timeout, transport-level failure.
225
+ *
226
+ * @public
227
+ */
228
+ declare class NetworkError extends TheokitAgentError {
229
+ readonly name: string;
230
+ constructor(message: string, options?: {
231
+ code?: string;
232
+ cause?: unknown;
233
+ metadata?: ErrorMetadata;
234
+ });
235
+ }
236
+ /**
237
+ * Catch-all for unclassified server or runtime errors.
238
+ *
239
+ * @public
240
+ */
241
+ declare class UnknownAgentError extends TheokitAgentError {
242
+ readonly name: string;
243
+ constructor(message: string, options?: {
244
+ code?: string;
245
+ cause?: unknown;
246
+ metadata?: ErrorMetadata;
247
+ });
248
+ }
249
+ /**
250
+ * Thrown by `Agent.prompt` (and helpers that go through `run.wait()`) when
251
+ * the option `{ throwOnError: true }` is set and the run terminates with
252
+ * `status: 'error'`. Carries the structured `RunResult.error` fields so
253
+ * callers can `catch` once and branch on `code` / `provider` instead of
254
+ * unwrapping the run.
255
+ *
256
+ * Extends {@link TheokitAgentError} per ADR D65 — no new hierarchy.
257
+ *
258
+ * @example
259
+ * try {
260
+ * await Agent.prompt(msg, { apiKey, model, throwOnError: true });
261
+ * } catch (err) {
262
+ * if (err instanceof AgentRunError && err.code === 'auth_failed') {
263
+ * // bad key
264
+ * }
265
+ * }
266
+ *
267
+ * @public
268
+ */
269
+ declare class AgentRunError extends TheokitAgentError {
270
+ readonly name: string;
271
+ readonly provider?: string;
272
+ readonly raw?: string;
273
+ /** Provider's request id (`x-request-id` / `request-id` header). Useful for support tickets. */
274
+ readonly requestId?: string;
275
+ /** SDK conversation id this error was raised inside. */
276
+ readonly conversationId?: string;
277
+ constructor(message: string, options: {
278
+ code: AgentRunErrorCode;
279
+ provider?: string;
280
+ raw?: string;
281
+ requestId?: string;
282
+ conversationId?: string;
283
+ retriable?: boolean;
284
+ cause?: unknown;
285
+ metadata?: ErrorMetadata;
286
+ });
287
+ /**
288
+ * Production-Readiness #3 (ADR D311): alias for `isRetryable` exposed as
289
+ * `retriable` to match the handoff contract. Future v2 will deprecate
290
+ * `isRetryable` in favor of this.
291
+ */
292
+ get retriable(): boolean;
293
+ /**
294
+ * D312: provider's `Retry-After` header in **milliseconds**. Mappers store
295
+ * the header value (seconds) in `metadata.retryAfter`; this getter
296
+ * multiplies by 1000 so the result composes with `Date.now()`/`setTimeout`.
297
+ *
298
+ * Returns `undefined` when no hint was provided. `0` is a legitimate value
299
+ * — use `=== undefined` check rather than truthy check.
300
+ */
301
+ get retryAfterMs(): number | undefined;
302
+ /**
303
+ * D313: alias for `metadata.raw`. Provider response body for debugging.
304
+ * Available but NEVER serialized into `.message` (anti-leak invariant).
305
+ */
306
+ get providerError(): unknown;
307
+ }
308
+ /**
309
+ * Thrown when a {@link Run} or agent operation is not available on the current
310
+ * runtime. Check first with `run.supports(operation)`.
311
+ *
312
+ * Extends {@link TheokitAgentError} (so error-catching code that branches on
313
+ * `instanceof TheokitAgentError` continues to work) but is never retryable —
314
+ * an unsupported operation will not become supported on retry.
315
+ *
316
+ * @public
317
+ */
318
+ declare class UnsupportedRunOperationError extends TheokitAgentError {
319
+ readonly name: string;
320
+ readonly operation: RunOperation;
321
+ constructor(message: string, operation: RunOperation, options?: {
322
+ code?: string;
323
+ cause?: unknown;
324
+ });
325
+ }
326
+ /**
327
+ * Thrown when every credential in a per-provider pool is in cooldown
328
+ * and no healthy key is available (ADR D133). The caller's
329
+ * {@link import("./internal/llm/fallback-client.js").FallbackLlmClient}
330
+ * catches this and tries the next provider in the fallback chain.
331
+ *
332
+ * `metadata.nextRetryAt` (epoch ms) tells callers when the soonest
333
+ * pool entry resumes — useful for manual retry scheduling.
334
+ *
335
+ * @public
336
+ */
337
+ declare class CredentialPoolExhaustedError extends TheokitAgentError {
338
+ readonly name: string;
339
+ readonly provider: string;
340
+ readonly nextRetryAt: number | undefined;
341
+ constructor(message: string, options: {
342
+ provider: string;
343
+ nextRetryAt?: number;
344
+ code?: string;
345
+ cause?: unknown;
346
+ metadata?: ErrorMetadata;
347
+ });
348
+ }
349
+ /**
350
+ * Finite error codes specific to memory adapter operations (ADR D141).
351
+ *
352
+ * @public
353
+ */
354
+ type MemoryAdapterErrorCode = "auth_failed" | "rate_limited" | "not_found" | "network" | "invalid_input" | "unknown";
355
+ /**
356
+ * Error raised by `@theokit-memory-*` adapters. Carries `adapterId`
357
+ * so callers can branch on which provider failed (ADR D141).
358
+ *
359
+ * @public
360
+ */
361
+ declare class MemoryAdapterError extends TheokitAgentError {
362
+ readonly name: string;
363
+ readonly adapterId: string;
364
+ constructor(message: string, options: {
365
+ adapterId: string;
366
+ code: MemoryAdapterErrorCode;
367
+ cause?: unknown;
368
+ metadata?: ErrorMetadata;
369
+ });
370
+ }
371
+ /**
372
+ * Thrown when a user-supplied task ID violates the grammar
373
+ * `^[a-z0-9][a-z0-9_-]*$` (D368) OR starts with a reserved adapter
374
+ * prefix (`wf-` / `b-` / `cron-`, EC-5).
375
+ *
376
+ * @public
377
+ */
378
+ declare class InvalidTaskIdError extends TheokitAgentError {
379
+ readonly name: string;
380
+ readonly taskId: string;
381
+ constructor(message: string, taskId: string, options?: {
382
+ cause?: unknown;
383
+ });
384
+ }
385
+ /**
386
+ * Thrown when `Task.subscribe(id)` is called for a task that has been
387
+ * evicted, never submitted, or evicted after retention (D373).
388
+ *
389
+ * @public
390
+ */
391
+ declare class TaskNotFoundError extends TheokitAgentError {
392
+ readonly name: string;
393
+ readonly taskId: string;
394
+ constructor(taskId: string, options?: {
395
+ cause?: unknown;
396
+ });
397
+ }
398
+ /**
399
+ * Thrown when `CloudAgent` is asked to wrap a task (D370). Cloud
400
+ * task observability is deferred until Theo PaaS GA.
401
+ *
402
+ * @public
403
+ */
404
+ declare class UnsupportedTaskOperationError extends TheokitAgentError {
405
+ readonly name: string;
406
+ readonly operation: string;
407
+ constructor(operation: string, options?: {
408
+ cause?: unknown;
409
+ });
410
+ }
411
+ /**
412
+ * Thrown by `Budget` enforcement (ADR D386) when a `mode: "block"`
413
+ * budget would be exceeded by the upcoming LLM call. Caller pega
414
+ * tipado para retry-after-window-reset or surface to the user.
415
+ *
416
+ * @public
417
+ */
418
+ declare class BudgetExceededError extends TheokitAgentError {
419
+ readonly name: string;
420
+ readonly budgetName: string;
421
+ readonly window: BudgetWindow;
422
+ readonly spentUsd: number;
423
+ readonly limitUsd: number;
424
+ readonly mode: BudgetMode;
425
+ constructor(args: {
426
+ budgetName: string;
427
+ window: BudgetWindow;
428
+ spentUsd: number;
429
+ limitUsd: number;
430
+ mode: BudgetMode;
431
+ cause?: unknown;
432
+ });
433
+ }
434
+ /**
435
+ * Thrown when `CloudAgent.send({ budget })` is invoked (D388). Cloud
436
+ * budget surface waits for Theo PaaS GA.
437
+ *
438
+ * @public
439
+ */
440
+ declare class UnsupportedBudgetOperationError extends TheokitAgentError {
441
+ readonly name: string;
442
+ readonly operation: string;
443
+ constructor(operation: string, options?: {
444
+ cause?: unknown;
445
+ });
446
+ }
447
+
448
+ export { AgentRunError as A, type BudgetOptions as B, ConfigurationError as C, type ErrorCode as E, IntegrationNotConnectedError as I, MemoryAdapterError as M, NetworkError as N, RateLimitError as R, TheokitAgentError as T, UnknownAgentError as U, type BudgetHandle as a, type BudgetSnapshot as b, type AgentRunErrorCode as c, AuthenticationError as d, type BudgetExceedEvent as e, BudgetExceededError as f, type BudgetLimit as g, type BudgetMode as h, type BudgetScope as i, type BudgetThresholdEvent as j, type BudgetWindow as k, type ErrorMetadata as l, InvalidTaskIdError as m, type MemoryAdapterErrorCode as n, TaskNotFoundError as o, UnsupportedBudgetOperationError as p, UnsupportedRunOperationError as q, UnsupportedTaskOperationError as r, CredentialPoolExhaustedError as s };
@@ -0,0 +1,255 @@
1
+ 'use strict';
2
+
3
+ // src/errors.ts
4
+ var TheokitAgentError = class extends Error {
5
+ name = "TheokitAgentError";
6
+ isRetryable;
7
+ code;
8
+ protoErrorCode;
9
+ metadata;
10
+ constructor(message, options = {}) {
11
+ super(message, options.cause !== void 0 ? { cause: options.cause } : void 0);
12
+ this.isRetryable = options.isRetryable ?? false;
13
+ if (options.code !== void 0) this.code = options.code;
14
+ if (options.protoErrorCode !== void 0) this.protoErrorCode = options.protoErrorCode;
15
+ if (options.metadata !== void 0) this.metadata = options.metadata;
16
+ }
17
+ };
18
+ var AuthenticationError = class extends TheokitAgentError {
19
+ name = "AuthenticationError";
20
+ constructor(message, options = {}) {
21
+ super(message, { ...options, isRetryable: false });
22
+ }
23
+ };
24
+ var RateLimitError = class extends TheokitAgentError {
25
+ name = "RateLimitError";
26
+ constructor(message, options = {}) {
27
+ super(message, { ...options, isRetryable: true });
28
+ }
29
+ };
30
+ var ConfigurationError = class extends TheokitAgentError {
31
+ name = "ConfigurationError";
32
+ constructor(message, options = {}) {
33
+ super(message, { ...options, isRetryable: false });
34
+ }
35
+ };
36
+ var IntegrationNotConnectedError = class extends ConfigurationError {
37
+ name = "IntegrationNotConnectedError";
38
+ provider;
39
+ helpUrl;
40
+ constructor(message, options) {
41
+ super(message, options);
42
+ this.provider = options.provider;
43
+ this.helpUrl = options.helpUrl;
44
+ }
45
+ };
46
+ var NetworkError = class extends TheokitAgentError {
47
+ name = "NetworkError";
48
+ constructor(message, options = {}) {
49
+ super(message, { ...options, isRetryable: true });
50
+ }
51
+ };
52
+ var UnknownAgentError = class extends TheokitAgentError {
53
+ name = "UnknownAgentError";
54
+ constructor(message, options = {}) {
55
+ super(message, { ...options, isRetryable: false });
56
+ }
57
+ };
58
+ var AgentRunError = class extends TheokitAgentError {
59
+ name = "AgentRunError";
60
+ provider;
61
+ raw;
62
+ /** Provider's request id (`x-request-id` / `request-id` header). Useful for support tickets. */
63
+ requestId;
64
+ /** SDK conversation id this error was raised inside. */
65
+ conversationId;
66
+ constructor(message, options) {
67
+ super(message, {
68
+ code: options.code,
69
+ cause: options.cause,
70
+ metadata: options.metadata,
71
+ // D311: most AgentRunErrors are not retriable (auth, validation, abort).
72
+ // Provider mappers (D314) override per-status — explicit `retriable` wins
73
+ // over the implicit default when supplied.
74
+ isRetryable: options.retriable ?? defaultRetriableForCode(options.code)
75
+ });
76
+ if (options.provider !== void 0) this.provider = options.provider;
77
+ if (options.raw !== void 0) this.raw = options.raw;
78
+ if (options.requestId !== void 0) this.requestId = options.requestId;
79
+ if (options.conversationId !== void 0) this.conversationId = options.conversationId;
80
+ }
81
+ /**
82
+ * Production-Readiness #3 (ADR D311): alias for `isRetryable` exposed as
83
+ * `retriable` to match the handoff contract. Future v2 will deprecate
84
+ * `isRetryable` in favor of this.
85
+ */
86
+ get retriable() {
87
+ return this.isRetryable;
88
+ }
89
+ /**
90
+ * D312: provider's `Retry-After` header in **milliseconds**. Mappers store
91
+ * the header value (seconds) in `metadata.retryAfter`; this getter
92
+ * multiplies by 1000 so the result composes with `Date.now()`/`setTimeout`.
93
+ *
94
+ * Returns `undefined` when no hint was provided. `0` is a legitimate value
95
+ * — use `=== undefined` check rather than truthy check.
96
+ */
97
+ get retryAfterMs() {
98
+ if (this.metadata?.retryAfter === void 0) return void 0;
99
+ return this.metadata.retryAfter * 1e3;
100
+ }
101
+ /**
102
+ * D313: alias for `metadata.raw`. Provider response body for debugging.
103
+ * Available but NEVER serialized into `.message` (anti-leak invariant).
104
+ */
105
+ get providerError() {
106
+ return this.metadata?.raw;
107
+ }
108
+ };
109
+ function defaultRetriableForCode(code) {
110
+ switch (code) {
111
+ case "rate_limit":
112
+ case "timeout":
113
+ case "server_error":
114
+ case "network":
115
+ case "provider_unreachable":
116
+ return true;
117
+ default:
118
+ return false;
119
+ }
120
+ }
121
+ var UnsupportedRunOperationError = class extends TheokitAgentError {
122
+ name = "UnsupportedRunOperationError";
123
+ operation;
124
+ constructor(message, operation, options = {}) {
125
+ super(message, {
126
+ ...options,
127
+ isRetryable: false,
128
+ code: options.code ?? "unsupported_run_operation"
129
+ });
130
+ this.operation = operation;
131
+ }
132
+ };
133
+ var CredentialPoolExhaustedError = class extends TheokitAgentError {
134
+ name = "CredentialPoolExhaustedError";
135
+ provider;
136
+ nextRetryAt;
137
+ constructor(message, options) {
138
+ super(message, {
139
+ ...options,
140
+ isRetryable: true,
141
+ code: options.code ?? "credential_pool_exhausted"
142
+ });
143
+ this.provider = options.provider;
144
+ this.nextRetryAt = options.nextRetryAt;
145
+ }
146
+ };
147
+ var MemoryAdapterError = class extends TheokitAgentError {
148
+ name = "MemoryAdapterError";
149
+ adapterId;
150
+ constructor(message, options) {
151
+ super(message, {
152
+ isRetryable: options.code === "rate_limited" || options.code === "network",
153
+ code: options.code,
154
+ ...options.cause !== void 0 ? { cause: options.cause } : {},
155
+ ...options.metadata !== void 0 ? { metadata: options.metadata } : {}
156
+ });
157
+ this.adapterId = options.adapterId;
158
+ }
159
+ };
160
+ var InvalidTaskIdError = class extends TheokitAgentError {
161
+ name = "InvalidTaskIdError";
162
+ taskId;
163
+ constructor(message, taskId, options = {}) {
164
+ super(message, {
165
+ ...options,
166
+ isRetryable: false,
167
+ code: "invalid_task_id"
168
+ });
169
+ this.taskId = taskId;
170
+ }
171
+ };
172
+ var TaskNotFoundError = class extends TheokitAgentError {
173
+ name = "TaskNotFoundError";
174
+ taskId;
175
+ constructor(taskId, options = {}) {
176
+ super(`Task not found: ${taskId}`, {
177
+ ...options,
178
+ isRetryable: false,
179
+ code: "task_not_found"
180
+ });
181
+ this.taskId = taskId;
182
+ }
183
+ };
184
+ var UnsupportedTaskOperationError = class extends TheokitAgentError {
185
+ name = "UnsupportedTaskOperationError";
186
+ operation;
187
+ constructor(operation, options = {}) {
188
+ super(
189
+ `Task operation "${operation}" is not supported on CloudAgent (pre-release; see ADR D370)`,
190
+ {
191
+ ...options,
192
+ isRetryable: false,
193
+ code: "task_op_unsupported"
194
+ }
195
+ );
196
+ this.operation = operation;
197
+ }
198
+ };
199
+ var BudgetExceededError = class extends TheokitAgentError {
200
+ name = "BudgetExceededError";
201
+ budgetName;
202
+ window;
203
+ spentUsd;
204
+ limitUsd;
205
+ mode;
206
+ constructor(args) {
207
+ super(
208
+ `Budget "${args.budgetName}" exceeded for window ${args.window}: spent $${args.spentUsd.toFixed(4)} > limit $${args.limitUsd.toFixed(4)}`,
209
+ {
210
+ ...args.cause !== void 0 ? { cause: args.cause } : {},
211
+ isRetryable: false,
212
+ code: "budget_exceeded"
213
+ }
214
+ );
215
+ this.budgetName = args.budgetName;
216
+ this.window = args.window;
217
+ this.spentUsd = args.spentUsd;
218
+ this.limitUsd = args.limitUsd;
219
+ this.mode = args.mode;
220
+ }
221
+ };
222
+ var UnsupportedBudgetOperationError = class extends TheokitAgentError {
223
+ name = "UnsupportedBudgetOperationError";
224
+ operation;
225
+ constructor(operation, options = {}) {
226
+ super(
227
+ `Budget operation "${operation}" is not supported on CloudAgent (pre-release; see ADR D388)`,
228
+ {
229
+ ...options,
230
+ isRetryable: false,
231
+ code: "budget_op_unsupported"
232
+ }
233
+ );
234
+ this.operation = operation;
235
+ }
236
+ };
237
+
238
+ exports.AgentRunError = AgentRunError;
239
+ exports.AuthenticationError = AuthenticationError;
240
+ exports.BudgetExceededError = BudgetExceededError;
241
+ exports.ConfigurationError = ConfigurationError;
242
+ exports.CredentialPoolExhaustedError = CredentialPoolExhaustedError;
243
+ exports.IntegrationNotConnectedError = IntegrationNotConnectedError;
244
+ exports.InvalidTaskIdError = InvalidTaskIdError;
245
+ exports.MemoryAdapterError = MemoryAdapterError;
246
+ exports.NetworkError = NetworkError;
247
+ exports.RateLimitError = RateLimitError;
248
+ exports.TaskNotFoundError = TaskNotFoundError;
249
+ exports.TheokitAgentError = TheokitAgentError;
250
+ exports.UnknownAgentError = UnknownAgentError;
251
+ exports.UnsupportedBudgetOperationError = UnsupportedBudgetOperationError;
252
+ exports.UnsupportedRunOperationError = UnsupportedRunOperationError;
253
+ exports.UnsupportedTaskOperationError = UnsupportedTaskOperationError;
254
+ //# sourceMappingURL=errors.cjs.map
255
+ //# sourceMappingURL=errors.cjs.map