@animalabs/agent-framework 0.8.0 → 0.10.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 (204) hide show
  1. package/dist/src/agent.d.ts +11 -1
  2. package/dist/src/agent.d.ts.map +1 -1
  3. package/dist/src/agent.js +33 -3
  4. package/dist/src/agent.js.map +1 -1
  5. package/dist/src/framework.d.ts +184 -18
  6. package/dist/src/framework.d.ts.map +1 -1
  7. package/dist/src/framework.js +1323 -246
  8. package/dist/src/framework.js.map +1 -1
  9. package/dist/src/gate/event-gate.d.ts +73 -7
  10. package/dist/src/gate/event-gate.d.ts.map +1 -1
  11. package/dist/src/gate/event-gate.js +399 -22
  12. package/dist/src/gate/event-gate.js.map +1 -1
  13. package/dist/src/gate/types.d.ts +56 -0
  14. package/dist/src/gate/types.d.ts.map +1 -1
  15. package/dist/src/index.d.ts +1 -0
  16. package/dist/src/index.d.ts.map +1 -1
  17. package/dist/src/index.js +1 -0
  18. package/dist/src/index.js.map +1 -1
  19. package/dist/src/mcpl/capability-grant.d.ts +115 -0
  20. package/dist/src/mcpl/capability-grant.d.ts.map +1 -0
  21. package/dist/src/mcpl/capability-grant.js +291 -0
  22. package/dist/src/mcpl/capability-grant.js.map +1 -0
  23. package/dist/src/mcpl/capability-mask.d.ts +51 -0
  24. package/dist/src/mcpl/capability-mask.d.ts.map +1 -0
  25. package/dist/src/mcpl/capability-mask.js +190 -0
  26. package/dist/src/mcpl/capability-mask.js.map +1 -0
  27. package/dist/src/mcpl/channel-registry.d.ts +3 -1
  28. package/dist/src/mcpl/channel-registry.d.ts.map +1 -1
  29. package/dist/src/mcpl/channel-registry.js +163 -36
  30. package/dist/src/mcpl/channel-registry.js.map +1 -1
  31. package/dist/src/mcpl/checkpoint-manager.d.ts +8 -3
  32. package/dist/src/mcpl/checkpoint-manager.d.ts.map +1 -1
  33. package/dist/src/mcpl/checkpoint-manager.js +28 -8
  34. package/dist/src/mcpl/checkpoint-manager.js.map +1 -1
  35. package/dist/src/mcpl/errors.d.ts +6 -0
  36. package/dist/src/mcpl/errors.d.ts.map +1 -1
  37. package/dist/src/mcpl/errors.js +6 -0
  38. package/dist/src/mcpl/errors.js.map +1 -1
  39. package/dist/src/mcpl/feature-set-manager.d.ts +10 -1
  40. package/dist/src/mcpl/feature-set-manager.d.ts.map +1 -1
  41. package/dist/src/mcpl/feature-set-manager.js +45 -4
  42. package/dist/src/mcpl/feature-set-manager.js.map +1 -1
  43. package/dist/src/mcpl/hook-orchestrator.d.ts +10 -14
  44. package/dist/src/mcpl/hook-orchestrator.d.ts.map +1 -1
  45. package/dist/src/mcpl/hook-orchestrator.js +58 -67
  46. package/dist/src/mcpl/hook-orchestrator.js.map +1 -1
  47. package/dist/src/mcpl/index.d.ts +1 -1
  48. package/dist/src/mcpl/index.d.ts.map +1 -1
  49. package/dist/src/mcpl/index.js.map +1 -1
  50. package/dist/src/mcpl/prose-grammar.d.ts +11 -0
  51. package/dist/src/mcpl/prose-grammar.d.ts.map +1 -1
  52. package/dist/src/mcpl/prose-grammar.js +21 -0
  53. package/dist/src/mcpl/prose-grammar.js.map +1 -1
  54. package/dist/src/mcpl/prose-stream-router.d.ts +11 -2
  55. package/dist/src/mcpl/prose-stream-router.d.ts.map +1 -1
  56. package/dist/src/mcpl/prose-stream-router.js +73 -13
  57. package/dist/src/mcpl/prose-stream-router.js.map +1 -1
  58. package/dist/src/mcpl/push-handler.d.ts.map +1 -1
  59. package/dist/src/mcpl/push-handler.js +20 -2
  60. package/dist/src/mcpl/push-handler.js.map +1 -1
  61. package/dist/src/mcpl/server-connection.d.ts +93 -9
  62. package/dist/src/mcpl/server-connection.d.ts.map +1 -1
  63. package/dist/src/mcpl/server-connection.js +231 -32
  64. package/dist/src/mcpl/server-connection.js.map +1 -1
  65. package/dist/src/mcpl/server-registry.d.ts.map +1 -1
  66. package/dist/src/mcpl/server-registry.js +4 -3
  67. package/dist/src/mcpl/server-registry.js.map +1 -1
  68. package/dist/src/mcpl/tags.d.ts +24 -0
  69. package/dist/src/mcpl/tags.d.ts.map +1 -0
  70. package/dist/src/mcpl/tags.js +52 -0
  71. package/dist/src/mcpl/tags.js.map +1 -0
  72. package/dist/src/mcpl/transport.d.ts.map +1 -1
  73. package/dist/src/mcpl/transport.js +10 -0
  74. package/dist/src/mcpl/transport.js.map +1 -1
  75. package/dist/src/mcpl/types.d.ts +159 -64
  76. package/dist/src/mcpl/types.d.ts.map +1 -1
  77. package/dist/src/mcpl/types.js +16 -2
  78. package/dist/src/mcpl/types.js.map +1 -1
  79. package/dist/src/modules/workspace/index.d.ts +23 -0
  80. package/dist/src/modules/workspace/index.d.ts.map +1 -1
  81. package/dist/src/modules/workspace/index.js +48 -0
  82. package/dist/src/modules/workspace/index.js.map +1 -1
  83. package/dist/src/modules/workspace/sync.d.ts +11 -2
  84. package/dist/src/modules/workspace/sync.d.ts.map +1 -1
  85. package/dist/src/modules/workspace/sync.js +18 -8
  86. package/dist/src/modules/workspace/sync.js.map +1 -1
  87. package/dist/src/refusal-reactions.d.ts +27 -0
  88. package/dist/src/refusal-reactions.d.ts.map +1 -0
  89. package/dist/src/refusal-reactions.js +35 -0
  90. package/dist/src/refusal-reactions.js.map +1 -0
  91. package/dist/src/tool-result-history.d.ts +20 -0
  92. package/dist/src/tool-result-history.d.ts.map +1 -1
  93. package/dist/src/tool-result-history.js +26 -5
  94. package/dist/src/tool-result-history.js.map +1 -1
  95. package/dist/src/types/agent.d.ts +39 -1
  96. package/dist/src/types/agent.d.ts.map +1 -1
  97. package/dist/src/types/framework.d.ts +16 -0
  98. package/dist/src/types/framework.d.ts.map +1 -1
  99. package/dist/src/types/trace.d.ts +24 -0
  100. package/dist/src/types/trace.d.ts.map +1 -1
  101. package/dist/test/channel-registry-routing.test.js +38 -10
  102. package/dist/test/channel-registry-routing.test.js.map +1 -1
  103. package/dist/test/channel-registry-typing.test.js +10 -1
  104. package/dist/test/channel-registry-typing.test.js.map +1 -1
  105. package/dist/test/checkpoint-attribution.test.js +168 -8
  106. package/dist/test/checkpoint-attribution.test.js.map +1 -1
  107. package/dist/test/conversation-fork-injection-scoping.test.js +8 -3
  108. package/dist/test/conversation-fork-injection-scoping.test.js.map +1 -1
  109. package/dist/test/event-gate-passthrough.test.d.ts +15 -0
  110. package/dist/test/event-gate-passthrough.test.d.ts.map +1 -0
  111. package/dist/test/event-gate-passthrough.test.js +289 -0
  112. package/dist/test/event-gate-passthrough.test.js.map +1 -0
  113. package/dist/test/event-gate-selfwake.test.d.ts +15 -0
  114. package/dist/test/event-gate-selfwake.test.d.ts.map +1 -0
  115. package/dist/test/event-gate-selfwake.test.js +125 -0
  116. package/dist/test/event-gate-selfwake.test.js.map +1 -0
  117. package/dist/test/explicit-prose-routing.test.js +137 -7
  118. package/dist/test/explicit-prose-routing.test.js.map +1 -1
  119. package/dist/test/fixtures/awareness-barrier-mcpl-server.mjs +276 -0
  120. package/dist/test/fixtures/flaky-mcpl-server.mjs +41 -0
  121. package/dist/test/machine-close-provenance.test.js +6 -0
  122. package/dist/test/machine-close-provenance.test.js.map +1 -1
  123. package/dist/test/mcpl-awareness-barrier.test.js +10 -0
  124. package/dist/test/mcpl-awareness-barrier.test.js.map +1 -1
  125. package/dist/test/mcpl-capability-grant.test.d.ts +10 -0
  126. package/dist/test/mcpl-capability-grant.test.d.ts.map +1 -0
  127. package/dist/test/mcpl-capability-grant.test.js +109 -0
  128. package/dist/test/mcpl-capability-grant.test.js.map +1 -0
  129. package/dist/test/mcpl-capability-scoping.test.d.ts +2 -0
  130. package/dist/test/mcpl-capability-scoping.test.d.ts.map +1 -0
  131. package/dist/test/mcpl-capability-scoping.test.js +266 -0
  132. package/dist/test/mcpl-capability-scoping.test.js.map +1 -0
  133. package/dist/test/mcpl-gate-roundtrip.test.js +13 -0
  134. package/dist/test/mcpl-gate-roundtrip.test.js.map +1 -1
  135. package/dist/test/mcpl-list-status.test.d.ts +2 -0
  136. package/dist/test/mcpl-list-status.test.d.ts.map +1 -0
  137. package/dist/test/mcpl-list-status.test.js +78 -0
  138. package/dist/test/mcpl-list-status.test.js.map +1 -0
  139. package/dist/test/mcpl-manifest-changed.test.d.ts +2 -0
  140. package/dist/test/mcpl-manifest-changed.test.d.ts.map +1 -0
  141. package/dist/test/mcpl-manifest-changed.test.js +177 -0
  142. package/dist/test/mcpl-manifest-changed.test.js.map +1 -0
  143. package/dist/test/mcpl-reconnect-events.test.js +27 -2
  144. package/dist/test/mcpl-reconnect-events.test.js.map +1 -1
  145. package/dist/test/mcpl-reconnect-reregistration.test.js +53 -17
  146. package/dist/test/mcpl-reconnect-reregistration.test.js.map +1 -1
  147. package/dist/test/mcpl-request-timeout.test.js +1 -1
  148. package/dist/test/mcpl-request-timeout.test.js.map +1 -1
  149. package/dist/test/physical-window-restart.test.d.ts +14 -0
  150. package/dist/test/physical-window-restart.test.d.ts.map +1 -0
  151. package/dist/test/physical-window-restart.test.js +222 -0
  152. package/dist/test/physical-window-restart.test.js.map +1 -0
  153. package/dist/test/present-while-acting.test.js +199 -1
  154. package/dist/test/present-while-acting.test.js.map +1 -1
  155. package/dist/test/prose-stream-router.test.js +43 -0
  156. package/dist/test/prose-stream-router.test.js.map +1 -1
  157. package/dist/test/refusal-reaction-baseline.test.d.ts +2 -0
  158. package/dist/test/refusal-reaction-baseline.test.d.ts.map +1 -0
  159. package/dist/test/refusal-reaction-baseline.test.js +74 -0
  160. package/dist/test/refusal-reaction-baseline.test.js.map +1 -0
  161. package/dist/test/state-scaling-e2e.test.js +7 -1
  162. package/dist/test/state-scaling-e2e.test.js.map +1 -1
  163. package/dist/test/state-scaling.test.js +9 -1
  164. package/dist/test/state-scaling.test.js.map +1 -1
  165. package/dist/test/tool-result-spill.test.d.ts +13 -0
  166. package/dist/test/tool-result-spill.test.d.ts.map +1 -0
  167. package/dist/test/tool-result-spill.test.js +472 -0
  168. package/dist/test/tool-result-spill.test.js.map +1 -0
  169. package/dist/test/trunk-channel-routing.test.js +45 -0
  170. package/dist/test/trunk-channel-routing.test.js.map +1 -1
  171. package/dist/test/xml-round-persist.test.d.ts +19 -0
  172. package/dist/test/xml-round-persist.test.d.ts.map +1 -0
  173. package/dist/test/xml-round-persist.test.js +235 -0
  174. package/dist/test/xml-round-persist.test.js.map +1 -0
  175. package/dist/tsconfig.tsbuildinfo +1 -1
  176. package/package.json +5 -4
  177. package/src/agent.ts +38 -4
  178. package/src/framework.ts +1488 -272
  179. package/src/gate/event-gate.ts +427 -24
  180. package/src/gate/types.ts +58 -0
  181. package/src/index.ts +1 -0
  182. package/src/mcpl/capability-grant.ts +319 -0
  183. package/src/mcpl/capability-mask.ts +228 -0
  184. package/src/mcpl/channel-registry.ts +167 -39
  185. package/src/mcpl/checkpoint-manager.ts +28 -8
  186. package/src/mcpl/errors.ts +7 -0
  187. package/src/mcpl/feature-set-manager.ts +50 -5
  188. package/src/mcpl/hook-orchestrator.ts +64 -86
  189. package/src/mcpl/index.ts +0 -2
  190. package/src/mcpl/prose-grammar.ts +21 -0
  191. package/src/mcpl/prose-stream-router.ts +65 -14
  192. package/src/mcpl/push-handler.ts +18 -2
  193. package/src/mcpl/server-connection.ts +262 -34
  194. package/src/mcpl/server-registry.ts +4 -3
  195. package/src/mcpl/tags.ts +50 -0
  196. package/src/mcpl/transport.ts +11 -0
  197. package/src/mcpl/types.ts +176 -78
  198. package/src/modules/workspace/index.ts +48 -0
  199. package/src/modules/workspace/sync.ts +30 -7
  200. package/src/refusal-reactions.ts +37 -0
  201. package/src/tool-result-history.ts +27 -5
  202. package/src/types/agent.ts +40 -1
  203. package/src/types/framework.ts +17 -0
  204. package/src/types/trace.ts +22 -0
