plugin-agent-orchestrator 1.1.7 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (413) hide show
  1. package/README.md +207 -204
  2. package/client-v2.d.ts +2 -2
  3. package/client-v2.js +1 -1
  4. package/client.d.ts +2 -2
  5. package/client.js +1 -1
  6. package/dist/client/117.2e4cb0477da3db1f.js +10 -0
  7. package/dist/client/253.93deb9e0192e76a5.js +10 -0
  8. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  9. package/dist/client/404.498d2d9516dd1dce.js +10 -0
  10. package/dist/client/418.6f01da17774a5a25.js +10 -0
  11. package/dist/client/53.774ff07505d521fa.js +10 -0
  12. package/dist/client/619.e342b0fa467d39ca.js +10 -0
  13. package/dist/client/627.fdd60bcc0f3a9cf6.js +10 -0
  14. package/dist/client/652.477e21bfff67bc1c.js +10 -0
  15. package/dist/client/981.e0546ffc34afedcd.js +10 -0
  16. package/dist/client/993.5d04b510835ab0d2.js +10 -0
  17. package/dist/client/index.js +1 -1
  18. package/dist/client-v2/117.ccf43ae8631f7d74.js +10 -0
  19. package/dist/client-v2/214.cdf76752053a8990.js +10 -0
  20. package/dist/client-v2/253.1198df22f5baf304.js +10 -0
  21. package/dist/client-v2/264.78887ff88f969467.js +10 -0
  22. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  23. package/dist/client-v2/404.9ba964c28a151c81.js +10 -0
  24. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.b28cf7a675a603d1.js} +1 -1
  25. package/dist/client-v2/418.55b6b28cda8bb5f3.js +10 -0
  26. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.282081f97e4308c6.js} +1 -1
  27. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.8c03913873785fb6.js} +1 -1
  28. package/dist/client-v2/627.e16f4a0dd596c3e6.js +10 -0
  29. package/dist/client-v2/652.1a48364774d5383a.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.9166ed70906d041f.js} +1 -1
  31. package/dist/client-v2/{981.e4a1f41cfc94a856.js → 981.a81521f0296c7db8.js} +1 -1
  32. package/dist/client-v2/993.ca5b28f1e2b4c1ef.js +10 -0
  33. package/dist/client-v2/index.js +1 -1
  34. package/dist/externalVersion.js +10 -7
  35. package/dist/locale/en-US.json +229 -1
  36. package/dist/locale/zh-CN.json +229 -1
  37. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  38. package/dist/node_modules/adm-zip/package.json +1 -1
  39. package/dist/node_modules/ajv/package.json +1 -1
  40. package/dist/node_modules/zod/index.cjs +1 -1
  41. package/dist/node_modules/zod/package.json +1 -1
  42. package/dist/server/collections/agent-execution-spans.js +145 -6
  43. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  44. package/dist/server/collections/agent-governance-policies.js +47 -0
  45. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  46. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  47. package/dist/server/collections/agent-loop-runs.js +23 -5
  48. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  49. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  50. package/dist/server/plugin.js +114 -33
  51. package/dist/server/resources/agent-governance.js +192 -0
  52. package/dist/server/resources/agent-harness-profile.js +11 -3
  53. package/dist/server/resources/agent-monitor.js +109 -339
  54. package/dist/server/resources/agent-usage.js +423 -0
  55. package/dist/server/resources/native-monitor-format.js +179 -0
  56. package/dist/server/resources/tracing.js +35 -12
  57. package/dist/server/services/AgentGovernanceService.js +500 -0
  58. package/dist/server/services/DepartmentAttribution.js +65 -0
  59. package/dist/server/services/ExecutionSpanService.js +96 -3
  60. package/dist/server/services/GovernanceAdmission.js +211 -0
  61. package/dist/server/services/HarnessCapabilities.js +118 -0
  62. package/dist/server/services/LoopBudgetService.js +29 -11
  63. package/dist/server/services/LoopRunRepository.js +15 -6
  64. package/dist/server/services/LoopRunStateMachine.js +18 -7
  65. package/dist/server/services/LoopTriggerService.js +1 -1
  66. package/dist/server/services/LoopWorkerService.js +66 -32
  67. package/dist/server/services/ManagedPromptProtection.js +99 -0
  68. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  69. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  70. package/dist/server/services/NativeUsageAttribution.js +97 -0
  71. package/dist/server/services/TokenTracker.js +787 -104
  72. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  73. package/dist/server/services/VerificationService.js +18 -8
  74. package/dist/server/skill-hub/sandbox-config.json +6 -6
  75. package/dist/server/utils/ensure-indexes.js +14 -5
  76. package/package.json +63 -53
  77. package/server.d.ts +2 -2
  78. package/server.js +1 -1
  79. package/src/client/AgentRunsTab.tsx +2 -2
  80. package/src/client/ApprovalsTab.tsx +2 -2
  81. package/src/client/HarnessProfilesTab.tsx +2 -2
  82. package/src/client/OrchestratorSettings.tsx +152 -152
  83. package/src/client/SkillPages.tsx +41 -0
  84. package/src/client/__tests__/embedded-settings.test.tsx +232 -0
  85. package/src/client/hooks/useRunEventStream.ts +76 -76
  86. package/src/client/index.tsx +2 -2
  87. package/src/client/plugin.tsx +76 -32
  88. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  89. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  90. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  91. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  92. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  93. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  94. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  95. package/src/client/skill-hub/index.tsx +6 -6
  96. package/src/client/skill-hub/locale.ts +16 -16
  97. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +132 -132
  98. package/src/client/skill-hub/tools/SkillHubCard.tsx +104 -104
  99. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  100. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +71 -71
  101. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  102. package/src/client-v2/__tests__/embedded-settings.test.tsx +193 -0
  103. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  104. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  105. package/src/client-v2/components/AgentBindingsTab.tsx +269 -269
  106. package/src/client-v2/components/AgentRunsTab.tsx +92 -83
  107. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  108. package/src/client-v2/components/EmployeeGovernanceTab.tsx +702 -0
  109. package/src/client-v2/components/HarnessProfilesTab.tsx +704 -541
  110. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  111. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  112. package/src/client-v2/components/UsageGovernanceTab.tsx +386 -0
  113. package/src/client-v2/index.tsx +1 -1
  114. package/src/client-v2/pages/AgentBindingsPage.tsx +22 -13
  115. package/src/client-v2/pages/ApprovalsPage.tsx +19 -10
  116. package/src/client-v2/pages/EmployeeGovernancePage.tsx +22 -0
  117. package/src/client-v2/pages/ExecutionHistoryPage.tsx +19 -10
  118. package/src/client-v2/pages/HarnessProfilesPage.tsx +19 -10
  119. package/src/client-v2/pages/KnowledgeAccessPage.tsx +19 -10
  120. package/src/client-v2/pages/LoopSettingsPage.tsx +19 -10
  121. package/src/client-v2/pages/MemoryInspectorPage.tsx +22 -13
  122. package/src/client-v2/pages/RetrievalTracePage.tsx +19 -10
  123. package/src/client-v2/pages/RulesPage.tsx +22 -13
  124. package/src/client-v2/pages/SkillDefinitionsPage.tsx +19 -10
  125. package/src/client-v2/pages/SkillMetricsPage.tsx +19 -10
  126. package/src/client-v2/pages/TracingPage.tsx +22 -13
  127. package/src/client-v2/pages/UsageGovernancePage.tsx +22 -0
  128. package/src/client-v2/plugin.tsx +139 -99
  129. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  130. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  131. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  132. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  133. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  134. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  135. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  136. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  137. package/src/client-v2/skill-hub/locale.ts +13 -13
  138. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  139. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  140. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +110 -0
  141. package/src/client-v2/skill-hub/tools/interactions.ts +128 -0
  142. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  143. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  144. package/src/client-v2/utils/jsonFields.ts +41 -41
  145. package/src/index.ts +2 -2
  146. package/src/locale/en-US.json +229 -1
  147. package/src/locale/zh-CN.json +229 -1
  148. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  149. package/src/server/__tests__/agent-governance.integration.test.ts +392 -0
  150. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  151. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +274 -0
  152. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  153. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  154. package/src/server/__tests__/agent-usage-report.integration.test.ts +342 -0
  155. package/src/server/__tests__/code-validator.test.ts +63 -63
  156. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  157. package/src/server/__tests__/harness-capabilities.test.ts +95 -0
  158. package/src/server/__tests__/harness-compiler.test.ts +214 -214
  159. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  160. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  161. package/src/server/__tests__/harness-tool-plan.test.ts +182 -172
  162. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  163. package/src/server/__tests__/loop-approval-decision.test.ts +577 -512
  164. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  165. package/src/server/__tests__/loop-budget-service.test.ts +36 -0
  166. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  167. package/src/server/__tests__/loop-run-repository.test.ts +32 -0
  168. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  169. package/src/server/__tests__/loop-trigger-service.test.ts +192 -148
  170. package/src/server/__tests__/loop-worker-claim.test.ts +72 -9
  171. package/src/server/__tests__/loop-worker-execution.test.ts +382 -317
  172. package/src/server/__tests__/native-agent-monitor-sync.test.ts +350 -0
  173. package/src/server/__tests__/native-sub-agent-observer.test.ts +470 -662
  174. package/src/server/__tests__/native-usage-attribution.integration.test.ts +175 -0
  175. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  176. package/src/server/__tests__/skill-execute.test.ts +70 -70
  177. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  178. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  179. package/src/server/__tests__/skill-settings.test.ts +63 -63
  180. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  181. package/src/server/__tests__/token-tracker.test.ts +639 -0
  182. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  183. package/src/server/__tests__/tracing-retention-policy.test.ts +37 -0
  184. package/src/server/__tests__/usage-ledger.integration.test.ts +194 -0
  185. package/src/server/collections/agent-execution-spans.ts +393 -245
  186. package/src/server/collections/agent-governance-audit-events.ts +26 -0
  187. package/src/server/collections/agent-governance-policies.ts +26 -0
  188. package/src/server/collections/agent-governance-policy-versions.ts +27 -0
  189. package/src/server/collections/agent-governance-prompt-bindings.ts +29 -0
  190. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  191. package/src/server/collections/agent-loop-runs.ts +396 -369
  192. package/src/server/collections/agent-loop-steps.ts +220 -220
  193. package/src/server/collections/agent-memory-contexts.ts +95 -95
  194. package/src/server/collections/orchestrator-config.ts +87 -87
  195. package/src/server/collections/orchestrator-logs.ts +116 -116
  196. package/src/server/collections/skill-definitions.ts +159 -159
  197. package/src/server/collections/skill-executions.ts +154 -154
  198. package/src/server/collections/skill-loop-configs.ts +65 -65
  199. package/src/server/collections/skill-metrics.ts +36 -36
  200. package/src/server/collections/skill-registry-installations.ts +41 -41
  201. package/src/server/collections/skill-worker-configs.ts +86 -86
  202. package/src/server/index.ts +1 -1
  203. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  204. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  205. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  206. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  207. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  208. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  209. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  210. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  211. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  212. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  213. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +117 -0
  214. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +35 -0
  215. package/src/server/plugin.ts +674 -573
  216. package/src/server/resources/agent-governance.ts +168 -0
  217. package/src/server/resources/agent-harness-profile.ts +110 -94
  218. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  219. package/src/server/resources/agent-loop-approval.ts +84 -84
  220. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  221. package/src/server/resources/agent-loop.ts +252 -252
  222. package/src/server/resources/agent-monitor.ts +215 -482
  223. package/src/server/resources/agent-usage.ts +420 -0
  224. package/src/server/resources/native-monitor-format.ts +157 -0
  225. package/src/server/resources/tracing.ts +303 -267
  226. package/src/server/services/AgentExecutionContext.ts +23 -23
  227. package/src/server/services/AgentGovernanceService.ts +548 -0
  228. package/src/server/services/AgentMemoryContextService.ts +344 -344
  229. package/src/server/services/AgentRegistryService.ts +220 -220
  230. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  231. package/src/server/services/CodeValidator.ts +238 -238
  232. package/src/server/services/DepartmentAttribution.ts +54 -0
  233. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  234. package/src/server/services/ExecutionSpanService.ts +278 -146
  235. package/src/server/services/FileManager.ts +159 -159
  236. package/src/server/services/GovernanceAdmission.ts +239 -0
  237. package/src/server/services/HarnessCapabilities.ts +119 -0
  238. package/src/server/services/HarnessCompiler.ts +170 -170
  239. package/src/server/services/HarnessProfileService.ts +235 -235
  240. package/src/server/services/HarnessSchema.ts +194 -194
  241. package/src/server/services/InputSchemaValidator.ts +44 -44
  242. package/src/server/services/LoopBudgetService.ts +332 -271
  243. package/src/server/services/LoopControlService.ts +120 -120
  244. package/src/server/services/LoopPatternSchema.ts +231 -231
  245. package/src/server/services/LoopPatternService.ts +171 -171
  246. package/src/server/services/LoopRunRepository.ts +350 -332
  247. package/src/server/services/LoopRunStateMachine.ts +545 -525
  248. package/src/server/services/LoopSchedulerService.ts +195 -195
  249. package/src/server/services/LoopTriggerService.ts +169 -159
  250. package/src/server/services/LoopWorkerService.ts +986 -912
  251. package/src/server/services/ManagedPromptProtection.ts +88 -0
  252. package/src/server/services/NativeAgentMonitorSyncService.ts +691 -0
  253. package/src/server/services/NativeSubAgentObserver.ts +331 -757
  254. package/src/server/services/NativeUsageAttribution.ts +98 -0
  255. package/src/server/services/PathLockService.ts +317 -317
  256. package/src/server/services/PluginAiRuntimeAdapter.ts +387 -387
  257. package/src/server/services/RunEventBus.ts +58 -58
  258. package/src/server/services/SandboxRunner.ts +492 -492
  259. package/src/server/services/SkillAccessService.ts +175 -175
  260. package/src/server/services/SkillManager.ts +585 -585
  261. package/src/server/services/SkillRepositoryService.ts +236 -236
  262. package/src/server/services/TokenTracker.ts +1158 -287
  263. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  264. package/src/server/services/TracingRetentionPolicy.ts +56 -0
  265. package/src/server/services/VerificationSchema.ts +31 -31
  266. package/src/server/services/VerificationService.ts +332 -313
  267. package/src/server/services/WorkerEnvManager.ts +198 -198
  268. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  269. package/src/server/services/harness-runtime-policy.ts +134 -134
  270. package/src/server/services/pythonGuardTemplate.ts +87 -87
  271. package/src/server/services/sandboxCapabilities.ts +348 -348
  272. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  273. package/src/server/skill-hub/actions/git-import.ts +936 -936
  274. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  275. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  276. package/src/server/skill-hub/plugin.ts +1232 -1232
  277. package/src/server/skill-hub/sandbox-config.json +6 -6
  278. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +281 -281
  279. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  280. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +568 -568
  281. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  282. package/src/server/tools/delegate-task.ts +30 -30
  283. package/src/server/tools/external-rag-search.ts +329 -329
  284. package/src/server/tools/skill-execute.ts +216 -216
  285. package/src/server/types.ts +21 -21
  286. package/src/server/utils/ai-manager.ts +24 -24
  287. package/src/server/utils/ctx-utils.ts +132 -132
  288. package/src/server/utils/ensure-indexes.ts +119 -96
  289. package/src/server/utils/ha-lock.ts +80 -80
  290. package/src/server/utils/loop-pattern-context.ts +84 -84
  291. package/src/server/utils/record-utils.ts +19 -19
  292. package/src/server/utils/skill-settings.ts +135 -135
  293. package/src/server/utils/skill-tool-name.ts +58 -58
  294. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  295. package/dist/client-v2/214.106635011859dede.js +0 -10
  296. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  297. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  298. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  299. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  300. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  301. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  302. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  303. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  304. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  305. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  306. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  307. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  308. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  309. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  310. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  311. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  312. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  313. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  314. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  315. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  316. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  317. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  318. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  319. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  320. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  321. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  322. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  323. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  324. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  325. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  326. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  327. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  328. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  329. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  330. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  331. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  332. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  333. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  334. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  335. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  336. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  337. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  338. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  339. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  340. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  341. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  342. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  343. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  344. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  345. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  346. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  347. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  348. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  349. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  350. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  351. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  352. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  353. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  354. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  355. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  356. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  357. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  358. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  359. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  360. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  361. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  362. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  363. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  364. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  365. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  366. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  367. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  368. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  369. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  370. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  371. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  372. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  373. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  374. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  375. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  376. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  377. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  378. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  379. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  380. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  381. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  382. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  383. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  384. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  385. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  387. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  388. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  389. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  390. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  391. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  392. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  393. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  394. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  395. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  396. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  397. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  398. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  399. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  400. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  401. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  402. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  403. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  404. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  405. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  406. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  407. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  408. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  409. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  410. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  411. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  412. package/dist/node_modules/simple-git/package.json +0 -1
  413. package/dist/node_modules/simple-git/promise.js +0 -17
