agency-lang 0.17.1 → 0.18.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 (490) hide show
  1. package/dist/lib/agents/agency-agent/agent.agency +27 -20
  2. package/dist/lib/agents/agency-agent/agent.js +158 -177
  3. package/dist/lib/agents/agency-agent/brains/brain.js +2 -0
  4. package/dist/lib/agents/agency-agent/brains/coordinator/README.md +5 -3
  5. package/dist/lib/agents/agency-agent/brains/coordinator/coordinator.agency +67 -17
  6. package/dist/lib/agents/agency-agent/brains/coordinator/coordinator.js +673 -18
  7. package/dist/lib/agents/agency-agent/brains/coordinator/lib/announce.agency +29 -0
  8. package/dist/lib/agents/agency-agent/{tests/threadText.js → brains/coordinator/lib/announce.js} +125 -150
  9. package/dist/lib/agents/agency-agent/brains/coordinator/lib/budgets.agency +60 -0
  10. package/dist/lib/agents/agency-agent/brains/coordinator/lib/budgets.js +874 -0
  11. package/dist/lib/agents/agency-agent/brains/coordinator/prompts/code.md +11 -4
  12. package/dist/lib/agents/agency-agent/brains/coordinator/prompts/codeSample.js +7 -5
  13. package/dist/lib/agents/agency-agent/brains/coordinator/prompts/main-large.md +87 -104
  14. package/dist/lib/agents/agency-agent/brains/coordinator/prompts/main-small.md +41 -10
  15. package/dist/lib/agents/agency-agent/{tests/agentName.js → brains/coordinator/subagents/announce.js} +133 -87
  16. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/brainstorm.js +14 -12
  17. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/code.agency +10 -1
  18. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/code.js +90 -52
  19. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/context.js +533 -0
  20. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/explorer.agency +36 -35
  21. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/explorer.js +162 -94
  22. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/oracle.agency +41 -30
  23. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/oracle.js +167 -89
  24. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/research.agency +31 -21
  25. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/research.js +197 -82
  26. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/review.agency +3 -0
  27. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/review.js +31 -12
  28. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/rewrite.agency +3 -0
  29. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/rewrite.js +24 -5
  30. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/supervisor.js +15 -13
  31. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/writing.agency +3 -0
  32. package/dist/lib/agents/agency-agent/brains/coordinator/subagents/writing.js +23 -4
  33. package/dist/lib/agents/agency-agent/brains/registry.agency +0 -9
  34. package/dist/lib/agents/agency-agent/brains/registry.js +5 -139
  35. package/dist/lib/agents/agency-agent/brains/simple/simple.js +5 -3
  36. package/dist/lib/agents/agency-agent/images/images.js +2 -0
  37. package/dist/lib/agents/agency-agent/lib/agentName.js +3 -1
  38. package/dist/lib/agents/agency-agent/lib/args.agency +137 -111
  39. package/dist/lib/agents/agency-agent/lib/args.js +198 -25
  40. package/dist/lib/agents/agency-agent/lib/attachments.agency +8 -5
  41. package/dist/lib/agents/agency-agent/lib/attachments.js +59 -21
  42. package/dist/lib/agents/agency-agent/lib/budget.agency +17 -201
  43. package/dist/lib/agents/agency-agent/lib/budget.js +52 -1168
  44. package/dist/lib/agents/agency-agent/lib/capabilities.js +13 -11
  45. package/dist/lib/agents/agency-agent/lib/capabilitiesUi.js +11 -9
  46. package/dist/lib/agents/agency-agent/lib/commandPalette.js +4 -2
  47. package/dist/lib/agents/agency-agent/lib/config.js +3 -1
  48. package/dist/lib/agents/agency-agent/lib/grounding.agency +42 -24
  49. package/dist/lib/agents/agency-agent/lib/grounding.js +161 -126
  50. package/dist/lib/agents/agency-agent/lib/header.agency +94 -19
  51. package/dist/lib/agents/agency-agent/lib/header.js +831 -107
  52. package/dist/lib/agents/agency-agent/lib/images.js +5 -3
  53. package/dist/lib/agents/agency-agent/lib/mcp.js +8 -6
  54. package/dist/lib/agents/agency-agent/lib/modelFilters.js +3 -1
  55. package/dist/lib/agents/agency-agent/lib/models.agency +2 -2
  56. package/dist/lib/agents/agency-agent/lib/models.js +14 -12
  57. package/dist/lib/agents/agency-agent/lib/policy.agency +42 -20
  58. package/dist/lib/agents/agency-agent/lib/policy.js +240 -150
  59. package/dist/lib/agents/agency-agent/lib/projectContext.agency +44 -0
  60. package/dist/lib/agents/agency-agent/lib/projectContext.js +571 -0
  61. package/dist/lib/agents/agency-agent/lib/repl.js +15 -13
  62. package/dist/lib/agents/agency-agent/lib/resolution.js +9 -7
  63. package/dist/lib/agents/agency-agent/lib/resume.agency +6 -5
  64. package/dist/lib/agents/agency-agent/lib/resume.js +26 -24
  65. package/dist/lib/agents/agency-agent/lib/search.js +18 -16
  66. package/dist/lib/agents/agency-agent/lib/session.js +9 -7
  67. package/dist/lib/agents/agency-agent/lib/sessionTitle.agency +13 -8
  68. package/dist/lib/agents/agency-agent/lib/sessionTitle.js +111 -16
  69. package/dist/lib/agents/agency-agent/lib/sessions.js +13 -11
  70. package/dist/lib/agents/agency-agent/lib/settings.js +8 -6
  71. package/dist/lib/agents/agency-agent/lib/slots.js +5 -3
  72. package/dist/lib/agents/agency-agent/lib/trace.js +15 -13
  73. package/dist/lib/agents/agency-agent/lib/transcript.js +5 -3
  74. package/dist/lib/agents/agency-agent/lib/turn.agency +22 -46
  75. package/dist/lib/agents/agency-agent/lib/turn.js +83 -255
  76. package/dist/lib/agents/agency-agent/lib/utils/renderLLMCallResponse.js +3 -1
  77. package/dist/lib/agents/agency-agent/lib/utils.js +11 -9
  78. package/dist/lib/agents/agency-agent/shared.agency +8 -4
  79. package/dist/lib/agents/agency-agent/shared.js +34 -28
  80. package/dist/lib/agents/eval/goalJudge.js +3 -1
  81. package/dist/lib/agents/eval/judge.js +3 -1
  82. package/dist/lib/agents/eval/judgePairwise.js +3 -1
  83. package/dist/lib/agents/eval/rubricJudge.js +3 -1
  84. package/dist/lib/agents/optimize/gepaReflect.js +3 -1
  85. package/dist/lib/agents/optimize/mutatePrompt.js +3 -1
  86. package/dist/lib/agents/policy/agent.js +13 -11
  87. package/dist/lib/agents/review/agent.js +4 -2
  88. package/dist/lib/backends/agencyGenerator.js +9 -6
  89. package/dist/lib/backends/typescriptBuilder.js +16 -16
  90. package/dist/lib/backends/typescriptGenerator.d.ts +1 -1
  91. package/dist/lib/backends/typescriptGenerator.js +15 -2
  92. package/dist/lib/cli/effects.d.ts +26 -0
  93. package/dist/lib/cli/effects.js +108 -0
  94. package/dist/lib/cli/eval/upload.d.ts +8 -2
  95. package/dist/lib/cli/eval/upload.js +24 -21
  96. package/dist/lib/cli/runPolicy.js +4 -25
  97. package/dist/lib/cli/statelog/spendTypes.d.ts +4 -4
  98. package/dist/lib/cli/testReport.d.ts +3 -3
  99. package/dist/lib/compiler/buildSession.js +1 -1
  100. package/dist/lib/compiler/closureValidator.js +4 -3
  101. package/dist/lib/debugger/uiState.d.ts +1 -11
  102. package/dist/lib/logsViewer/conversation.d.ts +1 -1
  103. package/dist/lib/logsViewer/conversation.js +46 -15
  104. package/dist/lib/logsViewer/search.js +2 -2
  105. package/dist/lib/logsViewer/treeRows.d.ts +0 -1
  106. package/dist/lib/logsViewer/treeRows.js +11 -36
  107. package/dist/lib/logsViewer/wrapLine.d.ts +4 -0
  108. package/dist/lib/logsViewer/wrapLine.js +20 -0
  109. package/dist/lib/lowering/patternLowering.js +41 -6
  110. package/dist/lib/parsers/messages.d.ts +11 -0
  111. package/dist/lib/parsers/messages.js +49 -0
  112. package/dist/lib/parsers/onClauseHandler.d.ts +39 -0
  113. package/dist/lib/parsers/onClauseHandler.js +140 -0
  114. package/dist/lib/parsers/parsers.d.ts +8 -1
  115. package/dist/lib/parsers/parsers.js +267 -47
  116. package/dist/lib/preprocessors/importResolver.js +7 -0
  117. package/dist/lib/runsExplorer/views/verdictScreen.js +1 -1
  118. package/dist/lib/runtime/agencyFunction.d.ts +5 -2
  119. package/dist/lib/runtime/builtinPolicies.js +6 -0
  120. package/dist/lib/runtime/checkpointChecksum.d.ts +16 -0
  121. package/dist/lib/runtime/checkpointChecksum.js +91 -0
  122. package/dist/lib/runtime/effectSets.d.ts +23 -0
  123. package/dist/lib/runtime/effectSets.js +111 -0
  124. package/dist/lib/runtime/errors.d.ts +7 -0
  125. package/dist/lib/runtime/errors.js +15 -0
  126. package/dist/lib/runtime/handoff.d.ts +29 -0
  127. package/dist/lib/runtime/handoff.js +87 -0
  128. package/dist/lib/runtime/index.d.ts +3 -1
  129. package/dist/lib/runtime/index.js +3 -1
  130. package/dist/lib/runtime/interruptResolution.d.ts +5 -3
  131. package/dist/lib/runtime/interruptResolution.js +6 -4
  132. package/dist/lib/runtime/interrupts.js +4 -0
  133. package/dist/lib/runtime/moduleFingerprintRegistry.d.ts +14 -0
  134. package/dist/lib/runtime/moduleFingerprintRegistry.js +31 -0
  135. package/dist/lib/runtime/node.js +15 -29
  136. package/dist/lib/runtime/policy.d.ts +4 -0
  137. package/dist/lib/runtime/policy.js +22 -3
  138. package/dist/lib/runtime/policyFlags.d.ts +23 -0
  139. package/dist/lib/runtime/policyFlags.js +96 -0
  140. package/dist/lib/runtime/prompt.d.ts +3 -0
  141. package/dist/lib/runtime/prompt.js +334 -101
  142. package/dist/lib/runtime/referencedModules.d.ts +10 -0
  143. package/dist/lib/runtime/referencedModules.js +43 -0
  144. package/dist/lib/runtime/result.d.ts +8 -0
  145. package/dist/lib/runtime/result.js +1 -0
  146. package/dist/lib/runtime/resumableScope.js +1 -1
  147. package/dist/lib/runtime/rewind.js +7 -0
  148. package/dist/lib/runtime/runPolicyHandler.js +1 -1
  149. package/dist/lib/runtime/state/checkpointStore.d.ts +23 -11
  150. package/dist/lib/runtime/state/checkpointStore.js +41 -5
  151. package/dist/lib/runtime/state/messageThread.d.ts +9 -1
  152. package/dist/lib/runtime/state/messageThread.js +20 -1
  153. package/dist/lib/runtime/state/schemas.d.ts +8 -0
  154. package/dist/lib/runtime/state/schemas.js +8 -0
  155. package/dist/lib/runtime/state/stateStack.d.ts +7 -1
  156. package/dist/lib/runtime/state/stateStack.js +29 -1
  157. package/dist/lib/runtime/state/threadStore.d.ts +7 -0
  158. package/dist/lib/runtime/state/threadStore.js +16 -0
  159. package/dist/lib/serve/http/adapter.js +7 -1
  160. package/dist/lib/serve/mcp/interruptLoop.js +4 -1
  161. package/dist/lib/serve/policyStore.d.ts +2 -0
  162. package/dist/lib/serve/policyStore.js +37 -8
  163. package/dist/lib/statelog/agentName.d.ts +6 -6
  164. package/dist/lib/statelog/agentName.js +6 -6
  165. package/dist/lib/stdlib/agency.d.ts +3 -3
  166. package/dist/lib/stdlib/agency.js +34 -60
  167. package/dist/lib/stdlib/assertContained.d.ts +13 -27
  168. package/dist/lib/stdlib/assertContained.js +28 -97
  169. package/dist/lib/stdlib/builtins.d.ts +11 -7
  170. package/dist/lib/stdlib/builtins.js +16 -33
  171. package/dist/lib/stdlib/contained.d.ts +88 -0
  172. package/dist/lib/stdlib/contained.js +476 -0
  173. package/dist/lib/stdlib/expandPath.d.ts +10 -16
  174. package/dist/lib/stdlib/expandPath.js +10 -16
  175. package/dist/lib/stdlib/fs.d.ts +3 -3
  176. package/dist/lib/stdlib/fs.js +39 -58
  177. package/dist/lib/stdlib/git.js +4 -7
  178. package/dist/lib/stdlib/github/args.d.ts +13 -0
  179. package/dist/lib/stdlib/github/args.js +31 -0
  180. package/dist/lib/stdlib/github/credential.d.ts +20 -0
  181. package/dist/lib/stdlib/github/credential.js +103 -0
  182. package/dist/lib/stdlib/github/errors.d.ts +3 -0
  183. package/dist/lib/stdlib/github/errors.js +50 -0
  184. package/dist/lib/stdlib/github/issues.d.ts +57 -0
  185. package/dist/lib/stdlib/github/issues.js +173 -0
  186. package/dist/lib/stdlib/github/prs.d.ts +242 -0
  187. package/dist/lib/stdlib/github/prs.js +290 -0
  188. package/dist/lib/stdlib/github/repo.d.ts +22 -0
  189. package/dist/lib/stdlib/github/repo.js +92 -0
  190. package/dist/lib/stdlib/github/request.d.ts +30 -0
  191. package/dist/lib/stdlib/github/request.js +113 -0
  192. package/dist/lib/stdlib/github/testUtils.d.ts +5 -0
  193. package/dist/lib/stdlib/github/testUtils.js +31 -0
  194. package/dist/lib/stdlib/gitignore.d.ts +38 -0
  195. package/dist/lib/stdlib/gitignore.js +133 -0
  196. package/dist/lib/stdlib/grepQuery.d.ts +29 -0
  197. package/dist/lib/stdlib/grepQuery.js +65 -0
  198. package/dist/lib/stdlib/keyring.d.ts +6 -1
  199. package/dist/lib/stdlib/keyring.js +17 -16
  200. package/dist/lib/stdlib/layout/border.d.ts +4 -2
  201. package/dist/lib/stdlib/layout/border.js +21 -1
  202. package/dist/lib/stdlib/layout/box.js +5 -2
  203. package/dist/lib/stdlib/layout/table.d.ts +1 -1
  204. package/dist/lib/stdlib/layout/table.js +66 -31
  205. package/dist/lib/stdlib/layout.d.ts +1 -1
  206. package/dist/lib/stdlib/mediaPathScan.js +7 -1
  207. package/dist/lib/stdlib/policy.d.ts +1 -0
  208. package/dist/lib/stdlib/policy.js +9 -6
  209. package/dist/lib/stdlib/prepareContainedPath.d.ts +14 -9
  210. package/dist/lib/stdlib/prepareContainedPath.js +29 -80
  211. package/dist/lib/stdlib/resolveDir.d.ts +14 -16
  212. package/dist/lib/stdlib/resolveDir.js +14 -16
  213. package/dist/lib/stdlib/shell.d.ts +32 -5
  214. package/dist/lib/stdlib/shell.js +190 -157
  215. package/dist/lib/stdlib/skills.d.ts +15 -0
  216. package/dist/lib/stdlib/skills.js +15 -0
  217. package/dist/lib/stdlib/speech.js +26 -16
  218. package/dist/lib/stdlib/spill.d.ts +11 -0
  219. package/dist/lib/stdlib/spill.js +82 -0
  220. package/dist/lib/stdlib/system.js +6 -5
  221. package/dist/lib/stdlib/template.js +3 -4
  222. package/dist/lib/stdlib/thread.d.ts +3 -0
  223. package/dist/lib/stdlib/thread.js +10 -0
  224. package/dist/lib/templates/backends/typescriptGenerator/blockSetup.d.ts +2 -2
  225. package/dist/lib/templates/backends/typescriptGenerator/blockSetup.js +1 -1
  226. package/dist/lib/templates/backends/typescriptGenerator/forkBlockSetup.d.ts +2 -2
  227. package/dist/lib/templates/backends/typescriptGenerator/forkBlockSetup.js +1 -1
  228. package/dist/lib/templates/backends/typescriptGenerator/imports.d.ts +1 -1
  229. package/dist/lib/templates/backends/typescriptGenerator/imports.js +1 -0
  230. package/dist/lib/templates/backends/typescriptGenerator/interruptAssignment.d.ts +1 -1
  231. package/dist/lib/templates/backends/typescriptGenerator/interruptAssignment.js +5 -5
  232. package/dist/lib/templates/backends/typescriptGenerator/interruptReturn.d.ts +1 -1
  233. package/dist/lib/templates/backends/typescriptGenerator/interruptReturn.js +4 -4
  234. package/dist/lib/tui/elements.d.ts +2 -0
  235. package/dist/lib/tui/render/ansi.js +3 -0
  236. package/dist/lib/tui/render/html.js +2 -0
  237. package/dist/lib/tui/render/renderer.js +4 -2
  238. package/dist/lib/tui/styleParser.d.ts +1 -0
  239. package/dist/lib/tui/styleParser.js +14 -3
  240. package/dist/lib/tui/table.d.ts +1 -1
  241. package/dist/lib/tui/utils.js +1 -1
  242. package/dist/lib/typeChecker/matchExhaustiveness.js +65 -1
  243. package/dist/lib/typeChecker/resultUnion.js +1 -0
  244. package/dist/lib/typeChecker/synthesizer.js +1 -0
  245. package/dist/lib/types/function.d.ts +17 -4
  246. package/dist/lib/types/function.js +11 -0
  247. package/dist/lib/types/pattern.d.ts +8 -3
  248. package/dist/lib/types.d.ts +2 -2
  249. package/dist/lib/utils/identifierSlots.js +1 -0
  250. package/dist/lib/utils/topLevel.js +1 -0
  251. package/dist/scripts/agency.js +20 -10
  252. package/package.json +3 -3
  253. package/stdlib/agency/eval.js +5 -3
  254. package/stdlib/agency/local.js +14 -12
  255. package/stdlib/agency.agency +10 -5
  256. package/stdlib/agency.js +126 -81
  257. package/stdlib/agent.js +9 -7
  258. package/stdlib/agents/agency/coding.agency +5 -1
  259. package/stdlib/agents/agency/coding.js +19 -13
  260. package/stdlib/agents/agency/expert.js +6 -4
  261. package/stdlib/agents/agency/researcher.agency +11 -20
  262. package/stdlib/agents/agency/researcher.js +64 -84
  263. package/stdlib/agents/agency/review.js +10 -8
  264. package/stdlib/agents/agency/verifier.js +7 -5
  265. package/stdlib/agents/coding.js +6 -4
  266. package/stdlib/agents/composable/promptRewriter.js +3 -1
  267. package/stdlib/agents/composable/researcher.js +4 -2
  268. package/stdlib/agents/composable/utils.js +5 -3
  269. package/stdlib/agents/data.js +6 -4
  270. package/stdlib/agents/expert.js +6 -4
  271. package/stdlib/agents/explorer.agency +16 -18
  272. package/stdlib/agents/explorer.js +74 -107
  273. package/stdlib/agents/lib/expertGuidance.js +6 -4
  274. package/stdlib/agents/lib/feedback.js +9 -7
  275. package/stdlib/agents/lib/search.js +8 -6
  276. package/stdlib/agents/lib/shared.js +5 -3
  277. package/stdlib/agents/lib/toolkits.agency +9 -3
  278. package/stdlib/agents/lib/toolkits.js +28 -17
  279. package/stdlib/agents/oracle.agency +17 -20
  280. package/stdlib/agents/oracle.js +77 -111
  281. package/stdlib/agents/planner.js +19 -17
  282. package/stdlib/agents/researcher.agency +16 -15
  283. package/stdlib/agents/researcher.js +68 -63
  284. package/stdlib/agents/review.js +6 -4
  285. package/stdlib/agents/typescript/review.js +7 -5
  286. package/stdlib/agents/verifier.js +8 -6
  287. package/stdlib/agents/writing/review.js +15 -13
  288. package/stdlib/agents/writing/rewrite.agency +2 -1
  289. package/stdlib/agents/writing/rewrite.js +36 -16
  290. package/stdlib/args.js +3 -1
  291. package/stdlib/array.js +15 -13
  292. package/stdlib/auth/keyring.js +12 -10
  293. package/stdlib/auth/oauth.js +12 -10
  294. package/stdlib/aws/s3.js +20 -18
  295. package/stdlib/calendar.js +18 -16
  296. package/stdlib/capabilities.agency +16 -1
  297. package/stdlib/capabilities.js +13 -1
  298. package/stdlib/clipboard.js +8 -6
  299. package/stdlib/concurrency.js +6 -4
  300. package/stdlib/data/connector.js +7 -5
  301. package/stdlib/data/finance/dbnomics.js +9 -7
  302. package/stdlib/data/finance/edgar.js +16 -14
  303. package/stdlib/data/finance/fred.js +17 -15
  304. package/stdlib/data/news/gdelt.js +9 -7
  305. package/stdlib/data/people/littlesis.js +30 -28
  306. package/stdlib/data/social/bluesky.js +23 -21
  307. package/stdlib/data/tech/hackernews.js +31 -29
  308. package/stdlib/data/tech/yc.js +31 -29
  309. package/stdlib/data/usaspending.js +19 -17
  310. package/stdlib/data/wikidata.js +30 -28
  311. package/stdlib/date.js +19 -17
  312. package/stdlib/docs/cli/agent.md +17 -0
  313. package/stdlib/docs/cli/effects.md +80 -0
  314. package/stdlib/docs/cli/policy.md +31 -0
  315. package/stdlib/docs/guide/checkpointing.md +20 -1
  316. package/stdlib/docs/guide/functions.md +63 -1
  317. package/stdlib/docs/guide/match-expressions.md +38 -0
  318. package/stdlib/docs/guide/policies.md +20 -0
  319. package/stdlib/docs/stdlib/agency.md +35 -34
  320. package/stdlib/docs/stdlib/agents/agency/coding.md +2 -2
  321. package/stdlib/docs/stdlib/agents/agency/researcher.md +1 -1
  322. package/stdlib/docs/stdlib/agents/explorer.md +8 -6
  323. package/stdlib/docs/stdlib/agents/lib/toolkits.md +19 -14
  324. package/stdlib/docs/stdlib/agents/oracle.md +9 -8
  325. package/stdlib/docs/stdlib/agents/researcher.md +2 -2
  326. package/stdlib/docs/stdlib/capabilities.md +65 -10
  327. package/stdlib/docs/stdlib/fs.md +3 -3
  328. package/stdlib/docs/stdlib/github.md +1126 -0
  329. package/stdlib/docs/stdlib/policy.md +51 -34
  330. package/stdlib/docs/stdlib/safeBash/actions.md +15 -42
  331. package/stdlib/docs/stdlib/safeBash.md +9 -2
  332. package/stdlib/docs/stdlib/shell.md +48 -25
  333. package/stdlib/docs/stdlib/skills.md +290 -77
  334. package/stdlib/docs/stdlib/speech.md +8 -11
  335. package/stdlib/docs/stdlib/spill.md +172 -0
  336. package/stdlib/docs/stdlib/system.md +17 -17
  337. package/stdlib/docs/stdlib/thread.md +45 -23
  338. package/stdlib/docs/stdlib/toolbox.md +99 -42
  339. package/stdlib/docs/stdlib/ui/layout.md +5 -3
  340. package/stdlib/docs/stdlib/ui/table.md +8 -1
  341. package/stdlib/fs.agency +35 -11
  342. package/stdlib/fs.js +310 -50
  343. package/stdlib/git.js +57 -55
  344. package/stdlib/github.agency +854 -0
  345. package/stdlib/github.js +5103 -0
  346. package/stdlib/http.js +11 -9
  347. package/stdlib/image.js +3 -1
  348. package/stdlib/index.js +42 -40
  349. package/stdlib/llm.js +11 -9
  350. package/stdlib/markdown.js +7 -5
  351. package/stdlib/math.js +7 -5
  352. package/stdlib/mcp.js +7 -5
  353. package/stdlib/memory.js +21 -19
  354. package/stdlib/messaging/email.js +11 -9
  355. package/stdlib/messaging/imessage.js +5 -3
  356. package/stdlib/messaging/sms.js +5 -3
  357. package/stdlib/notes/apple.js +25 -23
  358. package/stdlib/object.js +10 -8
  359. package/stdlib/path.js +9 -7
  360. package/stdlib/policy.agency +72 -9
  361. package/stdlib/policy.js +311 -35
  362. package/stdlib/safeBash/actions.agency +4 -16
  363. package/stdlib/safeBash/actions.js +13 -165
  364. package/stdlib/safeBash.agency +16 -9
  365. package/stdlib/safeBash.js +89 -66
  366. package/stdlib/shell.agency +70 -19
  367. package/stdlib/shell.js +306 -71
  368. package/stdlib/skills.agency +475 -90
  369. package/stdlib/skills.js +3495 -313
  370. package/stdlib/speech.agency +35 -7
  371. package/stdlib/speech.js +306 -37
  372. package/stdlib/spill.agency +199 -0
  373. package/stdlib/spill.js +1814 -0
  374. package/stdlib/statelog.js +10 -8
  375. package/stdlib/strategy.js +11 -9
  376. package/stdlib/supervise.js +4 -2
  377. package/stdlib/syntax.js +6 -4
  378. package/stdlib/system.agency +7 -2
  379. package/stdlib/system.js +78 -32
  380. package/stdlib/tag.js +8 -6
  381. package/stdlib/thread.agency +15 -0
  382. package/stdlib/thread.js +174 -21
  383. package/stdlib/toolbox.agency +269 -106
  384. package/stdlib/toolbox.js +3603 -1757
  385. package/stdlib/ui/chart.js +6 -4
  386. package/stdlib/ui/cli.js +11 -9
  387. package/stdlib/ui/layout.agency +4 -2
  388. package/stdlib/ui/layout.js +25 -21
  389. package/stdlib/ui/table.agency +9 -2
  390. package/stdlib/ui/table.js +34 -13
  391. package/stdlib/ui.js +64 -62
  392. package/stdlib/validation.js +15 -13
  393. package/stdlib/weather.js +7 -5
  394. package/stdlib/web/browser.js +5 -3
  395. package/stdlib/web/search.js +8 -6
  396. package/stdlib/wikipedia.js +11 -9
  397. package/dist/lib/agents/agency-agent/brains/coordinator/tests/agentTurn.agency +0 -436
  398. package/dist/lib/agents/agency-agent/brains/coordinator/tests/agentTurn.js +0 -4853
  399. package/dist/lib/agents/agency-agent/brains/coordinator/tests/agentTurn.test.json +0 -310
  400. package/dist/lib/agents/agency-agent/brains/coordinator/tests/attachmentsTurn.agency +0 -55
  401. package/dist/lib/agents/agency-agent/brains/coordinator/tests/attachmentsTurn.js +0 -801
  402. package/dist/lib/agents/agency-agent/brains/coordinator/tests/attachmentsTurn.test.json +0 -47
  403. package/dist/lib/agents/agency-agent/brains/coordinator/tests/brainstorm.agency +0 -94
  404. package/dist/lib/agents/agency-agent/brains/coordinator/tests/brainstorm.js +0 -1270
  405. package/dist/lib/agents/agency-agent/brains/coordinator/tests/brainstorm.test.json +0 -59
  406. package/dist/lib/agents/agency-agent/brains/coordinator/tests/supervisor.agency +0 -197
  407. package/dist/lib/agents/agency-agent/brains/coordinator/tests/supervisor.js +0 -2798
  408. package/dist/lib/agents/agency-agent/brains/coordinator/tests/supervisor.test.json +0 -169
  409. package/dist/lib/agents/agency-agent/brains/coordinator/tests/toolWiring.agency +0 -79
  410. package/dist/lib/agents/agency-agent/brains/coordinator/tests/toolWiring.js +0 -1064
  411. package/dist/lib/agents/agency-agent/brains/coordinator/tests/toolWiring.test.json +0 -46
  412. package/dist/lib/agents/agency-agent/brains/simple/tests/simpleTurn.agency +0 -17
  413. package/dist/lib/agents/agency-agent/brains/simple/tests/simpleTurn.js +0 -386
  414. package/dist/lib/agents/agency-agent/brains/simple/tests/simpleTurn.test.json +0 -13
  415. package/dist/lib/agents/agency-agent/tests/agentDir.agency +0 -20
  416. package/dist/lib/agents/agency-agent/tests/agentDir.js +0 -382
  417. package/dist/lib/agents/agency-agent/tests/agentDir.test.json +0 -15
  418. package/dist/lib/agents/agency-agent/tests/agentName.agency +0 -10
  419. package/dist/lib/agents/agency-agent/tests/agentName.test.json +0 -6
  420. package/dist/lib/agents/agency-agent/tests/agentTurn.js +0 -4154
  421. package/dist/lib/agents/agency-agent/tests/attachments.agency +0 -192
  422. package/dist/lib/agents/agency-agent/tests/attachments.js +0 -3840
  423. package/dist/lib/agents/agency-agent/tests/attachments.test.json +0 -254
  424. package/dist/lib/agents/agency-agent/tests/attachmentsTurn.js +0 -926
  425. package/dist/lib/agents/agency-agent/tests/brainstorm.js +0 -1065
  426. package/dist/lib/agents/agency-agent/tests/capabilities.agency +0 -233
  427. package/dist/lib/agents/agency-agent/tests/capabilities.js +0 -2443
  428. package/dist/lib/agents/agency-agent/tests/capabilities.test.json +0 -165
  429. package/dist/lib/agents/agency-agent/tests/envPolicy.agency +0 -18
  430. package/dist/lib/agents/agency-agent/tests/envPolicy.js +0 -446
  431. package/dist/lib/agents/agency-agent/tests/envPolicy.test.json +0 -11
  432. package/dist/lib/agents/agency-agent/tests/execPolicy.agency +0 -46
  433. package/dist/lib/agents/agency-agent/tests/execPolicy.js +0 -980
  434. package/dist/lib/agents/agency-agent/tests/execPolicy.test.json +0 -34
  435. package/dist/lib/agents/agency-agent/tests/gitPolicy.agency +0 -53
  436. package/dist/lib/agents/agency-agent/tests/gitPolicy.js +0 -796
  437. package/dist/lib/agents/agency-agent/tests/gitPolicy.test.json +0 -7
  438. package/dist/lib/agents/agency-agent/tests/imageTool.agency +0 -51
  439. package/dist/lib/agents/agency-agent/tests/imageTool.js +0 -1233
  440. package/dist/lib/agents/agency-agent/tests/imageTool.test.json +0 -81
  441. package/dist/lib/agents/agency-agent/tests/mcpGating.agency +0 -42
  442. package/dist/lib/agents/agency-agent/tests/mcpGating.js +0 -730
  443. package/dist/lib/agents/agency-agent/tests/mcpGating.test.json +0 -22
  444. package/dist/lib/agents/agency-agent/tests/memoryWiring.agency +0 -148
  445. package/dist/lib/agents/agency-agent/tests/memoryWiring.js +0 -1414
  446. package/dist/lib/agents/agency-agent/tests/memoryWiring.test.json +0 -75
  447. package/dist/lib/agents/agency-agent/tests/modelFilters.agency +0 -32
  448. package/dist/lib/agents/agency-agent/tests/modelFilters.js +0 -809
  449. package/dist/lib/agents/agency-agent/tests/modelFilters.test.json +0 -7
  450. package/dist/lib/agents/agency-agent/tests/models.agency +0 -114
  451. package/dist/lib/agents/agency-agent/tests/models.js +0 -2324
  452. package/dist/lib/agents/agency-agent/tests/models.test.json +0 -49
  453. package/dist/lib/agents/agency-agent/tests/oneShotRounds.agency +0 -20
  454. package/dist/lib/agents/agency-agent/tests/oneShotRounds.js +0 -646
  455. package/dist/lib/agents/agency-agent/tests/oneShotRounds.test.json +0 -9
  456. package/dist/lib/agents/agency-agent/tests/readPolicy.agency +0 -44
  457. package/dist/lib/agents/agency-agent/tests/readPolicy.js +0 -1035
  458. package/dist/lib/agents/agency-agent/tests/readPolicy.test.json +0 -22
  459. package/dist/lib/agents/agency-agent/tests/registry.agency +0 -26
  460. package/dist/lib/agents/agency-agent/tests/registry.js +0 -698
  461. package/dist/lib/agents/agency-agent/tests/registry.test.json +0 -9
  462. package/dist/lib/agents/agency-agent/tests/resolution.agency +0 -236
  463. package/dist/lib/agents/agency-agent/tests/resolution.js +0 -2315
  464. package/dist/lib/agents/agency-agent/tests/resolution.test.json +0 -115
  465. package/dist/lib/agents/agency-agent/tests/search.agency +0 -101
  466. package/dist/lib/agents/agency-agent/tests/search.js +0 -2509
  467. package/dist/lib/agents/agency-agent/tests/search.test.json +0 -19
  468. package/dist/lib/agents/agency-agent/tests/settings.agency +0 -216
  469. package/dist/lib/agents/agency-agent/tests/settings.js +0 -2281
  470. package/dist/lib/agents/agency-agent/tests/settings.test.json +0 -145
  471. package/dist/lib/agents/agency-agent/tests/slots.agency +0 -22
  472. package/dist/lib/agents/agency-agent/tests/slots.js +0 -685
  473. package/dist/lib/agents/agency-agent/tests/slots.test.json +0 -10
  474. package/dist/lib/agents/agency-agent/tests/stubBrains.agency +0 -146
  475. package/dist/lib/agents/agency-agent/tests/stubBrains.js +0 -2379
  476. package/dist/lib/agents/agency-agent/tests/stubPolicy.json +0 -4
  477. package/dist/lib/agents/agency-agent/tests/subagentFailure.js +0 -749
  478. package/dist/lib/agents/agency-agent/tests/supervisor.js +0 -2437
  479. package/dist/lib/agents/agency-agent/tests/threadText.agency +0 -29
  480. package/dist/lib/agents/agency-agent/tests/toolWiring.js +0 -948
  481. package/dist/lib/agents/agency-agent/tests/turn.agency +0 -194
  482. package/dist/lib/agents/agency-agent/tests/turn.js +0 -2818
  483. package/dist/lib/agents/agency-agent/tests/turn.test.json +0 -29
  484. package/dist/lib/agents/agency-agent/tests/turnFailure.agency +0 -44
  485. package/dist/lib/agents/agency-agent/tests/turnFailure.js +0 -881
  486. package/dist/lib/agents/agency-agent/tests/turnFailure.test.json +0 -40
  487. package/dist/lib/stdlib/resolvePath.d.ts +0 -12
  488. package/dist/lib/stdlib/resolvePath.js +0 -21
  489. package/dist/lib/utils/readContainedFile.d.ts +0 -6
  490. package/dist/lib/utils/readContainedFile.js +0 -49
