@inneranimalmedia/agentsam-sdk 2.6.2 → 2.6.4

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 (661) hide show
  1. package/AGENTSAM.md +51 -1
  2. package/README.md +95 -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/bin/agentsam +16 -1
  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/THEME_REFINERY.md +120 -0
  25. package/docs/architecture/AGENTSAM_DISTRIBUTION_OWNERSHIP.md +176 -0
  26. package/docs/architecture/AGENTSAM_GO_RUNTIME.md +282 -0
  27. package/docs/architecture/CODEBASEINDEX_GUIDED_PATH.md +202 -0
  28. package/docs/architecture/FS_E2E_CLOSURE_RECEIPT.md +59 -0
  29. package/docs/architecture/LOCAL_FS_AUTHORITY.md +38 -0
  30. package/docs/architecture/LOCAL_STUDIO_CLOUDFLARE_OAUTH.md +28 -0
  31. package/docs/architecture/PLAN_CLI_AND_LOCAL_STUDIO_DESKTOP.md +96 -0
  32. package/docs/architecture/PROVIDER-TOOLS-AND-COMPACTION.md +60 -0
  33. package/docs/architecture/SAM_ACTIVITY_RECOVERY_RECEIPT.md +39 -0
  34. package/docs/architecture/SAM_DECISION_WORK_RECEIPT.md +54 -0
  35. package/docs/architecture/SAM_KERNEL.md +181 -0
  36. package/docs/architecture/SAM_MACHINE_NORMALIZATION_PRECOMMIT_REPORT.md +208 -0
  37. package/docs/architecture/SLASH_SKILLS_PORTABLE.md +116 -0
  38. package/docs/architecture/STORAGE.md +87 -0
  39. package/docs/architecture/fs-e2e-receipt.latest.json +42 -0
  40. package/docs/architecture/previews/codebaseindex-guided-path/CODEBASEINDEX_GUIDED_PATH.md +202 -0
  41. package/docs/architecture/previews/codebaseindex-guided-path/index.html +321 -0
  42. package/docs/cad-project-tools.md +69 -0
  43. package/docs/cms-scaffolding-pattern-reference.md +73 -0
  44. package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS-codex-tui-20260919.md +113 -0
  45. package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS.md +85 -0
  46. package/docs/plans/AGENTSAM-MCP-CLIENT-2026-09-19.md +181 -0
  47. package/docs/plans/ASBD-PORTABLE-WORKGRAPH-UI-DEFERRED.md +34 -0
  48. package/docs/plans/ASTRA-BRIEF-2026-09-18.md +258 -0
  49. package/docs/plans/MULTI-AGENT-SPRINTS-2026-09-19.md +373 -0
  50. package/docs/plans/NEXT-AGENT-HANDOFF.md +167 -0
  51. package/docs/plans/RECONCILIATION-2026-09-19.md +178 -0
  52. package/docs/plugins.md +43 -0
  53. package/docs/tools/README.md +57 -0
  54. package/docs/tools/agent-and-orchestration.md +49 -0
  55. package/docs/tools/browser-and-research.md +46 -0
  56. package/docs/tools/cloudflare-platform.md +32 -0
  57. package/docs/tools/cms.md +25 -0
  58. package/docs/tools/communications.md +41 -0
  59. package/docs/tools/database-and-storage.md +62 -0
  60. package/docs/tools/design-and-media.md +64 -0
  61. package/docs/tools/filesystem-and-code.md +55 -0
  62. package/docs/tools/github.md +56 -0
  63. package/docs/tools/integrations-and-misc.md +16 -0
  64. package/docs/tools/memory.md +21 -0
  65. package/docs/tools/terminal-and-execution.md +29 -0
  66. package/docs/tools/tickets-and-platform.md +30 -0
  67. package/migrations/d1/0001_agentsam_plugin_runtime.sql +177 -0
  68. package/migrations/d1/0002_agentsam_ticket_ownership.sql +8 -0
  69. package/migrations/d1/0002_dynamic_model_policies.sql +23 -0
  70. package/migrations/d1/0003_expand_tool_handler_families.sql +18 -0
  71. package/migrations/d1/0004_project_aware_retrieval_lanes.sql +24 -0
  72. package/migrations/d1/0005_portable_knowledge_identity.sql +104 -0
  73. package/migrations/d1/0006_repair_ops_trail_account_scope.sql +14 -0
  74. package/migrations/d1/0007_repair_ops_trail_agent_run_account.sql +13 -0
  75. package/migrations/d1/0008_backfill_knowledge_run_legacy_tenant.sql +14 -0
  76. package/migrations/d1/0009_normalize_cloudflare_plugin_installations.sql +137 -0
  77. package/migrations/d1/0010_portable_tickets_memory.sql +140 -0
  78. package/migrations/d1/0011_agentsam_skill_v2.sql +185 -0
  79. package/migrations/d1/0011b_agentsam_skill_v2_cutover.sql +22 -0
  80. package/migrations/d1/0011c_agentsam_skill_v2_backfill.sql +76 -0
  81. package/migrations/d1/0011d_agentsam_skill_v2_retrieval_revisions.sql +50 -0
  82. package/migrations/d1/0012_agentsam_tools_required_seed.sql +67 -0
  83. package/migrations/d1/0013_identity_oauth_states.sql +15 -0
  84. package/migrations/d1/0014_auth_event_log.sql +20 -0
  85. package/migrations/d1/0015_identity_oauth_state_app_id.sql +3 -0
  86. package/migrations/d1/README_PORTABLE_CONTROL_PLANE.md +16 -0
  87. package/migrations/runtime/0001_cli_runtime.sql +67 -0
  88. package/migrations/runtime/0002_project_sessions.sql +15 -0
  89. package/migrations/runtime/0003_provider_continuations.sql +8 -0
  90. package/migrations/sqlite/agentsam_skill_retrieval.portable.sql +42 -0
  91. package/package.json +107 -12
  92. package/packages/agentsam-brand/README.md +21 -0
  93. package/packages/agentsam-brand/package.json +22 -0
  94. package/packages/agentsam-brand/src/contract.js +59 -0
  95. package/packages/agentsam-brand/src/extract.js +126 -0
  96. package/packages/agentsam-brand/src/goap-actions.js +73 -0
  97. package/packages/agentsam-brand/src/index.js +48 -0
  98. package/packages/agentsam-brand/src/plan.js +115 -0
  99. package/packages/agentsam-brand/src/resolve.js +139 -0
  100. package/packages/agentsam-brand/src/scan.js +250 -0
  101. package/packages/agentsam-brand/test/brand-scan.test.mjs +106 -0
  102. package/packages/agentsam-contracts/README.md +23 -0
  103. package/packages/agentsam-contracts/package.json +32 -0
  104. package/packages/agentsam-contracts/src/adapter.ts +25 -0
  105. package/packages/agentsam-contracts/src/agent.ts +35 -0
  106. package/packages/agentsam-contracts/src/artifacts.ts +33 -0
  107. package/packages/agentsam-contracts/src/authority.ts +29 -0
  108. package/packages/agentsam-contracts/src/context.ts +16 -0
  109. package/packages/agentsam-contracts/src/errors.ts +62 -0
  110. package/packages/agentsam-contracts/src/events.ts +47 -0
  111. package/packages/agentsam-contracts/src/execution.ts +50 -0
  112. package/packages/agentsam-contracts/src/hooks.ts +40 -0
  113. package/packages/agentsam-contracts/src/identity.ts +16 -0
  114. package/packages/agentsam-contracts/src/index.ts +14 -0
  115. package/packages/agentsam-contracts/src/models.ts +9 -0
  116. package/packages/agentsam-contracts/src/providers.ts +33 -0
  117. package/packages/agentsam-contracts/src/repository.ts +64 -0
  118. package/packages/agentsam-contracts/src/tools.ts +98 -0
  119. package/packages/agentsam-contracts/test/contracts.test.mjs +16 -0
  120. package/packages/agentsam-contracts/test/errors-catalog.test.mjs +25 -0
  121. package/packages/agentsam-contracts/test/repository.test.mjs +18 -0
  122. package/packages/agentsam-contracts/tsconfig.json +12 -0
  123. package/packages/agentsam-errors/package.json +17 -0
  124. package/packages/agentsam-errors/src/adapters/anthropic.js +15 -0
  125. package/packages/agentsam-errors/src/adapters/cad.js +109 -0
  126. package/packages/agentsam-errors/src/adapters/cloudflare.js +21 -0
  127. package/packages/agentsam-errors/src/adapters/cursor.js +4 -0
  128. package/packages/agentsam-errors/src/adapters/device.js +38 -0
  129. package/packages/agentsam-errors/src/adapters/docker.js +28 -0
  130. package/packages/agentsam-errors/src/adapters/gcp.js +14 -0
  131. package/packages/agentsam-errors/src/adapters/github.js +22 -0
  132. package/packages/agentsam-errors/src/adapters/google.js +17 -0
  133. package/packages/agentsam-errors/src/adapters/index.js +55 -0
  134. package/packages/agentsam-errors/src/adapters/internal.js +40 -0
  135. package/packages/agentsam-errors/src/adapters/oauth.js +24 -0
  136. package/packages/agentsam-errors/src/adapters/openai.js +17 -0
  137. package/packages/agentsam-errors/src/adapters/process.js +35 -0
  138. package/packages/agentsam-errors/src/adapters/provider.js +114 -0
  139. package/packages/agentsam-errors/src/envelope.js +239 -0
  140. package/packages/agentsam-errors/src/error.js +24 -0
  141. package/packages/agentsam-errors/src/fingerprint.js +35 -0
  142. package/packages/agentsam-errors/src/index.js +11 -0
  143. package/packages/agentsam-errors/src/normalize.js +30 -0
  144. package/packages/agentsam-errors/src/recovery.js +301 -0
  145. package/packages/agentsam-errors/src/redaction.js +52 -0
  146. package/packages/agentsam-errors/src/render.js +16 -0
  147. package/packages/agentsam-errors/src/retry.js +10 -0
  148. package/packages/agentsam-errors/src/transport.js +52 -0
  149. package/packages/agentsam-errors/src/vocabulary.js +320 -0
  150. package/packages/agentsam-errors/test/envelope.test.mjs +70 -0
  151. package/packages/agentsam-errors/test/providers.test.mjs +99 -0
  152. package/packages/agentsam-errors/test/redaction.test.mjs +21 -0
  153. package/packages/agentsam-errors/test/runtime-cad-device.test.mjs +76 -0
  154. package/packages/agentsam-errors/test/transport.test.mjs +46 -0
  155. package/packages/agentsam-knowledge/package.json +15 -0
  156. package/packages/agentsam-knowledge/src/autorag/index.js +64 -0
  157. package/packages/agentsam-knowledge/src/backends/index.js +26 -0
  158. package/packages/agentsam-knowledge/src/index.js +3 -0
  159. package/packages/agentsam-knowledge/src/providers/index.js +107 -0
  160. package/packages/agentsam-knowledge/test/autorag.test.mjs +42 -0
  161. package/packages/agentsam-nav/README.md +40 -0
  162. package/packages/agentsam-nav/dist/Nav.d.ts +43 -0
  163. package/packages/agentsam-nav/dist/NavCollapsible.d.ts +10 -0
  164. package/packages/agentsam-nav/dist/NavContent.d.ts +2 -0
  165. package/packages/agentsam-nav/dist/NavFooter.d.ts +2 -0
  166. package/packages/agentsam-nav/dist/NavGroup.d.ts +3 -0
  167. package/packages/agentsam-nav/dist/NavHeader.d.ts +2 -0
  168. package/packages/agentsam-nav/dist/NavMenu.d.ts +22 -0
  169. package/packages/agentsam-nav/dist/NavProvider.d.ts +35 -0
  170. package/packages/agentsam-nav/dist/NavTrigger.d.ts +2 -0
  171. package/packages/agentsam-nav/dist/Surfaces.d.ts +41 -0
  172. package/packages/agentsam-nav/dist/browser.d.ts +11 -0
  173. package/packages/agentsam-nav/dist/browser.global.js +132 -0
  174. package/packages/agentsam-nav/dist/browser.js +613 -0
  175. package/packages/agentsam-nav/dist/contracts.d.ts +76 -0
  176. package/packages/agentsam-nav/dist/index.d.ts +11 -0
  177. package/packages/agentsam-nav/dist/index.js +614 -0
  178. package/packages/agentsam-nav/dist/legacy.css +83 -0
  179. package/packages/agentsam-nav/dist/shell.css +113 -0
  180. package/packages/agentsam-nav/dist/theme.css +113 -0
  181. package/packages/agentsam-nav/dist/utils.d.ts +1 -0
  182. package/packages/agentsam-nav/package.json +43 -0
  183. package/packages/agentsam-queue-control/README.md +107 -0
  184. package/packages/agentsam-queue-control/package.json +31 -0
  185. package/packages/agentsam-queue-control/schemas/job-envelope.schema.json +56 -0
  186. package/packages/agentsam-queue-control/src/adapters/cloudflare.js +152 -0
  187. package/packages/agentsam-queue-control/src/adapters/memory.js +38 -0
  188. package/packages/agentsam-queue-control/src/contracts.js +130 -0
  189. package/packages/agentsam-queue-control/src/control-plane.js +141 -0
  190. package/packages/agentsam-queue-control/src/dispatch.js +43 -0
  191. package/packages/agentsam-queue-control/src/index.js +7 -0
  192. package/packages/agentsam-queue-control/src/policy.js +88 -0
  193. package/packages/agentsam-queue-control/src/topology.js +66 -0
  194. package/packages/agentsam-queue-control/test/queue-control.test.mjs +100 -0
  195. package/packages/agentsam-repository/src/goap.js +718 -0
  196. package/packages/agentsam-repository/src/goap.js.bak-20260922011251 +670 -0
  197. package/packages/agentsam-repository/src/index.js +5 -0
  198. package/packages/agentsam-repository/src/merkle/cloudflare-persistence.js +2 -2
  199. package/packages/agentsam-repository/src/tickets.js +184 -0
  200. package/packages/agentsam-repository/src/work-tracking.js +199 -0
  201. package/packages/agentsam-repository/src/workspace-state.js +176 -0
  202. package/packages/agentsam-repository/test/goap-tickets-workspace-state.test.mjs +152 -0
  203. package/packages/connectors/cloudflare/src/index.js +297 -15
  204. package/packages/connectors/cloudflare/src/owner.js +43 -40
  205. package/packages/connectors/cloudflare/src/routes.js +176 -26
  206. package/packages/connectors/cloudflare/tests/connector.test.mjs +137 -2
  207. package/packages/heuristic-theme/README.md +11 -0
  208. package/packages/heuristic-theme/package.json +25 -0
  209. package/packages/heuristic-theme/src/index.js +2 -0
  210. package/packages/heuristic-theme/src/registry.js +36 -0
  211. package/packages/heuristic-theme/src/theme.js +41 -0
  212. package/packages/heuristic-theme/test/theme.test.mjs +26 -0
  213. package/packages/identity/.agentsam/features/oauth-login-portal/agentsam.feature.json +64 -0
  214. package/packages/identity/.agentsam/features/oauth-login-portal/providers.json +96 -0
  215. package/packages/identity/.agentsam/features/oauth-login-portal/resources.json +47 -0
  216. package/packages/identity/.agentsam/features/oauth-login-portal/routes.json +83 -0
  217. package/packages/identity/.agentsam/features/oauth-login-portal/ui.json +35 -0
  218. package/packages/identity/docs/PORTABLE_IDENTITY_ARCHITECTURE.md +50 -0
  219. package/packages/identity/migrations/D1_SCHEMA_MAPPING.md +31 -0
  220. package/packages/identity/migrations/sqlite/001_identity_core.sql +99 -0
  221. package/packages/identity/migrations/sqlite/002_identity_oauth_client.sql +38 -0
  222. package/packages/identity/migrations/sqlite/003_identity_oauth_server.sql +64 -0
  223. package/packages/identity/package.json +4 -3
  224. package/packages/identity/src/adapters/cloudflare-d1/ids.js +4 -0
  225. package/packages/identity/src/adapters/cloudflare-d1/index.js +156 -18
  226. package/packages/identity/src/adapters/sqlite/index.js +319 -0
  227. package/packages/identity/src/app/verify-app.js +95 -0
  228. package/packages/identity/src/contracts/identity-store.js +115 -0
  229. package/packages/identity/src/contracts/provider.js +3 -2
  230. package/packages/identity/src/contracts/route-ids.js +30 -0
  231. package/packages/identity/src/contracts/route-projection.js +218 -0
  232. package/packages/identity/src/contracts/routes.js +11 -0
  233. package/packages/identity/src/core/browser-paths.js +4 -5
  234. package/packages/identity/src/core/constants.js +13 -8
  235. package/packages/identity/src/core/session-policy.js +32 -0
  236. package/packages/identity/src/frontend/auth-portal/pages/login.html +16 -9
  237. package/packages/identity/src/frontend/auth-portal/pages/reset.html +3 -3
  238. package/packages/identity/src/frontend/auth-portal/pages/signup.html +3 -3
  239. package/packages/identity/src/frontend/auth-portal/preview/dashboard-stub.html +1 -1
  240. package/packages/identity/src/index.js +27 -0
  241. package/packages/identity/src/oauth/README.md +10 -4
  242. package/packages/identity/src/oauth/credentials.js +31 -11
  243. package/packages/identity/src/oauth/finalize-inbound.js +1 -1
  244. package/packages/identity/src/oauth/iam-platform.js +13 -12
  245. package/packages/identity/src/oauth/redirect-paths.js +27 -36
  246. package/packages/identity/src/providers/cloudflare/index.js +19 -0
  247. package/packages/identity/src/providers/cloudflare/mapper.js +21 -0
  248. package/packages/identity/src/providers/cloudflare/oauth.js +48 -0
  249. package/packages/identity/src/providers/cloudflare/profile.js +28 -0
  250. package/packages/identity/src/providers/index.js +18 -2
  251. package/packages/identity/src/server/identity-service.js +35 -8
  252. package/packages/identity/src/server/mount-policy.js +30 -0
  253. package/packages/identity/src/server/post-auth.js +79 -0
  254. package/packages/identity/src/server/worker-router.js +153 -66
  255. package/packages/identity/tests/finalize-inbound-oauth.test.mjs +6 -6
  256. package/packages/identity/tests/iam-provider.test.mjs +1 -1
  257. package/packages/identity/tests/identity-service.test.mjs +47 -1
  258. package/packages/identity/tests/oauth-credentials.test.mjs +3 -1
  259. package/packages/identity/tests/portable-identity-architecture.test.mjs +157 -0
  260. package/packages/identity/tests/session-routes-policy.test.mjs +21 -0
  261. package/packages/providers/completeful/README.md +38 -0
  262. package/packages/providers/completeful/package.json +29 -0
  263. package/packages/providers/completeful/src/client.js +162 -0
  264. package/packages/providers/completeful/src/events.js +49 -0
  265. package/packages/providers/completeful/src/index.js +22 -0
  266. package/packages/providers/completeful/src/tools.js +579 -0
  267. package/packages/providers/completeful/src/webhooks.js +55 -0
  268. package/packages/providers/completeful/test/provider.test.mjs +196 -0
  269. package/packages/theme-church-site/README.md +10 -0
  270. package/packages/theme-church-site/package.json +31 -0
  271. package/packages/theme-church-site/src/harvest.json +14 -0
  272. package/packages/theme-church-site/src/index.js +85 -0
  273. package/packages/theme-church-site/test/theme.test.mjs +19 -0
  274. package/packages/theme-companions-site/README.md +10 -0
  275. package/packages/theme-companions-site/package.json +31 -0
  276. package/packages/theme-companions-site/src/harvest.json +12 -0
  277. package/packages/theme-companions-site/src/index.js +83 -0
  278. package/packages/theme-companions-site/test/theme.test.mjs +19 -0
  279. package/packages/theme-floors-site/README.md +10 -0
  280. package/packages/theme-floors-site/package.json +31 -0
  281. package/packages/theme-floors-site/src/harvest.json +14 -0
  282. package/packages/theme-floors-site/src/index.js +83 -0
  283. package/packages/theme-floors-site/test/theme.test.mjs +19 -0
  284. package/packages/theme-fuelnfree-site/README.md +10 -0
  285. package/packages/theme-fuelnfree-site/package.json +31 -0
  286. package/packages/theme-fuelnfree-site/src/harvest.json +13 -0
  287. package/packages/theme-fuelnfree-site/src/index.js +82 -0
  288. package/packages/theme-fuelnfree-site/test/theme.test.mjs +19 -0
  289. package/packages/theme-handyman-site/README.md +10 -0
  290. package/packages/theme-handyman-site/package.json +31 -0
  291. package/packages/theme-handyman-site/src/harvest.json +10 -0
  292. package/packages/theme-handyman-site/src/index.js +84 -0
  293. package/packages/theme-handyman-site/test/theme.test.mjs +19 -0
  294. package/packages/theme-insurance-site/README.md +10 -0
  295. package/packages/theme-insurance-site/package.json +31 -0
  296. package/packages/theme-insurance-site/src/harvest.json +10 -0
  297. package/packages/theme-insurance-site/src/index.js +84 -0
  298. package/packages/theme-insurance-site/test/theme.test.mjs +19 -0
  299. package/packages/theme-shinshu-site/README.md +10 -0
  300. package/packages/theme-shinshu-site/package.json +31 -0
  301. package/packages/theme-shinshu-site/src/harvest.json +12 -0
  302. package/packages/theme-shinshu-site/src/index.js +84 -0
  303. package/packages/theme-shinshu-site/test/theme.test.mjs +19 -0
  304. package/packages/work-graph/README.md +49 -0
  305. package/packages/work-graph/package.json +19 -0
  306. package/packages/work-graph/prototype/README.md +32 -0
  307. package/packages/work-graph/prototype/data/demo-workgraph.js +47 -0
  308. package/packages/work-graph/prototype/renderers/timeline-model.js +21 -0
  309. package/packages/work-graph/prototype/renderers/workgraph-runtime.js +38 -0
  310. package/packages/work-graph/prototype-gnantt.html +655 -0
  311. package/packages/work-graph/src/adapters/business/projects.js +23 -0
  312. package/packages/work-graph/src/adapters/engineering/git.js +22 -0
  313. package/packages/work-graph/src/adapters/engineering/mcp.js +22 -0
  314. package/packages/work-graph/src/index.js +76 -0
  315. package/packages/work-graph/src/renderers/gantt-model.js +11 -0
  316. package/packages/work-graph/src/renderers/timeline.js +16 -0
  317. package/packages/work-graph/test/work-graph.test.mjs +37 -0
  318. package/protocol/README.md +12 -0
  319. package/protocol/apps/agentsam.app.v1.schema.json +51 -0
  320. package/protocol/brand/brandpack.v1.schema.json +43 -0
  321. package/protocol/capabilities/cloudflare-cpu-audit-input.schema.json +30 -6
  322. package/protocol/capabilities/cloudflare-cpu-profile-input.schema.json +18 -4
  323. package/protocol/capabilities/cloudflare-wrangler-native-input.schema.json +59 -10
  324. package/protocol/capabilities/knowledge-search-input.schema.json +35 -0
  325. package/protocol/capabilities/manifest.json +163 -1
  326. package/protocol/capabilities/repository-audit-input.schema.json +39 -6
  327. package/protocol/capabilities/repository-snapshot-input.schema.json +15 -3
  328. package/protocol/capabilities/terminal-exec-input.schema.json +55 -0
  329. package/protocol/commerce/catalog.v1.json +50 -0
  330. package/protocol/credentials/issue.v1.schema.json +38 -0
  331. package/protocol/database/connection.v1.schema.json +41 -0
  332. package/protocol/embeddings/embedding-profile.v1.schema.json +20 -0
  333. package/protocol/errors/error-catalog.json +164 -0
  334. package/protocol/errors/error-envelope.schema.json +678 -0
  335. package/protocol/errors/recovery.v1.schema.json +50 -0
  336. package/protocol/features/README.md +57 -0
  337. package/protocol/features/agentsam.feature.v1.schema.json +290 -0
  338. package/protocol/features/catalog.json +65 -0
  339. package/protocol/features/examples/provider-resend.feature.json +17 -0
  340. package/protocol/go/agentsam-go-runtime.v1.json +17 -0
  341. package/protocol/knowledge/LIFECYCLE.md +140 -0
  342. package/protocol/knowledge/README.md +4 -0
  343. package/protocol/presets/catalog.json +128 -19
  344. package/protocol/rpc/v1/errors.proto +24 -0
  345. package/protocol/runtime/workspace-fs.v1.schema.json +71 -0
  346. package/protocol/sam/activity.v1.schema.json +48 -0
  347. package/protocol/sam/answer.v1.schema.json +35 -0
  348. package/protocol/sam/calibration.v1.schema.json +21 -0
  349. package/protocol/sam/decision-receipt.v1.schema.json +29 -0
  350. package/protocol/sam/evaluation.v1.schema.json +19 -0
  351. package/protocol/sam/operation.schema.json +66 -0
  352. package/protocol/sam/outcome.v1.schema.json +36 -0
  353. package/protocol/sam/question.v1.schema.json +26 -0
  354. package/protocol/sam/registry.seed.json +153 -0
  355. package/protocol/sam/result.schema.json +53 -0
  356. package/protocol/sam/state.v1.schema.json +23 -0
  357. package/protocol/skills/agentsam.interaction.v1.schema.json +50 -0
  358. package/protocol/skills/agentsam.skill.v1.schema.json +57 -0
  359. package/protocol/theme-refinery/d1-reconciliation.md +48 -0
  360. package/protocol/theme-refinery/product-metadata.schema.json +27 -0
  361. package/protocol/theme-refinery/receipts/products-registry-batch-20260924.json +318 -0
  362. package/protocol/theme-refinery/receipts/theme-harvest-20260924.json +472 -0
  363. package/protocol/theme-refinery/reconciliation-receipt.schema.json +83 -0
  364. package/protocol/ui/icon-registry.mjs +226 -0
  365. package/protocol/ui/icon.v1.schema.json +51 -0
  366. package/services/cad/server.py +249 -2
  367. package/skills/README.md +22 -9
  368. package/skills/agentsam-codebaseindex/SKILL.md +225 -0
  369. package/skills/catalog.json +14 -0
  370. package/src/agent/capability-adapter.js +15 -5
  371. package/src/agent/index.js +2 -1
  372. package/src/agent/model-turn.js +51 -0
  373. package/src/agent/responses-runner.js +304 -38
  374. package/src/capabilities/index.js +1 -0
  375. package/src/capabilities/terminal-exec.js +78 -0
  376. package/src/cli/command-catalog.js +130 -0
  377. package/src/cli/dispatch.js +48 -0
  378. package/src/cli.js +160 -10
  379. package/src/cloudflare/index.js +6 -0
  380. package/src/cloudflare/runtime-status.js +393 -0
  381. package/src/cloudflare/wrangler.js +17 -1
  382. package/src/commands/api-key.js +244 -0
  383. package/src/commands/app.js +138 -0
  384. package/src/commands/autorag.js +77 -0
  385. package/src/commands/brand.js +291 -0
  386. package/src/commands/cad.js +1 -0
  387. package/src/commands/codebaseindex.js +688 -0
  388. package/src/commands/connections.js +126 -29
  389. package/src/commands/context-economics.js +8 -0
  390. package/src/commands/db.js +7 -0
  391. package/src/commands/env.js +155 -27
  392. package/src/commands/eval.js +209 -14
  393. package/src/commands/go.js +678 -0
  394. package/src/commands/goap.js +176 -0
  395. package/src/commands/identity-init.js +27 -3
  396. package/src/commands/identity-protocol.js +195 -0
  397. package/src/commands/interaction-clack.js +115 -0
  398. package/src/commands/knowledge.js +64 -5
  399. package/src/commands/mcp.js +341 -0
  400. package/src/commands/merkle-persist.js +3 -1
  401. package/src/commands/merkle.js +18 -3
  402. package/src/commands/models.js +110 -24
  403. package/src/commands/plugins.js +175 -0
  404. package/src/commands/preferences.js +28 -8
  405. package/src/commands/product.js +53 -10
  406. package/src/commands/providers.js +173 -44
  407. package/src/commands/resume.js +9 -5
  408. package/src/commands/runtime-status.js +154 -0
  409. package/src/commands/shell.js +508 -56
  410. package/src/commands/skill.js +248 -0
  411. package/src/commands/skills.js +1 -1
  412. package/src/commands/start-local.js +4 -0
  413. package/src/commands/status.js +82 -7
  414. package/src/commands/tunnel.js +228 -195
  415. package/src/commands/whoami.js +156 -12
  416. package/src/context/budget.js +6 -0
  417. package/src/context/index.js +2 -1
  418. package/src/context/project-card.js +75 -0
  419. package/src/errors/contract.js +34 -211
  420. package/src/errors/diagnostic.js +95 -51
  421. package/src/errors/index.js +6 -13
  422. package/src/eval/index.js +6 -0
  423. package/src/eval/live.js +439 -0
  424. package/src/features/resolve.js +242 -0
  425. package/src/go/build.js +298 -0
  426. package/src/go/cloudflare.js +608 -0
  427. package/src/go/container.js +120 -0
  428. package/src/go/contract.js +144 -0
  429. package/src/go/discover.js +212 -0
  430. package/src/go/index.js +25 -0
  431. package/src/go/native-probe-runner.mjs +119 -0
  432. package/src/go/official-registry.js +280 -0
  433. package/src/go/official-release.js +10 -0
  434. package/src/go/receipts.js +144 -0
  435. package/src/go/verify.js +38 -0
  436. package/src/index.js +127 -1
  437. package/src/indexing/ingest/discover-models.js +298 -0
  438. package/src/indexing/ingest/inventory.js +243 -0
  439. package/src/indexing/ingest/job-graph.js +181 -0
  440. package/src/indexing/ingest/materials.js +210 -0
  441. package/src/knowledge/config.js +13 -5
  442. package/src/knowledge/engine.js +23 -8
  443. package/src/knowledge/index.js +1 -0
  444. package/src/knowledge/lane-registry.js +46 -0
  445. package/src/knowledge/providers/gemini.js +48 -8
  446. package/src/knowledge/service/client.js +13 -1
  447. package/src/knowledge/service/grpc-codec.js +156 -53
  448. package/src/knowledge/service/job-engine.js +133 -11
  449. package/src/knowledge/service/job-worker.js +34 -5
  450. package/src/knowledge/service/server.js +10 -1
  451. package/src/knowledge/store-discovery.js +77 -0
  452. package/src/lib/account-session.js +8 -2
  453. package/src/lib/agent-instructions.js +3 -0
  454. package/src/lib/auth.js +7 -3
  455. package/src/lib/cad/blender.js +42 -3
  456. package/src/lib/cad/d1-project-store.js +43 -0
  457. package/src/lib/cad/discovery.js +616 -0
  458. package/src/lib/cad/docker-executor.js +352 -0
  459. package/src/lib/cad/freecad.js +253 -0
  460. package/src/lib/cad/index.js +40 -0
  461. package/src/lib/cad/openscad.js +198 -0
  462. package/src/lib/cad/project-cli.d.ts +2 -0
  463. package/src/lib/cad/project-cli.js +21 -0
  464. package/src/lib/cad/project-contract.d.ts +3 -0
  465. package/src/lib/cad/project-contract.js +1 -0
  466. package/src/lib/cad/project-recipe.js +30 -0
  467. package/src/lib/cad/project-runtime.d.ts +2 -0
  468. package/src/lib/cad/project-runtime.js +53 -0
  469. package/src/lib/cad/project-store.js +25 -0
  470. package/src/lib/cad/project-workflows.js +31 -0
  471. package/src/lib/cad-docker.js +21 -2
  472. package/src/lib/cli-preferences.js +17 -2
  473. package/src/lib/core-client.js +37 -18
  474. package/src/lib/deploy/local-studio.js +6 -5
  475. package/src/lib/dockerize.js +3 -0
  476. package/src/lib/execution-approvals.js +1 -0
  477. package/src/lib/identity-scaffold.js +4 -1
  478. package/src/lib/knowledge-docker.js +9 -1
  479. package/src/lib/local-sessions.js +124 -34
  480. package/src/lib/local-status.js +35 -14
  481. package/src/lib/project-config.js +9 -0
  482. package/src/lib/provider-credentials.js +136 -32
  483. package/src/lib/scaffold/resolve-cloudflare-account.js +37 -0
  484. package/src/lib/scaffold/wizards/cms.js +2 -8
  485. package/src/lib/scaffold/wizards/worker-api.js +2 -8
  486. package/src/lib/slash-commands.js +10 -2
  487. package/src/local/migrations.js +109 -1
  488. package/src/local/runtime-store.js +31 -5
  489. package/src/local/sqlite.js +36 -1
  490. package/src/local-fs/capability.js +121 -0
  491. package/src/local-fs/freshness.js +75 -0
  492. package/src/local-fs/index.js +385 -0
  493. package/src/local-fs/paths.js +100 -0
  494. package/src/local-pty/server.js +295 -19
  495. package/src/mcp/authority.js +348 -0
  496. package/src/mcp/client-adapters.js +431 -0
  497. package/src/mcp/client.js +172 -0
  498. package/src/mcp/index.js +47 -0
  499. package/src/mcp/telemetry.js +103 -0
  500. package/src/models/ai-access-onboarding.js +112 -0
  501. package/src/models/catalog.js +329 -51
  502. package/src/models/discovery.js +34 -6
  503. package/src/models/index.js +2 -0
  504. package/src/models/inventory-core.js +190 -0
  505. package/src/models/policy.js +20 -0
  506. package/src/plugins/cloudflare.js +103 -0
  507. package/src/plugins/completeful.js +69 -0
  508. package/src/plugins/contracts.js +86 -0
  509. package/src/plugins/index.js +11 -0
  510. package/src/plugins/registry.js +207 -0
  511. package/src/plugins/resource-scope.js +45 -0
  512. package/src/plugins/runtime.js +118 -0
  513. package/src/plugins/vectorize.js +31 -0
  514. package/src/progression/engine.js +171 -0
  515. package/src/progression/index.js +1 -0
  516. package/src/providers/cloudflare-chat.js +1 -1
  517. package/src/providers/gemini-generate-content.js +2 -1
  518. package/src/providers/openai-responses.js +45 -16
  519. package/src/providers/tool-schema.js +85 -0
  520. package/src/repository/index.js +29 -0
  521. package/src/rpc/generated/errors_pb.js +961 -1
  522. package/src/sam/activity/index.js +183 -0
  523. package/src/sam/client.js +252 -0
  524. package/src/sam/decision/calibration.js +109 -0
  525. package/src/sam/decision/confidence.js +126 -0
  526. package/src/sam/decision/evaluate.js +157 -0
  527. package/src/sam/decision/evaluators/deterministic.js +341 -0
  528. package/src/sam/decision/evaluators/heuristic.js +61 -0
  529. package/src/sam/decision/evaluators/select.js +50 -0
  530. package/src/sam/decision/evaluators/semantic.js +149 -0
  531. package/src/sam/decision/hierarchical.js +61 -0
  532. package/src/sam/decision/index.js +53 -0
  533. package/src/sam/decision/policy.js +86 -0
  534. package/src/sam/decision/questions.js +120 -0
  535. package/src/sam/decision/receipt.js +148 -0
  536. package/src/sam/decision/state.js +117 -0
  537. package/src/sam/decision/types.js +22 -0
  538. package/src/sam/decision/validate.js +200 -0
  539. package/src/sam/define.js +51 -0
  540. package/src/sam/index.js +65 -0
  541. package/src/sam/operations/brand-scan.js +62 -0
  542. package/src/sam/operations/cad-blender-inspect.js +36 -0
  543. package/src/sam/operations/codebaseindex-ingest.js +49 -0
  544. package/src/sam/operations/decision-evaluate.js +59 -0
  545. package/src/sam/operations/planning-astar.js +77 -0
  546. package/src/sam/operations/planning-goap.js +60 -0
  547. package/src/sam/operations/repository-inspect.js +72 -0
  548. package/src/sam/operations/security-scan.js +33 -0
  549. package/src/sam/operations/terminal-exec.js +29 -0
  550. package/src/sam/planning/astar.js +311 -0
  551. package/src/sam/planning/goap.js +177 -0
  552. package/src/sam/planning/index.js +21 -0
  553. package/src/sam/planning/state.js +84 -0
  554. package/src/sam/registry.js +48 -0
  555. package/src/sam/result.js +77 -0
  556. package/src/sam/seed.js +44 -0
  557. package/src/sam/types.js +91 -0
  558. package/src/security/local-vault.js +415 -0
  559. package/src/security/process.js +20 -4
  560. package/src/skills/catalog.js +64 -0
  561. package/src/skills/content-resolver.js +124 -0
  562. package/src/skills/hosted-store.js +37 -0
  563. package/src/skills/index.js +29 -64
  564. package/src/skills/interaction.js +102 -0
  565. package/src/skills/local-store.js +228 -0
  566. package/src/skills/manifest.js +104 -0
  567. package/src/skills/metrics.js +31 -0
  568. package/src/skills/registry.js +184 -0
  569. package/src/skills/runtime.js +287 -0
  570. package/src/skills/slash.js +44 -0
  571. package/src/status/actions.js +192 -0
  572. package/src/tools/hydrate.js +5 -1
  573. package/src/tools/index.js +7 -0
  574. package/src/tools/redact.js +64 -0
  575. package/src/tools/registry.js +83 -0
  576. package/src/tools/runtime.js +257 -0
  577. package/src/tools/search.js +21 -8
  578. package/src/ui/ansi.js +117 -3
  579. package/src/ui/cli/activity.js +76 -7
  580. package/src/ui/cli/footer.js +110 -9
  581. package/src/ui/cli/help.js +96 -96
  582. package/src/ui/wireframes.js +166 -0
  583. package/test/account-session.test.mjs +28 -0
  584. package/test/apps-scaffold-contract.test.mjs +16 -1
  585. package/test/capabilities.test.mjs +1 -1
  586. package/test/cli/api-key-env-whoami.test.mjs +129 -0
  587. package/test/cli/codebaseindex-plan-ux.test.mjs +37 -0
  588. package/test/cli/eval-live.test.mjs +219 -0
  589. package/test/cli/go.test.mjs +128 -0
  590. package/test/cli/local-vault-and-provider-setup.test.mjs +268 -0
  591. package/test/cli/mcp-client.test.mjs +245 -0
  592. package/test/cli/runtime-ui.test.mjs +69 -2
  593. package/test/cli/skill-npm-and-env.test.mjs +52 -0
  594. package/test/cli/status-actions.test.mjs +88 -0
  595. package/test/cli/wireframes-go-registry.test.mjs +139 -0
  596. package/test/cloudflare-connector.test.mjs +3 -6
  597. package/test/cloudflare-runtime.test.mjs +8 -1
  598. package/test/context.test.mjs +15 -0
  599. package/test/error-diagnostics.test.mjs +9 -0
  600. package/test/fixtures/cad/courtyard-house.json +208 -0
  601. package/test/go/build-source-identity.test.mjs +31 -0
  602. package/test/go/cloudflare-probe.test.mjs +317 -0
  603. package/test/go/distribution.test.mjs +28 -0
  604. package/test/integration/ai-access-onboarding.test.mjs +47 -0
  605. package/test/integration/app-command.test.mjs +55 -0
  606. package/test/integration/cad-discovery.test.mjs +158 -0
  607. package/test/integration/cad-docker-executor.test.mjs +249 -0
  608. package/test/integration/cad-execution.test.mjs +184 -0
  609. package/test/integration/cad-project-app.test.mjs +31 -0
  610. package/test/integration/cad-project-d1.test.mjs +25 -0
  611. package/test/integration/cad-project-native.test.mjs +24 -0
  612. package/test/integration/cad-project-workflow.test.mjs +9 -0
  613. package/test/integration/cad-project.test.mjs +82 -0
  614. package/test/integration/cli-help.test.mjs +5 -1
  615. package/test/integration/cms-site-tenancy-contract.test.mjs +256 -0
  616. package/test/integration/codebaseindex-ingest.test.mjs +166 -0
  617. package/test/integration/core-client.integration.test.mjs +55 -0
  618. package/test/integration/error-runtime-rpc.test.mjs +71 -0
  619. package/test/integration/features-resolve.test.mjs +128 -0
  620. package/test/integration/icon-registry.test.mjs +67 -0
  621. package/test/integration/ingest-discover-models.test.mjs +30 -0
  622. package/test/integration/install-script.test.mjs +110 -0
  623. package/test/integration/inventory-core.test.mjs +53 -0
  624. package/test/integration/local-fs.test.mjs +113 -0
  625. package/test/integration/plugins-cloudflare.integration.test.mjs +28 -0
  626. package/test/integration/provider-env-cli.test.mjs +3 -2
  627. package/test/integration/runtime-migrations.test.mjs +6 -1
  628. package/test/integration/runtime-status.integration.test.mjs +211 -0
  629. package/test/integration/sam-activity-recovery.test.mjs +147 -0
  630. package/test/integration/sam-decision.test.mjs +584 -0
  631. package/test/integration/sam-kernel.test.mjs +99 -0
  632. package/test/integration/sam-planning-astar.test.mjs +279 -0
  633. package/test/integration/scaffold-cloudflare.test.mjs +46 -0
  634. package/test/integration/skill-runtime.test.mjs +240 -0
  635. package/test/integration/storage-architecture.test.mjs +154 -0
  636. package/test/integration/store-discovery.test.mjs +44 -0
  637. package/test/integration/studio-fs-pty-e2e.test.mjs +294 -0
  638. package/test/integration/terminal-exec.integration.test.mjs +86 -0
  639. package/test/integration/tool-runtime.test.mjs +124 -0
  640. package/test/integration/tool-schema.test.mjs +59 -0
  641. package/test/knowledge-service.test.mjs +4 -0
  642. package/test/local-sessions.test.mjs +11 -2
  643. package/test/local-studio-deploy.test.mjs +1 -1
  644. package/test/model-catalog.test.mjs +28 -1
  645. package/test/models.test.mjs +172 -11
  646. package/test/openai-responses.test.mjs +60 -0
  647. package/test/provider-credentials.test.mjs +15 -5
  648. package/test/responses-runner.test.mjs +321 -6
  649. package/test/shell.test.mjs +151 -6
  650. package/test/smoke.mjs +2 -2
  651. package/test/tools-search.test.mjs +33 -0
  652. package/test/unit/website-assets-bindings.test.mjs +60 -0
  653. package/test/whoami-resume.test.mjs +82 -3
  654. package/examples/gorilla-shell/README.md +0 -15
  655. package/src/lib/gorilla-template.js +0 -54
  656. package/templates/gorilla-shell/App.tsx +0 -639
  657. package/templates/gorilla-shell/README.md +0 -34
  658. package/templates/gorilla-shell/index.html +0 -15
  659. package/templates/gorilla-shell/main.jsx +0 -9
  660. package/templates/gorilla-shell/package.json +0 -19
  661. package/templates/gorilla-shell/vite.config.js +0 -21
