@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,120 @@
1
+ import { spawnSync } from 'node:child_process';
2
+ import { probeGoDeploymentWithRetry } from './cloudflare.js';
3
+
4
+ function runDocker(args, { productRoot, spawn = spawnSync } = {}) {
5
+ const res = spawn('docker', args, {
6
+ cwd: productRoot,
7
+ encoding: 'utf8',
8
+ maxBuffer: 16 * 1024 * 1024,
9
+ });
10
+ return {
11
+ status: res.status,
12
+ stdout: res.stdout || '',
13
+ stderr: res.stderr || '',
14
+ output: ((res.stdout || '') + '\n' + (res.stderr || '')).trim(),
15
+ };
16
+ }
17
+
18
+ export async function verifyGoContainer({
19
+ productRoot,
20
+ product = 'agentsam-go-worker',
21
+ expectedSource,
22
+ expectedSourceCommit,
23
+ expectedBuiltAt = '',
24
+ spawn = spawnSync,
25
+ fetchImpl = globalThis.fetch,
26
+ } = {}) {
27
+ const tag = product + ':agentsam-verify';
28
+ const build = runDocker(['build', '--platform', 'linux/amd64', '-t', tag, '.'], { productRoot, spawn });
29
+ if (build.status !== 0) {
30
+ const err = new Error('go_container_build_failed');
31
+ err.detail = build.output.slice(-4000);
32
+ throw err;
33
+ }
34
+
35
+ const inspected = runDocker(['image', 'inspect', tag], { productRoot, spawn });
36
+ if (inspected.status !== 0) throw new Error('go_container_inspect_failed');
37
+ let image = null;
38
+ try { image = JSON.parse(inspected.stdout)?.[0] || null; } catch {}
39
+ if (!image) throw new Error('go_container_inspect_invalid');
40
+ if (image.Architecture !== 'amd64') throw new Error('go_container_architecture_invalid');
41
+ const imageUser = String(image.Config?.User || '');
42
+ if (!imageUser || imageUser === '0' || imageUser === 'root' || imageUser.startsWith('0:')) {
43
+ throw new Error('go_container_root_user_forbidden');
44
+ }
45
+
46
+ const name = product + '-verify-' + process.pid + '-' + Date.now();
47
+ const start = runDocker([
48
+ 'run', '-d', '--name', name,
49
+ '-p', '127.0.0.1::8080',
50
+ '-e', 'AGENTSAM_TARGET=container',
51
+ '-e', 'AGENTSAM_BUILD_SOURCE=' + (expectedSource || ''),
52
+ '-e', 'AGENTSAM_BUILD_COMMIT=' + (expectedSourceCommit || ''),
53
+ '-e', 'AGENTSAM_BUILT_AT=' + expectedBuiltAt,
54
+ tag,
55
+ ], { productRoot, spawn });
56
+ if (start.status !== 0) {
57
+ const err = new Error('go_container_start_failed');
58
+ err.detail = start.output.slice(-3000);
59
+ throw err;
60
+ }
61
+
62
+ const containerId = start.stdout.trim();
63
+ let stopped = false;
64
+ let cleaned = false;
65
+ try {
66
+ let port = null;
67
+ for (let attempt = 0; attempt < 30; attempt += 1) {
68
+ const mapped = runDocker(['port', containerId, '8080/tcp'], { productRoot, spawn });
69
+ const match = mapped.stdout.match(/:(\d+)\s*$/m);
70
+ if (mapped.status === 0 && match) {
71
+ port = Number(match[1]);
72
+ break;
73
+ }
74
+ await new Promise((resolve) => setTimeout(resolve, 100));
75
+ }
76
+ if (!port) throw new Error('go_container_port_missing');
77
+
78
+ const origin = 'http://127.0.0.1:' + port;
79
+ const probe = await probeGoDeploymentWithRetry(origin, {
80
+ fetchImpl,
81
+ expectedSource,
82
+ expectedSourceCommit,
83
+ expectedTarget: 'container',
84
+ edge: false,
85
+ attempts: 20,
86
+ delayMs: 250,
87
+ });
88
+ if (!probe.ok) {
89
+ const err = new Error('go_container_probe_failed');
90
+ err.detail = probe;
91
+ throw err;
92
+ }
93
+
94
+ const stop = runDocker(['stop', '-t', '5', containerId], { productRoot, spawn });
95
+ stopped = stop.status === 0;
96
+ if (!stopped) throw new Error('go_container_stop_failed');
97
+ const cleanup = runDocker(['container', 'rm', containerId], { productRoot, spawn });
98
+ cleaned = cleanup.status === 0;
99
+ if (!cleaned) throw new Error('go_container_cleanup_failed');
100
+
101
+ return {
102
+ ok: true,
103
+ tag,
104
+ name,
105
+ image_digest: image.Id || null,
106
+ architecture: image.Architecture,
107
+ os: image.Os || null,
108
+ user: imageUser,
109
+ container_id: containerId,
110
+ clean_shutdown: true,
111
+ clean_cleanup: true,
112
+ probe,
113
+ retained_stopped_container: false,
114
+ build_output: build.output.slice(-2000),
115
+ };
116
+ } finally {
117
+ if (!stopped) runDocker(['stop', '-t', '1', containerId], { productRoot, spawn });
118
+ if (!cleaned) runDocker(['container', 'rm', containerId], { productRoot, spawn });
119
+ }
120
+ }
@@ -0,0 +1,144 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { spawnSync } from 'node:child_process';
4
+ import { DEFAULT_PRODUCT } from './discover.js';
5
+
6
+ const PACKAGE_TEMPLATE = {
7
+ schema: 'agentsam.package.v1',
8
+ name: DEFAULT_PRODUCT,
9
+ type: 'service',
10
+ runtime: 'go',
11
+ version: '0.1.0',
12
+ targets: ['cloudflare-worker', 'cloudflare-container', 'local'],
13
+ entrypoints: {
14
+ server: './runtime/cmd/server',
15
+ worker: './worker/src/index.js',
16
+ },
17
+ capabilities: ['hash', 'inspect', 'runtime', 'capabilities'],
18
+ distribution: {
19
+ package: '@inneranimalmedia/agentsam-go-worker',
20
+ normal_user: 'official-hosted-service',
21
+ self_host: 'advanced-opt-in',
22
+ },
23
+ deployment: {
24
+ adapter: 'cloudflare',
25
+ mode: 'worker-container',
26
+ wrangler_config: './wrangler.jsonc',
27
+ authority: 'explicit-cloudflare-account',
28
+ },
29
+ product: {
30
+ slug: DEFAULT_PRODUCT,
31
+ kind: 'service',
32
+ registry: 'local-by-default',
33
+ official_registry: 'agentsam_products',
34
+ official_registry_only: true,
35
+ },
36
+ };
37
+
38
+ /**
39
+ * Ensure product adapter files exist. Never scaffolds a second product directory.
40
+ * Returns { created: string[], updated: string[], existing: true }.
41
+ */
42
+ export function ensureProductContract(productRoot, { overwrite = false } = {}) {
43
+ const created = [];
44
+ const updated = [];
45
+ const manifestPath = path.join(productRoot, 'agentsam.package.json');
46
+
47
+ if (!fs.existsSync(productRoot)) {
48
+ throw new Error(`product_root_missing: ${productRoot} — seed apps/${DEFAULT_PRODUCT} first; do not invent a sibling product`);
49
+ }
50
+
51
+ if (!fs.existsSync(manifestPath)) {
52
+ fs.writeFileSync(manifestPath, `${JSON.stringify(PACKAGE_TEMPLATE, null, 2)}\n`);
53
+ created.push(rel(productRoot, manifestPath));
54
+ } else if (overwrite) {
55
+ const current = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
56
+ const merged = { ...PACKAGE_TEMPLATE, ...current, name: DEFAULT_PRODUCT };
57
+ fs.writeFileSync(manifestPath, `${JSON.stringify(merged, null, 2)}\n`);
58
+ updated.push(rel(productRoot, manifestPath));
59
+ }
60
+
61
+ const required = [
62
+ 'runtime/go.mod',
63
+ 'runtime/cmd/server/main.go',
64
+ 'worker/src/index.js',
65
+ 'wrangler.jsonc',
66
+ 'Dockerfile',
67
+ ];
68
+ const missing = required.filter((relPath) => !fs.existsSync(path.join(productRoot, relPath)));
69
+ if (missing.length) {
70
+ throw new Error(`product_incomplete: missing ${missing.join(', ')}`);
71
+ }
72
+
73
+ return {
74
+ product: DEFAULT_PRODUCT,
75
+ productRoot,
76
+ existing: created.length === 0,
77
+ created,
78
+ updated,
79
+ manifest: JSON.parse(fs.readFileSync(manifestPath, 'utf8')),
80
+ };
81
+ }
82
+
83
+ export function readProductManifest(productRoot) {
84
+ const manifestPath = path.join(productRoot, 'agentsam.package.json');
85
+ if (!fs.existsSync(manifestPath)) return null;
86
+ return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
87
+ }
88
+
89
+ function rel(root, file) {
90
+ return path.relative(root, file).split(path.sep).join('/');
91
+ }
92
+
93
+ export function preflightToolchain({ requireDocker = false, productRoot = null } = {}) {
94
+ const checks = [];
95
+ const push = (id, ok, detail = '') => checks.push({ id, ok, detail });
96
+
97
+ try {
98
+ const v = spawnSync('go', ['version'], { encoding: 'utf8' });
99
+ push('go', v.status === 0, (v.stdout || v.stderr || '').trim());
100
+ } catch (e) {
101
+ push('go', false, e.message);
102
+ }
103
+
104
+ const wranglerBin = resolveWranglerBin(productRoot);
105
+ try {
106
+ const v = spawnSync(wranglerBin.command, wranglerBin.args.concat(['--version']), {
107
+ encoding: 'utf8',
108
+ cwd: productRoot || process.cwd(),
109
+ });
110
+ push('wrangler', v.status === 0, (v.stdout || v.stderr || '').trim().slice(0, 120));
111
+ } catch (e) {
112
+ push('wrangler', false, e.message);
113
+ }
114
+
115
+ try {
116
+ const v = spawnSync('docker', ['info'], { encoding: 'utf8' });
117
+ push('docker', v.status === 0, v.status === 0 ? 'available' : (v.stderr || 'unavailable').trim().slice(0, 200));
118
+ } catch (e) {
119
+ push('docker', false, e.message);
120
+ }
121
+
122
+ const failed = checks.filter((c) => {
123
+ if (c.ok) return false;
124
+ if (c.id === 'docker' && !requireDocker) return false;
125
+ return true;
126
+ });
127
+ return { ok: failed.length === 0, checks, failed, wrangler: wranglerBin };
128
+ }
129
+
130
+ function resolveWranglerBin(productRoot) {
131
+ const candidates = [];
132
+ if (productRoot) {
133
+ candidates.push(path.join(productRoot, 'node_modules', 'wrangler', 'bin', 'wrangler.js'));
134
+ candidates.push(path.join(productRoot, 'node_modules', '.bin', 'wrangler'));
135
+ }
136
+ candidates.push(path.join(process.cwd(), 'node_modules', '.bin', 'wrangler'));
137
+ for (const candidate of candidates) {
138
+ if (fs.existsSync(candidate)) {
139
+ if (candidate.endsWith('.js')) return { command: process.execPath, args: [candidate] };
140
+ return { command: candidate, args: [] };
141
+ }
142
+ }
143
+ return { command: 'npx', args: ['--yes', 'wrangler'] };
144
+ }
@@ -0,0 +1,212 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { createRequire } from 'node:module';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { execFileSync } from 'node:child_process';
6
+ import { repositoryRoot, gitEvidence } from '../knowledge/config.js';
7
+
8
+ const HERE = path.dirname(fileURLToPath(import.meta.url));
9
+ const MODULE_REQUIRE = createRequire(import.meta.url);
10
+ export const SDK_ROOT = path.resolve(HERE, '../..');
11
+ export const DEFAULT_PRODUCT = 'agentsam-go-worker';
12
+ export const DEFAULT_PRODUCT_REL = path.join('apps', DEFAULT_PRODUCT);
13
+ export const GO_WORKER_PACKAGE = '@inneranimalmedia/agentsam-go-worker';
14
+
15
+ function readJSON(file) {
16
+ try { return JSON.parse(fs.readFileSync(file, 'utf8')); } catch { return null; }
17
+ }
18
+
19
+ function normalizeExplicitProductRoot(value) {
20
+ if (!value) return null;
21
+ const resolved = path.resolve(value);
22
+ if (!fs.existsSync(resolved)) return null;
23
+ if (path.basename(resolved) === 'runtime' && fs.existsSync(path.join(resolved, 'go.mod'))) {
24
+ return path.dirname(resolved);
25
+ }
26
+ return resolved;
27
+ }
28
+
29
+ function packageRootFrom(requireFn) {
30
+ try {
31
+ return path.dirname(requireFn.resolve(GO_WORKER_PACKAGE + '/package.json'));
32
+ } catch {
33
+ return null;
34
+ }
35
+ }
36
+
37
+ function cwdRequire(cwd) {
38
+ try {
39
+ return createRequire(path.join(path.resolve(cwd), 'package.json'));
40
+ } catch {
41
+ return null;
42
+ }
43
+ }
44
+
45
+ function runtimeCandidate(productRoot, origin) {
46
+ if (!productRoot) return null;
47
+ const runtimeRoot = path.join(productRoot, 'runtime');
48
+ const modPath = path.join(runtimeRoot, 'go.mod');
49
+ if (!fs.existsSync(modPath)) return null;
50
+ const mod = fs.readFileSync(modPath, 'utf8');
51
+ const moduleMatch = mod.match(/^module\s+(\S+)/m);
52
+ const serverMain = path.join(runtimeRoot, 'cmd', 'server', 'main.go');
53
+ const packageJson = path.join(productRoot, 'package.json');
54
+ return {
55
+ origin,
56
+ runtimeRoot,
57
+ module: moduleMatch?.[1] || null,
58
+ goMod: modPath,
59
+ entry: fs.existsSync(serverMain) ? serverMain : findFirstGoMain(runtimeRoot),
60
+ productRoot,
61
+ packageManifest: path.join(productRoot, 'agentsam.package.json'),
62
+ packageJson,
63
+ package: readJSON(packageJson),
64
+ };
65
+ }
66
+
67
+ function legacyRuntimeCandidate(runtimeRoot, origin) {
68
+ const modPath = path.join(runtimeRoot, 'go.mod');
69
+ if (!fs.existsSync(modPath)) return null;
70
+ const mod = fs.readFileSync(modPath, 'utf8');
71
+ const moduleMatch = mod.match(/^module\s+(\S+)/m);
72
+ const productRoot = path.basename(runtimeRoot) === 'runtime' ? path.dirname(runtimeRoot) : runtimeRoot;
73
+ return {
74
+ origin,
75
+ runtimeRoot,
76
+ module: moduleMatch?.[1] || null,
77
+ goMod: modPath,
78
+ entry: findFirstGoMain(runtimeRoot),
79
+ productRoot,
80
+ packageManifest: path.join(productRoot, 'agentsam.package.json'),
81
+ packageJson: path.join(productRoot, 'package.json'),
82
+ package: readJSON(path.join(productRoot, 'package.json')),
83
+ };
84
+ }
85
+
86
+ /**
87
+ * Locate the one AgentSam Go service implementation without assuming the SDK
88
+ * development checkout ships inside the root npm package.
89
+ *
90
+ * Resolution order:
91
+ * 1. explicit AGENTSAM_GO_WORKER_ROOT
92
+ * 2. current repository apps/agentsam-go-worker (maintainer/contributor mode)
93
+ * 3. installed @inneranimalmedia/agentsam-go-worker package (distribution mode)
94
+ * 4. SDK development tree when present
95
+ * 5. narrow legacy runtime candidates
96
+ */
97
+ export function discoverGoRuntime(cwd = process.cwd()) {
98
+ const root = repositoryRoot(cwd);
99
+ const req = cwdRequire(cwd);
100
+ const productCandidates = [
101
+ [normalizeExplicitProductRoot(process.env.AGENTSAM_GO_WORKER_ROOT), 'explicit'],
102
+ [path.join(root, DEFAULT_PRODUCT_REL), 'repository'],
103
+ [req ? packageRootFrom(req) : null, 'installed_package'],
104
+ [packageRootFrom(MODULE_REQUIRE), 'installed_package'],
105
+ [path.join(SDK_ROOT, DEFAULT_PRODUCT_REL), 'sdk_development_tree'],
106
+ ];
107
+
108
+ const found = [];
109
+ const seen = new Set();
110
+ for (const [productRoot, origin] of productCandidates) {
111
+ if (!productRoot) continue;
112
+ let real;
113
+ try { real = fs.realpathSync(productRoot); } catch { continue; }
114
+ if (seen.has(real)) continue;
115
+ seen.add(real);
116
+ const candidate = runtimeCandidate(real, origin);
117
+ if (candidate) found.push(candidate);
118
+ }
119
+
120
+ for (const [runtimeRoot, origin] of [
121
+ [path.join(root, 'runtime'), 'legacy_repository_runtime'],
122
+ [path.join(root, 'cmd', 'agentsam'), 'legacy_repository_cmd'],
123
+ ]) {
124
+ let real;
125
+ try { real = fs.realpathSync(runtimeRoot); } catch { continue; }
126
+ if (seen.has(real)) continue;
127
+ seen.add(real);
128
+ const candidate = legacyRuntimeCandidate(real, origin);
129
+ if (candidate) found.push(candidate);
130
+ }
131
+
132
+ const preferred = found.find((row) => row.module?.includes('agentsam-go-worker')) || found[0] || null;
133
+ const goTool = probeGoToolchain();
134
+ const git = gitEvidence(root);
135
+
136
+ return {
137
+ schema: 'agentsam.go-discovery.v2',
138
+ repository_root: root,
139
+ sdk_root: SDK_ROOT,
140
+ go: goTool,
141
+ git,
142
+ runtime: preferred,
143
+ candidates: found,
144
+ product_exists: Boolean(preferred && fs.existsSync(preferred.packageManifest)),
145
+ distribution: preferred
146
+ ? {
147
+ origin: preferred.origin,
148
+ package_name: preferred.package?.name || null,
149
+ package_version: preferred.package?.version || null,
150
+ product_root: preferred.productRoot,
151
+ }
152
+ : null,
153
+ };
154
+ }
155
+
156
+ function findFirstGoMain(dir) {
157
+ const stack = [dir];
158
+ while (stack.length) {
159
+ const cur = stack.pop();
160
+ let ents;
161
+ try { ents = fs.readdirSync(cur, { withFileTypes: true }); } catch { continue; }
162
+ for (const ent of ents) {
163
+ if (ent.name === 'vendor' || ent.name === '.git' || ent.name === 'node_modules') continue;
164
+ const full = path.join(cur, ent.name);
165
+ if (ent.isDirectory()) stack.push(full);
166
+ else if (ent.name === 'main.go') return full;
167
+ }
168
+ }
169
+ return null;
170
+ }
171
+
172
+ export function probeGoToolchain() {
173
+ try {
174
+ const version = execFileSync('go', ['version'], { encoding: 'utf8' }).trim();
175
+ const env = execFileSync('go', ['env', 'GOROOT', 'GOVERSION'], { encoding: 'utf8' }).trim().split(/\r?\n/);
176
+ return { ok: true, version, goroot: env[0] || null, goversion: env[1] || null };
177
+ } catch (error) {
178
+ return { ok: false, error: error.message };
179
+ }
180
+ }
181
+
182
+ export function resolveGoStateRoot(discovery, cwd = process.cwd()) {
183
+ const origin = discovery?.runtime?.origin || null;
184
+ if (origin === 'repository' || origin === 'sdk_development_tree') {
185
+ return discovery.runtime.productRoot;
186
+ }
187
+ return repositoryRoot(cwd);
188
+ }
189
+
190
+ export function resolveProductRoot(discovery, productName = DEFAULT_PRODUCT) {
191
+ const runtime = discovery?.runtime;
192
+ if (
193
+ runtime?.productRoot
194
+ && (
195
+ path.basename(runtime.productRoot) === productName
196
+ || runtime.package?.name === GO_WORKER_PACKAGE
197
+ )
198
+ ) {
199
+ return runtime.productRoot;
200
+ }
201
+
202
+ const fromCandidates = discovery?.candidates?.find((row) => (
203
+ path.basename(row.productRoot || '') === productName
204
+ || row.package?.name === GO_WORKER_PACKAGE
205
+ ));
206
+ if (fromCandidates?.productRoot) return fromCandidates.productRoot;
207
+
208
+ const err = new Error('go_product_not_discovered:' + productName);
209
+ err.code = 'go_product_not_discovered';
210
+ err.hint = 'Install ' + GO_WORKER_PACKAGE + ' for self-host deployment or run from the AgentSam SDK maintainer checkout.';
211
+ throw err;
212
+ }
@@ -0,0 +1,25 @@
1
+ export { discoverGoRuntime, resolveProductRoot, resolveGoStateRoot, probeGoToolchain, DEFAULT_PRODUCT, SDK_ROOT } from './discover.js';
2
+ export { ensureProductContract, readProductManifest, preflightToolchain } from './contract.js';
3
+ export { buildGoProduct, runGoBuild, runGoTests, runGoVet } from './build.js';
4
+ export { deployGoCloudflare, resolveWranglerIdentity, probeGoDeployment, probeGoDeploymentWithRetry, readLatestWranglerDeployment } from './cloudflare.js';
5
+ export { verifyGoContainer } from './container.js';
6
+ export { verifyGoProduct } from './verify.js';
7
+ export {
8
+ applyInnerAnimalMediaOfficialGoProductRegistry,
9
+ applyIamOfficialGoProductRegistry,
10
+ buildGoProductRegistrySql,
11
+ } from './official-registry.js';
12
+ export {
13
+ INNERANIMALMEDIA_OFFICIAL_RELEASE_ENV,
14
+ LEGACY_IAM_OFFICIAL_RELEASE_ENV,
15
+ innerAnimalMediaOfficialReleaseEnabled,
16
+ } from './official-release.js';
17
+ export {
18
+ writeGoBuildReceipt,
19
+ writeDeploymentReceipt,
20
+ writeDeploymentValidationReceipt,
21
+ writeProductRegistryLocal,
22
+ writeProductValidationLocal,
23
+ readLatestStatus,
24
+ buildProductRow,
25
+ } from './receipts.js';
@@ -0,0 +1,119 @@
1
+ import { spawn } from 'node:child_process';
2
+ import net from 'node:net';
3
+
4
+ const binary = process.argv[2];
5
+ const expectedSource = process.argv[3] || '';
6
+ const expectedCommit = process.argv[4] || '';
7
+ const expectedHash = '2e60bba13dc2bc37d75dd2ce5deb25466f19cb2994e20889388948879875eae9';
8
+ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
9
+
10
+ const port = await new Promise((resolve, reject) => {
11
+ const server = net.createServer();
12
+ server.unref();
13
+ server.on('error', reject);
14
+ server.listen(0, '127.0.0.1', () => {
15
+ const value = server.address().port;
16
+ server.close(() => resolve(value));
17
+ });
18
+ });
19
+
20
+ const child = spawn(binary, [], {
21
+ env: { ...process.env, PORT: String(port), AGENTSAM_TARGET: 'local' },
22
+ stdio: ['ignore', 'ignore', 'pipe'],
23
+ });
24
+ let stderr = '';
25
+ child.stderr.on('data', (chunk) => { stderr += String(chunk); });
26
+ const base = 'http://127.0.0.1:' + port;
27
+ const results = {};
28
+
29
+ async function request(name, pathname, init = {}) {
30
+ const res = await fetch(base + pathname, init);
31
+ let body = null;
32
+ try { body = await res.json(); } catch {}
33
+ results[name] = { status: res.status, ok: res.ok, body };
34
+ return results[name];
35
+ }
36
+
37
+ let ready = false;
38
+ for (let attempt = 0; attempt < 100 && child.exitCode == null; attempt += 1) {
39
+ try {
40
+ const health = await request('health', '/health', { headers: { Accept: 'application/json' } });
41
+ if (health.ok) { ready = true; break; }
42
+ } catch {}
43
+ await sleep(50);
44
+ }
45
+
46
+ let error = null;
47
+ if (!ready) {
48
+ error = 'runtime_not_ready';
49
+ } else {
50
+ try {
51
+ await request('runtime', '/v1/runtime');
52
+ await request('capabilities', '/v1/capabilities');
53
+ await request('hash', '/v1/hash', {
54
+ method: 'POST',
55
+ headers: { 'Content-Type': 'application/json' },
56
+ body: JSON.stringify({ input: 'agentsam', algorithm: 'sha256' }),
57
+ });
58
+ await request('inspect', '/v1/inspect', {
59
+ method: 'POST',
60
+ headers: { 'Content-Type': 'application/json' },
61
+ body: JSON.stringify({ files: [{ path: 'demo.css', content: '.button { color: #2563eb; }' }] }),
62
+ });
63
+ await request('malformed', '/v1/inspect', {
64
+ method: 'POST',
65
+ headers: { 'Content-Type': 'application/json' },
66
+ body: JSON.stringify({ not_files: true }),
67
+ });
68
+ } catch (cause) {
69
+ error = cause.message;
70
+ }
71
+ }
72
+
73
+ const health = results.health?.body;
74
+ const runtime = results.runtime?.body;
75
+ const capabilities = results.capabilities?.body;
76
+ const malformed = results.malformed?.body;
77
+ const checks = {
78
+ health: results.health?.status === 200 && health?.ok === true && health?.target === 'local',
79
+ source_identity: Boolean(expectedSource) && health?.build?.source === expectedSource,
80
+ source_commit: expectedCommit ? health?.build?.commit === expectedCommit : true,
81
+ runtime: results.runtime?.status === 200 && runtime?.schema === 'agentsam.go-runtime.v1',
82
+ capabilities: results.capabilities?.status === 200
83
+ && capabilities?.schema === 'agentsam.go-capabilities.v1'
84
+ && ['hash', 'inspect', 'runtime', 'capabilities'].every((name) => capabilities?.capabilities?.includes(name)),
85
+ hash: results.hash?.status === 200 && results.hash?.body?.hash === expectedHash,
86
+ inspect: results.inspect?.status === 200
87
+ && results.inspect?.body?.findings?.some((finding) => finding.kind === 'hardcoded_color' && finding.value === '#2563eb'),
88
+ error_envelope: results.malformed?.status === 400
89
+ && malformed?.ok === false
90
+ && malformed?.schema_version === 1
91
+ && malformed?.reason === 'input_invalid'
92
+ && malformed?.code === 'INVALID_ARGUMENT',
93
+ };
94
+
95
+ const exitPromise = new Promise((resolve) => {
96
+ const timer = setTimeout(() => {
97
+ child.kill('SIGKILL');
98
+ resolve({ code: child.exitCode, signal: 'SIGKILL', timeout: true });
99
+ }, 5000);
100
+ child.once('exit', (code, signal) => {
101
+ clearTimeout(timer);
102
+ resolve({ code, signal, timeout: false });
103
+ });
104
+ });
105
+ child.kill('SIGTERM');
106
+ const exit = await exitPromise;
107
+ checks.clean_shutdown = exit.code === 0 && !exit.timeout;
108
+
109
+ const ok = !error && Object.values(checks).every(Boolean);
110
+ process.stdout.write(JSON.stringify({
111
+ ok,
112
+ origin: base,
113
+ checks,
114
+ results,
115
+ exit,
116
+ stderr: stderr.slice(-2000),
117
+ error,
118
+ }));
119
+ process.exit(ok ? 0 : 1);