plugin-agent-orchestrator 1.1.8 → 1.2.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/LICENSE +201 -0
- package/README.md +207 -204
- package/client-v2.d.ts +2 -2
- package/client-v2.js +1 -1
- package/client.d.ts +2 -2
- package/client.js +1 -1
- package/dist/client/117.6c69b6a87751dd18.js +10 -0
- package/dist/client/253.52f62e1bc0e9520a.js +10 -0
- package/dist/client/325.8f7f509bdb35e142.js +10 -0
- package/dist/client/404.86593f98c9768ed5.js +10 -0
- package/dist/client/453.fa2d169576262213.js +10 -0
- package/dist/client/53.567db3ae078650c6.js +10 -0
- package/dist/client/619.01713281e5e951d3.js +10 -0
- package/dist/client/652.69da1598312b3a3f.js +10 -0
- package/dist/client/773.648965568ff476f9.js +10 -0
- package/dist/client/981.37e7aeecdb1ef6fa.js +10 -0
- package/dist/client/993.ac89f3852990918d.js +10 -0
- package/dist/client/index.js +1 -1
- package/dist/client-v2/117.c982d79ff68738f5.js +10 -0
- package/dist/client-v2/214.94c4257bf2838577.js +10 -0
- package/dist/client-v2/253.8e19956d2a44dfb8.js +10 -0
- package/dist/client-v2/264.80e8e358c8c6c2e5.js +10 -0
- package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
- package/dist/client-v2/404.ab032b79c95dab6f.js +10 -0
- package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.cd5610fcf7446127.js} +1 -1
- package/dist/client-v2/453.42c6d70628d56cc2.js +10 -0
- package/dist/client-v2/{53.349fff8db80b19d4.js → 53.37c08089a648f89a.js} +1 -1
- package/dist/client-v2/{619.0a2144aaffefe018.js → 619.6e9618550101e819.js} +1 -1
- package/dist/client-v2/652.eeba4e0c38367321.js +10 -0
- package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.332698e53eb59677.js} +1 -1
- package/dist/client-v2/773.4de2ba5acb07318c.js +10 -0
- package/dist/client-v2/981.76060f466e6f7c11.js +10 -0
- package/dist/client-v2/993.f8cdb5172566ce75.js +10 -0
- package/dist/client-v2/index.js +1 -1
- package/dist/externalVersion.js +13 -7
- package/dist/locale/en-US.json +308 -1
- package/dist/locale/vi-VN.json +5 -1
- package/dist/locale/zh-CN.json +308 -1
- package/dist/node_modules/acorn/LICENSE +21 -0
- package/dist/node_modules/acorn/bin/acorn +4 -0
- package/dist/node_modules/acorn/dist/acorn.d.mts +857 -0
- package/dist/node_modules/acorn/dist/acorn.d.ts +857 -0
- package/dist/node_modules/acorn/dist/acorn.js +1 -0
- package/dist/node_modules/acorn/dist/bin.js +90 -0
- package/dist/node_modules/acorn/package.json +1 -0
- package/dist/node_modules/acorn-walk/LICENSE +21 -0
- package/dist/node_modules/acorn-walk/dist/walk.d.mts +177 -0
- package/dist/node_modules/acorn-walk/dist/walk.d.ts +177 -0
- package/dist/node_modules/acorn-walk/dist/walk.js +1 -0
- package/dist/node_modules/acorn-walk/node_modules/.bin/acorn +15 -0
- package/dist/node_modules/acorn-walk/node_modules/.bin/acorn.cmd +7 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/bin/acorn +4 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.mts +866 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.ts +866 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.js +6174 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/dist/bin.js +90 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/package.json +50 -0
- package/dist/node_modules/acorn-walk/package.json +1 -0
- package/dist/node_modules/adm-zip/adm-zip.js +1 -1
- package/dist/node_modules/adm-zip/package.json +1 -1
- package/dist/node_modules/ajv/package.json +1 -1
- package/dist/node_modules/zod/index.cjs +1 -1
- package/dist/node_modules/zod/package.json +1 -1
- package/dist/server/collections/agent-auto-approval-checkpoints.js +47 -0
- package/dist/server/collections/agent-execution-spans.js +148 -9
- package/dist/server/collections/agent-governance-audit-events.js +47 -0
- package/dist/server/collections/agent-governance-policies.js +47 -0
- package/dist/server/collections/agent-governance-policy-versions.js +48 -0
- package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
- package/dist/server/collections/agent-hierarchy-invocations.js +59 -0
- package/dist/server/collections/agent-loop-runs.js +23 -5
- package/dist/server/collections/agent-routing-graph-locks.js +40 -0
- package/dist/server/collections/agent-session-auto-approvals.js +45 -0
- package/dist/server/collections/orchestrator-config.js +17 -0
- package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
- package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
- package/dist/server/migrations/20261119000000-widen-native-employee-identifiers.js +59 -0
- package/dist/server/plugin.js +169 -33
- package/dist/server/resources/agent-auto-approval.js +80 -0
- package/dist/server/resources/agent-governance.js +192 -0
- package/dist/server/resources/agent-harness-profile.js +11 -3
- package/dist/server/resources/agent-monitor.js +109 -339
- package/dist/server/resources/agent-usage.js +423 -0
- package/dist/server/resources/hierarchical-routing.js +60 -0
- package/dist/server/resources/native-monitor-format.js +179 -0
- package/dist/server/resources/tracing.js +35 -12
- package/dist/server/services/AgentGovernanceService.js +500 -0
- package/dist/server/services/AutoApprovalCheckpoint.js +133 -0
- package/dist/server/services/CodeValidator.js +8 -4
- package/dist/server/services/DepartmentAttribution.js +65 -0
- package/dist/server/services/ExecutionSpanService.js +96 -3
- package/dist/server/services/GovernanceAdmission.js +271 -0
- package/dist/server/services/HarnessCapabilities.js +118 -0
- package/dist/server/services/HarnessCompiler.js +3 -0
- package/dist/server/services/HarnessSchema.js +13 -1
- package/dist/server/services/HierarchicalAgentRuntime.js +925 -0
- package/dist/server/services/HierarchyEnrollmentGuard.js +216 -0
- package/dist/server/services/HierarchyInvocationJournal.js +157 -0
- package/dist/server/services/HierarchyRequestCancellation.js +150 -0
- package/dist/server/services/LoopBudgetService.js +29 -11
- package/dist/server/services/LoopRunRepository.js +16 -7
- package/dist/server/services/LoopRunStateMachine.js +20 -9
- package/dist/server/services/LoopTriggerService.js +1 -1
- package/dist/server/services/LoopWorkerService.js +71 -37
- package/dist/server/services/ManagedPromptProtection.js +99 -0
- package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
- package/dist/server/services/NativeSubAgentObserver.js +141 -508
- package/dist/server/services/NativeUsageAttribution.js +97 -0
- package/dist/server/services/PluginAiRuntimeAdapter.js +107 -9
- package/dist/server/services/RoutingBindingRepository.js +156 -0
- package/dist/server/services/RoutingBindingValidation.js +161 -0
- package/dist/server/services/SandboxRunner.js +19 -0
- package/dist/server/services/SessionAutoApproval.js +173 -0
- package/dist/server/services/TokenTracker.js +787 -104
- package/dist/server/services/TracingRetentionPolicy.js +66 -0
- package/dist/server/services/VerificationService.js +20 -10
- package/dist/server/skill-hub/plugin.js +17 -0
- package/dist/server/skill-hub/sandbox-config.json +6 -6
- package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
- package/dist/server/skill-hub/services/registry-node-package.js +191 -0
- package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
- package/dist/server/tools/skill-execute.js +1 -0
- package/dist/server/utils/ensure-indexes.js +15 -5
- package/package.json +66 -53
- package/server.d.ts +2 -2
- package/server.js +1 -1
- package/src/client/AgentRunsTab.tsx +2 -2
- package/src/client/ApprovalsTab.tsx +2 -2
- package/src/client/HarnessProfilesTab.tsx +2 -2
- package/src/client/OrchestratorSettings.tsx +152 -152
- package/src/client/SkillPages.tsx +34 -0
- package/src/client/__tests__/embedded-settings.test.tsx +225 -0
- package/src/client/hooks/useRunEventStream.ts +76 -76
- package/src/client/index.tsx +2 -2
- package/src/client/plugin.tsx +71 -33
- package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
- package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
- package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
- package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
- package/src/client/skill-hub/components/SkillManager.tsx +194 -194
- package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
- package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
- package/src/client/skill-hub/index.tsx +6 -6
- package/src/client/skill-hub/locale.ts +16 -16
- package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +147 -132
- package/src/client/skill-hub/tools/SkillHubCard.tsx +110 -104
- package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
- package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
- package/src/client/skill-hub/tools/registerSkillLoopCards.ts +80 -71
- package/src/client/skill-hub/utils/jsonFields.ts +41 -41
- package/src/client-v2/__tests__/embedded-settings.test.tsx +202 -0
- package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
- package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
- package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
- package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -0
- package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
- package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
- package/src/client-v2/components/AgentBindingsTab.tsx +541 -269
- package/src/client-v2/components/AgentRunsTab.tsx +85 -83
- package/src/client-v2/components/ApprovalsTab.tsx +337 -337
- package/src/client-v2/components/EmployeeGovernanceTab.tsx +695 -0
- package/src/client-v2/components/HarnessProfilesTab.tsx +700 -541
- package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
- package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
- package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
- package/src/client-v2/components/UsageGovernanceTab.tsx +379 -0
- package/src/client-v2/index.tsx +1 -1
- package/src/client-v2/pages/AgentBindingsPage.tsx +15 -13
- package/src/client-v2/pages/ApprovalsPage.tsx +12 -10
- package/src/client-v2/pages/EmployeeGovernancePage.tsx +15 -0
- package/src/client-v2/pages/ExecutionHistoryPage.tsx +12 -10
- package/src/client-v2/pages/HarnessProfilesPage.tsx +12 -10
- package/src/client-v2/pages/KnowledgeAccessPage.tsx +12 -10
- package/src/client-v2/pages/LoopSettingsPage.tsx +12 -10
- package/src/client-v2/pages/MemoryInspectorPage.tsx +15 -13
- package/src/client-v2/pages/RetrievalTracePage.tsx +12 -10
- package/src/client-v2/pages/RulesPage.tsx +15 -13
- package/src/client-v2/pages/SkillDefinitionsPage.tsx +12 -10
- package/src/client-v2/pages/SkillMetricsPage.tsx +12 -10
- package/src/client-v2/pages/TracingPage.tsx +15 -13
- package/src/client-v2/pages/UsageGovernancePage.tsx +15 -0
- package/src/client-v2/plugin.tsx +134 -111
- package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
- package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
- package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
- package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
- package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
- package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
- package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
- package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
- package/src/client-v2/skill-hub/locale.ts +13 -13
- package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
- package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
- package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +126 -0
- package/src/client-v2/skill-hub/tools/interactions.ts +137 -0
- package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
- package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
- package/src/client-v2/utils/jsonFields.ts +41 -41
- package/src/index.ts +2 -2
- package/src/locale/en-US.json +308 -1
- package/src/locale/vi-VN.json +5 -1
- package/src/locale/zh-CN.json +308 -1
- package/src/server/__tests__/agent-execution-context.test.ts +18 -18
- package/src/server/__tests__/agent-governance.integration.test.ts +385 -0
- package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
- package/src/server/__tests__/agent-monitor-acl.integration.test.ts +267 -0
- package/src/server/__tests__/agent-registry-service.test.ts +147 -147
- package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
- package/src/server/__tests__/agent-usage-report.integration.test.ts +335 -0
- package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -0
- package/src/server/__tests__/code-validator.test.ts +63 -63
- package/src/server/__tests__/external-rag-search.test.ts +107 -107
- package/src/server/__tests__/harness-capabilities.test.ts +88 -0
- package/src/server/__tests__/harness-compiler.test.ts +278 -214
- package/src/server/__tests__/harness-profile-service.test.ts +167 -167
- package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
- package/src/server/__tests__/harness-tool-plan.test.ts +175 -172
- package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
- package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
- package/src/server/__tests__/input-schema-validator.test.ts +26 -26
- package/src/server/__tests__/loop-approval-decision.test.ts +624 -512
- package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
- package/src/server/__tests__/loop-budget-service.test.ts +29 -0
- package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
- package/src/server/__tests__/loop-run-repository.test.ts +25 -0
- package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
- package/src/server/__tests__/loop-trigger-service.test.ts +185 -148
- package/src/server/__tests__/loop-worker-claim.test.ts +110 -10
- package/src/server/__tests__/loop-worker-execution.test.ts +375 -317
- package/src/server/__tests__/native-agent-monitor-sync.test.ts +343 -0
- package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
- package/src/server/__tests__/native-sub-agent-observer.test.ts +463 -662
- package/src/server/__tests__/native-usage-attribution.integration.test.ts +168 -0
- package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
- package/src/server/__tests__/registry-node-package.test.ts +299 -0
- package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
- package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
- package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
- package/src/server/__tests__/skill-access-service.test.ts +64 -64
- package/src/server/__tests__/skill-execute.test.ts +81 -70
- package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
- package/src/server/__tests__/skill-review-guard.test.ts +171 -0
- package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
- package/src/server/__tests__/skill-settings.test.ts +63 -63
- package/src/server/__tests__/skill-tool-name.test.ts +23 -23
- package/src/server/__tests__/token-tracker.test.ts +632 -0
- package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
- package/src/server/__tests__/tracing-retention-policy.test.ts +30 -0
- package/src/server/__tests__/usage-ledger.integration.test.ts +187 -0
- package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
- package/src/server/collections/agent-execution-spans.ts +386 -245
- package/src/server/collections/agent-governance-audit-events.ts +19 -0
- package/src/server/collections/agent-governance-policies.ts +19 -0
- package/src/server/collections/agent-governance-policy-versions.ts +20 -0
- package/src/server/collections/agent-governance-prompt-bindings.ts +22 -0
- package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
- package/src/server/collections/agent-loop-action-approvals.ts +39 -39
- package/src/server/collections/agent-loop-runs.ts +389 -369
- package/src/server/collections/agent-loop-steps.ts +220 -220
- package/src/server/collections/agent-memory-contexts.ts +95 -95
- package/src/server/collections/agent-routing-graph-locks.ts +11 -0
- package/src/server/collections/agent-session-auto-approvals.ts +16 -0
- package/src/server/collections/orchestrator-config.ts +113 -87
- package/src/server/collections/orchestrator-logs.ts +116 -116
- package/src/server/collections/skill-definitions.ts +159 -159
- package/src/server/collections/skill-executions.ts +154 -154
- package/src/server/collections/skill-loop-configs.ts +65 -65
- package/src/server/collections/skill-metrics.ts +36 -36
- package/src/server/collections/skill-registry-installations.ts +41 -41
- package/src/server/collections/skill-worker-configs.ts +86 -86
- package/src/server/index.ts +1 -1
- package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
- package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
- package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
- package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
- package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
- package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
- package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
- package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
- package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
- package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
- package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +110 -0
- package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +28 -0
- package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
- package/src/server/plugin.ts +724 -573
- package/src/server/resources/agent-auto-approval.ts +51 -0
- package/src/server/resources/agent-governance.ts +161 -0
- package/src/server/resources/agent-harness-profile.ts +103 -94
- package/src/server/resources/agent-knowledge-insights.ts +306 -306
- package/src/server/resources/agent-loop-approval.ts +84 -84
- package/src/server/resources/agent-loop-events-stream.ts +108 -108
- package/src/server/resources/agent-loop.ts +252 -252
- package/src/server/resources/agent-monitor.ts +208 -482
- package/src/server/resources/agent-usage.ts +413 -0
- package/src/server/resources/hierarchical-routing.ts +39 -0
- package/src/server/resources/native-monitor-format.ts +150 -0
- package/src/server/resources/tracing.ts +296 -267
- package/src/server/services/AgentExecutionContext.ts +23 -23
- package/src/server/services/AgentGovernanceService.ts +541 -0
- package/src/server/services/AgentMemoryContextService.ts +344 -344
- package/src/server/services/AgentRegistryService.ts +220 -220
- package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
- package/src/server/services/AutoApprovalCheckpoint.ts +140 -0
- package/src/server/services/CodeValidator.ts +257 -238
- package/src/server/services/DepartmentAttribution.ts +47 -0
- package/src/server/services/DurableCircuitBreakerService.ts +235 -235
- package/src/server/services/ExecutionSpanService.ts +271 -146
- package/src/server/services/FileManager.ts +159 -159
- package/src/server/services/GovernanceAdmission.ts +314 -0
- package/src/server/services/HarnessCapabilities.ts +112 -0
- package/src/server/services/HarnessCompiler.ts +182 -170
- package/src/server/services/HarnessProfileService.ts +235 -235
- package/src/server/services/HarnessSchema.ts +224 -194
- package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
- package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
- package/src/server/services/HierarchyInvocationJournal.ts +172 -0
- package/src/server/services/HierarchyRequestCancellation.ts +132 -0
- package/src/server/services/InputSchemaValidator.ts +44 -44
- package/src/server/services/LoopBudgetService.ts +325 -271
- package/src/server/services/LoopControlService.ts +120 -120
- package/src/server/services/LoopPatternSchema.ts +231 -231
- package/src/server/services/LoopPatternService.ts +171 -171
- package/src/server/services/LoopRunRepository.ts +343 -332
- package/src/server/services/LoopRunStateMachine.ts +538 -525
- package/src/server/services/LoopSchedulerService.ts +195 -195
- package/src/server/services/LoopTriggerService.ts +162 -159
- package/src/server/services/LoopWorkerService.ts +975 -912
- package/src/server/services/ManagedPromptProtection.ts +81 -0
- package/src/server/services/NativeAgentMonitorSyncService.ts +684 -0
- package/src/server/services/NativeSubAgentObserver.ts +324 -757
- package/src/server/services/NativeUsageAttribution.ts +91 -0
- package/src/server/services/PathLockService.ts +317 -317
- package/src/server/services/PluginAiRuntimeAdapter.ts +518 -387
- package/src/server/services/RoutingBindingRepository.ts +146 -0
- package/src/server/services/RoutingBindingValidation.ts +161 -0
- package/src/server/services/RunEventBus.ts +58 -58
- package/src/server/services/SandboxRunner.ts +526 -492
- package/src/server/services/SessionAutoApproval.ts +167 -0
- package/src/server/services/SkillAccessService.ts +175 -175
- package/src/server/services/SkillManager.ts +585 -585
- package/src/server/services/SkillRepositoryService.ts +236 -236
- package/src/server/services/TokenTracker.ts +1151 -287
- package/src/server/services/ToolLoopDetectionService.ts +210 -210
- package/src/server/services/TracingRetentionPolicy.ts +49 -0
- package/src/server/services/VerificationSchema.ts +31 -31
- package/src/server/services/VerificationService.ts +325 -313
- package/src/server/services/WorkerEnvManager.ts +198 -198
- package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
- package/src/server/services/harness-runtime-policy.ts +134 -134
- package/src/server/services/pythonGuardTemplate.ts +87 -87
- package/src/server/services/sandboxCapabilities.ts +348 -348
- package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
- package/src/server/skill-hub/actions/git-import.ts +936 -936
- package/src/server/skill-hub/mcp/McpController.ts +107 -107
- package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
- package/src/server/skill-hub/plugin.ts +1272 -1232
- package/src/server/skill-hub/sandbox-config.json +6 -6
- package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +291 -281
- package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
- package/src/server/skill-hub/services/registry-node-package.ts +191 -0
- package/src/server/skill-hub/tasks/SkillExecutionTask.ts +597 -568
- package/src/server/skill-hub/utils/json-fields.ts +57 -57
- package/src/server/tools/delegate-task.ts +30 -30
- package/src/server/tools/external-rag-search.ts +329 -329
- package/src/server/tools/skill-execute.ts +226 -216
- package/src/server/types.ts +21 -21
- package/src/server/utils/ai-manager.ts +24 -24
- package/src/server/utils/ctx-utils.ts +132 -132
- package/src/server/utils/ensure-indexes.ts +113 -96
- package/src/server/utils/ha-lock.ts +80 -80
- package/src/server/utils/loop-pattern-context.ts +84 -84
- package/src/server/utils/record-utils.ts +19 -19
- package/src/server/utils/skill-settings.ts +135 -135
- package/src/server/utils/skill-tool-name.ts +58 -58
- package/dist/client-v2/117.7565cff57c39318a.js +0 -10
- package/dist/client-v2/214.106635011859dede.js +0 -10
- package/dist/client-v2/253.59577b40d9875be0.js +0 -10
- package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
- package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
- package/dist/client-v2/794.a67a2614405ba627.js +0 -10
- package/dist/client-v2/981.e4a1f41cfc94a856.js +0 -10
- package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
- package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
- package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
- package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
- package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
- package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
- package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
- package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
- package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
- package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
- package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
- package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
- package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
- package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
- package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
- package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
- package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
- package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
- package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
- package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
- package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
- package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
- package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
- package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
- package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
- package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
- package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
- package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
- package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
- package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
- package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
- package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
- package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
- package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
- package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
- package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
- package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
- package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
- package/dist/node_modules/simple-git/package.json +0 -1
- package/dist/node_modules/simple-git/promise.js +0 -17
|
@@ -1,757 +1,324 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
import {
|
|
4
|
-
import { ExecutionSpanService } from './ExecutionSpanService';
|
|
5
|
-
import { AgentMemoryContextService } from './AgentMemoryContextService';
|
|
6
|
-
import {
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
type
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
};
|
|
41
|
-
|
|
42
|
-
type
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
const
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
const
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
}
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
);
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
} catch
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
failedAt: new Date().toISOString(),
|
|
326
|
-
},
|
|
327
|
-
});
|
|
328
|
-
await this.tokenTracker.estimateAndTrack(
|
|
329
|
-
state.rootSpanId,
|
|
330
|
-
task.question,
|
|
331
|
-
errorMessage(error),
|
|
332
|
-
state.rootMetadata.agentLoopRunId ? Number(state.rootMetadata.agentLoopRunId) : undefined,
|
|
333
|
-
);
|
|
334
|
-
throw error;
|
|
335
|
-
}
|
|
336
|
-
}
|
|
337
|
-
|
|
338
|
-
private async safeResolvePolicy(task: NativeSubAgentTask) {
|
|
339
|
-
try {
|
|
340
|
-
return await this.memoryService.resolvePolicySettings(task);
|
|
341
|
-
} catch (error) {
|
|
342
|
-
this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to resolve native observer policy', error);
|
|
343
|
-
return { harnessTag: 'default' };
|
|
344
|
-
}
|
|
345
|
-
}
|
|
346
|
-
|
|
347
|
-
// Span payload gates: inputs are captured only under 'full' sharing, outputs under 'full' or
|
|
348
|
-
// 'feedback-only'. Redaction scrubs secret-looking keys on whatever is captured; free text is
|
|
349
|
-
// deliberately left alone.
|
|
350
|
-
private spanInput(state: RunState, input: Record<string, unknown>): Record<string, unknown> | undefined {
|
|
351
|
-
const observability = state.policy.observability;
|
|
352
|
-
if (observability.sharing !== 'full' || !observability.captureInputs) return undefined;
|
|
353
|
-
return observability.redactSecrets ? redactSecretsIn(input) : input;
|
|
354
|
-
}
|
|
355
|
-
|
|
356
|
-
private spanOutput(state: RunState, output: unknown): unknown | undefined {
|
|
357
|
-
const observability = state.policy.observability;
|
|
358
|
-
if (observability.sharing === 'disabled' || !observability.captureOutputs) return undefined;
|
|
359
|
-
return observability.redactSecrets ? redactSecretsIn(output) : output;
|
|
360
|
-
}
|
|
361
|
-
|
|
362
|
-
// Resolved settings are a raw profile record plus the harnessTag marker; the marker is not a
|
|
363
|
-
// schema field. On any compile trouble fall back to an empty (all-default) harness so the
|
|
364
|
-
// safety defaults — redaction on, sharing full — still govern the spans.
|
|
365
|
-
private compilePolicy(settings: Record<string, unknown>, parentRunHarness: CompiledHarness | null): CompiledHarness {
|
|
366
|
-
const tag =
|
|
367
|
-
typeof settings.harnessTag === 'string' && settings.harnessTag.trim() ? settings.harnessTag.trim() : 'default';
|
|
368
|
-
const { harnessTag: _harnessTag, ...rest } = settings;
|
|
369
|
-
try {
|
|
370
|
-
const layers: HarnessLayer[] = [];
|
|
371
|
-
if (parentRunHarness) {
|
|
372
|
-
// `sources` is a compiler artifact the strict schema rejects, so it is stripped before the
|
|
373
|
-
// compiled parent harness is re-used as a layer. Most-restrictive-wins then carries the
|
|
374
|
-
// parent's delegation caps, sharing mode and memory limits into the child.
|
|
375
|
-
const { sources, ...inherited } = parentRunHarness;
|
|
376
|
-
layers.push({ source: `run-role:${sources.join('+') || 'snapshot'}`, settings: inherited });
|
|
377
|
-
}
|
|
378
|
-
layers.push({ source: `profile:${tag}`, settings: rest });
|
|
379
|
-
return compileHarness(layers);
|
|
380
|
-
} catch (error) {
|
|
381
|
-
this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to compile observer harness policy', error);
|
|
382
|
-
return compileHarness([{ source: 'default', settings: {} }]);
|
|
383
|
-
}
|
|
384
|
-
}
|
|
385
|
-
|
|
386
|
-
// Oversized sub-agent results are stored on disk and replaced by a head/tail preview plus the
|
|
387
|
-
// file path, so the parent conversation can read the full text back with its file tools.
|
|
388
|
-
// Best effort: a spill failure keeps the original result inline.
|
|
389
|
-
private spillLargeResult(state: RunState, result: string): string {
|
|
390
|
-
const maxInlineBytes = state.policy.context.spill.maxInlineBytes;
|
|
391
|
-
if (!maxInlineBytes || typeof result !== 'string') return result;
|
|
392
|
-
try {
|
|
393
|
-
const spillDir = resolve(process.cwd(), 'storage', 'plugin-agent-orchestrator', 'spills');
|
|
394
|
-
mkdirSync(spillDir, { recursive: true });
|
|
395
|
-
const spillPath = resolve(spillDir, `${state.rootRunId}-${Date.now()}.txt`);
|
|
396
|
-
const replaced = spilledText(result, maxInlineBytes, spillPath);
|
|
397
|
-
if (!replaced) return result;
|
|
398
|
-
writeFileSync(spillPath, result, 'utf8');
|
|
399
|
-
return replaced;
|
|
400
|
-
} catch (error) {
|
|
401
|
-
this.plugin.app.logger?.warn?.('[AgentOrchestrator] Sub-agent result spill failed', error);
|
|
402
|
-
return result;
|
|
403
|
-
}
|
|
404
|
-
}
|
|
405
|
-
|
|
406
|
-
private async safeBuildMemoryContext(options: {
|
|
407
|
-
userId?: string | number;
|
|
408
|
-
aiEmployeeUsername?: string;
|
|
409
|
-
settings: Record<string, unknown>;
|
|
410
|
-
}) {
|
|
411
|
-
try {
|
|
412
|
-
return await this.memoryService.buildContext(options);
|
|
413
|
-
} catch (error) {
|
|
414
|
-
this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to build agent memory context', error);
|
|
415
|
-
return { context: '', appliedScopes: [] as string[], chars: 0 };
|
|
416
|
-
}
|
|
417
|
-
}
|
|
418
|
-
|
|
419
|
-
private async safeCreateRootSpan(
|
|
420
|
-
state: RunState,
|
|
421
|
-
question: string,
|
|
422
|
-
delegationInfo: { depth: number; parentSpanId?: string; agentLoopRunId?: number },
|
|
423
|
-
) {
|
|
424
|
-
const span = (await this.spanService.create({
|
|
425
|
-
rootRunId: state.rootRunId,
|
|
426
|
-
parentSpanId: delegationInfo.parentSpanId,
|
|
427
|
-
depth: delegationInfo.depth,
|
|
428
|
-
agentLoopRunId: delegationInfo.agentLoopRunId,
|
|
429
|
-
source: NATIVE_SOURCE,
|
|
430
|
-
parentSessionId: state.parentSessionId,
|
|
431
|
-
subSessionId: state.subSessionId,
|
|
432
|
-
toolCallId: state.toolCallId,
|
|
433
|
-
type: 'sub_agent',
|
|
434
|
-
status: 'running',
|
|
435
|
-
leaderUsername: state.leaderUsername,
|
|
436
|
-
employeeUsername: state.employeeUsername,
|
|
437
|
-
toolName: 'dispatch-sub-agent-task',
|
|
438
|
-
title: `${state.leaderUsername || 'main'} -> ${state.employeeUsername || 'sub-agent'}`,
|
|
439
|
-
input: this.spanInput(state, {
|
|
440
|
-
question,
|
|
441
|
-
parentSessionId: state.parentSessionId,
|
|
442
|
-
subSessionId: state.subSessionId,
|
|
443
|
-
}),
|
|
444
|
-
metadata: state.rootMetadata,
|
|
445
|
-
userId: state.userId,
|
|
446
|
-
})) as SpanRecord | null;
|
|
447
|
-
|
|
448
|
-
state.rootSpanId = span?.id;
|
|
449
|
-
}
|
|
450
|
-
|
|
451
|
-
private runWithKnowledgeBaseAgentContext<T>(employeeUsername: string | undefined, fn: () => Promise<T>) {
|
|
452
|
-
if (!employeeUsername) return fn();
|
|
453
|
-
const knowledgeBasePlugin = this.plugin.app.pm?.get?.('plugin-knowledge-base') as
|
|
454
|
-
| { runWithAgentContext?: <TResult>(username: string, callback: () => Promise<TResult>) => Promise<TResult> }
|
|
455
|
-
| undefined;
|
|
456
|
-
return knowledgeBasePlugin?.runWithAgentContext
|
|
457
|
-
? knowledgeBasePlugin.runWithAgentContext(employeeUsername, fn)
|
|
458
|
-
: fn();
|
|
459
|
-
}
|
|
460
|
-
|
|
461
|
-
private async handleWriterChunk(state: RunState, chunk: Record<string, unknown>) {
|
|
462
|
-
const action = chunk.action;
|
|
463
|
-
if (action === 'beforeToolCall') {
|
|
464
|
-
await this.handleBeforeToolCall(state, chunk);
|
|
465
|
-
return;
|
|
466
|
-
}
|
|
467
|
-
if (action === 'afterToolCall') {
|
|
468
|
-
await this.handleAfterToolCall(state, chunk, false);
|
|
469
|
-
return;
|
|
470
|
-
}
|
|
471
|
-
if (action === 'afterToolCallError') {
|
|
472
|
-
await this.handleAfterToolCall(state, chunk, true);
|
|
473
|
-
return;
|
|
474
|
-
}
|
|
475
|
-
if (action === 'afterSubAgentInvoke') {
|
|
476
|
-
state.rootMetadata = {
|
|
477
|
-
...state.rootMetadata,
|
|
478
|
-
afterSubAgentInvokeAt: new Date().toISOString(),
|
|
479
|
-
};
|
|
480
|
-
await this.spanService.update(state.rootSpanId, { metadata: state.rootMetadata });
|
|
481
|
-
}
|
|
482
|
-
}
|
|
483
|
-
|
|
484
|
-
private async handleBeforeToolCall(state: RunState, chunk: Record<string, unknown>) {
|
|
485
|
-
if (state.policy.observability.sharing === 'disabled') return;
|
|
486
|
-
const body = chunkBody(chunk);
|
|
487
|
-
const toolCall = asObject(body.toolCall);
|
|
488
|
-
const toolCallId = normalizeString(toolCall.id);
|
|
489
|
-
if (!toolCallId || state.toolSpans.has(toolCallId)) return;
|
|
490
|
-
|
|
491
|
-
const conversation = chunkCurrentConversation(chunk);
|
|
492
|
-
const startedAt = Date.now();
|
|
493
|
-
const toolSpan: ToolSpanState = {
|
|
494
|
-
startedAt,
|
|
495
|
-
ready: Promise.resolve(),
|
|
496
|
-
};
|
|
497
|
-
state.toolSpans.set(toolCallId, toolSpan);
|
|
498
|
-
|
|
499
|
-
const toolName = normalizeString(toolCall.name);
|
|
500
|
-
toolSpan.ready = this.spanService
|
|
501
|
-
.create({
|
|
502
|
-
rootRunId: state.rootRunId,
|
|
503
|
-
parentSpanId: state.rootSpanId ? String(state.rootSpanId) : undefined,
|
|
504
|
-
source: NATIVE_SOURCE,
|
|
505
|
-
parentSessionId: state.parentSessionId || undefined,
|
|
506
|
-
subSessionId: normalizeString(conversation.sessionId) || state.subSessionId || undefined,
|
|
507
|
-
toolCallId,
|
|
508
|
-
type:
|
|
509
|
-
toolName === 'dispatch-sub-agent-task'
|
|
510
|
-
? 'dispatch'
|
|
511
|
-
: toolName === 'skill_hub_execute' || toolName.startsWith('skill_hub_')
|
|
512
|
-
? 'skill'
|
|
513
|
-
: 'tool',
|
|
514
|
-
status: 'running',
|
|
515
|
-
leaderUsername: state.leaderUsername,
|
|
516
|
-
employeeUsername: normalizeString(conversation.username) || state.employeeUsername,
|
|
517
|
-
toolName,
|
|
518
|
-
title: toolName || 'tool call',
|
|
519
|
-
input: this.spanInput(state, asObject(toolCall.args)),
|
|
520
|
-
metadata: {
|
|
521
|
-
source: NATIVE_SOURCE,
|
|
522
|
-
currentConversation: conversation,
|
|
523
|
-
messageId: toolCall.messageId,
|
|
524
|
-
},
|
|
525
|
-
userId: state.userId,
|
|
526
|
-
})
|
|
527
|
-
.then((span) => {
|
|
528
|
-
toolSpan.spanId = (span as SpanRecord | null)?.id;
|
|
529
|
-
});
|
|
530
|
-
|
|
531
|
-
await toolSpan.ready;
|
|
532
|
-
}
|
|
533
|
-
|
|
534
|
-
private async handleAfterToolCall(state: RunState, chunk: Record<string, unknown>, forceError: boolean) {
|
|
535
|
-
const body = chunkBody(chunk);
|
|
536
|
-
const toolCall = asObject(body.toolCall);
|
|
537
|
-
const toolCallId = normalizeString(toolCall.id);
|
|
538
|
-
const existing = toolCallId ? state.toolSpans.get(toolCallId) : undefined;
|
|
539
|
-
if (!existing) return;
|
|
540
|
-
await existing.ready;
|
|
541
|
-
|
|
542
|
-
const result = asObject(toPlain(body.toolCallResult));
|
|
543
|
-
const error = body.error;
|
|
544
|
-
const status = forceError || result.status === 'error' ? 'error' : 'success';
|
|
545
|
-
const output = result.content ?? result.result ?? result;
|
|
546
|
-
const toolName = normalizeString(toolCall.name);
|
|
547
|
-
const skillExecutionId =
|
|
548
|
-
toolName === 'skill_hub_execute' || toolName.startsWith('skill_hub_') ? readSkillExecutionId(result) : undefined;
|
|
549
|
-
const invokeStart = Number(result.invokeStartTime);
|
|
550
|
-
const invokeEnd = Number(result.invokeEndTime);
|
|
551
|
-
const durationMs =
|
|
552
|
-
Number.isFinite(invokeStart) && Number.isFinite(invokeEnd) && invokeEnd >= invokeStart
|
|
553
|
-
? invokeEnd - invokeStart
|
|
554
|
-
: Date.now() - existing.startedAt;
|
|
555
|
-
|
|
556
|
-
await this.spanService.update(existing.spanId, {
|
|
557
|
-
status,
|
|
558
|
-
endedAt: new Date(),
|
|
559
|
-
durationMs,
|
|
560
|
-
output: forceError ? undefined : this.spanOutput(state, trimText(output, 20000)),
|
|
561
|
-
error: forceError ? this.spanOutput(state, trimText(errorMessage(error), 10000)) : undefined,
|
|
562
|
-
skillExecutionId,
|
|
563
|
-
metadata: {
|
|
564
|
-
source: NATIVE_SOURCE,
|
|
565
|
-
toolCallResultStatus: result.status,
|
|
566
|
-
invokeStatus: result.invokeStatus,
|
|
567
|
-
messageId: toolCall.messageId,
|
|
568
|
-
},
|
|
569
|
-
});
|
|
570
|
-
|
|
571
|
-
if (skillExecutionId && existing.spanId) {
|
|
572
|
-
await this.linkExecutionToSpan(skillExecutionId, existing.spanId);
|
|
573
|
-
}
|
|
574
|
-
|
|
575
|
-
await this.tokenTracker.estimateAndTrack(
|
|
576
|
-
existing.spanId,
|
|
577
|
-
normalizeString(toolCall.name),
|
|
578
|
-
typeof output === 'string' ? output : JSON.stringify(output),
|
|
579
|
-
);
|
|
580
|
-
}
|
|
581
|
-
|
|
582
|
-
private async linkExecutionToSpan(skillExecutionId: string | number, spanId: string | number) {
|
|
583
|
-
try {
|
|
584
|
-
const repo = this.plugin.db.getRepository('skillExecutions');
|
|
585
|
-
if (!repo) return;
|
|
586
|
-
await repo.update({
|
|
587
|
-
filterByTk: skillExecutionId,
|
|
588
|
-
values: { orchestratorSpanId: spanId },
|
|
589
|
-
});
|
|
590
|
-
} catch (error) {
|
|
591
|
-
this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to link skill execution to native span', error);
|
|
592
|
-
}
|
|
593
|
-
}
|
|
594
|
-
|
|
595
|
-
private resolveParentSessionId(task: NativeSubAgentTask) {
|
|
596
|
-
const values = task.ctx?.action?.params?.values || {};
|
|
597
|
-
return normalizeString(values.sessionId) || undefined;
|
|
598
|
-
}
|
|
599
|
-
|
|
600
|
-
private leaderUsernameFor(ctx: NativeSubAgentTask['ctx'], parentConversation: unknown) {
|
|
601
|
-
const values = ctx?.action?.params?.values || {};
|
|
602
|
-
const direct =
|
|
603
|
-
normalizeString(values.aiEmployeeUsername) ||
|
|
604
|
-
normalizeString((asObject(values.aiEmployee) as Record<string, unknown>).username);
|
|
605
|
-
return direct || normalizeString(readValue(parentConversation, 'aiEmployeeUsername')) || undefined;
|
|
606
|
-
}
|
|
607
|
-
|
|
608
|
-
private async safeFindParentConversation(ctx: NativeSubAgentTask['ctx'], parentSessionId?: string) {
|
|
609
|
-
if (!parentSessionId) return null;
|
|
610
|
-
try {
|
|
611
|
-
const repo = ctx.db?.getRepository?.('aiConversations') as
|
|
612
|
-
| { findOne?: (options: Record<string, unknown>) => Promise<unknown> }
|
|
613
|
-
| undefined;
|
|
614
|
-
const conversation = await repo?.findOne?.({ filter: { sessionId: parentSessionId } });
|
|
615
|
-
return conversation || null;
|
|
616
|
-
} catch {
|
|
617
|
-
return null;
|
|
618
|
-
}
|
|
619
|
-
}
|
|
620
|
-
|
|
621
|
-
private controlPlaneRunIdOf(conversation: unknown): number | undefined {
|
|
622
|
-
const runId = Number(asObject(readValue(conversation, 'options')).controlPlaneRunId);
|
|
623
|
-
return Number.isSafeInteger(runId) && runId > 0 ? runId : undefined;
|
|
624
|
-
}
|
|
625
|
-
|
|
626
|
-
private async safeResolveParentRunHarness(runId: number, parentUsername: string): Promise<CompiledHarness | null> {
|
|
627
|
-
if (!parentUsername) return null;
|
|
628
|
-
try {
|
|
629
|
-
return await resolveRunRoleHarness(this.plugin.db, runId, parentUsername);
|
|
630
|
-
} catch (error) {
|
|
631
|
-
this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to resolve parent run harness for delegation', error);
|
|
632
|
-
return null;
|
|
633
|
-
}
|
|
634
|
-
}
|
|
635
|
-
|
|
636
|
-
// The parent's persisted span is the authoritative depth source: it was recorded when the
|
|
637
|
-
// parent itself was dispatched, so a resumed child arrives with its true depth even though its
|
|
638
|
-
// in-process context is fresh. The runtime context can only confirm or deepen the count, never
|
|
639
|
-
// lower it.
|
|
640
|
-
private async resolveDelegationContext(parentSessionId?: string): Promise<{ parentSpanId?: string; depth: number }> {
|
|
641
|
-
const candidates: Array<{ id?: string | number; depth?: unknown }> = [];
|
|
642
|
-
const context = getAgentExecutionContext();
|
|
643
|
-
if (context?.spanId) {
|
|
644
|
-
const span = await this.safeFindSpan({ filterByTk: context.spanId });
|
|
645
|
-
if (span) candidates.push(span);
|
|
646
|
-
}
|
|
647
|
-
if (parentSessionId) {
|
|
648
|
-
const span = await this.safeFindSpan({
|
|
649
|
-
filter: { subSessionId: parentSessionId, type: 'sub_agent' },
|
|
650
|
-
sort: ['-id'],
|
|
651
|
-
});
|
|
652
|
-
if (span) candidates.push(span);
|
|
653
|
-
}
|
|
654
|
-
const depth = candidates.reduce((deepest, span) => Math.max(deepest, Number(span.depth) || 0), 0);
|
|
655
|
-
const parentSpanId = candidates.find((span) => span.id !== undefined)?.id;
|
|
656
|
-
return { parentSpanId: parentSpanId === undefined ? undefined : String(parentSpanId), depth };
|
|
657
|
-
}
|
|
658
|
-
|
|
659
|
-
private async safeFindSpan(
|
|
660
|
-
options: Record<string, unknown>,
|
|
661
|
-
): Promise<{ id?: string | number; depth?: unknown } | null> {
|
|
662
|
-
try {
|
|
663
|
-
const repo = this.plugin.db.getRepository('agentExecutionSpans');
|
|
664
|
-
if (!repo || typeof repo.findOne !== 'function') return null;
|
|
665
|
-
return ((await repo.findOne(options)) as { id?: string | number; depth?: unknown } | null) || null;
|
|
666
|
-
} catch (error) {
|
|
667
|
-
this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to resolve delegation parent span', error);
|
|
668
|
-
return null;
|
|
669
|
-
}
|
|
670
|
-
}
|
|
671
|
-
|
|
672
|
-
private async resolveDispatchToolMessage(
|
|
673
|
-
ctx: NativeSubAgentTask['ctx'],
|
|
674
|
-
parentSessionId?: string,
|
|
675
|
-
subSessionId?: string,
|
|
676
|
-
) {
|
|
677
|
-
if (!parentSessionId) return null;
|
|
678
|
-
try {
|
|
679
|
-
const fromMetadata = await this.resolveDispatchToolMessageFromMetadata(ctx, parentSessionId, subSessionId);
|
|
680
|
-
if (fromMetadata) {
|
|
681
|
-
return fromMetadata;
|
|
682
|
-
}
|
|
683
|
-
|
|
684
|
-
const repo = ctx.db?.getRepository?.('aiToolMessages') as
|
|
685
|
-
| { findOne?: (options: Record<string, unknown>) => Promise<unknown> }
|
|
686
|
-
| undefined;
|
|
687
|
-
const record = await repo?.findOne?.({
|
|
688
|
-
filter: {
|
|
689
|
-
sessionId: parentSessionId,
|
|
690
|
-
toolName: 'dispatch-sub-agent-task',
|
|
691
|
-
invokeStatus: {
|
|
692
|
-
$ne: 'confirmed',
|
|
693
|
-
},
|
|
694
|
-
},
|
|
695
|
-
sort: ['-id'],
|
|
696
|
-
});
|
|
697
|
-
return toPlain(record) as DispatchToolMessage | null;
|
|
698
|
-
} catch {
|
|
699
|
-
return null;
|
|
700
|
-
}
|
|
701
|
-
}
|
|
702
|
-
|
|
703
|
-
private async resolveDispatchToolMessageFromMetadata(
|
|
704
|
-
ctx: NativeSubAgentTask['ctx'],
|
|
705
|
-
parentSessionId?: string,
|
|
706
|
-
subSessionId?: string,
|
|
707
|
-
) {
|
|
708
|
-
if (!parentSessionId || !subSessionId) return null;
|
|
709
|
-
|
|
710
|
-
const messageRepo = ctx.db?.getRepository?.('aiMessages') as
|
|
711
|
-
| { find?: (options: Record<string, unknown>) => Promise<unknown[]> }
|
|
712
|
-
| undefined;
|
|
713
|
-
const toolRepo = ctx.db?.getRepository?.('aiToolMessages') as
|
|
714
|
-
| { findOne?: (options: Record<string, unknown>) => Promise<unknown> }
|
|
715
|
-
| undefined;
|
|
716
|
-
const messages = await messageRepo?.find?.({
|
|
717
|
-
filter: { sessionId: parentSessionId },
|
|
718
|
-
sort: ['-messageId'],
|
|
719
|
-
limit: 20,
|
|
720
|
-
});
|
|
721
|
-
if (!Array.isArray(messages)) return null;
|
|
722
|
-
|
|
723
|
-
for (const rawMessage of messages) {
|
|
724
|
-
const message = toPlain(rawMessage);
|
|
725
|
-
const conversations = asObject(message?.metadata).subAgentConversations;
|
|
726
|
-
if (!Array.isArray(conversations)) continue;
|
|
727
|
-
|
|
728
|
-
const matched = conversations.find((item) => normalizeString(item?.sessionId) === subSessionId);
|
|
729
|
-
const toolCallId = normalizeString(matched?.toolCallId);
|
|
730
|
-
if (!toolCallId) continue;
|
|
731
|
-
|
|
732
|
-
const toolMessage = await toolRepo?.findOne?.({
|
|
733
|
-
filter: {
|
|
734
|
-
sessionId: parentSessionId,
|
|
735
|
-
toolCallId,
|
|
736
|
-
},
|
|
737
|
-
});
|
|
738
|
-
return {
|
|
739
|
-
...(toPlain(toolMessage) || {}),
|
|
740
|
-
toolCallId,
|
|
741
|
-
messageId: readValue(toolMessage, 'messageId') || message?.messageId,
|
|
742
|
-
sessionId: parentSessionId,
|
|
743
|
-
status: matched?.status,
|
|
744
|
-
} as DispatchToolMessage;
|
|
745
|
-
}
|
|
746
|
-
|
|
747
|
-
return null;
|
|
748
|
-
}
|
|
749
|
-
|
|
750
|
-
private async flushPending(state: RunState) {
|
|
751
|
-
const pending = Array.from(state.pending);
|
|
752
|
-
if (!pending.length) return;
|
|
753
|
-
await Promise.allSettled(pending);
|
|
754
|
-
}
|
|
755
|
-
}
|
|
756
|
-
|
|
757
|
-
export { NATIVE_SOURCE, makeNativeRunId };
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
|
|
3
|
+
import { createHash } from 'crypto';
|
|
4
|
+
import { ExecutionSpanService } from './ExecutionSpanService';
|
|
5
|
+
import { AgentMemoryContextService } from './AgentMemoryContextService';
|
|
6
|
+
import { asObject } from '../utils/ctx-utils';
|
|
7
|
+
|
|
8
|
+
export const NATIVE_SOURCE = 'native-plugin-ai';
|
|
9
|
+
const WRAP_STATE_KEY = Symbol.for('plugin-agent-orchestrator.nativeSubAgentObserver');
|
|
10
|
+
|
|
11
|
+
type NativeRepository = {
|
|
12
|
+
create: (options: Record<string, unknown>) => Promise<unknown>;
|
|
13
|
+
update: (options: Record<string, unknown>) => Promise<unknown>;
|
|
14
|
+
find?: (options?: Record<string, unknown>) => Promise<unknown[]>;
|
|
15
|
+
findOne?: (options: Record<string, unknown>) => Promise<unknown>;
|
|
16
|
+
};
|
|
17
|
+
|
|
18
|
+
type NativeContext = {
|
|
19
|
+
action?: { params?: { values?: Record<string, unknown> } };
|
|
20
|
+
auth?: { user?: { id?: string | number } };
|
|
21
|
+
db?: { getRepository?: (name: string) => NativeRepository | undefined };
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
type NativeSubAgentTask = {
|
|
25
|
+
ctx: NativeContext;
|
|
26
|
+
sessionId: string;
|
|
27
|
+
employee: unknown;
|
|
28
|
+
model?: unknown;
|
|
29
|
+
question: string;
|
|
30
|
+
skillSettings?: Record<string, unknown>;
|
|
31
|
+
writer?: (chunk: Record<string, unknown>) => unknown;
|
|
32
|
+
};
|
|
33
|
+
|
|
34
|
+
type DispatcherWithRun = {
|
|
35
|
+
run: (task: NativeSubAgentTask) => Promise<string>;
|
|
36
|
+
[WRAP_STATE_KEY]?: {
|
|
37
|
+
originalRun: (task: NativeSubAgentTask) => Promise<string>;
|
|
38
|
+
wrappedRun: (task: NativeSubAgentTask) => Promise<string>;
|
|
39
|
+
};
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
type ObserverPlugin = {
|
|
43
|
+
app: {
|
|
44
|
+
logger?: {
|
|
45
|
+
info?: (
|
|
46
|
+
message: string,
|
|
47
|
+
meta?: { module?: string; submodule?: string; method?: string; [key: string]: unknown },
|
|
48
|
+
) => void;
|
|
49
|
+
warn?: (
|
|
50
|
+
message: string,
|
|
51
|
+
meta?: { module?: string; submodule?: string; method?: string; [key: string]: unknown },
|
|
52
|
+
) => void;
|
|
53
|
+
};
|
|
54
|
+
pm?: { get?: (name: string) => unknown };
|
|
55
|
+
};
|
|
56
|
+
db: { getRepository: (name: string) => NativeRepository | undefined };
|
|
57
|
+
};
|
|
58
|
+
|
|
59
|
+
type ObserverSettings = {
|
|
60
|
+
nativeObserverEnabled?: boolean;
|
|
61
|
+
harnessTag?: string;
|
|
62
|
+
observability?: {
|
|
63
|
+
enabled?: boolean;
|
|
64
|
+
sharing?: string;
|
|
65
|
+
};
|
|
66
|
+
};
|
|
67
|
+
|
|
68
|
+
function objectValue(value: unknown) {
|
|
69
|
+
return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function readValue(record: unknown, key: string) {
|
|
73
|
+
const model = record as { get?: (name: string) => unknown; [name: string]: unknown };
|
|
74
|
+
return typeof model?.get === 'function' ? model.get(key) : model?.[key];
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
function stringValue(value: unknown) {
|
|
78
|
+
return typeof value === 'string' ? value.trim() : '';
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
function makeNativeRunId(parts: Array<string | number | undefined>) {
|
|
82
|
+
const source = parts.map((part) => String(part || '')).join('|');
|
|
83
|
+
return (
|
|
84
|
+
'native_' +
|
|
85
|
+
createHash('sha1')
|
|
86
|
+
.update(source || String(Date.now()))
|
|
87
|
+
.digest('hex')
|
|
88
|
+
.slice(0, 24)
|
|
89
|
+
);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
function errorText(error: unknown) {
|
|
93
|
+
try {
|
|
94
|
+
return error instanceof Error ? error.message : String(error || 'Unknown error');
|
|
95
|
+
} catch {
|
|
96
|
+
return 'Unknown error';
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
function rowAsObject(value: unknown) {
|
|
101
|
+
const record = value as { toJSON?: () => unknown };
|
|
102
|
+
const resolved = typeof record?.toJSON === 'function' ? record.toJSON() : value;
|
|
103
|
+
return objectValue(resolved);
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
export class NativeSubAgentObserver {
|
|
107
|
+
private readonly spanService: ExecutionSpanService;
|
|
108
|
+
private readonly policyService: AgentMemoryContextService;
|
|
109
|
+
|
|
110
|
+
constructor(private readonly plugin: ObserverPlugin) {
|
|
111
|
+
this.spanService = new ExecutionSpanService(plugin);
|
|
112
|
+
this.policyService = new AgentMemoryContextService(plugin);
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
install() {
|
|
116
|
+
const aiPlugin = this.plugin.app.pm?.get?.('ai');
|
|
117
|
+
const dispatcher = objectValue(aiPlugin).subAgentsDispatcher as DispatcherWithRun | undefined;
|
|
118
|
+
if (!dispatcher?.run) {
|
|
119
|
+
this.warn('[AgentOrchestrator] plugin-ai subAgentsDispatcher not available; observer skipped.');
|
|
120
|
+
return false;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
const existing = dispatcher[WRAP_STATE_KEY];
|
|
124
|
+
if (existing?.wrappedRun === dispatcher.run) return false;
|
|
125
|
+
|
|
126
|
+
const originalRun = existing?.originalRun || dispatcher.run.bind(dispatcher);
|
|
127
|
+
const observer = this;
|
|
128
|
+
const wrappedRun = async function wrappedNativeSubAgentRun(task: NativeSubAgentTask) {
|
|
129
|
+
return observer.runObserved(originalRun, task);
|
|
130
|
+
};
|
|
131
|
+
|
|
132
|
+
dispatcher.run = wrappedRun;
|
|
133
|
+
dispatcher[WRAP_STATE_KEY] = { originalRun, wrappedRun };
|
|
134
|
+
this.info('[AgentOrchestrator] Native plugin-ai sub-agent observer installed.');
|
|
135
|
+
return true;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
uninstall() {
|
|
139
|
+
const aiPlugin = this.plugin.app.pm?.get?.('ai');
|
|
140
|
+
const dispatcher = objectValue(aiPlugin).subAgentsDispatcher as DispatcherWithRun | undefined;
|
|
141
|
+
const existing = dispatcher?.[WRAP_STATE_KEY];
|
|
142
|
+
if (!dispatcher?.run || !existing || existing.wrappedRun !== dispatcher.run) return false;
|
|
143
|
+
|
|
144
|
+
dispatcher.run = existing.originalRun;
|
|
145
|
+
delete dispatcher[WRAP_STATE_KEY];
|
|
146
|
+
this.info('[AgentOrchestrator] Native plugin-ai sub-agent observer uninstalled.');
|
|
147
|
+
return true;
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
private async runObserved(originalRun: (task: NativeSubAgentTask) => Promise<string>, task: NativeSubAgentTask) {
|
|
151
|
+
const startedAt = Date.now();
|
|
152
|
+
try {
|
|
153
|
+
// Preserve the native task object, writer, prompt, skill settings, and result exactly.
|
|
154
|
+
const result = await originalRun(task);
|
|
155
|
+
this.observeDispatch(task, 'success', startedAt).catch((error) => {
|
|
156
|
+
this.warn('[AgentOrchestrator] Native dispatch telemetry failed; continuing native execution.', error);
|
|
157
|
+
});
|
|
158
|
+
return result;
|
|
159
|
+
} catch (error) {
|
|
160
|
+
this.observeDispatch(task, 'error', startedAt).catch((telemetryError) => {
|
|
161
|
+
this.warn('[AgentOrchestrator] Native dispatch telemetry failed; continuing native execution.', telemetryError);
|
|
162
|
+
});
|
|
163
|
+
throw error;
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
private async observeDispatch(task: NativeSubAgentTask, status: 'success' | 'error', startedAt: number) {
|
|
168
|
+
try {
|
|
169
|
+
const settings = (await this.policyService.resolvePolicySettings(task)) as ObserverSettings;
|
|
170
|
+
if (settings.nativeObserverEnabled === false || settings.observability?.enabled === false) return;
|
|
171
|
+
if (settings.observability?.sharing === 'disabled') return;
|
|
172
|
+
|
|
173
|
+
const parentSessionId = stringValue(task.ctx?.action?.params?.values?.sessionId);
|
|
174
|
+
const subSessionId = stringValue(task.sessionId);
|
|
175
|
+
const employeeUsername =
|
|
176
|
+
stringValue(readValue(task.employee, 'username')) ||
|
|
177
|
+
stringValue(readValue(task.employee, 'aiEmployeeUsername')) ||
|
|
178
|
+
stringValue(readValue(task.employee, 'name')) ||
|
|
179
|
+
undefined;
|
|
180
|
+
const dispatch = await this.resolveDispatch(parentSessionId, subSessionId, task.ctx.db);
|
|
181
|
+
const toolCallId = dispatch?.toolCallId;
|
|
182
|
+
if (!parentSessionId || !subSessionId || !toolCallId) return;
|
|
183
|
+
|
|
184
|
+
const parentConversation = await this.findOne(task.ctx.db, 'aiConversations', {
|
|
185
|
+
filter: { sessionId: parentSessionId },
|
|
186
|
+
});
|
|
187
|
+
const parentSpan = await this.findParentSpan(parentConversation, parentSessionId);
|
|
188
|
+
// If the main projection is not yet available, let reconciliation link this call later;
|
|
189
|
+
// inventing a root here can race a valid legacy control-plane association.
|
|
190
|
+
if (!parentSpan) return;
|
|
191
|
+
const rootRunId = stringValue(parentSpan.rootRunId);
|
|
192
|
+
if (!rootRunId) return;
|
|
193
|
+
const parentSpanId = parentSpan?.id === undefined ? undefined : String(parentSpan.id);
|
|
194
|
+
const endedAt = new Date();
|
|
195
|
+
const nativeIdentity = 'native:tool-call:' + toolCallId;
|
|
196
|
+
const span = await this.spanService.upsertNative(nativeIdentity, {
|
|
197
|
+
nativeIdentity,
|
|
198
|
+
rootRunId,
|
|
199
|
+
parentSpanId,
|
|
200
|
+
depth: Number(parentSpan?.depth) + 1 || 1,
|
|
201
|
+
source: NATIVE_SOURCE,
|
|
202
|
+
parentSessionId,
|
|
203
|
+
subSessionId,
|
|
204
|
+
toolCallId,
|
|
205
|
+
type: 'sub_agent',
|
|
206
|
+
status: status === 'error' ? 'error' : 'unknown',
|
|
207
|
+
leaderUsername: stringValue(readValue(parentConversation, 'aiEmployeeUsername')) || undefined,
|
|
208
|
+
employeeUsername,
|
|
209
|
+
toolName: 'dispatch-sub-agent-task',
|
|
210
|
+
title: 'Native sub-agent dispatch',
|
|
211
|
+
startedAt: new Date(startedAt),
|
|
212
|
+
endedAt,
|
|
213
|
+
nativeActivityAt: endedAt,
|
|
214
|
+
durationMs: Math.max(0, endedAt.getTime() - startedAt),
|
|
215
|
+
metadata: {
|
|
216
|
+
source: NATIVE_SOURCE,
|
|
217
|
+
nativeCoverage: { source: 'dispatcher-return', realtime: false },
|
|
218
|
+
capturePolicy: {
|
|
219
|
+
source: 'native-persistence-no-invocation-snapshot',
|
|
220
|
+
sharing: 'disabled',
|
|
221
|
+
captureInputs: false,
|
|
222
|
+
captureOutputs: false,
|
|
223
|
+
redactSecrets: true,
|
|
224
|
+
},
|
|
225
|
+
dispatchToolMessageId: dispatch.id,
|
|
226
|
+
dispatchMessageId: dispatch.messageId,
|
|
227
|
+
harnessTag: settings.harnessTag || 'default',
|
|
228
|
+
outcome: status,
|
|
229
|
+
},
|
|
230
|
+
userId: task.ctx.auth?.user?.id,
|
|
231
|
+
});
|
|
232
|
+
if (!span) this.warn('[AgentOrchestrator] Native dispatch telemetry was not persisted.');
|
|
233
|
+
} catch (error) {
|
|
234
|
+
this.warn('[AgentOrchestrator] Native dispatch telemetry failed; continuing native execution.', error);
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
private async resolveDispatch(parentSessionId: string, subSessionId: string, db?: NativeContext['db']) {
|
|
239
|
+
if (!parentSessionId || !subSessionId) return null;
|
|
240
|
+
const messages = await this.findMany(db, 'aiMessages', {
|
|
241
|
+
filter: { sessionId: parentSessionId },
|
|
242
|
+
sort: ['-messageId'],
|
|
243
|
+
limit: 100,
|
|
244
|
+
});
|
|
245
|
+
for (const message of messages) {
|
|
246
|
+
const relations = asObject(readValue(message, 'metadata')).subAgentConversations;
|
|
247
|
+
if (!Array.isArray(relations)) continue;
|
|
248
|
+
const relation = relations.find((value) => stringValue(asObject(value).sessionId) === subSessionId);
|
|
249
|
+
const toolCallId = stringValue(asObject(relation).toolCallId);
|
|
250
|
+
if (toolCallId) {
|
|
251
|
+
return {
|
|
252
|
+
id: undefined,
|
|
253
|
+
messageId: stringValue(readValue(message, 'messageId')),
|
|
254
|
+
toolCallId,
|
|
255
|
+
};
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
const toolMessage = await this.findOne(db, 'aiToolMessages', {
|
|
260
|
+
filter: { sessionId: parentSessionId, toolName: 'dispatch-sub-agent-task' },
|
|
261
|
+
sort: ['-id'],
|
|
262
|
+
});
|
|
263
|
+
const contentSessionId = stringValue(asObject(readValue(toolMessage, 'content')).sessionId);
|
|
264
|
+
return contentSessionId === subSessionId
|
|
265
|
+
? {
|
|
266
|
+
id: readValue(toolMessage, 'id'),
|
|
267
|
+
messageId: stringValue(readValue(toolMessage, 'messageId')),
|
|
268
|
+
toolCallId: stringValue(readValue(toolMessage, 'toolCallId')),
|
|
269
|
+
}
|
|
270
|
+
: null;
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
private async findParentSpan(parentConversation: Record<string, unknown> | null, parentSessionId: string) {
|
|
274
|
+
const from = stringValue(readValue(parentConversation, 'from'));
|
|
275
|
+
if (from === 'sub-agent') {
|
|
276
|
+
return this.findOne(this.plugin.db, 'agentExecutionSpans', {
|
|
277
|
+
filter: { source: NATIVE_SOURCE, type: 'sub_agent', subSessionId: parentSessionId },
|
|
278
|
+
});
|
|
279
|
+
}
|
|
280
|
+
return this.findOne(this.plugin.db, 'agentExecutionSpans', {
|
|
281
|
+
filter: { source: NATIVE_SOURCE, type: 'main_agent', parentSessionId },
|
|
282
|
+
});
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
private async findOne(
|
|
286
|
+
database: NativeContext['db'] | ObserverPlugin['db'],
|
|
287
|
+
name: string,
|
|
288
|
+
options: Record<string, unknown>,
|
|
289
|
+
): Promise<Record<string, unknown> | null> {
|
|
290
|
+
try {
|
|
291
|
+
const row = await database?.getRepository?.(name)?.findOne?.(options);
|
|
292
|
+
return row ? rowAsObject(row) : null;
|
|
293
|
+
} catch {
|
|
294
|
+
return null;
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
private async findMany(database: NativeContext['db'] | undefined, name: string, options: Record<string, unknown>) {
|
|
299
|
+
try {
|
|
300
|
+
const rows = await database?.getRepository?.(name)?.find?.(options);
|
|
301
|
+
return Array.isArray(rows) ? rows.map(rowAsObject) : [];
|
|
302
|
+
} catch {
|
|
303
|
+
return [];
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
private info(message: string) {
|
|
308
|
+
try {
|
|
309
|
+
this.plugin.app.logger?.info?.(message);
|
|
310
|
+
} catch {
|
|
311
|
+
// Telemetry logging is best effort.
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
|
|
315
|
+
private warn(message: string, error?: unknown) {
|
|
316
|
+
try {
|
|
317
|
+
this.plugin.app.logger?.warn?.(message, { error });
|
|
318
|
+
} catch {
|
|
319
|
+
// Telemetry logging must not affect native execution.
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
export { makeNativeRunId };
|