@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
@@ -0,0 +1,293 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { repositorySnapshot } from '../capabilities/index.js';
4
+ import {
5
+ brandScan,
6
+ brandResolve,
7
+ brandPlan,
8
+ buildBrandContractDraft,
9
+ brandGoapActions,
10
+ brandWorldFromPlan,
11
+ brandGoalFromPlan,
12
+ } from '../../packages/agentsam-brand/src/index.js';
13
+ import { suggestNextActions } from '../progression/index.js';
14
+ import { createRuntimeActivity } from '../ui/runtime-activity.js';
15
+
16
+ function parseArgs(argv = []) {
17
+ const out = { json: false, cwd: process.cwd(), dryRun: false, goap: false, write: false, positionals: [] };
18
+ for (let i = 0; i < argv.length; i += 1) {
19
+ const a = argv[i];
20
+ if (a === '--json') out.json = true;
21
+ else if (a === '--cwd') out.cwd = argv[++i] || out.cwd;
22
+ else if (a === '--dry-run') out.dryRun = true;
23
+ else if (a === '--goap') out.goap = true;
24
+ else if (a === '--write') out.write = true;
25
+ else if (a === '--snapshot-file') out.snapshotFile = argv[++i] || '';
26
+ else out.positionals.push(a);
27
+ }
28
+ return out;
29
+ }
30
+
31
+ async function loadSnapshot(opts) {
32
+ if (opts.snapshotFile) {
33
+ return JSON.parse(fs.readFileSync(path.resolve(opts.cwd, opts.snapshotFile), 'utf8'));
34
+ }
35
+ return repositorySnapshot({ cwd: opts.cwd, churnDays: 30 });
36
+ }
37
+
38
+ function printNext(actions) {
39
+ if (!actions?.length) return;
40
+ console.log('\nSuggested');
41
+ for (const a of actions.slice(0, 5)) {
42
+ console.log(`→ ${a.label}`);
43
+ if (a.command) console.log(` ${a.command}`);
44
+ if (a.reason) console.log(` ${a.reason}`);
45
+ }
46
+ console.log('');
47
+ }
48
+
49
+ function attachProgression(capability, result, json) {
50
+ const { next_actions } = suggestNextActions({ capability, result });
51
+ const receipt = {
52
+ capability,
53
+ status: 'completed',
54
+ repository_snapshot: result.repository?.snapshot_id || result.snapshot_id || null,
55
+ content_hash: result.content_hash || null,
56
+ next_actions,
57
+ };
58
+ if (json) return { ...result, receipt, next_actions };
59
+ printNext(next_actions);
60
+ return { ...result, receipt, next_actions };
61
+ }
62
+
63
+ export async function runBrand(argv = []) {
64
+ const opts = parseArgs(argv);
65
+ const [sub = '', ...rest] = opts.positionals;
66
+ const action = sub || 'summary';
67
+
68
+ if (action === 'help' || action === '--help') {
69
+ console.log(`usage: agentsam brand [summary|scan|resolve|inspect|plan|apply|verify] [options]
70
+
71
+ summary (default) Short brand intelligence overview
72
+ scan Deterministic evidence extraction (no model)
73
+ resolve Cluster tokens into inferred roles
74
+ inspect [conflicts] Show conflicts / component families
75
+ plan [--goap] Normalization plan (preserve → improve)
76
+ apply --dry-run Mutation stub (writes require future approval)
77
+ verify Stub verification gate
78
+
79
+ Options:
80
+ --json --cwd <path> --snapshot-file <file> --write
81
+ `);
82
+ return;
83
+ }
84
+
85
+ if (action === 'apply') {
86
+ if (!opts.dryRun) {
87
+ console.error('brand apply requires --dry-run until mutations are gated (side_effects: repository-write)');
88
+ process.exitCode = 2;
89
+ return;
90
+ }
91
+ const out = {
92
+ capability: 'brand.apply',
93
+ status: 'dry-run',
94
+ message: 'No files changed. Approve a brand.plan then re-run apply when mutation executor ships.',
95
+ };
96
+ if (opts.json) console.log(JSON.stringify(out, null, 2));
97
+ else console.log(out.message);
98
+ return;
99
+ }
100
+
101
+ if (action === 'verify') {
102
+ const out = {
103
+ capability: 'brand.verify',
104
+ status: 'stub',
105
+ message: 'Verify will re-scan and diff against .agentsam/brand/contract.json',
106
+ };
107
+ if (opts.json) console.log(JSON.stringify(out, null, 2));
108
+ else console.log(out.message);
109
+ return;
110
+ }
111
+
112
+ const tty = process.stdout.isTTY && !opts.json;
113
+ const activity = tty ? createRuntimeActivity({ label: 'Brand intelligence' }) : null;
114
+ const onEvent = (ev) => {
115
+ if (!activity) return;
116
+ if (ev.type === 'operation.phase.started') activity.update(String(ev.phase || 'working'));
117
+ if (ev.type === 'operation.progress') activity.update(String(ev.detail || ev.phase || 'scanning'));
118
+ };
119
+
120
+ try {
121
+ activity?.start('snapshot');
122
+ const snapshot = await loadSnapshot(opts);
123
+
124
+ if (action === 'summary' || action === 'scan' || action === 'resolve' || action === 'inspect' || action === 'plan') {
125
+ const scan = await brandScan({
126
+ cwd: opts.cwd,
127
+ snapshot,
128
+ onEvent,
129
+ });
130
+
131
+ if (action === 'scan') {
132
+ const enriched = attachProgression('brand.scan', scan, opts.json);
133
+ if (opts.write) writeArtifacts(opts.cwd, { evidence: scan });
134
+ if (opts.json) console.log(JSON.stringify(enriched, null, 2));
135
+ else {
136
+ console.log(`\nBrand scan complete · ${scan.repository.snapshot_id}`);
137
+ console.log(` colors ${scan.tokens.colors.length}`);
138
+ console.log(` conflicts ${scan.conflicts.length}`);
139
+ console.log(` css files ${scan.sources.css}`);
140
+ console.log(` components ${scan.sources.components}`);
141
+ console.log(` hash ${scan.content_hash}`);
142
+ }
143
+ return;
144
+ }
145
+
146
+ const resolved = brandResolve(scan);
147
+ if (action === 'resolve') {
148
+ const enriched = attachProgression('brand.resolve', { ...resolved, repository: scan.repository, content_hash: scan.content_hash }, opts.json);
149
+ if (opts.write) writeArtifacts(opts.cwd, { evidence: scan, resolved });
150
+ if (opts.json) console.log(JSON.stringify({ ...resolved, next_actions: enriched.next_actions }, null, 2));
151
+ else {
152
+ console.log(`\nBrand resolve · ${Object.keys(resolved.resolved.colors).length} color roles`);
153
+ console.log(` ambiguities ${resolved.ambiguities.length}`);
154
+ for (const a of resolved.ambiguities.slice(0, 5)) {
155
+ console.log(` ? ${a.question}`);
156
+ }
157
+ }
158
+ return;
159
+ }
160
+
161
+ if (action === 'inspect') {
162
+ const focus = rest[0] || 'conflicts';
163
+ const payload = focus === 'components'
164
+ ? { capability: 'brand.inspect', focus, components: scan.components, patterns: scan.patterns }
165
+ : { capability: 'brand.inspect', focus, conflicts: scan.conflicts, colors: scan.tokens.colors.slice(0, 20) };
166
+ if (opts.json) console.log(JSON.stringify(payload, null, 2));
167
+ else if (focus === 'components') {
168
+ console.log('\nComponent families');
169
+ for (const [k, v] of Object.entries(scan.components).slice(0, 20)) {
170
+ console.log(` ${k} ×${v.count}`);
171
+ }
172
+ } else {
173
+ console.log(`\nConflicts (${scan.conflicts.length})`);
174
+ for (const c of scan.conflicts.slice(0, 15)) {
175
+ console.log(` ${c.values?.join(' ≈ ')} · d=${c.distance} · n=${c.occurrences}`);
176
+ }
177
+ }
178
+ return;
179
+ }
180
+
181
+ if (action === 'plan') {
182
+ return runBrandPlanInner({ scan, resolved, opts });
183
+ }
184
+
185
+ // summary
186
+ const contract = buildBrandContractDraft({ scan, resolved });
187
+ const plan = brandPlan({ scan, resolved, contract });
188
+ const { next_actions } = suggestNextActions({ capability: 'brand.scan', result: scan });
189
+ const summary = {
190
+ capability: 'brand.summary',
191
+ repository: scan.repository,
192
+ sources: scan.sources,
193
+ summary: plan.summary,
194
+ confidence: resolved.confidence,
195
+ ambiguities: resolved.ambiguities.slice(0, 5),
196
+ next_actions,
197
+ };
198
+ if (opts.write) writeArtifacts(opts.cwd, { evidence: scan, resolved, contract });
199
+ if (opts.json) console.log(JSON.stringify(summary, null, 2));
200
+ else {
201
+ console.log(`\nBrand · ${scan.repository.snapshot_id}`);
202
+ console.log(` ${plan.summary.colors} colors · ${plan.summary.near_duplicate_pairs} near-duplicates`);
203
+ console.log(` ${plan.summary.button_families} button families · ${plan.summary.header_families} header/nav families`);
204
+ console.log(` confidence colors=${resolved.confidence.colors} typography=${resolved.confidence.typography}`);
205
+ printNext(next_actions);
206
+ }
207
+ }
208
+ } finally {
209
+ activity?.stop?.();
210
+ }
211
+ }
212
+
213
+ async function runBrandPlanInner({ scan, resolved, opts }) {
214
+ const contract = buildBrandContractDraft({ scan, resolved });
215
+ const plan = brandPlan({ scan, resolved, contract });
216
+ let goap = null;
217
+ if (opts.goap) {
218
+ const world = brandWorldFromPlan(plan);
219
+ const goal = brandGoalFromPlan(plan);
220
+ const actions = brandGoapActions();
221
+ const sequence = [];
222
+ const state = { ...world };
223
+ // greedy applicable actions by cost until goal satisfied or stuck
224
+ for (let guard = 0; guard < 20; guard += 1) {
225
+ const done = Object.entries(goal).every(([k, v]) => state[k] === v);
226
+ if (done) break;
227
+ const candidates = actions
228
+ .filter((a) => Object.entries(a.preconditions || {}).every(([k, v]) => state[k] === v))
229
+ .filter((a) => !sequence.includes(a.id))
230
+ .sort((a, b) => (a.cost || 1) - (b.cost || 1));
231
+ if (!candidates.length) break;
232
+ const next = candidates[0];
233
+ sequence.push(next.id);
234
+ Object.assign(state, next.effects || {});
235
+ }
236
+ goap = {
237
+ ok: sequence.length > 0,
238
+ plan: sequence,
239
+ cost: sequence.reduce((n, id) => n + (actions.find((a) => a.id === id)?.cost || 0), 0),
240
+ engine: 'brand-goap-greedy',
241
+ };
242
+ }
243
+ const enriched = attachProgression('brand.plan', plan, opts.json);
244
+ const out = { ...plan, goap, next_actions: enriched.next_actions };
245
+ if (opts.write) {
246
+ writeArtifacts(opts.cwd, { evidence: scan, resolved, contract });
247
+ const dir = path.join(opts.cwd, '.agentsam', 'brand');
248
+ fs.mkdirSync(dir, { recursive: true });
249
+ fs.writeFileSync(path.join(dir, 'plan.json'), `${JSON.stringify(out, null, 2)}\n`);
250
+ }
251
+ if (opts.json) console.log(JSON.stringify(out, null, 2));
252
+ else {
253
+ console.log('\nBrand coherence plan');
254
+ console.log(` philosophy ${plan.philosophy}`);
255
+ console.log(` colors ${plan.summary.colors} (${plan.summary.near_duplicate_pairs} near-dup pairs)`);
256
+ console.log(' steps');
257
+ for (const [i, s] of plan.steps.entries()) {
258
+ console.log(` ${i + 1}. [${s.action}] ${s.title}`);
259
+ }
260
+ if (goap?.ok) console.log(` goap cost=${goap.cost} · ${goap.plan?.join(' → ')}`);
261
+ }
262
+ }
263
+
264
+ export async function runPlan(argv = []) {
265
+ const opts = parseArgs(argv);
266
+ const [domain, ...rest] = opts.positionals;
267
+ if (!domain || domain === 'help') {
268
+ console.log(`usage: agentsam plan <domain>
269
+
270
+ Domains:
271
+ brand [--goap] [--json] [--write]
272
+ security (use: agentsam security scan)
273
+ repository (use: agentsam inspect)
274
+ release (use: agentsam status / package verify)
275
+
276
+ Composable grammar: agentsam plan brand
277
+ `);
278
+ return;
279
+ }
280
+ if (domain === 'brand') {
281
+ return runBrand(['plan', ...rest, ...(opts.json ? ['--json'] : []), ...(opts.goap ? ['--goap'] : []), ...(opts.write ? ['--write'] : []), ...(opts.cwd !== process.cwd() ? ['--cwd', opts.cwd] : [])]);
282
+ }
283
+ console.error(`plan domain not implemented: ${domain}`);
284
+ process.exitCode = 2;
285
+ }
286
+
287
+ function writeArtifacts(cwd, { evidence, resolved, contract }) {
288
+ const dir = path.join(cwd, '.agentsam', 'brand');
289
+ fs.mkdirSync(dir, { recursive: true });
290
+ if (evidence) fs.writeFileSync(path.join(dir, 'evidence.json'), `${JSON.stringify(evidence, null, 2)}\n`);
291
+ if (resolved) fs.writeFileSync(path.join(dir, 'resolved.json'), `${JSON.stringify(resolved, null, 2)}\n`);
292
+ if (contract) fs.writeFileSync(path.join(dir, 'contract.json'), `${JSON.stringify(contract, null, 2)}\n`);
293
+ }
@@ -106,6 +106,7 @@ function required(value, message) {
106
106
  }
