@terreno/ai 57.8.0 → 57.10.1

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 (425) hide show
  1. package/.cursorrules +2 -2
  2. package/README.md +2 -1
  3. package/bunfig.toml +1 -1
  4. package/dist/aiApp.d.ts +16 -5
  5. package/dist/aiApp.js +17 -7
  6. package/dist/harness/adminScreens.d.ts +6 -0
  7. package/dist/harness/adminScreens.js +11 -0
  8. package/dist/harness/agentLoop.d.ts +61 -0
  9. package/dist/harness/agentLoop.js +798 -0
  10. package/dist/harness/agentTaskNames.d.ts +4 -0
  11. package/dist/harness/agentTaskNames.js +7 -0
  12. package/dist/harness/approvalPolicy.d.ts +3 -0
  13. package/dist/harness/approvalPolicy.js +23 -0
  14. package/dist/harness/approvals.d.ts +101 -0
  15. package/dist/harness/approvals.js +468 -0
  16. package/dist/harness/commit.d.ts +238 -0
  17. package/dist/harness/commit.js +678 -0
  18. package/dist/harness/conversation.d.ts +75 -0
  19. package/dist/harness/conversation.js +397 -0
  20. package/dist/harness/defineAgent.d.ts +9 -0
  21. package/dist/harness/defineAgent.js +65 -0
  22. package/dist/harness/defineTask.d.ts +11 -0
  23. package/dist/harness/defineTask.js +59 -0
  24. package/dist/harness/defineTool.d.ts +7 -0
  25. package/dist/harness/defineTool.js +36 -0
  26. package/dist/harness/definitionError.d.ts +8 -0
  27. package/dist/harness/definitionError.js +15 -0
  28. package/dist/harness/errors.d.ts +127 -0
  29. package/dist/harness/errors.js +101 -0
  30. package/dist/harness/eventHub.d.ts +45 -0
  31. package/dist/harness/eventHub.js +135 -0
  32. package/dist/harness/events.d.ts +95 -0
  33. package/dist/harness/events.js +267 -0
  34. package/dist/harness/executionEnv.d.ts +31 -0
  35. package/dist/harness/executionEnv.js +2 -0
  36. package/dist/harness/extensions.d.ts +82 -0
  37. package/dist/harness/extensions.js +274 -0
  38. package/dist/harness/harness.d.ts +163 -0
  39. package/dist/harness/harness.js +520 -0
  40. package/dist/harness/harnessApp.d.ts +44 -0
  41. package/dist/harness/harnessApp.js +62 -0
  42. package/dist/harness/internalRuntime.d.ts +16 -0
  43. package/dist/harness/internalRuntime.js +18 -0
  44. package/dist/harness/leases.d.ts +35 -0
  45. package/dist/harness/leases.js +86 -0
  46. package/dist/harness/memo.d.ts +24 -0
  47. package/dist/harness/memo.js +78 -0
  48. package/dist/harness/modelCall.d.ts +45 -0
  49. package/dist/harness/modelCall.js +147 -0
  50. package/dist/harness/models/harnessApproval.d.ts +2 -0
  51. package/dist/harness/models/harnessApproval.js +100 -0
  52. package/dist/harness/models/harnessConversation.d.ts +2 -0
  53. package/dist/harness/models/harnessConversation.js +117 -0
  54. package/dist/harness/models/harnessEvent.d.ts +3 -0
  55. package/dist/harness/models/harnessEvent.js +73 -0
  56. package/dist/harness/models/harnessInboxEvent.d.ts +2 -0
  57. package/dist/harness/models/harnessInboxEvent.js +58 -0
  58. package/dist/harness/models/harnessMemo.d.ts +2 -0
  59. package/dist/harness/models/harnessMemo.js +42 -0
  60. package/dist/harness/models/harnessMessage.d.ts +2 -0
  61. package/dist/harness/models/harnessMessage.js +73 -0
  62. package/dist/harness/models/harnessOwner.d.ts +2 -0
  63. package/dist/harness/models/harnessOwner.js +36 -0
  64. package/dist/harness/models/harnessTask.d.ts +2 -0
  65. package/dist/harness/models/harnessTask.js +186 -0
  66. package/dist/harness/ownership.d.ts +89 -0
  67. package/dist/harness/ownership.js +438 -0
  68. package/dist/harness/registry.d.ts +29 -0
  69. package/dist/harness/registry.js +93 -0
  70. package/dist/harness/retryBackoff.d.ts +31 -0
  71. package/dist/harness/retryBackoff.js +50 -0
  72. package/dist/harness/routes/approvals.d.ts +13 -0
  73. package/dist/harness/routes/approvals.js +93 -0
  74. package/dist/harness/routes/conversations.d.ts +11 -0
  75. package/dist/harness/routes/conversations.js +66 -0
  76. package/dist/harness/routes/events.d.ts +19 -0
  77. package/dist/harness/routes/events.js +215 -0
  78. package/dist/harness/routes/tasks.d.ts +11 -0
  79. package/dist/harness/routes/tasks.js +108 -0
  80. package/dist/harness/runners/inProcessRunner.d.ts +57 -0
  81. package/dist/harness/runners/inProcessRunner.js +196 -0
  82. package/dist/harness/runtime.d.ts +34 -0
  83. package/dist/harness/runtime.js +551 -0
  84. package/dist/harness/subagent.d.ts +53 -0
  85. package/dist/harness/subagent.js +134 -0
  86. package/dist/harness/suspend.d.ts +8 -0
  87. package/dist/harness/suspend.js +16 -0
  88. package/dist/harness/transaction.d.ts +3 -0
  89. package/dist/harness/transaction.js +22 -0
  90. package/dist/harness/waits.d.ts +100 -0
  91. package/dist/harness/waits.js +214 -0
  92. package/dist/index.d.ts +19 -1
  93. package/dist/index.js +45 -2
  94. package/dist/models/aiDataset.d.ts +2 -0
  95. package/dist/models/aiDataset.js +67 -0
  96. package/dist/models/aiRequest.js +1 -1
  97. package/dist/models/gptHistory.js +88 -2
  98. package/dist/observability/adminScreens.d.ts +5 -0
  99. package/dist/observability/adminScreens.js +32 -0
  100. package/dist/observability/compileTemplate.d.ts +1 -0
  101. package/dist/observability/compileTemplate.js +13 -0
  102. package/dist/observability/datasetImport.d.ts +11 -0
  103. package/dist/observability/datasetImport.js +185 -0
  104. package/dist/observability/evaluate.d.ts +31 -0
  105. package/dist/observability/evaluate.js +200 -0
  106. package/dist/observability/evaluatorTemplates.d.ts +17 -0
  107. package/dist/observability/evaluatorTemplates.js +111 -0
  108. package/dist/observability/jsonPath.d.ts +2 -0
  109. package/dist/observability/jsonPath.js +57 -0
  110. package/dist/observability/local/datasetStore.d.ts +87 -0
  111. package/dist/observability/local/datasetStore.js +326 -0
  112. package/dist/observability/local/evaluatorStore.d.ts +44 -0
  113. package/dist/observability/local/evaluatorStore.js +182 -0
  114. package/dist/observability/local/experimentRunner.d.ts +96 -0
  115. package/dist/observability/local/experimentRunner.js +419 -0
  116. package/dist/observability/local/localPlugin.d.ts +22 -0
  117. package/dist/observability/local/localPlugin.js +76 -0
  118. package/dist/observability/local/models/obsDataset.d.ts +2 -0
  119. package/dist/observability/local/models/obsDataset.js +37 -0
  120. package/dist/observability/local/models/obsDatasetItem.d.ts +2 -0
  121. package/dist/observability/local/models/obsDatasetItem.js +76 -0
  122. package/dist/observability/local/models/obsEvaluator.d.ts +2 -0
  123. package/dist/observability/local/models/obsEvaluator.js +98 -0
  124. package/dist/observability/local/models/obsExperiment.d.ts +2 -0
  125. package/dist/observability/local/models/obsExperiment.js +87 -0
  126. package/dist/observability/local/models/obsExperimentItem.d.ts +2 -0
  127. package/dist/observability/local/models/obsExperimentItem.js +45 -0
  128. package/dist/observability/local/models/obsPrompt.d.ts +2 -0
  129. package/dist/observability/local/models/obsPrompt.js +42 -0
  130. package/dist/observability/local/models/obsPromptLabel.d.ts +2 -0
  131. package/dist/observability/local/models/obsPromptLabel.js +39 -0
  132. package/dist/observability/local/models/obsPromptVersion.d.ts +2 -0
  133. package/dist/observability/local/models/obsPromptVersion.js +96 -0
  134. package/dist/observability/local/models/obsReviewItem.d.ts +2 -0
  135. package/dist/observability/local/models/obsReviewItem.js +75 -0
  136. package/dist/observability/local/models/obsScore.d.ts +2 -0
  137. package/dist/observability/local/models/obsScore.js +58 -0
  138. package/dist/observability/local/models/obsSpan.d.ts +2 -0
  139. package/dist/observability/local/models/obsSpan.js +64 -0
  140. package/dist/observability/local/models/obsTrace.d.ts +2 -0
  141. package/dist/observability/local/models/obsTrace.js +93 -0
  142. package/dist/observability/local/promptStore.d.ts +180 -0
  143. package/dist/observability/local/promptStore.js +444 -0
  144. package/dist/observability/local/reviewStore.d.ts +50 -0
  145. package/dist/observability/local/reviewStore.js +203 -0
  146. package/dist/observability/local/traceStore.d.ts +103 -0
  147. package/dist/observability/local/traceStore.js +325 -0
  148. package/dist/observability/observabilityApp.d.ts +24 -0
  149. package/dist/observability/observabilityApp.js +157 -0
  150. package/dist/observability/observabilityAppRegistry.d.ts +14 -0
  151. package/dist/observability/observabilityAppRegistry.js +16 -0
  152. package/dist/observability/permissions.d.ts +7 -0
  153. package/dist/observability/permissions.js +60 -0
  154. package/dist/observability/reviewPanels.d.ts +18 -0
  155. package/dist/observability/reviewPanels.js +46 -0
  156. package/dist/observability/routes/datasets.d.ts +7 -0
  157. package/dist/observability/routes/datasets.js +149 -0
  158. package/dist/observability/routes/evaluators.d.ts +7 -0
  159. package/dist/observability/routes/evaluators.js +123 -0
  160. package/dist/observability/routes/experiments.d.ts +7 -0
  161. package/dist/observability/routes/experiments.js +95 -0
  162. package/dist/observability/routes/observabilityRouteAccess.d.ts +13 -0
  163. package/dist/observability/routes/observabilityRouteAccess.js +67 -0
  164. package/dist/observability/routes/prompts.d.ts +12 -0
  165. package/dist/observability/routes/prompts.js +172 -0
  166. package/dist/observability/routes/requestAiService.d.ts +13 -0
  167. package/dist/observability/routes/requestAiService.js +21 -0
  168. package/dist/observability/routes/review.d.ts +7 -0
  169. package/dist/observability/routes/review.js +79 -0
  170. package/dist/observability/routes/status.d.ts +5 -0
  171. package/dist/observability/routes/status.js +31 -0
  172. package/dist/observability/routes/testMultiStage.d.ts +9 -0
  173. package/dist/observability/routes/testMultiStage.js +67 -0
  174. package/dist/observability/routes/traces.d.ts +7 -0
  175. package/dist/observability/routes/traces.js +129 -0
  176. package/dist/observability/schemaValidation.d.ts +5 -0
  177. package/dist/observability/schemaValidation.js +26 -0
  178. package/dist/observability/sopThresholds.d.ts +2 -0
  179. package/dist/observability/sopThresholds.js +21 -0
  180. package/dist/observability/status.d.ts +23 -0
  181. package/dist/observability/status.js +34 -0
  182. package/dist/observability/testMultiStageSchemas.d.ts +10 -0
  183. package/dist/observability/testMultiStageSchemas.js +79 -0
  184. package/dist/observability/testMultiStageWorkflow.d.ts +20 -0
  185. package/dist/observability/testMultiStageWorkflow.js +218 -0
  186. package/dist/observability/types.d.ts +159 -0
  187. package/dist/observability/types.js +67 -0
  188. package/dist/routes/files.js +20 -7
  189. package/dist/routes/gpt.js +179 -488
  190. package/dist/routes/gptActions.d.ts +9 -0
  191. package/dist/routes/gptActions.js +212 -0
  192. package/dist/routes/gptDatasets.d.ts +5 -0
  193. package/dist/routes/gptDatasets.js +94 -0
  194. package/dist/routes/gptHistories.d.ts +3 -1
  195. package/dist/routes/gptHistories.js +188 -2
  196. package/dist/service/aiDatasets.d.ts +57 -0
  197. package/dist/service/aiDatasets.js +253 -0
  198. package/dist/service/aiService.d.ts +50 -1
  199. package/dist/service/aiService.js +431 -77
  200. package/dist/service/askFiles.d.ts +49 -0
  201. package/dist/service/askFiles.js +162 -0
  202. package/dist/service/asks.d.ts +76 -0
  203. package/dist/service/asks.js +284 -0
  204. package/dist/service/chatTurn.d.ts +128 -0
  205. package/dist/service/chatTurn.js +1674 -0
  206. package/dist/service/fileStorage.d.ts +4 -0
  207. package/dist/service/fileStorage.js +7 -2
  208. package/dist/service/fileUploadsGate.d.ts +8 -0
  209. package/dist/service/fileUploadsGate.js +18 -0
  210. package/dist/service/fillActionIds.d.ts +6 -0
  211. package/dist/service/fillActionIds.js +79 -0
  212. package/dist/service/gemini.d.ts +3 -3
  213. package/dist/service/gemini.js +3 -3
  214. package/dist/service/jsonFenceModel.d.ts +7 -0
  215. package/dist/service/jsonFenceModel.js +45 -0
  216. package/dist/service/prompts.d.ts +52 -0
  217. package/dist/service/prompts.js +96 -1
  218. package/dist/service/sanitizeHtml.d.ts +11 -0
  219. package/dist/service/sanitizeHtml.js +108 -0
  220. package/dist/service/vertex.d.ts +6 -6
  221. package/dist/service/vertex.js +5 -5
  222. package/dist/types/harness.d.ts +934 -0
  223. package/dist/types/harness.js +133 -0
  224. package/dist/types/index.d.ts +219 -13
  225. package/dist/types/index.js +2 -0
  226. package/dist/types/observability.d.ts +288 -0
  227. package/dist/types/observability.js +2 -0
  228. package/package.json +17 -5
  229. package/src/aiApp.test.ts +207 -1
  230. package/src/aiApp.ts +31 -8
  231. package/src/harness/adminScreens.test.ts +34 -0
  232. package/src/harness/adminScreens.ts +11 -0
  233. package/src/harness/agentLoop.test.ts +1034 -0
  234. package/src/harness/agentLoop.ts +1082 -0
  235. package/src/harness/agentRecovery.test.ts +380 -0
  236. package/src/harness/agentTaskNames.ts +4 -0
  237. package/src/harness/approvalPolicy.ts +28 -0
  238. package/src/harness/approvals.test.ts +1094 -0
  239. package/src/harness/approvals.ts +644 -0
  240. package/src/harness/commit.ts +1049 -0
  241. package/src/harness/conversation.ts +503 -0
  242. package/src/harness/defineAgent.test.ts +92 -0
  243. package/src/harness/defineAgent.ts +82 -0
  244. package/src/harness/defineTask.test.ts +59 -0
  245. package/src/harness/defineTask.ts +76 -0
  246. package/src/harness/defineTool.ts +45 -0
  247. package/src/harness/definitionError.ts +13 -0
  248. package/src/harness/errors.test.ts +90 -0
  249. package/src/harness/errors.ts +119 -0
  250. package/src/harness/eventHub.test.ts +124 -0
  251. package/src/harness/eventHub.ts +159 -0
  252. package/src/harness/events.test.ts +757 -0
  253. package/src/harness/events.ts +384 -0
  254. package/src/harness/executionEnv.ts +34 -0
  255. package/src/harness/extensions.test.ts +1218 -0
  256. package/src/harness/extensions.ts +382 -0
  257. package/src/harness/harness.test.ts +693 -0
  258. package/src/harness/harness.ts +767 -0
  259. package/src/harness/harnessApp.ts +76 -0
  260. package/src/harness/internalRuntime.ts +44 -0
  261. package/src/harness/leases.ts +132 -0
  262. package/src/harness/memo.ts +107 -0
  263. package/src/harness/modelCall.test.ts +134 -0
  264. package/src/harness/modelCall.ts +200 -0
  265. package/src/harness/models/harnessApproval.ts +109 -0
  266. package/src/harness/models/harnessConversation.ts +142 -0
  267. package/src/harness/models/harnessEvent.ts +92 -0
  268. package/src/harness/models/harnessInboxEvent.ts +73 -0
  269. package/src/harness/models/harnessMemo.ts +43 -0
  270. package/src/harness/models/harnessMessage.ts +85 -0
  271. package/src/harness/models/harnessModels.test.ts +60 -0
  272. package/src/harness/models/harnessOwner.ts +40 -0
  273. package/src/harness/models/harnessTask.ts +201 -0
  274. package/src/harness/ownership.test.ts +1087 -0
  275. package/src/harness/ownership.ts +618 -0
  276. package/src/harness/recovery.test.ts +912 -0
  277. package/src/harness/registry.ts +124 -0
  278. package/src/harness/retries.test.ts +292 -0
  279. package/src/harness/retryBackoff.test.ts +100 -0
  280. package/src/harness/retryBackoff.ts +77 -0
  281. package/src/harness/routes/approvals.ts +123 -0
  282. package/src/harness/routes/conversations.test.ts +518 -0
  283. package/src/harness/routes/conversations.ts +102 -0
  284. package/src/harness/routes/events.ts +280 -0
  285. package/src/harness/routes/tasks.test.ts +198 -0
  286. package/src/harness/routes/tasks.ts +146 -0
  287. package/src/harness/runners/inProcessRunner.test.ts +402 -0
  288. package/src/harness/runners/inProcessRunner.ts +220 -0
  289. package/src/harness/runtime.ts +714 -0
  290. package/src/harness/subagent.test.ts +696 -0
  291. package/src/harness/subagent.ts +192 -0
  292. package/src/harness/suspend.ts +13 -0
  293. package/src/harness/transaction.ts +17 -0
  294. package/src/harness/versioning.test.ts +288 -0
  295. package/src/harness/waits.test.ts +693 -0
  296. package/src/harness/waits.ts +356 -0
  297. package/src/index.test.ts +13 -0
  298. package/src/index.ts +70 -0
  299. package/src/isolated/adminScreensConfig.isolated.ts +143 -0
  300. package/src/models/aiDataset.test.ts +34 -0
  301. package/src/models/aiDataset.ts +78 -0
  302. package/src/models/aiRequest.test.ts +2 -2
  303. package/src/models/aiRequest.ts +2 -1
  304. package/src/models/gptHistory.test.ts +156 -0
  305. package/src/models/gptHistory.ts +106 -4
  306. package/src/observability/adminScreens.test.ts +71 -0
  307. package/src/observability/adminScreens.ts +42 -0
  308. package/src/observability/compileTemplate.test.ts +14 -0
  309. package/src/observability/compileTemplate.ts +10 -0
  310. package/src/observability/datasetImport.test.ts +95 -0
  311. package/src/observability/datasetImport.ts +220 -0
  312. package/src/observability/evaluate.test.ts +549 -0
  313. package/src/observability/evaluate.ts +254 -0
  314. package/src/observability/evaluatorTemplates.ts +124 -0
  315. package/src/observability/jsonPath.test.ts +52 -0
  316. package/src/observability/jsonPath.ts +60 -0
  317. package/src/observability/local/datasetStore.test.ts +230 -0
  318. package/src/observability/local/datasetStore.ts +452 -0
  319. package/src/observability/local/evaluatorStore.test.ts +138 -0
  320. package/src/observability/local/evaluatorStore.ts +224 -0
  321. package/src/observability/local/experimentRunner.test.ts +489 -0
  322. package/src/observability/local/experimentRunner.ts +548 -0
  323. package/src/observability/local/localPlugin.ts +88 -0
  324. package/src/observability/local/models/obsDataset.ts +38 -0
  325. package/src/observability/local/models/obsDatasetItem.ts +80 -0
  326. package/src/observability/local/models/obsEvaluator.ts +102 -0
  327. package/src/observability/local/models/obsExperiment.ts +91 -0
  328. package/src/observability/local/models/obsExperimentItem.ts +52 -0
  329. package/src/observability/local/models/obsPrompt.ts +43 -0
  330. package/src/observability/local/models/obsPromptLabel.ts +43 -0
  331. package/src/observability/local/models/obsPromptVersion.ts +107 -0
  332. package/src/observability/local/models/obsReviewItem.ts +79 -0
  333. package/src/observability/local/models/obsScore.ts +59 -0
  334. package/src/observability/local/models/obsSpan.ts +65 -0
  335. package/src/observability/local/models/obsTrace.ts +94 -0
  336. package/src/observability/local/obsModels.test.ts +119 -0
  337. package/src/observability/local/promptStore.test.ts +351 -0
  338. package/src/observability/local/promptStore.ts +665 -0
  339. package/src/observability/local/reviewStore.test.ts +164 -0
  340. package/src/observability/local/reviewStore.ts +264 -0
  341. package/src/observability/local/traceStore.test.ts +264 -0
  342. package/src/observability/local/traceStore.ts +440 -0
  343. package/src/observability/observabilityApp.test.ts +92 -0
  344. package/src/observability/observabilityApp.ts +185 -0
  345. package/src/observability/observabilityAppRegistry.test.ts +30 -0
  346. package/src/observability/observabilityAppRegistry.ts +35 -0
  347. package/src/observability/permissions.test.ts +96 -0
  348. package/src/observability/permissions.ts +78 -0
  349. package/src/observability/reviewPanels.test.ts +35 -0
  350. package/src/observability/reviewPanels.ts +64 -0
  351. package/src/observability/routes/datasets.test.ts +176 -0
  352. package/src/observability/routes/datasets.ts +252 -0
  353. package/src/observability/routes/evaluators.test.ts +119 -0
  354. package/src/observability/routes/evaluators.ts +207 -0
  355. package/src/observability/routes/experiments.test.ts +282 -0
  356. package/src/observability/routes/experiments.ts +152 -0
  357. package/src/observability/routes/observabilityRbac.test.ts +767 -0
  358. package/src/observability/routes/observabilityRouteAccess.ts +106 -0
  359. package/src/observability/routes/prompts.test.ts +320 -0
  360. package/src/observability/routes/prompts.ts +263 -0
  361. package/src/observability/routes/requestAiService.ts +36 -0
  362. package/src/observability/routes/review.test.ts +120 -0
  363. package/src/observability/routes/review.ts +125 -0
  364. package/src/observability/routes/status.test.ts +116 -0
  365. package/src/observability/routes/status.ts +47 -0
  366. package/src/observability/routes/testMultiStage.test.ts +214 -0
  367. package/src/observability/routes/testMultiStage.ts +96 -0
  368. package/src/observability/routes/traces.test.ts +167 -0
  369. package/src/observability/routes/traces.ts +172 -0
  370. package/src/observability/schemaValidation.ts +29 -0
  371. package/src/observability/sopThresholds.ts +20 -0
  372. package/src/observability/status.test.ts +38 -0
  373. package/src/observability/status.ts +56 -0
  374. package/src/observability/testMultiStageSchemas.ts +95 -0
  375. package/src/observability/testMultiStageWorkflow.test.ts +114 -0
  376. package/src/observability/testMultiStageWorkflow.ts +307 -0
  377. package/src/observability/types.ts +262 -0
  378. package/src/routes/files.test.ts +84 -9
  379. package/src/routes/files.ts +23 -7
  380. package/src/routes/gpt.test.ts +3279 -0
  381. package/src/routes/gpt.ts +214 -552
  382. package/src/routes/gptActions.test.ts +241 -0
  383. package/src/routes/gptActions.ts +255 -0
  384. package/src/routes/gptApprovals.test.ts +762 -0
  385. package/src/routes/gptDatasets.test.ts +86 -0
  386. package/src/routes/gptDatasets.ts +104 -0
  387. package/src/routes/gptFiles.test.ts +589 -0
  388. package/src/routes/gptHistories.test.ts +933 -0
  389. package/src/routes/gptHistories.ts +266 -5
  390. package/src/routes/routes.test.ts +676 -5
  391. package/src/service/aiDatasets.test.ts +123 -0
  392. package/src/service/aiDatasets.ts +316 -0
  393. package/src/service/aiService.test.ts +614 -0
  394. package/src/service/aiService.ts +575 -111
  395. package/src/service/askFiles.test.ts +96 -0
  396. package/src/service/askFiles.ts +222 -0
  397. package/src/service/asks.test.ts +946 -0
  398. package/src/service/asks.ts +423 -0
  399. package/src/service/chatTurn.ts +2287 -0
  400. package/src/service/fileStorage.test.ts +11 -0
  401. package/src/service/fileStorage.ts +10 -2
  402. package/src/service/fileUploadsGate.ts +23 -0
  403. package/src/service/fillActionIds.test.ts +65 -0
  404. package/src/service/fillActionIds.ts +98 -0
  405. package/src/service/gemini.test.ts +16 -10
  406. package/src/service/gemini.ts +3 -3
  407. package/src/service/jsonFenceModel.test.ts +47 -0
  408. package/src/service/jsonFenceModel.ts +53 -0
  409. package/src/service/prompts.test.ts +21 -0
  410. package/src/service/prompts.ts +147 -0
  411. package/src/service/sanitizeHtml.test.ts +61 -0
  412. package/src/service/sanitizeHtml.ts +109 -0
  413. package/src/service/vertex.test.ts +49 -49
  414. package/src/service/vertex.ts +7 -8
  415. package/src/tests/bunSetup.test.ts +7 -4
  416. package/src/tests/bunSetup.ts +7 -7
  417. package/src/tests/chatHarness.ts +478 -0
  418. package/src/tests/generateStream.ts +49 -0
  419. package/src/tests/harnessErrors.ts +22 -0
  420. package/src/tests/harnessStreaming.ts +227 -0
  421. package/src/tests/helpers.ts +9 -2
  422. package/src/types/harness.ts +1095 -0
  423. package/src/types/index.ts +237 -12
  424. package/src/types/observability.ts +344 -0
  425. package/src/types/sanitize-html.d.ts +25 -0
