@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
@@ -1,10 +1,12 @@
1
1
  import assert from 'node:assert/strict';
2
2
  import test from 'node:test';
3
- import { createInlineActivity } from '../../src/ui/cli/activity.js';
4
- import { renderCliFooter } from '../../src/ui/cli/footer.js';
3
+ import { createInlineActivity, INTERRUPT_HINT, renderShimmer } from '../../src/ui/cli/activity.js';
4
+ import { renderCliFooter, renderDiffPreview } from '../../src/ui/cli/footer.js';
5
5
  import { createCliRuntimePresenter, normalizeRuntimeEventEnvelope, RUNTIME_EVENT_ENVELOPE_SCHEMA } from '../../src/ui/cli/runtime-events.js';
6
6
  import { renderWaitingInput } from '../../src/ui/cli/waiting.js';
7
7
 
8
+ const stripAnsi = (text) => String(text || '').replace(/\x1B\[[0-9;]*[a-zA-Z]/g, '');
9
+
8
10
  test('CLI footer reports unknown context honestly', () => {
9
11
  const text = renderCliFooter({
10
12
  model: 'claude-test',
@@ -19,6 +21,71 @@ test('CLI footer reports unknown context honestly', () => {
19
21
  assert.match(text, /cache 2k/);
20
22
  });
21
23
 
24
+ test('CLI footer shows project identity, branch, and shortcut hints', () => {
25
+ const text = stripAnsi(renderCliFooter({
26
+ project: 'agentsam-sdk',
27
+ cwd: '/Users/sam/agentsam-sdk',
28
+ branch: 'feat/cli-interactive-presence',
29
+ model: 'claude-test',
30
+ }));
31
+ assert.match(text, /agentsam-sdk/);
32
+ assert.match(text, /feat\/cli-interactive-presence/);
33
+ assert.match(text, /ctrl-c to cancel/);
34
+ assert.match(text, /\/ commands/);
35
+ });
36
+
37
+ test('diff preview colors hunks and keeps NO_COLOR output readable', () => {
38
+ const diff = [
39
+ 'diff --git a/src/ui/cli/footer.js b/src/ui/cli/footer.js',
40
+ '--- a/src/ui/cli/footer.js',
41
+ '+++ b/src/ui/cli/footer.js',
42
+ '@@ -1,3 +1,4 @@',
43
+ ' import pc from \'picocolors\';',
44
+ '-const old = 1;',
45
+ '+const next = 2;',
46
+ ' keep',
47
+ ].join('\n');
48
+ const colored = renderDiffPreview(diff, { color: true });
49
+ assert.match(colored, /\x1b\[/);
50
+ assert.match(stripAnsi(colored), /\+const next = 2;/);
51
+ const plain = renderDiffPreview(diff, { color: false });
52
+ assert.doesNotMatch(plain, /\x1b\[/);
53
+ assert.match(plain, /-const old = 1;/);
54
+ assert.equal(stripAnsi(renderDiffPreview('', { color: false })).trim(), 'no changes');
55
+ });
56
+
57
+ test('inline activity shows elapsed time and ctrl-c cancel hint', () => {
58
+ let output = '';
59
+ let now = 0;
60
+ let tick = null;
61
+ const activity = createInlineActivity({
62
+ write: (value) => { output += value; },
63
+ interactive: true,
64
+ env: { NO_COLOR: '1' },
65
+ now: () => now,
66
+ setInterval: (fn) => { tick = fn; return 1; },
67
+ clearInterval() {},
68
+ });
69
+ activity.start('Working');
70
+ now = 1500;
71
+ tick();
72
+ const clean = stripAnsi(output);
73
+ assert.match(clean, /Working/);
74
+ assert.match(clean, /1\.5s/);
75
+ assert.match(clean, new RegExp(INTERRUPT_HINT.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')));
76
+ activity.clear();
77
+ });
78
+
79
+ test('shimmer uses color when allowed and stays plain under NO_COLOR', () => {
80
+ const colored = renderShimmer('Working', 4, { env: { COLORTERM: 'truecolor' } });
81
+ assert.match(colored, /\x1b\[38;2;/);
82
+ assert.match(stripAnsi(colored), /Working/);
83
+ const fallback = renderShimmer('Working', 4, { env: { TERM: 'xterm-256color' } });
84
+ assert.match(fallback, /\x1b\[38;5;/);
85
+ const plain = renderShimmer('Working', 4, { env: { NO_COLOR: '1', COLORTERM: 'truecolor' } });
86
+ assert.equal(plain, 'Working');
87
+ });
88
+
22
89
  test('runtime event envelope is the single standalone/platform producer contract', () => {
23
90
  const envelope = normalizeRuntimeEventEnvelope({
24
91
  schema_version: 1,
@@ -0,0 +1,52 @@
1
+ import assert from 'node:assert/strict';
2
+ import fs from 'node:fs';
3
+ import os from 'node:os';
4
+ import path from 'node:path';
5
+ import { spawnSync } from 'node:child_process';
6
+ import test from 'node:test';
7
+ import { resolveNpmSkillPackage } from '../../src/commands/skill.js';
8
+ import { installSkillFromPath } from '../../src/skills/index.js';
9
+ import { runEnv } from '../../src/commands/env.js';
10
+
11
+ function tmpHome() {
12
+ return fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-finish-'));
13
+ }
14
+
15
+ test('resolveNpmSkillPackage extracts agentsam.skill.json via npm pack', (t) => {
16
+ // Build a tiny local package and pack it by path (no registry).
17
+ const pkgRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-npm-skill-'));
18
+ fs.writeFileSync(
19
+ path.join(pkgRoot, 'package.json'),
20
+ JSON.stringify({ name: 'tmp-agentsam-skill-fixture', version: '0.0.0', private: true }),
21
+ );
22
+ fs.writeFileSync(
23
+ path.join(pkgRoot, 'agentsam.skill.json'),
24
+ JSON.stringify({
25
+ schema: 'agentsam.skill.v1',
26
+ id: 'npm-fixture',
27
+ name: 'NPM Fixture',
28
+ slash: { suggested: '/npm-fixture' },
29
+ instructions: { source: 'inline', inline: '# npm fixture' },
30
+ execution: { mode: 'turn' },
31
+ }),
32
+ );
33
+ const resolved = resolveNpmSkillPackage(pkgRoot, { spawnSyncImpl: spawnSync });
34
+ assert.ok(fs.existsSync(path.join(resolved, 'agentsam.skill.json')));
35
+
36
+ const home = tmpHome();
37
+ const installed = installSkillFromPath(resolved, { home });
38
+ assert.equal(installed.id, 'npm-fixture');
39
+ assert.equal(installed.trigger, '/npm-fixture');
40
+ });
41
+
42
+ test('env boot-line prints source load-agent-env command', async () => {
43
+ const home = tmpHome();
44
+ const lines = [];
45
+ const result = await runEnv(['boot-line', 'cursor', 'inneranimalmedia'], {
46
+ home,
47
+ write: (t) => lines.push(t),
48
+ });
49
+ assert.equal(result.command, 'source ~/.agentsam/load-agent-env.sh');
50
+ assert.ok(lines.join('').includes('load-agent-env.sh'));
51
+ assert.ok(lines.join('').includes('agentsam env shell'));
52
+ });
@@ -0,0 +1,88 @@
1
+ import assert from 'node:assert/strict';
2
+ import test from 'node:test';
3
+ import {
4
+ buildStatusActionPlan,
5
+ formatStatusNextSteps,
6
+ } from '../../src/status/actions.js';
7
+ import { renderLocalStatus } from '../../src/ui/ansi.js';
8
+
9
+ test('healthy Cloudflare deployment wins over localhost', () => {
10
+ const runtime = {
11
+ ready: true,
12
+ checks: {
13
+ account: true,
14
+ models: true,
15
+ terminal: true,
16
+ cloudflare: true,
17
+ },
18
+ local: {
19
+ deployTarget: 'cloudflare',
20
+ api: {
21
+ online: false,
22
+ url: 'http://127.0.0.1:8787/api/health',
23
+ },
24
+ db: {
25
+ ready: true,
26
+ exists: true,
27
+ },
28
+ },
29
+ cloudflare: {
30
+ configured: true,
31
+ worker_name: 'agentsam-sdk',
32
+ health: {
33
+ ok: true,
34
+ status: 200,
35
+ url: 'https://agentsam.inneranimalmedia.com/health',
36
+ },
37
+ },
38
+ };
39
+
40
+ const plan = buildStatusActionPlan(runtime);
41
+ const text = formatStatusNextSteps(plan);
42
+
43
+ assert.match(plan.headline, /Live project healthy/);
44
+ assert.ok(plan.actions.some((action) =>
45
+ action.command === 'https://agentsam.inneranimalmedia.com'
46
+ ));
47
+ assert.ok(plan.actions.some((action) =>
48
+ action.command === 'agentsam cloudflare status'
49
+ ));
50
+ assert.doesNotMatch(text, /npm run dev/);
51
+ assert.match(text, /open https:\/\/agentsam\.inneranimalmedia\.com/);
52
+ });
53
+
54
+ test('compact local card prefers live deployment', () => {
55
+ const text = renderLocalStatus({
56
+ configured: true,
57
+ project: 'agentsam-sdk',
58
+ lane: 'custom',
59
+ agent: 'default',
60
+ git: {
61
+ branch: 'main',
62
+ revision: 'abcdef123456',
63
+ dirty: false,
64
+ },
65
+ db: {
66
+ ready: true,
67
+ tables: [],
68
+ },
69
+ api: {
70
+ online: false,
71
+ url: 'http://127.0.0.1:8787/api/health',
72
+ },
73
+ pty: {
74
+ online: true,
75
+ url: 'http://127.0.0.1:3099/health',
76
+ },
77
+ deployTarget: 'cloudflare',
78
+ live: {
79
+ online: true,
80
+ url: 'https://agentsam.inneranimalmedia.com/health',
81
+ },
82
+ });
83
+
84
+ assert.match(text, /● live/);
85
+ assert.match(text, /open https:\/\/agentsam\.inneranimalmedia\.com/);
86
+ assert.match(text, /agentsam cloudflare status/);
87
+ assert.doesNotMatch(text, /npm run dev/);
88
+ });
@@ -0,0 +1,139 @@
1
+ import assert from 'node:assert/strict';
2
+ import test from 'node:test';
3
+ import { renderArchitectureExplorer, renderOperationInspector, drawBox } from '../../src/ui/wireframes.js';
4
+ import { applyInnerAnimalMediaOfficialGoProductRegistry, buildGoProductRegistrySql } from '../../src/go/official-registry.js';
5
+
6
+ test('architecture explorer is boxed reasoning scenery', () => {
7
+ const view = renderArchitectureExplorer({
8
+ repo: 'agentsam-sdk',
9
+ focus: { package: 'protocol', owns: 'wire contracts', runtime: 'none', imported_by: 'client', files: '.proto' },
10
+ });
11
+ assert.match(view, /┌/);
12
+ assert.match(view, /package: protocol/);
13
+ assert.match(view, /DEPENDENCY MAP/);
14
+ assert.match(view, /\[contracts\]/);
15
+ });
16
+
17
+ test('operation inspector shows intent timeline', () => {
18
+ const view = renderOperationInspector({
19
+ operation: 'model.export',
20
+ op_id: 'op_01H',
21
+ active_index: 2,
22
+ step: { name: 'converter', artifact: 'GLB' },
23
+ receipt: { 'input document revision': 84, 'output artifact hash': 'abc' },
24
+ });
25
+ assert.match(view, /model\.export/);
26
+ assert.match(view, /intent/);
27
+ assert.match(view, /converter/);
28
+ assert.match(view, /GLB/);
29
+ assert.match(view, /input document revision/);
30
+ });
31
+
32
+ test('drawBox pads visible ANSI width', () => {
33
+ const box = drawBox(['hello'], { width: 20, title: 't' });
34
+ assert.match(box, /┌/);
35
+ assert.match(box, /└/);
36
+ });
37
+
38
+ test('buildGoProductRegistrySql upserts product + relationships without inventing tables', () => {
39
+ const sql = buildGoProductRegistrySql({
40
+ product: 'agentsam-go-worker',
41
+ status: 'deployed',
42
+ url: 'https://agentsam-go-worker.example.workers.dev',
43
+ commit: 'abc123',
44
+ health: 'healthy',
45
+ });
46
+ assert.match(sql, /INSERT INTO agentsam_products/);
47
+ assert.match(sql, /ON CONFLICT\(slug\) DO UPDATE/);
48
+ assert.match(sql, /INSERT INTO asset_relationships/);
49
+ assert.match(sql, /sourced_from/);
50
+ assert.match(sql, /runs_on/);
51
+ assert.match(sql, /deployed_as/);
52
+ assert.doesNotMatch(sql, /CREATE TABLE/);
53
+ assert.doesNotMatch(sql, /account_id/);
54
+ });
55
+
56
+
57
+ test('InnerAnimalMedia remote registry requires the explicit official-release guard', () => {
58
+ const preferred = process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE;
59
+ const legacy = process.env.AGENTSAM_IAM_OFFICIAL_RELEASE;
60
+
61
+ delete process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE;
62
+ delete process.env.AGENTSAM_IAM_OFFICIAL_RELEASE;
63
+
64
+ try {
65
+ assert.throws(
66
+ () => applyInnerAnimalMediaOfficialGoProductRegistry({
67
+ productRoot: '/tmp/agentsam-test-state',
68
+ officialRelease: true,
69
+ skipRemote: true,
70
+ }),
71
+ /inneranimalmedia_registry_official_release_required/,
72
+ );
73
+ } finally {
74
+ if (preferred == null) {
75
+ delete process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE;
76
+ } else {
77
+ process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE = preferred;
78
+ }
79
+
80
+ if (legacy == null) {
81
+ delete process.env.AGENTSAM_IAM_OFFICIAL_RELEASE;
82
+ } else {
83
+ process.env.AGENTSAM_IAM_OFFICIAL_RELEASE = legacy;
84
+ }
85
+ }
86
+ });
87
+
88
+ test('InnerAnimalMedia official registry normalizes deployed lifecycle status to D1 production', () => {
89
+ const prior = process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE;
90
+ process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE = '1';
91
+ try {
92
+ const result = applyInnerAnimalMediaOfficialGoProductRegistry({
93
+ productRoot: null,
94
+ officialRelease: true,
95
+ status: 'deployed',
96
+ dryRun: true,
97
+ skipRemote: true,
98
+ });
99
+ assert.match(result.sql, /'production'/);
100
+ assert.doesNotMatch(result.sql, /'deployed',\n 'AgentSam Go runtime/);
101
+ } finally {
102
+ if (prior == null) delete process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE;
103
+ else process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE = prior;
104
+ }
105
+ });
106
+
107
+
108
+ test('legacy AGENTSAM_IAM_OFFICIAL_RELEASE guard remains backward compatible', () => {
109
+ const preferred = process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE;
110
+ const legacy = process.env.AGENTSAM_IAM_OFFICIAL_RELEASE;
111
+
112
+ delete process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE;
113
+ process.env.AGENTSAM_IAM_OFFICIAL_RELEASE = '1';
114
+
115
+ try {
116
+ const result = applyInnerAnimalMediaOfficialGoProductRegistry({
117
+ productRoot: null,
118
+ officialRelease: true,
119
+ status: 'deployed',
120
+ dryRun: true,
121
+ skipRemote: true,
122
+ });
123
+
124
+ assert.equal(result.ok, true);
125
+ assert.match(result.sql, /'production'/);
126
+ } finally {
127
+ if (preferred == null) {
128
+ delete process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE;
129
+ } else {
130
+ process.env.AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE = preferred;
131
+ }
132
+
133
+ if (legacy == null) {
134
+ delete process.env.AGENTSAM_IAM_OFFICIAL_RELEASE;
135
+ } else {
136
+ process.env.AGENTSAM_IAM_OFFICIAL_RELEASE = legacy;
137
+ }
138
+ }
139
+ });
@@ -29,8 +29,7 @@ describe('cloudflare connector routes', () => {
29
29
  it('returns 503 on start when only fixture credentials exist', async () => {
30
30
  const env = {
31
31
  CLOUDFLARE_OAUTH_CLIENT_ID: 'sillynotreal',
32
- CLOUDFLARE_OAUTH_CLIENT_SECRET: 'sillynotreal-secret',
33
- sessions: new Map([['sess_1', 'user-sam']]),
32
+ fixtureSessions: new Map([['sess_1', 'user-sam']]),
34
33
  };
35
34
  const res = await handleCloudflareConnectionRequest(
36
35
  req('https://agentsam.inneranimalmedia.com/api/connections/cloudflare/start', {
@@ -47,8 +46,7 @@ describe('cloudflare connector routes', () => {
47
46
  it('status stays safe and does not treat fixture as production configured', async () => {
48
47
  const env = {
49
48
  CLOUDFLARE_OAUTH_CLIENT_ID: 'sillynotreal',
50
- CLOUDFLARE_OAUTH_CLIENT_SECRET: 'sillynotreal-secret',
51
- sessions: new Map([['sess_1', 'user-sam']]),
49
+ fixtureSessions: new Map([['sess_1', 'user-sam']]),
52
50
  };
53
51
  const res = await handleCloudflareConnectionRequest(
54
52
  req('https://agentsam.inneranimalmedia.com/api/connections/cloudflare', {
@@ -65,7 +63,7 @@ describe('cloudflare connector routes', () => {
65
63
  });
66
64
 
67
65
  it('rejects owner_id in the JSON body', async () => {
68
- const env = { sessions: new Map([['sess_1', 'user-sam']]) };
66
+ const env = { fixtureSessions: new Map([['sess_1', 'user-sam']]) };
69
67
  const res = await handleCloudflareConnectionRequest(
70
68
  req('https://agentsam.inneranimalmedia.com/api/connections/cloudflare/disconnect', {
71
69
  method: 'POST',
@@ -82,7 +80,6 @@ describe('cloudflare connector routes', () => {
82
80
  it('rejects callback without a stored oauth state', async () => {
83
81
  const env = {
84
82
  CLOUDFLARE_OAUTH_CLIENT_ID: 'real-client-id',
85
- CLOUDFLARE_OAUTH_CLIENT_SECRET: 'real-client-secret-value',
86
83
  oauthState: new Map(),
87
84
  };
88
85
  const res = await handleCloudflareConnectionRequest(
@@ -10,10 +10,17 @@ function tempRoot() { return fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-cf-
10
10
 
11
11
  test('Cloudflare native command catalog exposes bounded read operations and never an auth-token secret read', () => {
12
12
  const ids = listWranglerNativeCommands().map((row) => row.id);
13
- assert.deepEqual(ids, ['whoami', 'deployments.list', 'versions.list', 'types.check', 'queues.list']);
13
+ assert.deepEqual(ids, ['whoami', 'deployments.list', 'versions.list', 'versions.view', 'types.check', 'queues.list', 'tunnel.list', 'tunnel.info']);
14
14
  assert.ok(!ids.some((id) => id.includes('token') || id.includes('secret') || id === 'deploy'));
15
15
  });
16
16
 
17
+ test('Wrangler version view requires an exact version and keeps secret values unavailable', () => {
18
+ const root = tempRoot();
19
+ const plan = buildWranglerInvocation('versions.view', { cwd: root, name: 'demo', version_id: 'ver_123' });
20
+ assert.deepEqual(plan.args, ['versions', 'view', 'ver_123', '--json', '--name', 'demo']);
21
+ assert.throws(() => buildWranglerInvocation('versions.view', { cwd: root, name: 'demo' }), /version_id_required/);
22
+ });
23
+
17
24
  test('Wrangler native invocation is argv-based and cwd/config scoped', () => {
18
25
  const root = tempRoot();
19
26
  fs.writeFileSync(path.join(root, 'wrangler.jsonc'), '{}');
@@ -115,6 +115,21 @@ test('AgentSam instructions compile in stable then repository-specific precedenc
115
115
  assert.ok(compiled.content.indexOf('base law') < compiled.content.indexOf('local law'));
116
116
  });
117
117
 
118
+ test('compatibility shims are not compiled into AgentSam instruction authority', t => {
119
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-instruction-shims-'));
120
+ t.after(() => fs.rmSync(root, { recursive: true, force: true }));
121
+ fs.mkdirSync(path.join(root, '.git'));
122
+ fs.writeFileSync(path.join(root, 'AGENTSAM.md'), '# Stable\ncanonical only\n');
123
+ fs.writeFileSync(path.join(root, 'AGENTS.md'), 'shim should not become policy\n');
124
+ fs.writeFileSync(path.join(root, 'CLAUDE.md'), 'claude shim should not become policy\n');
125
+ const compiled = compileAgentInstructions(root);
126
+ assert.equal(compiled.sources.length, 1);
127
+ assert.equal(compiled.sources[0].filename, 'AGENTSAM.md');
128
+ assert.match(compiled.content, /canonical only/);
129
+ assert.doesNotMatch(compiled.content, /shim should not become policy/);
130
+ assert.doesNotMatch(compiled.content, /claude shim should not become policy/);
131
+ });
132
+
118
133
  test('project context loads bounded compiled AgentSam instructions', t => {
119
134
  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-context-rules-'));
120
135
  t.after(() => fs.rmSync(root, { recursive: true, force: true }));
@@ -16,6 +16,15 @@ import { createOpenAIResponsesAdapter } from '../src/providers/openai-responses.
16
16
 
17
17
  function response(status, body, headers = {}) { return new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json', ...headers } }); }
18
18
 
19
+
20
+ test('public errors subpath preserves canonical and legacy diagnostic APIs', async () => {
21
+ const errors = await import('@inneranimalmedia/agentsam-sdk/errors');
22
+ assert.equal(typeof errors.createErrorEnvelope, 'function');
23
+ assert.equal(typeof errors.classifyCloudflareFailure, 'function');
24
+ assert.equal(typeof errors.classifyOpenAIError, 'function');
25
+ assert.equal(typeof errors.diagnosticFromError, 'function');
26
+ });
27
+
19
28
  test('OpenAI diagnostics preserve machine code, request id, retry metadata and redact secrets', () => {
20
29
  const error = createOpenAIHttpError({
21
30
  status: 429,
@@ -0,0 +1,208 @@
1
+ {
2
+ "id": "courtyard-house-fixture",
3
+ "name": "Courtyard House — baseline study",
4
+ "units": "in",
5
+ "scale": 1,
6
+ "gridSize": 12,
7
+ "snapToGrid": true,
8
+ "walls": [
9
+ {
10
+ "id": "wall-0",
11
+ "x1": 0,
12
+ "y1": 0,
13
+ "x2": 864,
14
+ "y2": 0,
15
+ "thickness": 6,
16
+ "height3D": 120,
17
+ "material": "wood_panel",
18
+ "exterior": true
19
+ },
20
+ {
21
+ "id": "wall-1",
22
+ "x1": 864,
23
+ "y1": 0,
24
+ "x2": 864,
25
+ "y2": 720,
26
+ "thickness": 6,
27
+ "height3D": 120,
28
+ "material": "wood_panel",
29
+ "exterior": true
30
+ },
31
+ {
32
+ "id": "wall-2",
33
+ "x1": 864,
34
+ "y1": 720,
35
+ "x2": 600,
36
+ "y2": 720,
37
+ "thickness": 6,
38
+ "height3D": 120,
39
+ "material": "wood_panel",
40
+ "exterior": true
41
+ },
42
+ {
43
+ "id": "wall-3",
44
+ "x1": 600,
45
+ "y1": 720,
46
+ "x2": 600,
47
+ "y2": 192,
48
+ "thickness": 6,
49
+ "height3D": 120,
50
+ "material": "wood_panel",
51
+ "exterior": true
52
+ },
53
+ {
54
+ "id": "wall-4",
55
+ "x1": 600,
56
+ "y1": 192,
57
+ "x2": 264,
58
+ "y2": 192,
59
+ "thickness": 6,
60
+ "height3D": 120,
61
+ "material": "wood_panel",
62
+ "exterior": true
63
+ },
64
+ {
65
+ "id": "wall-5",
66
+ "x1": 264,
67
+ "y1": 192,
68
+ "x2": 264,
69
+ "y2": 720,
70
+ "thickness": 6,
71
+ "height3D": 120,
72
+ "material": "wood_panel",
73
+ "exterior": true
74
+ },
75
+ {
76
+ "id": "wall-6",
77
+ "x1": 264,
78
+ "y1": 720,
79
+ "x2": 0,
80
+ "y2": 720,
81
+ "thickness": 6,
82
+ "height3D": 120,
83
+ "material": "wood_panel",
84
+ "exterior": true
85
+ },
86
+ {
87
+ "id": "wall-7",
88
+ "x1": 0,
89
+ "y1": 720,
90
+ "x2": 0,
91
+ "y2": 0,
92
+ "thickness": 6,
93
+ "height3D": 120,
94
+ "material": "wood_panel",
95
+ "exterior": true
96
+ }
97
+ ],
98
+ "doors": [
99
+ {
100
+ "id": "courtyard-door",
101
+ "wallId": "wall-4",
102
+ "distanceAlongWall": 0.5,
103
+ "width": 96,
104
+ "height": 96,
105
+ "swing": "double",
106
+ "openAngle": 0
107
+ }
108
+ ],
109
+ "windows": [],
110
+ "rooms": [
111
+ {
112
+ "id": "left-wing",
113
+ "name": "Primary / kitchen wing",
114
+ "points": [
115
+ [
116
+ 0,
117
+ 0
118
+ ],
119
+ [
120
+ 264,
121
+ 0
122
+ ],
123
+ [
124
+ 264,
125
+ 720
126
+ ],
127
+ [
128
+ 0,
129
+ 720
130
+ ]
131
+ ],
132
+ "areaSqFt": 1320,
133
+ "floorMaterial": "hardwood",
134
+ "color": "#ac9875"
135
+ },
136
+ {
137
+ "id": "right-wing",
138
+ "name": "Bedroom / media wing",
139
+ "points": [
140
+ [
141
+ 600,
142
+ 0
143
+ ],
144
+ [
145
+ 864,
146
+ 0
147
+ ],
148
+ [
149
+ 864,
150
+ 720
151
+ ],
152
+ [
153
+ 600,
154
+ 720
155
+ ]
156
+ ],
157
+ "areaSqFt": 1320,
158
+ "floorMaterial": "hardwood",
159
+ "color": "#ac9875"
160
+ },
161
+ {
162
+ "id": "living",
163
+ "name": "Living connection",
164
+ "points": [
165
+ [
166
+ 264,
167
+ 0
168
+ ],
169
+ [
170
+ 600,
171
+ 0
172
+ ],
173
+ [
174
+ 600,
175
+ 192
176
+ ],
177
+ [
178
+ 264,
179
+ 192
180
+ ]
181
+ ],
182
+ "areaSqFt": 448,
183
+ "floorMaterial": "hardwood",
184
+ "color": "#ac9875"
185
+ }
186
+ ],
187
+ "furniture": [],
188
+ "annotations": [],
189
+ "parametricObjects": [],
190
+ "lighting": {
191
+ "sunAltitude": 45,
192
+ "sunAzimuth": 135,
193
+ "intensity": 1,
194
+ "timeOfDay": "noon",
195
+ "shadows": true,
196
+ "ambientColor": "#334155"
197
+ },
198
+ "roofType": "none",
199
+ "ceilingHeight": 120,
200
+ "version": 1,
201
+ "updatedAt": 0,
202
+ "metadata": {
203
+ "createdAt": 0,
204
+ "updatedAt": 0,
205
+ "revision": 1,
206
+ "description": "Regression fixture, not final house plan. 72x60 ft reference envelope; rear courtyard opens +Y. 10ft height assumed. Roof intentionally omitted until supported."
207
+ }
208
+ }