@inneranimalmedia/agentsam-sdk 2.6.2 → 2.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (497) hide show
  1. package/AGENTSAM.md +45 -1
  2. package/README.md +80 -0
  3. package/apps/README.md +34 -0
  4. package/apps/cad-creator/README.md +728 -0
  5. package/apps/cad-creator/shared/cad/package.json +19 -0
  6. package/apps/cad-creator/shared/cad/src/domain/operations.ts +7 -0
  7. package/apps/cad-creator/shared/cad/src/domain/project-contract.d.ts +3 -0
  8. package/apps/cad-creator/shared/cad/src/domain/project-contract.js +75 -0
  9. package/apps/cad-creator/shared/cad/src/domain/project-tools.d.ts +1 -0
  10. package/apps/cad-creator/shared/cad/src/domain/project-tools.js +24 -0
  11. package/apps/cad-creator/shared/cad/src/domain/validation.ts +191 -0
  12. package/apps/cad-creator/shared/cad/src/index.ts +4 -0
  13. package/apps/cad-creator/shared/cad/src/robotics/types.ts +232 -0
  14. package/apps/cad-creator/shared/cad/src/types.ts +507 -0
  15. package/apps/cad-creator/shared/cad/tsconfig.json +14 -0
  16. package/docs/AUTORAG.md +58 -0
  17. package/docs/BRAND_INTELLIGENCE.md +30 -0
  18. package/docs/CLI_SHELL.md +4 -2
  19. package/docs/CMS_CONTEXTUAL_COMPOSER.md +38 -0
  20. package/docs/MERKLE.md +4 -0
  21. package/docs/PROJECT_CONFIG.md +3 -0
  22. package/docs/REPOSITORY_KNOWLEDGE.md +2 -0
  23. package/docs/THEME_REFINERY.md +120 -0
  24. package/docs/architecture/PROVIDER-TOOLS-AND-COMPACTION.md +60 -0
  25. package/docs/architecture/STORAGE.md +87 -0
  26. package/docs/cad-project-tools.md +69 -0
  27. package/docs/cms-scaffolding-pattern-reference.md +73 -0
  28. package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS-codex-tui-20260919.md +113 -0
  29. package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS.md +85 -0
  30. package/docs/plans/AGENTSAM-MCP-CLIENT-2026-09-19.md +181 -0
  31. package/docs/plans/ASBD-PORTABLE-WORKGRAPH-UI-DEFERRED.md +34 -0
  32. package/docs/plans/ASTRA-BRIEF-2026-09-18.md +258 -0
  33. package/docs/plans/MULTI-AGENT-SPRINTS-2026-09-19.md +373 -0
  34. package/docs/plans/NEXT-AGENT-HANDOFF.md +167 -0
  35. package/docs/plans/RECONCILIATION-2026-09-19.md +178 -0
  36. package/docs/plugins.md +43 -0
  37. package/docs/tools/README.md +57 -0
  38. package/docs/tools/agent-and-orchestration.md +49 -0
  39. package/docs/tools/browser-and-research.md +46 -0
  40. package/docs/tools/cloudflare-platform.md +32 -0
  41. package/docs/tools/cms.md +25 -0
  42. package/docs/tools/communications.md +41 -0
  43. package/docs/tools/database-and-storage.md +62 -0
  44. package/docs/tools/design-and-media.md +64 -0
  45. package/docs/tools/filesystem-and-code.md +55 -0
  46. package/docs/tools/github.md +56 -0
  47. package/docs/tools/integrations-and-misc.md +16 -0
  48. package/docs/tools/memory.md +21 -0
  49. package/docs/tools/terminal-and-execution.md +29 -0
  50. package/docs/tools/tickets-and-platform.md +30 -0
  51. package/migrations/d1/0001_agentsam_plugin_runtime.sql +177 -0
  52. package/migrations/d1/0002_agentsam_ticket_ownership.sql +8 -0
  53. package/migrations/d1/0002_dynamic_model_policies.sql +23 -0
  54. package/migrations/d1/0003_expand_tool_handler_families.sql +18 -0
  55. package/migrations/d1/0004_project_aware_retrieval_lanes.sql +24 -0
  56. package/migrations/d1/0005_portable_knowledge_identity.sql +104 -0
  57. package/migrations/d1/0006_repair_ops_trail_account_scope.sql +14 -0
  58. package/migrations/d1/0007_repair_ops_trail_agent_run_account.sql +13 -0
  59. package/migrations/d1/0008_backfill_knowledge_run_legacy_tenant.sql +14 -0
  60. package/migrations/d1/0009_normalize_cloudflare_plugin_installations.sql +137 -0
  61. package/migrations/runtime/0001_cli_runtime.sql +67 -0
  62. package/migrations/runtime/0002_project_sessions.sql +15 -0
  63. package/migrations/runtime/0003_provider_continuations.sql +8 -0
  64. package/package.json +92 -12
  65. package/packages/agentsam-brand/README.md +21 -0
  66. package/packages/agentsam-brand/package.json +22 -0
  67. package/packages/agentsam-brand/src/contract.js +59 -0
  68. package/packages/agentsam-brand/src/extract.js +126 -0
  69. package/packages/agentsam-brand/src/goap-actions.js +73 -0
  70. package/packages/agentsam-brand/src/index.js +48 -0
  71. package/packages/agentsam-brand/src/plan.js +115 -0
  72. package/packages/agentsam-brand/src/resolve.js +139 -0
  73. package/packages/agentsam-brand/src/scan.js +250 -0
  74. package/packages/agentsam-brand/test/brand-scan.test.mjs +106 -0
  75. package/packages/agentsam-contracts/README.md +23 -0
  76. package/packages/agentsam-contracts/package.json +32 -0
  77. package/packages/agentsam-contracts/src/adapter.ts +25 -0
  78. package/packages/agentsam-contracts/src/agent.ts +35 -0
  79. package/packages/agentsam-contracts/src/artifacts.ts +33 -0
  80. package/packages/agentsam-contracts/src/authority.ts +29 -0
  81. package/packages/agentsam-contracts/src/context.ts +16 -0
  82. package/packages/agentsam-contracts/src/errors.ts +46 -0
  83. package/packages/agentsam-contracts/src/events.ts +47 -0
  84. package/packages/agentsam-contracts/src/execution.ts +50 -0
  85. package/packages/agentsam-contracts/src/hooks.ts +40 -0
  86. package/packages/agentsam-contracts/src/identity.ts +16 -0
  87. package/packages/agentsam-contracts/src/index.ts +14 -0
  88. package/packages/agentsam-contracts/src/models.ts +9 -0
  89. package/packages/agentsam-contracts/src/providers.ts +33 -0
  90. package/packages/agentsam-contracts/src/repository.ts +64 -0
  91. package/packages/agentsam-contracts/src/tools.ts +98 -0
  92. package/packages/agentsam-contracts/test/contracts.test.mjs +16 -0
  93. package/packages/agentsam-contracts/test/errors-catalog.test.mjs +25 -0
  94. package/packages/agentsam-contracts/test/repository.test.mjs +18 -0
  95. package/packages/agentsam-contracts/tsconfig.json +12 -0
  96. package/packages/agentsam-errors/package.json +17 -0
  97. package/packages/agentsam-errors/src/adapters/anthropic.js +15 -0
  98. package/packages/agentsam-errors/src/adapters/cad.js +109 -0
  99. package/packages/agentsam-errors/src/adapters/cloudflare.js +21 -0
  100. package/packages/agentsam-errors/src/adapters/cursor.js +4 -0
  101. package/packages/agentsam-errors/src/adapters/device.js +38 -0
  102. package/packages/agentsam-errors/src/adapters/docker.js +28 -0
  103. package/packages/agentsam-errors/src/adapters/gcp.js +14 -0
  104. package/packages/agentsam-errors/src/adapters/github.js +22 -0
  105. package/packages/agentsam-errors/src/adapters/google.js +17 -0
  106. package/packages/agentsam-errors/src/adapters/index.js +55 -0
  107. package/packages/agentsam-errors/src/adapters/internal.js +40 -0
  108. package/packages/agentsam-errors/src/adapters/oauth.js +24 -0
  109. package/packages/agentsam-errors/src/adapters/openai.js +17 -0
  110. package/packages/agentsam-errors/src/adapters/process.js +35 -0
  111. package/packages/agentsam-errors/src/adapters/provider.js +114 -0
  112. package/packages/agentsam-errors/src/envelope.js +186 -0
  113. package/packages/agentsam-errors/src/error.js +24 -0
  114. package/packages/agentsam-errors/src/fingerprint.js +35 -0
  115. package/packages/agentsam-errors/src/index.js +10 -0
  116. package/packages/agentsam-errors/src/normalize.js +30 -0
  117. package/packages/agentsam-errors/src/redaction.js +52 -0
  118. package/packages/agentsam-errors/src/render.js +16 -0
  119. package/packages/agentsam-errors/src/retry.js +10 -0
  120. package/packages/agentsam-errors/src/transport.js +52 -0
  121. package/packages/agentsam-errors/src/vocabulary.js +320 -0
  122. package/packages/agentsam-errors/test/envelope.test.mjs +70 -0
  123. package/packages/agentsam-errors/test/providers.test.mjs +99 -0
  124. package/packages/agentsam-errors/test/redaction.test.mjs +21 -0
  125. package/packages/agentsam-errors/test/runtime-cad-device.test.mjs +76 -0
  126. package/packages/agentsam-errors/test/transport.test.mjs +46 -0
  127. package/packages/agentsam-knowledge/package.json +15 -0
  128. package/packages/agentsam-knowledge/src/autorag/index.js +64 -0
  129. package/packages/agentsam-knowledge/src/backends/index.js +26 -0
  130. package/packages/agentsam-knowledge/src/index.js +3 -0
  131. package/packages/agentsam-knowledge/src/providers/index.js +95 -0
  132. package/packages/agentsam-knowledge/test/autorag.test.mjs +42 -0
  133. package/packages/agentsam-nav/README.md +40 -0
  134. package/packages/agentsam-nav/dist/Nav.d.ts +43 -0
  135. package/packages/agentsam-nav/dist/NavCollapsible.d.ts +10 -0
  136. package/packages/agentsam-nav/dist/NavContent.d.ts +2 -0
  137. package/packages/agentsam-nav/dist/NavFooter.d.ts +2 -0
  138. package/packages/agentsam-nav/dist/NavGroup.d.ts +3 -0
  139. package/packages/agentsam-nav/dist/NavHeader.d.ts +2 -0
  140. package/packages/agentsam-nav/dist/NavMenu.d.ts +22 -0
  141. package/packages/agentsam-nav/dist/NavProvider.d.ts +35 -0
  142. package/packages/agentsam-nav/dist/NavTrigger.d.ts +2 -0
  143. package/packages/agentsam-nav/dist/Surfaces.d.ts +41 -0
  144. package/packages/agentsam-nav/dist/browser.d.ts +11 -0
  145. package/packages/agentsam-nav/dist/browser.global.js +132 -0
  146. package/packages/agentsam-nav/dist/browser.js +613 -0
  147. package/packages/agentsam-nav/dist/contracts.d.ts +76 -0
  148. package/packages/agentsam-nav/dist/index.d.ts +11 -0
  149. package/packages/agentsam-nav/dist/index.js +614 -0
  150. package/packages/agentsam-nav/dist/legacy.css +83 -0
  151. package/packages/agentsam-nav/dist/shell.css +113 -0
  152. package/packages/agentsam-nav/dist/theme.css +113 -0
  153. package/packages/agentsam-nav/dist/utils.d.ts +1 -0
  154. package/packages/agentsam-nav/package.json +43 -0
  155. package/packages/agentsam-queue-control/README.md +107 -0
  156. package/packages/agentsam-queue-control/package.json +31 -0
  157. package/packages/agentsam-queue-control/schemas/job-envelope.schema.json +56 -0
  158. package/packages/agentsam-queue-control/src/adapters/cloudflare.js +152 -0
  159. package/packages/agentsam-queue-control/src/adapters/memory.js +38 -0
  160. package/packages/agentsam-queue-control/src/contracts.js +130 -0
  161. package/packages/agentsam-queue-control/src/control-plane.js +141 -0
  162. package/packages/agentsam-queue-control/src/dispatch.js +43 -0
  163. package/packages/agentsam-queue-control/src/index.js +7 -0
  164. package/packages/agentsam-queue-control/src/policy.js +88 -0
  165. package/packages/agentsam-queue-control/src/topology.js +66 -0
  166. package/packages/agentsam-queue-control/test/queue-control.test.mjs +100 -0
  167. package/packages/agentsam-repository/src/goap.js +718 -0
  168. package/packages/agentsam-repository/src/goap.js.bak-20260922011251 +670 -0
  169. package/packages/agentsam-repository/src/index.js +5 -0
  170. package/packages/agentsam-repository/src/merkle/cloudflare-persistence.js +2 -2
  171. package/packages/agentsam-repository/src/tickets.js +184 -0
  172. package/packages/agentsam-repository/src/work-tracking.js +199 -0
  173. package/packages/agentsam-repository/src/workspace-state.js +176 -0
  174. package/packages/agentsam-repository/test/goap-tickets-workspace-state.test.mjs +152 -0
  175. package/packages/connectors/cloudflare/src/index.js +297 -15
  176. package/packages/connectors/cloudflare/src/owner.js +43 -40
  177. package/packages/connectors/cloudflare/src/routes.js +167 -26
  178. package/packages/connectors/cloudflare/tests/connector.test.mjs +112 -2
  179. package/packages/heuristic-theme/README.md +11 -0
  180. package/packages/heuristic-theme/package.json +25 -0
  181. package/packages/heuristic-theme/src/index.js +2 -0
  182. package/packages/heuristic-theme/src/registry.js +36 -0
  183. package/packages/heuristic-theme/src/theme.js +41 -0
  184. package/packages/heuristic-theme/test/theme.test.mjs +26 -0
  185. package/packages/identity/.agentsam/features/oauth-login-portal/agentsam.feature.json +64 -0
  186. package/packages/identity/.agentsam/features/oauth-login-portal/providers.json +96 -0
  187. package/packages/identity/.agentsam/features/oauth-login-portal/resources.json +47 -0
  188. package/packages/identity/.agentsam/features/oauth-login-portal/routes.json +74 -0
  189. package/packages/identity/.agentsam/features/oauth-login-portal/ui.json +35 -0
  190. package/packages/identity/package.json +3 -2
  191. package/packages/identity/src/adapters/cloudflare-d1/ids.js +4 -0
  192. package/packages/identity/src/adapters/cloudflare-d1/index.js +39 -1
  193. package/packages/identity/src/contracts/provider.js +3 -2
  194. package/packages/identity/src/frontend/auth-portal/pages/login.html +7 -0
  195. package/packages/identity/src/index.js +2 -0
  196. package/packages/identity/src/oauth/credentials.js +13 -0
  197. package/packages/identity/src/oauth/iam-platform.js +5 -5
  198. package/packages/identity/src/providers/cloudflare/index.js +19 -0
  199. package/packages/identity/src/providers/cloudflare/mapper.js +21 -0
  200. package/packages/identity/src/providers/cloudflare/oauth.js +48 -0
  201. package/packages/identity/src/providers/cloudflare/profile.js +28 -0
  202. package/packages/identity/src/providers/index.js +18 -2
  203. package/packages/identity/src/server/identity-service.js +13 -3
  204. package/packages/identity/src/server/worker-router.js +63 -8
  205. package/packages/identity/tests/identity-service.test.mjs +15 -0
  206. package/packages/providers/completeful/README.md +38 -0
  207. package/packages/providers/completeful/package.json +29 -0
  208. package/packages/providers/completeful/src/client.js +162 -0
  209. package/packages/providers/completeful/src/events.js +49 -0
  210. package/packages/providers/completeful/src/index.js +22 -0
  211. package/packages/providers/completeful/src/tools.js +579 -0
  212. package/packages/providers/completeful/src/webhooks.js +55 -0
  213. package/packages/providers/completeful/test/provider.test.mjs +196 -0
  214. package/packages/theme-church-site/README.md +10 -0
  215. package/packages/theme-church-site/package.json +30 -0
  216. package/packages/theme-church-site/src/harvest.json +14 -0
  217. package/packages/theme-church-site/src/index.js +84 -0
  218. package/packages/theme-church-site/test/theme.test.mjs +19 -0
  219. package/packages/theme-companions-site/README.md +10 -0
  220. package/packages/theme-companions-site/package.json +30 -0
  221. package/packages/theme-companions-site/src/harvest.json +12 -0
  222. package/packages/theme-companions-site/src/index.js +82 -0
  223. package/packages/theme-companions-site/test/theme.test.mjs +19 -0
  224. package/packages/theme-floors-site/README.md +10 -0
  225. package/packages/theme-floors-site/package.json +30 -0
  226. package/packages/theme-floors-site/src/harvest.json +14 -0
  227. package/packages/theme-floors-site/src/index.js +82 -0
  228. package/packages/theme-floors-site/test/theme.test.mjs +19 -0
  229. package/packages/theme-fuelnfree-site/README.md +10 -0
  230. package/packages/theme-fuelnfree-site/package.json +30 -0
  231. package/packages/theme-fuelnfree-site/src/harvest.json +13 -0
  232. package/packages/theme-fuelnfree-site/src/index.js +81 -0
  233. package/packages/theme-fuelnfree-site/test/theme.test.mjs +19 -0
  234. package/packages/theme-handyman-site/README.md +10 -0
  235. package/packages/theme-handyman-site/package.json +30 -0
  236. package/packages/theme-handyman-site/src/harvest.json +10 -0
  237. package/packages/theme-handyman-site/src/index.js +83 -0
  238. package/packages/theme-handyman-site/test/theme.test.mjs +19 -0
  239. package/packages/theme-insurance-site/README.md +10 -0
  240. package/packages/theme-insurance-site/package.json +30 -0
  241. package/packages/theme-insurance-site/src/harvest.json +10 -0
  242. package/packages/theme-insurance-site/src/index.js +83 -0
  243. package/packages/theme-insurance-site/test/theme.test.mjs +19 -0
  244. package/packages/theme-shinshu-site/README.md +10 -0
  245. package/packages/theme-shinshu-site/package.json +30 -0
  246. package/packages/theme-shinshu-site/src/harvest.json +12 -0
  247. package/packages/theme-shinshu-site/src/index.js +83 -0
  248. package/packages/theme-shinshu-site/test/theme.test.mjs +19 -0
  249. package/packages/work-graph/README.md +49 -0
  250. package/packages/work-graph/package.json +19 -0
  251. package/packages/work-graph/prototype/README.md +32 -0
  252. package/packages/work-graph/prototype/data/demo-workgraph.js +47 -0
  253. package/packages/work-graph/prototype/renderers/timeline-model.js +21 -0
  254. package/packages/work-graph/prototype/renderers/workgraph-runtime.js +38 -0
  255. package/packages/work-graph/prototype-gnantt.html +655 -0
  256. package/packages/work-graph/src/adapters/business/projects.js +23 -0
  257. package/packages/work-graph/src/adapters/engineering/git.js +22 -0
  258. package/packages/work-graph/src/adapters/engineering/mcp.js +22 -0
  259. package/packages/work-graph/src/index.js +76 -0
  260. package/packages/work-graph/src/renderers/gantt-model.js +11 -0
  261. package/packages/work-graph/src/renderers/timeline.js +16 -0
  262. package/packages/work-graph/test/work-graph.test.mjs +37 -0
  263. package/protocol/README.md +12 -0
  264. package/protocol/capabilities/cloudflare-cpu-audit-input.schema.json +30 -6
  265. package/protocol/capabilities/cloudflare-cpu-profile-input.schema.json +18 -4
  266. package/protocol/capabilities/cloudflare-wrangler-native-input.schema.json +59 -10
  267. package/protocol/capabilities/knowledge-search-input.schema.json +35 -0
  268. package/protocol/capabilities/manifest.json +163 -1
  269. package/protocol/capabilities/repository-audit-input.schema.json +39 -6
  270. package/protocol/capabilities/repository-snapshot-input.schema.json +15 -3
  271. package/protocol/capabilities/terminal-exec-input.schema.json +55 -0
  272. package/protocol/commerce/catalog.v1.json +50 -0
  273. package/protocol/errors/error-catalog.json +164 -0
  274. package/protocol/errors/error-envelope.schema.json +544 -0
  275. package/protocol/features/README.md +57 -0
  276. package/protocol/features/agentsam.feature.v1.schema.json +290 -0
  277. package/protocol/features/catalog.json +65 -0
  278. package/protocol/features/examples/provider-resend.feature.json +17 -0
  279. package/protocol/go/agentsam-go-runtime.v1.json +17 -0
  280. package/protocol/knowledge/LIFECYCLE.md +140 -0
  281. package/protocol/knowledge/README.md +4 -0
  282. package/protocol/presets/catalog.json +128 -19
  283. package/protocol/rpc/v1/errors.proto +24 -0
  284. package/protocol/theme-refinery/d1-reconciliation.md +48 -0
  285. package/protocol/theme-refinery/product-metadata.schema.json +27 -0
  286. package/protocol/theme-refinery/receipts/products-registry-batch-20260924.json +318 -0
  287. package/protocol/theme-refinery/receipts/theme-harvest-20260924.json +472 -0
  288. package/protocol/theme-refinery/reconciliation-receipt.schema.json +83 -0
  289. package/services/cad/server.py +249 -2
  290. package/src/agent/capability-adapter.js +15 -5
  291. package/src/agent/index.js +2 -1
  292. package/src/agent/model-turn.js +51 -0
  293. package/src/agent/responses-runner.js +304 -38
  294. package/src/capabilities/index.js +1 -0
  295. package/src/capabilities/terminal-exec.js +78 -0
  296. package/src/cli.js +117 -9
  297. package/src/cloudflare/index.js +6 -0
  298. package/src/cloudflare/runtime-status.js +393 -0
  299. package/src/cloudflare/wrangler.js +17 -1
  300. package/src/commands/app.js +106 -0
  301. package/src/commands/autorag.js +77 -0
  302. package/src/commands/brand.js +293 -0
  303. package/src/commands/cad.js +1 -0
  304. package/src/commands/connections.js +126 -29
  305. package/src/commands/context-economics.js +8 -0
  306. package/src/commands/db.js +7 -0
  307. package/src/commands/env.js +5 -4
  308. package/src/commands/eval.js +209 -14
  309. package/src/commands/go.js +365 -0
  310. package/src/commands/goap.js +176 -0
  311. package/src/commands/identity-init.js +27 -3
  312. package/src/commands/identity-protocol.js +195 -0
  313. package/src/commands/knowledge.js +64 -5
  314. package/src/commands/mcp.js +341 -0
  315. package/src/commands/merkle-persist.js +3 -1
  316. package/src/commands/merkle.js +18 -3
  317. package/src/commands/models.js +109 -23
  318. package/src/commands/plugins.js +175 -0
  319. package/src/commands/preferences.js +28 -8
  320. package/src/commands/product.js +53 -10
  321. package/src/commands/providers.js +118 -37
  322. package/src/commands/resume.js +9 -5
  323. package/src/commands/runtime-status.js +154 -0
  324. package/src/commands/shell.js +466 -55
  325. package/src/commands/status.js +82 -7
  326. package/src/commands/tunnel.js +228 -195
  327. package/src/commands/whoami.js +78 -6
  328. package/src/context/budget.js +6 -0
  329. package/src/context/index.js +2 -1
  330. package/src/context/project-card.js +75 -0
  331. package/src/errors/contract.js +34 -211
  332. package/src/errors/diagnostic.js +95 -51
  333. package/src/errors/index.js +6 -13
  334. package/src/eval/index.js +6 -0
  335. package/src/eval/live.js +439 -0
  336. package/src/features/resolve.js +242 -0
  337. package/src/go/build.js +108 -0
  338. package/src/go/cloudflare.js +207 -0
  339. package/src/go/contract.js +139 -0
  340. package/src/go/discover.js +96 -0
  341. package/src/go/index.js +13 -0
  342. package/src/go/receipts.js +77 -0
  343. package/src/go/registry.js +223 -0
  344. package/src/go/verify.js +31 -0
  345. package/src/index.js +100 -1
  346. package/src/knowledge/config.js +13 -5
  347. package/src/knowledge/engine.js +23 -8
  348. package/src/knowledge/index.js +1 -0
  349. package/src/knowledge/lane-registry.js +46 -0
  350. package/src/knowledge/providers/gemini.js +48 -8
  351. package/src/knowledge/service/client.js +13 -1
  352. package/src/knowledge/service/grpc-codec.js +156 -53
  353. package/src/knowledge/service/job-engine.js +133 -11
  354. package/src/knowledge/service/job-worker.js +34 -5
  355. package/src/knowledge/service/server.js +10 -1
  356. package/src/knowledge/store-discovery.js +77 -0
  357. package/src/lib/account-session.js +8 -2
  358. package/src/lib/agent-instructions.js +3 -0
  359. package/src/lib/auth.js +7 -3
  360. package/src/lib/cad/blender.js +42 -3
  361. package/src/lib/cad/d1-project-store.js +43 -0
  362. package/src/lib/cad/discovery.js +616 -0
  363. package/src/lib/cad/docker-executor.js +352 -0
  364. package/src/lib/cad/freecad.js +253 -0
  365. package/src/lib/cad/index.js +40 -0
  366. package/src/lib/cad/openscad.js +198 -0
  367. package/src/lib/cad/project-cli.d.ts +2 -0
  368. package/src/lib/cad/project-cli.js +21 -0
  369. package/src/lib/cad/project-contract.d.ts +3 -0
  370. package/src/lib/cad/project-contract.js +1 -0
  371. package/src/lib/cad/project-recipe.js +30 -0
  372. package/src/lib/cad/project-runtime.d.ts +2 -0
  373. package/src/lib/cad/project-runtime.js +53 -0
  374. package/src/lib/cad/project-store.js +25 -0
  375. package/src/lib/cad/project-workflows.js +31 -0
  376. package/src/lib/cad-docker.js +21 -2
  377. package/src/lib/cli-preferences.js +17 -2
  378. package/src/lib/core-client.js +37 -18
  379. package/src/lib/deploy/local-studio.js +6 -5
  380. package/src/lib/dockerize.js +3 -0
  381. package/src/lib/execution-approvals.js +1 -0
  382. package/src/lib/identity-scaffold.js +4 -1
  383. package/src/lib/knowledge-docker.js +9 -1
  384. package/src/lib/local-sessions.js +124 -34
  385. package/src/lib/local-status.js +35 -14
  386. package/src/lib/project-config.js +9 -0
  387. package/src/lib/provider-credentials.js +73 -11
  388. package/src/lib/scaffold/resolve-cloudflare-account.js +37 -0
  389. package/src/lib/scaffold/wizards/cms.js +2 -8
  390. package/src/lib/scaffold/wizards/worker-api.js +2 -8
  391. package/src/lib/slash-commands.js +9 -2
  392. package/src/local/migrations.js +109 -1
  393. package/src/local/runtime-store.js +31 -5
  394. package/src/local/sqlite.js +36 -1
  395. package/src/mcp/authority.js +348 -0
  396. package/src/mcp/client-adapters.js +431 -0
  397. package/src/mcp/client.js +172 -0
  398. package/src/mcp/index.js +47 -0
  399. package/src/mcp/telemetry.js +103 -0
  400. package/src/models/catalog.js +329 -51
  401. package/src/models/discovery.js +24 -4
  402. package/src/models/index.js +2 -0
  403. package/src/models/inventory-core.js +182 -0
  404. package/src/models/policy.js +20 -0
  405. package/src/plugins/cloudflare.js +103 -0
  406. package/src/plugins/completeful.js +69 -0
  407. package/src/plugins/contracts.js +86 -0
  408. package/src/plugins/index.js +11 -0
  409. package/src/plugins/registry.js +207 -0
  410. package/src/plugins/resource-scope.js +45 -0
  411. package/src/plugins/runtime.js +118 -0
  412. package/src/plugins/vectorize.js +31 -0
  413. package/src/progression/engine.js +171 -0
  414. package/src/progression/index.js +1 -0
  415. package/src/providers/cloudflare-chat.js +1 -1
  416. package/src/providers/gemini-generate-content.js +2 -1
  417. package/src/providers/openai-responses.js +45 -16
  418. package/src/providers/tool-schema.js +85 -0
  419. package/src/repository/index.js +29 -0
  420. package/src/rpc/generated/errors_pb.js +961 -1
  421. package/src/security/local-vault.js +415 -0
  422. package/src/security/process.js +20 -4
  423. package/src/status/actions.js +192 -0
  424. package/src/tools/hydrate.js +5 -1
  425. package/src/tools/index.js +7 -0
  426. package/src/tools/redact.js +64 -0
  427. package/src/tools/registry.js +83 -0
  428. package/src/tools/runtime.js +257 -0
  429. package/src/tools/search.js +21 -8
  430. package/src/ui/ansi.js +117 -3
  431. package/src/ui/cli/activity.js +76 -7
  432. package/src/ui/cli/footer.js +110 -9
  433. package/src/ui/cli/help.js +11 -4
  434. package/src/ui/wireframes.js +166 -0
  435. package/test/account-session.test.mjs +28 -0
  436. package/test/apps-scaffold-contract.test.mjs +16 -1
  437. package/test/capabilities.test.mjs +1 -1
  438. package/test/cli/eval-live.test.mjs +219 -0
  439. package/test/cli/go.test.mjs +71 -0
  440. package/test/cli/local-vault-and-provider-setup.test.mjs +268 -0
  441. package/test/cli/mcp-client.test.mjs +245 -0
  442. package/test/cli/runtime-ui.test.mjs +69 -2
  443. package/test/cli/status-actions.test.mjs +88 -0
  444. package/test/cli/wireframes-go-registry.test.mjs +54 -0
  445. package/test/cloudflare-connector.test.mjs +3 -6
  446. package/test/cloudflare-runtime.test.mjs +8 -1
  447. package/test/context.test.mjs +15 -0
  448. package/test/error-diagnostics.test.mjs +9 -0
  449. package/test/fixtures/cad/courtyard-house.json +208 -0
  450. package/test/go/cloudflare-probe.test.mjs +53 -0
  451. package/test/integration/app-command.test.mjs +55 -0
  452. package/test/integration/cad-discovery.test.mjs +158 -0
  453. package/test/integration/cad-docker-executor.test.mjs +249 -0
  454. package/test/integration/cad-execution.test.mjs +184 -0
  455. package/test/integration/cad-project-app.test.mjs +31 -0
  456. package/test/integration/cad-project-d1.test.mjs +25 -0
  457. package/test/integration/cad-project-native.test.mjs +24 -0
  458. package/test/integration/cad-project-workflow.test.mjs +9 -0
  459. package/test/integration/cad-project.test.mjs +82 -0
  460. package/test/integration/cli-help.test.mjs +4 -0
  461. package/test/integration/cms-site-tenancy-contract.test.mjs +256 -0
  462. package/test/integration/core-client.integration.test.mjs +55 -0
  463. package/test/integration/error-runtime-rpc.test.mjs +71 -0
  464. package/test/integration/features-resolve.test.mjs +128 -0
  465. package/test/integration/install-script.test.mjs +107 -0
  466. package/test/integration/inventory-core.test.mjs +53 -0
  467. package/test/integration/plugins-cloudflare.integration.test.mjs +28 -0
  468. package/test/integration/provider-env-cli.test.mjs +1 -1
  469. package/test/integration/runtime-migrations.test.mjs +6 -1
  470. package/test/integration/runtime-status.integration.test.mjs +211 -0
  471. package/test/integration/scaffold-cloudflare.test.mjs +46 -0
  472. package/test/integration/storage-architecture.test.mjs +154 -0
  473. package/test/integration/store-discovery.test.mjs +44 -0
  474. package/test/integration/terminal-exec.integration.test.mjs +86 -0
  475. package/test/integration/tool-runtime.test.mjs +124 -0
  476. package/test/integration/tool-schema.test.mjs +59 -0
  477. package/test/knowledge-service.test.mjs +4 -0
  478. package/test/local-sessions.test.mjs +11 -2
  479. package/test/local-studio-deploy.test.mjs +1 -1
  480. package/test/model-catalog.test.mjs +28 -1
  481. package/test/models.test.mjs +159 -5
  482. package/test/openai-responses.test.mjs +60 -0
  483. package/test/provider-credentials.test.mjs +15 -5
  484. package/test/responses-runner.test.mjs +321 -6
  485. package/test/shell.test.mjs +149 -4
  486. package/test/smoke.mjs +2 -2
  487. package/test/tools-search.test.mjs +33 -0
  488. package/test/unit/website-assets-bindings.test.mjs +60 -0
  489. package/test/whoami-resume.test.mjs +82 -3
  490. package/examples/gorilla-shell/README.md +0 -15
  491. package/src/lib/gorilla-template.js +0 -54
  492. package/templates/gorilla-shell/App.tsx +0 -639
  493. package/templates/gorilla-shell/README.md +0 -34
  494. package/templates/gorilla-shell/index.html +0 -15
  495. package/templates/gorilla-shell/main.jsx +0 -9
  496. package/templates/gorilla-shell/package.json +0 -19
  497. package/templates/gorilla-shell/vite.config.js +0 -21
