@contractspec/example.agent-console 3.7.6 → 3.8.2

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 (288) hide show
  1. package/.turbo/turbo-build.log +126 -105
  2. package/AGENTS.md +52 -31
  3. package/CHANGELOG.md +29 -0
  4. package/README.md +112 -83
  5. package/dist/agent/agent.event.js +1 -1
  6. package/dist/agent/agent.handler.d.ts +3 -0
  7. package/dist/agent/agent.handler.js +730 -1
  8. package/dist/agent/agent.operation.js +1 -1
  9. package/dist/agent/index.d.ts +5 -5
  10. package/dist/agent/index.js +74 -73
  11. package/dist/agent.feature.js +179 -0
  12. package/dist/browser/agent/agent.event.js +1 -1
  13. package/dist/browser/agent/agent.handler.js +730 -1
  14. package/dist/browser/agent/agent.operation.js +1 -1
  15. package/dist/browser/agent/index.js +74 -73
  16. package/dist/browser/agent.feature.js +179 -0
  17. package/dist/browser/docs/agent-console.docblock.js +11 -8
  18. package/dist/browser/docs/index.js +11 -8
  19. package/dist/browser/example.js +2 -3
  20. package/dist/browser/handlers/agent.handlers.js +1883 -2
  21. package/dist/browser/handlers/index.js +2142 -8
  22. package/dist/browser/index.js +4075 -3161
  23. package/dist/browser/presentations/index.js +51 -51
  24. package/dist/browser/run/index.js +380 -374
  25. package/dist/browser/run/run.event.js +2 -2
  26. package/dist/browser/run/run.handler.js +666 -1
  27. package/dist/browser/run/run.presentation.js +2 -2
  28. package/dist/browser/shared/index.js +293 -1
  29. package/dist/browser/shared/mock-runs.js +5 -0
  30. package/dist/browser/tool/index.js +161 -161
  31. package/dist/browser/tool/tool.event.js +1 -1
  32. package/dist/browser/tool/tool.handler.js +479 -3
  33. package/dist/browser/tool/tool.presentation.js +2 -2
  34. package/dist/browser/ui/AgentDashboard.js +1816 -931
  35. package/dist/browser/ui/AgentDashboard.visualizations.js +217 -0
  36. package/dist/browser/ui/AgentRunList.js +360 -128
  37. package/dist/browser/ui/AgentToolRegistry.js +9 -9
  38. package/dist/browser/ui/hooks/index.js +611 -161
  39. package/dist/browser/ui/hooks/useAgentList.js +1 -1
  40. package/dist/browser/ui/hooks/useAgentMutations.js +444 -9
  41. package/dist/browser/ui/hooks/useRunList.js +26 -11
  42. package/dist/browser/ui/hooks/useToolList.js +1 -1
  43. package/dist/browser/ui/index.js +2161 -1258
  44. package/dist/browser/ui/modals/AgentActionsModal.js +13 -13
  45. package/dist/browser/ui/modals/CreateAgentModal.js +15 -15
  46. package/dist/browser/ui/modals/index.js +297 -297
  47. package/dist/browser/ui/renderers/agent-list.markdown.js +14 -5
  48. package/dist/browser/ui/renderers/agent-list.renderer.js +7 -7
  49. package/dist/browser/ui/renderers/dashboard.markdown.js +207 -36
  50. package/dist/browser/ui/renderers/index.js +359 -163
  51. package/dist/browser/ui/renderers/run-list.markdown.js +9 -4
  52. package/dist/browser/ui/renderers/tool-registry.markdown.js +15 -4
  53. package/dist/browser/ui/views/AgentListView.js +7 -7
  54. package/dist/browser/ui/views/RunDataTable.js +326 -0
  55. package/dist/browser/ui/views/RunListView.js +360 -128
  56. package/dist/browser/ui/views/ToolRegistryView.js +9 -9
  57. package/dist/browser/ui/views/index.js +478 -246
  58. package/dist/browser/ui/views/run-data-table.columns.js +271 -0
  59. package/dist/browser/ui/views/run-list.shared.js +177 -0
  60. package/dist/browser/visualizations/catalog.js +134 -0
  61. package/dist/browser/visualizations/index.js +187 -0
  62. package/dist/browser/visualizations/selectors.js +181 -0
  63. package/dist/docs/agent-console.docblock.js +11 -8
  64. package/dist/docs/index.js +11 -8
  65. package/dist/example.js +2 -3
  66. package/dist/example.test.d.ts +1 -0
  67. package/dist/handlers/agent.handlers.d.ts +2 -0
  68. package/dist/handlers/agent.handlers.js +1883 -2
  69. package/dist/handlers/index.d.ts +2 -4
  70. package/dist/handlers/index.js +2142 -8
  71. package/dist/handlers/mock-handlers.test.d.ts +1 -0
  72. package/dist/index.d.ts +6 -4
  73. package/dist/index.js +4075 -3161
  74. package/dist/node/agent/agent.event.js +1 -1
  75. package/dist/node/agent/agent.handler.js +730 -1
  76. package/dist/node/agent/agent.operation.js +1 -1
  77. package/dist/node/agent/index.js +74 -73
  78. package/dist/node/agent.feature.js +179 -0
  79. package/dist/node/docs/agent-console.docblock.js +11 -8
  80. package/dist/node/docs/index.js +11 -8
  81. package/dist/node/example.js +2 -3
  82. package/dist/node/handlers/agent.handlers.js +1883 -2
  83. package/dist/node/handlers/index.js +2142 -8
  84. package/dist/node/index.js +4075 -3161
  85. package/dist/node/presentations/index.js +51 -51
  86. package/dist/node/run/index.js +380 -374
  87. package/dist/node/run/run.event.js +2 -2
  88. package/dist/node/run/run.handler.js +666 -1
  89. package/dist/node/run/run.presentation.js +2 -2
  90. package/dist/node/shared/index.js +293 -1
  91. package/dist/node/shared/mock-runs.js +5 -0
  92. package/dist/node/tool/index.js +161 -161
  93. package/dist/node/tool/tool.event.js +1 -1
  94. package/dist/node/tool/tool.handler.js +479 -3
  95. package/dist/node/tool/tool.presentation.js +2 -2
  96. package/dist/node/ui/AgentDashboard.js +1816 -931
  97. package/dist/node/ui/AgentDashboard.visualizations.js +217 -0
  98. package/dist/node/ui/AgentRunList.js +360 -128
  99. package/dist/node/ui/AgentToolRegistry.js +9 -9
  100. package/dist/node/ui/hooks/index.js +611 -161
  101. package/dist/node/ui/hooks/useAgentList.js +1 -1
  102. package/dist/node/ui/hooks/useAgentMutations.js +444 -9
  103. package/dist/node/ui/hooks/useRunList.js +26 -11
  104. package/dist/node/ui/hooks/useToolList.js +1 -1
  105. package/dist/node/ui/index.js +2161 -1258
  106. package/dist/node/ui/modals/AgentActionsModal.js +13 -13
  107. package/dist/node/ui/modals/CreateAgentModal.js +15 -15
  108. package/dist/node/ui/modals/index.js +297 -297
  109. package/dist/node/ui/renderers/agent-list.markdown.js +14 -5
  110. package/dist/node/ui/renderers/agent-list.renderer.js +7 -7
  111. package/dist/node/ui/renderers/dashboard.markdown.js +207 -36
  112. package/dist/node/ui/renderers/index.js +359 -163
  113. package/dist/node/ui/renderers/run-list.markdown.js +9 -4
  114. package/dist/node/ui/renderers/tool-registry.markdown.js +15 -4
  115. package/dist/node/ui/views/AgentListView.js +7 -7
  116. package/dist/node/ui/views/RunDataTable.js +326 -0
  117. package/dist/node/ui/views/RunListView.js +360 -128
  118. package/dist/node/ui/views/ToolRegistryView.js +9 -9
  119. package/dist/node/ui/views/index.js +478 -246
  120. package/dist/node/ui/views/run-data-table.columns.js +271 -0
  121. package/dist/node/ui/views/run-list.shared.js +177 -0
  122. package/dist/node/visualizations/catalog.js +134 -0
  123. package/dist/node/visualizations/index.js +187 -0
  124. package/dist/node/visualizations/selectors.js +181 -0
  125. package/dist/presentations/index.d.ts +3 -5
  126. package/dist/presentations/index.js +51 -51
  127. package/dist/proof/index.d.ts +2 -0
  128. package/dist/proof/meetup-proof.d.ts +10 -0
  129. package/dist/proof/meetup-proof.runtime.d.ts +22 -0
  130. package/dist/proof/meetup-proof.scenario.d.ts +2 -0
  131. package/dist/proof/meetup-proof.suite.d.ts +1 -0
  132. package/dist/proof/meetup-proof.test.d.ts +1 -0
  133. package/dist/run/index.d.ts +7 -7
  134. package/dist/run/index.js +380 -374
  135. package/dist/run/run.event.js +2 -2
  136. package/dist/run/run.handler.d.ts +7 -0
  137. package/dist/run/run.handler.js +666 -1
  138. package/dist/run/run.presentation.js +2 -2
  139. package/dist/shared/demo-dashboard-data.d.ts +16 -0
  140. package/dist/shared/demo-runtime-seed.d.ts +17 -0
  141. package/dist/shared/demo-runtime.d.ts +8 -0
  142. package/dist/shared/demo-runtime.test.d.ts +1 -0
  143. package/dist/shared/index.d.ts +4 -1
  144. package/dist/shared/index.js +293 -1
  145. package/dist/shared/mock-runs.d.ts +4 -0
  146. package/dist/shared/mock-runs.js +5 -0
  147. package/dist/tool/index.d.ts +7 -7
  148. package/dist/tool/index.js +161 -161
  149. package/dist/tool/tool.event.js +1 -1
  150. package/dist/tool/tool.handler.d.ts +3 -0
  151. package/dist/tool/tool.handler.js +479 -3
  152. package/dist/tool/tool.presentation.js +2 -2
  153. package/dist/ui/AgentDashboard.js +1816 -931
  154. package/dist/ui/AgentDashboard.sandbox.test.d.ts +1 -0
  155. package/dist/ui/AgentDashboard.visualizations.d.ts +4 -0
  156. package/dist/ui/AgentDashboard.visualizations.js +218 -0
  157. package/dist/ui/AgentRunList.js +360 -128
  158. package/dist/ui/AgentToolRegistry.js +9 -9
  159. package/dist/ui/hooks/index.d.ts +4 -4
  160. package/dist/ui/hooks/index.js +611 -161
  161. package/dist/ui/hooks/useAgentList.d.ts +5 -0
  162. package/dist/ui/hooks/useAgentList.js +1 -1
  163. package/dist/ui/hooks/useAgentMutations.d.ts +9 -2
  164. package/dist/ui/hooks/useAgentMutations.js +444 -9
  165. package/dist/ui/hooks/useRunList.d.ts +13 -2
  166. package/dist/ui/hooks/useRunList.js +26 -11
  167. package/dist/ui/hooks/useToolList.d.ts +5 -0
  168. package/dist/ui/hooks/useToolList.js +1 -1
  169. package/dist/ui/index.d.ts +3 -3
  170. package/dist/ui/index.js +2161 -1258
  171. package/dist/ui/modals/AgentActionsModal.js +13 -13
  172. package/dist/ui/modals/CreateAgentModal.js +15 -15
  173. package/dist/ui/modals/index.d.ts +1 -1
  174. package/dist/ui/modals/index.js +297 -297
  175. package/dist/ui/renderers/agent-list.markdown.d.ts +5 -0
  176. package/dist/ui/renderers/agent-list.markdown.js +14 -5
  177. package/dist/ui/renderers/agent-list.renderer.js +7 -7
  178. package/dist/ui/renderers/dashboard.markdown.d.ts +5 -0
  179. package/dist/ui/renderers/dashboard.markdown.js +207 -36
  180. package/dist/ui/renderers/index.d.ts +2 -2
  181. package/dist/ui/renderers/index.js +359 -163
  182. package/dist/ui/renderers/run-list.markdown.d.ts +5 -0
  183. package/dist/ui/renderers/run-list.markdown.js +9 -4
  184. package/dist/ui/renderers/tool-registry.markdown.d.ts +6 -1
  185. package/dist/ui/renderers/tool-registry.markdown.js +15 -4
  186. package/dist/ui/views/AgentListView.js +7 -7
  187. package/dist/ui/views/RunDataTable.d.ts +18 -0
  188. package/dist/ui/views/RunDataTable.js +327 -0
  189. package/dist/ui/views/RunListView.js +360 -128
  190. package/dist/ui/views/ToolRegistryView.js +9 -9
  191. package/dist/ui/views/index.js +478 -246
  192. package/dist/ui/views/run-data-table.columns.d.ts +3 -0
  193. package/dist/ui/views/run-data-table.columns.js +272 -0
  194. package/dist/ui/views/run-list.shared.d.ts +14 -0
  195. package/dist/ui/views/run-list.shared.js +178 -0
  196. package/dist/visualizations/catalog.d.ts +10 -0
  197. package/dist/visualizations/catalog.js +135 -0
  198. package/dist/visualizations/index.d.ts +2 -0
  199. package/dist/visualizations/index.js +188 -0
  200. package/dist/visualizations/selectors.d.ts +3 -0
  201. package/dist/visualizations/selectors.js +182 -0
  202. package/dist/visualizations/selectors.test.d.ts +1 -0
  203. package/package.json +114 -12
  204. package/proofs/agent-console-meetup.replay.json +220 -0
  205. package/src/agent/agent.entity.ts +111 -111
  206. package/src/agent/agent.enum.ts +12 -12
  207. package/src/agent/agent.event.ts +91 -91
  208. package/src/agent/agent.handler.ts +144 -127
  209. package/src/agent/agent.operation.ts +400 -400
  210. package/src/agent/agent.presentation.ts +62 -62
  211. package/src/agent/agent.schema.ts +175 -175
  212. package/src/agent/agent.test-spec.ts +48 -48
  213. package/src/agent/index.ts +46 -51
  214. package/src/agent.capability.ts +11 -11
  215. package/src/agent.feature.ts +134 -131
  216. package/src/docs/agent-console.docblock.ts +52 -49
  217. package/src/example.test.ts +75 -0
  218. package/src/example.ts +34 -35
  219. package/src/handlers/agent.handlers.ts +576 -522
  220. package/src/handlers/index.ts +30 -14
  221. package/src/handlers/mock-handlers.test.ts +77 -0
  222. package/src/index.ts +10 -9
  223. package/src/presentations/index.ts +11 -13
  224. package/src/proof/index.ts +2 -0
  225. package/src/proof/meetup-proof.runtime.ts +196 -0
  226. package/src/proof/meetup-proof.scenario.ts +99 -0
  227. package/src/proof/meetup-proof.suite.ts +29 -0
  228. package/src/proof/meetup-proof.test.ts +28 -0
  229. package/src/proof/meetup-proof.ts +130 -0
  230. package/src/run/index.ts +49 -54
  231. package/src/run/run.entity.ts +137 -137
  232. package/src/run/run.enum.ts +18 -18
  233. package/src/run/run.event.ts +174 -174
  234. package/src/run/run.handler.ts +113 -96
  235. package/src/run/run.operation.ts +474 -474
  236. package/src/run/run.presentation.ts +42 -42
  237. package/src/run/run.schema.ts +126 -126
  238. package/src/run/run.test-spec.ts +48 -48
  239. package/src/seeders/index.ts +21 -21
  240. package/src/shared/demo-dashboard-data.ts +58 -0
  241. package/src/shared/demo-runtime-seed.ts +139 -0
  242. package/src/shared/demo-runtime.test.ts +169 -0
  243. package/src/shared/demo-runtime.ts +260 -0
  244. package/src/shared/index.ts +12 -1
  245. package/src/shared/mock-agents.ts +76 -76
  246. package/src/shared/mock-runs.ts +107 -102
  247. package/src/shared/mock-tools.ts +140 -140
  248. package/src/shared/overlay-types.ts +23 -23
  249. package/src/tool/index.ts +39 -44
  250. package/src/tool/tool.entity.ts +73 -73
  251. package/src/tool/tool.enum.ts +13 -13
  252. package/src/tool/tool.event.ts +80 -80
  253. package/src/tool/tool.handler.ts +124 -107
  254. package/src/tool/tool.operation.ts +328 -328
  255. package/src/tool/tool.presentation.ts +43 -43
  256. package/src/tool/tool.schema.ts +106 -106
  257. package/src/tool/tool.test-spec.ts +48 -48
  258. package/src/ui/AgentDashboard.sandbox.test.tsx +312 -0
  259. package/src/ui/AgentDashboard.tsx +351 -348
  260. package/src/ui/AgentDashboard.visualizations.tsx +35 -0
  261. package/src/ui/hooks/index.ts +7 -7
  262. package/src/ui/hooks/useAgentList.ts +57 -56
  263. package/src/ui/hooks/useAgentMutations.ts +168 -159
  264. package/src/ui/hooks/useRunList.ts +90 -57
  265. package/src/ui/hooks/useToolList.ts +102 -101
  266. package/src/ui/index.ts +6 -9
  267. package/src/ui/modals/AgentActionsModal.tsx +262 -262
  268. package/src/ui/modals/CreateAgentModal.tsx +232 -232
  269. package/src/ui/modals/index.ts +1 -1
  270. package/src/ui/overlays/demo-overlays.ts +52 -52
  271. package/src/ui/renderers/agent-list.markdown.ts +81 -61
  272. package/src/ui/renderers/agent-list.renderer.tsx +14 -14
  273. package/src/ui/renderers/dashboard.markdown.ts +135 -139
  274. package/src/ui/renderers/index.ts +3 -4
  275. package/src/ui/renderers/run-list.markdown.ts +56 -47
  276. package/src/ui/renderers/tool-registry.markdown.ts +79 -66
  277. package/src/ui/views/AgentListView.tsx +90 -90
  278. package/src/ui/views/RunDataTable.tsx +74 -0
  279. package/src/ui/views/RunListView.tsx +84 -158
  280. package/src/ui/views/ToolRegistryView.tsx +113 -113
  281. package/src/ui/views/run-data-table.columns.tsx +102 -0
  282. package/src/ui/views/run-list.shared.tsx +139 -0
  283. package/src/visualizations/catalog.ts +132 -0
  284. package/src/visualizations/index.ts +2 -0
  285. package/src/visualizations/selectors.test.ts +12 -0
  286. package/src/visualizations/selectors.ts +70 -0
  287. package/tsconfig.json +7 -8
  288. package/tsdown.config.js +24 -3