@@ -5,22 +5,17 @@ import { evalOutput, evalValue, setAgentName } from "std::statelog"
5
5
  import { cwd, env, isTTY, readStdin, setTitle } from "std::system"
6
6
  import { getCost } from "std::thread"
7
7
  import { setSlashPalette } from "std::ui/cli"
8
- import {
9
- clearMessages,
10
- pushMessage,
11
- repl,
12
- clearScreen,
13
- } from "std::ui/cli"
8
+ import { clearMessages, pushMessage, repl, clearScreen } from "std::ui/cli"
14
9
 
15
- import { brainByName, allBrains, brainFlagHelp } from "./brains/registry.agency"
10
+ import { brainByName, allBrains } from "./brains/registry.agency"
16
11
  import { agentNameFor } from "./lib/agentName.agency"
17
- import { mergedPalette } from "./lib/commandPalette.agency"
18
12
  import { parseAgentArgs } from "./lib/args.agency"
13
+ import { mergedPalette } from "./lib/commandPalette.agency"
19
14
  import { getHeader } from "./lib/header.agency"
20
15
  import { maybeLoadMcp } from "./lib/mcp.agency"
21
16
  import { printPolicyHelp } from "./lib/policy.agency"
22
- import { chooseSession, startSession } from "./lib/resume.agency"
23
17
  import { installSessionHooks, startInteractive } from "./lib/repl.agency"