@@ -169,6 +169,19 @@ export type TraceEvent =
169
169
  agentStatus: string;
170
170
  result: unknown;
171
171
  })
172
+ | (TraceEventBase & {
173
+ /**
174
+ * A writable workspace existed but the oversized-result spill write
175
+ * failed (size cap, storeBlob failure, …) — the over-cap tail was NOT
176
+ * retained. Distinct from the no-workspace fallback, which is silent
177
+ * by design (nothing unexpected happened).
178
+ */
179
+ type: 'tool:spill_failed';
180
+ label: string;
181
+ path: string;
182
+ contentLength: number;
183
+ error: string;
184
+ })
172
185
 
173
186
  // Module lifecycle
174
187
  | (TraceEventBase & { type: 'module:added'; moduleName: string })
@@ -339,6 +352,15 @@ export type TraceEvent =
339
352
  /** True when a background reconnect loop will keep retrying. */
340
353
  willRetry: boolean;
341
354
  })
355
+ | (TraceEventBase & {
356
+ /** §17.6: the ONE normalized receipt per manifest change — closed
357
+ * host-derived impact vocabulary, never a server-authored flag. */
358
+ type: 'mcpl:manifest-change-receipt';
359
+ serverId: string;
360
+ revision: string | null;
361
+ announcedDomains: string[];
362
+ impacts: Array<{ impact: string; subject: string; disposition: string }>;
363
+ })
342
364
  | (TraceEventBase & {
343
365
  type: 'mcpl:server-reconnected';
344
366
  serverId: string;