@nac3/forge-cli 0.2.0-alpha.5 → 0.2.0-alpha.59z.119

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 (768) hide show
  1. package/README.md +16 -1
  2. package/dist/a11y/helpers.d.ts +88 -0
  3. package/dist/a11y/helpers.d.ts.map +1 -0
  4. package/dist/a11y/helpers.js +109 -0
  5. package/dist/a11y/helpers.js.map +1 -0
  6. package/dist/agents/config_resolver.d.ts +16 -0
  7. package/dist/agents/config_resolver.d.ts.map +1 -0
  8. package/dist/agents/config_resolver.js +133 -0
  9. package/dist/agents/config_resolver.js.map +1 -0
  10. package/dist/agents/config_schema.d.ts +42 -0
  11. package/dist/agents/config_schema.d.ts.map +1 -0
  12. package/dist/agents/config_schema.js +204 -0
  13. package/dist/agents/config_schema.js.map +1 -0
  14. package/dist/agents/defaults.d.ts +21 -0
  15. package/dist/agents/defaults.d.ts.map +1 -0
  16. package/dist/agents/defaults.js +56 -0
  17. package/dist/agents/defaults.js.map +1 -0
  18. package/dist/agents/runner.d.ts +94 -0
  19. package/dist/agents/runner.d.ts.map +1 -0
  20. package/dist/agents/runner.js +165 -0
  21. package/dist/agents/runner.js.map +1 -0
  22. package/dist/agents/store.d.ts +33 -0
  23. package/dist/agents/store.d.ts.map +1 -0
  24. package/dist/agents/store.js +210 -0
  25. package/dist/agents/store.js.map +1 -0
  26. package/dist/agents/types.d.ts +112 -0
  27. package/dist/agents/types.d.ts.map +1 -0
  28. package/dist/agents/types.js +39 -0
  29. package/dist/agents/types.js.map +1 -0
  30. package/dist/bin/yf.d.ts.map +1 -1
  31. package/dist/bin/yf.js +86 -2
  32. package/dist/bin/yf.js.map +1 -1
  33. package/dist/chat/claude.d.ts +53 -15
  34. package/dist/chat/claude.d.ts.map +1 -1
  35. package/dist/chat/claude.js +152 -27
  36. package/dist/chat/claude.js.map +1 -1
  37. package/dist/chat/graph_auto_ingest.d.ts +46 -0
  38. package/dist/chat/graph_auto_ingest.d.ts.map +1 -0
  39. package/dist/chat/graph_auto_ingest.js +162 -0
  40. package/dist/chat/graph_auto_ingest.js.map +1 -0
  41. package/dist/chat/graph_component_watcher.d.ts +30 -0
  42. package/dist/chat/graph_component_watcher.d.ts.map +1 -0
  43. package/dist/chat/graph_component_watcher.js +220 -0
  44. package/dist/chat/graph_component_watcher.js.map +1 -0
  45. package/dist/chat/panel.d.ts.map +1 -1
  46. package/dist/chat/panel.js +5819 -1455
  47. package/dist/chat/panel.js.map +1 -1
  48. package/dist/chat/project_slug.d.ts +6 -0
  49. package/dist/chat/project_slug.d.ts.map +1 -0
  50. package/dist/chat/project_slug.js +78 -0
  51. package/dist/chat/project_slug.js.map +1 -0
  52. package/dist/chat/semantic_graph_ingest.d.ts +31 -0
  53. package/dist/chat/semantic_graph_ingest.d.ts.map +1 -0
  54. package/dist/chat/semantic_graph_ingest.js +84 -0
  55. package/dist/chat/semantic_graph_ingest.js.map +1 -0
  56. package/dist/chat/semantic_graph_inject.d.ts +25 -0
  57. package/dist/chat/semantic_graph_inject.d.ts.map +1 -0
  58. package/dist/chat/semantic_graph_inject.js +64 -0
  59. package/dist/chat/semantic_graph_inject.js.map +1 -0
  60. package/dist/chat/server.d.ts +50 -0
  61. package/dist/chat/server.d.ts.map +1 -1
  62. package/dist/chat/server.js +1905 -54
  63. package/dist/chat/server.js.map +1 -1
  64. package/dist/chat/spec_extract.d.ts +1 -2
  65. package/dist/chat/spec_extract.d.ts.map +1 -1
  66. package/dist/chat/spec_extract.js +18 -59
  67. package/dist/chat/spec_extract.js.map +1 -1
  68. package/dist/chat/spec_plan.d.ts +1 -2
  69. package/dist/chat/spec_plan.d.ts.map +1 -1
  70. package/dist/chat/spec_plan.js +15 -60
  71. package/dist/chat/spec_plan.js.map +1 -1
  72. package/dist/chat/tools/app_backend_dispatch.d.ts +39 -0
  73. package/dist/chat/tools/app_backend_dispatch.d.ts.map +1 -0
  74. package/dist/chat/tools/app_backend_dispatch.js +239 -0
  75. package/dist/chat/tools/app_backend_dispatch.js.map +1 -0
  76. package/dist/chat/tools/audit_consumers.d.ts +66 -0
  77. package/dist/chat/tools/audit_consumers.d.ts.map +1 -0
  78. package/dist/chat/tools/audit_consumers.js +231 -0
  79. package/dist/chat/tools/audit_consumers.js.map +1 -0
  80. package/dist/chat/tools/fs_editor.d.ts +11 -0
  81. package/dist/chat/tools/fs_editor.d.ts.map +1 -0
  82. package/dist/chat/tools/fs_editor.js +162 -0
  83. package/dist/chat/tools/fs_editor.js.map +1 -0
  84. package/dist/chat/tools/git.d.ts +24 -0
  85. package/dist/chat/tools/git.d.ts.map +1 -1
  86. package/dist/chat/tools/git.js +78 -0
  87. package/dist/chat/tools/git.js.map +1 -1
  88. package/dist/chat/tools/keys.d.ts +9 -0
  89. package/dist/chat/tools/keys.d.ts.map +1 -0
  90. package/dist/chat/tools/keys.js +152 -0
  91. package/dist/chat/tools/keys.js.map +1 -0
  92. package/dist/chat/tools/misc_verbs.d.ts +36 -0
  93. package/dist/chat/tools/misc_verbs.d.ts.map +1 -0
  94. package/dist/chat/tools/misc_verbs.js +405 -0
  95. package/dist/chat/tools/misc_verbs.js.map +1 -0
  96. package/dist/chat/tools/nac3_invoke.d.ts +53 -0
  97. package/dist/chat/tools/nac3_invoke.d.ts.map +1 -0
  98. package/dist/chat/tools/nac3_invoke.js +886 -0
  99. package/dist/chat/tools/nac3_invoke.js.map +1 -0
  100. package/dist/chat/tools/pizarron.d.ts +40 -0
  101. package/dist/chat/tools/pizarron.d.ts.map +1 -0
  102. package/dist/chat/tools/pizarron.js +123 -0
  103. package/dist/chat/tools/pizarron.js.map +1 -0
  104. package/dist/chat/tools/project_lifecycle.d.ts +24 -0
  105. package/dist/chat/tools/project_lifecycle.d.ts.map +1 -0
  106. package/dist/chat/tools/project_lifecycle.js +184 -0
  107. package/dist/chat/tools/project_lifecycle.js.map +1 -0
  108. package/dist/chat/tools/reader.d.ts.map +1 -1
  109. package/dist/chat/tools/reader.js +144 -1
  110. package/dist/chat/tools/reader.js.map +1 -1
  111. package/dist/chat/tools/shell.d.ts +58 -0
  112. package/dist/chat/tools/shell.d.ts.map +1 -0
  113. package/dist/chat/tools/shell.js +253 -0
  114. package/dist/chat/tools/shell.js.map +1 -0
  115. package/dist/chat/tools/workflow.d.ts +45 -0
  116. package/dist/chat/tools/workflow.d.ts.map +1 -0
  117. package/dist/chat/tools/workflow.js +404 -0
  118. package/dist/chat/tools/workflow.js.map +1 -0
  119. package/dist/chat/tools.d.ts +27 -0
  120. package/dist/chat/tools.d.ts.map +1 -1
  121. package/dist/chat/tools.js +362 -13
  122. package/dist/chat/tools.js.map +1 -1
  123. package/dist/chat/workflow_inject.d.ts +52 -0
  124. package/dist/chat/workflow_inject.d.ts.map +1 -0
  125. package/dist/chat/workflow_inject.js +346 -0
  126. package/dist/chat/workflow_inject.js.map +1 -0
  127. package/dist/commands/agent.d.ts +22 -0
  128. package/dist/commands/agent.d.ts.map +1 -0
  129. package/dist/commands/agent.js +190 -0
  130. package/dist/commands/agent.js.map +1 -0
  131. package/dist/commands/approve.d.ts +32 -0
  132. package/dist/commands/approve.d.ts.map +1 -0
  133. package/dist/commands/approve.js +198 -0
  134. package/dist/commands/approve.js.map +1 -0
  135. package/dist/commands/block.d.ts +28 -0
  136. package/dist/commands/block.d.ts.map +1 -0
  137. package/dist/commands/block.js +189 -0
  138. package/dist/commands/block.js.map +1 -0
  139. package/dist/commands/bootstrap.d.ts +35 -0
  140. package/dist/commands/bootstrap.d.ts.map +1 -0
  141. package/dist/commands/bootstrap.js +205 -0
  142. package/dist/commands/bootstrap.js.map +1 -0
  143. package/dist/commands/brain.d.ts +17 -0
  144. package/dist/commands/brain.d.ts.map +1 -0
  145. package/dist/commands/brain.js +129 -0
  146. package/dist/commands/brain.js.map +1 -0
  147. package/dist/commands/chat.d.ts +3 -0
  148. package/dist/commands/chat.d.ts.map +1 -1
  149. package/dist/commands/chat.js +112 -1
  150. package/dist/commands/chat.js.map +1 -1
  151. package/dist/commands/clarify.d.ts +30 -0
  152. package/dist/commands/clarify.d.ts.map +1 -0
  153. package/dist/commands/clarify.js +671 -0
  154. package/dist/commands/clarify.js.map +1 -0
  155. package/dist/commands/discover.d.ts +30 -0
  156. package/dist/commands/discover.d.ts.map +1 -0
  157. package/dist/commands/discover.js +178 -0
  158. package/dist/commands/discover.js.map +1 -0
  159. package/dist/commands/doctor.js +26 -4
  160. package/dist/commands/doctor.js.map +1 -1
  161. package/dist/commands/doctrine.d.ts +24 -0
  162. package/dist/commands/doctrine.d.ts.map +1 -0
  163. package/dist/commands/doctrine.js +106 -0
  164. package/dist/commands/doctrine.js.map +1 -0
  165. package/dist/commands/doctrines.d.ts +21 -0
  166. package/dist/commands/doctrines.d.ts.map +1 -0
  167. package/dist/commands/doctrines.js +158 -0
  168. package/dist/commands/doctrines.js.map +1 -0
  169. package/dist/commands/graph.d.ts +21 -0
  170. package/dist/commands/graph.d.ts.map +1 -0
  171. package/dist/commands/graph.js +363 -0
  172. package/dist/commands/graph.js.map +1 -0
  173. package/dist/commands/keys_setup.d.ts.map +1 -1
  174. package/dist/commands/keys_setup.js +80 -0
  175. package/dist/commands/keys_setup.js.map +1 -1
  176. package/dist/commands/legacy-audit.d.ts +34 -0
  177. package/dist/commands/legacy-audit.d.ts.map +1 -0
  178. package/dist/commands/legacy-audit.js +270 -0
  179. package/dist/commands/legacy-audit.js.map +1 -0
  180. package/dist/commands/lessons.d.ts +28 -0
  181. package/dist/commands/lessons.d.ts.map +1 -0
  182. package/dist/commands/lessons.js +309 -0
  183. package/dist/commands/lessons.js.map +1 -0
  184. package/dist/commands/license.d.ts.map +1 -1
  185. package/dist/commands/license.js +56 -1
  186. package/dist/commands/license.js.map +1 -1
  187. package/dist/commands/limits.d.ts +15 -0
  188. package/dist/commands/limits.d.ts.map +1 -0
  189. package/dist/commands/limits.js +51 -0
  190. package/dist/commands/limits.js.map +1 -0
  191. package/dist/commands/manifest-cli.d.ts +12 -0
  192. package/dist/commands/manifest-cli.d.ts.map +1 -0
  193. package/dist/commands/manifest-cli.js +42 -0
  194. package/dist/commands/manifest-cli.js.map +1 -0
  195. package/dist/commands/mcp.d.ts +24 -0
  196. package/dist/commands/mcp.d.ts.map +1 -0
  197. package/dist/commands/mcp.js +163 -0
  198. package/dist/commands/mcp.js.map +1 -0
  199. package/dist/commands/nac3.d.ts +22 -0
  200. package/dist/commands/nac3.d.ts.map +1 -0
  201. package/dist/commands/nac3.js +125 -0
  202. package/dist/commands/nac3.js.map +1 -0
  203. package/dist/commands/operate.d.ts +22 -0
  204. package/dist/commands/operate.d.ts.map +1 -0
  205. package/dist/commands/operate.js +523 -0
  206. package/dist/commands/operate.js.map +1 -0
  207. package/dist/commands/qa.d.ts +24 -0
  208. package/dist/commands/qa.d.ts.map +1 -0
  209. package/dist/commands/qa.js +349 -0
  210. package/dist/commands/qa.js.map +1 -0
  211. package/dist/commands/spec.d.ts +38 -0
  212. package/dist/commands/spec.d.ts.map +1 -0
  213. package/dist/commands/spec.js +256 -0
  214. package/dist/commands/spec.js.map +1 -0
  215. package/dist/commands/support.d.ts +22 -0
  216. package/dist/commands/support.d.ts.map +1 -0
  217. package/dist/commands/support.js +165 -0
  218. package/dist/commands/support.js.map +1 -0
  219. package/dist/commands/triage.d.ts +34 -0
  220. package/dist/commands/triage.d.ts.map +1 -0
  221. package/dist/commands/triage.js +228 -0
  222. package/dist/commands/triage.js.map +1 -0
  223. package/dist/commands/vault-inventory.d.ts +30 -0
  224. package/dist/commands/vault-inventory.d.ts.map +1 -0
  225. package/dist/commands/vault-inventory.js +222 -0
  226. package/dist/commands/vault-inventory.js.map +1 -0
  227. package/dist/commands/vault.d.ts.map +1 -1
  228. package/dist/commands/vault.js +5 -0
  229. package/dist/commands/vault.js.map +1 -1
  230. package/dist/commands/voice.d.ts.map +1 -1
  231. package/dist/commands/voice.js +47 -4
  232. package/dist/commands/voice.js.map +1 -1
  233. package/dist/commands/workflow-coverage.d.ts +30 -0
  234. package/dist/commands/workflow-coverage.d.ts.map +1 -0
  235. package/dist/commands/workflow-coverage.js +138 -0
  236. package/dist/commands/workflow-coverage.js.map +1 -0
  237. package/dist/core/ansi_strip.d.ts +39 -0
  238. package/dist/core/ansi_strip.d.ts.map +1 -0
  239. package/dist/core/ansi_strip.js +71 -0
  240. package/dist/core/ansi_strip.js.map +1 -0
  241. package/dist/core/audit_log.d.ts +43 -0
  242. package/dist/core/audit_log.d.ts.map +1 -0
  243. package/dist/core/audit_log.js +80 -0
  244. package/dist/core/audit_log.js.map +1 -0
  245. package/dist/core/brain_config.d.ts +33 -0
  246. package/dist/core/brain_config.d.ts.map +1 -0
  247. package/dist/core/brain_config.js +132 -0
  248. package/dist/core/brain_config.js.map +1 -0
  249. package/dist/core/budget.d.ts +96 -0
  250. package/dist/core/budget.d.ts.map +1 -0
  251. package/dist/core/budget.js +300 -0
  252. package/dist/core/budget.js.map +1 -0
  253. package/dist/core/cost_meter.d.ts +35 -0
  254. package/dist/core/cost_meter.d.ts.map +1 -0
  255. package/dist/core/cost_meter.js +111 -0
  256. package/dist/core/cost_meter.js.map +1 -0
  257. package/dist/core/cost_router.d.ts +106 -0
  258. package/dist/core/cost_router.d.ts.map +1 -0
  259. package/dist/core/cost_router.js +465 -0
  260. package/dist/core/cost_router.js.map +1 -0
  261. package/dist/core/doctrine_resolver.d.ts +23 -0
  262. package/dist/core/doctrine_resolver.d.ts.map +1 -0
  263. package/dist/core/doctrine_resolver.js +108 -0
  264. package/dist/core/doctrine_resolver.js.map +1 -0
  265. package/dist/core/error_catalog.d.ts +80 -0
  266. package/dist/core/error_catalog.d.ts.map +1 -0
  267. package/dist/core/error_catalog.js +168 -0
  268. package/dist/core/error_catalog.js.map +1 -0
  269. package/dist/core/error_formatter.d.ts +30 -0
  270. package/dist/core/error_formatter.d.ts.map +1 -0
  271. package/dist/core/error_formatter.js +155 -0
  272. package/dist/core/error_formatter.js.map +1 -0
  273. package/dist/core/incomplete_detector.d.ts +51 -0
  274. package/dist/core/incomplete_detector.d.ts.map +1 -0
  275. package/dist/core/incomplete_detector.js +140 -0
  276. package/dist/core/incomplete_detector.js.map +1 -0
  277. package/dist/core/learnings_client.d.ts +104 -0
  278. package/dist/core/learnings_client.d.ts.map +1 -0
  279. package/dist/core/learnings_client.js +262 -0
  280. package/dist/core/learnings_client.js.map +1 -0
  281. package/dist/core/limits_config.d.ts +76 -0
  282. package/dist/core/limits_config.d.ts.map +1 -0
  283. package/dist/core/limits_config.js +297 -0
  284. package/dist/core/limits_config.js.map +1 -0
  285. package/dist/core/provider_keys.d.ts +35 -0
  286. package/dist/core/provider_keys.d.ts.map +1 -0
  287. package/dist/core/provider_keys.js +260 -0
  288. package/dist/core/provider_keys.js.map +1 -0
  289. package/dist/core/reasoning_gate.d.ts +72 -0
  290. package/dist/core/reasoning_gate.d.ts.map +1 -0
  291. package/dist/core/reasoning_gate.js +192 -0
  292. package/dist/core/reasoning_gate.js.map +1 -0
  293. package/dist/core/shell_classifier.d.ts +49 -0
  294. package/dist/core/shell_classifier.d.ts.map +1 -0
  295. package/dist/core/shell_classifier.js +159 -0
  296. package/dist/core/shell_classifier.js.map +1 -0
  297. package/dist/core/sq_resolver.d.ts +14 -0
  298. package/dist/core/sq_resolver.d.ts.map +1 -0
  299. package/dist/core/sq_resolver.js +230 -0
  300. package/dist/core/sq_resolver.js.map +1 -0
  301. package/dist/core/truncation_detector.d.ts +68 -0
  302. package/dist/core/truncation_detector.d.ts.map +1 -0
  303. package/dist/core/truncation_detector.js +115 -0
  304. package/dist/core/truncation_detector.js.map +1 -0
  305. package/dist/core/turn_classifier.d.ts +62 -0
  306. package/dist/core/turn_classifier.d.ts.map +1 -0
  307. package/dist/core/turn_classifier.js +213 -0
  308. package/dist/core/turn_classifier.js.map +1 -0
  309. package/dist/core/whats_new.d.ts +42 -0
  310. package/dist/core/whats_new.d.ts.map +1 -0
  311. package/dist/core/whats_new.js +214 -0
  312. package/dist/core/whats_new.js.map +1 -0
  313. package/dist/deploy/adapter.d.ts +93 -0
  314. package/dist/deploy/adapter.d.ts.map +1 -0
  315. package/dist/deploy/adapter.js +42 -0
  316. package/dist/deploy/adapter.js.map +1 -0
  317. package/dist/deploy/aws_adapter.d.ts +28 -0
  318. package/dist/deploy/aws_adapter.d.ts.map +1 -0
  319. package/dist/deploy/aws_adapter.js +98 -0
  320. package/dist/deploy/aws_adapter.js.map +1 -0
  321. package/dist/deploy/cloudflare.d.ts +24 -0
  322. package/dist/deploy/cloudflare.d.ts.map +1 -0
  323. package/dist/deploy/cloudflare.js +169 -0
  324. package/dist/deploy/cloudflare.js.map +1 -0
  325. package/dist/docs/LIMITED_RESPONSIBILITY.md +216 -0
  326. package/dist/docs/PRIVACY_POLICY.md +169 -0
  327. package/dist/docs/SQ.md +1397 -0
  328. package/dist/docs/SQ_BY_STEP.yaml +147 -0
  329. package/dist/docs/doctrine/accessibility.md +78 -0
  330. package/dist/docs/doctrine/agent-orchestrator.md +76 -0
  331. package/dist/docs/doctrine/byok-vs-managed.md +81 -0
  332. package/dist/docs/doctrine/cost-router-escalation.md +73 -0
  333. package/dist/docs/doctrine/explain-results.md +90 -0
  334. package/dist/docs/doctrine/g-doc.md +46 -0
  335. package/dist/docs/doctrine/gates.md +21 -0
  336. package/dist/docs/doctrine/lessons-workflow.md +68 -0
  337. package/dist/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  338. package/dist/docs/doctrine/nac3-attrs.md +23 -0
  339. package/dist/docs/doctrine/office-tools.md +102 -0
  340. package/dist/docs/doctrine/pizarron.md +52 -0
  341. package/dist/docs/doctrine/r8-modal.md +60 -0
  342. package/dist/docs/doctrine/safety-refusals.md +73 -0
  343. package/dist/docs/doctrine/verb-composition.md +68 -0
  344. package/dist/docs/doctrine/workflow-phases.md +108 -0
  345. package/dist/docs/doctrine/workflow.md +58 -0
  346. package/dist/docs/doctrine/yf-commands.md +49 -0
  347. package/dist/json/query.d.ts +38 -0
  348. package/dist/json/query.d.ts.map +1 -0
  349. package/dist/json/query.js +177 -0
  350. package/dist/json/query.js.map +1 -0
  351. package/dist/license/hito4_client.d.ts +19 -0
  352. package/dist/license/hito4_client.d.ts.map +1 -1
  353. package/dist/license/hito4_client.js +110 -0
  354. package/dist/license/hito4_client.js.map +1 -1
  355. package/dist/license/index.d.ts.map +1 -1
  356. package/dist/license/index.js +7 -0
  357. package/dist/license/index.js.map +1 -1
  358. package/dist/license/sync.d.ts +54 -0
  359. package/dist/license/sync.d.ts.map +1 -0
  360. package/dist/license/sync.js +138 -0
  361. package/dist/license/sync.js.map +1 -0
  362. package/dist/llm/cohere_client.d.ts +81 -0
  363. package/dist/llm/cohere_client.d.ts.map +1 -0
  364. package/dist/llm/cohere_client.js +195 -0
  365. package/dist/llm/cohere_client.js.map +1 -0
  366. package/dist/llm/deepseek_client.d.ts +63 -0
  367. package/dist/llm/deepseek_client.d.ts.map +1 -0
  368. package/dist/llm/deepseek_client.js +188 -0
  369. package/dist/llm/deepseek_client.js.map +1 -0
  370. package/dist/llm/gemini_client.d.ts +78 -0
  371. package/dist/llm/gemini_client.d.ts.map +1 -0
  372. package/dist/llm/gemini_client.js +189 -0
  373. package/dist/llm/gemini_client.js.map +1 -0
  374. package/dist/llm/managed_client.d.ts +70 -0
  375. package/dist/llm/managed_client.d.ts.map +1 -0
  376. package/dist/llm/managed_client.js +251 -0
  377. package/dist/llm/managed_client.js.map +1 -0
  378. package/dist/llm/mistral_client.d.ts +54 -0
  379. package/dist/llm/mistral_client.d.ts.map +1 -0
  380. package/dist/llm/mistral_client.js +174 -0
  381. package/dist/llm/mistral_client.js.map +1 -0
  382. package/dist/llm/multi_provider_client.d.ts +57 -0
  383. package/dist/llm/multi_provider_client.d.ts.map +1 -0
  384. package/dist/llm/multi_provider_client.js +109 -0
  385. package/dist/llm/multi_provider_client.js.map +1 -0
  386. package/dist/llm/openai_client.d.ts +77 -0
  387. package/dist/llm/openai_client.d.ts.map +1 -0
  388. package/dist/llm/openai_client.js +200 -0
  389. package/dist/llm/openai_client.js.map +1 -0
  390. package/dist/llm/xai_client.d.ts +51 -0
  391. package/dist/llm/xai_client.d.ts.map +1 -0
  392. package/dist/llm/xai_client.js +174 -0
  393. package/dist/llm/xai_client.js.map +1 -0
  394. package/dist/mcp/bridge_registry.d.ts +77 -0
  395. package/dist/mcp/bridge_registry.d.ts.map +1 -0
  396. package/dist/mcp/bridge_registry.js +220 -0
  397. package/dist/mcp/bridge_registry.js.map +1 -0
  398. package/dist/mcp/config.d.ts +25 -0
  399. package/dist/mcp/config.d.ts.map +1 -0
  400. package/dist/mcp/config.js +116 -0
  401. package/dist/mcp/config.js.map +1 -0
  402. package/dist/mcp/protocol_client.d.ts +63 -0
  403. package/dist/mcp/protocol_client.d.ts.map +1 -0
  404. package/dist/mcp/protocol_client.js +340 -0
  405. package/dist/mcp/protocol_client.js.map +1 -0
  406. package/dist/mcp/state.d.ts +38 -0
  407. package/dist/mcp/state.d.ts.map +1 -0
  408. package/dist/mcp/state.js +144 -0
  409. package/dist/mcp/state.js.map +1 -0
  410. package/dist/migrate/ai-decorator.d.ts.map +1 -1
  411. package/dist/migrate/ai-decorator.js +33 -145
  412. package/dist/migrate/ai-decorator.js.map +1 -1
  413. package/dist/nac3/approval_queue.d.ts +36 -0
  414. package/dist/nac3/approval_queue.d.ts.map +1 -0
  415. package/dist/nac3/approval_queue.js +105 -0
  416. package/dist/nac3/approval_queue.js.map +1 -0
  417. package/dist/nac3/backend_tools.d.ts +89 -0
  418. package/dist/nac3/backend_tools.d.ts.map +1 -0
  419. package/dist/nac3/backend_tools.js +271 -0
  420. package/dist/nac3/backend_tools.js.map +1 -0
  421. package/dist/nac3/dispatch_log.d.ts +35 -0
  422. package/dist/nac3/dispatch_log.d.ts.map +1 -0
  423. package/dist/nac3/dispatch_log.js +126 -0
  424. package/dist/nac3/dispatch_log.js.map +1 -0
  425. package/dist/nac3/internal_manifest.d.ts +62 -0
  426. package/dist/nac3/internal_manifest.d.ts.map +1 -0
  427. package/dist/nac3/internal_manifest.js +1846 -0
  428. package/dist/nac3/internal_manifest.js.map +1 -0
  429. package/dist/nac3/manifest_lazy.d.ts +71 -0
  430. package/dist/nac3/manifest_lazy.d.ts.map +1 -0
  431. package/dist/nac3/manifest_lazy.js +141 -0
  432. package/dist/nac3/manifest_lazy.js.map +1 -0
  433. package/dist/nac3/verb_tier_map.d.ts +80 -0
  434. package/dist/nac3/verb_tier_map.d.ts.map +1 -0
  435. package/dist/nac3/verb_tier_map.js +159 -0
  436. package/dist/nac3/verb_tier_map.js.map +1 -0
  437. package/dist/office/excel.d.ts +110 -0
  438. package/dist/office/excel.d.ts.map +1 -0
  439. package/dist/office/excel.js +276 -0
  440. package/dist/office/excel.js.map +1 -0
  441. package/dist/office/pdf.d.ts +35 -0
  442. package/dist/office/pdf.d.ts.map +1 -0
  443. package/dist/office/pdf.js +70 -0
  444. package/dist/office/pdf.js.map +1 -0
  445. package/dist/office/word.d.ts +64 -0
  446. package/dist/office/word.d.ts.map +1 -0
  447. package/dist/office/word.js +243 -0
  448. package/dist/office/word.js.map +1 -0
  449. package/dist/qa/brain_matrix/ab_runner.d.ts +44 -0
  450. package/dist/qa/brain_matrix/ab_runner.d.ts.map +1 -0
  451. package/dist/qa/brain_matrix/ab_runner.js +144 -0
  452. package/dist/qa/brain_matrix/ab_runner.js.map +1 -0
  453. package/dist/qa/brain_matrix/brains.json +80 -0
  454. package/dist/qa/brain_matrix/compare.d.ts +27 -0
  455. package/dist/qa/brain_matrix/compare.d.ts.map +1 -0
  456. package/dist/qa/brain_matrix/compare.js +122 -0
  457. package/dist/qa/brain_matrix/compare.js.map +1 -0
  458. package/dist/qa/brain_matrix/fake_brain.d.ts +36 -0
  459. package/dist/qa/brain_matrix/fake_brain.d.ts.map +1 -0
  460. package/dist/qa/brain_matrix/fake_brain.js +27 -0
  461. package/dist/qa/brain_matrix/fake_brain.js.map +1 -0
  462. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_intent.json +22 -0
  463. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_no_speak_default.json +23 -0
  464. package/dist/qa/brain_matrix/fixtures/scenario_a11y_consecutive_announces.json +37 -0
  465. package/dist/qa/brain_matrix/fixtures/scenario_a11y_focus_after_action.json +22 -0
  466. package/dist/qa/brain_matrix/fixtures/scenario_a11y_label_with_shortcut.json +22 -0
  467. package/dist/qa/brain_matrix/fixtures/scenario_announce_min_tool_calls.json +23 -0
  468. package/dist/qa/brain_matrix/fixtures/scenario_app_invoke_happy_path.json +65 -0
  469. package/dist/qa/brain_matrix/fixtures/scenario_app_no_invent_without_backend.json +18 -0
  470. package/dist/qa/brain_matrix/fixtures/scenario_app_schema_fail_recover.json +48 -0
  471. package/dist/qa/brain_matrix/fixtures/scenario_approval_modal_no_redundancy.json +21 -0
  472. package/dist/qa/brain_matrix/fixtures/scenario_args_redacted_in_audit.json +17 -0
  473. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent.json +19 -0
  474. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent_en.json +19 -0
  475. package/dist/qa/brain_matrix/fixtures/scenario_audit_log_on_destructive.json +18 -0
  476. package/dist/qa/brain_matrix/fixtures/scenario_brain_explains_after_invoke.json +28 -0
  477. package/dist/qa/brain_matrix/fixtures/scenario_byok_on_managed_brain_overflow.json +28 -0
  478. package/dist/qa/brain_matrix/fixtures/scenario_byok_required_policy.json +35 -0
  479. package/dist/qa/brain_matrix/fixtures/scenario_concise_no_loop.json +23 -0
  480. package/dist/qa/brain_matrix/fixtures/scenario_consult_nac_spec_intent.json +19 -0
  481. package/dist/qa/brain_matrix/fixtures/scenario_contradiction_rfp_cost.json +38 -0
  482. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_attachment_frontier.json +24 -0
  483. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_escalation_explicit.json +23 -0
  484. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_idle_reset.json +24 -0
  485. package/dist/qa/brain_matrix/fixtures/scenario_csv_via_excel_read.json +22 -0
  486. package/dist/qa/brain_matrix/fixtures/scenario_destructive_no_text_confirm.json +20 -0
  487. package/dist/qa/brain_matrix/fixtures/scenario_diff_explains_changes.json +32 -0
  488. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_after_unknown_intent.json +17 -0
  489. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_a11y.json +24 -0
  490. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_agent_orchestrator.json +24 -0
  491. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_byok_vs_managed.json +24 -0
  492. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_cost_router.json +24 -0
  493. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_g_doc.json +24 -0
  494. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_gates.json +23 -0
  495. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_intent_en.json +19 -0
  496. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_lessons_workflow.json +24 -0
  497. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_mcp_lifecycle.json +24 -0
  498. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_nac3_attrs.json +24 -0
  499. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_office.json +24 -0
  500. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_pizarron.json +23 -0
  501. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_r8_modal.json +23 -0
  502. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow.json +23 -0
  503. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow_phases.json +24 -0
  504. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_yf_commands.json +24 -0
  505. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_explain_results.json +22 -0
  506. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_safety_refusals.json +22 -0
  507. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_verb_composition.json +22 -0
  508. package/dist/qa/brain_matrix/fixtures/scenario_eco_defers_complex.json +17 -0
  509. package/dist/qa/brain_matrix/fixtures/scenario_eco_short_query.json +27 -0
  510. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent.json +20 -0
  511. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent_en.json +20 -0
  512. package/dist/qa/brain_matrix/fixtures/scenario_env_no_secret_leak.json +21 -0
  513. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression.json +35 -0
  514. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression_en.json +21 -0
  515. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_handles_csv_refusal.json +28 -0
  516. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent.json +20 -0
  517. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent_en.json +20 -0
  518. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_then_list.json +34 -0
  519. package/dist/qa/brain_matrix/fixtures/scenario_excel_list_sheets_first.json +22 -0
  520. package/dist/qa/brain_matrix/fixtures/scenario_excel_sheet_named.json +23 -0
  521. package/dist/qa/brain_matrix/fixtures/scenario_explain_voice_yes.json +22 -0
  522. package/dist/qa/brain_matrix/fixtures/scenario_explains_forge_error.json +39 -0
  523. package/dist/qa/brain_matrix/fixtures/scenario_focus_after_modal_open.json +29 -0
  524. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent.json +21 -0
  525. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent_en.json +20 -0
  526. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_with_glob.json +22 -0
  527. package/dist/qa/brain_matrix/fixtures/scenario_fs_mkdir_intent.json +20 -0
  528. package/dist/qa/brain_matrix/fixtures/scenario_fs_move_intent.json +20 -0
  529. package/dist/qa/brain_matrix/fixtures/scenario_fs_read_handles_missing.json +28 -0
  530. package/dist/qa/brain_matrix/fixtures/scenario_fs_stat_before_read.json +22 -0
  531. package/dist/qa/brain_matrix/fixtures/scenario_generated_app_nac3_default.json +24 -0
  532. package/dist/qa/brain_matrix/fixtures/scenario_git_branch_list_intent.json +20 -0
  533. package/dist/qa/brain_matrix/fixtures/scenario_git_diff_intent.json +20 -0
  534. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent.json +20 -0
  535. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent_en.json +20 -0
  536. package/dist/qa/brain_matrix/fixtures/scenario_git_pull_intent.json +19 -0
  537. package/dist/qa/brain_matrix/fixtures/scenario_git_push_intent.json +20 -0
  538. package/dist/qa/brain_matrix/fixtures/scenario_git_show_metadata_only.json +22 -0
  539. package/dist/qa/brain_matrix/fixtures/scenario_git_status_branch_combo.json +44 -0
  540. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent.json +20 -0
  541. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent_en.json +20 -0
  542. package/dist/qa/brain_matrix/fixtures/scenario_github_clone_repo_intent.json +20 -0
  543. package/dist/qa/brain_matrix/fixtures/scenario_github_create_repo_intent.json +20 -0
  544. package/dist/qa/brain_matrix/fixtures/scenario_id_format_in_reply.json +27 -0
  545. package/dist/qa/brain_matrix/fixtures/scenario_iterations_idempotent_adenda.json +27 -0
  546. package/dist/qa/brain_matrix/fixtures/scenario_iterations_query_history.json +29 -0
  547. package/dist/qa/brain_matrix/fixtures/scenario_iterations_tracker_acknowledge.json +28 -0
  548. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_handles_malformed.json +34 -0
  549. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent.json +30 -0
  550. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent_en.json +30 -0
  551. package/dist/qa/brain_matrix/fixtures/scenario_json_query_extract.json +23 -0
  552. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent.json +20 -0
  553. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent_en.json +20 -0
  554. package/dist/qa/brain_matrix/fixtures/scenario_keys_set_intent.json +20 -0
  555. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent.json +20 -0
  556. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent_en.json +20 -0
  557. package/dist/qa/brain_matrix/fixtures/scenario_lazy_complex_verb.json +27 -0
  558. package/dist/qa/brain_matrix/fixtures/scenario_lazy_doctrine_only_when_needed.json +17 -0
  559. package/dist/qa/brain_matrix/fixtures/scenario_lazy_simple_verb.json +21 -0
  560. package/dist/qa/brain_matrix/fixtures/scenario_lesson_recall_overrides.json +22 -0
  561. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_restart_app_intent.json +19 -0
  562. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent.json +19 -0
  563. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent_en.json +19 -0
  564. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent.json +20 -0
  565. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent_en.json +20 -0
  566. package/dist/qa/brain_matrix/fixtures/scenario_long_doctrine_no_truncate.json +23 -0
  567. package/dist/qa/brain_matrix/fixtures/scenario_manifest_read_intent.json +19 -0
  568. package/dist/qa/brain_matrix/fixtures/scenario_manual_open_intent.json +19 -0
  569. package/dist/qa/brain_matrix/fixtures/scenario_mcp_bridge_unreachable_graceful.json +39 -0
  570. package/dist/qa/brain_matrix/fixtures/scenario_mcp_disabled_bridge_no_verbs.json +18 -0
  571. package/dist/qa/brain_matrix/fixtures/scenario_mcp_discover_tools_intent.json +19 -0
  572. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invariant_1_no_verbs.json +19 -0
  573. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_two_hop.json +68 -0
  574. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_with_auth_loaded.json +76 -0
  575. package/dist/qa/brain_matrix/fixtures/scenario_mcp_revoked_token_graceful.json +33 -0
  576. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_intent.json +21 -0
  577. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_no_token_arg.json +27 -0
  578. package/dist/qa/brain_matrix/fixtures/scenario_mcp_show_tools_before_invoke.json +44 -0
  579. package/dist/qa/brain_matrix/fixtures/scenario_mcp_toggle_intent.json +20 -0
  580. package/dist/qa/brain_matrix/fixtures/scenario_multi_turn_clarify_then_act.json +24 -0
  581. package/dist/qa/brain_matrix/fixtures/scenario_nac3_attrs_doctrine.json +53 -0
  582. package/dist/qa/brain_matrix/fixtures/scenario_nac3_discover_schemas_intent.json +19 -0
  583. package/dist/qa/brain_matrix/fixtures/scenario_nac3_required_attr_missing.json +19 -0
  584. package/dist/qa/brain_matrix/fixtures/scenario_no_bare_ok_after_destructive.json +27 -0
  585. package/dist/qa/brain_matrix/fixtures/scenario_no_global_learnings_no_recall.json +20 -0
  586. package/dist/qa/brain_matrix/fixtures/scenario_no_id_leak_in_reply.json +24 -0
  587. package/dist/qa/brain_matrix/fixtures/scenario_no_invent_verb.json +18 -0
  588. package/dist/qa/brain_matrix/fixtures/scenario_no_loop_after_repeated_fail.json +42 -0
  589. package/dist/qa/brain_matrix/fixtures/scenario_no_password_echo.json +28 -0
  590. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_all_current.json +28 -0
  591. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent.json +20 -0
  592. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent_en.json +20 -0
  593. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_then_explain.json +35 -0
  594. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_read_intent.json +24 -0
  595. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_write_required_args.json +23 -0
  596. package/dist/qa/brain_matrix/fixtures/scenario_office_overwrite_explicit.json +23 -0
  597. package/dist/qa/brain_matrix/fixtures/scenario_office_word_write_intent.json +27 -0
  598. package/dist/qa/brain_matrix/fixtures/scenario_panel_open_settings_intent.json +19 -0
  599. package/dist/qa/brain_matrix/fixtures/scenario_panel_send_message_intent.json +19 -0
  600. package/dist/qa/brain_matrix/fixtures/scenario_pdf_read_intent.json +22 -0
  601. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_clear_tab_explicit_close.json +17 -0
  602. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_chart.json +30 -0
  603. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_long_table.json +28 -0
  604. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_read_tab_intent.json +20 -0
  605. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_render_not_inline.json +20 -0
  606. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_read_file.json +28 -0
  607. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_verb_over_shell.json +22 -0
  608. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_workflow_state.json +28 -0
  609. package/dist/qa/brain_matrix/fixtures/scenario_project_init_intent.json +20 -0
  610. package/dist/qa/brain_matrix/fixtures/scenario_project_set_root_intent.json +20 -0
  611. package/dist/qa/brain_matrix/fixtures/scenario_promote_lesson_after_correction.json +17 -0
  612. package/dist/qa/brain_matrix/fixtures/scenario_r8_destructive_shell_exec.json +21 -0
  613. package/dist/qa/brain_matrix/fixtures/scenario_read_then_parse_order.json +36 -0
  614. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_jump_intent.json +19 -0
  615. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_set_intent.json +19 -0
  616. package/dist/qa/brain_matrix/fixtures/scenario_reader_for_long_doc.json +21 -0
  617. package/dist/qa/brain_matrix/fixtures/scenario_reader_list_docs_intent.json +19 -0
  618. package/dist/qa/brain_matrix/fixtures/scenario_reader_next_block_intent.json +19 -0
  619. package/dist/qa/brain_matrix/fixtures/scenario_reader_read_section_intent.json +19 -0
  620. package/dist/qa/brain_matrix/fixtures/scenario_reader_recap_intent.json +19 -0
  621. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent.json +20 -0
  622. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent_en.json +20 -0
  623. package/dist/qa/brain_matrix/fixtures/scenario_refuses_blanket_chmod_777.json +17 -0
  624. package/dist/qa/brain_matrix/fixtures/scenario_refuses_bypass_approval_modal.json +18 -0
  625. package/dist/qa/brain_matrix/fixtures/scenario_refuses_delete_critical_en.json +18 -0
  626. package/dist/qa/brain_matrix/fixtures/scenario_refuses_disable_vault_encryption.json +18 -0
  627. package/dist/qa/brain_matrix/fixtures/scenario_refuses_drop_database.json +17 -0
  628. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main.json +17 -0
  629. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main_en.json +17 -0
  630. package/dist/qa/brain_matrix/fixtures/scenario_refuses_leak_vault_en.json +18 -0
  631. package/dist/qa/brain_matrix/fixtures/scenario_refuses_modify_node_modules.json +17 -0
  632. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks.json +17 -0
  633. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks_en.json +17 -0
  634. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_delete_critical.json +18 -0
  635. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_leak_vault.json +18 -0
  636. package/dist/qa/brain_matrix/fixtures/scenario_respects_global_learnings.json +28 -0
  637. package/dist/qa/brain_matrix/fixtures/scenario_respects_workflow_gate_g2.json +39 -0
  638. package/dist/qa/brain_matrix/fixtures/scenario_revoke_lesson_request.json +21 -0
  639. package/dist/qa/brain_matrix/fixtures/scenario_sq_rules_active.json +30 -0
  640. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent.json +20 -0
  641. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent_en.json +20 -0
  642. package/dist/qa/brain_matrix/fixtures/scenario_truncated_response_retry.json +22 -0
  643. package/dist/qa/brain_matrix/fixtures/scenario_unknown_command_clarify.json +23 -0
  644. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_compose.json +23 -0
  645. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_handles_invalid.json +27 -0
  646. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent.json +20 -0
  647. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent_en.json +20 -0
  648. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_then_inspect_query.json +28 -0
  649. package/dist/qa/brain_matrix/fixtures/scenario_url_then_stringify_order.json +34 -0
  650. package/dist/qa/brain_matrix/fixtures/scenario_user_just_greets.json +17 -0
  651. package/dist/qa/brain_matrix/fixtures/scenario_user_overrides_proceeds.json +24 -0
  652. package/dist/qa/brain_matrix/fixtures/scenario_user_revokes_in_middle.json +22 -0
  653. package/dist/qa/brain_matrix/fixtures/scenario_voice_open_pizarron.json +21 -0
  654. package/dist/qa/brain_matrix/fixtures/scenario_word_outline_extraction.json +22 -0
  655. package/dist/qa/brain_matrix/fixtures/scenario_word_overwrite_explicit.json +20 -0
  656. package/dist/qa/brain_matrix/fixtures/scenario_word_section_count.json +28 -0
  657. package/dist/qa/brain_matrix/fixtures/scenario_workflow_doctrine.json +53 -0
  658. package/dist/qa/brain_matrix/fixtures/scenario_workflow_done_specs.json +32 -0
  659. package/dist/qa/brain_matrix/fixtures/scenario_workflow_intent_capture.json +22 -0
  660. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_jump_block.json +26 -0
  661. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_v_step_15.json +41 -0
  662. package/dist/qa/brain_matrix/fixtures/scenario_workflow_run_step_intent.json +19 -0
  663. package/dist/qa/brain_matrix/fixtures/scenario_workflow_set_intent.json +20 -0
  664. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_injection.json +32 -0
  665. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_recovers_after_clarify.json +25 -0
  666. package/dist/qa/brain_matrix/fixtures/scenario_workflow_step_1_intake.json +24 -0
  667. package/dist/qa/brain_matrix/fixtures/scenario_yf_command_doctrine.json +56 -0
  668. package/dist/qa/brain_matrix/fixtures/scenario_yf_doctrine_list_intent.json +19 -0
  669. package/dist/qa/brain_matrix/fixtures/scenario_yf_qa_compare_intent.json +17 -0
  670. package/dist/qa/brain_matrix/invariants.d.ts +18 -0
  671. package/dist/qa/brain_matrix/invariants.d.ts.map +1 -0
  672. package/dist/qa/brain_matrix/invariants.js +333 -0
  673. package/dist/qa/brain_matrix/invariants.js.map +1 -0
  674. package/dist/qa/brain_matrix/report.d.ts +12 -0
  675. package/dist/qa/brain_matrix/report.d.ts.map +1 -0
  676. package/dist/qa/brain_matrix/report.js +131 -0
  677. package/dist/qa/brain_matrix/report.js.map +1 -0
  678. package/dist/qa/brain_matrix/runner.d.ts +31 -0
  679. package/dist/qa/brain_matrix/runner.d.ts.map +1 -0
  680. package/dist/qa/brain_matrix/runner.js +561 -0
  681. package/dist/qa/brain_matrix/runner.js.map +1 -0
  682. package/dist/qa/brain_matrix/types.d.ts +180 -0
  683. package/dist/qa/brain_matrix/types.d.ts.map +1 -0
  684. package/dist/qa/brain_matrix/types.js +2 -0
  685. package/dist/qa/brain_matrix/types.js.map +1 -0
  686. package/dist/qa/brain_matrix/validate_scenario.d.ts +23 -0
  687. package/dist/qa/brain_matrix/validate_scenario.d.ts.map +1 -0
  688. package/dist/qa/brain_matrix/validate_scenario.js +128 -0
  689. package/dist/qa/brain_matrix/validate_scenario.js.map +1 -0
  690. package/dist/support/github_dispatcher.d.ts +36 -0
  691. package/dist/support/github_dispatcher.d.ts.map +1 -0
  692. package/dist/support/github_dispatcher.js +292 -0
  693. package/dist/support/github_dispatcher.js.map +1 -0
  694. package/dist/support/reports.d.ts +31 -0
  695. package/dist/support/reports.d.ts.map +1 -0
  696. package/dist/support/reports.js +162 -0
  697. package/dist/support/reports.js.map +1 -0
  698. package/dist/telemetry/usage.d.ts +67 -0
  699. package/dist/telemetry/usage.d.ts.map +1 -0
  700. package/dist/telemetry/usage.js +208 -0
  701. package/dist/telemetry/usage.js.map +1 -0
  702. package/dist/version.d.ts +1 -1
  703. package/dist/version.d.ts.map +1 -1
  704. package/dist/version.js +1 -1
  705. package/dist/version.js.map +1 -1
  706. package/dist/voice/config.d.ts +12 -0
  707. package/dist/voice/config.d.ts.map +1 -1
  708. package/dist/voice/config.js +25 -2
  709. package/dist/voice/config.js.map +1 -1
  710. package/dist/voice/providers/google.d.ts +9 -0
  711. package/dist/voice/providers/google.d.ts.map +1 -1
  712. package/dist/voice/providers/google.js +197 -28
  713. package/dist/voice/providers/google.js.map +1 -1
  714. package/dist/voice/router.d.ts +10 -0
  715. package/dist/voice/router.d.ts.map +1 -1
  716. package/dist/voice/router.js +39 -20
  717. package/dist/voice/router.js.map +1 -1
  718. package/dist/voice/types.d.ts +5 -2
  719. package/dist/voice/types.d.ts.map +1 -1
  720. package/dist/voice/types.js.map +1 -1
  721. package/dist/workflow/phase_inference.d.ts +56 -0
  722. package/dist/workflow/phase_inference.d.ts.map +1 -0
  723. package/dist/workflow/phase_inference.js +107 -0
  724. package/dist/workflow/phase_inference.js.map +1 -0
  725. package/dist/workflow/state.d.ts +238 -0
  726. package/dist/workflow/state.d.ts.map +1 -0
  727. package/dist/workflow/state.js +213 -0
  728. package/dist/workflow/state.js.map +1 -0
  729. package/docs/SQ.md +1397 -0
  730. package/docs/SQ_BY_STEP.yaml +147 -0
  731. package/docs/doctrine/accessibility.md +78 -0
  732. package/docs/doctrine/agent-orchestrator.md +76 -0
  733. package/docs/doctrine/byok-vs-managed.md +81 -0
  734. package/docs/doctrine/cost-router-escalation.md +73 -0
  735. package/docs/doctrine/explain-results.md +90 -0
  736. package/docs/doctrine/g-doc.md +46 -0
  737. package/docs/doctrine/gates.md +21 -0
  738. package/docs/doctrine/lessons-workflow.md +68 -0
  739. package/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  740. package/docs/doctrine/nac3-attrs.md +23 -0
  741. package/docs/doctrine/office-tools.md +102 -0
  742. package/docs/doctrine/pizarron.md +52 -0
  743. package/docs/doctrine/r8-modal.md +60 -0
  744. package/docs/doctrine/safety-refusals.md +73 -0
  745. package/docs/doctrine/verb-composition.md +68 -0
  746. package/docs/doctrine/workflow-phases.md +108 -0
  747. package/docs/doctrine/workflow.md +58 -0
  748. package/docs/doctrine/yf-commands.md +49 -0
  749. package/package.json +20 -14
  750. package/src/i18n/catalogs/ar.json +55 -10
  751. package/src/i18n/catalogs/de.json +55 -10
  752. package/src/i18n/catalogs/en.json +66 -1
  753. package/src/i18n/catalogs/es.json +66 -1
  754. package/src/i18n/catalogs/fr.json +55 -10
  755. package/src/i18n/catalogs/hi.json +55 -10
  756. package/src/i18n/catalogs/it.json +55 -10
  757. package/src/i18n/catalogs/ja.json +55 -10
  758. package/src/i18n/catalogs/pt.json +55 -10
  759. package/src/i18n/catalogs/zh.json +55 -10
  760. package/templates/nextjs-app/README.md +48 -0
  761. package/templates/nextjs-app/next.config.js +8 -0
  762. package/templates/nextjs-app/package.json +33 -0
  763. package/templates/nextjs-app/src/app/globals.css +43 -0
  764. package/templates/nextjs-app/src/app/layout.tsx +29 -0
  765. package/templates/nextjs-app/src/app/page.tsx +63 -0
  766. package/templates/nextjs-app/src/nac/manifest.ts +36 -0
  767. package/templates/nextjs-app/tsconfig.json +21 -0
  768. package/templates/nextjs-app/yujin.forge.json +11 -0
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Default agents Forge ships on first install (HITO 5 slice 3).
3
+ *
4
+ * Defined in code (not JSON files) so the build does not need
5
+ * to copy assets + the canonical shape is statically checked
6
+ * against AgentDefinition. The `yf agent install --defaults`
7
+ * CLI writes these to `~/.yujin-forge/agents/by-slug/<slug>/`
8
+ * via `saveAgentDefinition` -- the same path users edit later.
9
+ *
10
+ * Per HITO 5 lock 2026-06-04, the two seeded agents are:
11
+ * - agent:brain-matrix-nightly-watcher (the dogfood, #6 in
12
+ * the clarification list)
13
+ * - agent:web-search (the delegate that
14
+ * other agents whitelist for web search; resolves the
15
+ * "web search as a verb" item)
16
+ */
17
+ import type { AgentDefinition } from './types.js';
18
+ export declare const BRAIN_MATRIX_NIGHTLY_WATCHER: AgentDefinition;
19
+ export declare const WEB_SEARCH_AGENT: AgentDefinition;
20
+ export declare const DEFAULT_AGENTS: readonly AgentDefinition[];
21
+ //# sourceMappingURL=defaults.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/agents/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,eAAO,MAAM,4BAA4B,EAAE,eA6B1C,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eA+B9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EAGpD,CAAC"}
@@ -0,0 +1,56 @@
1
+ import { buildAgentDefinitionDraft } from './store.js';
2
+ export const BRAIN_MATRIX_NIGHTLY_WATCHER = buildAgentDefinitionDraft('brain-matrix-nightly-watcher', 'Brain matrix nightly watcher', {
3
+ description: 'Runs the brain matrix gate every 24h + opens an issue on regression. Dogfood agent.',
4
+ brain_tier: 'eco',
5
+ trigger: {
6
+ kind: 'cron',
7
+ config: { cron_expr: '0 8 * * *' }, /* 08:00 UTC daily; user can edit. */
8
+ },
9
+ can_call: [],
10
+ can_be_called_by: [],
11
+ allowed_verbs: [
12
+ /* Read-only on the local repo + report via Slack/GitHub. */
13
+ 'yujin.fs.read',
14
+ 'yujin.fs.find',
15
+ 'yujin.git.status',
16
+ 'yujin.git.branch-list',
17
+ 'yujin.git.log',
18
+ 'yujin.shell.exec', /* needed to run `pnpm run brain-matrix:gate` */
19
+ ],
20
+ prompt_addition: 'Tu trabajo: correr `pnpm run brain-matrix:gate`, parsear el output,'
21
+ + ' y reportar el conteo de pass/fail/err. Si el conteo de fail o err'
22
+ + ' creció desde la última corrida, abrir un issue en GitHub con el'
23
+ + ' diff. Si no, terminar sin posting. NO modificar fixtures ni código.',
24
+ status: 'active',
25
+ });
26
+ export const WEB_SEARCH_AGENT = buildAgentDefinitionDraft('web-search', 'Web search delegate', {
27
+ description: 'Web search via Brave/Tavily/Google. Other agents whitelist this slug to delegate searches without owning the API key.',
28
+ brain_tier: 'managed',
29
+ trigger: {
30
+ kind: 'manual', /* invoked by bridge messages from other agents */
31
+ config: {},
32
+ },
33
+ can_call: [],
34
+ /* Open whitelist: any agent can call us. The pair-level token
35
+ * cap + loop detector keep abuse in check. */
36
+ can_be_called_by: ['*'],
37
+ allowed_verbs: [
38
+ /* Only the search itself + the JSON helpers needed to
39
+ * normalize results. */
40
+ 'yujin.json.stringify',
41
+ 'yujin.json.parse',
42
+ 'yujin.url.parse',
43
+ ],
44
+ prompt_addition: 'You are the web-search delegate. Other agents send you a search query'
45
+ + ' via the inter-agent bridge. Use the configured provider'
46
+ + ' (agent.web_search.provider) to run the search, normalize the top 5'
47
+ + ' results into {title, url, snippet, published_at}, and reply via'
48
+ + ' the same bridge. Respect the daily query cap'
49
+ + ' (agent.web_search.daily_query_cap).',
50
+ status: 'active',
51
+ });
52
+ export const DEFAULT_AGENTS = [
53
+ BRAIN_MATRIX_NIGHTLY_WATCHER,
54
+ WEB_SEARCH_AGENT,
55
+ ];
56
+ //# sourceMappingURL=defaults.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/agents/defaults.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,CAAC,MAAM,4BAA4B,GAAoB,yBAAyB,CACpF,8BAA8B,EAC9B,8BAA8B,EAC9B;IACE,WAAW,EACT,qFAAqF;IACvF,UAAU,EAAE,KAAK;IACjB,OAAO,EAAE;QACP,IAAI,EAAI,MAAM;QACd,MAAM,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,EAAG,qCAAqC;KAC3E;IACD,QAAQ,EAAE,EAAE;IACZ,gBAAgB,EAAE,EAAE;IACpB,aAAa,EAAE;QACb,4DAA4D;QAC5D,eAAe;QACf,eAAe;QACf,kBAAkB;QAClB,uBAAuB;QACvB,eAAe;QACf,kBAAkB,EAAG,gDAAgD;KACtE;IACD,eAAe,EACb,qEAAqE;UACnE,oEAAoE;UACpE,kEAAkE;UAClE,sEAAsE;IAC1E,MAAM,EAAE,QAAQ;CACjB,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAoB,yBAAyB,CACxE,YAAY,EACZ,qBAAqB,EACrB;IACE,WAAW,EACT,uHAAuH;IACzH,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE;QACP,IAAI,EAAI,QAAQ,EAAG,kDAAkD;QACrE,MAAM,EAAE,EAAE;KACX;IACD,QAAQ,EAAE,EAAE;IACZ;kDAC8C;IAC9C,gBAAgB,EAAE,CAAC,GAAG,CAAC;IACvB,aAAa,EAAE;QACb;gCACwB;QACxB,sBAAsB;QACtB,kBAAkB;QAClB,iBAAiB;KAClB;IACD,eAAe,EACb,uEAAuE;UACrE,0DAA0D;UAC1D,qEAAqE;UACrE,kEAAkE;UAClE,+CAA+C;UAC/C,sCAAsC;IAC1C,MAAM,EAAE,QAAQ;CACjB,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA+B;IACxD,4BAA4B;IAC5B,gBAAgB;CACjB,CAAC"}
@@ -0,0 +1,94 @@
1
+ /**
2
+ * Agent runner (HITO 5 slice 4).
3
+ *
4
+ * Drives a single agent through one execution attempt:
5
+ * 1. Read config (timeout, max rejected approvals).
6
+ * 2. Loop: call the injected `step` function, accumulate
7
+ * tokens/tool_calls/rejected_approvals.
8
+ * 3. Watch for kill conditions (timeout, max rejections,
9
+ * external kill signal, step returning done=true).
10
+ * 4. Persist the final AgentRun via the store.
11
+ *
12
+ * The `step` function is injected -- this slice does NOT call
13
+ * the brain directly. Slice 5 wires `step` to the real brain
14
+ * dispatch (cost router, tool catalog, manifest filtering).
15
+ * Keeping it injected here makes the runner unit-testable
16
+ * without LLM calls.
17
+ *
18
+ * Per HITO 5 lock 2026-06-04: NO hardcoded numbers. Every
19
+ * threshold comes from getAgentConfig().
20
+ */
21
+ import type { AgentDefinition, AgentRun, AgentRunStatus, AgentTriggerKind } from './types.js';
22
+ /** State passed to the injected step function each iteration. */
23
+ export interface RunState {
24
+ iteration: number;
25
+ tokens_in: number;
26
+ tokens_out: number;
27
+ tool_calls: number;
28
+ consecutive_rejected: number;
29
+ last_reply: string;
30
+ /** Wall-clock ms since run start. The step function can use
31
+ * this to back off / take checkpoints. */
32
+ elapsed_ms: number;
33
+ }
34
+ /** Result returned by one step. */
35
+ export interface StepResult {
36
+ /** Free-text reply the step produced (the brain's chat output). */
37
+ text?: string;
38
+ /** Tokens consumed THIS step (added to running totals). */
39
+ tokens_in?: number;
40
+ tokens_out?: number;
41
+ /** Tool calls THIS step made. */
42
+ tool_calls?: number;
43
+ /** True iff this step's approval was rejected. Increments the
44
+ * consecutive_rejected counter; an accepted (or no-approval)
45
+ * step resets it to 0. */
46
+ rejected_approval?: boolean;
47
+ /** True iff the step says "I am done, stop looping". */
48
+ done?: boolean;
49
+ }
50
+ export type StepFn = (state: RunState) => Promise<StepResult>;
51
+ export interface RunAgentOptions {
52
+ trigger_kind: AgentTriggerKind;
53
+ trigger_reason: string;
54
+ /** Injected step function. Slice 5 wires this to the real
55
+ * brain dispatch. Slice 4 + tests inject mocks. */
56
+ step: StepFn;
57
+ /** External kill signal. If the AbortController is aborted
58
+ * during a run, the next step boundary returns
59
+ * status='killed_user'. */
60
+ abort?: AbortSignal;
61
+ /** Override `agent.runtime.run_timeout_seconds` for this call.
62
+ * Tests use it; production callers should let config resolve. */
63
+ timeout_seconds_override?: number;
64
+ /** Override `agent.runtime.max_consecutive_rejected_approvals`
65
+ * for this call. Same constraint as above. */
66
+ max_rejected_override?: number;
67
+ /** Hard cap on iterations regardless of timeout. Prevents an
68
+ * infinite-loop step from running forever even if it claims
69
+ * not done. Default 100; configurable per-call. */
70
+ max_iterations?: number;
71
+ /** Persist the resulting AgentRun via the store. Default true.
72
+ * Tests pass false to keep the filesystem clean. */
73
+ persist?: boolean;
74
+ }
75
+ /** Run one agent through its lifecycle. */
76
+ export declare function runAgent(def: AgentDefinition, opts: RunAgentOptions): Promise<AgentRun>;
77
+ declare function runWithoutId(run: AgentRun): {
78
+ trigger_kind: AgentTriggerKind;
79
+ trigger_reason: string;
80
+ started_at: number;
81
+ ended_at: number | undefined;
82
+ status: AgentRunStatus;
83
+ tokens_in: number;
84
+ tokens_out: number;
85
+ tool_calls: number;
86
+ rejected_approvals: number;
87
+ last_reply_summary: string;
88
+ kill_reason: string | undefined;
89
+ };
90
+ export declare const __internals: {
91
+ runWithoutId: typeof runWithoutId;
92
+ };
93
+ export {};
94
+ //# sourceMappingURL=runner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9F,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB;+CAC2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;+BAE2B;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB;wDACoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb;;gCAE4B;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;sEACkE;IAClE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;mDAC+C;IAC/C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;wDAEoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;yDACqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAqBD,2CAA2C;AAC3C,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,QAAQ,CAAC,CAkInB;AAID,iBAAS,YAAY,CAAC,GAAG,EAAE,QAAQ;;;;;;;;;;;;EAclC;AAGD,eAAO,MAAM,WAAW;;CAAmB,CAAC"}
@@ -0,0 +1,165 @@
1
+ import { appendAgentRun } from './store.js';
2
+ import { getAgentConfig } from './config_resolver.js';
3
+ /** Single source of truth for run termination. */
4
+ function kill(reason, status, state, startedAt) {
5
+ return {
6
+ id: 'run-' + startedAt.toString(36) + '-' + Math.random().toString(36).slice(2, 8),
7
+ slug: 'placeholder', /* caller fills in before persist */
8
+ trigger_kind: 'manual',
9
+ trigger_reason: 'placeholder',
10
+ started_at: startedAt,
11
+ ended_at: Date.now(),
12
+ status,
13
+ tokens_in: state.tokens_in,
14
+ tokens_out: state.tokens_out,
15
+ tool_calls: state.tool_calls,
16
+ rejected_approvals: state.consecutive_rejected,
17
+ last_reply_summary: state.last_reply.slice(0, 500),
18
+ kill_reason: reason,
19
+ };
20
+ }
21
+ /** Run one agent through its lifecycle. */
22
+ export async function runAgent(def, opts) {
23
+ const startedAt = Date.now();
24
+ /* Resolve config (or use overrides for tests). */
25
+ const timeoutSeconds = opts.timeout_seconds_override
26
+ ?? (await getAgentConfig('agent.runtime.run_timeout_seconds'));
27
+ const maxRejected = opts.max_rejected_override
28
+ ?? (await getAgentConfig('agent.runtime.max_consecutive_rejected_approvals'));
29
+ const maxIterations = opts.max_iterations ?? 100;
30
+ const persist = opts.persist ?? true;
31
+ const state = {
32
+ iteration: 0,
33
+ tokens_in: 0,
34
+ tokens_out: 0,
35
+ tool_calls: 0,
36
+ consecutive_rejected: 0,
37
+ last_reply: '',
38
+ elapsed_ms: 0,
39
+ };
40
+ /* Check status pre-flight: paused / deleted / auto-revoked
41
+ * agents do not run. */
42
+ if (def.status !== 'active') {
43
+ const run = {
44
+ id: 'run-' + startedAt.toString(36) + '-' + Math.random().toString(36).slice(2, 8),
45
+ slug: def.slug,
46
+ trigger_kind: opts.trigger_kind,
47
+ trigger_reason: opts.trigger_reason,
48
+ started_at: startedAt,
49
+ ended_at: Date.now(),
50
+ status: 'failed',
51
+ tokens_in: 0,
52
+ tokens_out: 0,
53
+ tool_calls: 0,
54
+ rejected_approvals: 0,
55
+ last_reply_summary: '',
56
+ kill_reason: 'agent_status_' + def.status,
57
+ };
58
+ if (persist)
59
+ await appendAgentRun(def.slug, runWithoutId(run), {});
60
+ return run;
61
+ }
62
+ let finalStatus = 'failed';
63
+ let killReason;
64
+ try {
65
+ for (state.iteration = 0; state.iteration < maxIterations; state.iteration++) {
66
+ state.elapsed_ms = Date.now() - startedAt;
67
+ /* Timeout */
68
+ if (state.elapsed_ms / 1000 >= timeoutSeconds) {
69
+ finalStatus = 'timeout';
70
+ killReason = 'run_timeout_seconds=' + timeoutSeconds + ' exceeded';
71
+ break;
72
+ }
73
+ /* External kill signal */
74
+ if (opts.abort?.aborted) {
75
+ finalStatus = 'killed_user';
76
+ killReason = 'abort signal received';
77
+ break;
78
+ }
79
+ /* Run one step */
80
+ let result;
81
+ try {
82
+ result = await opts.step(state);
83
+ }
84
+ catch (err) {
85
+ finalStatus = 'failed';
86
+ killReason = err instanceof Error ? err.message : String(err);
87
+ break;
88
+ }
89
+ /* Apply telemetry */
90
+ state.tokens_in += result.tokens_in ?? 0;
91
+ state.tokens_out += result.tokens_out ?? 0;
92
+ state.tool_calls += result.tool_calls ?? 0;
93
+ if (result.text !== undefined)
94
+ state.last_reply = result.text;
95
+ if (result.rejected_approval) {
96
+ state.consecutive_rejected++;
97
+ }
98
+ else {
99
+ state.consecutive_rejected = 0;
100
+ }
101
+ /* Max consecutive rejections */
102
+ if (state.consecutive_rejected >= maxRejected) {
103
+ finalStatus = 'killed_rejections';
104
+ killReason = state.consecutive_rejected + ' consecutive rejected approvals (max=' + maxRejected + ')';
105
+ break;
106
+ }
107
+ /* Step says done */
108
+ if (result.done) {
109
+ finalStatus = 'succeeded';
110
+ break;
111
+ }
112
+ }
113
+ /* Loop exhausted without done: treat as success if no other
114
+ * termination already fired (the step just kept going).
115
+ * Operators can crank max_iterations if they need more. */
116
+ if (state.iteration >= maxIterations && finalStatus === 'failed') {
117
+ finalStatus = 'succeeded';
118
+ killReason = 'max_iterations reached (' + maxIterations + ')';
119
+ }
120
+ }
121
+ catch (err) {
122
+ /* This catches errors from outside opts.step -- config
123
+ * resolver failures, etc. Step errors are caught above. */
124
+ finalStatus = 'failed';
125
+ killReason = err instanceof Error ? err.message : String(err);
126
+ }
127
+ const run = {
128
+ id: 'run-' + startedAt.toString(36) + '-' + Math.random().toString(36).slice(2, 8),
129
+ slug: def.slug,
130
+ trigger_kind: opts.trigger_kind,
131
+ trigger_reason: opts.trigger_reason,
132
+ started_at: startedAt,
133
+ ended_at: Date.now(),
134
+ status: finalStatus,
135
+ tokens_in: state.tokens_in,
136
+ tokens_out: state.tokens_out,
137
+ tool_calls: state.tool_calls,
138
+ rejected_approvals: state.consecutive_rejected,
139
+ last_reply_summary: state.last_reply.slice(0, 500),
140
+ kill_reason: killReason,
141
+ };
142
+ if (persist)
143
+ await appendAgentRun(def.slug, runWithoutId(run), {});
144
+ return run;
145
+ }
146
+ /* Strip id+slug for the store's `Omit<AgentRun, 'id' | 'slug'>`
147
+ * input shape. The store generates a fresh id if absent. */
148
+ function runWithoutId(run) {
149
+ return {
150
+ trigger_kind: run.trigger_kind,
151
+ trigger_reason: run.trigger_reason,
152
+ started_at: run.started_at,
153
+ ended_at: run.ended_at,
154
+ status: run.status,
155
+ tokens_in: run.tokens_in,
156
+ tokens_out: run.tokens_out,
157
+ tool_calls: run.tool_calls,
158
+ rejected_approvals: run.rejected_approvals,
159
+ last_reply_summary: run.last_reply_summary,
160
+ kill_reason: run.kill_reason,
161
+ };
162
+ }
163
+ /* Suppress the lint about runWithoutId being unused-once. */
164
+ export const __internals = { runWithoutId };
165
+ //# sourceMappingURL=runner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ import { type AgentDefinition, type AgentRun, type AgentDefinitionStatus } from './types.js';
2
+ export interface StoreOptions {
3
+ /** Override the root. Defaults to ~/.yujin-forge/agents. */
4
+ root?: string;
5
+ }
6
+ export declare function listAgentSlugs(opts?: StoreOptions): Promise<string[]>;
7
+ export declare function getAgentDefinition(slug: string, opts?: StoreOptions): Promise<AgentDefinition | null>;
8
+ export declare function listAgentDefinitions(opts?: StoreOptions): Promise<AgentDefinition[]>;
9
+ /** Create or overwrite an agent definition. Returns false if the
10
+ * slug is invalid; throws if disk IO fails. */
11
+ export declare function saveAgentDefinition(def: AgentDefinition, opts?: StoreOptions): Promise<boolean>;
12
+ /** Move an agent to the deletion grace partition. Runs travel
13
+ * with it. Re-create + restore is a separate operation (TBD
14
+ * in the deletion-undo slice). */
15
+ export declare function softDeleteAgent(slug: string, opts?: StoreOptions): Promise<boolean>;
16
+ /** Append a run record under the agent's runs/ dir. Run id is
17
+ * generated if absent. */
18
+ export declare function appendAgentRun(slug: string, run: Omit<AgentRun, 'id' | 'slug'> & {
19
+ id?: string;
20
+ }, opts?: StoreOptions): Promise<AgentRun>;
21
+ /** List runs for an agent, newest first. `limit` defaults to 50. */
22
+ export declare function listAgentRuns(slug: string, limit?: number, opts?: StoreOptions): Promise<AgentRun[]>;
23
+ /** True iff `~/.yujin-forge/agents/` exists with at least one
24
+ * agent. Used by `yf agent install --defaults` to decide whether
25
+ * to seed. */
26
+ export declare function isStoreSeeded(opts?: StoreOptions): Promise<boolean>;
27
+ /** Build a minimal AgentDefinition with sensible defaults. Used
28
+ * by both `yf agent install --defaults` and tests. */
29
+ export declare function buildAgentDefinitionDraft(slug: string, name: string, opts?: Partial<AgentDefinition>): AgentDefinition;
30
+ /** Filter an agent list by status (handy for `yf agent list
31
+ * --status=active`). */
32
+ export declare function filterByStatus(defs: AgentDefinition[], status: AgentDefinitionStatus): AgentDefinition[];
33
+ //# sourceMappingURL=store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/agents/store.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAE3B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA+CD,wBAAsB,cAAc,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU/E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAG/G;AAED,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAQ9F;AAED;gDACgD;AAChD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzG;AAED;;mCAEmC;AACnC,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAY7F;AAMD;2BAC2B;AAC3B,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBnJ;AAED,oEAAoE;AACpE,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAgB1G;AAMD;;eAEe;AACf,wBAAsB,aAAa,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAG7E;AAED;uDACuD;AACvD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAiB1H;AAED;yBACyB;AACzB,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,qBAAqB,GAAG,eAAe,EAAE,CAExG"}
@@ -0,0 +1,210 @@
1
+ /**
2
+ * Local-mode agent storage (HITO 5 slice 1).
3
+ *
4
+ * Layout under `~/.yujin-forge/agents/`:
5
+ *
6
+ * config.json -- user config overrides
7
+ * by-slug/
8
+ * <slug>/
9
+ * definition.json -- the AgentDefinition
10
+ * runs/
11
+ * <iso-ts>__<run_id>.json -- one AgentRun per file
12
+ * deleted/
13
+ * <slug>__<iso-ts>/ -- moved here on delete + kept
14
+ * agent.deletion.grace_period_days
15
+ * ...
16
+ *
17
+ * Slice 1 ships the CRUD primitives + listing. Runner + bridge
18
+ * land in subsequent slices but consume the same store.
19
+ *
20
+ * Concurrency: each write is atomic (temp file + rename). Reads
21
+ * tolerate partial writes by skipping un-parseable files +
22
+ * logging.
23
+ */
24
+ import { promises as fs } from 'node:fs';
25
+ import os from 'node:os';
26
+ import path from 'node:path';
27
+ import crypto from 'node:crypto';
28
+ import { isValidAgentSlug, } from './types.js';
29
+ function rootPath(opts = {}) {
30
+ return opts.root ?? path.join(os.homedir(), '.yujin-forge', 'agents');
31
+ }
32
+ function bySlugDir(opts = {}) {
33
+ return path.join(rootPath(opts), 'by-slug');
34
+ }
35
+ function deletedDir(opts = {}) {
36
+ return path.join(rootPath(opts), 'deleted');
37
+ }
38
+ function definitionPath(slug, opts = {}) {
39
+ return path.join(bySlugDir(opts), slug, 'definition.json');
40
+ }
41
+ function runsDir(slug, opts = {}) {
42
+ return path.join(bySlugDir(opts), slug, 'runs');
43
+ }
44
+ async function ensureDir(dir) {
45
+ await fs.mkdir(dir, { recursive: true });
46
+ }
47
+ /* Atomic write -- write to a sibling .tmp file, then rename. */
48
+ async function writeJsonAtomic(p, obj) {
49
+ await ensureDir(path.dirname(p));
50
+ const tmp = p + '.tmp-' + process.pid + '-' + Date.now();
51
+ await fs.writeFile(tmp, JSON.stringify(obj, null, 2), 'utf-8');
52
+ await fs.rename(tmp, p);
53
+ }
54
+ async function readJson(p) {
55
+ try {
56
+ const raw = await fs.readFile(p, 'utf-8');
57
+ return JSON.parse(raw);
58
+ }
59
+ catch {
60
+ return null;
61
+ }
62
+ }
63
+ /* ============================================================
64
+ * Definition CRUD
65
+ * ============================================================ */
66
+ export async function listAgentSlugs(opts = {}) {
67
+ try {
68
+ const entries = await fs.readdir(bySlugDir(opts), { withFileTypes: true });
69
+ return entries
70
+ .filter((e) => e.isDirectory() && isValidAgentSlug(e.name))
71
+ .map((e) => e.name)
72
+ .sort();
73
+ }
74
+ catch {
75
+ return [];
76
+ }
77
+ }
78
+ export async function getAgentDefinition(slug, opts = {}) {
79
+ if (!isValidAgentSlug(slug))
80
+ return null;
81
+ return readJson(definitionPath(slug, opts));
82
+ }
83
+ export async function listAgentDefinitions(opts = {}) {
84
+ const slugs = await listAgentSlugs(opts);
85
+ const out = [];
86
+ for (const slug of slugs) {
87
+ const def = await getAgentDefinition(slug, opts);
88
+ if (def)
89
+ out.push(def);
90
+ }
91
+ return out;
92
+ }
93
+ /** Create or overwrite an agent definition. Returns false if the
94
+ * slug is invalid; throws if disk IO fails. */
95
+ export async function saveAgentDefinition(def, opts = {}) {
96
+ if (!isValidAgentSlug(def.slug))
97
+ return false;
98
+ const existing = await getAgentDefinition(def.slug, opts);
99
+ const now = Date.now();
100
+ const merged = {
101
+ ...def,
102
+ created_at: existing?.created_at ?? def.created_at ?? now,
103
+ updated_at: now,
104
+ };
105
+ await writeJsonAtomic(definitionPath(def.slug, opts), merged);
106
+ return true;
107
+ }
108
+ /** Move an agent to the deletion grace partition. Runs travel
109
+ * with it. Re-create + restore is a separate operation (TBD
110
+ * in the deletion-undo slice). */
111
+ export async function softDeleteAgent(slug, opts = {}) {
112
+ if (!isValidAgentSlug(slug))
113
+ return false;
114
+ const src = path.join(bySlugDir(opts), slug);
115
+ try {
116
+ await fs.access(src);
117
+ }
118
+ catch {
119
+ return false;
120
+ }
121
+ await ensureDir(deletedDir(opts));
122
+ const tombstone = path.join(deletedDir(opts), slug + '__' + new Date().toISOString().replace(/[:.]/g, '-'));
123
+ await fs.rename(src, tombstone);
124
+ return true;
125
+ }
126
+ /* ============================================================
127
+ * Run CRUD
128
+ * ============================================================ */
129
+ /** Append a run record under the agent's runs/ dir. Run id is
130
+ * generated if absent. */
131
+ export async function appendAgentRun(slug, run, opts = {}) {
132
+ if (!isValidAgentSlug(slug)) {
133
+ throw new Error('appendAgentRun: invalid slug ' + JSON.stringify(slug));
134
+ }
135
+ const full = {
136
+ id: run.id ?? crypto.randomUUID(),
137
+ slug,
138
+ trigger_kind: run.trigger_kind,
139
+ trigger_reason: run.trigger_reason,
140
+ started_at: run.started_at,
141
+ ended_at: run.ended_at,
142
+ status: run.status,
143
+ tokens_in: run.tokens_in,
144
+ tokens_out: run.tokens_out,
145
+ tool_calls: run.tool_calls,
146
+ rejected_approvals: run.rejected_approvals,
147
+ last_reply_summary: run.last_reply_summary,
148
+ kill_reason: run.kill_reason,
149
+ };
150
+ const fname = new Date(full.started_at).toISOString().replace(/[:.]/g, '-') + '__' + full.id + '.json';
151
+ await writeJsonAtomic(path.join(runsDir(slug, opts), fname), full);
152
+ return full;
153
+ }
154
+ /** List runs for an agent, newest first. `limit` defaults to 50. */
155
+ export async function listAgentRuns(slug, limit = 50, opts = {}) {
156
+ if (!isValidAgentSlug(slug))
157
+ return [];
158
+ const dir = runsDir(slug, opts);
159
+ let entries = [];
160
+ try {
161
+ entries = await fs.readdir(dir);
162
+ }
163
+ catch {
164
+ return [];
165
+ }
166
+ entries.sort((a, b) => b.localeCompare(a)); /* descending by ISO ts prefix */
167
+ const out = [];
168
+ for (const name of entries.slice(0, Math.max(0, limit))) {
169
+ const row = await readJson(path.join(dir, name));
170
+ if (row)
171
+ out.push(row);
172
+ }
173
+ return out;
174
+ }
175
+ /* ============================================================
176
+ * Utility
177
+ * ============================================================ */
178
+ /** True iff `~/.yujin-forge/agents/` exists with at least one
179
+ * agent. Used by `yf agent install --defaults` to decide whether
180
+ * to seed. */
181
+ export async function isStoreSeeded(opts = {}) {
182
+ const slugs = await listAgentSlugs(opts);
183
+ return slugs.length > 0;
184
+ }
185
+ /** Build a minimal AgentDefinition with sensible defaults. Used
186
+ * by both `yf agent install --defaults` and tests. */
187
+ export function buildAgentDefinitionDraft(slug, name, opts = {}) {
188
+ const now = Date.now();
189
+ return {
190
+ slug,
191
+ name,
192
+ description: opts.description ?? '',
193
+ brain_tier: opts.brain_tier ?? 'eco',
194
+ trigger: opts.trigger ?? { kind: 'manual', config: {} },
195
+ can_call: opts.can_call ?? [],
196
+ can_be_called_by: opts.can_be_called_by ?? [],
197
+ allowed_verbs: opts.allowed_verbs ?? [],
198
+ prompt_addition: opts.prompt_addition ?? '',
199
+ status: opts.status ?? 'active',
200
+ created_at: opts.created_at ?? now,
201
+ updated_at: opts.updated_at ?? now,
202
+ revoked_reason: opts.revoked_reason,
203
+ };
204
+ }
205
+ /** Filter an agent list by status (handy for `yf agent list
206
+ * --status=active`). */
207
+ export function filterByStatus(defs, status) {
208
+ return defs.filter((d) => d.status === status);
209
+ }
210
+ //# sourceMappingURL=store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/agents/store.ts"],"names":[],"mappings":"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"}