package/.turbo/turbo-build.log CHANGED
@@ -2,68 +2,75 @@ $ contractspec-bun-build prebuild
2
2
  $ bun run prebuild && bun run build:bundle && bun run build:types
3
3
  $ contractspec-bun-build prebuild
4
4
  $ contractspec-bun-build transpile
5
- [contractspec-bun-build] transpile target=bun root=src entries=66 noBundle=false
6
- Bundled 66 modules in 143ms
5
+ [contractspec-bun-build] transpile target=bun root=src entries=73 noBundle=false
6
+ Bundled 79 modules in 127ms
7
7
 
8
8
  ./agent.capability.js 442 bytes (entry point)
9
9
  tool/tool.test-spec.js 1.38 KB (entry point)
10
10
  shared/overlay-types.js 8 bytes (entry point)
11
11
  run/run.test-spec.js 1.37 KB (entry point)
12
12
  seeders/index.js 0.64 KB (entry point)
13
- ./index.js 202.99 KB (entry point)
14
- ui/index.js 78.23 KB (entry point)
15
- ui/views/index.js 22.0 KB (entry point)
16
- ui/renderers/index.js 14.75 KB (entry point)
17
- ui/renderers/agent-list.markdown.js 1.49 KB (entry point)
13
+ ./index.js 233.57 KB (entry point)
14
+ ui/index.js 105.30 KB (entry point)
15
+ ui/views/index.js 27.89 KB (entry point)
16
+ ui/overlays/index.js 1.46 KB (entry point)
17
+ ui/renderers/index.js 21.0 KB (entry point)
18
+ ui/renderers/agent-list.markdown.js 1.83 KB (entry point)
18
19
  ui/renderers/agent-list.renderer.js 5.91 KB (entry point)
