@terreno/ai 57.9.0 → 57.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/bunfig.toml +1 -1
- package/dist/aiApp.d.ts +8 -2
- package/dist/aiApp.js +12 -6
- 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 +133 -0
- package/dist/harness/errors.js +107 -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 +522 -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 +191 -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 +64 -0
- package/dist/harness/runners/inProcessRunner.js +227 -0
- package/dist/harness/runners/jobsRunner.d.ts +62 -0
- package/dist/harness/runners/jobsRunner.js +212 -0
- package/dist/harness/runtime.d.ts +52 -0
- package/dist/harness/runtime.js +604 -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 +73 -0
- 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 +18 -7
- package/dist/routes/gpt.js +79 -689
- 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 +426 -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/fillActionIds.d.ts +6 -0
- package/dist/service/fillActionIds.js +79 -0
- 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/types/harness.d.ts +952 -0
- package/dist/types/harness.js +133 -0
- package/dist/types/index.d.ts +192 -14
- 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 +28 -5
- package/src/aiApp.test.ts +207 -1
- package/src/aiApp.ts +19 -6
- 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/concurrency.test.ts +155 -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 +125 -0
- package/src/harness/eventHub.test.ts +124 -0
- package/src/harness/eventHub.ts +159 -0
- package/src/harness/events.test.ts +769 -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 +778 -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 +206 -0
- package/src/harness/ownership.test.ts +1087 -0
- package/src/harness/ownership.ts +618 -0
- package/src/harness/recovery.test.ts +907 -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 +530 -0
- package/src/harness/runners/inProcessRunner.ts +260 -0
- package/src/harness/runners/jobsRunner.test.ts +709 -0
- package/src/harness/runners/jobsRunner.ts +252 -0
- package/src/harness/runtime.ts +802 -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.ts +2 -1
- package/src/models/gptHistory.test.ts +156 -0
- package/src/models/gptHistory.ts +89 -1
- 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 +63 -9
- package/src/routes/files.ts +21 -7
- package/src/routes/gpt.test.ts +3279 -0
- package/src/routes/gpt.ts +91 -816
- 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 +222 -2
- package/src/service/aiDatasets.test.ts +123 -0
- package/src/service/aiDatasets.ts +316 -0
- package/src/service/aiService.test.ts +593 -0
- package/src/service/aiService.ts +568 -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/fillActionIds.test.ts +65 -0
- package/src/service/fillActionIds.ts +98 -0
- 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/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 +1119 -0
- package/src/types/index.ts +209 -13
- package/src/types/observability.ts +344 -0
- package/src/types/sanitize-html.d.ts +25 -0
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
import type { RESTMethod, User } from "@terreno/api";
|
|
2
|
+
import { type DurationLike } from "luxon";
|
|
3
|
+
import mongoose from "mongoose";
|
|
4
|
+
import type { ModelPrice } from "../observability/types";
|
|
5
|
+
import type { HarnessAbortOptions, HarnessAgentDefinition, HarnessApprovalDocument, HarnessCreateTaskOptions, HarnessDecideApprovalOptions, HarnessExtensionDefinition, HarnessInboxEventDocument, HarnessModelResolver, HarnessResolveInterruptedOptions, HarnessRunner, HarnessSendEventOptions, HarnessStreamingOptions, HarnessTaskDefinition, HarnessTaskDocument, HarnessTestHooks } from "../types/harness";
|
|
6
|
+
import { HarnessConversationHandle } from "./conversation";
|
|
7
|
+
import type { ExecutionEnv } from "./executionEnv";
|
|
8
|
+
import { type HarnessRegistryEntry } from "./registry";
|
|
9
|
+
export type { AnyHarnessToolDefinition, HarnessAbortOptions, HarnessAbortRuntime, HarnessAgentDefinition, HarnessAgentDefinitionInput, HarnessApprovalDocument, HarnessApprovalOptions, HarnessApprovalPolicy, HarnessApprovalRequest, HarnessApprovalResult, HarnessApprovalStatus, HarnessApprover, HarnessBeforeToolResult, HarnessChildOutcome, HarnessChildTaskOptions, HarnessCommit, HarnessConversationAgent, HarnessConversationDocument, HarnessConversationStatus, HarnessCreateTaskOptions, HarnessDecideApprovalOptions, HarnessEventDocument, HarnessEventType, HarnessExtensionDefinition, HarnessExtensionDefinitionInput, HarnessHook, HarnessHookApi, HarnessHookHandlers, HarnessHookKind, HarnessInboxEventDocument, HarnessInterruptAction, HarnessLeaseSettings, HarnessMemo, HarnessMemoDocument, HarnessMessageDocument, HarnessMessagePart, HarnessMessageRole, HarnessModelRef, HarnessModelRequest, HarnessModelResolver, HarnessOutcome, HarnessPhaseCommit, HarnessPhaseDefinition, HarnessReplayPolicy, HarnessResolveAction, HarnessResolveInterruptedOptions, HarnessRetryPolicy, HarnessRunAgentOptions, HarnessRunnableTask, HarnessRunner, HarnessRunnerContext, HarnessRunTaskOptions, HarnessSection, HarnessSectionInput, HarnessSendEventOptions, HarnessSendOptions, HarnessStreamingOptions, HarnessSubmitDisposition, HarnessSubmitOptions, HarnessSubmitResult, HarnessSystemPromptPart, HarnessTaskDefinition, HarnessTaskDefinitionInput, HarnessTaskDocument, HarnessTaskRuntime, HarnessTaskSpanKind, HarnessTaskStatus, HarnessTaskView, HarnessTerminalCommit, HarnessTestHooks, HarnessTextPart, HarnessToolApi, HarnessToolCall, HarnessToolCallPart, HarnessToolDefinition, HarnessToolDefinitionInput, HarnessToolHookApi, HarnessToolResultPart, HarnessToolWrap, HarnessTurnResult, HarnessWaitCall, HarnessWaitForOptions, HarnessWaitForTasksOptions, HarnessWaiting, HarnessWaitKind, HarnessWaitPolicy, HarnessWaitResolution, HarnessWhenBusy, } from "../types/harness";
|
|
10
|
+
export { HARNESS_AGENT_DEFAULT_MAX_STEPS, HARNESS_APPROVAL_STATUSES, HARNESS_CONVERSATION_STATUSES, HARNESS_EVENT_TYPES, HARNESS_HOOK_KINDS, HARNESS_INTERRUPT_ACTIONS, HARNESS_MESSAGE_ROLES, HARNESS_MODEL_RETRY_DEFAULTS, HARNESS_RESOLVE_ACTIONS, HARNESS_RETRY_DEFAULTS, HARNESS_SUBMIT_DISPOSITIONS, HARNESS_TASK_STATUSES, HARNESS_WAIT_KINDS, HARNESS_WAIT_POLICIES, HARNESS_WAIT_RESOLUTIONS, HARNESS_WHEN_BUSY, } from "../types/harness";
|
|
11
|
+
export { AI_HARNESS_GROUP, HARNESS_APPROVALS_SCREEN, harnessAdminScreens } from "./adminScreens";
|
|
12
|
+
export { AGENT_TOOL_TASK_NAME, AGENT_TURN_TASK_NAME } from "./agentTaskNames";
|
|
13
|
+
export { type ApprovalGateOptions, approvalGate, approvalTaskInput, HARNESS_DEFAULT_APPROVERS, HarnessApprovalConflictError, } from "./approvals";
|
|
14
|
+
export { HarnessCommitConflictError } from "./commit";
|
|
15
|
+
export { HarnessConversationBusyError, HarnessConversationHandle, HarnessConversationOwnedError, } from "./conversation";
|
|
16
|
+
export { defineAgent } from "./defineAgent";
|
|
17
|
+
export { defineTask } from "./defineTask";
|
|
18
|
+
export { defineTool } from "./defineTool";
|
|
19
|
+
export { HarnessDefinitionError } from "./definitionError";
|
|
20
|
+
export { HARNESS_ERRORS, type HarnessErrorKind, type HarnessErrorKindName } from "./errors";
|
|
21
|
+
export type { ExecutionEnv, ExecutionEnvCallOptions, ExecutionEnvExecOptions, ExecutionEnvExecResult, } from "./executionEnv";
|
|
22
|
+
export { defineExtension, HarnessExtensionError, hook, section, wrapTool, } from "./extensions";
|
|
23
|
+
export { HarnessApp, type HarnessAppOptions } from "./harnessApp";
|
|
24
|
+
export { HarnessModelCallError, isRetryableModelError, type ModelCallAttempt, } from "./modelCall";
|
|
25
|
+
export type { AnyHarnessTaskDefinition, HarnessRegistryEntry } from "./registry";
|
|
26
|
+
export { IN_PROCESS_RUNNER_ROLES, InProcessRunner, type InProcessRunnerOptions, type InProcessRunnerRole, } from "./runners/inProcessRunner";
|
|
27
|
+
export { HarnessSubagentError } from "./subagent";
|
|
28
|
+
export interface HarnessOpenOptions {
|
|
29
|
+
/** Handed to phases as `rt.env` and to tools as `api.env` (interface only in Phase 1). */
|
|
30
|
+
env?: ExecutionEnv;
|
|
31
|
+
/**
|
|
32
|
+
* Turns an agent's `{provider, modelId}` into a Vercel AI SDK `LanguageModel`. Required
|
|
33
|
+
* when the registry lists an agent.
|
|
34
|
+
*/
|
|
35
|
+
models?: HarnessModelResolver;
|
|
36
|
+
/**
|
|
37
|
+
* Per-model token prices for LLM span `usage.costUsd`. Defaults to the registered
|
|
38
|
+
* `ObservabilityApp`'s `priceMap`.
|
|
39
|
+
*/
|
|
40
|
+
priceMap?: Record<string, ModelPrice>;
|
|
41
|
+
/**
|
|
42
|
+
* Every task definition (and version) this process may create or resume, every agent
|
|
43
|
+
* (`defineAgent`) its conversations may use, and every extension (`defineExtension`)
|
|
44
|
+
* those agents and conversations name.
|
|
45
|
+
*/
|
|
46
|
+
registry: ReadonlyArray<HarnessRegistryEntry>;
|
|
47
|
+
/** Defaults to a new `InProcessRunner`. */
|
|
48
|
+
runner?: HarnessRunner;
|
|
49
|
+
/** How streamed model text is coalesced into `delta` events. */
|
|
50
|
+
streaming?: HarnessStreamingOptions;
|
|
51
|
+
/** Test-only seams; never set in production code. */
|
|
52
|
+
testHooks?: HarnessTestHooks;
|
|
53
|
+
}
|
|
54
|
+
export interface HarnessWaitOptions {
|
|
55
|
+
pollInterval?: DurationLike;
|
|
56
|
+
timeout?: DurationLike;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Durable task engine. Owns the registry and Mongo storage; a pluggable runner decides
|
|
60
|
+
* who executes runnable tasks.
|
|
61
|
+
*/
|
|
62
|
+
export declare class Harness {
|
|
63
|
+
private readonly agents;
|
|
64
|
+
private readonly agentTasks;
|
|
65
|
+
private readonly definitions;
|
|
66
|
+
private readonly engine;
|
|
67
|
+
private readonly extensions;
|
|
68
|
+
private isStarted;
|
|
69
|
+
private nextQueueSweepAt;
|
|
70
|
+
private readonly models;
|
|
71
|
+
private readonly runner;
|
|
72
|
+
private readonly testHooks;
|
|
73
|
+
private constructor();
|
|
74
|
+
/**
|
|
75
|
+
* Validate the environment and build a harness. Throws when the local observability
|
|
76
|
+
* models are missing or the connection is not a replica set.
|
|
77
|
+
*/
|
|
78
|
+
static open(options: HarnessOpenOptions): Promise<Harness>;
|
|
79
|
+
/**
|
|
80
|
+
* Begin executing runnable tasks. First throws, claiming nothing, when any non-terminal
|
|
81
|
+
* task is pinned to a `name@version` missing from the registry. The runner recovers
|
|
82
|
+
* tasks whose lease expired once it owns execution (immediately, or on takeover when
|
|
83
|
+
* another owner holds the lease).
|
|
84
|
+
*/
|
|
85
|
+
start(): Promise<void>;
|
|
86
|
+
/**
|
|
87
|
+
* Claim the next runnable task. When there is none, at most once per
|
|
88
|
+
* `QUEUE_SWEEP_INTERVAL`, start queued submissions stranded on idle conversations (a
|
|
89
|
+
* process died between a turn's end and starting the next queued turn) and claim again.
|
|
90
|
+
*/
|
|
91
|
+
private claimNextOrSweep;
|
|
92
|
+
/** Stop claiming work and wait for every phase in flight to settle. */
|
|
93
|
+
stop(): Promise<void>;
|
|
94
|
+
/**
|
|
95
|
+
* Create a root task pinned to `definition`'s `name@version`. With `requestId`, a
|
|
96
|
+
* repeated call returns the task created first.
|
|
97
|
+
*/
|
|
98
|
+
createTask<In, State, Out>(definition: HarnessTaskDefinition<In, State, Out>, input: In, options?: HarnessCreateTaskOptions): Promise<HarnessTaskDocument>;
|
|
99
|
+
/**
|
|
100
|
+
* Abort a task and every non-terminal task it owns, deepest first. Each task's running
|
|
101
|
+
* phase (in this process, or elsewhere within one heartbeat) sees `rt.signal` abort; its
|
|
102
|
+
* `abort` handler runs; then it is committed `aborted` with an `abort` audit span. A
|
|
103
|
+
* failing handler is recorded on that span and the abort proceeds. Throws when `reason`
|
|
104
|
+
* is blank or the task is already terminal.
|
|
105
|
+
*/
|
|
106
|
+
abort(taskId: mongoose.Types.ObjectId | string, options: HarnessAbortOptions): Promise<HarnessTaskDocument>;
|
|
107
|
+
/**
|
|
108
|
+
* Send `event` with `payload` to a task. The event is stored durably first, so it is
|
|
109
|
+
* never lost: a task already waiting on `event` (`rt.waitFor`) goes back to `pending`
|
|
110
|
+
* and its `waitFor` returns `payload`; otherwise the event stays buffered until a
|
|
111
|
+
* `rt.waitFor(event)` takes it. Works while no runner is up. Delivery is FIFO per event
|
|
112
|
+
* name. With `requestId` (unique per task), a repeated send returns the event sent
|
|
113
|
+
* first. Throws when the task is terminal or `event` is blank.
|
|
114
|
+
*/
|
|
115
|
+
sendEvent(taskId: mongoose.Types.ObjectId | string, event: string, payload?: unknown, options?: HarnessSendEventOptions): Promise<HarnessInboxEventDocument>;
|
|
116
|
+
/**
|
|
117
|
+
* Approve or reject a pending approval as `userId`, without checking approvers (the
|
|
118
|
+
* `HarnessApp` routes check them first). In one transaction: the approval's status,
|
|
119
|
+
* `decidedBy`, `decidedAt`, `reason`; the event that wakes the waiting `rt.approval`;
|
|
120
|
+
* and the `approval:<key>` audit span. Throws `HarnessApprovalConflictError` when it is
|
|
121
|
+
* already decided or expired, or its task ended.
|
|
122
|
+
*/
|
|
123
|
+
decideApproval(approvalId: mongoose.Types.ObjectId | string, options: HarnessDecideApprovalOptions): Promise<HarnessApprovalDocument>;
|
|
124
|
+
/**
|
|
125
|
+
* Whether `user` passes every approver of `approval` (its definition's or extension's
|
|
126
|
+
* `approvals[key]`, default `[Permissions.IsAdmin]`), called with `method`. False when
|
|
127
|
+
* this registry lacks the approval's `name@version` or extension.
|
|
128
|
+
*/
|
|
129
|
+
mayApprove({ approval, method, user, }: {
|
|
130
|
+
approval: HarnessApprovalDocument;
|
|
131
|
+
method?: RESTMethod;
|
|
132
|
+
user?: User;
|
|
133
|
+
}): Promise<boolean>;
|
|
134
|
+
/** Pending, unexpired approvals of live tasks that `user` may approve, oldest first. */
|
|
135
|
+
approvableApprovals({ user }: {
|
|
136
|
+
user?: User;
|
|
137
|
+
}): Promise<HarnessApprovalDocument[]>;
|
|
138
|
+
private approvalRegistry;
|
|
139
|
+
/**
|
|
140
|
+
* Decide what happens to an `interrupted` task: `retry` re-queues the same phase,
|
|
141
|
+
* `abort` runs its abort handler (after aborting every task it owns) and ends it
|
|
142
|
+
* `aborted`, `complete` ends it `completed` with `result`. The decision and its reason
|
|
143
|
+
* are audited in a `resolveInterrupted` span. Throws when the task is not
|
|
144
|
+
* `interrupted` or `reason` is empty.
|
|
145
|
+
*/
|
|
146
|
+
resolveInterrupted(taskId: mongoose.Types.ObjectId | string, options: HarnessResolveInterruptedOptions): Promise<HarnessTaskDocument>;
|
|
147
|
+
/**
|
|
148
|
+
* Start a conversation with a registered agent. Its config (model, instructions,
|
|
149
|
+
* extension names, the tool names they resolve to, fallbacks, `maxSteps`) is
|
|
150
|
+
* snapshotted onto the conversation. `extensions` replaces the agent's extension list
|
|
151
|
+
* for this conversation; each must be registered.
|
|
152
|
+
*/
|
|
153
|
+
createConversation({ agent, extensions, userId, }: {
|
|
154
|
+
agent: HarnessAgentDefinition;
|
|
155
|
+
extensions?: ReadonlyArray<HarnessExtensionDefinition | string>;
|
|
156
|
+
userId?: mongoose.Types.ObjectId | string;
|
|
157
|
+
}): Promise<HarnessConversationHandle>;
|
|
158
|
+
/** Load a conversation. Throws when it does not exist. */
|
|
159
|
+
conversation(conversationId: mongoose.Types.ObjectId | string): Promise<HarnessConversationHandle>;
|
|
160
|
+
private conversationContext;
|
|
161
|
+
/** Poll until the task is terminal; throws after `timeout` (default 30 seconds). */
|
|
162
|
+
waitForTask(taskId: mongoose.Types.ObjectId | string, options?: HarnessWaitOptions): Promise<HarnessTaskDocument>;
|
|
163
|
+
}
|