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.
Files changed (495) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +207 -204
  3. package/client-v2.d.ts +2 -2
  4. package/client-v2.js +1 -1
  5. package/client.d.ts +2 -2
  6. package/client.js +1 -1
  7. package/dist/client/117.6c69b6a87751dd18.js +10 -0
  8. package/dist/client/253.52f62e1bc0e9520a.js +10 -0
  9. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  10. package/dist/client/404.86593f98c9768ed5.js +10 -0
  11. package/dist/client/453.fa2d169576262213.js +10 -0
  12. package/dist/client/53.567db3ae078650c6.js +10 -0
  13. package/dist/client/619.01713281e5e951d3.js +10 -0
  14. package/dist/client/652.69da1598312b3a3f.js +10 -0
  15. package/dist/client/773.648965568ff476f9.js +10 -0
  16. package/dist/client/981.37e7aeecdb1ef6fa.js +10 -0
  17. package/dist/client/993.ac89f3852990918d.js +10 -0
  18. package/dist/client/index.js +1 -1
  19. package/dist/client-v2/117.c982d79ff68738f5.js +10 -0
  20. package/dist/client-v2/214.94c4257bf2838577.js +10 -0
  21. package/dist/client-v2/253.8e19956d2a44dfb8.js +10 -0
  22. package/dist/client-v2/264.80e8e358c8c6c2e5.js +10 -0
  23. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  24. package/dist/client-v2/404.ab032b79c95dab6f.js +10 -0
  25. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.cd5610fcf7446127.js} +1 -1
  26. package/dist/client-v2/453.42c6d70628d56cc2.js +10 -0
  27. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.37c08089a648f89a.js} +1 -1
  28. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.6e9618550101e819.js} +1 -1
  29. package/dist/client-v2/652.eeba4e0c38367321.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.332698e53eb59677.js} +1 -1
  31. package/dist/client-v2/773.4de2ba5acb07318c.js +10 -0
  32. package/dist/client-v2/981.76060f466e6f7c11.js +10 -0
  33. package/dist/client-v2/993.f8cdb5172566ce75.js +10 -0
  34. package/dist/client-v2/index.js +1 -1
  35. package/dist/externalVersion.js +13 -7
  36. package/dist/locale/en-US.json +308 -1
  37. package/dist/locale/vi-VN.json +5 -1
  38. package/dist/locale/zh-CN.json +308 -1
  39. package/dist/node_modules/acorn/LICENSE +21 -0
  40. package/dist/node_modules/acorn/bin/acorn +4 -0
  41. package/dist/node_modules/acorn/dist/acorn.d.mts +857 -0
  42. package/dist/node_modules/acorn/dist/acorn.d.ts +857 -0
  43. package/dist/node_modules/acorn/dist/acorn.js +1 -0
  44. package/dist/node_modules/acorn/dist/bin.js +90 -0
  45. package/dist/node_modules/acorn/package.json +1 -0
  46. package/dist/node_modules/acorn-walk/LICENSE +21 -0
  47. package/dist/node_modules/acorn-walk/dist/walk.d.mts +177 -0
  48. package/dist/node_modules/acorn-walk/dist/walk.d.ts +177 -0
  49. package/dist/node_modules/acorn-walk/dist/walk.js +1 -0
  50. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn +15 -0
  51. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn.cmd +7 -0
  52. package/dist/node_modules/acorn-walk/node_modules/acorn/bin/acorn +4 -0
  53. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.mts +866 -0
  54. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.ts +866 -0
  55. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.js +6174 -0
  56. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/bin.js +90 -0
  57. package/dist/node_modules/acorn-walk/node_modules/acorn/package.json +50 -0
  58. package/dist/node_modules/acorn-walk/package.json +1 -0
  59. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  60. package/dist/node_modules/adm-zip/package.json +1 -1
  61. package/dist/node_modules/ajv/package.json +1 -1
  62. package/dist/node_modules/zod/index.cjs +1 -1
  63. package/dist/node_modules/zod/package.json +1 -1
  64. package/dist/server/collections/agent-auto-approval-checkpoints.js +47 -0
  65. package/dist/server/collections/agent-execution-spans.js +148 -9
  66. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  67. package/dist/server/collections/agent-governance-policies.js +47 -0
  68. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  69. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  70. package/dist/server/collections/agent-hierarchy-invocations.js +59 -0
  71. package/dist/server/collections/agent-loop-runs.js +23 -5
  72. package/dist/server/collections/agent-routing-graph-locks.js +40 -0
  73. package/dist/server/collections/agent-session-auto-approvals.js +45 -0
  74. package/dist/server/collections/orchestrator-config.js +17 -0
  75. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  76. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  77. package/dist/server/migrations/20261119000000-widen-native-employee-identifiers.js +59 -0
  78. package/dist/server/plugin.js +169 -33
  79. package/dist/server/resources/agent-auto-approval.js +80 -0
  80. package/dist/server/resources/agent-governance.js +192 -0
  81. package/dist/server/resources/agent-harness-profile.js +11 -3
  82. package/dist/server/resources/agent-monitor.js +109 -339
  83. package/dist/server/resources/agent-usage.js +423 -0
  84. package/dist/server/resources/hierarchical-routing.js +60 -0
  85. package/dist/server/resources/native-monitor-format.js +179 -0
  86. package/dist/server/resources/tracing.js +35 -12
  87. package/dist/server/services/AgentGovernanceService.js +500 -0
  88. package/dist/server/services/AutoApprovalCheckpoint.js +133 -0
  89. package/dist/server/services/CodeValidator.js +8 -4
  90. package/dist/server/services/DepartmentAttribution.js +65 -0
  91. package/dist/server/services/ExecutionSpanService.js +96 -3
  92. package/dist/server/services/GovernanceAdmission.js +271 -0
  93. package/dist/server/services/HarnessCapabilities.js +118 -0
  94. package/dist/server/services/HarnessCompiler.js +3 -0
  95. package/dist/server/services/HarnessSchema.js +13 -1
  96. package/dist/server/services/HierarchicalAgentRuntime.js +925 -0
  97. package/dist/server/services/HierarchyEnrollmentGuard.js +216 -0
  98. package/dist/server/services/HierarchyInvocationJournal.js +157 -0
  99. package/dist/server/services/HierarchyRequestCancellation.js +150 -0
  100. package/dist/server/services/LoopBudgetService.js +29 -11
  101. package/dist/server/services/LoopRunRepository.js +16 -7
  102. package/dist/server/services/LoopRunStateMachine.js +20 -9
  103. package/dist/server/services/LoopTriggerService.js +1 -1
  104. package/dist/server/services/LoopWorkerService.js +71 -37
  105. package/dist/server/services/ManagedPromptProtection.js +99 -0
  106. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  107. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  108. package/dist/server/services/NativeUsageAttribution.js +97 -0
  109. package/dist/server/services/PluginAiRuntimeAdapter.js +107 -9
  110. package/dist/server/services/RoutingBindingRepository.js +156 -0
  111. package/dist/server/services/RoutingBindingValidation.js +161 -0
  112. package/dist/server/services/SandboxRunner.js +19 -0
  113. package/dist/server/services/SessionAutoApproval.js +173 -0
  114. package/dist/server/services/TokenTracker.js +787 -104
  115. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  116. package/dist/server/services/VerificationService.js +20 -10
  117. package/dist/server/skill-hub/plugin.js +17 -0
  118. package/dist/server/skill-hub/sandbox-config.json +6 -6
  119. package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
  120. package/dist/server/skill-hub/services/registry-node-package.js +191 -0
  121. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
  122. package/dist/server/tools/skill-execute.js +1 -0
  123. package/dist/server/utils/ensure-indexes.js +15 -5
  124. package/package.json +66 -53
  125. package/server.d.ts +2 -2
  126. package/server.js +1 -1
  127. package/src/client/AgentRunsTab.tsx +2 -2
  128. package/src/client/ApprovalsTab.tsx +2 -2
  129. package/src/client/HarnessProfilesTab.tsx +2 -2
  130. package/src/client/OrchestratorSettings.tsx +152 -152
  131. package/src/client/SkillPages.tsx +34 -0
  132. package/src/client/__tests__/embedded-settings.test.tsx +225 -0
  133. package/src/client/hooks/useRunEventStream.ts +76 -76
  134. package/src/client/index.tsx +2 -2
  135. package/src/client/plugin.tsx +71 -33
  136. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  137. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  138. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  139. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  140. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  141. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  142. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  143. package/src/client/skill-hub/index.tsx +6 -6
  144. package/src/client/skill-hub/locale.ts +16 -16
  145. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +147 -132
  146. package/src/client/skill-hub/tools/SkillHubCard.tsx +110 -104
  147. package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
  148. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  149. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +80 -71
  150. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  151. package/src/client-v2/__tests__/embedded-settings.test.tsx +202 -0
  152. package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
  153. package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
  154. package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
  155. package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -0
  156. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  157. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  158. package/src/client-v2/components/AgentBindingsTab.tsx +541 -269
  159. package/src/client-v2/components/AgentRunsTab.tsx +85 -83
  160. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  161. package/src/client-v2/components/EmployeeGovernanceTab.tsx +695 -0
  162. package/src/client-v2/components/HarnessProfilesTab.tsx +700 -541
  163. package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
  164. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  165. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  166. package/src/client-v2/components/UsageGovernanceTab.tsx +379 -0
  167. package/src/client-v2/index.tsx +1 -1
  168. package/src/client-v2/pages/AgentBindingsPage.tsx +15 -13
  169. package/src/client-v2/pages/ApprovalsPage.tsx +12 -10
  170. package/src/client-v2/pages/EmployeeGovernancePage.tsx +15 -0
  171. package/src/client-v2/pages/ExecutionHistoryPage.tsx +12 -10
  172. package/src/client-v2/pages/HarnessProfilesPage.tsx +12 -10
  173. package/src/client-v2/pages/KnowledgeAccessPage.tsx +12 -10
  174. package/src/client-v2/pages/LoopSettingsPage.tsx +12 -10
  175. package/src/client-v2/pages/MemoryInspectorPage.tsx +15 -13
  176. package/src/client-v2/pages/RetrievalTracePage.tsx +12 -10
  177. package/src/client-v2/pages/RulesPage.tsx +15 -13
  178. package/src/client-v2/pages/SkillDefinitionsPage.tsx +12 -10
  179. package/src/client-v2/pages/SkillMetricsPage.tsx +12 -10
  180. package/src/client-v2/pages/TracingPage.tsx +15 -13
  181. package/src/client-v2/pages/UsageGovernancePage.tsx +15 -0
  182. package/src/client-v2/plugin.tsx +134 -111
  183. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  184. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  185. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  186. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  187. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  188. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  189. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  190. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  191. package/src/client-v2/skill-hub/locale.ts +13 -13
  192. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  193. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  194. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +126 -0
  195. package/src/client-v2/skill-hub/tools/interactions.ts +137 -0
  196. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  197. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  198. package/src/client-v2/utils/jsonFields.ts +41 -41
  199. package/src/index.ts +2 -2
  200. package/src/locale/en-US.json +308 -1
  201. package/src/locale/vi-VN.json +5 -1
  202. package/src/locale/zh-CN.json +308 -1
  203. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  204. package/src/server/__tests__/agent-governance.integration.test.ts +385 -0
  205. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  206. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +267 -0
  207. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  208. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  209. package/src/server/__tests__/agent-usage-report.integration.test.ts +335 -0
  210. package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -0
  211. package/src/server/__tests__/code-validator.test.ts +63 -63
  212. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  213. package/src/server/__tests__/harness-capabilities.test.ts +88 -0
  214. package/src/server/__tests__/harness-compiler.test.ts +278 -214
  215. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  216. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  217. package/src/server/__tests__/harness-tool-plan.test.ts +175 -172
  218. package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
  219. package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
  220. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  221. package/src/server/__tests__/loop-approval-decision.test.ts +624 -512
  222. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  223. package/src/server/__tests__/loop-budget-service.test.ts +29 -0
  224. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  225. package/src/server/__tests__/loop-run-repository.test.ts +25 -0
  226. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  227. package/src/server/__tests__/loop-trigger-service.test.ts +185 -148
  228. package/src/server/__tests__/loop-worker-claim.test.ts +110 -10
  229. package/src/server/__tests__/loop-worker-execution.test.ts +375 -317
  230. package/src/server/__tests__/native-agent-monitor-sync.test.ts +343 -0
  231. package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
  232. package/src/server/__tests__/native-sub-agent-observer.test.ts +463 -662
  233. package/src/server/__tests__/native-usage-attribution.integration.test.ts +168 -0
  234. package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
  235. package/src/server/__tests__/registry-node-package.test.ts +299 -0
  236. package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
  237. package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
  238. package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
  239. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  240. package/src/server/__tests__/skill-execute.test.ts +81 -70
  241. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  242. package/src/server/__tests__/skill-review-guard.test.ts +171 -0
  243. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  244. package/src/server/__tests__/skill-settings.test.ts +63 -63
  245. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  246. package/src/server/__tests__/token-tracker.test.ts +632 -0
  247. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  248. package/src/server/__tests__/tracing-retention-policy.test.ts +30 -0
  249. package/src/server/__tests__/usage-ledger.integration.test.ts +187 -0
  250. package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
  251. package/src/server/collections/agent-execution-spans.ts +386 -245
  252. package/src/server/collections/agent-governance-audit-events.ts +19 -0
  253. package/src/server/collections/agent-governance-policies.ts +19 -0
  254. package/src/server/collections/agent-governance-policy-versions.ts +20 -0
  255. package/src/server/collections/agent-governance-prompt-bindings.ts +22 -0
  256. package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
  257. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  258. package/src/server/collections/agent-loop-runs.ts +389 -369
  259. package/src/server/collections/agent-loop-steps.ts +220 -220
  260. package/src/server/collections/agent-memory-contexts.ts +95 -95
  261. package/src/server/collections/agent-routing-graph-locks.ts +11 -0
  262. package/src/server/collections/agent-session-auto-approvals.ts +16 -0
  263. package/src/server/collections/orchestrator-config.ts +113 -87
  264. package/src/server/collections/orchestrator-logs.ts +116 -116
  265. package/src/server/collections/skill-definitions.ts +159 -159
  266. package/src/server/collections/skill-executions.ts +154 -154
  267. package/src/server/collections/skill-loop-configs.ts +65 -65
  268. package/src/server/collections/skill-metrics.ts +36 -36
  269. package/src/server/collections/skill-registry-installations.ts +41 -41
  270. package/src/server/collections/skill-worker-configs.ts +86 -86
  271. package/src/server/index.ts +1 -1
  272. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  273. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  274. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  275. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  276. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  277. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  278. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  279. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  280. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  281. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  282. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +110 -0
  283. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +28 -0
  284. package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
  285. package/src/server/plugin.ts +724 -573
  286. package/src/server/resources/agent-auto-approval.ts +51 -0
  287. package/src/server/resources/agent-governance.ts +161 -0
  288. package/src/server/resources/agent-harness-profile.ts +103 -94
  289. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  290. package/src/server/resources/agent-loop-approval.ts +84 -84
  291. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  292. package/src/server/resources/agent-loop.ts +252 -252
  293. package/src/server/resources/agent-monitor.ts +208 -482
  294. package/src/server/resources/agent-usage.ts +413 -0
  295. package/src/server/resources/hierarchical-routing.ts +39 -0
  296. package/src/server/resources/native-monitor-format.ts +150 -0
  297. package/src/server/resources/tracing.ts +296 -267
  298. package/src/server/services/AgentExecutionContext.ts +23 -23
  299. package/src/server/services/AgentGovernanceService.ts +541 -0
  300. package/src/server/services/AgentMemoryContextService.ts +344 -344
  301. package/src/server/services/AgentRegistryService.ts +220 -220
  302. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  303. package/src/server/services/AutoApprovalCheckpoint.ts +140 -0
  304. package/src/server/services/CodeValidator.ts +257 -238
  305. package/src/server/services/DepartmentAttribution.ts +47 -0
  306. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  307. package/src/server/services/ExecutionSpanService.ts +271 -146
  308. package/src/server/services/FileManager.ts +159 -159
  309. package/src/server/services/GovernanceAdmission.ts +314 -0
  310. package/src/server/services/HarnessCapabilities.ts +112 -0
  311. package/src/server/services/HarnessCompiler.ts +182 -170
  312. package/src/server/services/HarnessProfileService.ts +235 -235
  313. package/src/server/services/HarnessSchema.ts +224 -194
  314. package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
  315. package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
  316. package/src/server/services/HierarchyInvocationJournal.ts +172 -0
  317. package/src/server/services/HierarchyRequestCancellation.ts +132 -0
  318. package/src/server/services/InputSchemaValidator.ts +44 -44
  319. package/src/server/services/LoopBudgetService.ts +325 -271
  320. package/src/server/services/LoopControlService.ts +120 -120
  321. package/src/server/services/LoopPatternSchema.ts +231 -231
  322. package/src/server/services/LoopPatternService.ts +171 -171
  323. package/src/server/services/LoopRunRepository.ts +343 -332
  324. package/src/server/services/LoopRunStateMachine.ts +538 -525
  325. package/src/server/services/LoopSchedulerService.ts +195 -195
  326. package/src/server/services/LoopTriggerService.ts +162 -159
  327. package/src/server/services/LoopWorkerService.ts +975 -912
  328. package/src/server/services/ManagedPromptProtection.ts +81 -0
  329. package/src/server/services/NativeAgentMonitorSyncService.ts +684 -0
  330. package/src/server/services/NativeSubAgentObserver.ts +324 -757
  331. package/src/server/services/NativeUsageAttribution.ts +91 -0
  332. package/src/server/services/PathLockService.ts +317 -317
  333. package/src/server/services/PluginAiRuntimeAdapter.ts +518 -387
  334. package/src/server/services/RoutingBindingRepository.ts +146 -0
  335. package/src/server/services/RoutingBindingValidation.ts +161 -0
  336. package/src/server/services/RunEventBus.ts +58 -58
  337. package/src/server/services/SandboxRunner.ts +526 -492
  338. package/src/server/services/SessionAutoApproval.ts +167 -0
  339. package/src/server/services/SkillAccessService.ts +175 -175
  340. package/src/server/services/SkillManager.ts +585 -585
  341. package/src/server/services/SkillRepositoryService.ts +236 -236
  342. package/src/server/services/TokenTracker.ts +1151 -287
  343. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  344. package/src/server/services/TracingRetentionPolicy.ts +49 -0
  345. package/src/server/services/VerificationSchema.ts +31 -31
  346. package/src/server/services/VerificationService.ts +325 -313
  347. package/src/server/services/WorkerEnvManager.ts +198 -198
  348. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  349. package/src/server/services/harness-runtime-policy.ts +134 -134
  350. package/src/server/services/pythonGuardTemplate.ts +87 -87
  351. package/src/server/services/sandboxCapabilities.ts +348 -348
  352. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  353. package/src/server/skill-hub/actions/git-import.ts +936 -936
  354. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  355. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  356. package/src/server/skill-hub/plugin.ts +1272 -1232
  357. package/src/server/skill-hub/sandbox-config.json +6 -6
  358. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +291 -281
  359. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  360. package/src/server/skill-hub/services/registry-node-package.ts +191 -0
  361. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +597 -568
  362. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  363. package/src/server/tools/delegate-task.ts +30 -30
  364. package/src/server/tools/external-rag-search.ts +329 -329
  365. package/src/server/tools/skill-execute.ts +226 -216
  366. package/src/server/types.ts +21 -21
  367. package/src/server/utils/ai-manager.ts +24 -24
  368. package/src/server/utils/ctx-utils.ts +132 -132
  369. package/src/server/utils/ensure-indexes.ts +113 -96
  370. package/src/server/utils/ha-lock.ts +80 -80
  371. package/src/server/utils/loop-pattern-context.ts +84 -84
  372. package/src/server/utils/record-utils.ts +19 -19
  373. package/src/server/utils/skill-settings.ts +135 -135
  374. package/src/server/utils/skill-tool-name.ts +58 -58
  375. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  376. package/dist/client-v2/214.106635011859dede.js +0 -10
  377. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  378. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  379. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  380. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  381. package/dist/client-v2/981.e4a1f41cfc94a856.js +0 -10
  382. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  383. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  384. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  385. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  387. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  388. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  389. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  390. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  391. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  392. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  393. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  394. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  395. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  396. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  397. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  398. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  399. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  400. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  401. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  402. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  403. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  404. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  405. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  406. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  407. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  408. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  409. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  410. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  411. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  412. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  413. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  414. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  415. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  416. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  417. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  418. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  419. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  420. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  421. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  422. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  423. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  424. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  425. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  426. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  427. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  428. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  429. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  430. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  431. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  432. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  433. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  434. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  435. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  436. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  437. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  438. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  439. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  440. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  441. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  442. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  443. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  444. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  445. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  446. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  447. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  448. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  449. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  450. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  451. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  452. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  453. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  454. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  455. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  456. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  457. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  458. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  459. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  460. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  461. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  462. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  463. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  464. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  465. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  466. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  467. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  468. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  469. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  470. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  471. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  472. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  473. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  474. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  475. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  476. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  477. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  478. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  479. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  480. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  481. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  482. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  483. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  484. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  485. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  486. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  487. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  488. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  489. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  490. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  491. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  492. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  493. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  494. package/dist/node_modules/simple-git/package.json +0 -1
  495. package/dist/node_modules/simple-git/promise.js +0 -17