19
- ui/renderers/dashboard.markdown.js 4.30 KB (entry point)
20
- ui/renderers/run-list.markdown.js 1.39 KB (entry point)
21
- ui/renderers/tool-registry.markdown.js 1.64 KB (entry point)
20
+ ui/renderers/dashboard.markdown.js 9.57 KB (entry point)
21
+ ui/renderers/run-list.markdown.js 1.62 KB (entry point)
22
+ ui/renderers/tool-registry.markdown.js 1.98 KB (entry point)
22
23
  ui/views/AgentListView.js 5.35 KB (entry point)
23
- ui/modals/index.js 22.57 KB (entry point)
24
- ui/overlays/index.js 1.46 KB (entry point)
24
+ ui/modals/index.js 22.55 KB (entry point)
25
25
  ui/overlays/demo-overlays.js 1.46 KB (entry point)
26
- ui/AgentDashboard.js 63.20 KB (entry point)
26
+ ui/AgentDashboard.js 89.18 KB (entry point)
27
27
  ui/modals/AgentActionsModal.js 12.32 KB (entry point)
28
28
  ui/modals/CreateAgentModal.js 10.18 KB (entry point)
29
- ui/AgentRunList.js 9.39 KB (entry point)
30
- ui/views/RunListView.js 9.33 KB (entry point)
29
+ ui/AgentDashboard.visualizations.js 6.67 KB (entry point)
30
+ ui/AgentRunList.js 15.25 KB (entry point)
31
+ ui/views/RunListView.js 15.20 KB (entry point)
32
+ ui/views/RunDataTable.js 10.33 KB (entry point)
33
+ ui/views/run-data-table.columns.js 8.65 KB (entry point)
34
+ ui/views/run-list.shared.js 5.85 KB (entry point)
31
35
  ui/AgentToolRegistry.js 6.99 KB (entry point)