@@ -0,0 +1,133 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.HARNESS_APPROVAL_STATUSES = exports.HARNESS_EVENT_TYPES = exports.HARNESS_SUBMIT_DISPOSITIONS = exports.HARNESS_WHEN_BUSY = exports.HARNESS_MESSAGE_ROLES = exports.HARNESS_CONVERSATION_STATUSES = exports.HARNESS_HOOK_KINDS = exports.HARNESS_AGENT_DEFAULT_MAX_STEPS = exports.HARNESS_MODEL_RETRY_DEFAULTS = exports.HARNESS_RESOLVE_ACTIONS = exports.HARNESS_WAIT_RESOLUTIONS = exports.HARNESS_WAIT_POLICIES = exports.HARNESS_WAIT_KINDS = exports.HARNESS_RETRY_DEFAULTS = exports.HARNESS_INTERRUPT_ACTIONS = exports.HARNESS_TERMINAL_STATUSES = exports.HARNESS_TASK_STATUSES = void 0;
4
+ /** Every lifecycle status a harness task can hold. */
5
+ exports.HARNESS_TASK_STATUSES = {
6
+ aborted: "aborted",
7
+ completed: "completed",
8
+ failed: "failed",
9
+ interrupted: "interrupted",
10
+ pending: "pending",
11
+ running: "running",
12
+ waiting: "waiting",
13
+ };
14
+ /** Statuses after which a task never runs again. */
15
+ exports.HARNESS_TERMINAL_STATUSES = new Set([
16
+ exports.HARNESS_TASK_STATUSES.aborted,
17
+ exports.HARNESS_TASK_STATUSES.completed,
18
+ exports.HARNESS_TASK_STATUSES.failed,
19
+ ]);
20
+ /** What an interrupted `replay: "never"` phase does; see `onInterrupt` on `defineTask`. */
21
+ exports.HARNESS_INTERRUPT_ACTIONS = {
22
+ fail: "fail",
23
+ park: "park",
24
+ };
25
+ /** Retry policy applied to fields a task definition leaves out. */
26
+ exports.HARNESS_RETRY_DEFAULTS = {
27
+ backoffMs: 1000,
28
+ maxAttempts: 3,
29
+ maxBackoffMs: 60_000,
30
+ };
31
+ /** What a `waiting` task is blocked on. */
32
+ exports.HARNESS_WAIT_KINDS = {
33
+ event: "event",
34
+ sleep: "sleep",
35
+ tasks: "tasks",
36
+ };
37
+ /** How `rt.waitForTasks` resolves: when every child settles, or at the first failure. */
38
+ exports.HARNESS_WAIT_POLICIES = {
39
+ all: "all",
40
+ failFast: "failFast",
41
+ };
42
+ /** How one `rt.waitFor` / `rt.sleep` call resolved. */
43
+ exports.HARNESS_WAIT_RESOLUTIONS = {
44
+ /** A sleep reached its `timeoutAt`. */
45
+ elapsed: "elapsed",
46
+ /** An event was delivered. */
47
+ event: "event",
48
+ /** An event wait reached its `timeoutAt` first. */
49
+ timeout: "timeout",
50
+ };
51
+ /** How an interrupted task is resolved by an operator. */
52
+ exports.HARNESS_RESOLVE_ACTIONS = {
53
+ abort: "abort",
54
+ complete: "complete",
55
+ retry: "retry",
56
+ };
57
+ /** Defaults for an agent's model-call retries (per model, before fallbacks). */
58
+ exports.HARNESS_MODEL_RETRY_DEFAULTS = {
59
+ backoffMs: 500,
60
+ maxAttempts: 3,
61
+ maxBackoffMs: 8000,
62
+ };
63
+ /** Model requests one turn may make when an agent leaves `maxSteps` out. */
64
+ exports.HARNESS_AGENT_DEFAULT_MAX_STEPS = 10;
65
+ exports.HARNESS_HOOK_KINDS = {
66
+ afterTool: "afterTool",
67
+ beforeModelRequest: "beforeModelRequest",
68
+ beforeTool: "beforeTool",
69
+ };
70
+ exports.HARNESS_CONVERSATION_STATUSES = {
71
+ busy: "busy",
72
+ idle: "idle",
73
+ };
74
+ exports.HARNESS_MESSAGE_ROLES = {
75
+ assistant: "assistant",
76
+ system: "system",
77
+ tool: "tool",
78
+ user: "user",
79
+ };
80
+ /** What `send` does with a message that arrives while a turn is running. */
81
+ exports.HARNESS_WHEN_BUSY = {
82
+ /** Run it as its own turn once the active turn (and any earlier queued ones) finish. */
83
+ queue: "queue",
84
+ /** Add it to the active turn: its next model request includes the message. */
85
+ steer: "steer",
86
+ };
87
+ /** How `send` handled a submission. */
88
+ exports.HARNESS_SUBMIT_DISPOSITIONS = {
89
+ /** Waiting for the active turn (and earlier queued submissions) to finish. */
90
+ queued: "queued",
91
+ /** Started a new turn. */
92
+ started: "started",
93
+ /** Joined the active turn; its next model request includes the message. */
94
+ steered: "steered",
95
+ };
96
+ // ---------------------------------------------------------------------------------------
97
+ // Event log (SSE source)
98
+ // ---------------------------------------------------------------------------------------
99
+ /** Every `HarnessEvent` type. Conversation streams and task streams carry different ones. */
100
+ exports.HARNESS_EVENT_TYPES = {
101
+ /** Task stream: an approval was approved, rejected, or expired. */
102
+ approvalDecided: "approval.decided",
103
+ /** Task stream: `rt.approval` created a pending approval. */
104
+ approvalRequested: "approval.requested",
105
+ /** Conversation stream: coalesced model text while a request streams; expires. */
106
+ delta: "delta",
107
+ /** Conversation stream: a transcript message was committed. */
108
+ messageCreated: "message.created",
109
+ /** Conversation stream: `send` queued a message or added it to the active turn. */
110
+ messageQueued: "message.queued",
111
+ /** Task stream: text a phase sent with `rt.output`. */
112
+ output: "output",
113
+ /** Task stream: a task was created or committed a new status or phase. */
114
+ taskStatus: "task.status",
115
+ /** Conversation stream: a tool call's task ended. */
116
+ toolFinished: "tool.finished",
117
+ /** Conversation stream: a tool call's task was created. */
118
+ toolStarted: "tool.started",
119
+ /** Conversation stream: a turn task ended. */
120
+ turnFinished: "turn.finished",
121
+ /** Conversation stream: a turn task was created. */
122
+ turnStarted: "turn.started",
123
+ };
124
+ // ---------------------------------------------------------------------------------------
125
+ // Approvals
126
+ // ---------------------------------------------------------------------------------------
127
+ /** Lifecycle of a `HarnessApproval`. */
128
+ exports.HARNESS_APPROVAL_STATUSES = {
129
+ approved: "approved",
130
+ expired: "expired",
131
+ pending: "pending",
132
+ rejected: "rejected",
133
+ };
@@ -1,7 +1,8 @@
1
1
  import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "@terreno/api";