@@ -0,0 +1,103 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { homeDirectory } from './authority.js';
4
+
5
+ export function getTelemetrySessionPath(options = {}) {
6
+ const home = homeDirectory(options);
7
+ return path.join(home, '.agentsam', 'telemetry', 'session-receipts.json');
8
+ }
9
+
10
+ export function recordToolReceipt(receipt = {}, options = {}) {
11
+ const filePath = getTelemetrySessionPath(options);
12
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
13
+
14
+ let existing = [];
15
+ try {
16
+ if (fs.existsSync(filePath)) {
17
+ existing = JSON.parse(fs.readFileSync(filePath, 'utf8'));
18
+ if (!Array.isArray(existing)) existing = [];
19
+ }
20
+ } catch {
21
+ existing = [];
22
+ }
23
+
24
+ const normalized = {
25
+ id: receipt.id || `tcl_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
26
+ agent_run_id: receipt.agent_run_id || null,
27
+ conversation_id: receipt.conversation_id || null,
28
+ tool_key: String(receipt.tool_key || receipt.tool || receipt.name || 'unknown'),
29
+ source_client: receipt.source_client || 'agentsam',
30
+ status: receipt.status || (receipt.error ? 'failure' : 'success'),
31
+ duration_ms: Number(receipt.duration_ms ?? receipt.latency_ms ?? 0),
32
+ error_code: receipt.error_code || (receipt.error ? 'EXECUTION_ERROR' : null),
33
+ failure_origin: receipt.failure_origin || null,
34
+ created_at: receipt.created_at || new Date().toISOString(),
35
+ };
36
+
37
+ existing.push(normalized);
38
+ fs.writeFileSync(filePath, JSON.stringify(existing, null, 2), 'utf8');
39
+ return normalized;
40
+ }
41
+
42
+ export function getSessionToolReceipts(options = {}) {
43
+ const filePath = getTelemetrySessionPath(options);
44
+ try {
45
+ if (!fs.existsSync(filePath)) return [];
46
+ const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
47
+ return Array.isArray(data) ? data : [];
48
+ } catch {
49
+ return [];
50
+ }
51
+ }
52
+
53
+ export function clearSessionToolReceipts(options = {}) {
54
+ const filePath = getTelemetrySessionPath(options);
55
+ try {
56
+ if (fs.existsSync(filePath)) {
57
+ fs.unlinkSync(filePath);
58
+ return true;
59
+ }
60
+ return false;
61
+ } catch {
62
+ return false;
63
+ }
64
+ }
65
+
66
+ export function summarizeToolReceipts(receipts = []) {
67
+ let toolCallCount = 0;
68
+ let mcpCallCount = 0;
69
+ let terminalCallCount = 0;
70
+ let githubCallCount = 0;
71
+ let d1CallCount = 0;
72
+ let failureCount = 0;
73
+
74
+ for (const r of receipts) {
75
+ toolCallCount += 1;
76
+ const key = (r.tool_key || '').toLowerCase();
77
+ if (key.startsWith('mcp:') || key.includes('mcp') || r.source_client === 'cursor_mcp') {
78
+ mcpCallCount += 1;
79
+ }
80
+ if (key.includes('terminal') || key.includes('bash') || key.includes('shell')) {
81
+ terminalCallCount += 1;
82
+ }
83
+ if (key.includes('github') || key.includes('gh_') || key.includes('git')) {
84
+ githubCallCount += 1;
85
+ }
86
+ if (key.includes('d1') || key.includes('sqlite') || key.includes('database')) {
87
+ d1CallCount += 1;
88
+ }
89
+ if (r.status === 'failure' || r.error_code) {
90
+ failureCount += 1;
91
+ }
92
+ }
93
+
94
+ return {
95
+ tool_call_count: toolCallCount,
96
+ mcp_call_count: mcpCallCount,
97
+ terminal_call_count: terminalCallCount,
98
+ github_call_count: githubCallCount,
99
+ d1_call_count: d1CallCount,
100
+ failure_count: failureCount,
101
+ success_count: toolCallCount - failureCount,
102
+ };
103
+ }
@@ -1,68 +1,305 @@
1
1
  export const MODEL_CATALOG_SCHEMA = 'agentsam-model-catalog-v1';
2
2
 
3
- const ASTRA_SOURCE = 'https://developers.openai.com/api/docs/models/gpt-6-astra';
3
+ const DOCS = Object.freeze({
4
+ gpt6Astra: 'https://developers.openai.com/api/docs/models/gpt-6-astra',
5
+ gpt6Sol: 'https://developers.openai.com/api/docs/models/gpt-6-sol',
6
+ gpt6Luna: 'https://developers.openai.com/api/docs/models/gpt-6-luna',
7
+ gpt56Sol: 'https://developers.openai.com/api/docs/models/gpt-5.6-sol',
8
+ gpt56Terra: 'https://developers.openai.com/api/docs/models/gpt-5.6-terra',
9
+ gpt56Luna: 'https://developers.openai.com/api/docs/models/gpt-5.6-luna',
10
+ gpt53Codex: 'https://developers.openai.com/api/docs/models/gpt-5.3-codex',
11
+ embeddingLarge: 'https://developers.openai.com/api/docs/models/text-embedding-3-large',
12
+ embeddingSmall: 'https://developers.openai.com/api/docs/models/text-embedding-3-small',
13
+ });
4
14
 
5
- const GPT_6_ASTRA = Object.freeze({
6
- schema_version: 1,
7
- model_key: 'openai:gpt-6-astra',
8
- provider: 'openai',
9
- provider_model_id: 'gpt-6-astra',
10
- label: 'GPT-6 Astra',
11
- context_window: 1_050_000,
12
- max_output_tokens: 128_000,
13
- reasoning_efforts: Object.freeze(['low', 'medium', 'high', 'xhigh', 'max']),
14
- service_tiers: Object.freeze(['default', 'fast', 'flex']),
15
- capabilities: Object.freeze({
16
- responses: true,
17
- streaming: true,
18
- function_calling: true,
19
- structured_outputs: true,
20
- prompt_caching: true,
21
- compaction: true,
22
- tool_search: true,
23
- async_tool_calls: true,
24
- mid_turn_steering: true,
25
- configuration_update: true,
26
- batch: true,
27
- fast: true,
28
- flex: true,
29
- }),
30
- pricing: Object.freeze({
15
+ const LONG_CONTEXT_POLICY = Object.freeze({
16
+ target_input_tokens: 120_000,
17
+ compact_at_tokens: 180_000,
18
+ intervene_at_tokens: 220_000,
19
+ max_normal_input_tokens: 250_000,
20
+ pricing_threshold_tokens: 272_000,
21
+ max_cumulative_input_tokens: 544_000,
22
+ safety_margin_tokens: 22_000,
23
+ });
24
+
25
+ const FULL_RESPONSES_TOOLS = Object.freeze({
26
+ web_search: true,
27
+ file_search: true,
28
+ image_generation: true,
29
+ code_interpreter: true,
30
+ hosted_shell: true,
31
+ apply_patch: true,
32
+ skills: true,
33
+ computer_use: true,
34
+ mcp: true,
35
+ tool_search: true,
36
+ });
37
+
38
+ const STANDARD_AGENT_CAPABILITIES = Object.freeze({
39
+ agent_runtime: true,
40
+ responses: true,
41
+ streaming: true,
42
+ function_calling: true,
43
+ structured_outputs: true,
44
+ prompt_caching: true,
45
+ compaction: true,
46
+ batch: true,
47
+ fast: true,
48
+ flex: true,
49
+ ...FULL_RESPONSES_TOOLS,
50
+ });
51
+
52
+ function freezePricing({ input, cachedInput, cacheWrite, output, source, longContext = true, processing = true }) {
53
+ return Object.freeze({
31
54
  currency: 'USD',
32
55
  unit: 'per_million_tokens',
33
- input: 10,
34
- cached_input: 1,
35
- cache_write: 12.5,
36
- output: 50,
37
- thresholds: Object.freeze([
56
+ input,
57
+ cached_input: cachedInput,
58
+ cache_write: cacheWrite,
59
+ output,
60
+ thresholds: Object.freeze(longContext ? [
38
61
  Object.freeze({
39
62
  input_tokens_gt: 272_000,
40
63
  applies_to_full_request: true,
41
64
  multipliers: Object.freeze({ input: 2, cached_input: 2, cache_write: 2, output: 1.5 }),
42
65
  }),
43
- ]),
44
- service_tier_multipliers: Object.freeze({ default: 1, fast: 2, flex: 0.5, batch: 0.5 }),
45
- source: ASTRA_SOURCE,
46
- as_of: '2026-09-12',
47
- }),
48
- context_policy: Object.freeze({
49
- target_input_tokens: 120_000,
50
- compact_at_tokens: 180_000,
51
- intervene_at_tokens: 220_000,
52
- max_normal_input_tokens: 250_000,
53
- pricing_threshold_tokens: 272_000,
54
- safety_margin_tokens: 22_000,
66
+ ] : []),
67
+ service_tier_multipliers: Object.freeze(processing
68
+ ? { default: 1, fast: 2, flex: 0.5, batch: 0.5 }
69
+ : { default: 1 }),
70
+ source,
71
+ as_of: '2026-09-23',
72
+ });
73
+ }
74
+
75
+ function openAiAgentModel({
76
+ id,
77
+ label,
78
+ source,
79
+ reasoning,
80
+ contextWindow,
81
+ maxOutputTokens,
82
+ knowledgeCutoff,
83
+ description,
84
+ pricing,
85
+ capabilities = {},
86
+ serviceTiers = ['default', 'fast', 'flex'],
87
+ contextPolicy = LONG_CONTEXT_POLICY,
88
+ }) {
89
+ return Object.freeze({
90
+ schema_version: 1,
91
+ model_key: 'openai:' + id,
92
+ provider: 'openai',
93
+ provider_model_id: id,
94
+ label,
95
+ kind: 'language',
96
+ description,
97
+ context_window: contextWindow,
98
+ max_output_tokens: maxOutputTokens,
99
+ knowledge_cutoff: knowledgeCutoff,
100
+ reasoning_efforts: Object.freeze([...reasoning]),
101
+ default_reasoning_effort: reasoning.includes('medium') ? 'medium' : reasoning[0],
102
+ service_tiers: Object.freeze([...serviceTiers]),
103
+ capabilities: Object.freeze({ ...STANDARD_AGENT_CAPABILITIES, ...capabilities }),
104
+ pricing,
105
+ context_policy: contextPolicy,
106
+ batch: Object.freeze({
107
+ supported: true,
108
+ completion_window: '24h',
109
+ relative_price: 0.5,
110
+ interactive: false,
111
+ }),
112
+ source: Object.freeze({ url: source, as_of: '2026-09-23' }),
113
+ });
114
+ }
115
+
116
+ function openAiEmbeddingModel({ id, label, source, dimensions, price }) {
117
+ return Object.freeze({
118
+ schema_version: 1,
119
+ model_key: 'openai:' + id,
120
+ provider: 'openai',
121
+ provider_model_id: id,
122
+ label,
123
+ kind: 'embedding',
124
+ description: 'Text embedding model for semantic search and retrieval.',
125
+ context_window: 8_192,
126
+ max_output_tokens: null,
127
+ knowledge_cutoff: null,
128
+ reasoning_efforts: Object.freeze([]),
129
+ default_reasoning_effort: null,
130
+ service_tiers: Object.freeze(['default']),
131
+ capabilities: Object.freeze({
132
+ agent_runtime: false,
133
+ responses: false,
134
+ function_calling: false,
135
+ embeddings: true,
136
+ configurable_dimensions: true,
137
+ }),
138
+ pricing: freezePricing({
139
+ input: price,
140
+ cachedInput: 0,
141
+ cacheWrite: 0,
142
+ output: 0,
143
+ source,
144
+ longContext: false,
145
+ processing: false,
146
+ }),
147
+ context_policy: null,
148
+ batch: Object.freeze({ supported: true, completion_window: '24h', relative_price: 0.5, interactive: false }),
149
+ source: Object.freeze({ url: source, as_of: '2026-09-23' }),
150
+ metadata: Object.freeze({ default_dimensions: dimensions, max_input_tokens: 8_192 }),
151
+ });
152
+ }
153
+
154
+ const GPT_6_ASTRA = openAiAgentModel({
155
+ id: 'gpt-6-astra',
156
+ label: 'GPT-6 Astra',
157
+ source: DOCS.gpt6Astra,
158
+ reasoning: ['low', 'medium', 'high', 'xhigh', 'max'],
159
+ contextWindow: 1_050_000,
160
+ maxOutputTokens: 128_000,
161
+ knowledgeCutoff: '2026-04-30',
162
+ description: 'Highest-capability GPT-6 tier for the hardest end-to-end work.',
163
+ pricing: freezePricing({ input: 10, cachedInput: 1, cacheWrite: 12.5, output: 50, source: DOCS.gpt6Astra }),
164
+ capabilities: { async_tool_calls: true, mid_turn_steering: true, configuration_update: true },
165
+ });
166
+
167
+ const GPT_6_SOL = openAiAgentModel({
168
+ id: 'gpt-6-sol',
169
+ label: 'GPT-6 Sol',
170
+ source: DOCS.gpt6Sol,
171
+ reasoning: ['none', 'low', 'medium', 'high', 'xhigh', 'max'],
172
+ contextWindow: 1_050_000,
173
+ maxOutputTokens: 128_000,
174
+ knowledgeCutoff: '2026-04-20',
175
+ description: 'GPT-6 tier for complex coding and agentic workflows.',
176
+ pricing: freezePricing({ input: 2, cachedInput: 0.2, cacheWrite: 2.5, output: 10, source: DOCS.gpt6Sol }),
177
+ capabilities: { async_tool_calls: true, mid_turn_steering: true, configuration_update: true },
178
+ });
179
+
180
+ const GPT_6_LUNA = openAiAgentModel({
181
+ id: 'gpt-6-luna',
182
+ label: 'GPT-6 Luna',
183
+ source: DOCS.gpt6Luna,
184
+ reasoning: ['none', 'low', 'medium', 'high', 'xhigh', 'max'],
185
+ contextWindow: 1_050_000,
186
+ maxOutputTokens: 128_000,
187
+ knowledgeCutoff: '2026-05-18',
188
+ description: 'Most efficient GPT-6 tier for focused, high-volume tasks.',
189
+ pricing: freezePricing({ input: 0.1, cachedInput: 0.01, cacheWrite: 0.125, output: 0.5, source: DOCS.gpt6Luna }),
190
+ capabilities: { async_tool_calls: true, mid_turn_steering: true, configuration_update: true },
191
+ });
192
+
193
+ const GPT_56_SOL = openAiAgentModel({
194
+ id: 'gpt-5.6-sol',
195
+ label: 'GPT-5.6 Sol',
196
+ source: DOCS.gpt56Sol,
197
+ reasoning: ['none', 'low', 'medium', 'high', 'xhigh', 'max'],
198
+ contextWindow: 1_050_000,
199
+ maxOutputTokens: 128_000,
200
+ knowledgeCutoff: '2026-02-16',
201
+ description: 'Flagship GPT-5.6 model for complex professional work.',
202
+ pricing: freezePricing({ input: 4, cachedInput: 0.4, cacheWrite: 5, output: 20, source: DOCS.gpt56Sol }),
203
+ });
204
+
205
+ const GPT_56_TERRA = openAiAgentModel({
206
+ id: 'gpt-5.6-terra',
207
+ label: 'GPT-5.6 Terra',
208
+ source: DOCS.gpt56Terra,
209
+ reasoning: ['none', 'low', 'medium', 'high', 'xhigh', 'max'],
210
+ contextWindow: 1_050_000,
211
+ maxOutputTokens: 128_000,
212
+ knowledgeCutoff: '2026-02-16',
213
+ description: 'GPT-5.6 tier balancing intelligence and cost.',
214
+ pricing: freezePricing({ input: 2, cachedInput: 0.2, cacheWrite: 2.5, output: 12, source: DOCS.gpt56Terra }),
215
+ });
216
+
217
+ const GPT_56_LUNA = openAiAgentModel({
218
+ id: 'gpt-5.6-luna',
219
+ label: 'GPT-5.6 Luna',
220
+ source: DOCS.gpt56Luna,
221
+ reasoning: ['none', 'low', 'medium', 'high', 'xhigh', 'max'],
222
+ contextWindow: 1_050_000,
223
+ maxOutputTokens: 128_000,
224
+ knowledgeCutoff: '2026-02-16',
225
+ description: 'Cost-sensitive GPT-5.6 tier for high-volume workloads.',
226
+ pricing: freezePricing({ input: 0.2, cachedInput: 0.02, cacheWrite: 0.25, output: 1.2, source: DOCS.gpt56Luna }),
227
+ });
228
+
229
+ const GPT_53_CODEX = openAiAgentModel({
230
+ id: 'gpt-5.3-codex',
231
+ label: 'GPT-5.3-Codex',
232
+ source: DOCS.gpt53Codex,
233
+ reasoning: ['low', 'medium', 'high', 'xhigh'],
234
+ contextWindow: 400_000,
235
+ maxOutputTokens: 128_000,
236
+ knowledgeCutoff: '2025-08-31',
237
+ description: 'Agentic coding model for Codex-style software workflows.',
238
+ pricing: freezePricing({
239
+ input: 1.75,
240
+ cachedInput: 0.175,
241
+ cacheWrite: 0,
242
+ output: 14,
243
+ source: DOCS.gpt53Codex,
244
+ longContext: false,
245
+ processing: false,
55
246
  }),
56
- batch: Object.freeze({
57
- supported: true,
58
- completion_window: '24h',
59
- relative_price: 0.5,
60
- interactive: false,
247
+ capabilities: {
248
+ web_search: false,
249
+ file_search: false,
250
+ image_generation: false,
251
+ code_interpreter: false,
252
+ hosted_shell: false,
253
+ apply_patch: false,
254
+ skills: false,
255
+ computer_use: false,
256
+ mcp: false,
257
+ tool_search: false,
258
+ async_tool_calls: false,
259
+ mid_turn_steering: false,
260
+ configuration_update: false,
261
+ fast: false,
262
+ flex: false,
263
+ },
264
+ serviceTiers: ['default'],
265
+ contextPolicy: Object.freeze({
266
+ target_input_tokens: 100_000,
267
+ compact_at_tokens: 160_000,
268
+ intervene_at_tokens: 210_000,
269
+ max_normal_input_tokens: 240_000,
270
+ pricing_threshold_tokens: null,
271
+ max_cumulative_input_tokens: 400_000,
272
+ safety_margin_tokens: 20_000,
61
273
  }),
62
- source: Object.freeze({ url: ASTRA_SOURCE, as_of: '2026-09-12' }),
63
274
  });
64
275
 
65
- export const MODEL_CATALOG = Object.freeze([GPT_6_ASTRA]);
276
+ const TEXT_EMBEDDING_3_LARGE = openAiEmbeddingModel({
277
+ id: 'text-embedding-3-large',
278
+ label: 'text-embedding-3-large',
279
+ source: DOCS.embeddingLarge,
280
+ dimensions: 3_072,
281
+ price: 0.13,
282
+ });
283
+
284
+ const TEXT_EMBEDDING_3_SMALL = openAiEmbeddingModel({
285
+ id: 'text-embedding-3-small',
286
+ label: 'text-embedding-3-small',
287
+ source: DOCS.embeddingSmall,
288
+ dimensions: 1_536,
289
+ price: 0.02,
290
+ });
291
+
292
+ export const MODEL_CATALOG = Object.freeze([
293
+ GPT_6_LUNA,
294
+ GPT_6_SOL,
295
+ GPT_6_ASTRA,
296
+ GPT_56_LUNA,
297
+ GPT_56_TERRA,
298
+ GPT_56_SOL,
299
+ GPT_53_CODEX,
300
+ TEXT_EMBEDDING_3_LARGE,
301
+ TEXT_EMBEDDING_3_SMALL,
302
+ ]);
66
303
 
67
304
  function clean(value) {
68
305
  return value == null ? '' : String(value).trim();
@@ -85,6 +322,47 @@ export function getModelRecord(value) {
85
322
  return MODEL_CATALOG.find((row) => row.model_key === key || row.provider_model_id === key) || null;
86
323
  }
87
324
 
325
+ export function mergeModelReference(snapshot) {
326
+ if (!snapshot || typeof snapshot !== 'object') return null;
327
+ const reference = getModelRecord(snapshot.model_key || snapshot.provider_model_id);
328
+ if (!reference) return snapshot;
329
+
330
+ const providerContext = snapshot.context_window_source === 'provider_api'
331
+ && Number.isFinite(Number(snapshot.context_window))
332
+ && Number(snapshot.context_window) > 0;
333
+ const providerMaxOutput = snapshot.max_output_tokens_source === 'provider_api'
334
+ && Number.isFinite(Number(snapshot.max_output_tokens))
335
+ && Number(snapshot.max_output_tokens) > 0;
336
+
337
+ return Object.freeze({
338
+ ...snapshot,
339
+ ...reference,
340
+ model_key: snapshot.model_key || reference.model_key,
341
+ provider: snapshot.provider || reference.provider,
342
+ provider_model_id: snapshot.provider_model_id || reference.provider_model_id,
343
+ availability: snapshot.availability,
344
+ availability_source: snapshot.availability_source,
345
+ context_window: providerContext ? Number(snapshot.context_window) : reference.context_window ?? snapshot.context_window ?? null,
346
+ context_window_source: providerContext
347
+ ? 'provider_api'
348
+ : reference.context_window ? 'sdk_reference' : snapshot.context_window_source || 'unknown',
349
+ max_output_tokens: providerMaxOutput ? Number(snapshot.max_output_tokens) : reference.max_output_tokens ?? snapshot.max_output_tokens ?? null,
350
+ max_output_tokens_source: providerMaxOutput
351
+ ? 'provider_api'
352
+ : reference.max_output_tokens ? 'sdk_reference' : snapshot.max_output_tokens_source || 'unknown',
353
+ reasoning_efforts: reference.reasoning_efforts?.length
354
+ ? reference.reasoning_efforts
355
+ : snapshot.reasoning_efforts || Object.freeze(['auto']),
356
+ default_reasoning_effort: reference.default_reasoning_effort || snapshot.default_reasoning_effort || null,
357
+ service_tiers: reference.service_tiers?.length ? reference.service_tiers : snapshot.service_tiers || Object.freeze(['default']),
358
+ capabilities: Object.freeze({ ...(snapshot.capabilities || {}), ...(reference.capabilities || {}) }),
359
+ pricing: reference.pricing || snapshot.pricing || null,
360
+ context_policy: reference.context_policy || snapshot.context_policy || null,
361
+ source: reference.source || snapshot.source || null,
362
+ metadata: Object.freeze({ ...(snapshot.metadata || {}), ...(reference.metadata || {}) }),
363
+ });
364
+ }
365
+
88
366
  export function calculateModelCost(model, usage = {}, options = {}) {
89
367
  const record = typeof model === 'string' ? getModelRecord(model) : model;
90
368
  if (!record?.pricing) throw new TypeError('model pricing record is required');
@@ -50,10 +50,12 @@ function baseRecord(provider, id, values = {}) {
50
50
  const contextWindow = positiveInt(values.context_window ?? values.contextWindow ?? fallback?.context_window);
51
51
  const maxOutput = positiveInt(values.max_output_tokens ?? values.maxOutputTokens ?? fallback?.max_output_tokens);
52
52
  return Object.freeze({
53
- model_key: `${provider}:${id}`,
53
+ model_key: provider + ':' + id,
54
54
  provider,
55
55
  provider_model_id: id,
56
56
  label: clean(values.label) || fallback?.label || id,
57
+ kind: clean(values.kind) || fallback?.kind || 'unknown',
58
+ description: clean(values.description) || fallback?.description || null,
57
59
  availability: 'available',
58
60
  availability_source: 'provider_api',
59
61
  context_window: contextWindow,
@@ -64,6 +66,8 @@ function baseRecord(provider, id, values = {}) {
64
66
  max_output_tokens_source: values.max_output_tokens != null || values.maxOutputTokens != null
65
67
  ? 'provider_api'
66
68
  : fallback?.max_output_tokens ? 'sdk_reference' : 'unknown',
69
+ knowledge_cutoff: values.knowledge_cutoff || fallback?.knowledge_cutoff || null,
70
+ default_reasoning_effort: clean(values.default_reasoning_effort) || fallback?.default_reasoning_effort || null,
67
71
  reasoning_efforts: Object.freeze(
68
72
  Array.isArray(values.reasoning_efforts) && values.reasoning_efforts.length
69
73
  ? [...values.reasoning_efforts]
@@ -87,10 +91,26 @@ function baseRecord(provider, id, values = {}) {
87
91
  discovered_at: new Date().toISOString(),
88
92
  fallback: fallback?.source || null,
89
93
  }),
90
- metadata: Object.freeze(values.metadata && typeof values.metadata === 'object' ? { ...values.metadata } : {}),
94
+ metadata: Object.freeze({
95
+ ...(fallback?.metadata && typeof fallback.metadata === 'object' ? fallback.metadata : {}),
96
+ ...(values.metadata && typeof values.metadata === 'object' ? values.metadata : {}),
97
+ }),
91
98
  });
92
99
  }
93
100
 
101
+ function openAIModelCapabilities(id) {
102
+ const fallback = fallbackRecord('openai', id);
103
+ if (fallback?.capabilities) return {};
104
+ if (/^text-embedding-/i.test(id)) return { agent_runtime: false, embeddings: true };
105
+ if (/^(?:gpt-image|chatgpt-image|gpt-audio|gpt-realtime|sora|tts|whisper|omni-moderation)/i.test(id)) {
106
+ return { agent_runtime: false };
107
+ }
108
+ if (/^(?:gpt-(?:4o|4\.1|5|6)|o[1-9])/i.test(id)) {
109
+ return { agent_runtime: true, responses: true };
110
+ }
111
+ return { agent_runtime: false };
112
+ }
113
+
94
114
  async function fetchJson(fetchImpl, url, init) {
95
115
  const response = await fetchImpl(url, { ...init, signal: init?.signal || timeoutSignal() });
96
116
  let body = null;
@@ -115,7 +135,7 @@ export async function discoverOpenAIModels(apiKey, fetchImpl = fetch) {
115
135
  .filter(Boolean)
116
136
  .map((id) => baseRecord('openai', id, {
117
137
  source_url: 'https://api.openai.com/v1/models',
118
- capabilities: { responses: true },
138
+ capabilities: openAIModelCapabilities(id),
119
139
  }));
120
140
  return { attempted: true, ok: true, models, error: null };
121
141
  } catch (error) { return failure(error); }
@@ -284,7 +304,7 @@ function cloudflareTaskName(task) {
284
304
 
285
305
  export async function discoverCloudflareModels(apiToken, accountId, fetchImpl = fetch) {
286
306
  if (!clean(apiToken)) return failure('credential unavailable', false);
287
- if (!clean(accountId)) return failure('ACCOUNT_ID is required for Workers AI discovery');
307
+ if (!clean(accountId)) return failure('CLOUDFLARE_ACCOUNT_ID is required for Workers AI discovery');
288
308
  try {
289
309
  const url = `https://api.cloudflare.com/client/v4/accounts/${encodeURIComponent(clean(accountId))}/ai/models/search`;
290
310
  const body = await fetchJson(fetchImpl, url, {
@@ -3,5 +3,7 @@ export {
3
3
  MODEL_CATALOG,
4
4
  listModelCatalog,
5
5
  getModelRecord,
6
+ mergeModelReference,
6
7
  calculateModelCost,
7
8
  } from './catalog.js';
9
+ export { normalizeModelPolicy, loadModelPolicy } from './policy.js';