@@ -1,757 +1,331 @@
1
- import { createHash } from 'crypto';
2
- import { mkdirSync, writeFileSync } from 'fs';
3
- import { resolve } from 'path';
4
- import { ExecutionSpanService } from './ExecutionSpanService';
5
- import { AgentMemoryContextService } from './AgentMemoryContextService';
6
- import { TokenTracker } from './TokenTracker';
7
- import { getAgentExecutionContext, runWithAgentExecutionContext } from './AgentExecutionContext';
8
- import { compileHarness } from './HarnessCompiler';
9
- import type { CompiledHarness, HarnessLayer } from './HarnessCompiler';
10
- import { redactSecretsIn, resolveRunRoleHarness, spilledText } from './harness-runtime-policy';
11
- import { asObject, currentUserId, toPlain, trimText } from '../utils/ctx-utils';
12
-
13
- const WRAP_STATE_KEY = Symbol.for('plugin-agent-orchestrator.nativeSubAgentObserver');
14
- const NATIVE_SOURCE = 'native-plugin-ai';
15
-
16
- type NativeWriter = (chunk: Record<string, unknown>) => unknown;
17
-
18
- type NativeSubAgentTask = {
19
- ctx: {
20
- action?: { params?: { values?: Record<string, unknown> } };
21
- auth?: { user?: { id?: string | number } };
22
- db?: { getRepository?: (name: string) => unknown };
23
- app?: unknown;
24
- };
25
- sessionId: string;
26
- employee: unknown;
27
- model?: unknown;
28
- question: string;
29
- skillSettings?: Record<string, unknown>;
30
- writer?: NativeWriter;
31
- };
32
-
33
- type DispatchToolMessage = {
34
- id?: string | number;
35
- messageId?: string | number;
36
- toolCallId?: string;
37
- sessionId?: string;
38
- status?: string;
39
- invokeStatus?: string;
40
- };
41
-
42
- type SpanRecord = {
43
- id?: string | number;
44
- rootRunId?: string;
45
- metadata?: Record<string, unknown>;
46
- };
47
-
48
- type ToolSpanState = {
49
- spanId?: string | number;
50
- startedAt: number;
51
- ready: Promise<void>;
52
- };
53
-
54
- type RunState = {
55
- rootRunId: string;
56
- rootSpanId?: string | number;
57
- rootStartedAt: number;
58
- rootMetadata: Record<string, unknown>;
59
- parentSessionId?: string;
60
- subSessionId?: string;
61
- toolCallId?: string;
62
- leaderUsername?: string;
63
- employeeUsername?: string;
64
- userId?: string | number;
65
- policy: CompiledHarness;
66
- toolSpans: Map<string, ToolSpanState>;
67
- pending: Set<Promise<void>>;
68
- };
69
-
70
- type DispatcherWithRun = {
71
- run: (task: NativeSubAgentTask) => Promise<string>;
72
- [WRAP_STATE_KEY]?: {
73
- originalRun: (task: NativeSubAgentTask) => Promise<string>;
74
- wrappedRun: (task: NativeSubAgentTask) => Promise<string>;
75
- };
76
- };
77
-
78
- function readValue(record: unknown, key: string) {
79
- const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
80
- return typeof model?.get === 'function' ? model.get(key) : model?.[key];
81
- }
82
-
83
- function normalizeString(value: unknown) {
84
- return typeof value === 'string' ? value.trim() : '';
85
- }
86
-
87
- function modelUsername(model: unknown) {
88
- return (
89
- normalizeString(readValue(model, 'username')) ||
90
- normalizeString(readValue(model, 'aiEmployeeUsername')) ||
91
- normalizeString(readValue(model, 'name')) ||
92
- undefined
93
- );
94
- }
95
-
96
- function makeNativeRunId(parts: Array<string | number | undefined>) {
97
- const source = parts.map((part) => String(part || '')).join('|');
98
- return `native_${createHash('sha1')
99
- .update(source || String(Date.now()))
100
- .digest('hex')
101
- .slice(0, 24)}`;
102
- }
103
-
104
- function errorMessage(error: unknown) {
105
- return error instanceof Error ? error.message : String(error || 'Unknown error');
106
- }
107
-
108
- function chunkBody(chunk: Record<string, unknown>) {
109
- return asObject(chunk.body);
110
- }
111
-
112
- function chunkCurrentConversation(chunk: Record<string, unknown>) {
113
- return asObject(chunk.currentConversation);
114
- }
115
-
116
- function readSkillExecutionId(result: Record<string, unknown>): string | number | undefined {
117
- const nestedResult = asObject(result.result);
118
- const direct = nestedResult.execId || result.execId;
119
- if (typeof direct === 'string' || typeof direct === 'number') return direct;
120
-
121
- if (typeof result.content !== 'string') return undefined;
122
- try {
123
- const content = asObject(JSON.parse(result.content));
124
- return typeof content.execId === 'string' || typeof content.execId === 'number' ? content.execId : undefined;
125
- } catch {
126
- return undefined;
127
- }
128
- }
129
-
130
- export class NativeSubAgentObserver {
131
- private readonly spanService: ExecutionSpanService;
132
- private readonly memoryService: AgentMemoryContextService;
133
- private readonly tokenTracker: TokenTracker;
134
-
135
- constructor(private readonly plugin: { app: any; db: any; name?: string }) {
136
- this.spanService = new ExecutionSpanService(plugin);
137
- this.memoryService = new AgentMemoryContextService(plugin);
138
- this.tokenTracker = new TokenTracker(plugin);
139
- }
140
-
141
- install() {
142
- const aiPlugin = this.plugin.app.pm?.get?.('ai');
143
- const dispatcher = aiPlugin?.subAgentsDispatcher as DispatcherWithRun | undefined;
144
- if (!dispatcher?.run) {
145
- this.plugin.app.logger?.warn?.(
146
- '[AgentOrchestrator] plugin-ai subAgentsDispatcher not available; observer skipped.',
147
- );
148
- return false;
149
- }
150
-
151
- const existing = dispatcher[WRAP_STATE_KEY];
152
- if (existing?.wrappedRun === dispatcher.run) {
153
- return false;
154
- }
155
-
156
- const originalRun = existing?.originalRun || dispatcher.run.bind(dispatcher);
157
- const observer = this;
158
- const wrappedRun = async function wrappedNativeSubAgentRun(task: NativeSubAgentTask) {
159
- return observer.runObserved(originalRun, task);
160
- };
161
-
162
- dispatcher.run = wrappedRun;
163
- dispatcher[WRAP_STATE_KEY] = {
164
- originalRun,
165
- wrappedRun,
166
- };
167
-
168
- this.plugin.app.logger?.info?.('[AgentOrchestrator] Native plugin-ai sub-agent observer installed.');
169
- return true;
170
- }
171
-
172
- uninstall() {
173
- const aiPlugin = this.plugin.app.pm?.get?.('ai');
174
- const dispatcher = aiPlugin?.subAgentsDispatcher as DispatcherWithRun | undefined;
175
- const existing = dispatcher?.[WRAP_STATE_KEY];
176
- if (!dispatcher?.run || !existing || existing.wrappedRun !== dispatcher.run) {
177
- return false;
178
- }
179
-
180
- dispatcher.run = existing.originalRun;
181
- delete dispatcher[WRAP_STATE_KEY];
182
- this.plugin.app.logger?.info?.('[AgentOrchestrator] Native plugin-ai sub-agent observer uninstalled.');
183
- return true;
184
- }
185
-
186
- private async runObserved(originalRun: (task: NativeSubAgentTask) => Promise<string>, task: NativeSubAgentTask) {
187
- const settings = await this.safeResolvePolicy(task);
188
- if (settings.nativeObserverEnabled === false) {
189
- return originalRun(task);
190
- }
191
-
192
- const parentSessionId = this.resolveParentSessionId(task) || undefined;
193
- const parentConversation = await this.safeFindParentConversation(task.ctx, parentSessionId);
194
- const parentRunId = this.controlPlaneRunIdOf(parentConversation);
195
- // A sub-agent dispatched from a loop session inherits the role's frozen harness as an extra
196
- // compile layer, so delegation caps, sharing and memory restrictions do not reset at the hop.
197
- const parentRunHarness = parentRunId
198
- ? await this.safeResolveParentRunHarness(
199
- parentRunId,
200
- normalizeString(readValue(parentConversation, 'aiEmployeeUsername')),
201
- )
202
- : null;
203
- const policy = this.compilePolicy(settings, parentRunHarness);
204
- const spansEnabled = policy.observability.sharing !== 'disabled';
205
-
206
- const subSessionId = normalizeString(task.sessionId) || undefined;
207
- const employeeUsername = modelUsername(task.employee);
208
- const userId = currentUserId(task.ctx) || task.ctx?.auth?.user?.id;
209
- const dispatchToolMessage = await this.resolveDispatchToolMessage(task.ctx, parentSessionId, subSessionId);
210
- const toolCallId = dispatchToolMessage?.toolCallId;
211
- const leaderUsername = this.leaderUsernameFor(task.ctx, parentConversation);
212
- const rootRunId = makeNativeRunId([parentSessionId, subSessionId, toolCallId, employeeUsername]);
213
- const delegation = await this.resolveDelegationContext(parentSessionId);
214
- const childDepth = delegation.depth + 1;
215
- const memory = await this.safeBuildMemoryContext({
216
- userId,
217
- aiEmployeeUsername: employeeUsername,
218
- settings,
219
- });
220
- const observedTask: NativeSubAgentTask = {
221
- ...task,
222
- // Native dispatch passes the leader conversation's skillSettings to the
223
- // sub-agent. Clear that inherited filter so plugin-ai resolves tools from
224
- // the sub-agent employee's own bindings instead.
225
- skillSettings: undefined,
226
- question: memory.context ? `${memory.context}\n\n<agent_task>\n${task.question}\n</agent_task>` : task.question,
227
- };
228
-
229
- const state: RunState = {
230
- rootRunId,
231
- rootStartedAt: Date.now(),
232
- rootMetadata: {
233
- source: NATIVE_SOURCE,
234
- parentSessionId,
235
- subSessionId,
236
- toolCallId,
237
- dispatchToolMessageId: dispatchToolMessage?.id,
238
- dispatchMessageId: dispatchToolMessage?.messageId,
239
- memoryContextApplied: Boolean(memory.context),
240
- memoryScopes: memory.appliedScopes,
241
- memoryContextChars: memory.chars,
242
- harnessTag: settings.harnessTag || 'default',
243
- ...(parentRunId ? { agentLoopRunId: parentRunId } : {}),
244
- },
245
- parentSessionId,
246
- subSessionId,
247
- toolCallId,
248
- leaderUsername,
249
- employeeUsername,
250
- userId,
251
- policy,
252
- toolSpans: new Map(),
253
- pending: new Set(),
254
- };
255
-
256
- if (spansEnabled) {
257
- await this.safeCreateRootSpan(state, task.question, {
258
- depth: childDepth,
259
- parentSpanId: delegation.parentSpanId,
260
- agentLoopRunId: parentRunId,
261
- });
262
- }
263
-
264
- // Depth is persisted on the span, not carried in-process, so a resumed child arrives with its
265
- // true depth. The cap comes from the compiled policy, which includes the inherited parent
266
- // layer; exceeding it fails the dispatch instead of silently deepening the recursion.
267
- const maxDepth = policy.delegation.maxDepth;
268
- if (maxDepth !== null && childDepth > maxDepth) {
269
- const message = `Sub-agent delegation depth ${childDepth} exceeds the harness limit of ${maxDepth}.`;
270
- await this.spanService.finish(state.rootSpanId, 'error', state.rootStartedAt, {
271
- error: message,
272
- metadata: {
273
- ...state.rootMetadata,
274
- failedAt: new Date().toISOString(),
275
- },
276
- });
277
- throw new Error(message);
278
- }
279
-
280
- const originalWriter = task.writer;
281
- observedTask.writer = (chunk: Record<string, unknown>) => {
282
- const pending = this.handleWriterChunk(state, chunk).catch((error) => {
283
- this.plugin.app.logger?.warn?.('[AgentOrchestrator] Native writer observer failed', error);
284
- });
285
- state.pending.add(pending);
286
- return originalWriter?.(chunk);
287
- };
288
-
289
- try {
290
- const rawResult = await runWithAgentExecutionContext(
291
- {
292
- rootRunId,
293
- spanId: state.rootSpanId ? String(state.rootSpanId) : undefined,
294
- toolCallId,
295
- leaderUsername,
296
- employeeUsername,
297
- sessionId: subSessionId,
298
- },
299
- () => this.runWithKnowledgeBaseAgentContext(employeeUsername, () => originalRun(observedTask)),
300
- );
301
- const result = this.spillLargeResult(state, rawResult);
302
- await this.flushPending(state);
303
- const capturedOutput = this.spanOutput(state, trimText(result, 20000));
304
- await this.spanService.finish(state.rootSpanId, 'success', state.rootStartedAt, {
305
- ...(capturedOutput !== undefined ? { output: capturedOutput } : {}),
306
- metadata: {
307
- ...state.rootMetadata,
308
- completedAt: new Date().toISOString(),
309
- },
310
- });
311
- await this.tokenTracker.estimateAndTrack(
312
- state.rootSpanId,
313
- task.question,
314
- result,
315
- state.rootMetadata.agentLoopRunId ? Number(state.rootMetadata.agentLoopRunId) : undefined,
316
- );
317
- return result;
318
- } catch (error) {
319
- await this.flushPending(state);
320
- const capturedError = this.spanOutput(state, trimText(errorMessage(error), 10000));
321
- await this.spanService.finish(state.rootSpanId, 'error', state.rootStartedAt, {
322
- ...(capturedError !== undefined ? { error: capturedError } : {}),
323
- metadata: {
324
- ...state.rootMetadata,
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
+ /**
2
+ * This file is part of the NocoBase (R) project.
3
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
4
+ * Authors: NocoBase Team.
5
+ *
6
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
7
+ * For more information, please refer to: https://www.nocobase.com/agreement.
8
+ */
9
+
10
+ import { createHash } from 'crypto';
11
+ import { ExecutionSpanService } from './ExecutionSpanService';
12
+ import { AgentMemoryContextService } from './AgentMemoryContextService';
13
+ import { asObject } from '../utils/ctx-utils';
14
+
15
+ export const NATIVE_SOURCE = 'native-plugin-ai';
16
+ const WRAP_STATE_KEY = Symbol.for('plugin-agent-orchestrator.nativeSubAgentObserver');
17
+
18
+ type NativeRepository = {
19
+ create: (options: Record<string, unknown>) => Promise<unknown>;
20
+ update: (options: Record<string, unknown>) => Promise<unknown>;
21
+ find?: (options?: Record<string, unknown>) => Promise<unknown[]>;
22
+ findOne?: (options: Record<string, unknown>) => Promise<unknown>;
23
+ };
24
+
25
+ type NativeContext = {
26
+ action?: { params?: { values?: Record<string, unknown> } };
27
+ auth?: { user?: { id?: string | number } };
28
+ db?: { getRepository?: (name: string) => NativeRepository | undefined };
29
+ };
30
+
31
+ type NativeSubAgentTask = {
32
+ ctx: NativeContext;
33
+ sessionId: string;
34
+ employee: unknown;
35
+ model?: unknown;
36
+ question: string;
37
+ skillSettings?: Record<string, unknown>;
38
+ writer?: (chunk: Record<string, unknown>) => unknown;
39
+ };
40
+
41
+ type DispatcherWithRun = {
42
+ run: (task: NativeSubAgentTask) => Promise<string>;
43
+ [WRAP_STATE_KEY]?: {
44
+ originalRun: (task: NativeSubAgentTask) => Promise<string>;
45
+ wrappedRun: (task: NativeSubAgentTask) => Promise<string>;
46
+ };
47
+ };
48
+
49
+ type ObserverPlugin = {
50
+ app: {
51
+ logger?: {
52
+ info?: (
53
+ message: string,
54
+ meta?: { module?: string; submodule?: string; method?: string; [key: string]: unknown },
55
+ ) => void;
56
+ warn?: (
57
+ message: string,
58
+ meta?: { module?: string; submodule?: string; method?: string; [key: string]: unknown },
59
+ ) => void;
60
+ };
61
+ pm?: { get?: (name: string) => unknown };
62
+ };
63
+ db: { getRepository: (name: string) => NativeRepository | undefined };
64
+ };
65
+
66
+ type ObserverSettings = {
67
+ nativeObserverEnabled?: boolean;
68
+ harnessTag?: string;
69
+ observability?: {
70
+ enabled?: boolean;
71
+ sharing?: string;
72
+ };
73
+ };
74
+
75
+ function objectValue(value: unknown) {
76
+ return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
77
+ }
78
+
79
+ function readValue(record: unknown, key: string) {
80
+ const model = record as { get?: (name: string) => unknown; [name: string]: unknown };
81
+ return typeof model?.get === 'function' ? model.get(key) : model?.[key];
82
+ }
83
+
84
+ function stringValue(value: unknown) {
85
+ return typeof value === 'string' ? value.trim() : '';
86
+ }
87
+
88
+ function makeNativeRunId(parts: Array<string | number | undefined>) {
89
+ const source = parts.map((part) => String(part || '')).join('|');
90
+ return (
91
+ 'native_' +
92
+ createHash('sha1')
93
+ .update(source || String(Date.now()))
94
+ .digest('hex')
95
+ .slice(0, 24)
96
+ );
97
+ }
98
+
99
+ function errorText(error: unknown) {
100
+ try {
101
+ return error instanceof Error ? error.message : String(error || 'Unknown error');
102
+ } catch {
103
+ return 'Unknown error';
104
+ }
105
+ }
106
+
107
+ function rowAsObject(value: unknown) {
108
+ const record = value as { toJSON?: () => unknown };
109
+ const resolved = typeof record?.toJSON === 'function' ? record.toJSON() : value;
110
+ return objectValue(resolved);
111
+ }
112
+
113
+ export class NativeSubAgentObserver {
114
+ private readonly spanService: ExecutionSpanService;
115
+ private readonly policyService: AgentMemoryContextService;
116
+
117
+ constructor(private readonly plugin: ObserverPlugin) {
118
+ this.spanService = new ExecutionSpanService(plugin);
119
+ this.policyService = new AgentMemoryContextService(plugin);
120
+ }
121
+
122
+ install() {
123
+ const aiPlugin = this.plugin.app.pm?.get?.('ai');
124
+ const dispatcher = objectValue(aiPlugin).subAgentsDispatcher as DispatcherWithRun | undefined;
125
+ if (!dispatcher?.run) {
126
+ this.warn('[AgentOrchestrator] plugin-ai subAgentsDispatcher not available; observer skipped.');
127
+ return false;
128
+ }
129
+
130
+ const existing = dispatcher[WRAP_STATE_KEY];
131
+ if (existing?.wrappedRun === dispatcher.run) return false;
132
+
133
+ const originalRun = existing?.originalRun || dispatcher.run.bind(dispatcher);
134
+ const observer = this;
135
+ const wrappedRun = async function wrappedNativeSubAgentRun(task: NativeSubAgentTask) {
136
+ return observer.runObserved(originalRun, task);
137
+ };
138
+
139
+ dispatcher.run = wrappedRun;
140
+ dispatcher[WRAP_STATE_KEY] = { originalRun, wrappedRun };
141
+ this.info('[AgentOrchestrator] Native plugin-ai sub-agent observer installed.');
142
+ return true;
143
+ }
144
+
145
+ uninstall() {
146
+ const aiPlugin = this.plugin.app.pm?.get?.('ai');
147
+ const dispatcher = objectValue(aiPlugin).subAgentsDispatcher as DispatcherWithRun | undefined;
148
+ const existing = dispatcher?.[WRAP_STATE_KEY];
149
+ if (!dispatcher?.run || !existing || existing.wrappedRun !== dispatcher.run) return false;
150
+
151
+ dispatcher.run = existing.originalRun;
152
+ delete dispatcher[WRAP_STATE_KEY];
153
+ this.info('[AgentOrchestrator] Native plugin-ai sub-agent observer uninstalled.');
154
+ return true;
155
+ }
156
+
157
+ private async runObserved(originalRun: (task: NativeSubAgentTask) => Promise<string>, task: NativeSubAgentTask) {
158
+ const startedAt = Date.now();
159
+ try {
160
+ // Preserve the native task object, writer, prompt, skill settings, and result exactly.
161
+ const result = await originalRun(task);
162
+ this.observeDispatch(task, 'success', startedAt).catch((error) => {
163
+ this.warn('[AgentOrchestrator] Native dispatch telemetry failed; continuing native execution.', error);
164
+ });
165
+ return result;
166
+ } catch (error) {
167
+ this.observeDispatch(task, 'error', startedAt).catch((telemetryError) => {
168
+ this.warn('[AgentOrchestrator] Native dispatch telemetry failed; continuing native execution.', telemetryError);
169
+ });
170
+ throw error;
171
+ }
172
+ }
173
+
174
+ private async observeDispatch(task: NativeSubAgentTask, status: 'success' | 'error', startedAt: number) {
175
+ try {
176
+ const settings = (await this.policyService.resolvePolicySettings(task)) as ObserverSettings;
177
+ if (settings.nativeObserverEnabled === false || settings.observability?.enabled === false) return;
178
+ if (settings.observability?.sharing === 'disabled') return;
179
+
180
+ const parentSessionId = stringValue(task.ctx?.action?.params?.values?.sessionId);
181
+ const subSessionId = stringValue(task.sessionId);
182
+ const employeeUsername =
183
+ stringValue(readValue(task.employee, 'username')) ||
184
+ stringValue(readValue(task.employee, 'aiEmployeeUsername')) ||
185
+ stringValue(readValue(task.employee, 'name')) ||
186
+ undefined;
187
+ const dispatch = await this.resolveDispatch(parentSessionId, subSessionId, task.ctx.db);
188
+ const toolCallId = dispatch?.toolCallId;
189
+ if (!parentSessionId || !subSessionId || !toolCallId) return;
190
+
191
+ const parentConversation = await this.findOne(task.ctx.db, 'aiConversations', {
192
+ filter: { sessionId: parentSessionId },
193
+ });
194
+ const parentSpan = await this.findParentSpan(parentConversation, parentSessionId);
195
+ // If the main projection is not yet available, let reconciliation link this call later;
196
+ // inventing a root here can race a valid legacy control-plane association.
197
+ if (!parentSpan) return;
198
+ const rootRunId = stringValue(parentSpan.rootRunId);
199
+ if (!rootRunId) return;
200
+ const parentSpanId = parentSpan?.id === undefined ? undefined : String(parentSpan.id);
201
+ const endedAt = new Date();
202
+ const nativeIdentity = 'native:tool-call:' + toolCallId;
203
+ const span = await this.spanService.upsertNative(nativeIdentity, {
204
+ nativeIdentity,
205
+ rootRunId,
206
+ parentSpanId,
207
+ depth: Number(parentSpan?.depth) + 1 || 1,
208
+ source: NATIVE_SOURCE,
209
+ parentSessionId,
210
+ subSessionId,
211
+ toolCallId,
212
+ type: 'sub_agent',
213
+ status: status === 'error' ? 'error' : 'unknown',
214
+ leaderUsername: stringValue(readValue(parentConversation, 'aiEmployeeUsername')) || undefined,
215
+ employeeUsername,
216
+ toolName: 'dispatch-sub-agent-task',
217
+ title: 'Native sub-agent dispatch',
218
+ startedAt: new Date(startedAt),
219
+ endedAt,
220
+ nativeActivityAt: endedAt,
221
+ durationMs: Math.max(0, endedAt.getTime() - startedAt),
222
+ metadata: {
223
+ source: NATIVE_SOURCE,
224
+ nativeCoverage: { source: 'dispatcher-return', realtime: false },
225
+ capturePolicy: {
226
+ source: 'native-persistence-no-invocation-snapshot',
227
+ sharing: 'disabled',
228
+ captureInputs: false,
229
+ captureOutputs: false,
230
+ redactSecrets: true,
231
+ },
232
+ dispatchToolMessageId: dispatch.id,
233
+ dispatchMessageId: dispatch.messageId,
234
+ harnessTag: settings.harnessTag || 'default',
235
+ outcome: status,
236
+ },
237
+ userId: task.ctx.auth?.user?.id,
238
+ });
239
+ if (!span) this.warn('[AgentOrchestrator] Native dispatch telemetry was not persisted.');
240
+ } catch (error) {
241
+ this.warn('[AgentOrchestrator] Native dispatch telemetry failed; continuing native execution.', error);
242
+ }
243
+ }
244
+
245
+ private async resolveDispatch(parentSessionId: string, subSessionId: string, db?: NativeContext['db']) {
246
+ if (!parentSessionId || !subSessionId) return null;
247
+ const messages = await this.findMany(db, 'aiMessages', {
248
+ filter: { sessionId: parentSessionId },
249
+ sort: ['-messageId'],
250
+ limit: 100,
251
+ });
252
+ for (const message of messages) {
253
+ const relations = asObject(readValue(message, 'metadata')).subAgentConversations;
254
+ if (!Array.isArray(relations)) continue;
255
+ const relation = relations.find((value) => stringValue(asObject(value).sessionId) === subSessionId);
256
+ const toolCallId = stringValue(asObject(relation).toolCallId);
257
+ if (toolCallId) {
258
+ return {
259
+ id: undefined,
260
+ messageId: stringValue(readValue(message, 'messageId')),
261
+ toolCallId,
262
+ };
263
+ }
264
+ }
265
+
266
+ const toolMessage = await this.findOne(db, 'aiToolMessages', {
267
+ filter: { sessionId: parentSessionId, toolName: 'dispatch-sub-agent-task' },
268
+ sort: ['-id'],
269
+ });
270
+ const contentSessionId = stringValue(asObject(readValue(toolMessage, 'content')).sessionId);
271
+ return contentSessionId === subSessionId
272
+ ? {
273
+ id: readValue(toolMessage, 'id'),
274
+ messageId: stringValue(readValue(toolMessage, 'messageId')),
275
+ toolCallId: stringValue(readValue(toolMessage, 'toolCallId')),
276
+ }
277
+ : null;
278
+ }
279
+
280
+ private async findParentSpan(parentConversation: Record<string, unknown> | null, parentSessionId: string) {
281
+ const from = stringValue(readValue(parentConversation, 'from'));
282
+ if (from === 'sub-agent') {
283
+ return this.findOne(this.plugin.db, 'agentExecutionSpans', {
284
+ filter: { source: NATIVE_SOURCE, type: 'sub_agent', subSessionId: parentSessionId },
285
+ });
286
+ }
287
+ return this.findOne(this.plugin.db, 'agentExecutionSpans', {
288
+ filter: { source: NATIVE_SOURCE, type: 'main_agent', parentSessionId },
289
+ });
290
+ }
291
+
292
+ private async findOne(
293
+ database: NativeContext['db'] | ObserverPlugin['db'],
294
+ name: string,
295
+ options: Record<string, unknown>,
296
+ ): Promise<Record<string, unknown> | null> {
297
+ try {
298
+ const row = await database?.getRepository?.(name)?.findOne?.(options);
299
+ return row ? rowAsObject(row) : null;
300
+ } catch {
301
+ return null;
302
+ }
303
+ }
304
+
305
+ private async findMany(database: NativeContext['db'] | undefined, name: string, options: Record<string, unknown>) {
306
+ try {
307
+ const rows = await database?.getRepository?.(name)?.find?.(options);
308
+ return Array.isArray(rows) ? rows.map(rowAsObject) : [];
309
+ } catch {
310
+ return [];
311
+ }
312
+ }
313
+
314
+ private info(message: string) {
315
+ try {
316
+ this.plugin.app.logger?.info?.(message);
317
+ } catch {
318
+ // Telemetry logging is best effort.
319
+ }
320
+ }
321
+
322
+ private warn(message: string, error?: unknown) {
323
+ try {
324
+ this.plugin.app.logger?.warn?.(message, { error });
325
+ } catch {
326
+ // Telemetry logging must not affect native execution.
327
+ }
328
+ }
329
+ }
330
+
331
+ export { makeNativeRunId };