@inneranimalmedia/agentsam-sdk 2.6.1 → 2.6.3

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 (507) hide show
  1. package/AGENTSAM.md +45 -1
  2. package/README.md +80 -0
  3. package/apps/README.md +34 -0
  4. package/apps/cad-creator/README.md +728 -0
  5. package/apps/cad-creator/shared/cad/package.json +19 -0
  6. package/apps/cad-creator/shared/cad/src/domain/operations.ts +7 -0
  7. package/apps/cad-creator/shared/cad/src/domain/project-contract.d.ts +3 -0
  8. package/apps/cad-creator/shared/cad/src/domain/project-contract.js +75 -0
  9. package/apps/cad-creator/shared/cad/src/domain/project-tools.d.ts +1 -0
  10. package/apps/cad-creator/shared/cad/src/domain/project-tools.js +24 -0
  11. package/apps/cad-creator/shared/cad/src/domain/validation.ts +191 -0
  12. package/apps/cad-creator/shared/cad/src/index.ts +4 -0
  13. package/apps/cad-creator/shared/cad/src/robotics/types.ts +232 -0
  14. package/apps/cad-creator/shared/cad/src/types.ts +507 -0
  15. package/apps/cad-creator/shared/cad/tsconfig.json +14 -0
  16. package/docs/AUTH_IDENTITY_CONTRACT.md +25 -27
  17. package/docs/AUTORAG.md +58 -0
  18. package/docs/BRAND_INTELLIGENCE.md +30 -0
  19. package/docs/CLI_SHELL.md +4 -2
  20. package/docs/CMS_CONTEXTUAL_COMPOSER.md +38 -0
  21. package/docs/MERKLE.md +4 -0
  22. package/docs/PROJECT_CONFIG.md +3 -0
  23. package/docs/REPOSITORY_KNOWLEDGE.md +2 -0
  24. package/docs/SDK_WORKER.md +4 -3
  25. package/docs/THEME_REFINERY.md +120 -0
  26. package/docs/architecture/PROVIDER-TOOLS-AND-COMPACTION.md +60 -0
  27. package/docs/architecture/STORAGE.md +87 -0
  28. package/docs/cad-project-tools.md +69 -0
  29. package/docs/cms-scaffolding-pattern-reference.md +73 -0
  30. package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS-codex-tui-20260919.md +113 -0
  31. package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS.md +85 -0
  32. package/docs/plans/AGENTSAM-MCP-CLIENT-2026-09-19.md +181 -0
  33. package/docs/plans/ASBD-PORTABLE-WORKGRAPH-UI-DEFERRED.md +34 -0
  34. package/docs/plans/ASTRA-BRIEF-2026-09-18.md +258 -0
  35. package/docs/plans/MULTI-AGENT-SPRINTS-2026-09-19.md +373 -0
  36. package/docs/plans/NEXT-AGENT-HANDOFF.md +167 -0
  37. package/docs/plans/RECONCILIATION-2026-09-19.md +178 -0
  38. package/docs/plugins.md +43 -0
  39. package/docs/tools/README.md +57 -0
  40. package/docs/tools/agent-and-orchestration.md +49 -0
  41. package/docs/tools/browser-and-research.md +46 -0
  42. package/docs/tools/cloudflare-platform.md +32 -0
  43. package/docs/tools/cms.md +25 -0
  44. package/docs/tools/communications.md +41 -0
  45. package/docs/tools/database-and-storage.md +62 -0
  46. package/docs/tools/design-and-media.md +64 -0
  47. package/docs/tools/filesystem-and-code.md +55 -0
  48. package/docs/tools/github.md +56 -0
  49. package/docs/tools/integrations-and-misc.md +16 -0
  50. package/docs/tools/memory.md +21 -0
  51. package/docs/tools/terminal-and-execution.md +29 -0
  52. package/docs/tools/tickets-and-platform.md +30 -0
  53. package/migrations/d1/0001_agentsam_plugin_runtime.sql +177 -0
  54. package/migrations/d1/0002_agentsam_ticket_ownership.sql +8 -0
  55. package/migrations/d1/0002_dynamic_model_policies.sql +23 -0
  56. package/migrations/d1/0003_expand_tool_handler_families.sql +18 -0
  57. package/migrations/d1/0004_project_aware_retrieval_lanes.sql +24 -0
  58. package/migrations/d1/0005_portable_knowledge_identity.sql +104 -0
  59. package/migrations/d1/0006_repair_ops_trail_account_scope.sql +14 -0
  60. package/migrations/d1/0007_repair_ops_trail_agent_run_account.sql +13 -0
  61. package/migrations/d1/0008_backfill_knowledge_run_legacy_tenant.sql +14 -0
  62. package/migrations/d1/0009_normalize_cloudflare_plugin_installations.sql +137 -0
  63. package/migrations/runtime/0001_cli_runtime.sql +67 -0
  64. package/migrations/runtime/0002_project_sessions.sql +15 -0
  65. package/migrations/runtime/0003_provider_continuations.sql +8 -0
  66. package/package.json +92 -12
  67. package/packages/agentsam-brand/README.md +21 -0
  68. package/packages/agentsam-brand/package.json +22 -0
  69. package/packages/agentsam-brand/src/contract.js +59 -0
  70. package/packages/agentsam-brand/src/extract.js +126 -0
  71. package/packages/agentsam-brand/src/goap-actions.js +73 -0
  72. package/packages/agentsam-brand/src/index.js +48 -0
  73. package/packages/agentsam-brand/src/plan.js +115 -0
  74. package/packages/agentsam-brand/src/resolve.js +139 -0
  75. package/packages/agentsam-brand/src/scan.js +250 -0
  76. package/packages/agentsam-brand/test/brand-scan.test.mjs +106 -0
  77. package/packages/agentsam-contracts/README.md +23 -0
  78. package/packages/agentsam-contracts/package.json +32 -0
  79. package/packages/agentsam-contracts/src/adapter.ts +25 -0
  80. package/packages/agentsam-contracts/src/agent.ts +35 -0
  81. package/packages/agentsam-contracts/src/artifacts.ts +33 -0
  82. package/packages/agentsam-contracts/src/authority.ts +29 -0
  83. package/packages/agentsam-contracts/src/context.ts +16 -0
  84. package/packages/agentsam-contracts/src/errors.ts +46 -0
  85. package/packages/agentsam-contracts/src/events.ts +47 -0
  86. package/packages/agentsam-contracts/src/execution.ts +50 -0
  87. package/packages/agentsam-contracts/src/hooks.ts +40 -0
  88. package/packages/agentsam-contracts/src/identity.ts +16 -0
  89. package/packages/agentsam-contracts/src/index.ts +14 -0
  90. package/packages/agentsam-contracts/src/models.ts +9 -0
  91. package/packages/agentsam-contracts/src/providers.ts +33 -0
  92. package/packages/agentsam-contracts/src/repository.ts +64 -0
  93. package/packages/agentsam-contracts/src/tools.ts +98 -0
  94. package/packages/agentsam-contracts/test/contracts.test.mjs +16 -0
  95. package/packages/agentsam-contracts/test/errors-catalog.test.mjs +25 -0
  96. package/packages/agentsam-contracts/test/repository.test.mjs +18 -0
  97. package/packages/agentsam-contracts/tsconfig.json +12 -0
  98. package/packages/agentsam-errors/package.json +17 -0
  99. package/packages/agentsam-errors/src/adapters/anthropic.js +15 -0
  100. package/packages/agentsam-errors/src/adapters/cad.js +109 -0
  101. package/packages/agentsam-errors/src/adapters/cloudflare.js +21 -0
  102. package/packages/agentsam-errors/src/adapters/cursor.js +4 -0
  103. package/packages/agentsam-errors/src/adapters/device.js +38 -0
  104. package/packages/agentsam-errors/src/adapters/docker.js +28 -0
  105. package/packages/agentsam-errors/src/adapters/gcp.js +14 -0
  106. package/packages/agentsam-errors/src/adapters/github.js +22 -0
  107. package/packages/agentsam-errors/src/adapters/google.js +17 -0
  108. package/packages/agentsam-errors/src/adapters/index.js +55 -0
  109. package/packages/agentsam-errors/src/adapters/internal.js +40 -0
  110. package/packages/agentsam-errors/src/adapters/oauth.js +24 -0
  111. package/packages/agentsam-errors/src/adapters/openai.js +17 -0
  112. package/packages/agentsam-errors/src/adapters/process.js +35 -0
  113. package/packages/agentsam-errors/src/adapters/provider.js +114 -0
  114. package/packages/agentsam-errors/src/envelope.js +186 -0
  115. package/packages/agentsam-errors/src/error.js +24 -0
  116. package/packages/agentsam-errors/src/fingerprint.js +35 -0
  117. package/packages/agentsam-errors/src/index.js +10 -0
  118. package/packages/agentsam-errors/src/normalize.js +30 -0
  119. package/packages/agentsam-errors/src/redaction.js +52 -0
  120. package/packages/agentsam-errors/src/render.js +16 -0
  121. package/packages/agentsam-errors/src/retry.js +10 -0
  122. package/packages/agentsam-errors/src/transport.js +52 -0
  123. package/packages/agentsam-errors/src/vocabulary.js +320 -0
  124. package/packages/agentsam-errors/test/envelope.test.mjs +70 -0
  125. package/packages/agentsam-errors/test/providers.test.mjs +99 -0
  126. package/packages/agentsam-errors/test/redaction.test.mjs +21 -0
  127. package/packages/agentsam-errors/test/runtime-cad-device.test.mjs +76 -0
  128. package/packages/agentsam-errors/test/transport.test.mjs +46 -0
  129. package/packages/agentsam-knowledge/package.json +15 -0
  130. package/packages/agentsam-knowledge/src/autorag/index.js +64 -0
  131. package/packages/agentsam-knowledge/src/backends/index.js +26 -0
  132. package/packages/agentsam-knowledge/src/index.js +3 -0
  133. package/packages/agentsam-knowledge/src/providers/index.js +95 -0
  134. package/packages/agentsam-knowledge/test/autorag.test.mjs +42 -0
  135. package/packages/agentsam-nav/README.md +40 -0
  136. package/packages/agentsam-nav/dist/Nav.d.ts +43 -0
  137. package/packages/agentsam-nav/dist/NavCollapsible.d.ts +10 -0
  138. package/packages/agentsam-nav/dist/NavContent.d.ts +2 -0
  139. package/packages/agentsam-nav/dist/NavFooter.d.ts +2 -0
  140. package/packages/agentsam-nav/dist/NavGroup.d.ts +3 -0
  141. package/packages/agentsam-nav/dist/NavHeader.d.ts +2 -0
  142. package/packages/agentsam-nav/dist/NavMenu.d.ts +22 -0
  143. package/packages/agentsam-nav/dist/NavProvider.d.ts +35 -0
  144. package/packages/agentsam-nav/dist/NavTrigger.d.ts +2 -0
  145. package/packages/agentsam-nav/dist/Surfaces.d.ts +41 -0
  146. package/packages/agentsam-nav/dist/browser.d.ts +11 -0
  147. package/packages/agentsam-nav/dist/browser.global.js +132 -0
  148. package/packages/agentsam-nav/dist/browser.js +613 -0
  149. package/packages/agentsam-nav/dist/contracts.d.ts +76 -0
  150. package/packages/agentsam-nav/dist/index.d.ts +11 -0
  151. package/packages/agentsam-nav/dist/index.js +614 -0
  152. package/packages/agentsam-nav/dist/legacy.css +83 -0
  153. package/packages/agentsam-nav/dist/shell.css +113 -0
  154. package/packages/agentsam-nav/dist/theme.css +113 -0
  155. package/packages/agentsam-nav/dist/utils.d.ts +1 -0
  156. package/packages/agentsam-nav/package.json +43 -0
  157. package/packages/agentsam-queue-control/README.md +107 -0
  158. package/packages/agentsam-queue-control/package.json +31 -0
  159. package/packages/agentsam-queue-control/schemas/job-envelope.schema.json +56 -0
  160. package/packages/agentsam-queue-control/src/adapters/cloudflare.js +152 -0
  161. package/packages/agentsam-queue-control/src/adapters/memory.js +38 -0
  162. package/packages/agentsam-queue-control/src/contracts.js +130 -0
  163. package/packages/agentsam-queue-control/src/control-plane.js +141 -0
  164. package/packages/agentsam-queue-control/src/dispatch.js +43 -0
  165. package/packages/agentsam-queue-control/src/index.js +7 -0
  166. package/packages/agentsam-queue-control/src/policy.js +88 -0
  167. package/packages/agentsam-queue-control/src/topology.js +66 -0
  168. package/packages/agentsam-queue-control/test/queue-control.test.mjs +100 -0
  169. package/packages/agentsam-repository/src/goap.js +718 -0
  170. package/packages/agentsam-repository/src/goap.js.bak-20260922011251 +670 -0
  171. package/packages/agentsam-repository/src/index.js +5 -0
  172. package/packages/agentsam-repository/src/merkle/cloudflare-persistence.js +2 -2
  173. package/packages/agentsam-repository/src/tickets.js +184 -0
  174. package/packages/agentsam-repository/src/work-tracking.js +199 -0
  175. package/packages/agentsam-repository/src/workspace-state.js +176 -0
  176. package/packages/agentsam-repository/test/goap-tickets-workspace-state.test.mjs +152 -0
  177. package/packages/connectors/cloudflare/src/index.js +297 -15
  178. package/packages/connectors/cloudflare/src/owner.js +43 -40
  179. package/packages/connectors/cloudflare/src/routes.js +167 -26
  180. package/packages/connectors/cloudflare/tests/connector.test.mjs +112 -2
  181. package/packages/heuristic-theme/README.md +11 -0
  182. package/packages/heuristic-theme/package.json +25 -0
  183. package/packages/heuristic-theme/src/index.js +2 -0
  184. package/packages/heuristic-theme/src/registry.js +36 -0
  185. package/packages/heuristic-theme/src/theme.js +41 -0
  186. package/packages/heuristic-theme/test/theme.test.mjs +26 -0
  187. package/packages/identity/.agentsam/features/oauth-login-portal/agentsam.feature.json +64 -0
  188. package/packages/identity/.agentsam/features/oauth-login-portal/providers.json +96 -0
  189. package/packages/identity/.agentsam/features/oauth-login-portal/resources.json +47 -0
  190. package/packages/identity/.agentsam/features/oauth-login-portal/routes.json +74 -0
  191. package/packages/identity/.agentsam/features/oauth-login-portal/ui.json +35 -0
  192. package/packages/identity/package.json +4 -3
  193. package/packages/identity/src/adapters/cloudflare-d1/ids.js +4 -0
  194. package/packages/identity/src/adapters/cloudflare-d1/index.js +39 -1
  195. package/packages/identity/src/contracts/auth-config.js +23 -40
  196. package/packages/identity/src/contracts/provider.js +3 -2
  197. package/packages/identity/src/frontend/auth-portal/pages/login.html +7 -0
  198. package/packages/identity/src/index.js +2 -0
  199. package/packages/identity/src/oauth/credentials.js +13 -0
  200. package/packages/identity/src/oauth/iam-platform.js +5 -5
  201. package/packages/identity/src/providers/cloudflare/index.js +19 -0
  202. package/packages/identity/src/providers/cloudflare/mapper.js +21 -0
  203. package/packages/identity/src/providers/cloudflare/oauth.js +48 -0
  204. package/packages/identity/src/providers/cloudflare/profile.js +28 -0
  205. package/packages/identity/src/providers/index.js +18 -2
  206. package/packages/identity/src/server/identity-service.js +13 -3
  207. package/packages/identity/src/server/worker-router.js +63 -8
  208. package/packages/identity/tests/auth-config.test.mjs +14 -23
  209. package/packages/identity/tests/identity-service.test.mjs +15 -0
  210. package/packages/providers/completeful/README.md +38 -0
  211. package/packages/providers/completeful/package.json +29 -0
  212. package/packages/providers/completeful/src/client.js +162 -0
  213. package/packages/providers/completeful/src/events.js +49 -0
  214. package/packages/providers/completeful/src/index.js +22 -0
  215. package/packages/providers/completeful/src/tools.js +579 -0
  216. package/packages/providers/completeful/src/webhooks.js +55 -0
  217. package/packages/providers/completeful/test/provider.test.mjs +196 -0
  218. package/packages/theme-church-site/README.md +10 -0
  219. package/packages/theme-church-site/package.json +30 -0
  220. package/packages/theme-church-site/src/harvest.json +14 -0
  221. package/packages/theme-church-site/src/index.js +84 -0
  222. package/packages/theme-church-site/test/theme.test.mjs +19 -0
  223. package/packages/theme-companions-site/README.md +10 -0
  224. package/packages/theme-companions-site/package.json +30 -0
  225. package/packages/theme-companions-site/src/harvest.json +12 -0
  226. package/packages/theme-companions-site/src/index.js +82 -0
  227. package/packages/theme-companions-site/test/theme.test.mjs +19 -0
  228. package/packages/theme-floors-site/README.md +10 -0
  229. package/packages/theme-floors-site/package.json +30 -0
  230. package/packages/theme-floors-site/src/harvest.json +14 -0
  231. package/packages/theme-floors-site/src/index.js +82 -0
  232. package/packages/theme-floors-site/test/theme.test.mjs +19 -0
  233. package/packages/theme-fuelnfree-site/README.md +10 -0
  234. package/packages/theme-fuelnfree-site/package.json +30 -0
  235. package/packages/theme-fuelnfree-site/src/harvest.json +13 -0
  236. package/packages/theme-fuelnfree-site/src/index.js +81 -0
  237. package/packages/theme-fuelnfree-site/test/theme.test.mjs +19 -0
  238. package/packages/theme-handyman-site/README.md +10 -0
  239. package/packages/theme-handyman-site/package.json +30 -0
  240. package/packages/theme-handyman-site/src/harvest.json +10 -0
  241. package/packages/theme-handyman-site/src/index.js +83 -0
  242. package/packages/theme-handyman-site/test/theme.test.mjs +19 -0
  243. package/packages/theme-insurance-site/README.md +10 -0
  244. package/packages/theme-insurance-site/package.json +30 -0
  245. package/packages/theme-insurance-site/src/harvest.json +10 -0
  246. package/packages/theme-insurance-site/src/index.js +83 -0
  247. package/packages/theme-insurance-site/test/theme.test.mjs +19 -0
  248. package/packages/theme-shinshu-site/README.md +10 -0
  249. package/packages/theme-shinshu-site/package.json +30 -0
  250. package/packages/theme-shinshu-site/src/harvest.json +12 -0
  251. package/packages/theme-shinshu-site/src/index.js +83 -0
  252. package/packages/theme-shinshu-site/test/theme.test.mjs +19 -0
  253. package/packages/work-graph/README.md +49 -0
  254. package/packages/work-graph/package.json +19 -0
  255. package/packages/work-graph/prototype/README.md +32 -0
  256. package/packages/work-graph/prototype/data/demo-workgraph.js +47 -0
  257. package/packages/work-graph/prototype/renderers/timeline-model.js +21 -0
  258. package/packages/work-graph/prototype/renderers/workgraph-runtime.js +38 -0
  259. package/packages/work-graph/prototype-gnantt.html +655 -0
  260. package/packages/work-graph/src/adapters/business/projects.js +23 -0
  261. package/packages/work-graph/src/adapters/engineering/git.js +22 -0
  262. package/packages/work-graph/src/adapters/engineering/mcp.js +22 -0
  263. package/packages/work-graph/src/index.js +76 -0
  264. package/packages/work-graph/src/renderers/gantt-model.js +11 -0
  265. package/packages/work-graph/src/renderers/timeline.js +16 -0
  266. package/packages/work-graph/test/work-graph.test.mjs +37 -0
  267. package/protocol/README.md +12 -0
  268. package/protocol/capabilities/cloudflare-cpu-audit-input.schema.json +30 -6
  269. package/protocol/capabilities/cloudflare-cpu-profile-input.schema.json +18 -4
  270. package/protocol/capabilities/cloudflare-wrangler-native-input.schema.json +59 -10
  271. package/protocol/capabilities/knowledge-search-input.schema.json +35 -0
  272. package/protocol/capabilities/manifest.json +163 -1
  273. package/protocol/capabilities/repository-audit-input.schema.json +39 -6
  274. package/protocol/capabilities/repository-snapshot-input.schema.json +15 -3
  275. package/protocol/capabilities/terminal-exec-input.schema.json +55 -0
  276. package/protocol/commerce/catalog.v1.json +50 -0
  277. package/protocol/errors/error-catalog.json +164 -0
  278. package/protocol/errors/error-envelope.schema.json +544 -0
  279. package/protocol/features/README.md +57 -0
  280. package/protocol/features/agentsam.feature.v1.schema.json +290 -0
  281. package/protocol/features/catalog.json +65 -0
  282. package/protocol/features/examples/provider-resend.feature.json +17 -0
  283. package/protocol/go/agentsam-go-runtime.v1.json +17 -0
  284. package/protocol/knowledge/LIFECYCLE.md +140 -0
  285. package/protocol/knowledge/README.md +4 -0
  286. package/protocol/presets/catalog.json +128 -19
  287. package/protocol/rpc/v1/errors.proto +24 -0
  288. package/protocol/theme-refinery/d1-reconciliation.md +48 -0
  289. package/protocol/theme-refinery/product-metadata.schema.json +27 -0
  290. package/protocol/theme-refinery/receipts/products-registry-batch-20260924.json +318 -0
  291. package/protocol/theme-refinery/receipts/theme-harvest-20260924.json +472 -0
  292. package/protocol/theme-refinery/reconciliation-receipt.schema.json +83 -0
  293. package/services/cad/server.py +249 -2
  294. package/src/agent/capability-adapter.js +15 -5
  295. package/src/agent/index.js +2 -1
  296. package/src/agent/model-turn.js +51 -0
  297. package/src/agent/responses-runner.js +304 -38
  298. package/src/capabilities/index.js +1 -0
  299. package/src/capabilities/terminal-exec.js +78 -0
  300. package/src/cli.js +129 -31
  301. package/src/cloudflare/index.js +6 -0
  302. package/src/cloudflare/runtime-status.js +393 -0
  303. package/src/cloudflare/wrangler.js +17 -1
  304. package/src/commands/account-auth.js +1 -1
  305. package/src/commands/app.js +106 -0
  306. package/src/commands/autorag.js +77 -0
  307. package/src/commands/brand.js +293 -0
  308. package/src/commands/cad.js +1 -0
  309. package/src/commands/connections.js +126 -29
  310. package/src/commands/context-economics.js +8 -0
  311. package/src/commands/db.js +7 -0
  312. package/src/commands/deploy.js +2 -2
  313. package/src/commands/env.js +5 -4
  314. package/src/commands/eval.js +209 -14
  315. package/src/commands/go.js +365 -0
  316. package/src/commands/goap.js +176 -0
  317. package/src/commands/identity-init.js +27 -3
  318. package/src/commands/identity-protocol.js +195 -0
  319. package/src/commands/knowledge.js +64 -5
  320. package/src/commands/mcp.js +341 -0
  321. package/src/commands/merkle-persist.js +3 -1
  322. package/src/commands/merkle.js +18 -3
  323. package/src/commands/models.js +109 -23
  324. package/src/commands/plugins.js +175 -0
  325. package/src/commands/preferences.js +28 -8
  326. package/src/commands/product.js +53 -10
  327. package/src/commands/providers.js +389 -0
  328. package/src/commands/resume.js +9 -5
  329. package/src/commands/runtime-status.js +154 -0
  330. package/src/commands/shell.js +469 -54
  331. package/src/commands/status.js +82 -7
  332. package/src/commands/tunnel.js +228 -195
  333. package/src/commands/whoami.js +115 -22
  334. package/src/context/budget.js +6 -0
  335. package/src/context/index.js +2 -1
  336. package/src/context/project-card.js +75 -0
  337. package/src/errors/contract.js +34 -211
  338. package/src/errors/diagnostic.js +95 -50
  339. package/src/errors/index.js +6 -13
  340. package/src/eval/index.js +6 -0
  341. package/src/eval/live.js +439 -0
  342. package/src/features/resolve.js +242 -0
  343. package/src/go/build.js +108 -0
  344. package/src/go/cloudflare.js +207 -0
  345. package/src/go/contract.js +139 -0
  346. package/src/go/discover.js +96 -0
  347. package/src/go/index.js +13 -0
  348. package/src/go/receipts.js +77 -0
  349. package/src/go/registry.js +223 -0
  350. package/src/go/verify.js +31 -0
  351. package/src/index.js +100 -1
  352. package/src/knowledge/config.js +13 -5
  353. package/src/knowledge/engine.js +23 -8
  354. package/src/knowledge/index.js +1 -0
  355. package/src/knowledge/lane-registry.js +46 -0
  356. package/src/knowledge/providers/gemini.js +48 -8
  357. package/src/knowledge/service/client.js +13 -1
  358. package/src/knowledge/service/grpc-codec.js +156 -53
  359. package/src/knowledge/service/job-engine.js +133 -11
  360. package/src/knowledge/service/job-worker.js +34 -5
  361. package/src/knowledge/service/server.js +10 -1
  362. package/src/knowledge/store-discovery.js +77 -0
  363. package/src/lib/account-session.js +100 -25
  364. package/src/lib/agent-instructions.js +3 -0
  365. package/src/lib/auth.js +318 -51
  366. package/src/lib/cad/blender.js +42 -3
  367. package/src/lib/cad/d1-project-store.js +43 -0
  368. package/src/lib/cad/discovery.js +616 -0
  369. package/src/lib/cad/docker-executor.js +352 -0
  370. package/src/lib/cad/freecad.js +253 -0
  371. package/src/lib/cad/index.js +40 -0
  372. package/src/lib/cad/openscad.js +198 -0
  373. package/src/lib/cad/project-cli.d.ts +2 -0
  374. package/src/lib/cad/project-cli.js +21 -0
  375. package/src/lib/cad/project-contract.d.ts +3 -0
  376. package/src/lib/cad/project-contract.js +1 -0
  377. package/src/lib/cad/project-recipe.js +30 -0
  378. package/src/lib/cad/project-runtime.d.ts +2 -0
  379. package/src/lib/cad/project-runtime.js +53 -0
  380. package/src/lib/cad/project-store.js +25 -0
  381. package/src/lib/cad/project-workflows.js +31 -0
  382. package/src/lib/cad-docker.js +21 -2
  383. package/src/lib/cli-preferences.js +17 -2
  384. package/src/lib/core-client.js +97 -33
  385. package/src/lib/deploy/local-studio.js +6 -5
  386. package/src/lib/detect-context.js +14 -16
  387. package/src/lib/dockerize.js +3 -0
  388. package/src/lib/execution-approvals.js +1 -0
  389. package/src/lib/identity-scaffold.js +4 -1
  390. package/src/lib/knowledge-docker.js +9 -1
  391. package/src/lib/local-sessions.js +124 -34
  392. package/src/lib/local-status.js +35 -14
  393. package/src/lib/project-config.js +9 -0
  394. package/src/lib/provider-credentials.js +233 -55
  395. package/src/lib/scaffold/resolve-cloudflare-account.js +37 -0
  396. package/src/lib/scaffold/wizards/cms.js +2 -8
  397. package/src/lib/scaffold/wizards/worker-api.js +2 -8
  398. package/src/lib/slash-commands.js +10 -2
  399. package/src/local/migrations.js +109 -1
  400. package/src/local/runtime-store.js +31 -5
  401. package/src/local/sqlite.js +36 -1
  402. package/src/mcp/authority.js +348 -0
  403. package/src/mcp/client-adapters.js +431 -0
  404. package/src/mcp/client.js +172 -0
  405. package/src/mcp/index.js +47 -0
  406. package/src/mcp/telemetry.js +103 -0
  407. package/src/models/catalog.js +329 -51
  408. package/src/models/discovery.js +59 -4
  409. package/src/models/index.js +2 -0
  410. package/src/models/inventory-core.js +182 -0
  411. package/src/models/policy.js +20 -0
  412. package/src/plugins/cloudflare.js +103 -0
  413. package/src/plugins/completeful.js +69 -0
  414. package/src/plugins/contracts.js +86 -0
  415. package/src/plugins/index.js +11 -0
  416. package/src/plugins/registry.js +207 -0
  417. package/src/plugins/resource-scope.js +45 -0
  418. package/src/plugins/runtime.js +118 -0
  419. package/src/plugins/vectorize.js +31 -0
  420. package/src/progression/engine.js +171 -0
  421. package/src/progression/index.js +1 -0
  422. package/src/providers/cloudflare-chat.js +1 -1
  423. package/src/providers/gemini-generate-content.js +2 -1
  424. package/src/providers/openai-responses.js +45 -16
  425. package/src/providers/tool-schema.js +85 -0
  426. package/src/repository/index.js +29 -0
  427. package/src/rpc/generated/errors_pb.js +961 -1
  428. package/src/security/local-vault.js +415 -0
  429. package/src/security/process.js +20 -4
  430. package/src/status/actions.js +192 -0
  431. package/src/tools/hydrate.js +5 -1
  432. package/src/tools/index.js +7 -0
  433. package/src/tools/redact.js +64 -0
  434. package/src/tools/registry.js +83 -0
  435. package/src/tools/runtime.js +257 -0
  436. package/src/tools/search.js +21 -8
  437. package/src/ui/ansi.js +117 -3
  438. package/src/ui/cli/activity.js +76 -7
  439. package/src/ui/cli/footer.js +110 -9
  440. package/src/ui/cli/help.js +14 -5
  441. package/src/ui/wireframes.js +166 -0
  442. package/test/account-session.test.mjs +76 -11
  443. package/test/apps-scaffold-contract.test.mjs +58 -0
  444. package/test/capabilities.test.mjs +1 -1
  445. package/test/cli/eval-live.test.mjs +219 -0
  446. package/test/cli/go.test.mjs +71 -0
  447. package/test/cli/local-vault-and-provider-setup.test.mjs +268 -0
  448. package/test/cli/mcp-client.test.mjs +245 -0
  449. package/test/cli/runtime-ui.test.mjs +69 -2
  450. package/test/cli/status-actions.test.mjs +88 -0
  451. package/test/cli/wireframes-go-registry.test.mjs +54 -0
  452. package/test/cloudflare-connector.test.mjs +3 -6
  453. package/test/cloudflare-runtime.test.mjs +8 -1
  454. package/test/context.test.mjs +15 -0
  455. package/test/error-diagnostics.test.mjs +9 -0
  456. package/test/fixtures/cad/courtyard-house.json +208 -0
  457. package/test/go/cloudflare-probe.test.mjs +53 -0
  458. package/test/integration/app-command.test.mjs +55 -0
  459. package/test/integration/cad-discovery.test.mjs +158 -0
  460. package/test/integration/cad-docker-executor.test.mjs +249 -0
  461. package/test/integration/cad-execution.test.mjs +184 -0
  462. package/test/integration/cad-project-app.test.mjs +31 -0
  463. package/test/integration/cad-project-d1.test.mjs +25 -0
  464. package/test/integration/cad-project-native.test.mjs +24 -0
  465. package/test/integration/cad-project-workflow.test.mjs +9 -0
  466. package/test/integration/cad-project.test.mjs +82 -0
  467. package/test/integration/cli-help.test.mjs +4 -0
  468. package/test/integration/cms-site-tenancy-contract.test.mjs +256 -0
  469. package/test/integration/core-client.integration.test.mjs +55 -0
  470. package/test/integration/error-runtime-rpc.test.mjs +71 -0
  471. package/test/integration/features-resolve.test.mjs +128 -0
  472. package/test/integration/install-script.test.mjs +107 -0
  473. package/test/integration/inventory-core.test.mjs +53 -0
  474. package/test/integration/plugins-cloudflare.integration.test.mjs +28 -0
  475. package/test/integration/provider-env-cli.test.mjs +1 -1
  476. package/test/integration/runtime-migrations.test.mjs +6 -1
  477. package/test/integration/runtime-status.integration.test.mjs +211 -0
  478. package/test/integration/scaffold-cloudflare.test.mjs +46 -0
  479. package/test/integration/storage-architecture.test.mjs +154 -0
  480. package/test/integration/store-discovery.test.mjs +44 -0
  481. package/test/integration/terminal-exec.integration.test.mjs +86 -0
  482. package/test/integration/tool-runtime.test.mjs +124 -0
  483. package/test/integration/tool-schema.test.mjs +59 -0
  484. package/test/knowledge-service.test.mjs +4 -0
  485. package/test/local-sessions.test.mjs +11 -2
  486. package/test/local-studio-deploy.test.mjs +1 -1
  487. package/test/model-catalog.test.mjs +28 -1
  488. package/test/models.test.mjs +159 -5
  489. package/test/openai-responses.test.mjs +60 -0
  490. package/test/provider-credentials.test.mjs +15 -5
  491. package/test/responses-runner.test.mjs +321 -6
  492. package/test/sdk-worker-contract.test.mjs +5 -1
  493. package/test/shell.test.mjs +149 -4
  494. package/test/smoke.mjs +4 -3
  495. package/test/tools-search.test.mjs +33 -0
  496. package/test/unit/website-assets-bindings.test.mjs +60 -0
  497. package/test/whoami-resume.test.mjs +87 -7
  498. package/examples/gorilla-shell/README.md +0 -15
  499. package/src/lib/gorilla-template.js +0 -54
  500. package/src/lib/prompt-byok.js +0 -57
  501. package/src/lib/save-sdk-token.js +0 -19
  502. package/templates/gorilla-shell/App.tsx +0 -639
  503. package/templates/gorilla-shell/README.md +0 -34
  504. package/templates/gorilla-shell/index.html +0 -15
  505. package/templates/gorilla-shell/main.jsx +0 -9
  506. package/templates/gorilla-shell/package.json +0 -19
  507. package/templates/gorilla-shell/vite.config.js +0 -21