32
36
  ui/views/ToolRegistryView.js 6.92 KB (entry point)
33
- ui/hooks/index.js 9.30 KB (entry point)
34
- ui/hooks/useRunList.js 1.69 KB (entry point)
37
+ ui/hooks/index.js 23.1 KB (entry point)
38
+ ui/hooks/useAgentMutations.js 16.48 KB (entry point)
39
+ ui/hooks/useRunList.js 2.15 KB (entry point)
35
40
  ui/hooks/useToolList.js 2.52 KB (entry point)
36
41
  ui/hooks/useAgentList.js 1.69 KB (entry point)
37
- ui/hooks/useAgentMutations.js 3.18 KB (entry point)
38
42
  tool/index.js 28.61 KB (entry point)
39
43
  tool/tool.entity.js 2.65 KB (entry point)
40
44
  tool/tool.event.js 3.25 KB (entry point)
41
- tool/tool.operation.js 14.62 KB (entry point)
42
- shared/index.js 9.67 KB (entry point)
45
+ shared/index.js 21.25 KB (entry point)
43
46
  presentations/index.js 25.20 KB (entry point)
44
47
  tool/tool.presentation.js 6.41 KB (entry point)
45
- tool/tool.schema.js 4.94 KB (entry point)
46
- tool/tool.enum.js 0.52 KB (entry point)
47
- run/index.js 43.50 KB (entry point)
48
+ run/index.js 43.70 KB (entry point)
48
49
  run/run.presentation.js 8.0 KB (entry point)
49
50
  run/run.entity.js 5.11 KB (entry point)
50
51
  run/run.event.js 8.26 KB (entry point)
52
+ agent/agent.test-spec.js 1.46 KB (entry point)
53
+ agent/index.js 39.74 KB (entry point)
54
+ docs/index.js 4.20 KB (entry point)
55
+ docs/agent-console.docblock.js 4.20 KB (entry point)
56
+ ./example.js 1.22 KB (entry point)
57
+ handlers/index.js 95.78 KB (entry point)
58
+ tool/tool.handler.js 20.88 KB (entry point)
59
+ run/run.handler.js 28.35 KB (entry point)
60
+ shared/mock-runs.js 3.18 KB (entry point)
61
+ handlers/agent.handlers.js 69.20 KB (entry point)
62
+ tool/tool.operation.js 14.62 KB (entry point)
63
+ tool/tool.schema.js 4.94 KB (entry point)
64
+ tool/tool.enum.js 0.52 KB (entry point)
51
65
  run/run.operation.js 20.69 KB (entry point)
