@terreno/ai 57.9.0 → 57.11.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 (417) hide show
  1. package/README.md +1 -0
  2. package/bunfig.toml +1 -1
  3. package/dist/aiApp.d.ts +8 -2
  4. package/dist/aiApp.js +12 -6
  5. package/dist/harness/adminScreens.d.ts +6 -0
  6. package/dist/harness/adminScreens.js +11 -0
  7. package/dist/harness/agentLoop.d.ts +61 -0
  8. package/dist/harness/agentLoop.js +798 -0
  9. package/dist/harness/agentTaskNames.d.ts +4 -0
  10. package/dist/harness/agentTaskNames.js +7 -0
  11. package/dist/harness/approvalPolicy.d.ts +3 -0
  12. package/dist/harness/approvalPolicy.js +23 -0
  13. package/dist/harness/approvals.d.ts +101 -0
  14. package/dist/harness/approvals.js +468 -0
  15. package/dist/harness/commit.d.ts +238 -0
  16. package/dist/harness/commit.js +678 -0
  17. package/dist/harness/conversation.d.ts +75 -0
  18. package/dist/harness/conversation.js +397 -0
  19. package/dist/harness/defineAgent.d.ts +9 -0
  20. package/dist/harness/defineAgent.js +65 -0
  21. package/dist/harness/defineTask.d.ts +11 -0
  22. package/dist/harness/defineTask.js +59 -0
  23. package/dist/harness/defineTool.d.ts +7 -0
  24. package/dist/harness/defineTool.js +36 -0
  25. package/dist/harness/definitionError.d.ts +8 -0
  26. package/dist/harness/definitionError.js +15 -0
  27. package/dist/harness/errors.d.ts +133 -0
  28. package/dist/harness/errors.js +107 -0
  29. package/dist/harness/eventHub.d.ts +45 -0
  30. package/dist/harness/eventHub.js +135 -0
  31. package/dist/harness/events.d.ts +95 -0
  32. package/dist/harness/events.js +267 -0
  33. package/dist/harness/executionEnv.d.ts +31 -0
  34. package/dist/harness/executionEnv.js +2 -0
  35. package/dist/harness/extensions.d.ts +82 -0
  36. package/dist/harness/extensions.js +274 -0
  37. package/dist/harness/harness.d.ts +163 -0
  38. package/dist/harness/harness.js +522 -0
  39. package/dist/harness/harnessApp.d.ts +44 -0
  40. package/dist/harness/harnessApp.js +62 -0
  41. package/dist/harness/internalRuntime.d.ts +16 -0
  42. package/dist/harness/internalRuntime.js +18 -0
  43. package/dist/harness/leases.d.ts +35 -0
  44. package/dist/harness/leases.js +86 -0
  45. package/dist/harness/memo.d.ts +24 -0
  46. package/dist/harness/memo.js +78 -0
  47. package/dist/harness/modelCall.d.ts +45 -0
  48. package/dist/harness/modelCall.js +147 -0
  49. package/dist/harness/models/harnessApproval.d.ts +2 -0
  50. package/dist/harness/models/harnessApproval.js +100 -0
  51. package/dist/harness/models/harnessConversation.d.ts +2 -0
  52. package/dist/harness/models/harnessConversation.js +117 -0
  53. package/dist/harness/models/harnessEvent.d.ts +3 -0
  54. package/dist/harness/models/harnessEvent.js +73 -0
  55. package/dist/harness/models/harnessInboxEvent.d.ts +2 -0
  56. package/dist/harness/models/harnessInboxEvent.js +58 -0
  57. package/dist/harness/models/harnessMemo.d.ts +2 -0
  58. package/dist/harness/models/harnessMemo.js +42 -0
  59. package/dist/harness/models/harnessMessage.d.ts +2 -0
  60. package/dist/harness/models/harnessMessage.js +73 -0
  61. package/dist/harness/models/harnessOwner.d.ts +2 -0
  62. package/dist/harness/models/harnessOwner.js +36 -0
  63. package/dist/harness/models/harnessTask.d.ts +2 -0
  64. package/dist/harness/models/harnessTask.js +191 -0
  65. package/dist/harness/ownership.d.ts +89 -0
  66. package/dist/harness/ownership.js +438 -0
  67. package/dist/harness/registry.d.ts +29 -0
  68. package/dist/harness/registry.js +93 -0
  69. package/dist/harness/retryBackoff.d.ts +31 -0
  70. package/dist/harness/retryBackoff.js +50 -0
  71. package/dist/harness/routes/approvals.d.ts +13 -0
  72. package/dist/harness/routes/approvals.js +93 -0
  73. package/dist/harness/routes/conversations.d.ts +11 -0
  74. package/dist/harness/routes/conversations.js +66 -0
  75. package/dist/harness/routes/events.d.ts +19 -0
  76. package/dist/harness/routes/events.js +215 -0
  77. package/dist/harness/routes/tasks.d.ts +11 -0
  78. package/dist/harness/routes/tasks.js +108 -0
  79. package/dist/harness/runners/inProcessRunner.d.ts +64 -0
  80. package/dist/harness/runners/inProcessRunner.js +227 -0
  81. package/dist/harness/runners/jobsRunner.d.ts +62 -0
  82. package/dist/harness/runners/jobsRunner.js +212 -0
  83. package/dist/harness/runtime.d.ts +52 -0
  84. package/dist/harness/runtime.js +604 -0
  85. package/dist/harness/subagent.d.ts +53 -0
  86. package/dist/harness/subagent.js +134 -0
  87. package/dist/harness/suspend.d.ts +8 -0
  88. package/dist/harness/suspend.js +16 -0
  89. package/dist/harness/transaction.d.ts +3 -0
  90. package/dist/harness/transaction.js +22 -0
  91. package/dist/harness/waits.d.ts +100 -0
  92. package/dist/harness/waits.js +214 -0
  93. package/dist/index.d.ts +19 -1
  94. package/dist/index.js +45 -2
  95. package/dist/models/aiDataset.d.ts +2 -0
  96. package/dist/models/aiDataset.js +67 -0
  97. package/dist/models/aiRequest.js +1 -1
  98. package/dist/models/gptHistory.js +73 -0
  99. package/dist/observability/adminScreens.d.ts +5 -0
  100. package/dist/observability/adminScreens.js +32 -0
  101. package/dist/observability/compileTemplate.d.ts +1 -0
  102. package/dist/observability/compileTemplate.js +13 -0
  103. package/dist/observability/datasetImport.d.ts +11 -0
  104. package/dist/observability/datasetImport.js +185 -0
  105. package/dist/observability/evaluate.d.ts +31 -0
  106. package/dist/observability/evaluate.js +200 -0
  107. package/dist/observability/evaluatorTemplates.d.ts +17 -0
  108. package/dist/observability/evaluatorTemplates.js +111 -0
  109. package/dist/observability/jsonPath.d.ts +2 -0
  110. package/dist/observability/jsonPath.js +57 -0
  111. package/dist/observability/local/datasetStore.d.ts +87 -0
  112. package/dist/observability/local/datasetStore.js +326 -0
  113. package/dist/observability/local/evaluatorStore.d.ts +44 -0
  114. package/dist/observability/local/evaluatorStore.js +182 -0
  115. package/dist/observability/local/experimentRunner.d.ts +96 -0
  116. package/dist/observability/local/experimentRunner.js +419 -0
  117. package/dist/observability/local/localPlugin.d.ts +22 -0
  118. package/dist/observability/local/localPlugin.js +76 -0
  119. package/dist/observability/local/models/obsDataset.d.ts +2 -0
  120. package/dist/observability/local/models/obsDataset.js +37 -0
  121. package/dist/observability/local/models/obsDatasetItem.d.ts +2 -0
  122. package/dist/observability/local/models/obsDatasetItem.js +76 -0
  123. package/dist/observability/local/models/obsEvaluator.d.ts +2 -0
  124. package/dist/observability/local/models/obsEvaluator.js +98 -0
  125. package/dist/observability/local/models/obsExperiment.d.ts +2 -0
  126. package/dist/observability/local/models/obsExperiment.js +87 -0
  127. package/dist/observability/local/models/obsExperimentItem.d.ts +2 -0
  128. package/dist/observability/local/models/obsExperimentItem.js +45 -0
  129. package/dist/observability/local/models/obsPrompt.d.ts +2 -0
  130. package/dist/observability/local/models/obsPrompt.js +42 -0
  131. package/dist/observability/local/models/obsPromptLabel.d.ts +2 -0
  132. package/dist/observability/local/models/obsPromptLabel.js +39 -0
  133. package/dist/observability/local/models/obsPromptVersion.d.ts +2 -0
  134. package/dist/observability/local/models/obsPromptVersion.js +96 -0
  135. package/dist/observability/local/models/obsReviewItem.d.ts +2 -0
  136. package/dist/observability/local/models/obsReviewItem.js +75 -0
  137. package/dist/observability/local/models/obsScore.d.ts +2 -0
  138. package/dist/observability/local/models/obsScore.js +58 -0
  139. package/dist/observability/local/models/obsSpan.d.ts +2 -0
  140. package/dist/observability/local/models/obsSpan.js +64 -0
  141. package/dist/observability/local/models/obsTrace.d.ts +2 -0
  142. package/dist/observability/local/models/obsTrace.js +93 -0
  143. package/dist/observability/local/promptStore.d.ts +180 -0
  144. package/dist/observability/local/promptStore.js +444 -0
  145. package/dist/observability/local/reviewStore.d.ts +50 -0
  146. package/dist/observability/local/reviewStore.js +203 -0
  147. package/dist/observability/local/traceStore.d.ts +103 -0
  148. package/dist/observability/local/traceStore.js +325 -0
  149. package/dist/observability/observabilityApp.d.ts +24 -0
  150. package/dist/observability/observabilityApp.js +157 -0
  151. package/dist/observability/observabilityAppRegistry.d.ts +14 -0
  152. package/dist/observability/observabilityAppRegistry.js +16 -0
  153. package/dist/observability/permissions.d.ts +7 -0
  154. package/dist/observability/permissions.js +60 -0
  155. package/dist/observability/reviewPanels.d.ts +18 -0
  156. package/dist/observability/reviewPanels.js +46 -0
  157. package/dist/observability/routes/datasets.d.ts +7 -0
  158. package/dist/observability/routes/datasets.js +149 -0
  159. package/dist/observability/routes/evaluators.d.ts +7 -0
  160. package/dist/observability/routes/evaluators.js +123 -0
  161. package/dist/observability/routes/experiments.d.ts +7 -0
  162. package/dist/observability/routes/experiments.js +95 -0
  163. package/dist/observability/routes/observabilityRouteAccess.d.ts +13 -0
  164. package/dist/observability/routes/observabilityRouteAccess.js +67 -0
  165. package/dist/observability/routes/prompts.d.ts +12 -0
  166. package/dist/observability/routes/prompts.js +172 -0
  167. package/dist/observability/routes/requestAiService.d.ts +13 -0
  168. package/dist/observability/routes/requestAiService.js +21 -0
  169. package/dist/observability/routes/review.d.ts +7 -0
  170. package/dist/observability/routes/review.js +79 -0
  171. package/dist/observability/routes/status.d.ts +5 -0
  172. package/dist/observability/routes/status.js +31 -0
  173. package/dist/observability/routes/testMultiStage.d.ts +9 -0
  174. package/dist/observability/routes/testMultiStage.js +67 -0
  175. package/dist/observability/routes/traces.d.ts +7 -0
  176. package/dist/observability/routes/traces.js +129 -0
  177. package/dist/observability/schemaValidation.d.ts +5 -0
  178. package/dist/observability/schemaValidation.js +26 -0
  179. package/dist/observability/sopThresholds.d.ts +2 -0
  180. package/dist/observability/sopThresholds.js +21 -0
  181. package/dist/observability/status.d.ts +23 -0
  182. package/dist/observability/status.js +34 -0
  183. package/dist/observability/testMultiStageSchemas.d.ts +10 -0
  184. package/dist/observability/testMultiStageSchemas.js +79 -0
  185. package/dist/observability/testMultiStageWorkflow.d.ts +20 -0
  186. package/dist/observability/testMultiStageWorkflow.js +218 -0
  187. package/dist/observability/types.d.ts +159 -0
  188. package/dist/observability/types.js +67 -0
  189. package/dist/routes/files.js +18 -7
  190. package/dist/routes/gpt.js +79 -689
  191. package/dist/routes/gptActions.d.ts +9 -0
  192. package/dist/routes/gptActions.js +212 -0
  193. package/dist/routes/gptDatasets.d.ts +5 -0
  194. package/dist/routes/gptDatasets.js +94 -0
  195. package/dist/routes/gptHistories.d.ts +3 -1
  196. package/dist/routes/gptHistories.js +188 -2
  197. package/dist/service/aiDatasets.d.ts +57 -0
  198. package/dist/service/aiDatasets.js +253 -0
  199. package/dist/service/aiService.d.ts +50 -1
  200. package/dist/service/aiService.js +426 -77
  201. package/dist/service/askFiles.d.ts +49 -0
  202. package/dist/service/askFiles.js +162 -0
  203. package/dist/service/asks.d.ts +76 -0
  204. package/dist/service/asks.js +284 -0
  205. package/dist/service/chatTurn.d.ts +128 -0
  206. package/dist/service/chatTurn.js +1674 -0
  207. package/dist/service/fileStorage.d.ts +4 -0
  208. package/dist/service/fileStorage.js +7 -2
  209. package/dist/service/fillActionIds.d.ts +6 -0
  210. package/dist/service/fillActionIds.js +79 -0
  211. package/dist/service/jsonFenceModel.d.ts +7 -0
  212. package/dist/service/jsonFenceModel.js +45 -0
  213. package/dist/service/prompts.d.ts +52 -0
  214. package/dist/service/prompts.js +96 -1
  215. package/dist/service/sanitizeHtml.d.ts +11 -0
  216. package/dist/service/sanitizeHtml.js +108 -0
  217. package/dist/types/harness.d.ts +952 -0
  218. package/dist/types/harness.js +133 -0
  219. package/dist/types/index.d.ts +192 -14
  220. package/dist/types/index.js +2 -0
  221. package/dist/types/observability.d.ts +288 -0
  222. package/dist/types/observability.js +2 -0
  223. package/package.json +28 -5
  224. package/src/aiApp.test.ts +207 -1
  225. package/src/aiApp.ts +19 -6
  226. package/src/harness/adminScreens.test.ts +34 -0
  227. package/src/harness/adminScreens.ts +11 -0
  228. package/src/harness/agentLoop.test.ts +1034 -0
  229. package/src/harness/agentLoop.ts +1082 -0
  230. package/src/harness/agentRecovery.test.ts +380 -0
  231. package/src/harness/agentTaskNames.ts +4 -0
  232. package/src/harness/approvalPolicy.ts +28 -0
  233. package/src/harness/approvals.test.ts +1094 -0
  234. package/src/harness/approvals.ts +644 -0
  235. package/src/harness/commit.ts +1049 -0
  236. package/src/harness/concurrency.test.ts +155 -0
  237. package/src/harness/conversation.ts +503 -0
  238. package/src/harness/defineAgent.test.ts +92 -0
  239. package/src/harness/defineAgent.ts +82 -0
  240. package/src/harness/defineTask.test.ts +59 -0
  241. package/src/harness/defineTask.ts +76 -0
  242. package/src/harness/defineTool.ts +45 -0
  243. package/src/harness/definitionError.ts +13 -0
  244. package/src/harness/errors.test.ts +90 -0
  245. package/src/harness/errors.ts +125 -0
  246. package/src/harness/eventHub.test.ts +124 -0
  247. package/src/harness/eventHub.ts +159 -0
  248. package/src/harness/events.test.ts +769 -0
  249. package/src/harness/events.ts +384 -0
  250. package/src/harness/executionEnv.ts +34 -0
  251. package/src/harness/extensions.test.ts +1218 -0
  252. package/src/harness/extensions.ts +382 -0
  253. package/src/harness/harness.test.ts +693 -0
  254. package/src/harness/harness.ts +778 -0
  255. package/src/harness/harnessApp.ts +76 -0
  256. package/src/harness/internalRuntime.ts +44 -0
  257. package/src/harness/leases.ts +132 -0
  258. package/src/harness/memo.ts +107 -0
  259. package/src/harness/modelCall.test.ts +134 -0
  260. package/src/harness/modelCall.ts +200 -0
  261. package/src/harness/models/harnessApproval.ts +109 -0
  262. package/src/harness/models/harnessConversation.ts +142 -0
  263. package/src/harness/models/harnessEvent.ts +92 -0
  264. package/src/harness/models/harnessInboxEvent.ts +73 -0
  265. package/src/harness/models/harnessMemo.ts +43 -0
  266. package/src/harness/models/harnessMessage.ts +85 -0
  267. package/src/harness/models/harnessModels.test.ts +60 -0
  268. package/src/harness/models/harnessOwner.ts +40 -0
  269. package/src/harness/models/harnessTask.ts +206 -0
  270. package/src/harness/ownership.test.ts +1087 -0
  271. package/src/harness/ownership.ts +618 -0
  272. package/src/harness/recovery.test.ts +907 -0
  273. package/src/harness/registry.ts +124 -0
  274. package/src/harness/retries.test.ts +292 -0
  275. package/src/harness/retryBackoff.test.ts +100 -0
  276. package/src/harness/retryBackoff.ts +77 -0
  277. package/src/harness/routes/approvals.ts +123 -0
  278. package/src/harness/routes/conversations.test.ts +518 -0
  279. package/src/harness/routes/conversations.ts +102 -0
  280. package/src/harness/routes/events.ts +280 -0
  281. package/src/harness/routes/tasks.test.ts +198 -0
  282. package/src/harness/routes/tasks.ts +146 -0
  283. package/src/harness/runners/inProcessRunner.test.ts +530 -0
  284. package/src/harness/runners/inProcessRunner.ts +260 -0
  285. package/src/harness/runners/jobsRunner.test.ts +709 -0
  286. package/src/harness/runners/jobsRunner.ts +252 -0
  287. package/src/harness/runtime.ts +802 -0
  288. package/src/harness/subagent.test.ts +696 -0
  289. package/src/harness/subagent.ts +192 -0
  290. package/src/harness/suspend.ts +13 -0
  291. package/src/harness/transaction.ts +17 -0
  292. package/src/harness/versioning.test.ts +288 -0
  293. package/src/harness/waits.test.ts +693 -0
  294. package/src/harness/waits.ts +356 -0
  295. package/src/index.test.ts +13 -0
  296. package/src/index.ts +70 -0
  297. package/src/isolated/adminScreensConfig.isolated.ts +143 -0
  298. package/src/models/aiDataset.test.ts +34 -0
  299. package/src/models/aiDataset.ts +78 -0
  300. package/src/models/aiRequest.ts +2 -1
  301. package/src/models/gptHistory.test.ts +156 -0
  302. package/src/models/gptHistory.ts +89 -1
  303. package/src/observability/adminScreens.test.ts +71 -0
  304. package/src/observability/adminScreens.ts +42 -0
  305. package/src/observability/compileTemplate.test.ts +14 -0
  306. package/src/observability/compileTemplate.ts +10 -0
  307. package/src/observability/datasetImport.test.ts +95 -0
  308. package/src/observability/datasetImport.ts +220 -0
  309. package/src/observability/evaluate.test.ts +549 -0
  310. package/src/observability/evaluate.ts +254 -0
  311. package/src/observability/evaluatorTemplates.ts +124 -0
  312. package/src/observability/jsonPath.test.ts +52 -0
  313. package/src/observability/jsonPath.ts +60 -0
  314. package/src/observability/local/datasetStore.test.ts +230 -0
  315. package/src/observability/local/datasetStore.ts +452 -0
  316. package/src/observability/local/evaluatorStore.test.ts +138 -0
  317. package/src/observability/local/evaluatorStore.ts +224 -0
  318. package/src/observability/local/experimentRunner.test.ts +489 -0
  319. package/src/observability/local/experimentRunner.ts +548 -0
  320. package/src/observability/local/localPlugin.ts +88 -0
  321. package/src/observability/local/models/obsDataset.ts +38 -0
  322. package/src/observability/local/models/obsDatasetItem.ts +80 -0
  323. package/src/observability/local/models/obsEvaluator.ts +102 -0
  324. package/src/observability/local/models/obsExperiment.ts +91 -0
  325. package/src/observability/local/models/obsExperimentItem.ts +52 -0
  326. package/src/observability/local/models/obsPrompt.ts +43 -0
  327. package/src/observability/local/models/obsPromptLabel.ts +43 -0
  328. package/src/observability/local/models/obsPromptVersion.ts +107 -0
  329. package/src/observability/local/models/obsReviewItem.ts +79 -0
  330. package/src/observability/local/models/obsScore.ts +59 -0
  331. package/src/observability/local/models/obsSpan.ts +65 -0
  332. package/src/observability/local/models/obsTrace.ts +94 -0
  333. package/src/observability/local/obsModels.test.ts +119 -0
  334. package/src/observability/local/promptStore.test.ts +351 -0
  335. package/src/observability/local/promptStore.ts +665 -0
  336. package/src/observability/local/reviewStore.test.ts +164 -0
  337. package/src/observability/local/reviewStore.ts +264 -0
  338. package/src/observability/local/traceStore.test.ts +264 -0
  339. package/src/observability/local/traceStore.ts +440 -0
  340. package/src/observability/observabilityApp.test.ts +92 -0
  341. package/src/observability/observabilityApp.ts +185 -0
  342. package/src/observability/observabilityAppRegistry.test.ts +30 -0
  343. package/src/observability/observabilityAppRegistry.ts +35 -0
  344. package/src/observability/permissions.test.ts +96 -0
  345. package/src/observability/permissions.ts +78 -0
  346. package/src/observability/reviewPanels.test.ts +35 -0
  347. package/src/observability/reviewPanels.ts +64 -0
  348. package/src/observability/routes/datasets.test.ts +176 -0
  349. package/src/observability/routes/datasets.ts +252 -0
  350. package/src/observability/routes/evaluators.test.ts +119 -0
  351. package/src/observability/routes/evaluators.ts +207 -0
  352. package/src/observability/routes/experiments.test.ts +282 -0
  353. package/src/observability/routes/experiments.ts +152 -0
  354. package/src/observability/routes/observabilityRbac.test.ts +767 -0
  355. package/src/observability/routes/observabilityRouteAccess.ts +106 -0
  356. package/src/observability/routes/prompts.test.ts +320 -0
  357. package/src/observability/routes/prompts.ts +263 -0
  358. package/src/observability/routes/requestAiService.ts +36 -0
  359. package/src/observability/routes/review.test.ts +120 -0
  360. package/src/observability/routes/review.ts +125 -0
  361. package/src/observability/routes/status.test.ts +116 -0
  362. package/src/observability/routes/status.ts +47 -0
  363. package/src/observability/routes/testMultiStage.test.ts +214 -0
  364. package/src/observability/routes/testMultiStage.ts +96 -0
  365. package/src/observability/routes/traces.test.ts +167 -0
  366. package/src/observability/routes/traces.ts +172 -0
  367. package/src/observability/schemaValidation.ts +29 -0
  368. package/src/observability/sopThresholds.ts +20 -0
  369. package/src/observability/status.test.ts +38 -0
  370. package/src/observability/status.ts +56 -0
  371. package/src/observability/testMultiStageSchemas.ts +95 -0
  372. package/src/observability/testMultiStageWorkflow.test.ts +114 -0
  373. package/src/observability/testMultiStageWorkflow.ts +307 -0
  374. package/src/observability/types.ts +262 -0
  375. package/src/routes/files.test.ts +63 -9
  376. package/src/routes/files.ts +21 -7
  377. package/src/routes/gpt.test.ts +3279 -0
  378. package/src/routes/gpt.ts +91 -816
  379. package/src/routes/gptActions.test.ts +241 -0
  380. package/src/routes/gptActions.ts +255 -0
  381. package/src/routes/gptApprovals.test.ts +762 -0
  382. package/src/routes/gptDatasets.test.ts +86 -0
  383. package/src/routes/gptDatasets.ts +104 -0
  384. package/src/routes/gptFiles.test.ts +589 -0
  385. package/src/routes/gptHistories.test.ts +933 -0
  386. package/src/routes/gptHistories.ts +266 -5
  387. package/src/routes/routes.test.ts +222 -2
  388. package/src/service/aiDatasets.test.ts +123 -0
  389. package/src/service/aiDatasets.ts +316 -0
  390. package/src/service/aiService.test.ts +593 -0
  391. package/src/service/aiService.ts +568 -111
  392. package/src/service/askFiles.test.ts +96 -0
  393. package/src/service/askFiles.ts +222 -0
  394. package/src/service/asks.test.ts +946 -0
  395. package/src/service/asks.ts +423 -0
  396. package/src/service/chatTurn.ts +2287 -0
  397. package/src/service/fileStorage.test.ts +11 -0
  398. package/src/service/fileStorage.ts +10 -2
  399. package/src/service/fillActionIds.test.ts +65 -0
  400. package/src/service/fillActionIds.ts +98 -0
  401. package/src/service/jsonFenceModel.test.ts +47 -0
  402. package/src/service/jsonFenceModel.ts +53 -0
  403. package/src/service/prompts.test.ts +21 -0
  404. package/src/service/prompts.ts +147 -0
  405. package/src/service/sanitizeHtml.test.ts +61 -0
  406. package/src/service/sanitizeHtml.ts +109 -0
  407. package/src/tests/bunSetup.test.ts +7 -4
  408. package/src/tests/bunSetup.ts +7 -7
  409. package/src/tests/chatHarness.ts +478 -0
  410. package/src/tests/generateStream.ts +49 -0
  411. package/src/tests/harnessErrors.ts +22 -0
  412. package/src/tests/harnessStreaming.ts +227 -0
  413. package/src/tests/helpers.ts +9 -2
  414. package/src/types/harness.ts +1119 -0
  415. package/src/types/index.ts +209 -13
  416. package/src/types/observability.ts +344 -0
  417. package/src/types/sanitize-html.d.ts +25 -0