@@ -0,0 +1,176 @@
1
+ import {
2
+ readGoapState,
3
+ listGoapTickets,
4
+ createGoapGoal,
5
+ switchGoapGoal,
6
+ closeGoapGoal,
7
+ renderGoapStatus,
8
+ renderGoapList,
9
+ renderGoapGoal,
10
+ renderGoapWhy,
11
+ renderGoapPlan,
12
+ } from '../../packages/agentsam-repository/src/goap.js';
13
+ import { readAccountSession } from '../lib/account-session.js';
14
+
15
+ function parseArgs(args = []) {
16
+ const flags = { _: [] };
17
+ for (let i = 0; i < args.length; i++) {
18
+ const a = args[i];
19
+ if (a === '--json') {
20
+ flags.json = true;
21
+ } else if (a.startsWith('--priority=')) {
22
+ flags.priority = a.slice('--priority='.length);
23
+ } else if (a === '--priority' || a === '-p') {
24
+ flags.priority = args[++i];
25
+ } else if (a.startsWith('--subsystem=')) {
26
+ flags.subsystem = a.slice('--subsystem='.length);
27
+ } else if (a === '--subsystem' || a === '-s') {
28
+ flags.subsystem = args[++i];
29
+ } else if (a.startsWith('--status=')) {
30
+ flags.status = a.slice('--status='.length);
31
+ } else if (a === '--status') {
32
+ flags.status = args[++i];
33
+ } else if (a.startsWith('--reason=')) {
34
+ flags.reason = a.slice('--reason='.length);
35
+ } else if (a === '--reason' || a === '-r') {
36
+ flags.reason = args[++i];
37
+ } else if (a.startsWith('--limit=')) {
38
+ flags.limit = parseInt(a.slice('--limit='.length), 10);
39
+ } else if (a === '--limit' || a === '-n') {
40
+ flags.limit = parseInt(args[++i], 10);
41
+ } else if (a.startsWith('--desc=') || a.startsWith('--description=')) {
42
+ flags.description = a.slice(a.indexOf('=') + 1);
43
+ } else if (a === '--desc' || a === '--description') {
44
+ flags.description = args[++i];
45
+ } else if (a.startsWith('--account=')) {
46
+ flags.accountId = a.slice('--account='.length);
47
+ } else if (a === '--account') {
48
+ flags.accountId = args[++i];
49
+ } else if (!a.startsWith('-')) {
50
+ flags._.push(a);
51
+ }
52
+ }
53
+ return flags;
54
+ }
55
+
56
+ /**
57
+ * Handle agentsam goap [status|goal|why|plan|list|new|switch|close] command.
58
+ */
59
+ export async function runGoap(subcommand = 'status', options = {}) {
60
+ const cwd = options.cwd || process.cwd();
61
+ const sub = String(subcommand || 'status').trim().toLowerCase();
62
+ const flags = parseArgs(options.args || []);
63
+ const jsonMode = Boolean(options.json || flags.json);
64
+ const accountId = flags.accountId || readAccountSession({ home: options.home })?.account_id || null;
65
+
66
+ if (sub === 'list' || sub === 'ls') {
67
+ const res = await listGoapTickets({ cwd, accountId, limit: flags.limit || 20 });
68
+ if (!res.ok) {
69
+ console.error(`Error listing GOAP tickets: ${res.error || 'unknown error'}`);
70
+ return;
71
+ }
72
+ if (jsonMode) {
73
+ console.log(JSON.stringify(res, null, 2));
74
+ return;
75
+ }
76
+ console.log(renderGoapList(res));
77
+ return;
78
+ }
79
+
80
+ if (sub === 'new' || sub === 'create') {
81
+ const title = flags._.join(' ').trim();
82
+ if (!title) {
83
+ console.error('Error: Ticket title is required.\nUsage: agentsam goap new "<title>" [--priority P1] [--subsystem sys]');
84
+ return;
85
+ }
86
+ const res = await createGoapGoal({
87
+ cwd,
88
+ accountId,
89
+ title,
90
+ priority: flags.priority || 'P2',
91
+ subsystem: flags.subsystem || 'agent-runtime',
92
+ description: flags.description || null,
93
+ });
94
+ if (!res.ok) {
95
+ console.error(`Error creating GOAP goal: ${res.error || 'unknown error'}`);
96
+ return;
97
+ }
98
+ if (jsonMode) {
99
+ console.log(JSON.stringify(res, null, 2));
100
+ return;
101
+ }
102
+ console.log(`Successfully created and activated GOAP goal: ${res.ticketId}`);
103
+ console.log(` Title: ${res.title}`);
104
+ console.log(` Priority: ${res.priority} [Subsystem: ${res.subsystem}]`);
105
+ console.log(` Agent Run: ${res.agentRunId}`);
106
+ return;
107
+ }
108
+
109
+ if (sub === 'switch' || sub === 'select') {
110
+ const ticketId = flags._[0]?.trim();
111
+ if (!ticketId) {
112
+ console.error('Error: Ticket ID is required.\nUsage: agentsam goap switch <ticket_id>');
113
+ return;
114
+ }
115
+ const res = await switchGoapGoal({ cwd, accountId, ticketId });
116
+ if (!res.ok) {
117
+ console.error(`Error switching GOAP goal: ${res.error || 'unknown error'}`);
118
+ return;
119
+ }
120
+ if (jsonMode) {
121
+ console.log(JSON.stringify(res, null, 2));
122
+ return;
123
+ }
124
+ console.log(`Successfully switched active GOAP goal to: ${res.ticketId}`);
125
+ return;
126
+ }
127
+
128
+ if (sub === 'close') {
129
+ const ticketId = flags._[0]?.trim() || null;
130
+ const res = await closeGoapGoal({
131
+ cwd,
132
+ accountId,
133
+ ticketId,
134
+ status: flags.status || 'shipped',
135
+ statusReason: flags.reason || null,
136
+ });
137
+ if (!res.ok) {
138
+ console.error(`Error closing GOAP goal: ${res.error || 'unknown error'}`);
139
+ return;
140
+ }
141
+ if (jsonMode) {
142
+ console.log(JSON.stringify(res, null, 2));
143
+ return;
144
+ }
145
+ console.log(`Successfully closed GOAP goal: ${res.ticketId} [Status: ${res.status}]`);
146
+ if (res.linkedCommit) console.log(` Linked Commit: ${res.linkedCommit.slice(0, 10)}`);
147
+ return;
148
+ }
149
+
150
+ const state = await readGoapState({ cwd, accountId });
151
+ if (!state.ok) {
152
+ console.error(`Error reading GOAP state: ${state.error || 'unknown error'}`);
153
+ return;
154
+ }
155
+
156
+ if (jsonMode) {
157
+ console.log(JSON.stringify(state, null, 2));
158
+ return;
159
+ }
160
+
161
+ switch (sub) {
162
+ case 'goal':
163
+ console.log(renderGoapGoal(state));
164
+ break;
165
+ case 'why':
166
+ console.log(renderGoapWhy(state));
167
+ break;
168
+ case 'plan':
169
+ console.log(renderGoapPlan(state));
170
+ break;
171
+ case 'status':
172
+ default:
173
+ console.log(renderGoapStatus(state));
174
+ break;
175
+ }
176
+ }
@@ -9,6 +9,7 @@ function parseArgs(argv) {
9
9
  projectName: '',
10
10
  brandName: '',
11
11
  logoUrl: '',
12
+ provider: 'inneranimalmedia',
12
13
  yes: false,
13
14
  cwd: process.cwd(),
14
15
  };