52
66
  run/run.schema.js 6.62 KB (entry point)
53
67
  run/run.enum.js 0.60 KB (entry point)
54
- agent/agent.test-spec.js 1.46 KB (entry point)
55
- agent/index.js 39.69 KB (entry point)
56
- docs/index.js 3.74 KB (entry point)
57
- docs/agent-console.docblock.js 3.74 KB (entry point)
58
- ./example.js 1.25 KB (entry point)
59
- handlers/index.js 25.34 KB (entry point)
60
- tool/tool.handler.js 6.38 KB (entry point)
61
- run/run.handler.js 7.61 KB (entry point)
62
- shared/mock-runs.js 3.0 KB (entry point)
63
- handlers/agent.handlers.js 9.24 KB (entry point)
64
- ./agent.feature.js 4.70 KB (entry point)
68
+ ./agent.feature.js 10.0 KB (entry point)
69
+ visualizations/index.js 5.52 KB (entry point)
70
+ visualizations/selectors.js 5.33 KB (entry point)
71
+ visualizations/catalog.js 3.79 KB (entry point)
65
72
  agent/agent.entity.js 3.92 KB (entry point)
66
- agent/agent.handler.js 8.88 KB (entry point)
73
+ agent/agent.handler.js 33.1 KB (entry point)
67
74
  shared/mock-tools.js 4.15 KB (entry point)
68
75
  shared/mock-agents.js 2.54 KB (entry point)
69
76
  agent/agent.operation.js 24.28 KB (entry point)
@@ -72,68 +79,75 @@ Bundled 66 modules in 143ms
72
79
  agent/agent.schema.js 8.13 KB (entry point)
73
80
  agent/agent.enum.js 467 bytes (entry point)
74
81
 
75
- [contractspec-bun-build] transpile target=node root=src entries=66 noBundle=false
76
- Bundled 66 modules in 111ms
82
+ [contractspec-bun-build] transpile target=node root=src entries=73 noBundle=false
83
+ Bundled 79 modules in 116ms
77
84
 
78
85
  ./agent.capability.js 434 bytes (entry point)
79
86
  tool/tool.test-spec.js 1.38 KB (entry point)
80
87
  shared/overlay-types.js 0 KB (entry point)
81
88
  run/run.test-spec.js 1.36 KB (entry point)
82
89
  seeders/index.js 0.63 KB (entry point)
83
- ./index.js 202.92 KB (entry point)
84
- ui/index.js 78.18 KB (entry point)
85
- ui/views/index.js 22.00 KB (entry point)
86
- ui/renderers/index.js 14.73 KB (entry point)
87
- ui/renderers/agent-list.markdown.js 1.48 KB (entry point)
90
+ ./index.js 233.51 KB (entry point)
91
+ ui/index.js 105.25 KB (entry point)
92
+ ui/views/index.js 27.88 KB (entry point)
93
+ ui/overlays/index.js 1.45 KB (entry point)
94
+ ui/renderers/index.js 21.0 KB (entry point)
95
+ ui/renderers/agent-list.markdown.js 1.83 KB (entry point)
88
96
  ui/renderers/agent-list.renderer.js 5.91 KB (entry point)
89
- ui/renderers/dashboard.markdown.js 4.29 KB (entry point)
90
- ui/renderers/run-list.markdown.js 1.39 KB (entry point)
91
- ui/renderers/tool-registry.markdown.js 1.62 KB (entry point)
97
+ ui/renderers/dashboard.markdown.js 9.56 KB (entry point)
98
+ ui/renderers/run-list.markdown.js 1.61 KB (entry point)
99
+ ui/renderers/tool-registry.markdown.js 1.96 KB (entry point)
92
100
  ui/views/AgentListView.js 5.34 KB (entry point)
93
- ui/modals/index.js 22.54 KB (entry point)
94
- ui/overlays/index.js 1.45 KB (entry point)
101
+ ui/modals/index.js 22.53 KB (entry point)
95
102
  ui/overlays/demo-overlays.js 1.45 KB (entry point)
96
- ui/AgentDashboard.js 63.16 KB (entry point)
103
+ ui/AgentDashboard.js 89.14 KB (entry point)
97
104
  ui/modals/AgentActionsModal.js 12.29 KB (entry point)
98
105
  ui/modals/CreateAgentModal.js 10.17 KB (entry point)
99
- ui/AgentRunList.js 9.38 KB (entry point)
100
- ui/views/RunListView.js 9.32 KB (entry point)
106
+ ui/AgentDashboard.visualizations.js 6.66 KB (entry point)
107
+ ui/AgentRunList.js 15.25 KB (entry point)
108
+ ui/views/RunListView.js 15.19 KB (entry point)
109
+ ui/views/RunDataTable.js 10.32 KB (entry point)
110
+ ui/views/run-data-table.columns.js 8.64 KB (entry point)
111
+ ui/views/run-list.shared.js 5.84 KB (entry point)
101
112
  ui/AgentToolRegistry.js 6.97 KB (entry point)
102
113
  ui/views/ToolRegistryView.js 6.91 KB (entry point)
103
- ui/hooks/index.js 9.29 KB (entry point)
104
- ui/hooks/useRunList.js 1.69 KB (entry point)
114
+ ui/hooks/index.js 23.0 KB (entry point)
115
+ ui/hooks/useAgentMutations.js 16.47 KB (entry point)
116
+ ui/hooks/useRunList.js 2.14 KB (entry point)
105
117
  ui/hooks/useToolList.js 2.51 KB (entry point)
106
118
  ui/hooks/useAgentList.js 1.68 KB (entry point)
107
- ui/hooks/useAgentMutations.js 3.18 KB (entry point)
108
119
  tool/index.js 28.60 KB (entry point)
109
120
  tool/tool.entity.js 2.64 KB (entry point)
110
121
  tool/tool.event.js 3.24 KB (entry point)
111
- tool/tool.operation.js 14.62 KB (entry point)
112
- shared/index.js 9.67 KB (entry point)
122
+ shared/index.js 21.24 KB (entry point)
113
123
  presentations/index.js 25.19 KB (entry point)
