@assemblyline-agents/runtime 1.0.0 → 3.0.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 (460) hide show
  1. package/LICENSE +1 -1
  2. package/dist/a2a-client.d.ts +22 -0
  3. package/dist/a2a-client.d.ts.map +1 -0
  4. package/dist/a2a-client.js +211 -0
  5. package/dist/a2a-client.js.map +1 -0
  6. package/dist/agent-capability-snapshot.d.ts +32 -0
  7. package/dist/agent-capability-snapshot.d.ts.map +1 -0
  8. package/dist/agent-capability-snapshot.js +77 -0
  9. package/dist/agent-capability-snapshot.js.map +1 -0
  10. package/dist/agent-event-handlers.d.ts +21 -0
  11. package/dist/agent-event-handlers.d.ts.map +1 -0
  12. package/dist/agent-event-handlers.js +64 -0
  13. package/dist/agent-event-handlers.js.map +1 -0
  14. package/dist/agent-hook-context.d.ts +8 -0
  15. package/dist/agent-hook-context.d.ts.map +1 -0
  16. package/dist/agent-hook-context.js +29 -0
  17. package/dist/agent-hook-context.js.map +1 -0
  18. package/dist/agent-hook-evaluation.d.ts +61 -0
  19. package/dist/agent-hook-evaluation.d.ts.map +1 -0
  20. package/dist/agent-hook-evaluation.js +197 -0
  21. package/dist/agent-hook-evaluation.js.map +1 -0
  22. package/dist/agent-hook-run-lifecycle.d.ts +44 -0
  23. package/dist/agent-hook-run-lifecycle.d.ts.map +1 -0
  24. package/dist/agent-hook-run-lifecycle.js +76 -0
  25. package/dist/agent-hook-run-lifecycle.js.map +1 -0
  26. package/dist/agent-state.d.ts +31 -0
  27. package/dist/agent-state.d.ts.map +1 -0
  28. package/dist/agent-state.js +80 -0
  29. package/dist/agent-state.js.map +1 -0
  30. package/dist/agent-surface.d.ts +32 -0
  31. package/dist/agent-surface.d.ts.map +1 -0
  32. package/dist/agent-surface.js +85 -0
  33. package/dist/agent-surface.js.map +1 -0
  34. package/dist/attachments.d.ts +5 -1
  35. package/dist/attachments.d.ts.map +1 -1
  36. package/dist/attachments.js +58 -32
  37. package/dist/attachments.js.map +1 -1
  38. package/dist/audience.d.ts +30 -0
  39. package/dist/audience.d.ts.map +1 -0
  40. package/dist/audience.js +68 -0
  41. package/dist/audience.js.map +1 -0
  42. package/dist/authored-hooks.d.ts +6 -0
  43. package/dist/authored-hooks.d.ts.map +1 -0
  44. package/dist/authored-hooks.js +17 -0
  45. package/dist/authored-hooks.js.map +1 -0
  46. package/dist/automation-event-match.d.ts +8 -0
  47. package/dist/automation-event-match.d.ts.map +1 -0
  48. package/dist/automation-event-match.js +25 -0
  49. package/dist/automation-event-match.js.map +1 -0
  50. package/dist/background-review-trigger.d.ts +9 -0
  51. package/dist/background-review-trigger.d.ts.map +1 -0
  52. package/dist/background-review-trigger.js +72 -0
  53. package/dist/background-review-trigger.js.map +1 -0
  54. package/dist/background-review-types.d.ts +60 -0
  55. package/dist/background-review-types.d.ts.map +1 -0
  56. package/dist/background-review-types.js +2 -0
  57. package/dist/background-review-types.js.map +1 -0
  58. package/dist/background-review-worker.d.ts +14 -0
  59. package/dist/background-review-worker.d.ts.map +1 -0
  60. package/dist/background-review-worker.js +61 -0
  61. package/dist/background-review-worker.js.map +1 -0
  62. package/dist/background-review.d.ts +5 -0
  63. package/dist/background-review.d.ts.map +1 -0
  64. package/dist/background-review.js +332 -0
  65. package/dist/background-review.js.map +1 -0
  66. package/dist/builtin-tool-executors.d.ts +50 -27
  67. package/dist/builtin-tool-executors.d.ts.map +1 -1
  68. package/dist/builtin-tool-executors.js +332 -124
  69. package/dist/builtin-tool-executors.js.map +1 -1
  70. package/dist/builtin-tools.d.ts +16 -9
  71. package/dist/builtin-tools.d.ts.map +1 -1
  72. package/dist/builtin-tools.js +308 -116
  73. package/dist/builtin-tools.js.map +1 -1
  74. package/dist/capability-catalog.d.ts +3 -2
  75. package/dist/capability-catalog.d.ts.map +1 -1
  76. package/dist/capability-catalog.js +12 -7
  77. package/dist/capability-catalog.js.map +1 -1
  78. package/dist/capability-inspection.d.ts +31 -0
  79. package/dist/capability-inspection.d.ts.map +1 -0
  80. package/dist/capability-inspection.js +58 -0
  81. package/dist/capability-inspection.js.map +1 -0
  82. package/dist/channel-http-util.d.ts.map +1 -1
  83. package/dist/channel-http-util.js +6 -5
  84. package/dist/channel-http-util.js.map +1 -1
  85. package/dist/channel-ingress.d.ts +16 -1
  86. package/dist/channel-ingress.d.ts.map +1 -1
  87. package/dist/channel-ingress.js +152 -14
  88. package/dist/channel-ingress.js.map +1 -1
  89. package/dist/channel.d.ts +73 -3
  90. package/dist/channel.d.ts.map +1 -1
  91. package/dist/checkpoints.d.ts +1 -1
  92. package/dist/checkpoints.d.ts.map +1 -1
  93. package/dist/checkpoints.js +6 -6
  94. package/dist/checkpoints.js.map +1 -1
  95. package/dist/child-process-env.d.ts +7 -0
  96. package/dist/child-process-env.d.ts.map +1 -0
  97. package/dist/child-process-env.js +41 -0
  98. package/dist/child-process-env.js.map +1 -0
  99. package/dist/computer-relay-protocol.d.ts.map +1 -1
  100. package/dist/computer-relay-protocol.js +4 -4
  101. package/dist/computer-relay-protocol.js.map +1 -1
  102. package/dist/concurrency.d.ts +1 -1
  103. package/dist/concurrency.js +1 -1
  104. package/dist/connection-auth-util.d.ts +1 -0
  105. package/dist/connection-auth-util.d.ts.map +1 -1
  106. package/dist/connection-auth-util.js +3 -1
  107. package/dist/connection-auth-util.js.map +1 -1
  108. package/dist/connection-clients.d.ts +11 -3
  109. package/dist/connection-clients.d.ts.map +1 -1
  110. package/dist/connection-clients.js +71 -8
  111. package/dist/connection-clients.js.map +1 -1
  112. package/dist/connection-event-store.d.ts +98 -0
  113. package/dist/connection-event-store.d.ts.map +1 -0
  114. package/dist/connection-event-store.js +162 -0
  115. package/dist/connection-event-store.js.map +1 -0
  116. package/dist/connection-events.d.ts +51 -0
  117. package/dist/connection-events.d.ts.map +1 -0
  118. package/dist/connection-events.js +343 -0
  119. package/dist/connection-events.js.map +1 -0
  120. package/dist/connection-stores.d.ts +6 -0
  121. package/dist/connection-stores.d.ts.map +1 -1
  122. package/dist/connection-stores.js +20 -1
  123. package/dist/connection-stores.js.map +1 -1
  124. package/dist/connection-util.d.ts +3 -2
  125. package/dist/connection-util.d.ts.map +1 -1
  126. package/dist/connection-util.js +18 -1
  127. package/dist/connection-util.js.map +1 -1
  128. package/dist/connections.d.ts +60 -5
  129. package/dist/connections.d.ts.map +1 -1
  130. package/dist/connections.js +390 -57
  131. package/dist/connections.js.map +1 -1
  132. package/dist/context-policy-util.d.ts.map +1 -1
  133. package/dist/context-policy-util.js +1 -3
  134. package/dist/context-policy-util.js.map +1 -1
  135. package/dist/conversation-context.d.ts +9 -4
  136. package/dist/conversation-context.d.ts.map +1 -1
  137. package/dist/conversation-context.js +65 -19
  138. package/dist/conversation-context.js.map +1 -1
  139. package/dist/conversation-transcript.d.ts +8 -5
  140. package/dist/conversation-transcript.d.ts.map +1 -1
  141. package/dist/conversation-transcript.js +24 -5
  142. package/dist/conversation-transcript.js.map +1 -1
  143. package/dist/conversation-turn-coalescing.d.ts +22 -0
  144. package/dist/conversation-turn-coalescing.d.ts.map +1 -0
  145. package/dist/conversation-turn-coalescing.js +121 -0
  146. package/dist/conversation-turn-coalescing.js.map +1 -0
  147. package/dist/conversation-turn-dispatch.d.ts +5 -2
  148. package/dist/conversation-turn-dispatch.d.ts.map +1 -1
  149. package/dist/conversation-turn-dispatch.js +59 -22
  150. package/dist/conversation-turn-dispatch.js.map +1 -1
  151. package/dist/default-outbound-route.d.ts +29 -0
  152. package/dist/default-outbound-route.d.ts.map +1 -0
  153. package/dist/default-outbound-route.js +105 -0
  154. package/dist/default-outbound-route.js.map +1 -0
  155. package/dist/delivery-artifacts.d.ts +2 -0
  156. package/dist/delivery-artifacts.d.ts.map +1 -0
  157. package/dist/delivery-artifacts.js +34 -0
  158. package/dist/delivery-artifacts.js.map +1 -0
  159. package/dist/delivery-files.d.ts +5 -0
  160. package/dist/delivery-files.d.ts.map +1 -0
  161. package/dist/delivery-files.js +33 -0
  162. package/dist/delivery-files.js.map +1 -0
  163. package/dist/delivery-queue.d.ts +21 -1
  164. package/dist/delivery-queue.d.ts.map +1 -1
  165. package/dist/delivery-queue.js +144 -1
  166. package/dist/delivery-queue.js.map +1 -1
  167. package/dist/delivery-send.d.ts +2 -2
  168. package/dist/delivery-send.d.ts.map +1 -1
  169. package/dist/delivery-send.js +256 -100
  170. package/dist/delivery-send.js.map +1 -1
  171. package/dist/durable-files.d.ts +37 -0
  172. package/dist/durable-files.d.ts.map +1 -0
  173. package/dist/durable-files.js +63 -0
  174. package/dist/durable-files.js.map +1 -0
  175. package/dist/harness-loop.d.ts +18 -9
  176. package/dist/harness-loop.d.ts.map +1 -1
  177. package/dist/harness-loop.js +245 -50
  178. package/dist/harness-loop.js.map +1 -1
  179. package/dist/heic-transcode-worker.d.ts +2 -0
  180. package/dist/heic-transcode-worker.d.ts.map +1 -0
  181. package/dist/heic-transcode-worker.js +59 -0
  182. package/dist/heic-transcode-worker.js.map +1 -0
  183. package/dist/heic-transcode.d.ts +18 -0
  184. package/dist/heic-transcode.d.ts.map +1 -0
  185. package/dist/heic-transcode.js +99 -0
  186. package/dist/heic-transcode.js.map +1 -0
  187. package/dist/human-input-routing.d.ts +22 -0
  188. package/dist/human-input-routing.d.ts.map +1 -0
  189. package/dist/human-input-routing.js +26 -0
  190. package/dist/human-input-routing.js.map +1 -0
  191. package/dist/in-memory-agent-state-store.d.ts +21 -0
  192. package/dist/in-memory-agent-state-store.d.ts.map +1 -0
  193. package/dist/in-memory-agent-state-store.js +97 -0
  194. package/dist/in-memory-agent-state-store.js.map +1 -0
  195. package/dist/in-memory-conversation-turn-store.d.ts +3 -1
  196. package/dist/in-memory-conversation-turn-store.d.ts.map +1 -1
  197. package/dist/in-memory-conversation-turn-store.js +41 -2
  198. package/dist/in-memory-conversation-turn-store.js.map +1 -1
  199. package/dist/in-memory-run-store.d.ts +8 -0
  200. package/dist/in-memory-run-store.d.ts.map +1 -1
  201. package/dist/in-memory-run-store.js +28 -5
  202. package/dist/in-memory-run-store.js.map +1 -1
  203. package/dist/in-memory-sandbox-session-store.d.ts +2 -1
  204. package/dist/in-memory-sandbox-session-store.d.ts.map +1 -1
  205. package/dist/in-memory-sandbox-session-store.js +65 -1
  206. package/dist/in-memory-sandbox-session-store.js.map +1 -1
  207. package/dist/in-memory-small-stores.d.ts +18 -1
  208. package/dist/in-memory-small-stores.d.ts.map +1 -1
  209. package/dist/in-memory-small-stores.js +107 -1
  210. package/dist/in-memory-small-stores.js.map +1 -1
  211. package/dist/in-memory-workspace-store.d.ts +40 -0
  212. package/dist/in-memory-workspace-store.d.ts.map +1 -0
  213. package/dist/in-memory-workspace-store.js +370 -0
  214. package/dist/in-memory-workspace-store.js.map +1 -0
  215. package/dist/index.d.ts +116 -45
  216. package/dist/index.d.ts.map +1 -1
  217. package/dist/index.js +637 -566
  218. package/dist/index.js.map +1 -1
  219. package/dist/json-util.d.ts +8 -0
  220. package/dist/json-util.d.ts.map +1 -1
  221. package/dist/json-util.js +8 -0
  222. package/dist/json-util.js.map +1 -1
  223. package/dist/learning-store.d.ts +111 -0
  224. package/dist/learning-store.d.ts.map +1 -0
  225. package/dist/learning-store.js +193 -0
  226. package/dist/learning-store.js.map +1 -0
  227. package/dist/local-sandbox.d.ts +3 -2
  228. package/dist/local-sandbox.d.ts.map +1 -1
  229. package/dist/local-sandbox.js +69 -25
  230. package/dist/local-sandbox.js.map +1 -1
  231. package/dist/mcp-client.d.ts.map +1 -1
  232. package/dist/mcp-client.js +3 -2
  233. package/dist/mcp-client.js.map +1 -1
  234. package/dist/media-processor.d.ts +42 -0
  235. package/dist/media-processor.d.ts.map +1 -0
  236. package/dist/media-processor.js +2 -0
  237. package/dist/media-processor.js.map +1 -0
  238. package/dist/model-media.d.ts +13 -1
  239. package/dist/model-media.d.ts.map +1 -1
  240. package/dist/model-media.js +81 -18
  241. package/dist/model-media.js.map +1 -1
  242. package/dist/model-visible-interrupts.d.ts +10 -0
  243. package/dist/model-visible-interrupts.d.ts.map +1 -0
  244. package/dist/model-visible-interrupts.js +41 -0
  245. package/dist/model-visible-interrupts.js.map +1 -0
  246. package/dist/operator-controls.d.ts.map +1 -1
  247. package/dist/operator-controls.js +16 -3
  248. package/dist/operator-controls.js.map +1 -1
  249. package/dist/outbound-http-policy.d.ts +7 -0
  250. package/dist/outbound-http-policy.d.ts.map +1 -0
  251. package/dist/outbound-http-policy.js +155 -0
  252. package/dist/outbound-http-policy.js.map +1 -0
  253. package/dist/principals.d.ts +18 -0
  254. package/dist/principals.d.ts.map +1 -0
  255. package/dist/principals.js +90 -0
  256. package/dist/principals.js.map +1 -0
  257. package/dist/public-api.d.ts +21 -0
  258. package/dist/public-api.d.ts.map +1 -0
  259. package/dist/public-api.js +19 -0
  260. package/dist/public-api.js.map +1 -0
  261. package/dist/replay-resume.d.ts +15 -3
  262. package/dist/replay-resume.d.ts.map +1 -1
  263. package/dist/replay-resume.js +256 -24
  264. package/dist/replay-resume.js.map +1 -1
  265. package/dist/resource-projection-util.d.ts +1 -1
  266. package/dist/resource-projection-util.d.ts.map +1 -1
  267. package/dist/resource-projection-util.js +21 -10
  268. package/dist/resource-projection-util.js.map +1 -1
  269. package/dist/resource-projection.d.ts +8 -1
  270. package/dist/resource-projection.d.ts.map +1 -1
  271. package/dist/resource-projection.js +230 -26
  272. package/dist/resource-projection.js.map +1 -1
  273. package/dist/run-heartbeat.d.ts +12 -2
  274. package/dist/run-heartbeat.d.ts.map +1 -1
  275. package/dist/run-heartbeat.js +31 -4
  276. package/dist/run-heartbeat.js.map +1 -1
  277. package/dist/run-outcome.d.ts +9 -5
  278. package/dist/run-outcome.d.ts.map +1 -1
  279. package/dist/run-outcome.js +16 -5
  280. package/dist/run-outcome.js.map +1 -1
  281. package/dist/run-recovery.d.ts +31 -2
  282. package/dist/run-recovery.d.ts.map +1 -1
  283. package/dist/run-recovery.js +211 -32
  284. package/dist/run-recovery.js.map +1 -1
  285. package/dist/run-replay.d.ts +35 -0
  286. package/dist/run-replay.d.ts.map +1 -0
  287. package/dist/run-replay.js +193 -0
  288. package/dist/run-replay.js.map +1 -0
  289. package/dist/run-result.d.ts +4 -0
  290. package/dist/run-result.d.ts.map +1 -0
  291. package/dist/run-result.js +18 -0
  292. package/dist/run-result.js.map +1 -0
  293. package/dist/run-timeline-query.d.ts +38 -0
  294. package/dist/run-timeline-query.d.ts.map +1 -0
  295. package/dist/run-timeline-query.js +99 -0
  296. package/dist/run-timeline-query.js.map +1 -0
  297. package/dist/runs-query.d.ts.map +1 -1
  298. package/dist/runs-query.js +12 -4
  299. package/dist/runs-query.js.map +1 -1
  300. package/dist/runtime-bundle.d.ts.map +1 -1
  301. package/dist/runtime-bundle.js +2 -0
  302. package/dist/runtime-bundle.js.map +1 -1
  303. package/dist/runtime-learning.d.ts +88 -0
  304. package/dist/runtime-learning.d.ts.map +1 -0
  305. package/dist/runtime-learning.js +260 -0
  306. package/dist/runtime-learning.js.map +1 -0
  307. package/dist/runtime-types.d.ts +79 -10
  308. package/dist/runtime-types.d.ts.map +1 -1
  309. package/dist/sandbox-fs.d.ts +9 -5
  310. package/dist/sandbox-fs.d.ts.map +1 -1
  311. package/dist/sandbox-fs.js +50 -33
  312. package/dist/sandbox-fs.js.map +1 -1
  313. package/dist/sandbox-handle.d.ts +25 -0
  314. package/dist/sandbox-handle.d.ts.map +1 -0
  315. package/dist/sandbox-handle.js +120 -0
  316. package/dist/sandbox-handle.js.map +1 -0
  317. package/dist/sandbox-session-identity.d.ts +14 -0
  318. package/dist/sandbox-session-identity.d.ts.map +1 -0
  319. package/dist/sandbox-session-identity.js +33 -0
  320. package/dist/sandbox-session-identity.js.map +1 -0
  321. package/dist/sandbox-session-key.d.ts.map +1 -1
  322. package/dist/sandbox-session-key.js +14 -10
  323. package/dist/sandbox-session-key.js.map +1 -1
  324. package/dist/sandbox-session-lifecycle.d.ts +12 -0
  325. package/dist/sandbox-session-lifecycle.d.ts.map +1 -0
  326. package/dist/sandbox-session-lifecycle.js +261 -0
  327. package/dist/sandbox-session-lifecycle.js.map +1 -0
  328. package/dist/sandbox-snapshot-policy.js +3 -3
  329. package/dist/sandbox-snapshot-policy.js.map +1 -1
  330. package/dist/sandbox-state-sync.d.ts +22 -0
  331. package/dist/sandbox-state-sync.d.ts.map +1 -0
  332. package/dist/sandbox-state-sync.js +147 -0
  333. package/dist/sandbox-state-sync.js.map +1 -0
  334. package/dist/sandbox-sync-worker.d.ts +11 -2
  335. package/dist/sandbox-sync-worker.d.ts.map +1 -1
  336. package/dist/sandbox-sync-worker.js +143 -31
  337. package/dist/sandbox-sync-worker.js.map +1 -1
  338. package/dist/schedule-execution.d.ts.map +1 -1
  339. package/dist/schedule-execution.js +187 -57
  340. package/dist/schedule-execution.js.map +1 -1
  341. package/dist/sdk-api-client.d.ts +17 -0
  342. package/dist/sdk-api-client.d.ts.map +1 -0
  343. package/dist/sdk-api-client.js +55 -0
  344. package/dist/sdk-api-client.js.map +1 -0
  345. package/dist/security.js +2 -2
  346. package/dist/security.js.map +1 -1
  347. package/dist/self-improvement.d.ts +34 -6
  348. package/dist/self-improvement.d.ts.map +1 -1
  349. package/dist/self-improvement.js +140 -34
  350. package/dist/self-improvement.js.map +1 -1
  351. package/dist/skill-bundles.d.ts +55 -0
  352. package/dist/skill-bundles.d.ts.map +1 -0
  353. package/dist/skill-bundles.js +134 -0
  354. package/dist/skill-bundles.js.map +1 -0
  355. package/dist/source-loader.d.ts +8 -0
  356. package/dist/source-loader.d.ts.map +1 -1
  357. package/dist/source-loader.js +41 -10
  358. package/dist/source-loader.js.map +1 -1
  359. package/dist/state-store-helpers.d.ts +2 -0
  360. package/dist/state-store-helpers.d.ts.map +1 -1
  361. package/dist/state-store-helpers.js +11 -1
  362. package/dist/state-store-helpers.js.map +1 -1
  363. package/dist/state-stores.d.ts +2 -0
  364. package/dist/state-stores.d.ts.map +1 -1
  365. package/dist/state-stores.js +40 -7
  366. package/dist/state-stores.js.map +1 -1
  367. package/dist/state.d.ts +344 -5
  368. package/dist/state.d.ts.map +1 -1
  369. package/dist/state.js +44 -2
  370. package/dist/state.js.map +1 -1
  371. package/dist/storage.d.ts +59 -2
  372. package/dist/storage.d.ts.map +1 -1
  373. package/dist/storage.js +183 -6
  374. package/dist/storage.js.map +1 -1
  375. package/dist/subagent-execution.d.ts +7 -6
  376. package/dist/subagent-execution.d.ts.map +1 -1
  377. package/dist/subagent-execution.js +58 -19
  378. package/dist/subagent-execution.js.map +1 -1
  379. package/dist/target-instructions.d.ts +14 -0
  380. package/dist/target-instructions.d.ts.map +1 -0
  381. package/dist/target-instructions.js +18 -0
  382. package/dist/target-instructions.js.map +1 -0
  383. package/dist/tool-apis.d.ts.map +1 -1
  384. package/dist/tool-apis.js +55 -10
  385. package/dist/tool-apis.js.map +1 -1
  386. package/dist/tool-execution.d.ts +26 -13
  387. package/dist/tool-execution.d.ts.map +1 -1
  388. package/dist/tool-execution.js +368 -239
  389. package/dist/tool-execution.js.map +1 -1
  390. package/dist/turn-media.d.ts +29 -0
  391. package/dist/turn-media.d.ts.map +1 -0
  392. package/dist/turn-media.js +233 -0
  393. package/dist/turn-media.js.map +1 -0
  394. package/dist/usage-reconciliation.d.ts +1 -1
  395. package/dist/usage-reconciliation.js +1 -1
  396. package/dist/workspace-id.d.ts +10 -0
  397. package/dist/workspace-id.d.ts.map +1 -0
  398. package/dist/workspace-id.js +55 -0
  399. package/dist/workspace-id.js.map +1 -0
  400. package/dist/workspace-manifest.d.ts +24 -0
  401. package/dist/workspace-manifest.d.ts.map +1 -0
  402. package/dist/workspace-manifest.js +111 -0
  403. package/dist/workspace-manifest.js.map +1 -0
  404. package/dist/workspace-operation-limiter.d.ts +16 -0
  405. package/dist/workspace-operation-limiter.d.ts.map +1 -0
  406. package/dist/workspace-operation-limiter.js +31 -0
  407. package/dist/workspace-operation-limiter.js.map +1 -0
  408. package/dist/workspace-operations.d.ts +145 -0
  409. package/dist/workspace-operations.d.ts.map +1 -0
  410. package/dist/workspace-operations.js +420 -0
  411. package/dist/workspace-operations.js.map +1 -0
  412. package/dist/workspace-runtime.d.ts +110 -0
  413. package/dist/workspace-runtime.d.ts.map +1 -0
  414. package/dist/workspace-runtime.js +240 -0
  415. package/dist/workspace-runtime.js.map +1 -0
  416. package/dist/workspace-search.d.ts +55 -0
  417. package/dist/workspace-search.d.ts.map +1 -0
  418. package/dist/workspace-search.js +262 -0
  419. package/dist/workspace-search.js.map +1 -0
  420. package/dist/workspace-service.d.ts +173 -0
  421. package/dist/workspace-service.d.ts.map +1 -0
  422. package/dist/workspace-service.js +619 -0
  423. package/dist/workspace-service.js.map +1 -0
  424. package/dist/workspace.d.ts +7 -0
  425. package/dist/workspace.d.ts.map +1 -0
  426. package/dist/workspace.js +7 -0
  427. package/dist/workspace.js.map +1 -0
  428. package/package.json +7 -4
  429. package/dist/agent-harness.d.ts +0 -108
  430. package/dist/agent-harness.d.ts.map +0 -1
  431. package/dist/agent-harness.js +0 -2
  432. package/dist/agent-harness.js.map +0 -1
  433. package/dist/attachments-legacy.d.ts +0 -17
  434. package/dist/attachments-legacy.d.ts.map +0 -1
  435. package/dist/attachments-legacy.js +0 -273
  436. package/dist/attachments-legacy.js.map +0 -1
  437. package/dist/code-mode.d.ts +0 -20
  438. package/dist/code-mode.d.ts.map +0 -1
  439. package/dist/code-mode.js +0 -658
  440. package/dist/code-mode.js.map +0 -1
  441. package/dist/hook-dispatch.d.ts +0 -19
  442. package/dist/hook-dispatch.d.ts.map +0 -1
  443. package/dist/hook-dispatch.js +0 -37
  444. package/dist/hook-dispatch.js.map +0 -1
  445. package/dist/pi-agent-harness.d.ts +0 -40
  446. package/dist/pi-agent-harness.d.ts.map +0 -1
  447. package/dist/pi-agent-harness.js +0 -222
  448. package/dist/pi-agent-harness.js.map +0 -1
  449. package/dist/pi-harness.d.ts +0 -42
  450. package/dist/pi-harness.d.ts.map +0 -1
  451. package/dist/pi-harness.js +0 -142
  452. package/dist/pi-harness.js.map +0 -1
  453. package/dist/run-resolver.d.ts +0 -35
  454. package/dist/run-resolver.d.ts.map +0 -1
  455. package/dist/run-resolver.js +0 -84
  456. package/dist/run-resolver.js.map +0 -1
  457. package/dist/usage-budget.d.ts +0 -29
  458. package/dist/usage-budget.d.ts.map +0 -1
  459. package/dist/usage-budget.js +0 -145
  460. package/dist/usage-budget.js.map +0 -1
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 OpenEve contributors
3
+ Copyright (c) 2026 Assembly Line contributors
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
@@ -0,0 +1,22 @@
1
+ import { type AgentCard } from "@a2a-js/sdk";
2
+ import type { CompiledConnection, JsonObject } from "@assemblyline-agents/core";
3
+ import type { ConnectionToolMetadata } from "./connection-stores.js";
4
+ import type { ConnectionClient, ResolvedConnection } from "./connection-clients.js";
5
+ import type { RuntimeConnectionRegistry } from "./connections.js";
6
+ export declare class A2AConnectionClient implements ConnectionClient {
7
+ private readonly compiled;
8
+ private readonly resolve;
9
+ private readonly registry;
10
+ private client;
11
+ private card;
12
+ private tools;
13
+ private metadata;
14
+ constructor(compiled: CompiledConnection, resolve: () => Promise<ResolvedConnection>, registry: RuntimeConnectionRegistry);
15
+ getToolMetadata(): Promise<ConnectionToolMetadata[]>;
16
+ executeTool(toolName: string, args: unknown): Promise<unknown>;
17
+ close(): Promise<void>;
18
+ private ensureClient;
19
+ private buildMetadata;
20
+ }
21
+ export declare function serializeAgentCard(card: AgentCard): JsonObject;
22
+ //# sourceMappingURL=a2a-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"a2a-client.d.ts","sourceRoot":"","sources":["../src/a2a-client.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,SAAS,EAGf,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAA2B,kBAAkB,EAAE,UAAU,EAAc,MAAM,2BAA2B,CAAC;AAErH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAiBlE,qBAAa,mBAAoB,YAAW,gBAAgB;IAOxD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,QAAQ,CAAuC;gBAGpC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EAC1C,QAAQ,EAAE,yBAAyB;IAGhD,eAAe,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAKpD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA+D9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,YAAY;IAiC1B,OAAO,CAAC,aAAa;CAgBtB;AAmED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAE9D"}
@@ -0,0 +1,211 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { AgentCard as AgentCardCodec, Message as MessageCodec, Role, Task as TaskCodec, TaskState } from "@a2a-js/sdk";
3
+ import { ClientFactory, DefaultAgentCardResolver, JsonRpcTransportFactory } from "@a2a-js/sdk/client";
4
+ import { ConnectionAuthorizationRequiredError } from "@assemblyline-agents/core";
5
+ import { connectionToolAccess, isRecord, passesFilter, qualifiedConnectionToolName } from "./connection-util.js";
6
+ const TASK_TOOL_NAMES = new Set(["get_task", "list_tasks", "cancel_task"]);
7
+ export class A2AConnectionClient {
8
+ compiled;
9
+ resolve;
10
+ registry;
11
+ client;
12
+ card;
13
+ tools;
14
+ metadata;
15
+ constructor(compiled, resolve, registry) {
16
+ this.compiled = compiled;
17
+ this.resolve = resolve;
18
+ this.registry = registry;
19
+ }
20
+ async getToolMetadata() {
21
+ await this.ensureClient();
22
+ return this.metadata ?? [];
23
+ }
24
+ async executeTool(toolName, args) {
25
+ const client = await this.ensureClient();
26
+ const input = isRecord(args) ? args : {};
27
+ if (toolName === "get_task") {
28
+ if (!input.id)
29
+ throw new Error("get_task requires id.");
30
+ return serializeTask(await client.getTask({ tenant: "", id: input.id, historyLength: input.historyLength }));
31
+ }
32
+ if (toolName === "list_tasks") {
33
+ const result = await client.listTasks({
34
+ tenant: "",
35
+ contextId: input.contextId ?? "",
36
+ status: TaskState.TASK_STATE_UNSPECIFIED,
37
+ pageSize: input.pageSize,
38
+ pageToken: input.pageToken ?? "",
39
+ historyLength: input.historyLength,
40
+ statusTimestampAfter: undefined,
41
+ includeArtifacts: true
42
+ });
43
+ return {
44
+ tasks: result.tasks.map(serializeTask),
45
+ nextPageToken: result.nextPageToken,
46
+ pageSize: result.pageSize,
47
+ totalSize: result.totalSize
48
+ };
49
+ }
50
+ if (toolName === "cancel_task") {
51
+ if (!input.id)
52
+ throw new Error("cancel_task requires id.");
53
+ return serializeTask(await client.cancelTask({ tenant: "", id: input.id, metadata: undefined }));
54
+ }
55
+ const skillId = this.tools?.get(toolName);
56
+ if (!skillId)
57
+ throw new Error(`A2A skill tool ${toolName} was not advertised by ${this.compiled.name}.`);
58
+ if (!input.message?.trim() && input.data === undefined)
59
+ throw new Error(`${toolName} requires message or data.`);
60
+ const parts = [];
61
+ if (input.message?.trim()) {
62
+ parts.push({ content: { $case: "text", value: input.message.trim() }, metadata: undefined, filename: "", mediaType: "text/plain" });
63
+ }
64
+ if (input.data !== undefined) {
65
+ parts.push({ content: { $case: "data", value: input.data }, metadata: undefined, filename: "", mediaType: "application/json" });
66
+ }
67
+ const message = {
68
+ messageId: randomUUID(),
69
+ contextId: input.contextId ?? "",
70
+ taskId: input.taskId ?? "",
71
+ role: Role.ROLE_USER,
72
+ parts,
73
+ metadata: { ...(input.metadata ?? {}), skillId },
74
+ extensions: [],
75
+ referenceTaskIds: []
76
+ };
77
+ const result = await client.sendMessage({
78
+ tenant: "",
79
+ message,
80
+ configuration: {
81
+ acceptedOutputModes: this.card?.defaultOutputModes ?? ["text/plain", "application/json"],
82
+ taskPushNotificationConfig: undefined,
83
+ historyLength: input.historyLength,
84
+ returnImmediately: input.returnImmediately === true
85
+ },
86
+ metadata: { skillId }
87
+ });
88
+ return "id" in result ? serializeTask(result) : serializeMessage(result);
89
+ }
90
+ async close() {
91
+ this.client = undefined;
92
+ this.card = undefined;
93
+ this.tools = undefined;
94
+ this.metadata = undefined;
95
+ }
96
+ async ensureClient() {
97
+ if (this.client)
98
+ return this.client;
99
+ const resolved = await this.resolve();
100
+ const definition = resolved.definition;
101
+ const fetchImpl = async (input, init = {}) => {
102
+ const connectionHeaders = await this.registry.resolveHeaders(this.compiled, definition);
103
+ const headers = new Headers(init.headers);
104
+ for (const [name, value] of Object.entries(connectionHeaders))
105
+ headers.set(name, value);
106
+ const response = await this.registry.request(input, { ...init, headers });
107
+ if (response.status === 401) {
108
+ await this.registry.evictToken(this.compiled, definition);
109
+ throw new ConnectionAuthorizationRequiredError(this.compiled.name, {
110
+ reason: "token_rejected",
111
+ message: `A2A peer ${this.compiled.name} rejected the current credential.`
112
+ });
113
+ }
114
+ return response;
115
+ };
116
+ const cardUrl = new URL(definition.agentCardUrl);
117
+ const resolver = new DefaultAgentCardResolver({ fetchImpl });
118
+ const card = await resolver.resolve(cardUrl.origin, `${cardUrl.pathname}${cardUrl.search}`);
119
+ validateAdvertisedOrigins(card, definition, cardUrl.origin);
120
+ const factory = new ClientFactory({
121
+ transports: [new JsonRpcTransportFactory({ fetchImpl })],
122
+ preferredTransports: ["JSONRPC"],
123
+ cardResolver: resolver
124
+ });
125
+ this.card = card;
126
+ this.client = await factory.createFromAgentCard(card);
127
+ this.buildMetadata(card, definition);
128
+ return this.client;
129
+ }
130
+ buildMetadata(card, definition) {
131
+ this.tools = new Map();
132
+ this.metadata = [];
133
+ const used = new Set(TASK_TOOL_NAMES);
134
+ for (const skill of card.skills) {
135
+ if (!passesFilter(skill.id, definition.skills) || connectionToolAccess(skill.id, definition.access) === "none")
136
+ continue;
137
+ const name = uniqueToolName(skill.id, used);
138
+ used.add(name);
139
+ this.tools.set(name, skill.id);
140
+ this.metadata.push(toolMetadata(this.compiled.name, name, skill.description || skill.name, sendInputSchema(skill.examples)));
141
+ }
142
+ for (const [name, description, schema] of taskTools()) {
143
+ if (connectionToolAccess(name, definition.access) === "none")
144
+ continue;
145
+ this.metadata.push(toolMetadata(this.compiled.name, name, description, schema));
146
+ }
147
+ }
148
+ }
149
+ function validateAdvertisedOrigins(card, definition, cardOrigin) {
150
+ const allowed = new Set(definition.allowedOrigins ?? [cardOrigin]);
151
+ for (const iface of card.supportedInterfaces) {
152
+ const url = new URL(iface.url);
153
+ if (!allowed.has(url.origin)) {
154
+ throw new Error(`A2A Agent Card for ${card.name} advertised non-allowlisted origin ${url.origin}.`);
155
+ }
156
+ if (url.protocol !== "https:" && url.hostname !== "localhost" && url.hostname !== "127.0.0.1") {
157
+ throw new Error(`A2A Agent Card for ${card.name} advertised an insecure interface URL.`);
158
+ }
159
+ }
160
+ }
161
+ function uniqueToolName(skillId, used) {
162
+ const base = skillId.toLowerCase().replace(/[^a-z0-9_-]+/gu, "_").replace(/^_+|_+$/gu, "") || "delegate";
163
+ let candidate = base;
164
+ let suffix = 2;
165
+ while (used.has(candidate))
166
+ candidate = `${base}_${suffix++}`;
167
+ return candidate;
168
+ }
169
+ function toolMetadata(connection, name, description, inputSchema) {
170
+ return { connection, name, qualifiedName: qualifiedConnectionToolName(connection, name), description, inputSchema };
171
+ }
172
+ function sendInputSchema(examples) {
173
+ return {
174
+ type: "object",
175
+ additionalProperties: false,
176
+ properties: {
177
+ message: { type: "string", description: "Natural-language task or follow-up for the remote agent." },
178
+ data: { description: "Optional structured A2A data part." },
179
+ contextId: { type: "string", description: "Existing A2A context id for a related task." },
180
+ taskId: { type: "string", description: "Existing A2A task id for a follow-up turn." },
181
+ metadata: { type: "object", additionalProperties: true },
182
+ returnImmediately: { type: "boolean", description: "Return a submitted task instead of waiting for completion." },
183
+ historyLength: { type: "integer", minimum: 0 }
184
+ },
185
+ anyOf: [{ required: ["message"] }, { required: ["data"] }],
186
+ ...(examples.length > 0 ? { description: `Examples: ${examples.join("; ")}` } : {})
187
+ };
188
+ }
189
+ function taskTools() {
190
+ return [
191
+ ["get_task", "Get the current state, history, and artifacts for an A2A task.", {
192
+ type: "object", additionalProperties: false, required: ["id"], properties: { id: { type: "string" }, historyLength: { type: "integer", minimum: 0 } }
193
+ }],
194
+ ["list_tasks", "List A2A tasks visible through this peer connection.", {
195
+ type: "object", additionalProperties: false, properties: { contextId: { type: "string" }, pageSize: { type: "integer", minimum: 1, maximum: 100 }, pageToken: { type: "string" }, historyLength: { type: "integer", minimum: 0 } }
196
+ }],
197
+ ["cancel_task", "Cancel an active A2A task.", {
198
+ type: "object", additionalProperties: false, required: ["id"], properties: { id: { type: "string" } }
199
+ }]
200
+ ];
201
+ }
202
+ function serializeTask(task) {
203
+ return TaskCodec.toJSON(task);
204
+ }
205
+ function serializeMessage(message) {
206
+ return MessageCodec.toJSON(message);
207
+ }
208
+ export function serializeAgentCard(card) {
209
+ return AgentCardCodec.toJSON(card);
210
+ }
211
+ //# sourceMappingURL=a2a-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"a2a-client.js","sourceRoot":"","sources":["../src/a2a-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import { type ResolvedAgentCapabilities, type SerializableAgentCapabilities } from "@assemblyline-agents/core";
2
+ import type { BlobAdapter } from "./runtime-types.js";
3
+ import type { CheckpointRecord, ResolvedStateAdapter } from "./state.js";
4
+ export type CapabilityResolutionReason = "run_start" | "state_changed" | "recovery";
5
+ export interface AgentCapabilitySnapshot {
6
+ id: string;
7
+ hash: string;
8
+ sequence: number;
9
+ stateRevision: number;
10
+ reason: CapabilityResolutionReason;
11
+ declaration: ResolvedAgentCapabilities;
12
+ serializable: SerializableAgentCapabilities;
13
+ checkpointId: string;
14
+ }
15
+ export interface PersistCapabilitySnapshotOptions {
16
+ state: ResolvedStateAdapter;
17
+ blob: BlobAdapter;
18
+ runId: string;
19
+ declaration: ResolvedAgentCapabilities;
20
+ sequence: number;
21
+ stateRevision: number;
22
+ reason: CapabilityResolutionReason;
23
+ createCheckpoint(input: Omit<CheckpointRecord, "id" | "createdAt">): Promise<CheckpointRecord>;
24
+ }
25
+ export declare function capabilitySnapshotMaterial(declaration: ResolvedAgentCapabilities): {
26
+ serializable: SerializableAgentCapabilities;
27
+ encoded: string;
28
+ hash: string;
29
+ };
30
+ /** Persist the complete declaration, then append the safe audit event before callers apply it. */
31
+ export declare function persistCapabilitySnapshot(options: PersistCapabilitySnapshotOptions): Promise<AgentCapabilitySnapshot>;
32
+ //# sourceMappingURL=agent-capability-snapshot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-capability-snapshot.d.ts","sourceRoot":"","sources":["../src/agent-capability-snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,MAAM,0BAA0B,GAAG,WAAW,GAAG,eAAe,GAAG,UAAU,CAAC;AAEpF,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,0BAA0B,CAAC;IACnC,WAAW,EAAE,yBAAyB,CAAC;IACvC,YAAY,EAAE,6BAA6B,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,oBAAoB,CAAC;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,yBAAyB,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,0BAA0B,CAAC;IACnC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAChG;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,yBAAyB,GAAG;IAClF,YAAY,EAAE,6BAA6B,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAQA;AAED,kGAAkG;AAClG,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,uBAAuB,CAAC,CAwDlC"}
@@ -0,0 +1,77 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { serializableAgentCapabilities } from "@assemblyline-agents/core";
3
+ export function capabilitySnapshotMaterial(declaration) {
4
+ const serializable = serializableAgentCapabilities(declaration);
5
+ const encoded = stableJson(serializable);
6
+ return {
7
+ serializable,
8
+ encoded,
9
+ hash: createHash("sha256").update(encoded).digest("hex")
10
+ };
11
+ }
12
+ /** Persist the complete declaration, then append the safe audit event before callers apply it. */
13
+ export async function persistCapabilitySnapshot(options) {
14
+ const id = randomUUID();
15
+ const { serializable, encoded, hash } = capabilitySnapshotMaterial(options.declaration);
16
+ const blob = await options.blob.put(`capabilities/${options.runId}/${String(options.sequence).padStart(6, "0")}-${hash}.json`, encoded, "application/json");
17
+ const checkpoint = await options.createCheckpoint({
18
+ runId: options.runId,
19
+ name: "agent.capability_snapshot",
20
+ data: {
21
+ snapshotId: id,
22
+ hash,
23
+ sequence: options.sequence,
24
+ stateRevision: options.stateRevision,
25
+ reason: options.reason,
26
+ blobKey: blob.key,
27
+ declaration: serializable
28
+ }
29
+ });
30
+ const instructionText = options.declaration.instructions.join("\n\n");
31
+ const outputSchemaText = options.declaration.outputSchema === undefined
32
+ ? ""
33
+ : stableJson(options.declaration.outputSchema);
34
+ const data = {
35
+ snapshotId: id,
36
+ sha256: hash,
37
+ checkpointId: checkpoint.id,
38
+ evaluationSequence: options.sequence,
39
+ reason: options.reason,
40
+ stateRevision: options.stateRevision,
41
+ model: options.declaration.model,
42
+ reasoning: options.declaration.reasoning ?? null,
43
+ tools: options.declaration.tools,
44
+ skills: options.declaration.skills,
45
+ connections: options.declaration.connections,
46
+ subagents: options.declaration.subagents,
47
+ sandbox: options.declaration.sandbox ?? null,
48
+ instructionHash: createHash("sha256").update(instructionText).digest("hex"),
49
+ instructionChars: instructionText.length,
50
+ outputSchemaHash: createHash("sha256").update(outputSchemaText).digest("hex"),
51
+ outputSchemaChars: outputSchemaText.length,
52
+ eventTypes: options.declaration.events.map((event) => event.type)
53
+ };
54
+ await options.state.appendEvent(options.runId, "run.capabilities_resolved", data);
55
+ return {
56
+ id,
57
+ hash,
58
+ sequence: options.sequence,
59
+ stateRevision: options.stateRevision,
60
+ reason: options.reason,
61
+ declaration: options.declaration,
62
+ serializable,
63
+ checkpointId: checkpoint.id
64
+ };
65
+ }
66
+ function stableJson(value) {
67
+ if (Array.isArray(value))
68
+ return `[${value.map(stableJson).join(",")}]`;
69
+ if (value && typeof value === "object") {
70
+ return `{${Object.entries(value)
71
+ .sort(([left], [right]) => left.localeCompare(right))
72
+ .map(([key, child]) => `${JSON.stringify(key)}:${stableJson(child)}`)
73
+ .join(",")}}`;
74
+ }
75
+ return JSON.stringify(value);
76
+ }
77
+ //# sourceMappingURL=agent-capability-snapshot.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-capability-snapshot.js","sourceRoot":"","sources":["../src/agent-capability-snapshot.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { AgentEventHandler, JsonObject } from "@assemblyline-agents/core";
2
+ import type { RuntimeLogger } from "./logging.js";
3
+ import type { RunStreamEvent } from "./run-stream.js";
4
+ export interface RegisteredAgentEventHandler {
5
+ type: string;
6
+ handler: AgentEventHandler;
7
+ hook?: string;
8
+ }
9
+ /** Per-run replaceable observer registry. Exact handlers run before wildcards. */
10
+ export declare class AgentEventHandlerRegistry {
11
+ private readonly agentName;
12
+ private readonly appendEvent;
13
+ private readonly logger;
14
+ private readonly registrations;
15
+ private readonly dispatchingFailures;
16
+ constructor(agentName: string, appendEvent: (runId: string, type: string, data: JsonObject) => Promise<unknown>, logger: RuntimeLogger);
17
+ replace(runId: string, handlers: RegisteredAgentEventHandler[]): void;
18
+ remove(runId: string): void;
19
+ dispatch(runId: string, event: RunStreamEvent): Promise<void>;
20
+ }
21
+ //# sourceMappingURL=agent-event-handlers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-event-handlers.d.ts","sourceRoot":"","sources":["../src/agent-event-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,qBAAa,yBAAyB;IAKlC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoD;IAClF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;gBAGtC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,EAChF,MAAM,EAAE,aAAa;IAGxC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAA2B,EAAE,GAAG,IAAI;IAIrE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CA4CpE"}
@@ -0,0 +1,64 @@
1
+ /** Per-run replaceable observer registry. Exact handlers run before wildcards. */
2
+ export class AgentEventHandlerRegistry {
3
+ agentName;
4
+ appendEvent;
5
+ logger;
6
+ registrations = new Map();
7
+ dispatchingFailures = new Set();
8
+ constructor(agentName, appendEvent, logger) {
9
+ this.agentName = agentName;
10
+ this.appendEvent = appendEvent;
11
+ this.logger = logger;
12
+ }
13
+ replace(runId, handlers) {
14
+ this.registrations.set(runId, [...handlers]);
15
+ }
16
+ remove(runId) {
17
+ this.registrations.delete(runId);
18
+ }
19
+ async dispatch(runId, event) {
20
+ const registered = this.registrations.get(runId) ?? [];
21
+ const ordered = [
22
+ ...registered.filter((item) => item.type === event.type),
23
+ ...registered.filter((item) => item.type === "*")
24
+ ];
25
+ for (const item of ordered) {
26
+ try {
27
+ await item.handler({
28
+ type: event.type,
29
+ timestamp: event.timestamp,
30
+ data: event.data,
31
+ ...(event.sequence !== undefined ? { sequence: event.sequence } : {})
32
+ }, {
33
+ runId,
34
+ agent: { name: this.agentName },
35
+ ...(item.hook ? { hook: { name: item.hook } } : {})
36
+ });
37
+ }
38
+ catch (error) {
39
+ this.logger.warn("agent.event_handler_failed", {
40
+ runId,
41
+ eventType: event.type,
42
+ handlerType: item.type,
43
+ ...(item.hook ? { hook: item.hook } : {}),
44
+ error: error instanceof Error ? error.message : String(error)
45
+ });
46
+ if (event.type === "agent.event_handler_failed" || this.dispatchingFailures.has(runId))
47
+ continue;
48
+ this.dispatchingFailures.add(runId);
49
+ try {
50
+ await this.appendEvent(runId, "agent.event_handler_failed", {
51
+ eventType: event.type,
52
+ handlerType: item.type,
53
+ ...(item.hook ? { hook: item.hook } : {}),
54
+ error: error instanceof Error ? error.message : String(error)
55
+ });
56
+ }
57
+ finally {
58
+ this.dispatchingFailures.delete(runId);
59
+ }
60
+ }
61
+ }
62
+ }
63
+ }
64
+ //# sourceMappingURL=agent-event-handlers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-event-handlers.js","sourceRoot":"","sources":["../src/agent-event-handlers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import { type AgentCapabilityCatalog, type AgentManifest } from "@assemblyline-agents/core";
2
+ import { type AgentSurface } from "./agent-surface.js";
3
+ export declare function hookCapabilityCatalog(manifest: AgentManifest, surface?: AgentSurface): AgentCapabilityCatalog;
4
+ export declare function defaultHookTools(manifest: AgentManifest, surface?: AgentSurface): string[];
5
+ export declare function defaultHookSkills(surface: AgentSurface): string[];
6
+ export declare function defaultHookConnections(surface: AgentSurface): string[];
7
+ export declare function defaultHookSubagents(surface: AgentSurface): string[];
8
+ //# sourceMappingURL=agent-hook-context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-hook-context.d.ts","sourceRoot":"","sources":["../src/agent-hook-context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,YAAyC,GAAG,sBAAsB,CAWzI;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,YAAyC,GAAG,MAAM,EAAE,CAItH;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAEjE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAEtE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAEpE"}
@@ -0,0 +1,29 @@
1
+ import { runtimeToolsForSurface } from "./builtin-tools.js";
2
+ import { rootAgentSurface } from "./agent-surface.js";
3
+ export function hookCapabilityCatalog(manifest, surface = rootAgentSurface(manifest)) {
4
+ const tools = runtimeToolsForSurface(surface.tools);
5
+ return {
6
+ models: new Set(surface.possibleModels),
7
+ tools: new Set(tools.filter((tool) => tool.visibility !== "hidden").map((tool) => tool.name)),
8
+ skills: new Set(surface.skills.map((skill) => skill.name)),
9
+ connections: new Set(surface.connections),
10
+ subagents: new Set(surface.subagents.map((subagent) => subagent.name)),
11
+ sandboxes: new Set(manifest.sandboxes.map((sandbox) => sandbox.name)),
12
+ ...(surface.maxReasoning !== undefined ? { maxReasoning: surface.maxReasoning } : {})
13
+ };
14
+ }
15
+ export function defaultHookTools(manifest, surface = rootAgentSurface(manifest)) {
16
+ return runtimeToolsForSurface(surface.tools)
17
+ .filter((tool) => tool.defaultEnabled && tool.visibility !== "hidden")
18
+ .map((tool) => tool.name);
19
+ }
20
+ export function defaultHookSkills(surface) {
21
+ return surface.skills.map((skill) => skill.name).sort();
22
+ }
23
+ export function defaultHookConnections(surface) {
24
+ return [...surface.connections];
25
+ }
26
+ export function defaultHookSubagents(surface) {
27
+ return surface.subagents.map((subagent) => subagent.name).sort();
28
+ }
29
+ //# sourceMappingURL=agent-hook-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-hook-context.js","sourceRoot":"","sources":["../src/agent-hook-context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAqB,MAAM,oBAAoB,CAAC;AAEzE,MAAM,UAAU,qBAAqB,CAAC,QAAuB,EAAE,UAAwB,gBAAgB,CAAC,QAAQ,CAAC;IAC/G,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO;QACL,MAAM,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC;QACvC,KAAK,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7F,MAAM,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,WAAW,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC;QACzC,SAAS,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtE,SAAS,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrE,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAuB,EAAE,UAAwB,gBAAgB,CAAC,QAAQ,CAAC;IAC1G,OAAO,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC;SACzC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC;SACrE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAqB;IACrD,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAqB;IAC1D,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAqB;IACxD,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACnE,CAAC"}
@@ -0,0 +1,61 @@
1
+ import { type AgentPrincipal, type AgentAudience, type AgentCapabilityCatalog, type CompiledHook, type AgentRunContext, type JsonObject } from "@assemblyline-agents/core";
2
+ import type { AgentEventHandlerRegistry } from "./agent-event-handlers.js";
3
+ import { type AgentSurface } from "./agent-surface.js";
4
+ import { type AgentCapabilitySnapshot, type CapabilityResolutionReason } from "./agent-capability-snapshot.js";
5
+ import type { RuntimeAgentStateHandle } from "./agent-state.js";
6
+ import type { RuntimeLogger } from "./logging.js";
7
+ import type { AgentSourceModuleLoader } from "./source-loader.js";
8
+ import type { AgentManifest } from "@assemblyline-agents/core";
9
+ import type { SourceReference } from "@assemblyline-agents/core";
10
+ import type { BlobAdapter } from "./runtime-types.js";
11
+ import type { CheckpointRecord, ResolvedStateAdapter } from "./state.js";
12
+ export declare class AgentHookEvaluationError extends Error {
13
+ constructor(message: string, options?: ErrorOptions);
14
+ }
15
+ export interface AgentHookRunControllerOptions {
16
+ manifest: AgentManifest;
17
+ agentSource?: SourceReference;
18
+ surface?: AgentSurface;
19
+ catalog?: AgentCapabilityCatalog;
20
+ defaultSkills?: readonly string[];
21
+ state: ResolvedStateAdapter;
22
+ blob: BlobAdapter;
23
+ sourceLoader: AgentSourceModuleLoader;
24
+ agentState: RuntimeAgentStateHandle;
25
+ run: AgentRunContext;
26
+ eventHandlers: AgentEventHandlerRegistry;
27
+ hooks?: readonly CompiledHook[];
28
+ logger: RuntimeLogger;
29
+ disabledTools?: ReadonlySet<string>;
30
+ disabledConnections?: ReadonlySet<string>;
31
+ createCheckpoint(input: Omit<CheckpointRecord, "id" | "createdAt">): Promise<CheckpointRecord>;
32
+ listCheckpoints?(runId: string): Promise<CheckpointRecord[]>;
33
+ }
34
+ /** Owns dirty tracking and atomic replacement of one run's capability snapshot. */
35
+ export declare class AgentHookRunController {
36
+ private readonly options;
37
+ private snapshotValue?;
38
+ private dirtyValue;
39
+ private evaluationSequence;
40
+ private evaluating;
41
+ constructor(options: AgentHookRunControllerOptions);
42
+ get current(): AgentCapabilitySnapshot;
43
+ get dirty(): boolean;
44
+ markDirty(): void;
45
+ evaluate(reason: CapabilityResolutionReason): Promise<AgentCapabilitySnapshot>;
46
+ refreshIfDirty(): Promise<AgentCapabilitySnapshot>;
47
+ private restoreMatchingSnapshot;
48
+ }
49
+ export declare function immutableAgentRunContext(input: {
50
+ id: string;
51
+ message: string;
52
+ channel: string;
53
+ conversationId: string;
54
+ userId?: string;
55
+ principal?: AgentPrincipal;
56
+ initiator?: AgentPrincipal;
57
+ audience?: AgentAudience;
58
+ metadata?: JsonObject;
59
+ attachments?: JsonObject[];
60
+ }): AgentRunContext;
61
+ //# sourceMappingURL=agent-hook-evaluation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-hook-evaluation.d.ts","sourceRoot":"","sources":["../src/agent-hook-evaluation.ts"],"names":[],"mappings":"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"}