18
+ import { chooseSession, startSession } from "./lib/resume.agency"
24
19
  import { pickModelsForAgent, maybeEnableMemory } from "./lib/session.agency"
25
20
  import { loadSettings } from "./lib/settings.agency"
26
21
  import { setDebug, setVerbose, setInteractive } from "./lib/trace.agency"
@@ -35,7 +30,6 @@ import {
35
30
  import { formatTurnFailure } from "./lib/utils.agency"
36
31
  import { resolveMaxToolCallRounds, getCapabilities } from "./shared.agency"
37
32
 
38
-
39
33
  // UI mode select — one-line swap between the alt-screen TUI and the
40
34
  // line-mode REPL. Both modules expose the same `repl` / `pushMessage`
41
35
  // / `clearMessages` surface (line mode re-exports `pushMessage` and
@@ -72,7 +66,7 @@ It means that agent starts with an initial prompt already there to respond to. *
72
66
  node main() {
73
67
  // Parse CLI flags first — `parseArgs` exits on --help / --version /
74
68
  // usage errors, before any handlers or the TUI are installed.
75
- const args = parseAgentArgs(brainFlagHelp())
69
+ const args = parseAgentArgs()
76
70
 
77
71
  // NOTE: --trace / --log / --agent-home are declared here only for
78
72
  // --help and so parseArgs accepts them. runBundledAgent extracts them from
@@ -94,7 +88,11 @@ node main() {
94
88
  printPolicyHelp()
95
89
  process.exit(0)
96
90
  }
97
- setPolicyArg(args.flags.policy ?? "")
91
+ setPolicyArg(
92
+ args.flags.policy ?? "",
93
+ approve: args.flags.approve ?? "",
94
+ reject: args.flags.reject ?? "",
95
+ )
98
96
 
99
97
  const brainName = resolveBrainName(args.flags.brain ?? null, loadSettings())
100
98
  const brain = brainByName(brainName)
@@ -127,7 +125,11 @@ node main() {
127
125
  let startAgent = ""
128
126
  if (resolvedStartTarget == null) {
129
127
  const validTargets = ["main", ...brain.startTargets].join(", ")
130
- print(color.red("Unknown --agent value: ${requestedStartTarget}. Valid for the ${brain.name} brain: ${validTargets}"))
128
+ print(
129
+ color.red(
130
+ "Unknown --agent value: ${requestedStartTarget}. Valid for the ${brain.name} brain: ${validTargets}",
131
+ ),
132
+ )
131
133
  process.exit(1)
132
134
  return
133
135
  } else {
@@ -148,11 +150,9 @@ node main() {
148
150
  args.flags["max-tool-call-rounds"] ?? null,
149
151
  isOneShot,
150
152
  )
151
- if (maxRounds != null) {
152
- setLlmOptions({
153
- maxToolCallRounds: maxRounds
154
- })
155
- }
153
+ setLlmOptions({
154
+ maxToolCallRounds: maxRounds
155
+ })
156
156
  const maxResultChars = args.flags["max-tool-result-chars"]
157
157
  if (maxResultChars != null) {
158
158
  setLlmOptions({
@@ -174,7 +174,11 @@ node main() {
174
174
  // One-shot runs are not saved, so a resume flag on one is a mistake
175
175
  // rather than something to ignore.
176
176
  if (isOneShot && (args.flags.continue || args.flags.resume != null)) {
177
- print(color.red("--continue and --resume need an interactive session; one-shot runs are not saved."))
177
+ print(
178
+ color.red(
179
+ "--continue and --resume need an interactive session; one-shot runs are not saved.",
180
+ ),
181
+ )
178
182
  process.exit(1)
179
183
  }
180
184
  // Everything above is process-level: model resolution feeds the memory
@@ -184,7 +188,10 @@ node main() {
184
188
  if (!isOneShot) {
185
189
  installSessionHooks()
186
190
  setSlashPalette(mergedPalette())
187
- startSession(chooseSession(args.flags.continue, args.flags.resume ?? null), brain)
191
+ startSession(
192
+ chooseSession(args.flags.continue, args.flags.resume ?? null),
193
+ brain,
194
+ )
188
195
  }
189
196
 
190
197
  if (isOneShot) {