@@ -18,6 +19,7 @@ function parseArgs(argv) {
18
19
  else if (arg === '--name') opts.projectName = argv[++i] || '';
19
20
  else if (arg === '--brand') opts.brandName = argv[++i] || '';
20
21
  else if (arg === '--logo-url') opts.logoUrl = argv[++i] || '';
22
+ else if (arg === '--provider') opts.provider = argv[++i] || opts.provider;
21
23
  else if (arg === '--cwd') opts.cwd = argv[++i] || opts.cwd;
22
24
  }
23
25
  return opts;
@@ -26,7 +28,14 @@ function parseArgs(argv) {
26
28
  export async function runIdentityInit(argv = []) {
27
29
  const opts = parseArgs(argv);
28
30
  if (!opts.projectName) {
29
- console.error('\n Usage: agentsam identity init --name <project> [--brand "App Name"] [--logo-url /logo.svg]\n');
31
+ console.error('\n Usage: agentsam identity init --name <project> [--brand "App Name"] [--logo-url /logo.svg] [--provider inneranimalmedia|google|github|gcp|email|cloudflare]\n');
32
+ process.exit(1);
33
+ }
34
+
35
+ const { getIdentityProviderTemplate, writeFeatureSelections } = await import('../features/resolve.js');
36
+ const provider = getIdentityProviderTemplate(opts.provider);
37
+ if (!provider) {
38
+ console.error(`\n ✗ Unknown provider template: ${opts.provider}\n`);
30
39
  process.exit(1);
31
40
  }
32
41
 
@@ -41,15 +50,30 @@ export async function runIdentityInit(argv = []) {
41
50
  brandName: opts.brandName || opts.projectName,
42
51
  logoUrl: opts.logoUrl || '/brand/logo.svg',
43
52
  sdkVersion: pkg.version,
53
+ provider: provider.id,
44
54
  });
45
55
 
46
56
  await writeFileTree(targetDir, files);
47
57
 
58
+ writeFeatureSelections(targetDir, {
59
+ schema_version: 2,
60
+ features: {
61
+ auth: {
62
+ selected: true,
63
+ capabilities: ['identity.init'],
64
+ provider_template: provider.id,
65
+ selected_at: new Date().toISOString(),
66
+ },
67
+ },
68
+ });
69
+
48
70
  console.log(`
49
71
  Identity app scaffold ready
50
72
  ───────────────────────────
51
- Path: ${targetDir}
52
- Layout: app/frontend · backend/src · migrations/
73
+ Path: ${targetDir}
74
+ Provider: ${provider.id} (${provider.kind})
75
+ Schema: d1 · auth_users, auth_sessions, account_identities, … (see agentsam identity schema)
76
+ Layout: app/frontend · backend/src · migrations/
53
77
 
54
78
  Next:
55
79
  cd ${opts.projectName}
@@ -0,0 +1,195 @@
1
+ import {
2
+ formatResourcesSummary,
3
+ getIdentityProviderTemplate,
4
+ listSchemaProfiles,
5
+ loadIdentityProviders,
6
+ loadIdentityResources,
7
+ loadSchemaProfile,
8
+ resolveAuthFeature,
9
+ writeFeaturesResolved,
10
+ } from '../features/resolve.js';
11
+
12
+ function parseArgs(argv = []) {
13
+ const opts = {
14
+ cwd: process.cwd(),
15
+ json: false,
16
+ provider: '',
17
+ schemaProfile: '',
18
+ positionals: [],
19
+ };
20
+ for (let i = 0; i < argv.length; i += 1) {
21
+ const arg = argv[i];
22
+ if (arg === '--json') opts.json = true;
23
+ else if (arg === '--cwd') opts.cwd = argv[++i] || opts.cwd;
24
+ else if (arg === '--provider') opts.provider = argv[++i] || '';
25
+ else if (arg === '--schema' || arg === '--schema-profile') opts.schemaProfile = argv[++i] || '';
26
+ else if (!arg.startsWith('-')) opts.positionals.push(arg);
27
+ }
28
+ return opts;
29
+ }
30
+
31
+ function writeJson(value) {
32
+ process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
33
+ }
34
+
35
+ export async function runIdentityProviders(argv = []) {
36
+ const opts = parseArgs(argv);
37
+ const providers = loadIdentityProviders();
38
+ if (opts.json) {
39
+ writeJson({ ok: true, providers });
40
+ return providers;
41
+ }
42
+ console.log('\nIdentity provider templates\n');
43
+ for (const row of providers) {
44
+ const status = row.status ? ` · ${row.status}` : '';
45
+ console.log(` ${row.id.padEnd(18)} ${String(row.kind || '').padEnd(10)} ${row.title || ''}${status}`);
46
+ }
47
+ console.log('');
48
+ return providers;
49
+ }
50
+
51
+ export async function runIdentityPlan(argv = []) {
52
+ const opts = parseArgs(argv);
53
+ const providerId = opts.provider || opts.positionals[0] || 'inneranimalmedia';
54
+ const provider = getIdentityProviderTemplate(providerId);
55
+ if (!provider) throw new Error(`unknown_provider_template:${providerId}`);
56
+
57
+ const selection = {
58
+ selected: true,
59
+ capabilities: ['identity.init'],
60
+ provider_template: provider.id,
61
+ };
62
+ const resolved = resolveAuthFeature(selection);
63
+ const resources = resolved.resources;
64
+ const tableNames = (resources.tables || []).map((t) => t.name).join(', ');
65
+ const migrations = (resources.migration_sources || []).join('\n ');
66
+ const plan = {
67
+ ok: true,
68
+ command: 'identity.plan',
69
+ provider: resolved.provider,
70
+ resources,
71
+ next: [
72
+ 'agentsam add auth',
73
+ `agentsam identity init --provider ${provider.id}`,
74
+ 'agentsam identity schema',
75
+ ],
76
+ };
77
+
78
+ if (opts.json) {
79
+ writeJson(plan);
80
+ return plan;
81
+ }
82
+
83
+ console.log(`
84
+ Identity plan
85
+ ─────────────
86
+ Provider: ${resolved.provider.id} (${resolved.provider.kind}) · ${resolved.provider.status || ''}
87
+ Engine: ${resources.engine}
88
+ Migrations: ${migrations}
89
+ Tables: ${tableNames}
90
+
91
+ Next:
92
+ agentsam add auth
93
+ agentsam identity init --provider ${provider.id}
94
+ agentsam identity schema
95
+ `);
96
+ return plan;
97
+ }
98
+
99
+ export async function runIdentitySchema(argv = []) {
100
+ const opts = parseArgs(argv);
101
+ const id = opts.schemaProfile || opts.positionals[0] || '';
102
+
103
+ if (!id) {
104
+ const resources = loadIdentityResources();
105
+ if (opts.json) {
106
+ writeJson({ ok: true, resources, also: listSchemaProfiles().filter((r) => r.id === 'better-auth-postgres') });
107
+ return resources;
108
+ }
109
+ if (!resources) {
110
+ console.error('\n ✗ identity resources.json missing\n');
111
+ process.exit(1);
112
+ }
113
+ console.log(`
114
+ Identity resources (packages/identity · oauth-login-portal)
115
+ ──────────────────────────────────────────────────────────
116
+ Engine: ${resources.engine}
117
+ Migrations:`);
118
+ for (const src of resources.migration_sources || []) {
119
+ console.log(` ${src}`);
120
+ }
121
+ console.log('Tables:');
122
+ for (const table of resources.tables || []) {
123
+ const owner = table.owner_column ? ` · owner ${table.owner_column}` : '';
124
+ const sensitive = table.sensitive ? ' · sensitive' : '';
125
+ console.log(` ${table.name.padEnd(24)} ${table.purpose || ''}${owner}${sensitive}`);
126
+ }
127
+ console.log('');
128
+ return resources;
129
+ }
130
+
131
+ const profile = loadSchemaProfile(id);
132
+ if (!profile) throw new Error(`unknown_resources:${id}`);
133
+ if (opts.json) {
134
+ writeJson(profile);
135
+ return profile;
136
+ }
137
+
138
+ if (profile.tables) {
139
+ console.log(`
140
+ Resources: ${profile.feature || profile.id || id}
141
+ Engine: ${profile.engine}
142
+ `);
143
+ for (const src of profile.migration_sources || (profile.source ? [profile.source] : [])) {
144
+ console.log(` migration ${src}`);
145
+ }
146
+ console.log('');
147
+ for (const table of profile.tables || []) {
148
+ const owner = table.owner_column ? ` · owner ${table.owner_column}` : '';
149
+ const sensitive = table.sensitive ? ' · sensitive' : '';
150
+ console.log(` ${String(table.name || '').padEnd(24)} ${table.purpose || ''}${owner}${sensitive}`);
151
+ }
152
+ console.log('');
153
+ } else {
154
+ console.log(`
155
+ ${profile.id || id}
156
+ Engine: ${profile.engine}
157
+ Source: ${profile.source || '(n/a)'}
158
+ ${profile.note ? `Note: ${profile.note}\n` : ''}`);
159
+ }
160
+ return profile;
161
+ }
162
+
163
+ export async function runIdentityResolve(argv = []) {
164
+ const opts = parseArgs(argv);
165
+ const { path: outPath, snapshot } = writeFeaturesResolved(opts.cwd);
166
+ if (opts.json) {
167
+ writeJson({ ok: true, path: outPath, snapshot });
168
+ return snapshot;
169
+ }
170
+ console.log(`\nResolved features → ${outPath}\n`);
171
+ for (const [id, feature] of Object.entries(snapshot.features || {})) {
172
+ const provider = feature.provider_template || feature.provider?.id || '—';
173
+ if (feature.resources) {
174
+ console.log(` ${id.padEnd(16)} provider=${provider} ${formatResourcesSummary(feature.resources)}`);
175
+ } else {
176
+ console.log(` ${id.padEnd(16)} provider=${provider}`);
177
+ }
178
+ }
179
+ console.log('');
180
+ return snapshot;
181
+ }
182
+
183
+ export function printIdentityHelp() {
184
+ console.error(`
185
+ Usage:
186
+ agentsam identity preview [--open] [--port 8791]
187
+ agentsam identity init --name <project> [--brand "Name"] [--provider inneranimalmedia]
188
+ agentsam identity providers [--json]
189
+ agentsam identity plan --provider <id> [--json]
190
+ agentsam identity schema [--json]
191
+ agentsam identity resolve [--cwd PATH] [--json]
192
+ `);
193
+ }
194
+
195
+ export { resolveAuthFeature };
@@ -0,0 +1,115 @@
1
+ /**
2
+ * Present AgentSamInteraction via Clack (or plain write fallback).
3
+ * Hosts (shell, Local Studio, Tauri) can swap the prompt impls.
4
+ */
5
+
6
+ import { confirm, isCancel, select, text } from '@clack/prompts';
7
+
8
+ /**
9
+ * @param {import('../skills/interaction.js').AgentSamInteraction} interaction
10
+ * @param {{
11
+ * write?: (s: string) => void,
12
+ * interactive?: boolean,
13
+ * selectImpl?: typeof select,
14
+ * confirmImpl?: typeof confirm,
15
+ * textImpl?: typeof text,
16
+ * }} [options]
17
+ * @returns {Promise<{ action: string|null, value: string|null, cancelled: boolean }>}
18
+ */
19
+ export async function presentAgentSamInteraction(interaction, options = {}) {
20
+ const write = options.write || ((s) => process.stdout.write(s));
21
+ const interactive =
22
+ options.interactive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
23
+ const prompt = interaction?.prompt;
24
+
25
+ if (!prompt?.message) {
26
+ return { action: null, value: null, cancelled: false };
27
+ }
28
+
29
+ for (const line of String(prompt.message).split('\n')) {
30
+ write(` ${line}\n`);
31
+ }
32
+
33
+ if (!interactive) {
34
+ return { action: null, value: null, cancelled: false };
35
+ }
36
+
37
+ const status = interaction.status;
38
+
39
+ if (status === 'needs_input' && prompt.kind === 'select' && Array.isArray(prompt.options) && prompt.options.length) {
40
+ const answer = await (options.selectImpl || select)({
41
+ message: prompt.title || 'Choose',
42
+ options: prompt.options.map((opt) => ({
43
+ value: opt.value,
44
+ label: opt.label,
45
+ hint: opt.description,
46
+ })),
47
+ });
48
+ if (isCancel(answer)) return { action: null, value: null, cancelled: true };
49
+ return { action: String(answer), value: String(answer), cancelled: false };
50
+ }
51
+
52
+ if (status === 'needs_input' && prompt.kind === 'text') {
53
+ const answer = await (options.textImpl || text)({
54
+ message: prompt.title || prompt.message,
55
+ });
56
+ if (isCancel(answer)) return { action: null, value: null, cancelled: true };
57
+ return { action: 'text', value: String(answer), cancelled: false };
58
+ }
59
+
60
+ if (status === 'needs_approval' || (status === 'needs_input' && prompt.kind === 'confirm')) {
61
+ const answer = await (options.confirmImpl || confirm)({
62
+ message: prompt.title || prompt.message,
63
+ });
64
+ if (isCancel(answer)) return { action: null, value: null, cancelled: true };
65
+ return { action: answer ? 'confirm' : 'cancel', value: answer ? 'yes' : 'no', cancelled: false };
66
+ }
67
+
68
+ if (
69
+ (status === 'blocked' || status === 'needs_input') &&
70
+ Array.isArray(prompt.actions) &&
71
+ prompt.actions.length
72
+ ) {
73
+ const answer = await (options.selectImpl || select)({
74
+ message: prompt.title || 'Next',
75
+ options: prompt.actions.map((a) => ({ value: a.id, label: a.label })),
76
+ });
77
+ if (isCancel(answer)) return { action: null, value: null, cancelled: true };
78
+ return { action: String(answer), value: String(answer), cancelled: false };
79
+ }
80
+
81
+ return { action: null, value: null, cancelled: false };
82
+ }
83
+
84
+ /**
85
+ * Map shell skill interaction choices to follow-up CLI actions.
86
+ */
87
+ export async function handleSkillInteractionChoice(choice, state = {}) {
88
+ const write = state.write || ((s) => process.stdout.write(s));
89
+ const { runSkill } = await import('./skill.js');
90
+ if (!choice || choice.cancelled) return null;
91
+ if (choice.action === 'create' || choice.value === 'create') {
92
+ const id = 'my-first-skill';
93
+ write(`\n Running: agentsam skill create ${id}\n\n`);
94
+ return runSkill(['create', id], { write, home: state.home, env: state.env });
95
+ }
96
+ if (typeof choice.value === 'string' && choice.value.startsWith('create:')) {
97
+ const id = choice.value.slice('create:'.length) || 'my-first-skill';
98
+ write(`\n Running: agentsam skill create ${id}\n\n`);
99
+ return runSkill(['create', id], { write, home: state.home, env: state.env });
100
+ }
101
+ if (typeof choice.action === 'string' && choice.action.startsWith('create:')) {
102
+ const id = choice.action.slice('create:'.length) || 'my-first-skill';
103
+ write(`\n Running: agentsam skill create ${id}\n\n`);
104
+ return runSkill(['create', id], { write, home: state.home, env: state.env });
105
+ }
106
+ if (choice.action === 'install' || choice.value === 'install') {
107
+ write('\n Next: agentsam skill install ./path-to-skill (or @scope/pkg)\n\n');
108
+ return null;
109
+ }
110
+ if (choice.action === 'list' || choice.value === 'list') {
111
+ return runSkill(['list'], { write, home: state.home, env: state.env });
112
+ }
113
+ // create with prefilled id handled above
114
+ return null;
115
+ }
@@ -11,7 +11,7 @@ import { CONFIG_PATH, repositoryRoot, initRepository, readConfig, defaultConfig,
11
11
  import { openSqliteStore } from '../knowledge/stores/sqlite.js';
12
12
  import { openPostgresStore } from '../knowledge/stores/postgres.js';
13
13
  import { planIndex, runIndex, retrieve } from '../knowledge/engine.js';
14
- import { createGeminiEmbedder } from '../knowledge/providers/gemini.js';
14
+ import { createProviderRegistry } from '../../packages/agentsam-knowledge/src/providers/index.js';
15
15
  import { compareObservations } from '../knowledge/evolution.js';
16
16
  import { ensureProjectManifest, getProjectName, getRepositoryId, portableRepositoryIdFromGit, tryReadProjectConfig } from '../lib/project-config.js';
17
17
  import { ensureProjectRules } from '../lib/project-rules.js';
@@ -24,7 +24,18 @@ const localPath = root => path.join(root, '.agentsam', 'knowledge', 'index.sqlit
24
24
  async function openStore(root, config, readOnly = false) {
25
25
  return config.storage.driver === 'sqlite' ? openSqliteStore(localPath(root), { readOnly }) : openPostgresStore(process.env[config.storage.connection_env]);
26
26
  }
27
- function provider() { return createGeminiEmbedder({ apiKey: process.env.GEMINI_API_KEY }); }
27
+ function provider(profile) {
28
+ if (profile?.provider === 'none') throw new Error('Embedding is disabled for this profile. Configure an explicit provider with `agentsam autorag configure --provider … --semantic`.');
29
+ const adapter = createProviderRegistry().get(profile?.provider);
30
+ return {
31
+ validate: input => adapter.validate(input),
32
+ async embed(text, input, context) {
33
+ return context?.kind === 'query'
34
+ ? adapter.embedQuery(text, input, context)
35
+ : (await adapter.embedDocuments([text], input, context))[0];
36
+ },
37
+ };
38
+ }
28
39
  function resolveKnowledgeConfig(root) {
29
40
  const filename = path.join(root, CONFIG_PATH);
30
41
  if (fs.existsSync(filename)) return readConfig(root);
@@ -51,7 +62,14 @@ export async function runRepositoryInit(argv) {
51
62
  if (projectRepositoryId && existingKnowledge.repository_id !== projectRepositoryId) {
52
63
  throw new Error(`repository_identity_mismatch: project=${projectRepositoryId} knowledge=${existingKnowledge.repository_id}`);
53
64
  }
54
- throw new Error(`${CONFIG_PATH} already exists; edit it to change scope/profile. Existing configuration was preserved.`);
65
+ show({
66
+ root,
67
+ config: CONFIG_PATH,
68
+ storage: existingKnowledge.storage?.driver || 'sqlite',
69
+ status: 'already_initialized',
70
+ note: `${CONFIG_PATH} already exists; existing configuration was preserved.`,
71
+ });
72
+ return;
55
73
  }
56
74
  let include = opts.include, exclude = opts.exclude, target = opts.target, dimensions = opts.dimensions;
57
75
  if (!opts.yes) {
@@ -91,7 +109,7 @@ export async function runKnowledge(argv) {
91
109
  else if (command === 'run') {
92
110
  // Lazy adapter creation means a fully cached --embed run needs no API key.
93
111
  let adapter;
94
- const embedder = { embed: (...args) => (adapter ??= provider()).embed(...args) };
112
+ const embedder = { validate: (...args) => (adapter ??= provider(config.embedding)).validate(...args), embed: (...args) => (adapter ??= provider(config.embedding)).embed(...args) };
95
113
  show(await runIndex({ root, config, store, embed: opts.embed, embedder, maxInputs: Number(opts['max-inputs'] ?? 100), maxCharacters: Number(opts['max-characters'] ?? 200000) }));
96
114
  } else if (command === 'history') show((await store?.history(scopeKey(config)) || []).map(g => ({ id: g.id, created_at: g.created_at, git: g.git, ...g.receipt })));
97
115
  else {
@@ -102,11 +120,52 @@ export async function runKnowledge(argv) {
102
120
  } finally { await store?.close(); }
103
121
  }
104
122
 
123
+ export async function runKnowledgeSearch({
124
+ cwd = process.cwd(),
125
+ query = '',
126
+ text = '',
127
+ semantic = false,
128
+ topK = 8,
129
+ tokenBudget = 6000,
130
+ generationId = null,
131
+ } = {}) {
132
+ const q = String(query || text || '').trim();
133
+ const root = repositoryRoot(cwd);
134
+ const sqliteFile = localPath(root);
135
+ const config = resolveKnowledgeConfig(root);
136
+ if (config.storage.driver === 'sqlite' && !fs.existsSync(sqliteFile)) {
137
+ return {
138
+ queryId: 'none',
139
+ query: { text: q, top_k: topK, token_budget: tokenBudget },
140
+ hits: [],
141
+ diagnostics: {
142
+ indexed: false,
143
+ message: 'Knowledge store not initialized. Run `agentsam index run` to build repository index.',
144
+ },
145
+ };
146
+ }
147
+ const store = await openStore(root, config, true);
148
+ try {
149
+ return await retrieve({
150
+ store,
151
+ config,
152
+ text: q,
153
+ semantic: Boolean(semantic),
154
+ embedder: semantic ? provider(config.embedding) : null,
155
+ topK: Number(topK || 8),
156
+ tokenBudget: Number(tokenBudget || 6000),
157
+ generationId,
158
+ });
159
+ } finally {
160
+ await store?.close();
161
+ }
162
+ }
163
+
105
164
  export async function runSearch(argv) {
106
165
  const { values: opts, positionals } = flags(argv, { semantic: { type: 'boolean' }, 'top-k': { type: 'string' }, 'token-budget': { type: 'string' }, generation: { type: 'string' } });
107
166
  if (opts.help) { console.log('agentsam search "query" [--cwd PATH] [--semantic] [--top-k 8] [--token-budget 6000] [--generation ID]'); return; }
108
167
  const root = repositoryRoot(opts.cwd), config = resolveKnowledgeConfig(root), store = await openStore(root, config, true);
109
- try { show(await retrieve({ store, config, text: positionals.join(' '), semantic: opts.semantic, embedder: opts.semantic ? provider() : null, topK: Number(opts['top-k'] || 8), tokenBudget: Number(opts['token-budget'] || 6000), generationId: opts.generation })); }
168
+ try { show(await retrieve({ store, config, text: positionals.join(' '), semantic: opts.semantic, embedder: opts.semantic ? provider(config.embedding) : null, topK: Number(opts['top-k'] || 8), tokenBudget: Number(opts['token-budget'] || 6000), generationId: opts.generation })); }
110
169
  finally { await store?.close(); }
111
170
  }
112
171