107
107
 
108
108
  export async function runCad(argv) {
109
+ if (argv[0] === 'project') return (await import('../lib/cad/project-cli.js')).runProjectCli(argv.slice(1));
109
110
  const engine = argv[0];
110
111
  if (!engine || engine === '--help' || engine === '-h') {
111
112
  console.log(usage());
@@ -9,6 +9,7 @@ import {
9
9
  resolveCloudflareOAuthClient,
10
10
  } from '../../packages/connectors/cloudflare/src/index.js';
11
11
  import { resolveIamIssuer } from '../../packages/identity/src/contracts/auth-config.js';
12
+ import { collectRuntimeStatus } from './runtime-status.js';
12
13
 
13
14
  const PRODUCTION_CALLBACK = `https://agentsam.inneranimalmedia.com${CLOUDFLARE_CALLBACK_PATH}`;
14
15
 
@@ -45,49 +46,145 @@ function printSetup(env = process.env) {
45
46
  return 0;
46
47
  }
47
48
 
48
- export async function runConnections(args = []) {
49
+ function bindingKey(row = {}) {
50
+ return String(row.name || '').trim();
51
+ }
52
+
53
+ function bindingTypeLabel(type = '') {
54
+ switch (String(type || '').trim()) {
55
+ case 'plain_text': return 'Variable';
56
+ case 'json': return 'Variable (JSON)';
57
+ case 'secret_text': return 'Secret';
58
+ case 'secret_key': return 'Secret key';
59
+ case 'ai': return 'Workers AI';
60
+ case 'd1': return 'D1 database';
61
+ case 'service': return 'Service binding';
62
+ case 'hyperdrive': return 'Hyperdrive';
63
+ case 'vpc_service': return 'VPC Service';
64
+ case 'r2_bucket': return 'R2 bucket';
65
+ case 'assets': return 'Assets';
66
+ default: return String(type || 'Binding');
67
+ }
68
+ }
69
+
70
+ function bindingTarget(row = {}) {
71
+ if (row.type === 'secret_text' || row.type === 'secret_key') return 'Value encrypted';
72
+ if (row.value != null) return String(row.value);
73
+ if (row.database_name) return row.database_name;
74
+ if (row.bucket_name) return row.bucket_name;
75
+ if (row.service) return row.environment ? `${row.service} · ${row.environment}` : row.service;
76
+ if (row.index_name) return row.index_name;
77
+ if (row.database_id) return row.database_id;
78
+ if (row.service_id) return row.service_id;
79
+ if (row.id) return row.id;
80
+ if (row.namespace) return row.namespace;
81
+ if (row.store_id && row.secret_name) return `${row.store_id} · ${row.secret_name}`;
82
+ return '';
83
+ }
84
+
85
+ function renderBindingRows(rows = []) {
86
+ if (!rows.length) return [' none'];
87
+ const width = Math.min(32, Math.max(4, ...rows.map((row) => bindingKey(row).length)));
88
+ return rows.map((row) => {
89
+ const name = bindingKey(row).padEnd(width);
90
+ const type = bindingTypeLabel(row.type);
91
+ const target = bindingTarget(row);
92
+ return ` ${name} ${type}${target ? ` · ${target}` : ''}`;
93
+ });
94
+ }
95
+
96
+ function renderWorkerBindings(status) {
97
+ const cloudflare = status.cloudflare || {};
98
+ const bindings = cloudflare.bindings;
99
+ if (!bindings) return [' Worker runtime not verified'];
100
+
101
+ const variables = Array.isArray(bindings.runtime_variables) ? bindings.runtime_variables : [];
102
+ const secrets = Array.isArray(bindings.runtime_secrets) ? bindings.runtime_secrets : [];
103
+ const resources = Array.isArray(bindings.resources) ? bindings.resources : [];
104
+ const declared = Array.isArray(bindings.declared) ? bindings.declared : [];
105
+ const missing = Array.isArray(bindings.missing) ? bindings.missing : [];
106
+ const mismatches = Array.isArray(bindings.type_mismatches) ? bindings.type_mismatches : [];
107
+
108
+ const lines = [];
109
+ if (cloudflare.version?.id || cloudflare.version?.number != null) {
110
+ const versionLabel = cloudflare.version?.number != null ? `v${cloudflare.version.number}` : 'version';
111
+ lines.push(` live Worker ${versionLabel}${cloudflare.version?.id ? ` · ${cloudflare.version.id}` : ''}`);
112
+ }
113
+
114
+ lines.push('');
115
+ lines.push(` Runtime variables and secrets ${variables.length} variables · ${secrets.length} secrets`);
116
+ lines.push(...renderBindingRows([...variables, ...secrets].sort((a, b) => bindingKey(a).localeCompare(bindingKey(b)))));
117
+
118
+ lines.push('');
119
+ lines.push(` Bindings ${resources.length} live resources`);
120
+ lines.push(...renderBindingRows(resources.sort((a, b) => bindingKey(a).localeCompare(bindingKey(b)))));
121
+
122
+ lines.push('');
123
+ lines.push(` Config comparison ${declared.length} declared locally · ${missing.length} missing live · ${mismatches.length} type mismatch`);
124
+ if (cloudflare.config) lines.push(` source ${cloudflare.config}`);
125
+ if (missing.length) {
126
+ for (const row of missing) lines.push(` ✗ ${bindingKey(row)} · declared ${row.type || 'unknown'} · missing from live version`);
127
+ }
128
+ if (mismatches.length) {
129
+ for (const row of mismatches) lines.push(` ! ${bindingKey(row)} · declared ${row.declared || 'unknown'} · live ${row.live || 'unknown'}`);
130
+ }
131
+
132
+ return lines;
133
+ }
134
+
135
+ function renderConnections(status) {
136
+ const lines = ['', ' Agent Sam · connections', ''];
137
+ lines.push(` IAM account ${status.identity?.authenticated ? 'connected' : 'not connected'}`);
138
+ lines.push(` active auth ${status.identity?.active_auth?.kind || 'none'}`);
139
+ lines.push(` model providers ${(status.model_summary?.configured_providers || []).join(', ') || 'none configured'}`);
140
+ lines.push(` terminal registry ${status.terminal?.connected ? `${status.terminal.active_connection_count} active / ${status.terminal.connections.length} total` : `unavailable · ${status.terminal?.error || 'not authenticated'}`}`);
141
+ for (const row of status.terminal?.connections || []) {
142
+ lines.push(` ${row.default ? '★' : '•'} ${row.name || row.id} · ${row.kind || 'terminal'} · ${row.active ? 'active' : 'inactive'} · ${row.health}`);
143
+ }
144
+ lines.push(` Worker ${status.cloudflare?.connected ? `${status.cloudflare.worker_name} · live` : status.cloudflare?.configured ? `${status.cloudflare.worker_name} · not verified` : 'not configured'}`);
145
+ lines.push(...renderWorkerBindings(status));
146
+ lines.push('');
147
+ lines.push(' Live Cloudflare binding names/targets are shown; secret values and terminal endpoint credentials are never printed.');
148
+ lines.push('');
149
+ return lines.join('\n');
150
+ }
151
+
152
+ export async function runConnections(args = [], options = {}) {
49
153
  const argv = args.filter((a) => a !== '--json');
50
154
  const jsonMode = args.includes('--json');
51
- const env = process.env;
155
+ const env = options.env || process.env;
156
+ const write = options.write || ((value) => process.stdout.write(value));
52
157
  if (argv[0] === 'cloudflare' && argv[1] === 'setup') {
53
158
  if (jsonMode) {
54
- console.log(JSON.stringify({
159
+ write(`${JSON.stringify({
55
160
  callback: PRODUCTION_CALLBACK,
56
161
  authorize: 'https://dash.cloudflare.com/oauth2/auth',
57
162
  token: 'https://dash.cloudflare.com/oauth2/token',
58
163
  revoke: 'https://dash.cloudflare.com/oauth2/revoke',
59
164
  mintsRealClient: false,
60
165
  client: resolveCloudflareOAuthClient(env),
61
- }, null, 2));
166
+ }, null, 2)}\n`);
62
167
  return 0;
63
168
  }
64
169
  return printSetup(env);
65
170
  }
66
- const report = doctor(env);
171
+ if (argv.length) throw new Error(`unknown connections option: ${argv[0]}`);
172
+ const status = await (options.collectRuntime || collectRuntimeStatus)({
173
+ ...options,
174
+ env,
175
+ cwd: options.cwd || process.cwd(),
176
+ discoverModels: true,
177
+ });
67
178
  if (jsonMode) {
68
- console.log(JSON.stringify({ identity: report.identity, cloudflare: report.cloudflare }, null, 2));
69
- return 0;
179
+ write(`${JSON.stringify({
180
+ schema_version: status.schema_version,
181
+ identity: status.identity,
182
+ providers: status.models?.providers || [],
183
+ terminal: status.terminal,
184
+ cloudflare: status.cloudflare,
185
+ }, null, 2)}\n`);
186
+ return status;
70
187
  }
71
- const iam = report.identity;
72
- const cf = report.cloudflare;
73
- const client = report.client;
74
- console.log('AgentSam Identity');
75
- console.log('');
76
- console.log('IAM client');
77
- console.log(` ${iam.clientId ? '✓' : '•'} client id`);
78
- console.log(` ✓ issuer ${iam.issuer}`);
79
- console.log(` ${iam.serverSecret ? '✓' : '•'} server secret configured`);
80
- if (iam.originAlias) console.log('Compatibility\n IAM_ORIGIN -> deprecated alias');
81
- console.log('');
82
- console.log('Cloudflare connection');
83
- console.log('');
84
- console.log('OAuth client');
85
- console.log(` client id: ${cf.clientId}`);
86
- console.log(` secret: ${cf.secret}`);
87
- console.log(` status: ${client.status}`);
88
- if (client.fixture) {
89
- console.log(' OAuth client fixture configured');
90
- console.log(' real Cloudflare OAuth client still required');
91
- }
92
- return 0;
188
+ write(renderConnections(status));
189
+ return status;
93
190
  }
@@ -58,6 +58,8 @@ export function buildContextEconomicsReport(cwd, options = {}) {
58
58
  model: model.provider_model_id,
59
59
  model_key: model.model_key,
60
60
  resolved: true,
61
+ compaction_supported: ['openai', 'grok'].includes(model.provider) && model.capabilities?.compaction === true,
62
+ auto_compact: options.autoCompact !== false,
61
63
  reasoning_effort: preferences.reasoningEffort || 'auto',
62
64
  service_tier: preferences.serviceTier || 'default',
63
65
  active_input_tokens: active,
@@ -117,6 +119,12 @@ export function renderContextEconomics(report) {
117
119
  ` intervene at ${formatInteger(report.intervene_at_tokens)}`,
118
120
  ` max normal ${formatInteger(report.max_normal_input_tokens)}`,
119
121
  '',
122
+ ' Compaction',
123
+ ` support ${report.compaction_supported ? 'native' : 'unavailable'}`,
124
+ ` automatic ${report.compaction_supported && report.auto_compact ? 'enabled' : 'disabled'}`,
125
+ ` threshold ${formatInteger(report.compact_at_tokens)}`,
126
+ ' command /compact · /compact status',
127
+ '',
120
128
  ' Economics',
121
129
  ` price threshold ${formatInteger(report.pricing_threshold_tokens)}`,
122
130
  ` remaining ${remaining}`,
@@ -1,3 +1,4 @@
1
+ import { discoverProjectStores, selectKnowledgeStore } from '../knowledge/store-discovery.js';
1
2
  import fs from 'node:fs';
2
3
  import path from 'node:path';
3
4
  import { createLocalSqliteDatabase, initializeLocalSqlite, inspectLocalSqlite } from '../local/sqlite.js';
@@ -24,6 +25,12 @@ function resolveDb(root, config) {
24
25
 
25
26
  export async function runDb(argv = [], opts = {}) {
26
27
  const sub = argv[0] || 'status';
28
+ if (sub === 'sources' || sub === 'select') {
29
+ if (sub === 'select' && (argv[1] !== 'knowledge' || !argv[2] || argv.length > 4)) throw new Error('Usage: /db select knowledge sqlite|postgres [CONNECTION_ENV]');
30
+ const result = sub === 'sources' ? await discoverProjectStores(opts.cwd || process.cwd()) : selectKnowledgeStore(opts.cwd || process.cwd(), argv[2], argv[3]);
31
+ (opts.write || console.log)(JSON.stringify(result, null, 2) + '\n');
32
+ return result;
33
+ }
27
34
  if (!['init', 'migrate', 'status'].includes(sub)) {
28
35
  throw new Error(`unknown db command: ${sub}`);
29
36
  }
@@ -6,7 +6,7 @@ import path from 'node:path';
6
6
  import readline from 'node:readline';
7
7
  import { authenticateViaBrowser } from '../lib/auth.js';
8
8
  import { getJson, streamScaffold } from '../lib/core-client.js';
9
- import { resolveAccountSdkKey } from '../lib/account-session.js';
9
+ import { resolveAccountAuth } from '../lib/account-session.js';
10
10
  import { getDefaultProfile, getDeployTarget, getLocalSchemaPath, getProjectName, getProjectPreset, readProjectConfig, setDeployTarget, writeProjectConfig } from '../lib/project-config.js';
11
11
  import { isLocalStudioCheckout, runLocalStudioDeploy } from '../lib/deploy/local-studio.js';
12
12
 
@@ -68,7 +68,7 @@ function ask(question) {
68
68
  async function runCloudflareDeploy(cwd, config, accountId) {
69
69
  console.log('\n Cloudflare deploy — browser sign-in + resource provisioning…\n');
70
70
 
71
- let token = resolveAccountSdkKey({ env: process.env }).value;
71
+ let token = resolveAccountAuth({ env: process.env }).value;
72
72
  if (!token) {
73
73
  const session = await authenticateViaBrowser();
74
74
  token = session.access_token;
@@ -5,12 +5,13 @@ const PROVIDERS = Object.freeze(['openai', 'anthropic', 'gemini', 'grok', 'cloud
5
5
 
6
6
  function writeLine(write, value = '') { write(`${value}\n`); }
7
7
 
8
- function detectCloudflareAccounts(options = {}) {
8
+ export function detectCloudflareAccounts(options = {}) {
9
9
  const env = options.env || process.env;
10
- const explicit = String(options.accountId || env.ACCOUNT_ID || env.CLOUDFLARE_ACCOUNT_ID || '').trim();
10
+ const explicit = String(options.accountId || env.CLOUDFLARE_ACCOUNT_ID || '').trim();
11
11
  if (explicit) return { accounts: [{ id: explicit, name: null }], source: 'environment' };
12
12
  const spawn = options.spawnSyncImpl || spawnSync;
13
- const result = spawn('npx', ['--no-install', 'wrangler', 'whoami', '--json'], { cwd: options.cwd || process.cwd(), env, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
13
+ const npxBin = process.platform === 'win32' ? 'npx.cmd' : 'npx';
14
+ const result = spawn(npxBin, ['--no-install', 'wrangler', 'whoami', '--json'], { cwd: options.cwd || process.cwd(), env, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], shell: process.platform === 'win32' });
14
15
  if (result?.status !== 0) return { accounts: [], source: 'wrangler', error: String(result?.stderr || '').trim() || `wrangler exited ${result?.status ?? 'unknown'}` };
15
16
  try {
16
17
  const parsed = JSON.parse(String(result.stdout || '{}'));
@@ -67,7 +68,7 @@ export async function runEnv(argv = [], options = {}) {
67
68
  if (provider === 'cloudflare') {
68
69
  if (accountId) writeLine(write, ` account detected/configured (${cloudflareAccounts?.source || 'explicit'})`);
69
70
  else if ((cloudflareAccounts?.accounts || []).length > 1) writeLine(write, ` account ${cloudflareAccounts.accounts.length} Wrangler accounts found · rerun with --account-id <id>`);
70
- else writeLine(write, ' account not detected · set ACCOUNT_ID in the profile or rerun with --account-id <id>');
71
+ else writeLine(write, ' account not detected · set CLOUDFLARE_ACCOUNT_ID in the profile or rerun with --account-id <id>');
71
72
  cloudflareGuidance(write);
72
73
  }
73
74
  writeLine(write, '');