@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.
- package/.cursorrules +2 -2
- package/README.md +2 -1
- package/bunfig.toml +1 -1
- package/dist/aiApp.d.ts +16 -5
- package/dist/aiApp.js +17 -7
- package/dist/harness/adminScreens.d.ts +6 -0
- package/dist/harness/adminScreens.js +11 -0
- package/dist/harness/agentLoop.d.ts +61 -0
- package/dist/harness/agentLoop.js +798 -0
- package/dist/harness/agentTaskNames.d.ts +4 -0
- package/dist/harness/agentTaskNames.js +7 -0
- package/dist/harness/approvalPolicy.d.ts +3 -0
- package/dist/harness/approvalPolicy.js +23 -0
- package/dist/harness/approvals.d.ts +101 -0
- package/dist/harness/approvals.js +468 -0
- package/dist/harness/commit.d.ts +238 -0
- package/dist/harness/commit.js +678 -0
- package/dist/harness/conversation.d.ts +75 -0
- package/dist/harness/conversation.js +397 -0
- package/dist/harness/defineAgent.d.ts +9 -0
- package/dist/harness/defineAgent.js +65 -0
- package/dist/harness/defineTask.d.ts +11 -0
- package/dist/harness/defineTask.js +59 -0
- package/dist/harness/defineTool.d.ts +7 -0
- package/dist/harness/defineTool.js +36 -0
- package/dist/harness/definitionError.d.ts +8 -0
- package/dist/harness/definitionError.js +15 -0
- package/dist/harness/errors.d.ts +127 -0
- package/dist/harness/errors.js +101 -0
- package/dist/harness/eventHub.d.ts +45 -0
- package/dist/harness/eventHub.js +135 -0
- package/dist/harness/events.d.ts +95 -0
- package/dist/harness/events.js +267 -0
- package/dist/harness/executionEnv.d.ts +31 -0
- package/dist/harness/executionEnv.js +2 -0
- package/dist/harness/extensions.d.ts +82 -0
- package/dist/harness/extensions.js +274 -0
- package/dist/harness/harness.d.ts +163 -0
- package/dist/harness/harness.js +520 -0
- package/dist/harness/harnessApp.d.ts +44 -0
- package/dist/harness/harnessApp.js +62 -0
- package/dist/harness/internalRuntime.d.ts +16 -0
- package/dist/harness/internalRuntime.js +18 -0
- package/dist/harness/leases.d.ts +35 -0
- package/dist/harness/leases.js +86 -0
- package/dist/harness/memo.d.ts +24 -0
- package/dist/harness/memo.js +78 -0
- package/dist/harness/modelCall.d.ts +45 -0
- package/dist/harness/modelCall.js +147 -0
- package/dist/harness/models/harnessApproval.d.ts +2 -0
- package/dist/harness/models/harnessApproval.js +100 -0
- package/dist/harness/models/harnessConversation.d.ts +2 -0
- package/dist/harness/models/harnessConversation.js +117 -0
- package/dist/harness/models/harnessEvent.d.ts +3 -0
- package/dist/harness/models/harnessEvent.js +73 -0
- package/dist/harness/models/harnessInboxEvent.d.ts +2 -0
- package/dist/harness/models/harnessInboxEvent.js +58 -0
- package/dist/harness/models/harnessMemo.d.ts +2 -0
- package/dist/harness/models/harnessMemo.js +42 -0
- package/dist/harness/models/harnessMessage.d.ts +2 -0
- package/dist/harness/models/harnessMessage.js +73 -0
- package/dist/harness/models/harnessOwner.d.ts +2 -0
- package/dist/harness/models/harnessOwner.js +36 -0
- package/dist/harness/models/harnessTask.d.ts +2 -0
- package/dist/harness/models/harnessTask.js +186 -0
- package/dist/harness/ownership.d.ts +89 -0
- package/dist/harness/ownership.js +438 -0
- package/dist/harness/registry.d.ts +29 -0
- package/dist/harness/registry.js +93 -0
- package/dist/harness/retryBackoff.d.ts +31 -0
- package/dist/harness/retryBackoff.js +50 -0
- package/dist/harness/routes/approvals.d.ts +13 -0
- package/dist/harness/routes/approvals.js +93 -0
- package/dist/harness/routes/conversations.d.ts +11 -0
- package/dist/harness/routes/conversations.js +66 -0
- package/dist/harness/routes/events.d.ts +19 -0
- package/dist/harness/routes/events.js +215 -0
- package/dist/harness/routes/tasks.d.ts +11 -0
- package/dist/harness/routes/tasks.js +108 -0
- package/dist/harness/runners/inProcessRunner.d.ts +57 -0
- package/dist/harness/runners/inProcessRunner.js +196 -0
- package/dist/harness/runtime.d.ts +34 -0
- package/dist/harness/runtime.js +551 -0
- package/dist/harness/subagent.d.ts +53 -0
- package/dist/harness/subagent.js +134 -0
- package/dist/harness/suspend.d.ts +8 -0
- package/dist/harness/suspend.js +16 -0
- package/dist/harness/transaction.d.ts +3 -0
- package/dist/harness/transaction.js +22 -0
- package/dist/harness/waits.d.ts +100 -0
- package/dist/harness/waits.js +214 -0
- package/dist/index.d.ts +19 -1
- package/dist/index.js +45 -2
- package/dist/models/aiDataset.d.ts +2 -0
- package/dist/models/aiDataset.js +67 -0
- package/dist/models/aiRequest.js +1 -1
- package/dist/models/gptHistory.js +88 -2
- package/dist/observability/adminScreens.d.ts +5 -0
- package/dist/observability/adminScreens.js +32 -0
- package/dist/observability/compileTemplate.d.ts +1 -0
- package/dist/observability/compileTemplate.js +13 -0
- package/dist/observability/datasetImport.d.ts +11 -0
- package/dist/observability/datasetImport.js +185 -0
- package/dist/observability/evaluate.d.ts +31 -0
- package/dist/observability/evaluate.js +200 -0
- package/dist/observability/evaluatorTemplates.d.ts +17 -0
- package/dist/observability/evaluatorTemplates.js +111 -0
- package/dist/observability/jsonPath.d.ts +2 -0
- package/dist/observability/jsonPath.js +57 -0
- package/dist/observability/local/datasetStore.d.ts +87 -0
- package/dist/observability/local/datasetStore.js +326 -0
- package/dist/observability/local/evaluatorStore.d.ts +44 -0
- package/dist/observability/local/evaluatorStore.js +182 -0
- package/dist/observability/local/experimentRunner.d.ts +96 -0
- package/dist/observability/local/experimentRunner.js +419 -0
- package/dist/observability/local/localPlugin.d.ts +22 -0
- package/dist/observability/local/localPlugin.js +76 -0
- package/dist/observability/local/models/obsDataset.d.ts +2 -0
- package/dist/observability/local/models/obsDataset.js +37 -0
- package/dist/observability/local/models/obsDatasetItem.d.ts +2 -0
- package/dist/observability/local/models/obsDatasetItem.js +76 -0
- package/dist/observability/local/models/obsEvaluator.d.ts +2 -0
- package/dist/observability/local/models/obsEvaluator.js +98 -0
- package/dist/observability/local/models/obsExperiment.d.ts +2 -0
- package/dist/observability/local/models/obsExperiment.js +87 -0
- package/dist/observability/local/models/obsExperimentItem.d.ts +2 -0
- package/dist/observability/local/models/obsExperimentItem.js +45 -0
- package/dist/observability/local/models/obsPrompt.d.ts +2 -0
- package/dist/observability/local/models/obsPrompt.js +42 -0
- package/dist/observability/local/models/obsPromptLabel.d.ts +2 -0
- package/dist/observability/local/models/obsPromptLabel.js +39 -0
- package/dist/observability/local/models/obsPromptVersion.d.ts +2 -0
- package/dist/observability/local/models/obsPromptVersion.js +96 -0
- package/dist/observability/local/models/obsReviewItem.d.ts +2 -0
- package/dist/observability/local/models/obsReviewItem.js +75 -0
- package/dist/observability/local/models/obsScore.d.ts +2 -0
- package/dist/observability/local/models/obsScore.js +58 -0
- package/dist/observability/local/models/obsSpan.d.ts +2 -0
- package/dist/observability/local/models/obsSpan.js +64 -0
- package/dist/observability/local/models/obsTrace.d.ts +2 -0
- package/dist/observability/local/models/obsTrace.js +93 -0
- package/dist/observability/local/promptStore.d.ts +180 -0
- package/dist/observability/local/promptStore.js +444 -0
- package/dist/observability/local/reviewStore.d.ts +50 -0
- package/dist/observability/local/reviewStore.js +203 -0
- package/dist/observability/local/traceStore.d.ts +103 -0
- package/dist/observability/local/traceStore.js +325 -0
- package/dist/observability/observabilityApp.d.ts +24 -0
- package/dist/observability/observabilityApp.js +157 -0
- package/dist/observability/observabilityAppRegistry.d.ts +14 -0
- package/dist/observability/observabilityAppRegistry.js +16 -0
- package/dist/observability/permissions.d.ts +7 -0
- package/dist/observability/permissions.js +60 -0
- package/dist/observability/reviewPanels.d.ts +18 -0
- package/dist/observability/reviewPanels.js +46 -0
- package/dist/observability/routes/datasets.d.ts +7 -0
- package/dist/observability/routes/datasets.js +149 -0
- package/dist/observability/routes/evaluators.d.ts +7 -0
- package/dist/observability/routes/evaluators.js +123 -0
- package/dist/observability/routes/experiments.d.ts +7 -0
- package/dist/observability/routes/experiments.js +95 -0
- package/dist/observability/routes/observabilityRouteAccess.d.ts +13 -0
- package/dist/observability/routes/observabilityRouteAccess.js +67 -0
- package/dist/observability/routes/prompts.d.ts +12 -0
- package/dist/observability/routes/prompts.js +172 -0
- package/dist/observability/routes/requestAiService.d.ts +13 -0
- package/dist/observability/routes/requestAiService.js +21 -0
- package/dist/observability/routes/review.d.ts +7 -0
- package/dist/observability/routes/review.js +79 -0
- package/dist/observability/routes/status.d.ts +5 -0
- package/dist/observability/routes/status.js +31 -0
- package/dist/observability/routes/testMultiStage.d.ts +9 -0
- package/dist/observability/routes/testMultiStage.js +67 -0
- package/dist/observability/routes/traces.d.ts +7 -0
- package/dist/observability/routes/traces.js +129 -0
- package/dist/observability/schemaValidation.d.ts +5 -0
- package/dist/observability/schemaValidation.js +26 -0
- package/dist/observability/sopThresholds.d.ts +2 -0
- package/dist/observability/sopThresholds.js +21 -0
- package/dist/observability/status.d.ts +23 -0
- package/dist/observability/status.js +34 -0
- package/dist/observability/testMultiStageSchemas.d.ts +10 -0
- package/dist/observability/testMultiStageSchemas.js +79 -0
- package/dist/observability/testMultiStageWorkflow.d.ts +20 -0
- package/dist/observability/testMultiStageWorkflow.js +218 -0
- package/dist/observability/types.d.ts +159 -0
- package/dist/observability/types.js +67 -0
- package/dist/routes/files.js +20 -7
- package/dist/routes/gpt.js +179 -488
- package/dist/routes/gptActions.d.ts +9 -0
- package/dist/routes/gptActions.js +212 -0
- package/dist/routes/gptDatasets.d.ts +5 -0
- package/dist/routes/gptDatasets.js +94 -0
- package/dist/routes/gptHistories.d.ts +3 -1
- package/dist/routes/gptHistories.js +188 -2
- package/dist/service/aiDatasets.d.ts +57 -0
- package/dist/service/aiDatasets.js +253 -0
- package/dist/service/aiService.d.ts +50 -1
- package/dist/service/aiService.js +431 -77
- package/dist/service/askFiles.d.ts +49 -0
- package/dist/service/askFiles.js +162 -0
- package/dist/service/asks.d.ts +76 -0
- package/dist/service/asks.js +284 -0
- package/dist/service/chatTurn.d.ts +128 -0
- package/dist/service/chatTurn.js +1674 -0
- package/dist/service/fileStorage.d.ts +4 -0
- package/dist/service/fileStorage.js +7 -2
- package/dist/service/fileUploadsGate.d.ts +8 -0
- package/dist/service/fileUploadsGate.js +18 -0
- package/dist/service/fillActionIds.d.ts +6 -0
- package/dist/service/fillActionIds.js +79 -0
- package/dist/service/gemini.d.ts +3 -3
- package/dist/service/gemini.js +3 -3
- package/dist/service/jsonFenceModel.d.ts +7 -0
- package/dist/service/jsonFenceModel.js +45 -0
- package/dist/service/prompts.d.ts +52 -0
- package/dist/service/prompts.js +96 -1
- package/dist/service/sanitizeHtml.d.ts +11 -0
- package/dist/service/sanitizeHtml.js +108 -0
- package/dist/service/vertex.d.ts +6 -6
- package/dist/service/vertex.js +5 -5
- package/dist/types/harness.d.ts +934 -0
- package/dist/types/harness.js +133 -0
- package/dist/types/index.d.ts +219 -13
- package/dist/types/index.js +2 -0
- package/dist/types/observability.d.ts +288 -0
- package/dist/types/observability.js +2 -0
- package/package.json +17 -5
- package/src/aiApp.test.ts +207 -1
- package/src/aiApp.ts +31 -8
- package/src/harness/adminScreens.test.ts +34 -0
- package/src/harness/adminScreens.ts +11 -0
- package/src/harness/agentLoop.test.ts +1034 -0
- package/src/harness/agentLoop.ts +1082 -0
- package/src/harness/agentRecovery.test.ts +380 -0
- package/src/harness/agentTaskNames.ts +4 -0
- package/src/harness/approvalPolicy.ts +28 -0
- package/src/harness/approvals.test.ts +1094 -0
- package/src/harness/approvals.ts +644 -0
- package/src/harness/commit.ts +1049 -0
- package/src/harness/conversation.ts +503 -0
- package/src/harness/defineAgent.test.ts +92 -0
- package/src/harness/defineAgent.ts +82 -0
- package/src/harness/defineTask.test.ts +59 -0
- package/src/harness/defineTask.ts +76 -0
- package/src/harness/defineTool.ts +45 -0
- package/src/harness/definitionError.ts +13 -0
- package/src/harness/errors.test.ts +90 -0
- package/src/harness/errors.ts +119 -0
- package/src/harness/eventHub.test.ts +124 -0
- package/src/harness/eventHub.ts +159 -0
- package/src/harness/events.test.ts +757 -0
- package/src/harness/events.ts +384 -0
- package/src/harness/executionEnv.ts +34 -0
- package/src/harness/extensions.test.ts +1218 -0
- package/src/harness/extensions.ts +382 -0
- package/src/harness/harness.test.ts +693 -0
- package/src/harness/harness.ts +767 -0
- package/src/harness/harnessApp.ts +76 -0
- package/src/harness/internalRuntime.ts +44 -0
- package/src/harness/leases.ts +132 -0
- package/src/harness/memo.ts +107 -0
- package/src/harness/modelCall.test.ts +134 -0
- package/src/harness/modelCall.ts +200 -0
- package/src/harness/models/harnessApproval.ts +109 -0
- package/src/harness/models/harnessConversation.ts +142 -0
- package/src/harness/models/harnessEvent.ts +92 -0
- package/src/harness/models/harnessInboxEvent.ts +73 -0
- package/src/harness/models/harnessMemo.ts +43 -0
- package/src/harness/models/harnessMessage.ts +85 -0
- package/src/harness/models/harnessModels.test.ts +60 -0
- package/src/harness/models/harnessOwner.ts +40 -0
- package/src/harness/models/harnessTask.ts +201 -0
- package/src/harness/ownership.test.ts +1087 -0
- package/src/harness/ownership.ts +618 -0
- package/src/harness/recovery.test.ts +912 -0
- package/src/harness/registry.ts +124 -0
- package/src/harness/retries.test.ts +292 -0
- package/src/harness/retryBackoff.test.ts +100 -0
- package/src/harness/retryBackoff.ts +77 -0
- package/src/harness/routes/approvals.ts +123 -0
- package/src/harness/routes/conversations.test.ts +518 -0
- package/src/harness/routes/conversations.ts +102 -0
- package/src/harness/routes/events.ts +280 -0
- package/src/harness/routes/tasks.test.ts +198 -0
- package/src/harness/routes/tasks.ts +146 -0
- package/src/harness/runners/inProcessRunner.test.ts +402 -0
- package/src/harness/runners/inProcessRunner.ts +220 -0
- package/src/harness/runtime.ts +714 -0
- package/src/harness/subagent.test.ts +696 -0
- package/src/harness/subagent.ts +192 -0
- package/src/harness/suspend.ts +13 -0
- package/src/harness/transaction.ts +17 -0
- package/src/harness/versioning.test.ts +288 -0
- package/src/harness/waits.test.ts +693 -0
- package/src/harness/waits.ts +356 -0
- package/src/index.test.ts +13 -0
- package/src/index.ts +70 -0
- package/src/isolated/adminScreensConfig.isolated.ts +143 -0
- package/src/models/aiDataset.test.ts +34 -0
- package/src/models/aiDataset.ts +78 -0
- package/src/models/aiRequest.test.ts +2 -2
- package/src/models/aiRequest.ts +2 -1
- package/src/models/gptHistory.test.ts +156 -0
- package/src/models/gptHistory.ts +106 -4
- package/src/observability/adminScreens.test.ts +71 -0
- package/src/observability/adminScreens.ts +42 -0
- package/src/observability/compileTemplate.test.ts +14 -0
- package/src/observability/compileTemplate.ts +10 -0
- package/src/observability/datasetImport.test.ts +95 -0
- package/src/observability/datasetImport.ts +220 -0
- package/src/observability/evaluate.test.ts +549 -0
- package/src/observability/evaluate.ts +254 -0
- package/src/observability/evaluatorTemplates.ts +124 -0
- package/src/observability/jsonPath.test.ts +52 -0
- package/src/observability/jsonPath.ts +60 -0
- package/src/observability/local/datasetStore.test.ts +230 -0
- package/src/observability/local/datasetStore.ts +452 -0
- package/src/observability/local/evaluatorStore.test.ts +138 -0
- package/src/observability/local/evaluatorStore.ts +224 -0
- package/src/observability/local/experimentRunner.test.ts +489 -0
- package/src/observability/local/experimentRunner.ts +548 -0
- package/src/observability/local/localPlugin.ts +88 -0
- package/src/observability/local/models/obsDataset.ts +38 -0
- package/src/observability/local/models/obsDatasetItem.ts +80 -0
- package/src/observability/local/models/obsEvaluator.ts +102 -0
- package/src/observability/local/models/obsExperiment.ts +91 -0
- package/src/observability/local/models/obsExperimentItem.ts +52 -0
- package/src/observability/local/models/obsPrompt.ts +43 -0
- package/src/observability/local/models/obsPromptLabel.ts +43 -0
- package/src/observability/local/models/obsPromptVersion.ts +107 -0
- package/src/observability/local/models/obsReviewItem.ts +79 -0
- package/src/observability/local/models/obsScore.ts +59 -0
- package/src/observability/local/models/obsSpan.ts +65 -0
- package/src/observability/local/models/obsTrace.ts +94 -0
- package/src/observability/local/obsModels.test.ts +119 -0
- package/src/observability/local/promptStore.test.ts +351 -0
- package/src/observability/local/promptStore.ts +665 -0
- package/src/observability/local/reviewStore.test.ts +164 -0
- package/src/observability/local/reviewStore.ts +264 -0
- package/src/observability/local/traceStore.test.ts +264 -0
- package/src/observability/local/traceStore.ts +440 -0
- package/src/observability/observabilityApp.test.ts +92 -0
- package/src/observability/observabilityApp.ts +185 -0
- package/src/observability/observabilityAppRegistry.test.ts +30 -0
- package/src/observability/observabilityAppRegistry.ts +35 -0
- package/src/observability/permissions.test.ts +96 -0
- package/src/observability/permissions.ts +78 -0
- package/src/observability/reviewPanels.test.ts +35 -0
- package/src/observability/reviewPanels.ts +64 -0
- package/src/observability/routes/datasets.test.ts +176 -0
- package/src/observability/routes/datasets.ts +252 -0
- package/src/observability/routes/evaluators.test.ts +119 -0
- package/src/observability/routes/evaluators.ts +207 -0
- package/src/observability/routes/experiments.test.ts +282 -0
- package/src/observability/routes/experiments.ts +152 -0
- package/src/observability/routes/observabilityRbac.test.ts +767 -0
- package/src/observability/routes/observabilityRouteAccess.ts +106 -0
- package/src/observability/routes/prompts.test.ts +320 -0
- package/src/observability/routes/prompts.ts +263 -0
- package/src/observability/routes/requestAiService.ts +36 -0
- package/src/observability/routes/review.test.ts +120 -0
- package/src/observability/routes/review.ts +125 -0
- package/src/observability/routes/status.test.ts +116 -0
- package/src/observability/routes/status.ts +47 -0
- package/src/observability/routes/testMultiStage.test.ts +214 -0
- package/src/observability/routes/testMultiStage.ts +96 -0
- package/src/observability/routes/traces.test.ts +167 -0
- package/src/observability/routes/traces.ts +172 -0
- package/src/observability/schemaValidation.ts +29 -0
- package/src/observability/sopThresholds.ts +20 -0
- package/src/observability/status.test.ts +38 -0
- package/src/observability/status.ts +56 -0
- package/src/observability/testMultiStageSchemas.ts +95 -0
- package/src/observability/testMultiStageWorkflow.test.ts +114 -0
- package/src/observability/testMultiStageWorkflow.ts +307 -0
- package/src/observability/types.ts +262 -0
- package/src/routes/files.test.ts +84 -9
- package/src/routes/files.ts +23 -7
- package/src/routes/gpt.test.ts +3279 -0
- package/src/routes/gpt.ts +214 -552
- package/src/routes/gptActions.test.ts +241 -0
- package/src/routes/gptActions.ts +255 -0
- package/src/routes/gptApprovals.test.ts +762 -0
- package/src/routes/gptDatasets.test.ts +86 -0
- package/src/routes/gptDatasets.ts +104 -0
- package/src/routes/gptFiles.test.ts +589 -0
- package/src/routes/gptHistories.test.ts +933 -0
- package/src/routes/gptHistories.ts +266 -5
- package/src/routes/routes.test.ts +676 -5
- package/src/service/aiDatasets.test.ts +123 -0
- package/src/service/aiDatasets.ts +316 -0
- package/src/service/aiService.test.ts +614 -0
- package/src/service/aiService.ts +575 -111
- package/src/service/askFiles.test.ts +96 -0
- package/src/service/askFiles.ts +222 -0
- package/src/service/asks.test.ts +946 -0
- package/src/service/asks.ts +423 -0
- package/src/service/chatTurn.ts +2287 -0
- package/src/service/fileStorage.test.ts +11 -0
- package/src/service/fileStorage.ts +10 -2
- package/src/service/fileUploadsGate.ts +23 -0
- package/src/service/fillActionIds.test.ts +65 -0
- package/src/service/fillActionIds.ts +98 -0
- package/src/service/gemini.test.ts +16 -10
- package/src/service/gemini.ts +3 -3
- package/src/service/jsonFenceModel.test.ts +47 -0
- package/src/service/jsonFenceModel.ts +53 -0
- package/src/service/prompts.test.ts +21 -0
- package/src/service/prompts.ts +147 -0
- package/src/service/sanitizeHtml.test.ts +61 -0
- package/src/service/sanitizeHtml.ts +109 -0
- package/src/service/vertex.test.ts +49 -49
- package/src/service/vertex.ts +7 -8
- package/src/tests/bunSetup.test.ts +7 -4
- package/src/tests/bunSetup.ts +7 -7
- package/src/tests/chatHarness.ts +478 -0
- package/src/tests/generateStream.ts +49 -0
- package/src/tests/harnessErrors.ts +22 -0
- package/src/tests/harnessStreaming.ts +227 -0
- package/src/tests/helpers.ts +9 -2
- package/src/types/harness.ts +1095 -0
- package/src/types/index.ts +237 -12
- package/src/types/observability.ts +344 -0
- 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
|
+
};
|
package/dist/types/index.d.ts
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "@terreno/api";
|
|
2
|
-
import type {
|
|
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
|
|
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
|
|
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
|
-
/**
|
|
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-
|
|
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 {};
|