@@ -1,12 +1,62 @@
1
- import { evaluateContextFixture, listContextEvalFixtures } from '../eval/index.js';
1
+ import {
2
+ evaluateContextFixture,
3
+ finishLiveEvalRun,
4
+ getLiveEvalStatus,
5
+ listContextEvalFixtures,
6
+ startLiveEvalRun,
7
+ } from '../eval/index.js';
2
8
 
3
9
  function parse(argv) {
4
- const out = { subcommand: argv[0] || '', fixture: '', strategy: 'all', model: 'gpt-6-astra', json: false, list: false };
5
- for (let i = 1; i < argv.length; i += 1) {
10
+ let subcommand = argv[0] || '';
11
+ let help = false;
12
+ if (subcommand === '--help' || subcommand === '-h') {
13
+ help = true;
14
+ subcommand = '';
15
+ }
16
+ const action = argv[1] || '';
17
+ const out = {
18
+ subcommand,
19
+ action,
20
+ fixture: '',
21
+ strategy: 'all',
22
+ model: '',
23
+ provider: '',
24
+ client: '',
25
+ reasoning: 'high',
26
+ suite: '',
27
+ case: '',
28
+ gate: '',
29
+ tenant: '',
30
+ workspace: '',
31
+ user: '',
32
+ database: '',
33
+ endpoint: '',
34
+ force: false,
35
+ remote: false,
36
+ json: false,
37
+ list: false,
38
+ help,
39
+ };
40
+
41
+ const startIndex = subcommand === 'live' ? 2 : 1;
42
+ for (let i = startIndex; i < argv.length; i += 1) {
6
43
  const arg = argv[i];
7
44
  if (arg === '--fixture') out.fixture = argv[++i] || '';
8
45
  else if (arg === '--strategy') out.strategy = argv[++i] || 'all';
9
- else if (arg === '--model') out.model = argv[++i] || 'gpt-6-astra';
46
+ else if (arg === '--model') out.model = argv[++i] || '';
47
+ else if (arg === '--provider') out.provider = argv[++i] || '';
48
+ else if (arg === '--client') out.client = argv[++i] || '';
49
+ else if (arg === '--reasoning') out.reasoning = argv[++i] || 'high';
50
+ else if (arg === '--suite') out.suite = argv[++i] || '';
51
+ else if (arg === '--case') out.case = argv[++i] || '';
52
+ else if (arg === '--gate') out.gate = argv[++i] || '';
53
+ else if (arg === '--tenant') out.tenant = argv[++i] || '';
54
+ else if (arg === '--workspace') out.workspace = argv[++i] || '';
55
+ else if (arg === '--user') out.user = argv[++i] || '';
56
+ else if (arg === '--database' || arg === '--db') out.database = argv[++i] || '';
57
+ else if (arg === '--endpoint') out.endpoint = argv[++i] || '';
58
+ else if (arg === '--force') out.force = true;
59
+ else if (arg === '--remote') out.remote = true;
10
60
  else if (arg === '--json') out.json = true;
11
61
  else if (arg === '--list') out.list = true;
12
62
  else if (arg === '--help' || arg === '-h') out.help = true;
@@ -15,7 +65,7 @@ function parse(argv) {
15
65
  return out;
16
66
  }
17
67
 
18
- function render(report) {
68
+ function renderContextReport(report) {
19
69
  const rows = [
20
70
  '',
21
71
  ' AgentSam · Context Eval',
@@ -45,19 +95,164 @@ function render(report) {
45
95
  return rows.join('\n');
46
96
  }
47
97
 
98
+ function renderLiveHelp() {
99
+ return `
100
+ AgentSam · Live Agent Evaluation
101
+
102
+ Usage:
103
+ agentsam eval live start --case <id> [--suite <id>] [--model <name>] [--provider <name>] [--client <client>] [--reasoning <high|medium|low>]
104
+ agentsam eval live status [--json]
105
+ agentsam eval live finish [--gate PASS|FAIL] [--remote] [--json]
106
+
107
+ Examples:
108
+ agentsam eval live start --suite sdk-real-work-20260919 --case cad-shell-unification --client cursor --model "Muse Spark 1.3"
109
+ agentsam eval live finish --gate PASS --remote
110
+ `;
111
+ }
112
+
48
113
  export async function runEval(argv = [], options = {}) {
49
114
  const args = parse(argv);
50
- const write = options.write || (text => process.stdout.write(text));
51
- if (args.help || args.subcommand !== 'context') {
115
+ const write = options.write || ((text) => process.stdout.write(text));
116
+
117
+ if (args.help || (!args.subcommand && !argv.length)) {
52
118
  write('agentsam eval context --fixture <name> [--strategy bounded|discovery|compact|all] [--model gpt-6-astra] [--json]\n');
119
+ write('agentsam eval live <start|status|finish> [options]\n');
53
120
  return null;
54
121
  }
55
- if (args.list) {
56
- const value = { fixtures: listContextEvalFixtures() };
57
- write(args.json ? `${JSON.stringify(value)}\n` : `${value.fixtures.join('\n')}\n`);
58
- return value;
122
+
123
+ if (args.subcommand === 'live') {
124
+ const action = args.action || 'status';
125
+
126
+ if (args.help || !action) {
127
+ write(renderLiveHelp());
128
+ return null;
129
+ }
130
+
131
+ if (action === 'start') {
132
+ const run = startLiveEvalRun(
133
+ {
134
+ suite: args.suite,
135
+ case: args.case,
136
+ model: args.model,
137
+ provider: args.provider,
138
+ client: args.client,
139
+ reasoning: args.reasoning,
140
+ tenant: args.tenant,
141
+ workspace: args.workspace,
142
+ user: args.user,
143
+ database: args.database,
144
+ },
145
+ options
146
+ );
147
+
148
+ if (args.json) {
149
+ write(JSON.stringify(run, null, 2) + '\n');
150
+ return run;
151
+ }
152
+
153
+ write(`\n ✓ Started live eval run: ${run.run_id}\n`);
154
+ write(` Suite: ${run.suite_id}\n`);
155
+ write(` Case: ${run.case_id}\n`);
156
+ write(` Tenant: ${run.tenant_id}\n`);
157
+ write(` Model: ${run.model} (${run.reasoning} reasoning)\n`);
158
+ write(` Client: ${run.client} (${run.provider})\n`);
159
+ write(` Base Git: ${run.base_commit.slice(0, 7) || 'clean'} on ${run.branch || 'main'}\n`);
160
+ write(` Started: ${run.started_at}\n\n`);
161
+ return run;
162
+ }
163
+
164
+ if (action === 'status') {
165
+ const status = getLiveEvalStatus(options);
166
+ if (args.json) {
167
+ write(JSON.stringify(status, null, 2) + '\n');
168
+ return status;
169
+ }
170
+
171
+ if (!status.active) {
172
+ write(' No live evaluation run currently in progress.\n');
173
+ return status;
174
+ }
175
+
176
+ const elapsedSec = (status.elapsed_ms / 1000).toFixed(1);
177
+ write(`\n Live Eval In Progress · ${status.run_id}\n`);
178
+ write(` Case: ${status.case_id} (${status.suite_id})\n`);
179
+ write(` Tenant: ${status.tenant_id || 'default'}\n`);
180
+ write(` Model: ${status.model} [${status.client}]\n`);
181
+ write(` Elapsed: ${elapsedSec}s\n`);
182
+ write(` Tool calls: ${status.receipts_summary?.tool_call_count || 0} (${status.receipts_summary?.mcp_call_count || 0} MCP)\n\n`);
183
+ return status;
184
+ }
185
+
186
+ if (action === 'finish') {
187
+ const result = await finishLiveEvalRun({
188
+ ...options,
189
+ gate: args.gate,
190
+ remote: args.remote,
191
+ tenant: args.tenant,
192
+ workspace: args.workspace,
193
+ user: args.user,
194
+ database: args.database,
195
+ evalEndpoint: args.endpoint,
196
+ force: args.force,
197
+ });
198
+
199
+ if (args.json) {
200
+ write(JSON.stringify(result, null, 2) + '\n');
201
+ return result;
202
+ }
203
+
204
+ const s = result.summary;
205
+ const elapsedMin = (s.elapsed_ms / 60000).toFixed(1);
206
+
207
+ write(`\n AgentSam Live Eval Summary\n`);
208
+ write(` ────────────────────────────────────────────────────────────\n`);
209
+ write(` Model: ${s.model} (${s.reasoning || 'high'})\n`);
210
+ write(` Case: ${s.case_id} (${s.suite_id})\n`);
211
+ write(` Tenant: ${s.tenant_id}\n`);
212
+ write(` Run ID: ${result.evalRunRow.id}\n`);
213
+ write(` Observation ID: ${result.modelObservationRow?.id || 'N/A'}\n`);
214
+ write(` Elapsed: ${elapsedMin}m (${(s.elapsed_ms / 1000).toFixed(1)}s)\n`);
215
+ write(` Files changed: ${s.files_changed} (+${s.insertions} / -${s.deletions})\n`);
216
+ write(` Tool calls: ${s.tool_call_count} total\n`);
217
+ write(` • MCP calls: ${s.mcp_call_count}\n`);
218
+ write(` • Terminal: ${s.terminal_call_count}\n`);
219
+ write(` • GitHub: ${s.github_call_count}\n`);
220
+ write(` • D1 / Database: ${s.d1_call_count}\n`);
221
+ write(` • Retries: ${s.failure_count}\n`);
222
+ write(` Gate status: ${s.gate_status}\n`);
223
+ write(` Commit: ${s.head_commit?.slice(0, 7) || 'N/A'}\n`);
224
+ write(` Local Archive: ${result.local_file}\n`);
225
+ if (s.d1_executed) {
226
+ write(` D1 Record: ✓ Recorded to ${s.tenant_id} (runs & observations via ${s.persistence_method || 'remote'})\n`);
227
+ } else if (s.d1_error) {
228
+ write(` D1 Record: ⚠ Remote persistence failed: ${s.d1_error}\n`);
229
+ if (s.state_preserved) {
230
+ write(` Status: Active run & telemetry preserved. Retry with --remote or pass --force\n`);
231
+ }
232
+ } else {
233
+ write(` D1 Record: ○ Local only (use --remote to push)\n`);
234
+ }
235
+ write(` ────────────────────────────────────────────────────────────\n\n`);
236
+ return result;
237
+ }
238
+
239
+ throw new Error(`unknown live eval action: ${action}`);
59
240
  }
60
- const report = await evaluateContextFixture({ fixture: args.fixture || 'exact-symbol-callers', strategy: args.strategy, model: args.model });
61
- write(args.json ? `${JSON.stringify(report)}\n` : render(report));
62
- return report;
241
+
242
+ if (args.subcommand === 'context') {
243
+ if (args.list) {
244
+ const value = { fixtures: listContextEvalFixtures() };
245
+ write(args.json ? `${JSON.stringify(value)}\n` : `${value.fixtures.join('\n')}\n`);
246
+ return value;
247
+ }
248
+ const report = await evaluateContextFixture({
249
+ fixture: args.fixture || 'exact-symbol-callers',
250
+ strategy: args.strategy,
251
+ model: args.model || 'gpt-6-astra',
252
+ });
253
+ write(args.json ? `${JSON.stringify(report)}\n` : renderContextReport(report));
254
+ return report;
255
+ }
256
+
257
+ throw new Error(`unknown eval subcommand: ${args.subcommand}`);
63
258
  }
@@ -0,0 +1,365 @@
1
+ import path from 'node:path';
2
+ import { cancel, intro, isCancel, outro, select } from '@clack/prompts';
3
+ import pc from 'picocolors';
4
+ import {
5
+ DEFAULT_PRODUCT,
6
+ discoverGoRuntime,
7
+ resolveProductRoot,
8
+ ensureProductContract,
9
+ preflightToolchain,
10
+ buildGoProduct,
11
+ deployGoCloudflare,
12
+ verifyGoProduct,
13
+ readLatestStatus,
14
+ runGoTests,
15
+ runGoVet,
16
+ runGoBuild,
17
+ } from '../go/index.js';
18
+ import { renderGoShipScenery, renderArchitectureExplorer } from '../ui/wireframes.js';
19
+
20
+ function parse(argv = []) {
21
+ const out = {
22
+ subcommand: null,
23
+ product: DEFAULT_PRODUCT,
24
+ cwd: process.cwd(),
25
+ json: false,
26
+ cloudflare: false,
27
+ dryRun: false,
28
+ skipDeploy: false,
29
+ skipRegistry: false,
30
+ help: false,
31
+ positionals: [],
32
+ };
33
+
34
+ for (let i = 0; i < argv.length; i += 1) {
35
+ const arg = argv[i];
36
+ if (arg === '--help' || arg === '-h') out.help = true;
37
+ else if (arg === '--json') out.json = true;
38
+ else if (arg === '--dry-run') out.dryRun = true;
39
+ else if (arg === '--skip-deploy') out.skipDeploy = true;
40
+ else if (arg === '--skip-registry') out.skipRegistry = true;
41
+ else if (arg === '--cwd') out.cwd = path.resolve(argv[++i] || out.cwd);
42
+ else if (arg === '--cloudflare') {
43
+ out.cloudflare = true;
44
+ const next = argv[i + 1];
45
+ if (next && !next.startsWith('-')) {
46
+ out.product = next;
47
+ i += 1;
48
+ }
49
+ } else if (['status', 'inspect', 'build', 'test', 'verify', 'deploy', 'products', 'runtime', 'dev', 'logs', 'explore'].includes(arg) && !out.subcommand) {
50
+ out.subcommand = arg;
51
+ } else if (!arg.startsWith('-')) {
52
+ out.positionals.push(arg);
53
+ } else {
54
+ throw new Error(`unknown go option: ${arg}`);
55
+ }
56
+ }
57
+
58
+ if (!out.subcommand && out.positionals[0] && !out.cloudflare) {
59
+ const maybe = out.positionals[0];
60
+ if (['status', 'inspect', 'build', 'test', 'verify', 'deploy', 'products', 'runtime', 'explore'].includes(maybe)) {
61
+ out.subcommand = maybe;
62
+ out.positionals = out.positionals.slice(1);
63
+ }
64
+ }
65
+ if (out.positionals[0] && out.product === DEFAULT_PRODUCT) {
66
+ out.product = out.positionals[0];
67
+ }
68
+ if (out.cloudflare && !out.subcommand) out.subcommand = 'cloudflare-ship';
69
+ if (!out.subcommand) out.subcommand = 'menu';
70
+ return out;
71
+ }
72
+
73
+ const HELP = `Agent Sam · Go
74
+
75
+ agentsam go Interactive status / actions (TTY)
76
+ agentsam go status [--json] Runtime + product status
77
+ agentsam go explore Architecture + operation wireframes (ANSI)
78
+ agentsam go inspect [--json] Discover Go source / toolchain
79
+ agentsam go test go test ./...
80
+ agentsam go build go build + build receipt
81
+ agentsam go verify [name] [--json] Local tests + optional live probe
82
+ agentsam go --cloudflare [name] Discover → build → validate → deploy → probe → D1 → receipt
83
+ agentsam go deploy [name] --cloudflare
84
+
85
+ First happy path:
86
+ agentsam go --cloudflare agentsam-go-worker
87
+
88
+ Flags:
89
+ --json Machine-readable output
90
+ --dry-run Validate and print plan without deploying
91
+ --skip-deploy Build/test/receipt only (no Wrangler deploy)
92
+ --skip-registry Skip remote D1 agentsam_products upsert
93
+ --cwd <path> Repository root override
94
+ `;
95
+
96
+ function writeHumanSteps(lines, write) {
97
+ write('\n Agent Sam · Go\n\n');
98
+ for (const line of lines) write(` ${line}\n`);
99
+ write('\n');
100
+ }
101
+
102
+ export async function runGo(argv = [], options = {}) {
103
+ const args = parse(argv);
104
+ const write = options.write || ((value) => process.stdout.write(value));
105
+ if (args.help) {
106
+ write(HELP);
107
+ return { ok: true, help: true };
108
+ }
109
+
110
+ const discovery = discoverGoRuntime(args.cwd);
111
+ const productRoot = resolveProductRoot(discovery, args.product);
112
+ const runtimeRoot = discovery.runtime?.runtimeRoot || path.join(productRoot, 'runtime');
113
+
114
+ if (args.subcommand === 'menu' && process.stdout.isTTY && !args.json) {
115
+ return runInteractiveMenu({ discovery, productRoot, runtimeRoot, args, write });
116
+ }
117
+
118
+ if (args.subcommand === 'inspect' || args.subcommand === 'runtime') {
119
+ const payload = { ok: true, discovery, productRoot, runtimeRoot };
120
+ write(args.json ? `${JSON.stringify(payload)}\n` : `${JSON.stringify(payload, null, 2)}\n`);
121
+ return payload;
122
+ }
123
+
124
+ if (args.subcommand === 'explore') {
125
+ const scenery = renderGoShipScenery({
126
+ product: args.product,
127
+ discovery,
128
+ deploy: { url: readLatestStatus(productRoot).deployment?.url, receipt: readLatestStatus(productRoot).deployment, probes: { ok: readLatestStatus(productRoot).deployment?.health === 'healthy' } },
129
+ build: { receipt: readLatestStatus(productRoot).build },
130
+ });
131
+ if (args.json) {
132
+ write(`${JSON.stringify({ ok: true, scenery: 'ansi', product: args.product })}\n`);
133
+ } else {
134
+ write(`\n${scenery}\n\n`);
135
+ write(`${pc.dim('Wireframes are reasoning scenery for the inline CLI — not pixel mockups.')}\n\n`);
136
+ }
137
+ return { ok: true, explore: true };
138
+ }
139
+
140
+ if (args.subcommand === 'status' || args.subcommand === 'products') {
141
+ const latest = readLatestStatus(productRoot);
142
+ const status = {
143
+ ok: true,
144
+ product: args.product,
145
+ discovery: {
146
+ go: discovery.go,
147
+ runtime: discovery.runtime
148
+ ? { module: discovery.runtime.module, runtimeRoot: discovery.runtime.runtimeRoot, entry: discovery.runtime.entry }
149
+ : null,
150
+ product_exists: discovery.product_exists,
151
+ },
152
+ build: latest.build,
153
+ deployment: latest.deployment,
154
+ registry: latest.product,
155
+ };
156
+ if (args.json) write(`${JSON.stringify(status)}\n`);
157
+ else {
158
+ writeHumanSteps([
159
+ discovery.go?.ok ? `✓ Go ${discovery.go.goversion || discovery.go.version}` : '✗ Go toolchain missing',
160
+ discovery.runtime ? `✓ AgentSam Go source · ${discovery.runtime.module}` : '✗ Go runtime not discovered',
161
+ status.deployment?.url ? `✓ deployed · ${status.deployment.url} · ${status.deployment.health}` : '· no deployment receipt yet',
162
+ ], write);
163
+ write(`${JSON.stringify(status, null, 2)}\n`);
164
+ }
165
+ return status;
166
+ }
167
+
168
+ if (args.subcommand === 'test') {
169
+ const tests = runGoTests(runtimeRoot);
170
+ const vet = runGoVet(runtimeRoot);
171
+ const payload = { ok: tests.ok && vet.ok, tests, vet };
172
+ write(args.json ? `${JSON.stringify(payload)}\n` : `${tests.stdout}${tests.stderr}${vet.stdout}${vet.stderr}`);
173
+ if (!payload.ok) {
174
+ const err = new Error('go_test_failed');
175
+ err.reported = true;
176
+ throw err;
177
+ }
178
+ return payload;
179
+ }
180
+
181
+ if (args.subcommand === 'build') {
182
+ ensureProductContract(productRoot);
183
+ const result = buildGoProduct({
184
+ productRoot,
185
+ runtimeRoot,
186
+ repositoryRoot: discovery.repository_root,
187
+ dryRun: args.dryRun,
188
+ });
189
+ write(args.json ? `${JSON.stringify(result)}\n` : `✓ build receipt · ${result.receiptPath}\n`);
190
+ return result;
191
+ }
192
+
193
+ if (args.subcommand === 'verify') {
194
+ const result = await verifyGoProduct({
195
+ productRoot,
196
+ runtimeRoot,
197
+ skipLive: args.dryRun || args.skipDeploy,
198
+ });
199
+ write(args.json ? `${JSON.stringify(result)}\n` : `${JSON.stringify(result, null, 2)}\n`);
200
+ if (!result.ok) {
201
+ const err = new Error('go_verify_failed');
202
+ err.reported = true;
203
+ throw err;
204
+ }
205
+ return result;
206
+ }
207
+
208
+ if (args.subcommand === 'deploy' || args.subcommand === 'cloudflare-ship') {
209
+ return shipCloudflare({ discovery, productRoot, runtimeRoot, args, write });
210
+ }
211
+
212
+ write(HELP);
213
+ return { ok: true, help: true };
214
+ }
215
+
216
+ async function shipCloudflare({ discovery, productRoot, runtimeRoot, args, write }) {
217
+ const steps = [];
218
+ const note = (line) => {
219
+ steps.push(line);
220
+ if (!args.json) write(` ${line}\n`);
221
+ };
222
+
223
+ if (!args.json) write('\n Agent Sam · Go\n\n');
224
+
225
+ note(discovery.runtime ? '✓ existing AgentSam Go runtime discovered' : '✗ Go runtime missing');
226
+ if (!discovery.runtime) throw new Error('go_runtime_not_found');
227
+ note(discovery.go?.ok ? '✓ go toolchain' : '✗ go toolchain');
228
+ if (!discovery.go?.ok) throw new Error('go_toolchain_missing');
229
+
230
+ const preflight = preflightToolchain({
231
+ requireDocker: !(args.dryRun || args.skipDeploy),
232
+ productRoot,
233
+ });
234
+ for (const check of preflight.checks) {
235
+ note(`${check.ok ? '✓' : '·'} ${check.id}${check.detail ? ` · ${String(check.detail).slice(0, 80)}` : ''}`);
236
+ }
237
+
238
+ const contract = ensureProductContract(productRoot);
239
+ note(contract.existing ? '✓ existing product contract' : '✓ product contract established');
240
+ note('✓ deployment contract · cloudflare worker-container');
241
+
242
+ if (!args.json) {
243
+ write(`\n Product\n ${args.product}\n`);
244
+ write(' Target\n cloudflare\n');
245
+ write(' Runtime\n go/native + worker edge\n\n');
246
+ }
247
+
248
+ if (!args.json) write(' Building\n');
249
+ const build = buildGoProduct({
250
+ productRoot,
251
+ runtimeRoot,
252
+ repositoryRoot: discovery.repository_root,
253
+ dryRun: args.dryRun,
254
+ });
255
+ note('✓ go test ./...');
256
+ note('✓ go vet ./...');
257
+ note(build.build.binary ? `✓ Go binary · ${path.basename(build.build.binary)}` : '✓ Go build skipped (dry-run)');
258
+
259
+ if (!args.json) write('\n Deploying\n');
260
+ const deploy = await deployGoCloudflare({
261
+ productRoot,
262
+ product: args.product,
263
+ dryRun: args.dryRun,
264
+ skipDeploy: args.skipDeploy,
265
+ skipRegistry: args.skipRegistry,
266
+ });
267
+ if (deploy.deployed) note(`✓ ${args.product}`);
268
+ else if (args.dryRun) note('· dry-run · deploy skipped');
269
+ else if (args.skipDeploy) note('· skip-deploy · local receipts only');
270
+ else note('· deploy not completed');
271
+
272
+ if (deploy.url && !args.json) write(`\n Live\n ${deploy.url}\n`);
273
+ if (!args.json) write('\n Validation\n');
274
+ if (deploy.probes?.results) {
275
+ for (const [key, value] of Object.entries(deploy.probes.results)) {
276
+ note(`${value.ok ? '✓' : '✗'} ${key}`);
277
+ }
278
+ } else {
279
+ note('· live probes skipped');
280
+ }
281
+
282
+ if (!args.json) write('\n Registered\n');
283
+ if (deploy.registry?.remote) note('✓ agentsam_products · remote D1 upsert');
284
+ else if (deploy.registry?.skipped) note(`· agentsam_products · ${deploy.registry.reason || 'local only'}`);
285
+ else note('✓ agentsam_products (local projection)');
286
+ if (deploy.registry?.remote) note('✓ asset_relationships · remote D1 upsert');
287
+ else note('✓ asset relationships (local metadata)');
288
+ note('✓ deployment receipt');
289
+
290
+ const payload = {
291
+ ok: Boolean(build && (args.dryRun || args.skipDeploy || deploy.probes?.ok || deploy.deployed)),
292
+ product: args.product,
293
+ existing_product: contract.existing,
294
+ scaffold_changes_required: contract.created.length > 0,
295
+ discovery,
296
+ contract,
297
+ build: build.receipt,
298
+ deploy,
299
+ steps,
300
+ };
301
+
302
+ // Idempotent success: second run with healthy prior deploy still ok even if live probe skipped.
303
+ if (args.dryRun || args.skipDeploy) payload.ok = true;
304
+ if (deploy.deployed && deploy.probes && !deploy.probes.skipped) payload.ok = deploy.probes.ok;
305
+
306
+ if (args.json) write(`${JSON.stringify(payload)}\n`);
307
+ else {
308
+ write(`\n${renderGoShipScenery({ product: args.product, discovery, deploy, build })}\n`);
309
+ write(`\n ${payload.ok ? 'ready' : 'incomplete'} · ${args.product}\n`);
310
+ if (contract.existing && !contract.created.length) {
311
+ write(' ✓ existing product · update/redeploy path (no sibling scaffold)\n');
312
+ }
313
+ write('\n');
314
+ }
315
+
316
+ if (!payload.ok && !args.dryRun && !args.skipDeploy) {
317
+ const err = new Error('go_cloudflare_ship_incomplete');
318
+ err.detail = payload;
319
+ err.reported = true;
320
+ throw err;
321
+ }
322
+ return payload;
323
+ }
324
+
325
+ async function runInteractiveMenu({ discovery, productRoot, runtimeRoot, args, write }) {
326
+ intro(pc.bgCyan(pc.black(' Agent Sam · Go ')));
327
+ const status = readLatestStatus(productRoot);
328
+ write(`\n Runtime\n`);
329
+ write(` ${discovery.go?.ok ? '✓' : '✗'} Go ${discovery.go?.goversion || ''}\n`);
330
+ write(` ${discovery.runtime ? '✓' : '✗'} AgentSam Go source discovered\n`);
331
+ write(`\n Products\n`);
332
+ write(` ${args.product.padEnd(28)} ${status.deployment?.health || 'undeployed'} ${status.deployment?.url || ''}\n\n`);
333
+
334
+ write(`\n${renderArchitectureExplorer({
335
+ repo: 'agentsam-sdk',
336
+ git: discovery.git,
337
+ tree: ['apps/', 'packages/', 'protocol/', 'src/go/', 'runtime/'],
338
+ focus: {
339
+ package: args.product,
340
+ owns: 'Go runtime + CF container edge',
341
+ runtime: 'go/native + worker',
342
+ imported_by: 'CLI · deploy adapter · D1 registry',
343
+ files: 'main.go · wrangler · Dockerfile',
344
+ },
345
+ })}\n\n`);
346
+
347
+ const action = await select({
348
+ message: 'What would you like to do?',
349
+ options: [
350
+ { value: 'explore', label: 'Explore wireframes' },
351
+ { value: 'build', label: 'Build' },
352
+ { value: 'test', label: 'Test' },
353
+ { value: 'inspect', label: 'Inspect' },
354
+ { value: 'cloudflare-ship', label: 'Deploy to Cloudflare' },
355
+ { value: 'verify', label: 'Verify deployment' },
356
+ { value: 'status', label: 'Show runtime' },
357
+ ],
358
+ });
359
+ if (isCancel(action)) {
360
+ cancel('Cancelled.');
361
+ return { ok: false, cancelled: true };
362
+ }
363
+ outro(`Running ${action}`);
364
+ return runGo([action, args.product, ...(args.json ? ['--json'] : [])], { write });
365
+ }