2
- import type { LanguageModel, StopCondition, ToolSet } from "ai";
2
+ import type { Ask, AskKind, ConfirmAskInput, DatasetColumn, SimpleCard } from "@terreno/blocks";
3
+ import type { LanguageModel, ModelMessage, StopCondition, ToolSet } from "ai";
3
4
  import type mongoose from "mongoose";
4
- export declare const DEFAULT_AI_REQUEST_TYPES: readonly ["general", "json_array", "json_object", "json_value", "remix", "summarization", "translation"];
5
+ export declare const DEFAULT_AI_REQUEST_TYPES: readonly ["general", "json_array", "json_object", "json_value", "remix", "summarization", "translation", "ui_action", "ui_blocks"];
5
6
  export type DefaultAIRequestType = (typeof DEFAULT_AI_REQUEST_TYPES)[number];
6
7
  export type AIRequestType = DefaultAIRequestType | (string & {});
7
8
  export interface AIRequestDocument extends mongoose.Document<mongoose.Types.ObjectId> {
@@ -56,17 +57,37 @@ export interface ImageContentPart {
56
57
  type: "image";
57
58
  url: string;
58
59
  mimeType?: string;
60
+ /** Durable storage key when the attachment was uploaded through FileStorageService. */
61
+ gcsKey?: string;
59
62
  }
60
63
  export interface FileContentPart {
61
64
  type: "file";
62
65
  url: string;
63
66
  filename?: string;
64
67
  mimeType: string;
68
+ /** Durable storage key when the attachment was uploaded through FileStorageService. */
69
+ gcsKey?: string;
65
70
  }
66
71
  export type MessageContentPart = TextContentPart | ImageContentPart | FileContentPart;
72
+ export type GptHistoryAskStatus = "pending" | "answered" | "cancelled";
73
+ /** Set on asks the server makes itself: `approval` asks before a host tool with `needsApproval` runs. */
74
+ export type AskOrigin = "approval";
75
+ /** Marks a `tool-call` row as an ask and records whether the user has answered it. */
76
+ export interface GptHistoryPromptAsk {
77
+ kind: AskKind;
78
+ /** `approval` when the server asked before a host tool runs; the row is then display-only. */
79
+ origin?: AskOrigin;
80
+ status: GptHistoryAskStatus;
81
+ }
82
+ /** Lifecycle of an assistant reply that is persisted while it streams. */
83
+ export type GptHistoryPromptStatus = "streaming" | "complete" | "error";
67
84
  export interface GptHistoryPrompt {
68
85
  model?: string;
69
86
  rating?: "up" | "down";
87
+ /** Set on assistant replies produced by /gpt/prompt. "streaming" while partial text is persisted. */
88
+ status?: GptHistoryPromptStatus;
89
+ /** Identifies one /gpt/prompt reply so resume clients can follow it. */
90
+ streamId?: string;
70
91
  text: string;
71
92
  type: "user" | "assistant" | "system" | "tool-call" | "tool-result";
72
93
  content?: MessageContentPart[];
@@ -74,10 +95,28 @@ export interface GptHistoryPrompt {
74
95
  toolName?: string;
75
96
  args?: Record<string, unknown>;
76
97
  result?: unknown;
98
+ ask?: GptHistoryPromptAsk;
77
99
  }
100
+ interface GptHistoryPendingAskState {
101
+ /** The AI SDK approval request an `approval` ask answers. It is also the ask's `toolCallId`. */
102
+ approvalId?: string;
103
+ created: Date;
104
+ origin?: AskOrigin;
105
+ /** Number of leading `prompts` rows that form the paused turn's history. */
106
+ promptIndex: number;
107
+ /** AI SDK messages the paused turn produced, replayed verbatim when the user answers. */
108
+ responseMessages: ModelMessage[];
109
+ simple: SimpleCard;
110
+ toolCallId: string;
111
+ /** The host tool an `approval` ask asks to run. */
112
+ toolName?: string;
113
+ }
114
+ /** The ask a history is waiting on. At most one per history. */
115
+ export type GptHistoryPendingAsk = Ask & GptHistoryPendingAskState;
78
116
  export interface GptHistoryDocument extends mongoose.Document<mongoose.Types.ObjectId> {
79
117
  created: Date;
80
118
  deleted: boolean;
119
+ pendingAsk?: GptHistoryPendingAsk;
81
120
  projectId?: mongoose.Types.ObjectId;
82
121
  prompts: GptHistoryPrompt[];
83
122
  title?: string;
@@ -112,7 +151,18 @@ export interface AIServiceOptions {
112
151
  defaultTemperature?: number;
113
152
  model: LanguageModel;
114
153
  }
115
- export interface GenerateTextOptions {
154
+ export interface GenerateObservabilityOptions {
155
+ priceMap?: Record<string, {
156
+ inputPerMTok: number;
157
+ outputPerMTok: number;
158
+ }>;
159
+ promptLabel?: string;
160
+ promptName?: string;
161
+ sensitive?: boolean;
162
+ sessionId?: string;
163
+ skipTrace?: boolean;
164
+ }
165
+ export interface GenerateTextOptions extends GenerateObservabilityOptions {
116
166
  maxOutputTokens?: number;
117
167
  prompt: string;
118
168
  stopWhen?: StopCondition<ToolSet>;
@@ -122,14 +172,14 @@ export interface GenerateTextOptions {
122
172
  tools?: Record<string, import("ai").Tool>;
123
173
  userId?: mongoose.Types.ObjectId;
124
174
  }
125
- export interface GenerateStreamOptions {
175
+ export interface GenerateStreamOptions extends GenerateObservabilityOptions {
126
176
  maxOutputTokens?: number;
127
177
  prompt: string;
128
178
  systemPrompt?: string;
129
179
  temperature?: number;
130
180
  userId?: mongoose.Types.ObjectId;
131
181
  }
132
- export interface GenerateChatStreamOptions {
182
+ export interface GenerateChatStreamOptions extends GenerateObservabilityOptions {
133
183
  messages: Array<{
134
184
  content: string;
135
185
  role: "user" | "assistant" | "system";
@@ -140,21 +190,21 @@ export interface GenerateChatStreamOptions {
140
190
  tools?: Record<string, import("ai").Tool>;
141
191
  userId?: mongoose.Types.ObjectId;
142
192
  }
143
- export interface RemixOptions {
193
+ export interface RemixOptions extends GenerateObservabilityOptions {
144
194
  text: string;
145
195
  userId?: mongoose.Types.ObjectId;
146
196
  }
147
- export interface SummaryOptions {
197
+ export interface SummaryOptions extends GenerateObservabilityOptions {
148
198
  text: string;
149
199
  userId?: mongoose.Types.ObjectId;
150
200
  }
151
- export interface TranslateOptions {
201
+ export interface TranslateOptions extends GenerateObservabilityOptions {
152
202
  sourceLanguage?: string;
153
203
  targetLanguage: string;
154
204
  text: string;
155
205
  userId?: mongoose.Types.ObjectId;
156
206
  }
157
- export interface GenerateJsonValueOptions {
207
+ export interface GenerateJsonValueOptions extends GenerateObservabilityOptions {
158
208
  maxOutputTokens?: number;
159
209
  /** Optional name passed to the provider for structured-output guidance. */
160
210
  outputName?: string;
@@ -165,7 +215,7 @@ export interface GenerateJsonValueOptions {
165
215
  temperature?: number;
166
216
  userId?: mongoose.Types.ObjectId;
167
217
  }
168
- export interface GenerateJsonObjectOptions<OBJECT> {
218
+ export interface GenerateJsonObjectOptions<OBJECT> extends GenerateObservabilityOptions {
169
219
  maxOutputTokens?: number;
170
220
  prompt: string;
171
221
  /** Zod schema, `jsonSchema(...)`, or other `FlexibleSchema` accepted by the AI SDK. */
@@ -176,7 +226,30 @@ export interface GenerateJsonObjectOptions<OBJECT> {
176
226
  temperature?: number;
177
227
  userId?: mongoose.Types.ObjectId;
178
228
  }
179
- export interface GenerateJsonArrayOptions<ELEMENT> {
229
+ export interface ObsTestMultiStageCall1Output {
230
+ phrase: string;
231
+ }
232
+ export interface ObsTestMultiStageCall2Output {
233
+ keywords: string[];
234
+ }
235
+ export interface ObsTestMultiStageMetrics {
236
+ call1: {
237
+ charCount: number;
238
+ wordCount: number;
239
+ };
240
+ call2: {
241
+ charCount: number;
242
+ wordCount: number;
243
+ };
244
+ combinedCharCount: number;
245
+ }
246
+ export interface ObsTestMultiStageFinalOutput {
247
+ keywords: string[];
248
+ metrics: ObsTestMultiStageMetrics;
249
+ phrase: string;
250
+ sentence: string;
251
+ }
252
+ export interface GenerateJsonArrayOptions<ELEMENT> extends GenerateObservabilityOptions {
180
253
  /** Schema for each array element. */
181
254
  element: import("ai").FlexibleSchema<ELEMENT>;
182
255
  /** Optional description for the array output (provider guidance). */
@@ -189,29 +262,136 @@ export interface GenerateJsonArrayOptions<ELEMENT> {
189
262
  temperature?: number;
190
263
  userId?: mongoose.Types.ObjectId;
191
264
  }
265
+ /** Makes the `confirm` input of the approval ask for one call of a host tool, from the call's input. */
266
+ export type ApprovalAskInput = (input: unknown) => ConfirmAskInput;
267
+ export interface AsksOptions {
268
+ /**
269
+ * The approval ask for host tools with `needsApproval`, by tool name. Without an entry, or when
270
+ * it throws or returns an input that is not a valid `confirm` input, the ask is "Allow
271
+ * <toolName>?" with the tool's description and Allow / Deny buttons.
272
+ */
273
+ approvals?: Record<string, ApprovalAskInput>;
274
+ /** Ask kinds offered to the model, each as the tool `ask_<kind>`. Defaults to every kind. */
275
+ kinds?: AskKind[];
276
+ /**
277
+ * The per-file cap for answers to a `files` ask, in bytes. Defaults to 10 MB, the
278
+ * `/files/upload` default; `AiApp` applies it to `/files/upload` too.
279
+ */
280
+ maxFileSizeBytes?: number;
281
+ }
282
+ /** Loads an upload's bytes by its GCS key. `FileStorageService` implements it. */
283
+ export interface AskFileDownloader {
284
+ download: (gcsKey: string) => Promise<Buffer>;
285
+ }
286
+ /** What a host callback may return. `blocks` is a whole-reply document. */
287
+ export interface HostActionResult {
288
+ blocks?: unknown;
289
+ replace?: "block" | "message";
290
+ text?: string;
291
+ }
292
+ /** A Zod schema's `safeParse`, so hosts can pass `z.object(...)` without this package depending on a Zod version. */
293
+ export interface HostPayloadSchema {
294
+ safeParse: (value: unknown) => {
295
+ data: unknown;
296
+ success: true;
297
+ } | {
298
+ error: {
299
+ issues: {
300
+ message: string;
301
+ path: PropertyKey[];
302
+ }[];
303
+ };
304
+ success: false;
305
+ };
306
+ }
307
+ export interface HostActionContext {
308
+ blockId: string;
309
+ elementId: string;
310
+ history: GptHistoryDocument;
311
+ messageId: string;
312
+ payload: unknown;
313
+ user: {
314
+ _id?: mongoose.Types.ObjectId;
315
+ };
316
+ }
317
+ /** `addGptRoutes` `uiBlocks`. `true` checks every assistant reply. `hostActions` names the callbacks the model may emit. */
318
+ export interface UiBlocksOptions {
319
+ /** Milliseconds before a host callback returns 504. Default 10 seconds. */
320
+ actionTimeoutMs?: number;
321
+ /** Rows stored by `registerAiDataset`. Default 50,000. A larger write returns 413. */
322
+ datasetMaxRows?: number;
323
+ /** Days before a stored dataset expires. `0` (the default) keeps it. */
324
+ datasetTtlDays?: number;
325
+ /** When true, `html` blocks are allowed and sanitized before they are stored. */
326
+ html?: boolean;
327
+ /** Hostnames allowed on `https` image sources. Empty rejects every https image. */
328
+ imageHosts?: readonly string[];
329
+ hostActions?: Record<string, {
330
+ handler?: (context: HostActionContext) => Promise<HostActionResult | undefined> | HostActionResult | undefined;
331
+ payload?: HostPayloadSchema;
332
+ }>;
333
+ repair?: boolean;
334
+ }
192
335
  export interface GptRouteOptions {
193
336
  /** Pre-configured AIService. Optional when using per-request keys or demo mode. */
194
337
  aiService?: import("../service/aiService").AIService;
338
+ /**
339
+ * Let the model ask the user typed questions with client-side ask tools. `true` offers every
340
+ * ask kind. Off by default; when off, tools, system prompt, SSE events, and the `/gpt/histories`
341
+ * routes are unchanged.
342
+ */
343
+ asks?: boolean | AsksOptions;
195
344
  /** Factory to create a LanguageModel from a per-request API key (x-ai-api-key header). */
196
345
  createModelFn?: (apiKey: string, modelId?: string) => import("ai").LanguageModel;
197
346
  /** Factory to create a LanguageModel on the server side without a per-request key (e.g. Vertex AI with ADC). Used for model switching when no x-ai-api-key header is present. Returns undefined if no provider is configured (falls through to demo mode). */
198
347
  createServerModelFn?: (modelId?: string) => import("ai").LanguageModel | undefined;
199
348
  /** Factory to create per-request tools (e.g. tools that need the request's API key). Merged with static tools. */
200
349
  createRequestTools?: (req: import("express").Request) => Record<string, import("ai").Tool>;
201
- /** Return canned responses when no AI service is available. */
350
+ /** Not read: the routes send a canned demo reply whenever no AI service resolves. */
202
351
  demoMode?: boolean;
352
+ /**
353
+ * Where uploads are stored. `download` loads a `files` ask by `fileId`. `upload` and
354
+ * `getSignedUrl` store `data:` attachments and sign them on later turns. A service with only
355
+ * `download` still answers `files` asks; attachments are then saved as sent.
356
+ */
357
+ fileStorageService?: import("../service/fileStorage").FileStorageService | AskFileDownloader;
203
358
  mcpService?: import("../service/mcpService").MCPService;
204
359
  openApiOptions?: Record<string, unknown>;
205
360
  tools?: Record<string, import("ai").Tool>;
206
361
  toolChoice?: "auto" | "none" | "required";
207
362
  maxSteps?: number;
208
- /** Cheap model ID used for generating conversation titles (e.g. "gemini-2.0-flash-lite"). Falls back to the main model if not set. */
363
+ /** Cheap model ID used for generating conversation titles (e.g. "gemini-3.5-flash-lite"). Falls back to the main model if not set. */
209
364
  titleModelId?: string;
365
+ /**
366
+ * Assistant replies are whole-reply block documents. Off by default; when off, the system
367
+ * prompt, SSE events, `/gpt/datasets`, and `/gpt/actions` are unchanged. `true` validates the
368
+ * final text, emits `{blocks}` before `{done}`, and mounts `GET /gpt/datasets/:id` and
369
+ * `POST /gpt/actions`. `{repair: true}` runs one repair call when that check fails.
370
+ */
371
+ uiBlocks?: boolean | UiBlocksOptions;
210
372
  /** Langfuse prompt name to load and use as the system prompt. Compiled with no variables.
211
373
  * Falls back gracefully if Langfuse is not configured or the prompt is not found. */
212
374
  langfuseSystemPromptName?: string;
375
+ /**
376
+ * When `false` or the function returns `false`, prompts that include attachments are rejected.
377
+ * Omit or pass `true` to leave uploads enabled.
378
+ */
379
+ fileUploadsEnabled?: import("../service/fileUploadsGate").FileUploadsEnabled;
380
+ /** How often partial assistant output is persisted while streaming. Defaults to 1000ms. */
381
+ streamPersistIntervalMs?: number;
382
+ /** How often the resume endpoint polls for new partial output. Defaults to 500ms. */
383
+ streamResumePollIntervalMs?: number;
384
+ /** A streaming reply with no persisted update for this long is treated as interrupted. Defaults to 60000ms. */
385
+ streamStaleAfterMs?: number;
213
386
  }
214
387
  export interface GptHistoryRouteOptions {
388
+ /**
389
+ * The chat options headless turns run with, usually the ones passed to `addGptRoutes`. When they
390
+ * turn `asks` on, `/gpt/histories` adds `GET pendingAsks` and `POST /:id/turn` for clients that do
391
+ * not read server-sent events, such as a watch app. With `asks` off it adds neither, so a host
392
+ * that never turned asks on gets no new endpoints.
393
+ */
394
+ chat?: GptRouteOptions;
215
395
  openApiOptions?: Record<string, unknown>;
216
396
  }
217
397
  export interface AiRequestsExplorerRouteOptions {
@@ -221,11 +401,36 @@ export interface FileRouteOptions {
221
401
  gcsBucket: string;
222
402
  maxFileSize?: number;
223
403
  openApiOptions?: Record<string, unknown>;
404
+ /**
405
+ * When `false` or the function returns `false`, `POST /files/upload` is rejected.
406
+ * Reads and deletes stay available. Omit or pass `true` to leave uploads enabled.
407
+ */
408
+ fileUploadsEnabled?: import("../service/fileUploadsGate").FileUploadsEnabled;
224
409
  }
225
410
  export interface McpRouteOptions {
226
411
  mcpService: import("../service/mcpService").MCPService;
227
412
  openApiOptions?: Record<string, unknown>;
228
413
  }
414
+ export type AIDatasetColumn = DatasetColumn;
415
+ export type AIDatasetCell = string | number | null;
416
+ /** No instance methods. `ownerId` is a virtual of `userId`. */
417
+ export type AIDatasetMethods = Record<string, never>;
418
+ export interface AIDatasetDocument extends mongoose.Document<mongoose.Types.ObjectId> {
419
+ columns: AIDatasetColumn[];
420
+ created: Date;
421
+ deleted: boolean;
422
+ expiresAt?: Date;
423
+ historyId: mongoose.Types.ObjectId;
424
+ rowCount: number;
425
+ rows: AIDatasetCell[][];
426
+ updated: Date;
427
+ userId: mongoose.Types.ObjectId;
428
+ }
429
+ export interface AIDatasetStatics extends FindExactlyOnePlugin<AIDatasetDocument>, FindOneOrNonePlugin<AIDatasetDocument> {
430
+ }
431
+ export interface AIDatasetModel extends mongoose.Model<AIDatasetDocument, object, AIDatasetMethods>, AIDatasetStatics {
432
+ }
433
+ export type AIDatasetSchema = mongoose.Schema<AIDatasetDocument, AIDatasetModel, AIDatasetMethods>;
229
434
  export interface FileAttachmentDocument extends mongoose.Document<mongoose.Types.ObjectId> {
230
435
  created: Date;
231
436
  deleted: boolean;
@@ -249,3 +454,4 @@ export interface MCPServerConfig {
249
454
  headers?: Record<string, string>;
250
455
  };
251
456
  }
457
+ export {};
@@ -12,4 +12,6 @@ exports.DEFAULT_AI_REQUEST_TYPES = [
12
12
  "remix",
13
13
  "summarization",
14
14
  "translation",
15
+ "ui_action",
16
+ "ui_blocks",
15
17
  ];