@@ -28,35 +28,252 @@ var TokenTracker_exports = {};
28
28
  __export(TokenTracker_exports, {
29
29
  TokenTracker: () => TokenTracker,
30
30
  estimateCost: () => estimateCost,
31
- extractTokenUsage: () => extractTokenUsage
31
+ usageEventIdentity: () => usageEventIdentity,
32
+ usageFromAIUsageEvent: () => usageFromAIUsageEvent
32
33
  });
33
34
  module.exports = __toCommonJS(TokenTracker_exports);
34
- const PRICE_PER_1K_INPUT = Number(process.env.ORCHESTRATOR_PRICE_PER_1K_INPUT || 3e-3);
35
- const PRICE_PER_1K_OUTPUT = Number(process.env.ORCHESTRATOR_PRICE_PER_1K_OUTPUT || 0.015);
35
+ var import_record_utils = require("../utils/record-utils");
36
+ const USAGE_EVENT_TYPE = "llm_message";
37
+ const USAGE_PAGE_SIZE = 1e3;
38
+ function asRecord(value) {
39
+ return value && typeof value === "object" && !Array.isArray(value) ? value : {};
40
+ }
41
+ function readNumber(value) {
42
+ if (typeof value === "string" && !value.trim()) return void 0;
43
+ const number = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
44
+ return Number.isFinite(number) && number >= 0 ? number : void 0;
45
+ }
46
+ function readOptionalNumber(record, key) {
47
+ const raw = (0, import_record_utils.read)(record, key);
48
+ return readNumber(raw);
49
+ }
50
+ function identityPart(value) {
51
+ return String(value ?? "").trim();
52
+ }
53
+ function normalizedCurrency(value) {
54
+ const currency = identityPart(value).toUpperCase();
55
+ return /^[A-Z]{3}$/.test(currency) ? currency : "";
56
+ }
57
+ function usageEventIdentity(sessionId, messageId) {
58
+ return `ai-usage-event:${sessionId}:${messageId}`;
59
+ }
60
+ function usageFromAIUsageEvent(event) {
61
+ const raw = asRecord((0, import_record_utils.read)(event, "rawUsageMetadata"));
62
+ const hasRawInput = ["input_tokens", "prompt_tokens", "inputTokens", "promptTokens"].some(
63
+ (key) => Object.prototype.hasOwnProperty.call(raw, key) && readNumber(raw[key]) !== void 0
64
+ );
65
+ const hasRawOutput = ["output_tokens", "completion_tokens", "outputTokens", "completionTokens"].some(
66
+ (key) => Object.prototype.hasOwnProperty.call(raw, key) && readNumber(raw[key]) !== void 0
67
+ );
68
+ const hasRawTotal = ["total_tokens", "totalTokens"].some(
69
+ (key) => Object.prototype.hasOwnProperty.call(raw, key) && readNumber(raw[key]) !== void 0
70
+ );
71
+ const inputTokens = readOptionalNumber(event, "inputTokens");
72
+ const outputTokens = readOptionalNumber(event, "outputTokens");
73
+ const totalTokens = readOptionalNumber(event, "totalTokens");
74
+ if (!hasRawInput && !hasRawOutput && !hasRawTotal && inputTokens === 0 && outputTokens === 0 && totalTokens === 0) {
75
+ return null;
76
+ }
77
+ if (inputTokens === void 0 || outputTokens === void 0) return null;
78
+ if (!hasRawInput && inputTokens === 0 || !hasRawOutput && outputTokens === 0) return null;
79
+ const cachedTokens = readOptionalNumber(event, "cachedTokens");
80
+ const reasoningTokens = readOptionalNumber(event, "reasoningTokens");
81
+ return {
82
+ inputTokens,
83
+ outputTokens,
84
+ totalTokens: totalTokens ?? inputTokens + outputTokens,
85
+ ...cachedTokens === void 0 ? {} : { cachedTokens },
86
+ ...reasoningTokens === void 0 ? {} : { reasoningTokens }
87
+ };
88
+ }
89
+ function usageIsValid(usage) {
90
+ return Boolean(
91
+ usage && readNumber(usage.inputTokens) !== void 0 && readNumber(usage.outputTokens) !== void 0 && readNumber(usage.totalTokens) !== void 0
92
+ );
93
+ }
94
+ function normalizedModelKey(provider, model, llmService) {
95
+ const modelName = identityPart(model).toLowerCase();
96
+ if (!modelName) return "";
97
+ const providerName = identityPart(provider).toLowerCase() || identityPart(llmService).toLowerCase();
98
+ return providerName ? `${providerName}/${modelName}` : modelName;
99
+ }
100
+ function configuredRate(provider, model, llmService) {
101
+ const json = process.env.ORCHESTRATOR_MODEL_PRICING_JSON;
102
+ if (!json) return null;
103
+ let entries;
104
+ try {
105
+ entries = asRecord(JSON.parse(json));
106
+ } catch {
107
+ return null;
108
+ }
109
+ const normalizedEntries = /* @__PURE__ */ new Map();
110
+ for (const [key, value] of Object.entries(entries)) {
111
+ normalizedEntries.set(key.trim().toLowerCase(), asRecord(value));
112
+ }
113
+ const modelKey = normalizedModelKey(provider, model, llmService);
114
+ const entry = normalizedEntries.get(modelKey) ?? (!provider ? normalizedEntries.get(identityPart(model).toLowerCase()) : void 0);
115
+ if (!entry) return null;
116
+ const inputPer1k = readNumber(entry.inputPer1k);
117
+ const outputPer1k = readNumber(entry.outputPer1k);
118
+ const currency = normalizedCurrency(entry.currency);
119
+ if (inputPer1k === void 0 || outputPer1k === void 0 || !currency) return null;
120
+ const cachedInputPer1k = readNumber(entry.cachedInputPer1k);
121
+ return {
122
+ inputPer1k,
123
+ outputPer1k,
124
+ ...cachedInputPer1k === void 0 ? {} : { cachedInputPer1k },
125
+ currency,
126
+ version: identityPart(entry.version) || identityPart(process.env.ORCHESTRATOR_MODEL_PRICING_VERSION) || "unversioned"
127
+ };
128
+ }
129
+ function legacyGlobalRate() {
130
+ const inputPer1k = readNumber(process.env.ORCHESTRATOR_PRICE_PER_1K_INPUT);
131
+ const outputPer1k = readNumber(process.env.ORCHESTRATOR_PRICE_PER_1K_OUTPUT);
132
+ if (inputPer1k === void 0 || outputPer1k === void 0) return null;
133
+ return {
134
+ inputPer1k,
135
+ outputPer1k,
136
+ currency: "USD",
137
+ version: "legacy-global-env"
138
+ };
139
+ }
140
+ function legacyCostEstimate(inputTokens, outputTokens) {
141
+ const rate = legacyGlobalRate();
142
+ if (!rate) return null;
143
+ return inputTokens / 1e3 * rate.inputPer1k + outputTokens / 1e3 * rate.outputPer1k;
144
+ }
36
145
  function estimateCost(inputTokens, outputTokens) {
37
- return inputTokens / 1e3 * PRICE_PER_1K_INPUT + outputTokens / 1e3 * PRICE_PER_1K_OUTPUT;
38
- }
39
- function extractTokenUsage(finalState) {
40
- if (!(finalState == null ? void 0 : finalState.messages) || !Array.isArray(finalState.messages)) return null;
41
- let totalInput = 0;
42
- let totalOutput = 0;
43
- let totalAll = 0;
44
- for (const msg of finalState.messages) {
45
- if (msg == null ? void 0 : msg.usage_metadata) {
46
- const um = msg.usage_metadata;
47
- totalInput += um.input_tokens || 0;
48
- totalOutput += um.output_tokens || 0;
49
- totalAll += um.total_tokens || 0;
146
+ return legacyCostEstimate(inputTokens, outputTokens) ?? Number.NaN;
147
+ }
148
+ function pricingFor(input) {
149
+ const supplied = input.priceSnapshot ? { ...input.priceSnapshot, currency: normalizedCurrency(input.priceSnapshot.currency) || void 0 } : void 0;
150
+ const nativeCost = readNumber(input.nativeCost) ?? readNumber(supplied == null ? void 0 : supplied.cost);
151
+ if (nativeCost !== void 0) {
152
+ const currency = normalizedCurrency(supplied == null ? void 0 : supplied.currency);
153
+ if (currency !== "USD") {
154
+ const status = currency ? "non_usd" : "unpriced";
155
+ return { cost: null, status, priceSource: (supplied == null ? void 0 : supplied.source) ?? "provider", snapshot: { ...supplied, status } };
50
156
  }
157
+ return {
158
+ cost: nativeCost,
159
+ status: (supplied == null ? void 0 : supplied.status) ?? "native",
160
+ priceSource: (supplied == null ? void 0 : supplied.source) ?? "provider",
161
+ snapshot: supplied ?? { status: "native", source: "provider" }
162
+ };
51
163
  }
52
- if (totalAll === 0) return null;
164
+ const suppliedInputRate = readNumber(supplied == null ? void 0 : supplied.inputPer1k);
165
+ const suppliedOutputRate = readNumber(supplied == null ? void 0 : supplied.outputPer1k);
166
+ const suppliedCachedInputRate = readNumber(supplied == null ? void 0 : supplied.cachedInputPer1k);
167
+ if (supplied && identityPart(supplied.currency).toUpperCase() !== "USD") {
168
+ const status = supplied.currency ? "non_usd" : "unpriced";
169
+ return { cost: null, status, priceSource: supplied.source ?? null, snapshot: { ...supplied, status } };
170
+ }
171
+ if (supplied && usageIsValid(input.usage) && suppliedInputRate !== void 0 && suppliedOutputRate !== void 0) {
172
+ const cachedTokens = Math.min(input.usage.cachedTokens ?? 0, input.usage.inputTokens);
173
+ const regularInput = input.usage.inputTokens - cachedTokens;
174
+ const inputCost = suppliedCachedInputRate === void 0 ? input.usage.inputTokens / 1e3 * suppliedInputRate : regularInput / 1e3 * suppliedInputRate + cachedTokens / 1e3 * suppliedCachedInputRate;
175
+ return {
176
+ cost: inputCost + input.usage.outputTokens / 1e3 * suppliedOutputRate,
177
+ status: supplied.status ?? "native",
178
+ priceSource: supplied.source ?? "provider",
179
+ snapshot: supplied
180
+ };
181
+ }
182
+ const rate = configuredRate(input.provider, input.model, input.llmService);
183
+ if (rate && rate.currency !== "USD") {
184
+ return {
185
+ cost: null,
186
+ status: "non_usd",
187
+ priceSource: "model_pricing_json",
188
+ snapshot: { ...rate, source: "model_pricing_json", status: "non_usd" }
189
+ };
190
+ }
191
+ if (rate && usageIsValid(input.usage)) {
192
+ const cachedTokens = Math.min(input.usage.cachedTokens ?? 0, input.usage.inputTokens);
193
+ const regularInput = input.usage.inputTokens - cachedTokens;
194
+ const inputCost = rate.cachedInputPer1k === void 0 ? input.usage.inputTokens / 1e3 * rate.inputPer1k : regularInput / 1e3 * rate.inputPer1k + cachedTokens / 1e3 * rate.cachedInputPer1k;
195
+ return {
196
+ cost: inputCost + input.usage.outputTokens / 1e3 * rate.outputPer1k,
197
+ status: "configured",
198
+ priceSource: "model_pricing_json",
199
+ snapshot: {
200
+ inputPer1k: rate.inputPer1k,
201
+ outputPer1k: rate.outputPer1k,
202
+ ...rate.cachedInputPer1k === void 0 ? {} : { cachedInputPer1k: rate.cachedInputPer1k },
203
+ currency: rate.currency,
204
+ version: rate.version,
205
+ source: "model_pricing_json",
206
+ status: "configured"
207
+ }
208
+ };
209
+ }
210
+ if (!input.model && !input.provider && !input.llmService && usageIsValid(input.usage)) {
211
+ const legacyRate = legacyGlobalRate();
212
+ const cost = legacyCostEstimate(input.usage.inputTokens, input.usage.outputTokens);
213
+ if (legacyRate && cost !== null) {
214
+ return {
215
+ cost,
216
+ status: "estimated",
217
+ priceSource: "legacy_global_env",
218
+ snapshot: {
219
+ inputPer1k: legacyRate.inputPer1k,
220
+ outputPer1k: legacyRate.outputPer1k,
221
+ currency: legacyRate.currency,
222
+ version: legacyRate.version,
223
+ source: "legacy_global_env",
224
+ status: "estimated"
225
+ }
226
+ };
227
+ }
228
+ }
229
+ return { cost: null, status: "unpriced", priceSource: null, snapshot: { status: "unpriced" } };
230
+ }
231
+ function storedNumber(record, key) {
232
+ const value = (0, import_record_utils.read)(record, key);
233
+ return value === null || value === void 0 || value === "" ? null : readNumber(value) ?? null;
234
+ }
235
+ function sourceDate(value) {
236
+ if (value instanceof Date && Number.isFinite(value.getTime())) return value;
237
+ if (typeof value === "string" || typeof value === "number") {
238
+ const date = new Date(value);
239
+ if (Number.isFinite(date.getTime())) return date;
240
+ }
241
+ return void 0;
242
+ }
243
+ function storedPriceSnapshot(record) {
244
+ const currency = identityPart((0, import_record_utils.read)(record, "priceCurrency"));
245
+ const version = identityPart((0, import_record_utils.read)(record, "priceVersion"));
246
+ const source = identityPart((0, import_record_utils.read)(record, "priceSource"));
247
+ const status = identityPart((0, import_record_utils.read)(record, "pricingStatus"));
53
248
  return {
54
- inputTokens: totalInput,
55
- outputTokens: totalOutput,
56
- totalTokens: totalAll,
57
- cost: estimateCost(totalInput, totalOutput)
249
+ inputPer1k: storedNumber(record, "priceInputPer1k"),
250
+ outputPer1k: storedNumber(record, "priceOutputPer1k"),
251
+ cachedInputPer1k: storedNumber(record, "priceCachedInputPer1k"),
252
+ ...currency ? { currency } : {},
253
+ ...version ? { version } : {},
254
+ ...source ? { source } : {},
255
+ ...status ? { status } : {}
58
256
  };
59
257
  }
258
+ function sameUsage(record, usage) {
259
+ if (!usageIsValid(usage)) return false;
260
+ return storedNumber(record, "inputTokens") === usage.inputTokens && storedNumber(record, "outputTokens") === usage.outputTokens && storedNumber(record, "totalTokens") === usage.totalTokens && storedNumber(record, "cachedTokens") === (usage.cachedTokens ?? null) && storedNumber(record, "reasoningTokens") === (usage.reasoningTokens ?? null);
261
+ }
262
+ function incompleteSessions(record) {
263
+ const value = (0, import_record_utils.read)(record, "usageIncompleteSessions");
264
+ if (Array.isArray(value)) return value.filter((entry) => typeof entry === "string" && !!entry);
265
+ return [];
266
+ }
267
+ function spanIdentity(record) {
268
+ const value = (0, import_record_utils.read)(record, "id");
269
+ return typeof value === "string" || typeof value === "number" ? value : void 0;
270
+ }
271
+ function isModelCall(record) {
272
+ return (0, import_record_utils.read)(record, "type") === "model_call";
273
+ }
274
+ function messageIdFor(event) {
275
+ return identityPart((0, import_record_utils.read)(event, "messageId"));
276
+ }
60
277
  class TokenTracker {
61
278
  constructor(plugin) {
62
279
  this.plugin = plugin;
@@ -67,94 +284,529 @@ class TokenTracker {
67
284
  get app() {
68
285
  return this.plugin.app;
69
286
  }
287
+ warn(message, error) {
288
+ var _a, _b, _c, _d;
289
+ try {
290
+ (_b = (_a = this.app.log) == null ? void 0 : _a.warn) == null ? void 0 : _b.call(_a, message, { error });
291
+ (_d = (_c = this.app.logger) == null ? void 0 : _c.warn) == null ? void 0 : _d.call(_c, message, { error });
292
+ } catch {
293
+ }
294
+ }
295
+ withTransaction(operation) {
296
+ const sequelize = this.db.sequelize;
297
+ return (sequelize == null ? void 0 : sequelize.transaction) ? sequelize.transaction((active) => operation(active)) : operation();
298
+ }
299
+ async markSessionIncomplete(runId, sessionId, incomplete) {
300
+ await this.withTransaction(async (transaction) => {
301
+ var _a;
302
+ const repo = this.db.getRepository("agentLoopRuns");
303
+ if (!(repo == null ? void 0 : repo.findOne) || !repo.update) throw new Error("Run repository is unavailable.");
304
+ const txOptions = transaction ? { transaction, ...((_a = transaction.LOCK) == null ? void 0 : _a.UPDATE) === void 0 ? {} : { lock: transaction.LOCK.UPDATE } } : {};
305
+ const run = await repo.findOne({ filterByTk: runId, ...txOptions });
306
+ if (!run) throw new Error(`Run ${runId} does not exist.`);
307
+ const sessions = new Set(incompleteSessions(run));
308
+ if (incomplete) sessions.add(sessionId);
309
+ else sessions.delete(sessionId);
310
+ const currentUsageStatus = identityPart((0, import_record_utils.read)(run, "usageStatus"));
311
+ await repo.update({
312
+ filterByTk: runId,
313
+ values: {
314
+ usageIncompleteSessions: [...sessions],
315
+ ...incomplete ? {
316
+ usageStatus: currentUsageStatus && currentUsageStatus !== "missing" ? "partial" : "missing",
317
+ pricingStatus: "unpriced",
318
+ totalCost: null
319
+ } : {}
320
+ },
321
+ ...transaction ? { transaction } : {}
322
+ });
323
+ });
324
+ }
70
325
  /**
71
- * Track token usage for a single execution span.
72
- * Updates the span record and accumulates into the parent run.
73
- *
74
- * @param spanId - The agentExecutionSpans.id to update
75
- * @param usage - Parsed token usage from extractTokenUsage()
76
- * @param runId - Optional agentLoopRuns.id to accumulate totals
326
+ * Upserts a single provider model-call usage record by its durable identity. Native usage events
327
+ * use `ai-usage-event:<sessionId>:<messageId>`; retries and resume history therefore reconcile
328
+ * the same row instead of adding its tokens again.
77
329
  */
78
- async trackSpan(spanId, usage, runId) {
79
- var _a, _b;
80
- if (!spanId) return;
81
- try {
330
+ async recordModelCallUsage(input) {
331
+ const usageIdentity = identityPart(input.usageIdentity);
332
+ if (!usageIdentity) return void 0;
333
+ const persist = async (transaction) => {
334
+ var _a;
82
335
  const repo = this.db.getRepository("agentExecutionSpans");
83
- if (!repo) return;
84
- await repo.update({
85
- filterByTk: spanId,
336
+ if (!(repo == null ? void 0 : repo.create) || !repo.update || !repo.findOne) return void 0;
337
+ const txOptions = transaction ? { transaction, ...((_a = transaction.LOCK) == null ? void 0 : _a.UPDATE) === void 0 ? {} : { lock: transaction.LOCK.UPDATE } } : {};
338
+ const existingByIdentity = await repo.findOne({ filter: { usageIdentity }, ...txOptions });
339
+ const existingById = input.spanId !== void 0 ? await repo.findOne({ filterByTk: input.spanId, ...txOptions }) : null;
340
+ const existing = existingByIdentity || (existingById && isModelCall(existingById) ? existingById : null);
341
+ if (existing && !isModelCall(existing)) {
342
+ this.warn("[TokenTracker] Refused to attach model-call usage to a non-model-call span.", usageIdentity);
343
+ return void 0;
344
+ }
345
+ if (existingById && !existingByIdentity && identityPart((0, import_record_utils.read)(existingById, "usageIdentity")) && identityPart((0, import_record_utils.read)(existingById, "usageIdentity")) !== usageIdentity) {
346
+ this.warn("[TokenTracker] Refused to replace a different model-call usage identity.", usageIdentity);
347
+ return void 0;
348
+ }
349
+ const origin = input.source;
350
+ const existingOrigin = identityPart((0, import_record_utils.read)(existing, "usageOrigin"));
351
+ const existingUsageSource = identityPart((0, import_record_utils.read)(existing, "usageSource"));
352
+ const hasIncomingUsage = usageIsValid(input.usage);
353
+ const preserveNativeData = existingOrigin === "ai_usage_event" && (origin === "loop_runtime" || existingUsageSource === "actual" && !hasIncomingUsage);
354
+ const preserveKnownUsage = (existingUsageSource === "actual" || existingUsageSource === "estimated") && !hasIncomingUsage;
355
+ const shouldPreserveUsage = preserveNativeData || preserveKnownUsage;
356
+ const usage = shouldPreserveUsage ? null : input.usage;
357
+ const usageSource = shouldPreserveUsage ? identityPart((0, import_record_utils.read)(existing, "usageSource")) || "missing" : usageIsValid(usage) ? "actual" : "missing";
358
+ const preservePrice = shouldPreserveUsage || existingUsageSource === "actual" && sameUsage(existing, input.usage);
359
+ const historicalSnapshot = storedPriceSnapshot(existing);
360
+ const hasHistoricalRates = historicalSnapshot.inputPer1k != null && historicalSnapshot.outputPer1k != null;
361
+ let resolvedPricing = null;
362
+ if (!preservePrice) {
363
+ if (hasHistoricalRates && (existingUsageSource === "actual" || existingUsageSource === "estimated")) {
364
+ resolvedPricing = pricingFor({ ...input, nativeCost: void 0, priceSnapshot: historicalSnapshot });
365
+ } else if (existingUsageSource === "actual") {
366
+ const status = historicalSnapshot.status === "non_usd" ? "non_usd" : "unpriced";
367
+ resolvedPricing = {
368
+ cost: null,
369
+ status,
370
+ priceSource: historicalSnapshot.source ?? null,
371
+ snapshot: { ...historicalSnapshot, status }
372
+ };
373
+ } else {
374
+ resolvedPricing = pricingFor(input);
375
+ }
376
+ }
377
+ const now = /* @__PURE__ */ new Date();
378
+ const occurredAt = sourceDate(input.occurredAt) || sourceDate((0, import_record_utils.read)(existing, "usageOccurredAt"));
379
+ const existingDepartmentId = (0, import_record_utils.read)(existing, "departmentId");
380
+ const departmentId = existingDepartmentId ?? input.departmentId;
381
+ const values = {
382
+ type: "model_call",
383
+ usageIdentity,
384
+ ...input.nativeIdentity ? { nativeIdentity: input.nativeIdentity } : {},
385
+ usageSessionId: input.sessionId,
386
+ usageMessageId: input.messageId,
387
+ ...input.runId === void 0 ? {} : { agentLoopRunId: input.runId },
388
+ ...input.rootRunId ? { rootRunId: input.rootRunId } : {},
389
+ ...input.parentSpanId ? { parentSpanId: input.parentSpanId } : {},
390
+ ...input.role ? { role: input.role } : {},
391
+ ...input.employeeUsername ? { employeeUsername: input.employeeUsername } : {},
392
+ ...input.userId == null ? {} : { userId: input.userId },
393
+ ...departmentId == null ? {} : {
394
+ departmentId,
395
+ departmentAttribution: existingDepartmentId == null ? "snapshot" : (0, import_record_utils.read)(existing, "departmentAttribution")
396
+ },
397
+ ...input.model ? { model: input.model } : {},
398
+ ...input.provider ? { provider: input.provider } : {},
399
+ ...input.llmService ? { llmService: input.llmService } : {},
400
+ source: input.source === "ai_usage_event" ? "native-plugin-ai" : "loop-runtime-usage",
401
+ usageSource,
402
+ usageOrigin: shouldPreserveUsage ? existingOrigin || identityPart((0, import_record_utils.read)(existing, "usageOrigin")) : origin,
403
+ inputTokens: shouldPreserveUsage ? (0, import_record_utils.read)(existing, "inputTokens") : (usage == null ? void 0 : usage.inputTokens) ?? null,
404
+ outputTokens: shouldPreserveUsage ? (0, import_record_utils.read)(existing, "outputTokens") : (usage == null ? void 0 : usage.outputTokens) ?? null,
405
+ totalTokens: shouldPreserveUsage ? (0, import_record_utils.read)(existing, "totalTokens") : (usage == null ? void 0 : usage.totalTokens) ?? null,
406
+ cachedTokens: shouldPreserveUsage ? (0, import_record_utils.read)(existing, "cachedTokens") : (usage == null ? void 0 : usage.cachedTokens) ?? null,
407
+ reasoningTokens: shouldPreserveUsage ? (0, import_record_utils.read)(existing, "reasoningTokens") : (usage == null ? void 0 : usage.reasoningTokens) ?? null,
408
+ cost: preservePrice ? (0, import_record_utils.read)(existing, "cost") : (resolvedPricing == null ? void 0 : resolvedPricing.cost) ?? null,
409
+ pricingStatus: preservePrice ? (0, import_record_utils.read)(existing, "pricingStatus") : (resolvedPricing == null ? void 0 : resolvedPricing.status) ?? "unpriced",
410
+ priceSource: preservePrice ? (0, import_record_utils.read)(existing, "priceSource") : (resolvedPricing == null ? void 0 : resolvedPricing.priceSource) ?? null,
411
+ priceCurrency: preservePrice ? (0, import_record_utils.read)(existing, "priceCurrency") : (resolvedPricing == null ? void 0 : resolvedPricing.snapshot.currency) ?? null,
412
+ priceVersion: preservePrice ? (0, import_record_utils.read)(existing, "priceVersion") : (resolvedPricing == null ? void 0 : resolvedPricing.snapshot.version) ?? null,
413
+ priceInputPer1k: preservePrice ? (0, import_record_utils.read)(existing, "priceInputPer1k") : (resolvedPricing == null ? void 0 : resolvedPricing.snapshot.inputPer1k) ?? null,
414
+ priceOutputPer1k: preservePrice ? (0, import_record_utils.read)(existing, "priceOutputPer1k") : (resolvedPricing == null ? void 0 : resolvedPricing.snapshot.outputPer1k) ?? null,
415
+ priceCachedInputPer1k: preservePrice ? (0, import_record_utils.read)(existing, "priceCachedInputPer1k") : (resolvedPricing == null ? void 0 : resolvedPricing.snapshot.cachedInputPer1k) ?? null,
416
+ ...occurredAt ? { usageOccurredAt: occurredAt } : {},
417
+ ...sourceDate(input.occurredAt) ? { startedAt: occurredAt, endedAt: occurredAt } : {},
418
+ ...existing ? {} : { status: "success", startedAt: occurredAt || now, endedAt: occurredAt || now, createdAt: now },
419
+ updatedAt: now
420
+ };
421
+ const id = spanIdentity(existing);
422
+ if (id !== void 0) {
423
+ await repo.update({ filterByTk: id, values, ...txOptions });
424
+ return id;
425
+ }
426
+ const created = await repo.create({
86
427
  values: {
87
- inputTokens: usage.inputTokens,
88
- outputTokens: usage.outputTokens,
89
- totalTokens: usage.totalTokens,
90
- cost: usage.cost
428
+ rootRunId: input.rootRunId || `session:${input.sessionId}`,
429
+ status: "success",
430
+ startedAt: occurredAt || now,
431
+ endedAt: occurredAt || now,
432
+ createdAt: now,
433
+ ...values
434
+ },
435
+ ...txOptions
436
+ });
437
+ return spanIdentity(created);
438
+ };
439
+ try {
440
+ let id;
441
+ try {
442
+ id = await this.withTransaction(persist);
443
+ } catch {
444
+ id = await this.withTransaction(persist);
445
+ }
446
+ if (id === void 0) return void 0;
447
+ if (input.runId != null && input.recomputeRunTotals !== false && !await this.accumulateToRun(input.runId)) {
448
+ return void 0;
449
+ }
450
+ return id;
451
+ } catch (error) {
452
+ this.warn("[TokenTracker] Failed to track model-call usage", error);
453
+ return void 0;
454
+ }
455
+ }
456
+ /**
457
+ * Imports authoritative core aiUsageEvents for one session. The same identity is used by the
458
+ * native monitor projection, so loop retries and observer reconciliation update one model-call.
459
+ */
460
+ async syncNativeUsageEvents(input) {
461
+ try {
462
+ const repo = this.db.getRepository("aiUsageEvents");
463
+ if (!(repo == null ? void 0 : repo.find)) {
464
+ if (input.expectEvents && input.runId != null)
465
+ await this.markSessionIncomplete(input.runId, input.sessionId, true);
466
+ return 0;
467
+ }
468
+ let tracked = 0;
469
+ let lastMessageId;
470
+ let hasMore = true;
471
+ while (hasMore) {
472
+ const events = await repo.find({
473
+ filter: {
474
+ sessionId: input.sessionId,
475
+ eventType: USAGE_EVENT_TYPE,
476
+ ...lastMessageId ? { messageId: { $gt: lastMessageId } } : {}
477
+ },
478
+ sort: ["messageId"],
479
+ limit: USAGE_PAGE_SIZE
480
+ });
481
+ for (const event of events) {
482
+ const sessionId = identityPart((0, import_record_utils.read)(event, "sessionId")) || input.sessionId;
483
+ const messageId = messageIdFor(event);
484
+ if (!messageId) throw new Error("Native usage event has no message identity.");
485
+ const nativeCost = readNumber((0, import_record_utils.read)(event, "cost"));
486
+ const priceSnapshotValue = (0, import_record_utils.read)(event, "priceSnapshot");
487
+ const priceSnapshot = priceSnapshotValue && typeof priceSnapshotValue === "object" ? priceSnapshotValue : void 0;
488
+ const occurredAt = sourceDate((0, import_record_utils.read)(event, "occurredAt"));
489
+ const id = await this.recordModelCallUsage({
490
+ usageIdentity: usageEventIdentity(sessionId, messageId),
491
+ nativeIdentity: usageEventIdentity(sessionId, messageId),
492
+ sessionId,
493
+ messageId,
494
+ usage: usageFromAIUsageEvent(event),
495
+ model: identityPart((0, import_record_utils.read)(event, "model")) || void 0,
496
+ provider: identityPart((0, import_record_utils.read)(event, "provider")) || void 0,
497
+ llmService: identityPart((0, import_record_utils.read)(event, "llmService")) || void 0,
498
+ runId: input.runId,
499
+ rootRunId: input.rootRunId,
500
+ parentSpanId: input.parentSpanId,
501
+ role: input.role,
502
+ employeeUsername: input.employeeUsername || identityPart((0, import_record_utils.read)(event, "aiEmployeeUsername")) || void 0,
503
+ userId: input.userId ?? (0, import_record_utils.read)(event, "userId"),
504
+ source: "ai_usage_event",
505
+ recomputeRunTotals: false,
506
+ ...occurredAt ? { occurredAt } : {},
507
+ ...priceSnapshot ? { priceSnapshot } : {},
508
+ ...nativeCost === void 0 ? {} : { nativeCost }
509
+ });
510
+ if (id === void 0) throw new Error(`Could not persist usage event ${messageId}.`);
511
+ tracked += 1;
512
+ }
513
+ if (events.length < USAGE_PAGE_SIZE) {
514
+ hasMore = false;
515
+ continue;
516
+ }
517
+ const nextMessageId = messageIdFor(events[events.length - 1]);
518
+ if (!nextMessageId || nextMessageId === lastMessageId)
519
+ throw new Error("Native usage pagination did not advance.");
520
+ lastMessageId = nextMessageId;
521
+ }
522
+ if (input.runId != null && (tracked > 0 || input.expectEvents)) {
523
+ await this.markSessionIncomplete(input.runId, input.sessionId, tracked === 0);
524
+ if (!await this.accumulateToRun(input.runId)) throw new Error("Could not recalculate usage totals.");
525
+ }
526
+ return tracked;
527
+ } catch (error) {
528
+ this.warn("[TokenTracker] Failed to synchronize native usage events", error);
529
+ if (input.runId != null) {
530
+ try {
531
+ await this.markSessionIncomplete(input.runId, input.sessionId, true);
532
+ } catch (markError) {
533
+ this.warn("[TokenTracker] Failed to mark incomplete run usage", markError);
91
534
  }
535
+ }
536
+ return -1;
537
+ }
538
+ }
539
+ /**
540
+ * Persists the loop adapter's transcript aggregate only as a non-additive summary when the
541
+ * authoritative aiUsageEvents rows are unavailable. Summary rows stay out of run totals so a
542
+ * later native reconciliation cannot double-count resume history or model-call children.
543
+ */
544
+ async trackLoopInvocationUsage(input) {
545
+ const nativeRows = await this.syncNativeUsageEvents({
546
+ sessionId: input.sessionId,
547
+ expectEvents: true,
548
+ runId: input.runId,
549
+ rootRunId: input.rootRunId,
550
+ role: input.role,
551
+ employeeUsername: input.employeeUsername,
552
+ userId: input.userId
553
+ });
554
+ if (nativeRows !== 0) return;
555
+ try {
556
+ const repo = this.db.getRepository("agentExecutionSpans");
557
+ if (!(repo == null ? void 0 : repo.findOne) || !(repo == null ? void 0 : repo.create) || !repo.update) return;
558
+ const usageIdentity = `loop-invocation-summary:${input.runId}:${input.stepId}`;
559
+ const existing = await repo.findOne({ filter: { usageIdentity } });
560
+ const now = /* @__PURE__ */ new Date();
561
+ let usage = usageIsValid(input.usage) ? input.usage : null;
562
+ let source = usage ? "actual" : "missing";
563
+ if (!usage) {
564
+ const inputTokens = Math.ceil((input.input || "").length / 4);
565
+ const outputTokens = Math.ceil((input.output || "").length / 4);
566
+ usage = { inputTokens, outputTokens, totalTokens: inputTokens + outputTokens };
567
+ source = "estimated";
568
+ }
569
+ const priced = pricingFor({
570
+ usageIdentity,
571
+ sessionId: input.sessionId,
572
+ messageId: input.messageId || "",
573
+ usage,
574
+ source: "loop_runtime"
92
575
  });
93
- if (runId != null) {
94
- await this.accumulateToRun(runId);
576
+ const values = {
577
+ type: "invocation_summary",
578
+ usageIdentity,
579
+ usageSessionId: input.sessionId,
580
+ usageMessageId: input.messageId || null,
581
+ agentLoopRunId: input.runId,
582
+ agentLoopStepId: input.stepId,
583
+ rootRunId: input.rootRunId || `loop:${input.runId}`,
584
+ role: input.role,
585
+ employeeUsername: input.employeeUsername,
586
+ ...input.userId == null ? {} : { userId: input.userId },
587
+ source: "loop-runtime-summary",
588
+ usageSource: source,
589
+ usageOrigin: "loop_invocation_summary",
590
+ inputTokens: usage.inputTokens,
591
+ outputTokens: usage.outputTokens,
592
+ totalTokens: usage.totalTokens,
593
+ cachedTokens: usage.cachedTokens ?? null,
594
+ reasoningTokens: usage.reasoningTokens ?? null,
595
+ cost: priced.cost,
596
+ pricingStatus: priced.cost === null ? "unpriced" : source === "estimated" ? "estimated" : priced.status,
597
+ priceSource: priced.priceSource,
598
+ priceCurrency: priced.snapshot.currency ?? null,
599
+ priceVersion: priced.snapshot.version ?? null,
600
+ priceInputPer1k: priced.snapshot.inputPer1k ?? null,
601
+ priceOutputPer1k: priced.snapshot.outputPer1k ?? null,
602
+ priceCachedInputPer1k: priced.snapshot.cachedInputPer1k ?? null,
603
+ status: "success",
604
+ startedAt: now,
605
+ endedAt: now,
606
+ updatedAt: now
607
+ };
608
+ const existingId = spanIdentity(existing);
609
+ if (existingId !== void 0) {
610
+ await repo.update({ filterByTk: existingId, values });
611
+ } else {
612
+ await repo.create({ values: { createdAt: now, ...values } });
95
613
  }
96
- } catch (e) {
97
- (_b = (_a = this.app.log) == null ? void 0 : _a.warn) == null ? void 0 : _b.call(_a, "[TokenTracker] Failed to track span tokens", e);
614
+ } catch (error) {
615
+ this.warn("[TokenTracker] Failed to persist loop invocation usage summary", error);
98
616
  }
99
617
  }
100
618
  /**
101
- * Recalculate total token/cost for a run by summing all its spans.
619
+ * Compatibility API for callers that already hold an agentExecutionSpans primary key. This
620
+ * method deliberately keeps span identity separate from agentLoopSteps IDs.
102
621
  */
103
- async accumulateToRun(runId) {
104
- var _a, _b, _c, _d, _e;
622
+ async trackSpan(spanId, usage, runId) {
623
+ if (spanId === void 0 || spanId === null || spanId === "") return;
105
624
  try {
106
- const spansRepo = this.db.getRepository("agentExecutionSpans");
107
- if (!spansRepo) return;
108
- const spans = await spansRepo.find({
109
- filter: { agentLoopRunId: String(runId) },
110
- fields: ["inputTokens", "outputTokens", "cost"],
111
- limit: 1e4
625
+ const repo = this.db.getRepository("agentExecutionSpans");
626
+ if (!(repo == null ? void 0 : repo.findOne) || !repo.update) return;
627
+ const span = await repo.findOne({ filterByTk: spanId });
628
+ if (!span) return;
629
+ const inputTokens = readNumber(usage.inputTokens);
630
+ const outputTokens = readNumber(usage.outputTokens);
631
+ const totalTokens = readNumber(usage.totalTokens);
632
+ if (inputTokens === void 0 || outputTokens === void 0 || totalTokens === void 0) return;
633
+ const model = identityPart((0, import_record_utils.read)(span, "model")) || void 0;
634
+ const provider = identityPart((0, import_record_utils.read)(span, "provider")) || void 0;
635
+ const llmService = identityPart((0, import_record_utils.read)(span, "llmService")) || void 0;
636
+ const resolved = pricingFor({
637
+ usageIdentity: identityPart((0, import_record_utils.read)(span, "usageIdentity")) || `legacy-span:${spanId}`,
638
+ nativeIdentity: identityPart((0, import_record_utils.read)(span, "nativeIdentity")) || void 0,
639
+ sessionId: identityPart((0, import_record_utils.read)(span, "sessionId")),
640
+ messageId: identityPart((0, import_record_utils.read)(span, "messageId")),
641
+ usage: { inputTokens, outputTokens, totalTokens, cost: usage.cost, cachedTokens: usage.cachedTokens },
642
+ model,
643
+ provider,
644
+ llmService,
645
+ source: "loop_runtime"
112
646
  });
113
- let totalInput = 0;
114
- let totalOutput = 0;
115
- let totalCost = 0;
116
- for (const span of spans) {
117
- totalInput += Number(((_a = span.get) == null ? void 0 : _a.call(span, "inputTokens")) || span.inputTokens || 0);
118
- totalOutput += Number(((_b = span.get) == null ? void 0 : _b.call(span, "outputTokens")) || span.outputTokens || 0);
119
- totalCost += Number(((_c = span.get) == null ? void 0 : _c.call(span, "cost")) || span.cost || 0);
120
- }
121
- const runsRepo = this.db.getRepository("agentLoopRuns");
122
- if (!runsRepo) return;
123
- await runsRepo.update({
124
- filterByTk: runId,
647
+ await repo.update({
648
+ filterByTk: spanId,
125
649
  values: {
126
- totalInputTokens: totalInput,
127
- totalOutputTokens: totalOutput,
128
- totalTokens: totalInput + totalOutput,
129
- totalCost
650
+ inputTokens,
651
+ outputTokens,
652
+ totalTokens,
653
+ cachedTokens: usage.cachedTokens ?? null,
654
+ reasoningTokens: usage.reasoningTokens ?? null,
655
+ usageSource: "actual",
656
+ usageOrigin: "legacy_tracker",
657
+ cost: resolved.cost,
658
+ pricingStatus: resolved.status,
659
+ priceSource: resolved.priceSource,
660
+ priceCurrency: resolved.snapshot.currency ?? null,
661
+ priceVersion: resolved.snapshot.version ?? null,
662
+ priceInputPer1k: resolved.snapshot.inputPer1k ?? null,
663
+ priceOutputPer1k: resolved.snapshot.outputPer1k ?? null,
664
+ priceCachedInputPer1k: resolved.snapshot.cachedInputPer1k ?? null,
665
+ updatedAt: /* @__PURE__ */ new Date()
130
666
  }
131
667
  });
132
- } catch (e) {
133
- (_e = (_d = this.app.log) == null ? void 0 : _d.warn) == null ? void 0 : _e.call(_d, "[TokenTracker] Failed to accumulate run totals", e);
668
+ if (runId != null) await this.accumulateToRun(runId);
669
+ } catch (error) {
670
+ this.warn("[TokenTracker] Failed to track span tokens", error);
134
671
  }
135
672
  }
136
- /**
137
- * Check if a run has exceeded its budget limits.
138
- */
673
+ /** Recalculates totals from model-call spans only. Parent and child span tokens are not added. */
674
+ async accumulateToRun(runId) {
675
+ try {
676
+ return await this.withTransaction(async (transaction) => {
677
+ var _a;
678
+ const spansRepo = this.db.getRepository("agentExecutionSpans");
679
+ const runsRepo = this.db.getRepository("agentLoopRuns");
680
+ if (!(spansRepo == null ? void 0 : spansRepo.find) || !(runsRepo == null ? void 0 : runsRepo.findOne) || !runsRepo.update) return false;
681
+ const txOptions = transaction ? { transaction, ...((_a = transaction.LOCK) == null ? void 0 : _a.UPDATE) === void 0 ? {} : { lock: transaction.LOCK.UPDATE } } : {};
682
+ const run = await runsRepo.findOne({ filterByTk: runId, ...txOptions });
683
+ if (!run) return false;
684
+ let totalInput = 0;
685
+ let totalOutput = 0;
686
+ let totalTokens = 0;
687
+ let totalCost = 0;
688
+ let hasKnownUsage = false;
689
+ let hasMissingUsage = incompleteSessions(run).length > 0;
690
+ let hasEstimatedUsage = false;
691
+ let hasActualUsage = false;
692
+ let hasUnpriced = incompleteSessions(run).length > 0;
693
+ let hasNonUsd = false;
694
+ let hasEstimatedPrice = false;
695
+ let rowCount = 0;
696
+ let lastId;
697
+ let hasMore = true;
698
+ while (hasMore) {
699
+ const spans = await spansRepo.find({
700
+ filter: {
701
+ agentLoopRunId: runId,
702
+ type: "model_call",
703
+ ...lastId === void 0 ? {} : { id: { $gt: lastId } }
704
+ },
705
+ fields: [
706
+ "id",
707
+ "inputTokens",
708
+ "outputTokens",
709
+ "totalTokens",
710
+ "cost",
711
+ "usageSource",
712
+ "pricingStatus",
713
+ "priceCurrency"
714
+ ],
715
+ sort: ["id"],
716
+ limit: USAGE_PAGE_SIZE,
717
+ ...transaction ? { transaction } : {}
718
+ });
719
+ rowCount += spans.length;
720
+ for (const span of spans) {
721
+ const source = identityPart((0, import_record_utils.read)(span, "usageSource"));
722
+ const inputTokens = storedNumber(span, "inputTokens");
723
+ const outputTokens = storedNumber(span, "outputTokens");
724
+ const storedTotalTokens = storedNumber(span, "totalTokens");
725
+ if (source === "missing" || inputTokens === null || outputTokens === null) {
726
+ hasMissingUsage = true;
727
+ } else {
728
+ hasKnownUsage = true;
729
+ totalInput += inputTokens;
730
+ totalOutput += outputTokens;
731
+ totalTokens += storedTotalTokens ?? inputTokens + outputTokens;
732
+ if (source === "estimated" || !source) hasEstimatedUsage = true;
733
+ if (source === "actual") hasActualUsage = true;
734
+ }
735
+ const pricingStatus2 = identityPart((0, import_record_utils.read)(span, "pricingStatus"));
736
+ const currency = identityPart((0, import_record_utils.read)(span, "priceCurrency")).toUpperCase();
737
+ const cost = storedNumber(span, "cost");
738
+ if (pricingStatus2 === "non_usd" || currency && currency !== "USD") hasNonUsd = true;
739
+ if (pricingStatus2 === "unpriced" || cost === null || currency !== "USD") {
740
+ hasUnpriced = true;
741
+ } else {
742
+ totalCost += cost;
743
+ if (pricingStatus2 === "estimated") hasEstimatedPrice = true;
744
+ }
745
+ }
746
+ if (spans.length < USAGE_PAGE_SIZE) {
747
+ hasMore = false;
748
+ continue;
749
+ }
750
+ const nextId = spanIdentity(spans[spans.length - 1]);
751
+ if (nextId === void 0 || nextId === lastId) throw new Error("Usage rollup pagination did not advance.");
752
+ lastId = nextId;
753
+ }
754
+ const usageStatus = !hasKnownUsage ? "missing" : hasMissingUsage ? "partial" : hasEstimatedUsage ? "estimated" : hasActualUsage ? "actual" : "partial";
755
+ const pricingStatus = hasNonUsd ? "non_usd" : hasUnpriced || rowCount === 0 ? "unpriced" : hasEstimatedPrice ? "estimated" : "configured";
756
+ await runsRepo.update({
757
+ filterByTk: runId,
758
+ values: {
759
+ totalInputTokens: hasKnownUsage ? totalInput : null,
760
+ totalOutputTokens: hasKnownUsage ? totalOutput : null,
761
+ totalTokens: hasKnownUsage ? totalTokens : null,
762
+ totalCost: hasUnpriced || rowCount === 0 ? null : totalCost,
763
+ usageStatus,
764
+ pricingStatus
765
+ },
766
+ ...transaction ? { transaction } : {}
767
+ });
768
+ return true;
769
+ });
770
+ } catch (error) {
771
+ this.warn("[TokenTracker] Failed to accumulate run totals", error);
772
+ return false;
773
+ }
774
+ }
775
+ /** Checks configured budgets. Unknown cost is never treated as a free run. */
139
776
  async checkBudget(runId) {
140
- var _a, _b, _c, _d, _e, _f;
141
777
  try {
142
778
  const repo = this.db.getRepository("agentLoopRuns");
143
- if (!repo) return { allowed: true };
779
+ if (!(repo == null ? void 0 : repo.findOne)) return { allowed: true };
144
780
  const run = await repo.findOne({ filter: { id: runId } });
145
781
  if (!run) return { allowed: true };
146
- const budgetMaxTokens = Number(((_a = run.get) == null ? void 0 : _a.call(run, "budgetMaxTokens")) ?? 0);
147
- const budgetMaxCost = Number(((_b = run.get) == null ? void 0 : _b.call(run, "budgetMaxCost")) ?? 0);
782
+ const budgetMaxTokens = Number((0, import_record_utils.read)(run, "budgetMaxTokens") ?? 0);
783
+ const budgetMaxCost = Number((0, import_record_utils.read)(run, "budgetMaxCost") ?? 0);
148
784
  if (budgetMaxTokens <= 0 && budgetMaxCost <= 0) return { allowed: true };
149
- const totalTokens = Number(((_c = run.get) == null ? void 0 : _c.call(run, "totalTokens")) || 0);
150
- const totalCost = Number(((_d = run.get) == null ? void 0 : _d.call(run, "totalCost")) || 0);
151
- if (budgetMaxTokens > 0 && totalTokens >= budgetMaxTokens) {
785
+ const usageStatus = identityPart((0, import_record_utils.read)(run, "usageStatus"));
786
+ const pricingStatus = identityPart((0, import_record_utils.read)(run, "pricingStatus"));
787
+ const hasIncompleteSessions = incompleteSessions(run).length > 0;
788
+ const totalTokens = readNumber((0, import_record_utils.read)(run, "totalTokens"));
789
+ const totalCost = readNumber((0, import_record_utils.read)(run, "totalCost"));
790
+ const hasInvocations = (readNumber((0, import_record_utils.read)(run, "invocationCount")) ?? 0) > 0;
791
+ if (budgetMaxTokens > 0 && (hasIncompleteSessions || usageStatus === "partial" || usageStatus === "missing" || totalTokens === void 0 && (usageStatus !== "" || hasInvocations))) {
792
+ return {
793
+ allowed: false,
794
+ reason: "Token usage is unavailable, so this run cannot be checked against its token budget."
795
+ };
796
+ }
797
+ if (budgetMaxCost > 0 && (hasIncompleteSessions || pricingStatus === "unpriced" || pricingStatus === "non_usd" || totalCost === void 0 && (pricingStatus !== "" || hasInvocations))) {
798
+ return {
799
+ allowed: false,
800
+ reason: "Model pricing is unavailable, so this run cannot be checked against its cost budget."
801
+ };
802
+ }
803
+ if (budgetMaxTokens > 0 && totalTokens !== void 0 && totalTokens >= budgetMaxTokens) {
152
804
  return {
153
805
  allowed: false,
154
806
  reason: `Budget exceeded: ${totalTokens}/${budgetMaxTokens} tokens used. Maximum allowed tokens for this run: ${budgetMaxTokens}.`
155
807
  };
156
808
  }
157
- if (budgetMaxCost > 0 && totalCost >= budgetMaxCost) {
809
+ if (budgetMaxCost > 0 && totalCost !== void 0 && totalCost >= budgetMaxCost) {
158
810
  return {
159
811
  allowed: false,
160
812
  reason: `Budget exceeded: $${totalCost.toFixed(4)}/$${budgetMaxCost.toFixed(
@@ -163,47 +815,78 @@ class TokenTracker {
163
815
  };
164
816
  }
165
817
  return { allowed: true };
166
- } catch (e) {
167
- (_f = (_e = this.app.log) == null ? void 0 : _e.warn) == null ? void 0 : _f.call(_e, "[TokenTracker] Budget check failed, allowing", e);
818
+ } catch (error) {
819
+ this.warn("[TokenTracker] Budget check failed, allowing", error);
168
820
  return { allowed: true };
169
821
  }
170
822
  }
171
823
  /**
172
- * Track actual token usage from the LLM response on a span.
173
- * This is preferred over estimateAndTrack when the LLM provides real usage metadata.
174
- * Falls back to estimation if usage is null.
824
+ * Compatibility API for callers that update an existing span. Missing usage falls back to an
825
+ * explicit text estimate; zero-token actual usage remains actual and is never re-estimated.
175
826
  */
176
827
  async trackActualUsage(spanId, tokenUsage, input, output, runId) {
177
- if (tokenUsage && tokenUsage.totalTokens > 0) {
178
- await this.trackSpan(spanId, tokenUsage, runId);
828
+ if (usageIsValid(tokenUsage)) {
829
+ await this.trackSpan(spanId, { ...tokenUsage, cost: tokenUsage.cost ?? Number.NaN }, runId);
179
830
  return;
180
831
  }
181
832
  await this.estimateAndTrack(spanId, input, output, runId);
182
833
  }
183
- /**
184
- * Estimate tokens from text length and track on a span.
185
- * Rough heuristic: ~4 chars per token for English text.
186
- * Use when actual usage_metadata is not available (e.g. native plugin-ai flow).
187
- */
834
+ /** Stores the legacy text-length estimate explicitly, scoped to an existing span. */
188
835
  async estimateAndTrack(spanId, input, output, runId) {
189
- if (!spanId) return;
190
- const inputTokens = Math.ceil((input || "").length / 4);
191
- const outputTokens = Math.ceil((output || "").length / 4);
192
- await this.trackSpan(
193
- spanId,
194
- {
836
+ if (spanId === void 0 || spanId === null || spanId === "") return;
837
+ try {
838
+ const repo = this.db.getRepository("agentExecutionSpans");
839
+ if (!(repo == null ? void 0 : repo.findOne) || !repo.update) return;
840
+ const span = await repo.findOne({ filterByTk: spanId });
841
+ if (!span) return;
842
+ const inputTokens = Math.ceil((input || "").length / 4);
843
+ const outputTokens = Math.ceil((output || "").length / 4);
844
+ const usage = {
195
845
  inputTokens,
196
846
  outputTokens,
197
- totalTokens: inputTokens + outputTokens,
198
- cost: estimateCost(inputTokens, outputTokens)
199
- },
200
- runId
201
- );
847
+ totalTokens: inputTokens + outputTokens
848
+ };
849
+ const resolved = pricingFor({
850
+ usageIdentity: identityPart((0, import_record_utils.read)(span, "usageIdentity")) || `legacy-span:${spanId}`,
851
+ sessionId: identityPart((0, import_record_utils.read)(span, "sessionId")),
852
+ messageId: identityPart((0, import_record_utils.read)(span, "messageId")),
853
+ usage,
854
+ model: identityPart((0, import_record_utils.read)(span, "model")) || void 0,
855
+ provider: identityPart((0, import_record_utils.read)(span, "provider")) || void 0,
856
+ llmService: identityPart((0, import_record_utils.read)(span, "llmService")) || void 0,
857
+ source: "loop_runtime"
858
+ });
859
+ await repo.update({
860
+ filterByTk: spanId,
861
+ values: {
862
+ inputTokens,
863
+ outputTokens,
864
+ totalTokens: inputTokens + outputTokens,
865
+ cachedTokens: null,
866
+ reasoningTokens: null,
867
+ usageSource: "estimated",
868
+ usageOrigin: "text_length_estimate",
869
+ cost: resolved.cost,
870
+ pricingStatus: resolved.cost === null ? "unpriced" : "estimated",
871
+ priceSource: resolved.priceSource,
872
+ priceCurrency: resolved.snapshot.currency ?? null,
873
+ priceVersion: resolved.snapshot.version ?? null,
874
+ priceInputPer1k: resolved.snapshot.inputPer1k ?? null,
875
+ priceOutputPer1k: resolved.snapshot.outputPer1k ?? null,
876
+ priceCachedInputPer1k: resolved.snapshot.cachedInputPer1k ?? null,
877
+ updatedAt: /* @__PURE__ */ new Date()
878
+ }
879
+ });
880
+ if (runId != null) await this.accumulateToRun(runId);
881
+ } catch (error) {
882
+ this.warn("[TokenTracker] Failed to estimate span tokens", error);
883
+ }
202
884
  }
203
885
  }
204
886
  // Annotate the CommonJS export names for ESM import in node:
205
887
  0 && (module.exports = {
206
888
  TokenTracker,
207
889
  estimateCost,
208
- extractTokenUsage
890
+ usageEventIdentity,
891
+ usageFromAIUsageEvent
209
892
  });