114
124
  tool/tool.presentation.js 6.40 KB (entry point)
115
- tool/tool.schema.js 4.93 KB (entry point)
116
- tool/tool.enum.js 0.51 KB (entry point)
117
- run/index.js 43.49 KB (entry point)
125
+ run/index.js 43.69 KB (entry point)
118
126
  run/run.presentation.js 8.0 KB (entry point)
119
127
  run/run.entity.js 5.1 KB (entry point)
120
128
  run/run.event.js 8.25 KB (entry point)
129
+ agent/agent.test-spec.js 1.46 KB (entry point)
130
+ agent/index.js 39.73 KB (entry point)
131
+ docs/index.js 4.18 KB (entry point)
132
+ docs/agent-console.docblock.js 4.18 KB (entry point)
133
+ ./example.js 1.21 KB (entry point)
134
+ handlers/index.js 95.77 KB (entry point)
135
+ tool/tool.handler.js 20.88 KB (entry point)
136
+ run/run.handler.js 28.34 KB (entry point)
137
+ shared/mock-runs.js 3.17 KB (entry point)
138
+ handlers/agent.handlers.js 69.19 KB (entry point)
139
+ tool/tool.operation.js 14.62 KB (entry point)
140
+ tool/tool.schema.js 4.93 KB (entry point)
141
+ tool/tool.enum.js 0.51 KB (entry point)
121
142
  run/run.operation.js 20.68 KB (entry point)
122
143
  run/run.schema.js 6.61 KB (entry point)
123
144
  run/run.enum.js 0.59 KB (entry point)
124
- agent/agent.test-spec.js 1.46 KB (entry point)
125
- agent/index.js 39.68 KB (entry point)
126
- docs/index.js 3.72 KB (entry point)
127
- docs/agent-console.docblock.js 3.72 KB (entry point)
128
- ./example.js 1.24 KB (entry point)
129
- handlers/index.js 25.33 KB (entry point)
130
- tool/tool.handler.js 6.37 KB (entry point)
131
- run/run.handler.js 7.60 KB (entry point)
132
- shared/mock-runs.js 3.0 KB (entry point)
133
- handlers/agent.handlers.js 9.24 KB (entry point)
134
- ./agent.feature.js 4.69 KB (entry point)
145
+ ./agent.feature.js 10.0 KB (entry point)
146
+ visualizations/index.js 5.51 KB (entry point)
147
+ visualizations/selectors.js 5.33 KB (entry point)
148
+ visualizations/catalog.js 3.78 KB (entry point)
135
149
  agent/agent.entity.js 3.92 KB (entry point)
136
- agent/agent.handler.js 8.88 KB (entry point)
150
+ agent/agent.handler.js 33.1 KB (entry point)
137
151
  shared/mock-tools.js 4.14 KB (entry point)
138
152
  shared/mock-agents.js 2.54 KB (entry point)
139
153
  agent/agent.operation.js 24.28 KB (entry point)
@@ -142,68 +156,75 @@ Bundled 66 modules in 111ms
142
156
  agent/agent.schema.js 8.13 KB (entry point)
143
157
  agent/agent.enum.js 459 bytes (entry point)
144
158
 
145
- [contractspec-bun-build] transpile target=browser root=src entries=66 noBundle=false
146
- Bundled 66 modules in 108ms
159
+ [contractspec-bun-build] transpile target=browser root=src entries=73 noBundle=false
160
+ Bundled 79 modules in 97ms
147
161
 
148
162
  ./agent.capability.js 434 bytes (entry point)
149
163
  tool/tool.test-spec.js 1.38 KB (entry point)
150
164
  shared/overlay-types.js 0 KB (entry point)
151
165
  run/run.test-spec.js 1.36 KB (entry point)
152
166
  seeders/index.js 0.63 KB (entry point)
153
- ./index.js 202.92 KB (entry point)
154
- ui/index.js 78.18 KB (entry point)
155
- ui/views/index.js 22.00 KB (entry point)
156
- ui/renderers/index.js 14.73 KB (entry point)
157
- ui/renderers/agent-list.markdown.js 1.48 KB (entry point)
167
+ ./index.js 233.51 KB (entry point)
168
+ ui/index.js 105.25 KB (entry point)
169
+ ui/views/index.js 27.88 KB (entry point)
170
+ ui/overlays/index.js 1.45 KB (entry point)
171
+ ui/renderers/index.js 21.0 KB (entry point)
172
+ ui/renderers/agent-list.markdown.js 1.83 KB (entry point)
158
173
  ui/renderers/agent-list.renderer.js 5.91 KB (entry point)
159
- ui/renderers/dashboard.markdown.js 4.29 KB (entry point)
160
- ui/renderers/run-list.markdown.js 1.39 KB (entry point)
161
- ui/renderers/tool-registry.markdown.js 1.62 KB (entry point)
174
+ ui/renderers/dashboard.markdown.js 9.56 KB (entry point)
175
+ ui/renderers/run-list.markdown.js 1.61 KB (entry point)
176
+ ui/renderers/tool-registry.markdown.js 1.96 KB (entry point)
162
177
  ui/views/AgentListView.js 5.34 KB (entry point)
163
- ui/modals/index.js 22.54 KB (entry point)
164
- ui/overlays/index.js 1.45 KB (entry point)
178
+ ui/modals/index.js 22.53 KB (entry point)
165
179
  ui/overlays/demo-overlays.js 1.45 KB (entry point)
166
- ui/AgentDashboard.js 63.16 KB (entry point)
180
+ ui/AgentDashboard.js 89.14 KB (entry point)
167
181
  ui/modals/AgentActionsModal.js 12.29 KB (entry point)
168
182
  ui/modals/CreateAgentModal.js 10.17 KB (entry point)
169
- ui/AgentRunList.js 9.38 KB (entry point)
170
- ui/views/RunListView.js 9.32 KB (entry point)
183
+ ui/AgentDashboard.visualizations.js 6.66 KB (entry point)
184
+ ui/AgentRunList.js 15.25 KB (entry point)
185
+ ui/views/RunListView.js 15.19 KB (entry point)
186
+ ui/views/RunDataTable.js 10.32 KB (entry point)
187
+ ui/views/run-data-table.columns.js 8.64 KB (entry point)
188
+ ui/views/run-list.shared.js 5.84 KB (entry point)
171
189
  ui/AgentToolRegistry.js 6.97 KB (entry point)