@@ -0,0 +1,92 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import {z} from "@terreno/api";
3
+ import {harnessErrorMatching} from "../tests/harnessErrors";
4
+ import {defineAgent} from "./defineAgent";
5
+ import {defineTask} from "./defineTask";
6
+ import {defineTool} from "./defineTool";
7
+
8
+ const model = {modelId: "claude-sonnet-5-5", provider: "anthropic"};
9
+
10
+ const echo = defineTool({
11
+ description: "Echo the text back",
12
+ execute: async ({text}: {text: string}) => text,
13
+ name: "echo",
14
+ parameters: z.object({text: z.string()}),
15
+ });
16
+
17
+ describe("defineTool", () => {
18
+ it("defaults replay to never and freezes the definition", () => {
19
+ expect(echo.kind).toBe("tool");
20
+ expect(echo.replay).toBe("never");
21
+ expect(Object.isFrozen(echo)).toBe(true);
22
+ expect(defineTool({...echo, replay: "safe"}).replay).toBe("safe");
23
+ });
24
+
25
+ it.each([
26
+ [{name: "has space"}, 'name must be 1-64 letters, digits, "_" or "-"'],
27
+ [{name: "x".repeat(65)}, 'name must be 1-64 letters, digits, "_" or "-"'],
28
+ [{description: " "}, "description is required"],
29
+ [{parameters: {}}, "parameters must be a zod schema"],
30
+ [{execute: "nope"}, "execute must be a function"],
31
+ [{replay: "sometimes"}, 'replay must be "safe" or "never"'],
32
+ ])("rejects %p", (override, message) => {
33
+ expect(() => defineTool({...echo, ...(override as object)} as never)).toThrow(
34
+ harnessErrorMatching("definitionInvalid", message)
35
+ );
36
+ });
37
+ });
38
+
39
+ describe("defineAgent", () => {
40
+ it("fills defaults", () => {
41
+ const agent = defineAgent({instructions: "Help.", model, name: "test.helper"});
42
+ expect(agent.kind).toBe("agent");
43
+ expect(agent.maxSteps).toBe(10);
44
+ expect(agent.tools).toEqual([]);
45
+ });
46
+
47
+ it.each([
48
+ [{name: ""}, "defineAgent: name is required"],
49
+ [{model: {modelId: "", provider: "anthropic"}}, "model needs a provider and a modelId"],
50
+ [{fallbackModels: [{modelId: "x"}]}, "each fallback model needs a provider and a modelId"],
51
+ [{instructions: 3}, "instructions must be a string"],
52
+ [{maxSteps: 0}, "maxSteps must be a positive integer"],
53
+ [{maxSteps: 1.5}, "maxSteps must be a positive integer"],
54
+ [{modelRetry: {maxAttempts: 0}}, "modelRetry.maxAttempts must be a positive integer"],
55
+ [{tools: [{name: "raw"}]}, "every tool must come from defineTool"],
56
+ [{tools: [echo, echo]}, 'tool "echo" is listed more than once'],
57
+ [{output: {}}, "output must be a zod schema"],
58
+ ])("rejects %p", (override, message) => {
59
+ expect(() =>
60
+ defineAgent({instructions: "Help.", model, name: "test.helper", ...(override as object)})
61
+ ).toThrow(harnessErrorMatching("definitionInvalid", message));
62
+ });
63
+ });
64
+
65
+ describe("defineTask agent-related options", () => {
66
+ const base = {
67
+ initial: () => ({phase: "run"}),
68
+ name: "test.options",
69
+ phases: {run: {run: async () => {}}},
70
+ version: 1,
71
+ };
72
+
73
+ it.each([
74
+ [{onInterrupt: "explode"}, 'onInterrupt must be "park" or "fail"'],
75
+ [{spanKind: "LLM"}, "spanKind must be AGENT, CHAIN, or TOOL"],
76
+ [{spanName: "fixed"}, "spanName must be a function"],
77
+ ])("rejects %p", (override, message) => {
78
+ expect(() => defineTask({...base, ...(override as object)} as never)).toThrow(
79
+ harnessErrorMatching("definitionInvalid", message)
80
+ );
81
+ });
82
+
83
+ it("accepts the valid values", () => {
84
+ const task = defineTask({
85
+ ...base,
86
+ onInterrupt: "fail",
87
+ spanKind: "TOOL",
88
+ spanName: () => "named",
89
+ });
90
+ expect(task.onInterrupt).toBe("fail");
91
+ });
92
+ });
@@ -0,0 +1,82 @@
1
+ import type {
2
+ HarnessAgentDefinition,
3
+ HarnessAgentDefinitionInput,
4
+ HarnessExtensionDefinition,
5
+ HarnessModelRef,
6
+ } from "../types/harness";
7
+ import {HARNESS_AGENT_DEFAULT_MAX_STEPS} from "../types/harness";
8
+ import {HarnessDefinitionError} from "./definitionError";
9
+ import {assertValidRetryPolicy} from "./retryBackoff";
10
+
11
+ const assertModelRef = (agent: string, label: string, ref: HarnessModelRef | undefined): void => {
12
+ if (!ref?.provider?.trim() || !ref.modelId?.trim()) {
13
+ throw new HarnessDefinitionError(
14
+ `defineAgent(${agent}): ${label} needs a provider and a modelId`
15
+ );
16
+ }
17
+ };
18
+
19
+ /** An extension reference (definition or name) as its name. */
20
+ export const extensionName = (
21
+ owner: string,
22
+ entry: HarnessExtensionDefinition | string
23
+ ): string => {
24
+ const name = typeof entry === "string" ? entry : entry?.kind === "extension" ? entry.name : "";
25
+ if (!name?.trim()) {
26
+ throw new HarnessDefinitionError(
27
+ `${owner}: every extension must be a defineExtension result or its name`
28
+ );
29
+ }
30
+ return name;
31
+ };
32
+
33
+ /**
34
+ * Declare an agent: a model, instructions, and tools. Running it runs the built-in
35
+ * `terreno.agent.turn` task on a conversation, one durable phase per model request and
36
+ * per batch of tool calls.
37
+ */
38
+ export const defineAgent = (definition: HarnessAgentDefinitionInput): HarnessAgentDefinition => {
39
+ const {name} = definition;
40
+ if (!name?.trim()) {
41
+ throw new HarnessDefinitionError("defineAgent: name is required");
42
+ }
43
+ assertModelRef(name, "model", definition.model);
44
+ for (const fallback of definition.fallbackModels ?? []) {
45
+ assertModelRef(name, "each fallback model", fallback);
46
+ }
47
+ if (typeof definition.instructions !== "string") {
48
+ throw new HarnessDefinitionError(`defineAgent(${name}): instructions must be a string`);
49
+ }
50
+ const maxSteps = definition.maxSteps ?? HARNESS_AGENT_DEFAULT_MAX_STEPS;
51
+ if (!Number.isInteger(maxSteps) || maxSteps < 1) {
52
+ throw new HarnessDefinitionError(`defineAgent(${name}): maxSteps must be a positive integer`);
53
+ }
54
+ if (definition.modelRetry !== undefined) {
55
+ assertValidRetryPolicy(`defineAgent(${name})`, definition.modelRetry, "modelRetry");
56
+ }
57
+ const tools = definition.tools ?? [];
58
+ const toolNames = new Set<string>();
59
+ for (const tool of tools) {
60
+ if (tool?.kind !== "tool") {
61
+ throw new HarnessDefinitionError(
62
+ `defineAgent(${name}): every tool must come from defineTool`
63
+ );
64
+ }
65
+ if (toolNames.has(tool.name)) {
66
+ throw new HarnessDefinitionError(
67
+ `defineAgent(${name}): tool "${tool.name}" is listed more than once`
68
+ );
69
+ }
70
+ toolNames.add(tool.name);
71
+ }
72
+ if (definition.output !== undefined && typeof definition.output.safeParse !== "function") {
73
+ throw new HarnessDefinitionError(`defineAgent(${name}): output must be a zod schema`);
74
+ }
75
+ const extensions = (definition.extensions ?? []).map((entry) =>
76
+ extensionName(`defineAgent(${name})`, entry)
77
+ );
78
+ if (new Set(extensions).size !== extensions.length) {
79
+ throw new HarnessDefinitionError(`defineAgent(${name}): an extension is listed more than once`);
80
+ }
81
+ return Object.freeze({...definition, extensions, kind: "agent" as const, maxSteps, tools});
82
+ };
@@ -0,0 +1,59 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import {harnessErrorMatching} from "../tests/harnessErrors";
3
+ import type {HarnessTaskDefinitionInput} from "../types/harness";
4
+ import {defineTask, taskDefinitionKey} from "./defineTask";
5
+
6
+ const validInput = (): HarnessTaskDefinitionInput<unknown, unknown, unknown> => ({
7
+ initial: () => ({phase: "only"}),
8
+ name: "test.define",
9
+ phases: {only: {run: async () => {}}},
10
+ version: 1,
11
+ });
12
+
13
+ describe("defineTask", () => {
14
+ it("returns a frozen task definition keyed by name@version", () => {
15
+ const definition = defineTask({...validInput(), retry: {maxAttempts: 2}, version: 3});
16
+ expect(definition.kind).toBe("task");
17
+ expect(definition.key).toBe("test.define@3");
18
+ expect(definition.retry).toEqual({maxAttempts: 2});
19
+ expect(Object.isFrozen(definition)).toBe(true);
20
+ });
21
+
22
+ it("keeps phase replay policies and the abort handler", () => {
23
+ const abort = async (): Promise<void> => {};
24
+ const definition = defineTask({
25
+ ...validInput(),
26
+ abort,
27
+ phases: {
28
+ risky: {run: async () => {}},
29
+ safe: {replay: "safe", run: async () => {}},
30
+ },
31
+ });
32
+ expect(definition.phases.safe.replay).toBe("safe");
33
+ expect(definition.phases.risky.replay).toBeUndefined();
34
+ expect(definition.abort).toBe(abort);
35
+ });
36
+
37
+ it("formats registry keys", () => {
38
+ expect(taskDefinitionKey({name: "clinic.intake", version: 2})).toBe("clinic.intake@2");
39
+ });
40
+
41
+ it.each([
42
+ [{name: " "}, "defineTask: name is required"],
43
+ [{version: 0}, "defineTask(test.define): version must be a positive integer"],
44
+ [{version: 1.5}, "defineTask(test.define): version must be a positive integer"],
45
+ [{phases: {}}, "defineTask(test.define): at least one phase is required"],
46
+ [
47
+ {phases: {broken: {} as unknown as {run: () => Promise<void>}}},
48
+ 'defineTask(test.define): phase "broken" needs a run function',
49
+ ],
50
+ [
51
+ {phases: {odd: {replay: "sometimes" as "safe", run: async () => {}}}},
52
+ 'defineTask(test.define): phase "odd" replay must be "safe" or "never"',
53
+ ],
54
+ ])("rejects an invalid definition %#", (override, message) => {
55
+ expect(() => defineTask({...validInput(), ...override})).toThrow(
56
+ harnessErrorMatching("definitionInvalid", message)
57
+ );
58
+ });
59
+ });
@@ -0,0 +1,76 @@
1
+ import type {HarnessTaskDefinition, HarnessTaskDefinitionInput} from "../types/harness";
2
+ import {assertValidApprovalPolicies} from "./approvalPolicy";
3
+ import {HarnessDefinitionError} from "./definitionError";
4
+ import {assertValidRetryPolicy} from "./retryBackoff";
5
+
6
+ /** Registry key that pins a run to one definition version. */
7
+ export const taskDefinitionKey = ({name, version}: {name: string; version: number}): string =>
8
+ `${name}@${version}`;
9
+
10
+ /**
11
+ * Declare a durable, multi-phase task. Each phase does work and calls `rt.commit()`
12
+ * with the next phase or a terminal outcome; a committed phase is the resume point.
13
+ */
14
+ export const defineTask = <In, State, Out>(
15
+ definition: HarnessTaskDefinitionInput<In, State, Out>
16
+ ): HarnessTaskDefinition<In, State, Out> => {
17
+ if (!definition.name?.trim()) {
18
+ throw new HarnessDefinitionError("defineTask: name is required");
19
+ }
20
+ if (!Number.isInteger(definition.version) || definition.version < 1) {
21
+ throw new HarnessDefinitionError(
22
+ `defineTask(${definition.name}): version must be a positive integer`
23
+ );
24
+ }
25
+ const phaseNames = Object.keys(definition.phases ?? {});
26
+ if (phaseNames.length === 0) {
27
+ throw new HarnessDefinitionError(
28
+ `defineTask(${definition.name}): at least one phase is required`
29
+ );
30
+ }
31
+ for (const phaseName of phaseNames) {
32
+ const phase = definition.phases[phaseName];
33
+ if (typeof phase?.run !== "function") {
34
+ throw new HarnessDefinitionError(
35
+ `defineTask(${definition.name}): phase "${phaseName}" needs a run function`
36
+ );
37
+ }
38
+ if (phase.replay !== undefined && phase.replay !== "safe" && phase.replay !== "never") {
39
+ throw new HarnessDefinitionError(
40
+ `defineTask(${definition.name}): phase "${phaseName}" replay must be "safe" or "never"`
41
+ );
42
+ }
43
+ }
44
+ if (definition.retry !== undefined) {
45
+ assertValidRetryPolicy(`defineTask(${definition.name})`, definition.retry);
46
+ }
47
+ if (
48
+ definition.onInterrupt !== undefined &&
49
+ definition.onInterrupt !== "park" &&
50
+ definition.onInterrupt !== "fail"
51
+ ) {
52
+ throw new HarnessDefinitionError(
53
+ `defineTask(${definition.name}): onInterrupt must be "park" or "fail"`
54
+ );
55
+ }
56
+ if (
57
+ definition.spanKind !== undefined &&
58
+ !["AGENT", "CHAIN", "TOOL"].includes(definition.spanKind)
59
+ ) {
60
+ throw new HarnessDefinitionError(
61
+ `defineTask(${definition.name}): spanKind must be AGENT, CHAIN, or TOOL`
62
+ );
63
+ }
64
+ if (definition.spanName !== undefined && typeof definition.spanName !== "function") {
65
+ throw new HarnessDefinitionError(`defineTask(${definition.name}): spanName must be a function`);
66
+ }
67
+ if (definition.abort !== undefined && typeof definition.abort !== "function") {
68
+ throw new HarnessDefinitionError(`defineTask(${definition.name}): abort must be a function`);
69
+ }
70
+ assertValidApprovalPolicies(`defineTask(${definition.name})`, definition.approvals);
71
+ return Object.freeze({
72
+ ...definition,
73
+ key: taskDefinitionKey(definition),
74
+ kind: "task" as const,
75
+ });
76
+ };
@@ -0,0 +1,45 @@
1
+ import type {HarnessToolDefinition, HarnessToolDefinitionInput} from "../types/harness";
2
+ import {HarnessDefinitionError} from "./definitionError";
3
+
4
+ /** Provider-safe tool names (the strictest common limit across providers). */
5
+ const TOOL_NAME_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
6
+
7
+ /**
8
+ * Declare a tool an agent may call. Each call runs as its own child task of the turn;
9
+ * `replay` (default `"never"`) decides whether an interrupted call is re-run or reported
10
+ * to the model as "interrupted, not retried".
11
+ */
12
+ export const defineTool = <Args, Result>(
13
+ definition: HarnessToolDefinitionInput<Args, Result>
14
+ ): HarnessToolDefinition<Args, Result> => {
15
+ if (!TOOL_NAME_PATTERN.test(definition.name ?? "")) {
16
+ throw new HarnessDefinitionError(
17
+ `defineTool(${definition.name}): name must be 1-64 letters, digits, "_" or "-"`
18
+ );
19
+ }
20
+ if (!definition.description?.trim()) {
21
+ throw new HarnessDefinitionError(`defineTool(${definition.name}): description is required`);
22
+ }
23
+ if (typeof definition.parameters?.safeParse !== "function") {
24
+ throw new HarnessDefinitionError(
25
+ `defineTool(${definition.name}): parameters must be a zod schema`
26
+ );
27
+ }
28
+ if (typeof definition.execute !== "function") {
29
+ throw new HarnessDefinitionError(`defineTool(${definition.name}): execute must be a function`);
30
+ }
31
+ if (
32
+ definition.replay !== undefined &&
33
+ definition.replay !== "safe" &&
34
+ definition.replay !== "never"
35
+ ) {
36
+ throw new HarnessDefinitionError(
37
+ `defineTool(${definition.name}): replay must be "safe" or "never"`
38
+ );
39
+ }
40
+ return Object.freeze({
41
+ ...definition,
42
+ kind: "tool" as const,
43
+ replay: definition.replay ?? "never",
44
+ });
45
+ };
@@ -0,0 +1,13 @@
1
+ import {APIError} from "@terreno/api";
2
+
3
+ import {HARNESS_ERRORS} from "./errors";
4
+
5
+ /**
6
+ * A misuse of the task API; retrying the phase cannot fix it, so the task fails at once.
7
+ * An `APIError` (500, `harness-definition-invalid`); the specific problem is in `detail`.
8
+ */
9
+ export class HarnessDefinitionError extends APIError {
10
+ constructor(detail: string) {
11
+ super({...HARNESS_ERRORS.definitionInvalid, detail});
12
+ }
13
+ }
@@ -0,0 +1,90 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import {APIError, isAPIError} from "@terreno/api";
3
+
4
+ import {HarnessDefinitionError} from "./definitionError";
5
+ import {errorMessage, HARNESS_ERRORS, harnessError} from "./errors";
6
+ import {internalRuntime} from "./internalRuntime";
7
+
8
+ describe("harness errors", () => {
9
+ it("builds an APIError whose message is the kind's stable title", () => {
10
+ const cause = new Error("socket hang up");
11
+ const error = harnessError({
12
+ cause,
13
+ detail: "Task 1 is already completed",
14
+ kind: "taskTerminal",
15
+ });
16
+ expect(isAPIError(error)).toBe(true);
17
+ expect(error).toMatchObject({
18
+ code: "harness-task-terminal",
19
+ detail: "Task 1 is already completed",
20
+ message: "Task already ended",
21
+ name: "HarnessTaskTerminal",
22
+ status: 409,
23
+ });
24
+ expect(error.cause).toBe(cause);
25
+ expect(error.toJSON()).toMatchObject({
26
+ code: "harness-task-terminal",
27
+ detail: "Task 1 is already completed",
28
+ status: 409,
29
+ title: "Task already ended",
30
+ });
31
+ });
32
+
33
+ it("gives every kind a harness- code, an HTTP error status, and a title", () => {
34
+ const codes = Object.values(HARNESS_ERRORS).map(({code}) => code);
35
+ expect(new Set(codes).size).toBe(codes.length);
36
+ for (const {code, status, title} of Object.values(HARNESS_ERRORS)) {
37
+ expect(code).toStartWith("harness-");
38
+ expect(status).toBeGreaterThanOrEqual(400);
39
+ expect(status).toBeLessThan(600);
40
+ expect(title.trim()).not.toBe("");
41
+ }
42
+ });
43
+
44
+ it("keeps HarnessDefinitionError an instanceof-checkable definition APIError", () => {
45
+ const error = new HarnessDefinitionError("defineTask: name is required");
46
+ expect(error).toBeInstanceOf(HarnessDefinitionError);
47
+ expect(error).toBeInstanceOf(APIError);
48
+ expect(error).toMatchObject({
49
+ code: HARNESS_ERRORS.definitionInvalid.code,
50
+ detail: "defineTask: name is required",
51
+ message: HARNESS_ERRORS.definitionInvalid.title,
52
+ name: "HarnessDefinitionError",
53
+ status: 500,
54
+ });
55
+ });
56
+
57
+ it("records a harness error by its detail and any other error with its full text", () => {
58
+ expect(
59
+ errorMessage(harnessError({detail: "memo requires a non-empty key", kind: "invalidRequest"}))
60
+ ).toBe("memo requires a non-empty key");
61
+ expect(
62
+ errorMessage(new HarnessDefinitionError("defineTool(x): execute must be a function"))
63
+ ).toBe("defineTool(x): execute must be a function");
64
+ // An app's own APIError keeps its title, since its detail may not stand alone.
65
+ expect(
66
+ errorMessage(
67
+ new APIError({
68
+ code: "ehr-down",
69
+ detail: "p-1 timed out",
70
+ status: 502,
71
+ title: "EHR unavailable",
72
+ })
73
+ )
74
+ ).toBe("EHR unavailable: p-1 timed out");
75
+ expect(errorMessage(new APIError({status: 404, title: "Chart not found"}))).toBe(
76
+ "Chart not found"
77
+ );
78
+ expect(errorMessage(new Error("boom"))).toBe("boom");
79
+ expect(errorMessage("plain string")).toBe("plain string");
80
+ });
81
+
82
+ it("refuses a runtime the engine did not build", () => {
83
+ expect(() => internalRuntime({} as never)).toThrow(
84
+ expect.objectContaining({
85
+ code: HARNESS_ERRORS.internal.code,
86
+ detail: "This runtime was not built by the harness engine",
87
+ })
88
+ );
89
+ });
90
+ });
@@ -0,0 +1,125 @@
1
+ import {APIError, errorDetail, isAPIError} from "@terreno/api";
2
+
3
+ /**
4
+ * Harness error vocabulary. Each kind is one stable problem type: `code` and `title` never
5
+ * change between occurrences; the per-occurrence sentence goes in `detail`.
6
+ */
7
+ export interface HarnessErrorKind {
8
+ code: string;
9
+ status: number;
10
+ title: string;
11
+ }
12
+
13
+ export const HARNESS_ERRORS = {
14
+ /** `start` called twice on a harness or runner. */
15
+ alreadyStarted: {code: "harness-already-started", status: 409, title: "Already started"},
16
+ /** Two writers raced on an approval; the loser can no longer decide it. */
17
+ approvalNotPending: {
18
+ code: "harness-approval-not-pending",
19
+ status: 409,
20
+ title: "Approval can no longer be decided",
21
+ },
22
+ /** A commit lost its checkpoint fence (lease taken over, task aborted, or phase moved). */
23
+ commitConflict: {
24
+ code: "harness-commit-conflict",
25
+ status: 409,
26
+ title: "Harness commit lost its checkpoint fence",
27
+ },
28
+ /** Invalid `Harness.open`, `HarnessApp`, runner, or model-resolver configuration. */
29
+ configInvalid: {
30
+ code: "harness-config-invalid",
31
+ status: 500,
32
+ title: "Invalid harness configuration",
33
+ },
34
+ /** A conversation is running a turn and `submit` cannot start another. */
35
+ conversationBusy: {
36
+ code: "harness-conversation-busy",
37
+ status: 409,
38
+ title: "Conversation is busy",
39
+ },
40
+ /** A subagent conversation: only its owning task's `rt.runAgent` runs turns. */
41
+ conversationOwned: {
42
+ code: "harness-conversation-owned",
43
+ status: 409,
44
+ title: "Conversation is run by its owning task",
45
+ },
46
+ /** Misuse of a definition API (`defineTask`, `rt.*`, ...); retrying cannot fix it. */
47
+ definitionInvalid: {
48
+ code: "harness-definition-invalid",
49
+ status: 500,
50
+ title: "Invalid harness definition",
51
+ },
52
+ /** An internal invariant broke; the work is retried or logged. */
53
+ internal: {code: "harness-internal", status: 500, title: "Harness invariant violated"},
54
+ /** A caller passed an invalid argument to a harness method. */
55
+ invalidRequest: {code: "harness-invalid-request", status: 400, title: "Invalid harness request"},
56
+ /** A harness row the call depends on no longer exists. */
57
+ notFound: {code: "harness-not-found", status: 404, title: "Harness record not found"},
58
+ /** A task definition, agent, or extension is not in this harness registry. */
59
+ notRegistered: {
60
+ code: "harness-not-registered",
61
+ status: 404,
62
+ title: "Not registered in this harness",
63
+ },
64
+ /** `Harness.open` on a MongoDB deployment without transactions (not a replica set or mongos). */
65
+ replicaSetRequired: {
66
+ code: "harness-replica-set-required",
67
+ status: 500,
68
+ title: "MongoDB replica set required",
69
+ },
70
+ /** A `requestId` (task or event) is already used for something else. */
71
+ requestIdConflict: {
72
+ code: "harness-request-id-conflict",
73
+ status: 409,
74
+ title: "requestId is already in use",
75
+ },
76
+ /** A `JobsRunner` phase job ran on an instance whose harness is not started. */
77
+ runnerStopped: {
78
+ code: "harness-runner-stopped",
79
+ status: 503,
80
+ title: "Harness runner is not running",
81
+ },
82
+ /** `retry` on a task whose abort is still running. */
83
+ taskAborting: {code: "harness-task-aborting", status: 409, title: "Task is being aborted"},
84
+ /** `resolveInterrupted` on a task that is not interrupted. */
85
+ taskNotInterrupted: {
86
+ code: "harness-task-not-interrupted",
87
+ status: 409,
88
+ title: "Task is not interrupted",
89
+ },
90
+ /** The task already ended, so it cannot be aborted or receive events. */
91
+ taskTerminal: {code: "harness-task-terminal", status: 409, title: "Task already ended"},
92
+ /** `Harness.waitFor` gave up before the task reached the status it waited for. */
93
+ waitTimedOut: {
94
+ code: "harness-wait-timed-out",
95
+ status: 504,
96
+ title: "Timed out waiting for task",
97
+ },
98
+ } as const satisfies Record<string, HarnessErrorKind>;
99
+
100
+ export type HarnessErrorKindName = keyof typeof HARNESS_ERRORS;
101
+
102
+ /** Build an `APIError` of one harness kind; `detail` is a self-contained sentence. */
103
+ export const harnessError = ({
104
+ cause,
105
+ detail,
106
+ kind,
107
+ }: {
108
+ cause?: unknown;
109
+ detail: string;
110
+ kind: HarnessErrorKindName;
111
+ }): APIError => {
112
+ return new APIError({...HARNESS_ERRORS[kind], cause, detail});
113
+ };
114
+
115
+ /**
116
+ * The text recorded for a failure (task `error`, tool results the model sees, logs). Harness
117
+ * details are self-contained sentences, so they stand alone; other `APIError`s keep their
118
+ * title too, and plain errors use their message.
119
+ */
120
+ export const errorMessage = (error: unknown): string => {
121
+ if (isAPIError(error) && error.code?.startsWith("harness-") && error.detail) {
122
+ return error.detail;
123
+ }
124
+ return errorDetail(error);
125
+ };