172
190
  ui/views/ToolRegistryView.js 6.91 KB (entry point)
173
- ui/hooks/index.js 9.29 KB (entry point)
174
- ui/hooks/useRunList.js 1.69 KB (entry point)
191
+ ui/hooks/index.js 23.0 KB (entry point)
192
+ ui/hooks/useAgentMutations.js 16.47 KB (entry point)
193
+ ui/hooks/useRunList.js 2.14 KB (entry point)
175
194
  ui/hooks/useToolList.js 2.51 KB (entry point)
176
195
  ui/hooks/useAgentList.js 1.68 KB (entry point)
177
- ui/hooks/useAgentMutations.js 3.18 KB (entry point)
178
196
  tool/index.js 28.60 KB (entry point)
179
197
  tool/tool.entity.js 2.64 KB (entry point)
180
198
  tool/tool.event.js 3.24 KB (entry point)
181
- tool/tool.operation.js 14.62 KB (entry point)
182
- shared/index.js 9.67 KB (entry point)
199
+ shared/index.js 21.24 KB (entry point)
183
200
  presentations/index.js 25.19 KB (entry point)
184
201
  tool/tool.presentation.js 6.40 KB (entry point)
185
- tool/tool.schema.js 4.93 KB (entry point)
186
- tool/tool.enum.js 0.51 KB (entry point)
187
- run/index.js 43.49 KB (entry point)
202
+ run/index.js 43.69 KB (entry point)
188
203
  run/run.presentation.js 8.0 KB (entry point)
189
204
  run/run.entity.js 5.1 KB (entry point)
190
205
  run/run.event.js 8.25 KB (entry point)
206
+ agent/agent.test-spec.js 1.46 KB (entry point)
207
+ agent/index.js 39.73 KB (entry point)
208
+ docs/index.js 4.18 KB (entry point)
209
+ docs/agent-console.docblock.js 4.18 KB (entry point)
210
+ ./example.js 1.21 KB (entry point)
211
+ handlers/index.js 95.77 KB (entry point)
212
+ tool/tool.handler.js 20.88 KB (entry point)
213
+ run/run.handler.js 28.34 KB (entry point)
214
+ shared/mock-runs.js 3.17 KB (entry point)
215
+ handlers/agent.handlers.js 69.19 KB (entry point)
216
+ tool/tool.operation.js 14.62 KB (entry point)
217
+ tool/tool.schema.js 4.93 KB (entry point)
218
+ tool/tool.enum.js 0.51 KB (entry point)
191
219
  run/run.operation.js 20.68 KB (entry point)
192
220
  run/run.schema.js 6.61 KB (entry point)
193
221
  run/run.enum.js 0.59 KB (entry point)
194
- agent/agent.test-spec.js 1.46 KB (entry point)
195
- agent/index.js 39.68 KB (entry point)
196
- docs/index.js 3.72 KB (entry point)
197
- docs/agent-console.docblock.js 3.72 KB (entry point)
198
- ./example.js 1.24 KB (entry point)
199
- handlers/index.js 25.33 KB (entry point)
200
- tool/tool.handler.js 6.37 KB (entry point)
201
- run/run.handler.js 7.60 KB (entry point)
202
- shared/mock-runs.js 3.0 KB (entry point)
203
- handlers/agent.handlers.js 9.24 KB (entry point)
204
- ./agent.feature.js 4.69 KB (entry point)
222
+ ./agent.feature.js 10.0 KB (entry point)
223
+ visualizations/index.js 5.51 KB (entry point)
224
+ visualizations/selectors.js 5.33 KB (entry point)
225
+ visualizations/catalog.js 3.78 KB (entry point)
205
226
  agent/agent.entity.js 3.92 KB (entry point)
206
- agent/agent.handler.js 8.88 KB (entry point)
227
+ agent/agent.handler.js 33.1 KB (entry point)
207
228
  shared/mock-tools.js 4.14 KB (entry point)
208
229
  shared/mock-agents.js 2.54 KB (entry point)
209
230
  agent/agent.operation.js 24.28 KB (entry point)
package/AGENTS.md CHANGED
@@ -1,40 +1,61 @@
1
- # AI Agent Guide -- `@contractspec/example.agent-console`
1
+ # AI Agent Guide — `@contractspec/example.agent-console`
2
2
 
3
3
  Scope: `packages/examples/agent-console/*`
4
4
 
5
- Demonstrates AI agent orchestration with tools, runs, and execution logs using the ContractSpec spec-first pattern.
5
+ Agent Console example - AI agent orchestration with tools, runs, and logs.
6
6
 
7
7
  ## Quick Context
8
8
 
9
- - **Layer**: example
10
- - **Related Packages**: `lib.schema`, `lib.contracts-spec`, `lib.example-shared-ui`, `lib.design-system`, `lib.runtime-sandbox`
11
-
12
- ## What This Demonstrates
13
-
14
- - Agent entity with lifecycle (create, configure, execute)
15
- - Run tracking with status enums and event-driven state transitions
16
- - Tool registry with typed schemas and operation handlers
17
- - Presentation layer with React UI components, hooks, modals, and overlays
18
- - Markdown and React renderers for multi-surface output
19
- - Seeders and mock data for demo scenarios
20
-
21
- ## Public Exports
22
-
23
- - `.` -- root barrel
24
- - `./agent` -- agent entity, enum, event, handler, operation, presentation, schema, test-spec
25
- - `./agent.capability`, `./agent.feature` -- capability and feature definitions
26
- - `./run` -- run entity, enum, event, handler, operation, presentation, schema, test-spec
27
- - `./tool` -- tool entity, enum, event, handler, operation, presentation, schema, test-spec
28
- - `./handlers` -- operation handlers
29
- - `./presentations` -- presentation definitions
30
- - `./seeders`, `./shared` -- mock data and shared types
31
- - `./ui` -- React components, hooks, modals, overlays, renderers, views
32
- - `./docs` -- DocBlock documentation
33
- - `./example` -- runnable example entry point
9
+ - Layer: `example`.
10
+ - Package visibility: published package.
11
+ - Primary consumers are example explorers, template authors, and documentation readers.
12
+ - Related packages: `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, ...
13
+
14
+ ## Architecture
15
+
16
+ - `src/agent` is part of the package's public or composition surface.
17
+ - `src/agent.capability.ts` defines a capability surface.
18
+ - `src/agent.feature.ts` defines a feature entrypoint.
19
+ - `src/docs/` contains docblocks and documentation-facing exports.
20
+ - `src/example.ts` is the runnable example entrypoint.
21
+ - `src/handlers/` contains handlers or demo adapters wired to contract surfaces.
22
+ - `src/index.ts` is the root public barrel and package entrypoint.
23
+
24
+ ## Public Surface
25
+
26
+ - Export `.` resolves through `./src/index.ts`.
27
+ - Export `./agent` resolves through `./src/agent/index.ts`.
28
+ - Export `./agent.capability` resolves through `./src/agent.capability.ts`.
29
+ - Export `./agent.feature` resolves through `./src/agent.feature.ts`.
30
+ - Export `./agent/agent.entity` resolves through `./src/agent/agent.entity.ts`.
31
+ - Export `./agent/agent.enum` resolves through `./src/agent/agent.enum.ts`.
32
+ - Export `./agent/agent.event` resolves through `./src/agent/agent.event.ts`.
33
+ - Export `./agent/agent.handler` resolves through `./src/agent/agent.handler.ts`.
34
+ - Export `./agent/agent.operation` resolves through `./src/agent/agent.operation.ts`.
35
+ - Export `./agent/agent.presentation` resolves through `./src/agent/agent.presentation.ts`.
36
+ - The package publishes 66 total export subpaths; keep docs aligned with `package.json`.
37
+
38
+ ## Guardrails
39
+
40
+ - Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
41
+ - Do not add hidden production assumptions that are not actually implemented in the example.
42
+ - Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, ....
43
+ - Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, ...
34
44
 
35
45
  ## Local Commands
36
46
 
37
- - Build: `bun run build`
38
- - Dev: `bun run dev`
39
- - Test: `bun test`
40
- - Typecheck: `bun run typecheck`
47
+ - `bun run dev` — contractspec-bun-build dev
48
+ - `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
49
+ - `bun run test` — bun test
50
+ - `bun run lint` — bun lint:fix
51
+ - `bun run lint:check` — biome check .
52
+ - `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
53
+ - `bun run typecheck` — tsc --noEmit
54
+ - `bun run proof` — bun ../../../scripts/generate-agent-console-meetup-proof.ts
55
+ - `bun run preflight` — bun run build && bun run typecheck && bun run test && bun ../../../scripts/check-agent-console-meetup-policy.ts && bun run proof
56
+ - `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
57
+ - `bun run publish:pkg:canary` — bun publish:pkg --tag canary
58
+ - `bun run clean` — rimraf dist .turbo
59
+ - `bun run build:bundle` — contractspec-bun-build transpile
60
+ - `bun run build:types` — contractspec-bun-build types
61
+ - `bun run prebuild` — contractspec-bun-build prebuild
package/CHANGELOG.md CHANGED
@@ -1,5 +1,29 @@
1
1
  # @contractspec/example.agent-console
2
2
 
3
+ ## 3.8.2
4
+
5
+ ### Patch Changes
6
+
7
+ - 1a44cb6: feat: improve examples to increase coverage of Contracts type
8
+ - Updated dependencies [1a44cb6]
9
+ - @contractspec/lib.example-shared-ui@6.0.10
10
+ - @contractspec/lib.runtime-sandbox@2.7.9
11
+ - @contractspec/lib.contracts-spec@4.1.2
12
+ - @contractspec/lib.design-system@3.8.3
13
+ - @contractspec/lib.schema@3.7.8
14
+
15
+ ## 3.8.1
16
+
17
+ ### Patch Changes
18
+
19
+ - fix: release
20
+ - Updated dependencies
21
+ - @contractspec/lib.example-shared-ui@6.0.9
22
+ - @contractspec/lib.runtime-sandbox@2.7.8
23
+ - @contractspec/lib.contracts-spec@4.1.1
24
+ - @contractspec/lib.design-system@3.8.2
25
+ - @contractspec/lib.schema@3.7.7
26
+
3
27
  ## 3.7.6
4
28
 
5
29
  ### Patch Changes
@@ -110,6 +134,7 @@
110
134
  ### Patch Changes
111
135
 
112
136
  - 27b77db: feat(ai-models): add latest models and align defaults
137
+
113
138
  - Add claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5, gpt-5.4, gpt-5-mini
114
139
  - Add mistral-large-2512, mistral-medium-2508, mistral-small-2506, devstral-2512
115
140
  - Add gemini-3.1-pro-preview, gemini-3.1-flash-lite-preview, gemini-3-flash-preview
@@ -497,6 +522,7 @@
497
522
  - 7f3203a: fix: make workspace test runs resilient when packages have no tests
498
523
 
499
524
  Updates package test scripts to pass cleanly when no matching test files exist:
525
+
500
526
  - Uses `bun test --pass-with-no-tests` in Bun-based packages that currently ship without test files.
501
527
  - Uses `jest --passWithNoTests` for the UI kit web package.
502
528
  - Adds `.vscode-test.mjs` for `vscode-contractspec` so VS Code extension test runs have an explicit config and stop failing on missing default configuration.
@@ -895,14 +921,17 @@
895
921
  feat: Contract layers support (features, examples, app-configs)
896
922
 
897
923
  ### New CLI Commands
924
+
898
925
  - `contractspec list layers` - List all contract layers with filtering
899
926
 
900
927
  ### Enhanced Commands
928
+
901
929
  - `contractspec ci` - New `layers` check category validates features/examples/config
902
930
  - `contractspec doctor` - New `layers` health checks
903
931
  - `contractspec integrity` - Now shows layer statistics
904
932
 
905
933
  ### New APIs
934
+
906
935
  - `discoverLayers()` - Scan workspace for all layer files
907
936
  - `scanExampleSource()` - Parse ExampleSpec from source code
908
937
  - `isExampleFile()` - Check if file is an example spec