@inneranimalmedia/agentsam-sdk 2.6.4 → 2.6.5

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 (418) hide show
  1. package/AGENTSAM.md +11 -0
  2. package/README.md +15 -9
  3. package/apps/client-cms-editor/AGENTS.md +12 -0
  4. package/apps/client-cms-editor/IMPORT_PROVENANCE.json +8 -0
  5. package/apps/client-cms-editor/README.md +72 -0
  6. package/apps/client-cms-editor/agentsam.app.json +57 -0
  7. package/apps/client-cms-editor/backend/README.md +5 -0
  8. package/apps/client-cms-editor/backend/package.json +22 -0
  9. package/apps/client-cms-editor/backend/src/api/client.ts +200 -0
  10. package/apps/client-cms-editor/backend/src/demo-bootstrap.ts +145 -0
  11. package/apps/client-cms-editor/backend/src/index.ts +6 -0
  12. package/apps/client-cms-editor/backend/src/model.ts +115 -0
  13. package/apps/client-cms-editor/backend/src/preview/bridge.ts +79 -0
  14. package/apps/client-cms-editor/backend/src/preview/urls.ts +55 -0
  15. package/apps/client-cms-editor/backend/src/routing/cms-route.js +293 -0
  16. package/apps/client-cms-editor/backend/src/routing/index.js +10 -0
  17. package/apps/client-cms-editor/backend/src/storefront.ts +52 -0
  18. package/apps/client-cms-editor/backend/tsconfig.json +15 -0
  19. package/apps/client-cms-editor/backend/worker/index.js +34 -0
  20. package/apps/client-cms-editor/backend/wrangler.jsonc +11 -0
  21. package/apps/client-cms-editor/bin/agentsam-cms.mjs +229 -0
  22. package/apps/client-cms-editor/frontend/index.html +12 -0
  23. package/apps/client-cms-editor/frontend/package.json +33 -0
  24. package/apps/client-cms-editor/frontend/src/AgentSamDrawer.tsx +188 -0
  25. package/apps/client-cms-editor/frontend/src/CmsAgentSurface.tsx +191 -0
  26. package/apps/client-cms-editor/frontend/src/CmsEditor.tsx +1345 -0
  27. package/apps/client-cms-editor/frontend/src/env.d.ts +14 -0
  28. package/apps/client-cms-editor/frontend/src/index.ts +8 -0
  29. package/apps/client-cms-editor/frontend/src/lib/content-safety.ts +63 -0
  30. package/apps/client-cms-editor/frontend/src/main.tsx +17 -0
  31. package/apps/client-cms-editor/frontend/src/mount.tsx +51 -0
  32. package/apps/client-cms-editor/frontend/src/styles/agentsam-drawer.css +214 -0
  33. package/apps/client-cms-editor/frontend/src/styles/cmsShell.css +1739 -0
  34. package/apps/client-cms-editor/frontend/src/styles/studio.css +106 -0
  35. package/apps/client-cms-editor/frontend/src/surfaces/CmsDashboard.tsx +313 -0
  36. package/apps/client-cms-editor/frontend/src/surfaces/CmsGuidedChatHero.tsx +121 -0
  37. package/apps/client-cms-editor/frontend/src/surfaces/CmsHubPage.tsx +132 -0
  38. package/apps/client-cms-editor/frontend/src/surfaces/CmsSiteSwitcher.tsx +176 -0
  39. package/apps/client-cms-editor/frontend/src/surfaces/index.ts +5 -0
  40. package/apps/client-cms-editor/frontend/src/surfaces/types.ts +48 -0
  41. package/apps/client-cms-editor/frontend/tsconfig.json +25 -0
  42. package/apps/client-cms-editor/frontend/vite.config.ts +13 -0
  43. package/apps/client-cms-editor/package-lock.json +3832 -0
  44. package/apps/client-cms-editor/package.json +23 -0
  45. package/apps/client-cms-editor/reference/DONOR_README.md +52 -0
  46. package/apps/client-cms-editor/reference/DONOR_package-lock.json +1253 -0
  47. package/apps/client-cms-editor/reference/DONOR_tsconfig.json +15 -0
  48. package/apps/client-cms-editor/shared/cms/package.json +21 -0
  49. package/apps/client-cms-editor/shared/cms/src/agent-context.ts +35 -0
  50. package/apps/client-cms-editor/shared/cms/src/cloudflare-bindings.ts +51 -0
  51. package/apps/client-cms-editor/shared/cms/src/editor-types.ts +58 -0
  52. package/apps/client-cms-editor/shared/cms/src/index.ts +5 -0
  53. package/apps/client-cms-editor/shared/cms/src/publication.ts +24 -0
  54. package/apps/client-cms-editor/shared/cms/src/routes.ts +11 -0
  55. package/apps/client-cms-editor/shared/cms/tsconfig.json +12 -0
  56. package/bin/agentsam-rapid-rust +36 -0
  57. package/docs/AUTH_IDENTITY_CONTRACT.md +2 -0
  58. package/docs/MACHINE_INTELLIGENCE.md +120 -0
  59. package/docs/WINDOWS_RUNTIME_INSTALL.md +30 -0
  60. package/docs/architecture/AGENTSAM_APPLICATION_CONTRACT.md +188 -0
  61. package/docs/architecture/AGENTSAM_RUNTIME_PROTOCOL.md +151 -0
  62. package/docs/architecture/LOCAL_STUDIO_CLOUDFLARE_OAUTH.md +12 -4
  63. package/docs/architecture/R2_SLUG_NAMESPACE.md +20 -0
  64. package/docs/architecture/WORK_PRODUCT_EXTRACTION.md +97 -0
  65. package/docs/brand/AGENT_SAM_ICON_GRAMMAR.md +70 -0
  66. package/docs/content-studio/HOST_MOUNT_CHECKLIST.md +71 -0
  67. package/docs/content-studio/REVISION_GATE_2026-09-27.md +501 -0
  68. package/docs/contracts/capability-install-planner.md +67 -0
  69. package/docs/contracts/environment-vocabulary.md +195 -0
  70. package/docs/contracts/google-cloud-oauth-setup.md +199 -0
  71. package/docs/local-studio/WORKMODE_DONOR_NOTES.md +1 -1
  72. package/docs/plans/LOCAL-STUDIO-GRADUATION-2026-09-26.md +290 -0
  73. package/docs/plans/LOCAL-STUDIO-REAL-APP-CONTRACT-ADDENDUM-2026-09-27.md +394 -0
  74. package/docs/plans/MACHINE-FIRST-APPS-TUI-2026-09-24.md +227 -0
  75. package/docs/plans/TOMORROW-EXTENSIVE-TODO-2026-09-26.md +221 -0
  76. package/docs/plans/TOMORROW-MACHINE-FIRST-BRIEFING.md +145 -0
  77. package/docs/plans/UNIVERSAL-INGEST-MACHINE-FIRST-2026-09-24.md +215 -0
  78. package/docs/plugins.md +2 -2
  79. package/docs/product/AGENTSAM_PRODUCT_EXPERIENCE_STANDARD.md +280 -0
  80. package/docs/product/LOCAL_STUDIO_DESKTOP_EXPERIENCE.md +139 -0
  81. package/docs/product/README.md +8 -0
  82. package/docs/rapid-rust-wasm.md +35 -0
  83. package/migrations/d1/0016_cloudflare_oauth_user_oauth_tokens_ssot.sql +14 -0
  84. package/package.json +73 -14
  85. package/packages/agentsam-brand/README.md +106 -11
  86. package/packages/agentsam-brand/bin/agentsam-brand.mjs +9 -0
  87. package/packages/agentsam-brand/package.json +39 -7
  88. package/packages/agentsam-brand/src/adapters/cloudflare-images.js +453 -0
  89. package/packages/agentsam-brand/src/adapters/cloudflare-r2.js +74 -0
  90. package/packages/agentsam-brand/src/adapters/d1-registry.js +26 -0
  91. package/packages/agentsam-brand/src/adapters/filesystem.js +59 -0
  92. package/packages/agentsam-brand/src/adapters/memory.js +31 -0
  93. package/packages/agentsam-brand/src/cli/controller.js +503 -0
  94. package/packages/agentsam-brand/src/cli/wizard.js +526 -0
  95. package/packages/agentsam-brand/src/core/capabilities.js +201 -0
  96. package/packages/agentsam-brand/src/core/derivatives.js +211 -0
  97. package/packages/agentsam-brand/src/core/errors.js +12 -0
  98. package/packages/agentsam-brand/src/core/ingest.js +195 -0
  99. package/packages/agentsam-brand/src/core/inspect.js +109 -0
  100. package/packages/agentsam-brand/src/core/keys.js +83 -0
  101. package/packages/agentsam-brand/src/core/naming.js +142 -0
  102. package/packages/agentsam-brand/src/core/optimize.js +316 -0
  103. package/packages/agentsam-brand/src/core/pack.js +305 -0
  104. package/packages/agentsam-brand/src/core/plan.js +276 -0
  105. package/packages/agentsam-brand/src/core/preview.js +159 -0
  106. package/packages/agentsam-brand/src/core/processors/cloudflare.js +68 -0
  107. package/packages/agentsam-brand/src/core/processors/contract.js +203 -0
  108. package/packages/agentsam-brand/src/core/processors/index.js +148 -0
  109. package/packages/agentsam-brand/src/core/processors/native.js +82 -0
  110. package/packages/agentsam-brand/src/core/processors/sharp.js +113 -0
  111. package/packages/agentsam-brand/src/core/processors/squoosh-binary.js +195 -0
  112. package/packages/agentsam-brand/src/core/promote.js +288 -0
  113. package/packages/agentsam-brand/src/core/receipts.js +155 -0
  114. package/packages/agentsam-brand/src/core/v2/compile.js +280 -0
  115. package/packages/agentsam-brand/src/core/v2/derivatives-semantic.js +207 -0
  116. package/packages/agentsam-brand/src/core/v2/ingest-graph.js +387 -0
  117. package/packages/agentsam-brand/src/core/v2/roles.js +180 -0
  118. package/packages/agentsam-brand/src/core/v2/schema.js +209 -0
  119. package/packages/agentsam-brand/src/core/v2/templates.js +114 -0
  120. package/packages/agentsam-brand/src/index.js +193 -36
  121. package/packages/agentsam-brand/src/presets/app-icon.json +16 -0
  122. package/packages/agentsam-brand/src/presets/favicon.json +17 -0
  123. package/packages/agentsam-brand/src/presets/hero.json +12 -0
  124. package/packages/agentsam-brand/src/presets/index.js +40 -0
  125. package/packages/agentsam-brand/src/presets/logo.json +12 -0
  126. package/packages/agentsam-brand/src/presets/model.json +8 -0
  127. package/packages/agentsam-brand/src/presets/og-image.json +10 -0
  128. package/packages/agentsam-brand/src/presets/product-shot.json +11 -0
  129. package/packages/agentsam-brand/src/presets/social-image.json +10 -0
  130. package/packages/agentsam-brand/src/presets/web-image.json +10 -0
  131. package/packages/agentsam-contracts/src/artifacts.ts +41 -0
  132. package/packages/agentsam-knowledge/src/autorag/index.js +1 -1
  133. package/packages/agentsam-knowledge/src/providers/index.js +6 -4
  134. package/packages/agentsam-knowledge/src/providers/ollama-endpoint.js +31 -0
  135. package/packages/agentsam-knowledge/test/autorag.test.mjs +22 -1
  136. package/packages/agentsam-nav/package.json +2 -2
  137. package/packages/agentsam-rapid-rust/Cargo.lock +344 -0
  138. package/packages/agentsam-rapid-rust/Cargo.toml +18 -0
  139. package/packages/agentsam-rapid-rust/README.md +5 -0
  140. package/packages/agentsam-rapid-rust/src/main.rs +718 -0
  141. package/packages/agentsam-rapid-rust/templates/api/Cargo.toml.tmpl +18 -0
  142. package/packages/agentsam-rapid-rust/templates/api/src/lib.rs.tmpl +17 -0
  143. package/packages/agentsam-rapid-rust/templates/common/README.md.tmpl +22 -0
  144. package/packages/agentsam-rapid-rust/templates/common/package.json.tmpl +12 -0
  145. package/packages/agentsam-rapid-rust/templates/common/wrangler.toml.tmpl +6 -0
  146. package/packages/agentsam-rapid-rust/templates/crypto-auth/Cargo.toml.tmpl +21 -0
  147. package/packages/agentsam-rapid-rust/templates/crypto-auth/src/lib.rs.tmpl +32 -0
  148. package/packages/agentsam-rapid-rust/templates/data-processor/Cargo.toml.tmpl +18 -0
  149. package/packages/agentsam-rapid-rust/templates/data-processor/src/lib.rs.tmpl +41 -0
  150. package/packages/agentsam-rapid-rust/templates/shared-core/Cargo.toml.tmpl +9 -0
  151. package/packages/agentsam-rapid-rust/templates/shared-core/core/Cargo.toml.tmpl +7 -0
  152. package/packages/agentsam-rapid-rust/templates/shared-core/core/src/lib.rs.tmpl +23 -0
  153. package/packages/agentsam-rapid-rust/templates/shared-core/worker/Cargo.toml.tmpl +12 -0
  154. package/packages/agentsam-rapid-rust/templates/shared-core/worker/src/lib.rs.tmpl +16 -0
  155. package/packages/agentsam-rapid-rust/templates/shared-core/wrangler.toml.tmpl +6 -0
  156. package/packages/agentsam-repository/src/index.js +1 -0
  157. package/packages/agentsam-repository/src/merkle/semantic.js +3 -10
  158. package/packages/agentsam-repository/src/source-types.js +85 -0
  159. package/packages/agentsam-vault/README.md +96 -0
  160. package/packages/agentsam-vault/package.json +32 -0
  161. package/packages/agentsam-vault/src/contracts/credential.d.ts +78 -0
  162. package/packages/agentsam-vault/src/contracts/credential.js +132 -0
  163. package/packages/agentsam-vault/src/crypto/aes-gcm.d.ts +30 -0
  164. package/packages/agentsam-vault/src/crypto/aes-gcm.js +107 -0
  165. package/packages/agentsam-vault/src/crypto/oauth-envelope.js +150 -0
  166. package/packages/agentsam-vault/src/index.d.ts +9 -0
  167. package/packages/agentsam-vault/src/index.js +27 -0
  168. package/packages/agentsam-vault/src/providers/registry.js +90 -0
  169. package/packages/agentsam-vault/src/runtime/resolver.js +77 -0
  170. package/packages/agentsam-workbench/README.md +24 -0
  171. package/packages/agentsam-workbench/package.json +38 -0
  172. package/packages/agentsam-workbench/src/agent/AgentPanel.tsx +41 -0
  173. package/packages/agentsam-workbench/src/agent/ArtifactCard.tsx +9 -0
  174. package/packages/agentsam-workbench/src/agent/Composer.tsx +102 -0
  175. package/packages/agentsam-workbench/src/agent/ConnectedAgentPanel.tsx +194 -0
  176. package/packages/agentsam-workbench/src/agent/ContextualComposer.tsx +788 -0
  177. package/packages/agentsam-workbench/src/agent/GoalStatusStrip.tsx +38 -0
  178. package/packages/agentsam-workbench/src/agent/MiniAgentSam.tsx +86 -0
  179. package/packages/agentsam-workbench/src/agent/ModelSelect.tsx +19 -0
  180. package/packages/agentsam-workbench/src/agent/Thread.tsx +56 -0
  181. package/packages/agentsam-workbench/src/agent/ToolReceipt.tsx +11 -0
  182. package/packages/agentsam-workbench/src/agent/contextual-composer.css +611 -0
  183. package/packages/agentsam-workbench/src/agent/index.ts +10 -0
  184. package/packages/agentsam-workbench/src/agent/mini-agentsam.css +12 -0
  185. package/packages/agentsam-workbench/src/browser/BrowserFrame.tsx +37 -0
  186. package/packages/agentsam-workbench/src/browser/index.ts +1 -0
  187. package/packages/agentsam-workbench/src/index.ts +6 -0
  188. package/packages/agentsam-workbench/src/project-control.css +160 -0
  189. package/packages/agentsam-workbench/src/projects/ProjectsSurface.tsx +131 -0
  190. package/packages/agentsam-workbench/src/projects/index.ts +1 -0
  191. package/packages/agentsam-workbench/src/shell/Breadcrumb.tsx +35 -0
  192. package/packages/agentsam-workbench/src/shell/ResizableStage.tsx +99 -0
  193. package/packages/agentsam-workbench/src/shell/SidePanel.tsx +5 -0
  194. package/packages/agentsam-workbench/src/shell/index.ts +4 -0
  195. package/packages/agentsam-workbench/src/shell/surfaceRegistry.ts +29 -0
  196. package/packages/agentsam-workbench/src/terminal/TerminalSurface.tsx +5 -0
  197. package/packages/agentsam-workbench/src/terminal/index.ts +1 -0
  198. package/packages/agentsam-workbench/src/timeline/GanttBoard.tsx +258 -0
  199. package/packages/agentsam-workbench/src/timeline/index.ts +1 -0
  200. package/packages/agentsam-workbench/tsconfig.json +13 -0
  201. package/packages/connectors/cloudflare/OAUTH_STORAGE_AUDIT.md +53 -0
  202. package/packages/connectors/cloudflare/package.json +3 -1
  203. package/packages/connectors/cloudflare/src/api-client.js +279 -0
  204. package/packages/connectors/cloudflare/src/capabilities.js +585 -0
  205. package/packages/connectors/cloudflare/src/credential.js +318 -0
  206. package/packages/connectors/cloudflare/src/families/brand-protection.js +123 -0
  207. package/packages/connectors/cloudflare/src/families/keyless.js +114 -0
  208. package/packages/connectors/cloudflare/src/families/pages.js +151 -0
  209. package/packages/connectors/cloudflare/src/families/scanner.js +123 -0
  210. package/packages/connectors/cloudflare/src/families/snippets.js +207 -0
  211. package/packages/connectors/cloudflare/src/families/tag-gateway.js +46 -0
  212. package/packages/connectors/cloudflare/src/families/tags.js +124 -0
  213. package/packages/connectors/cloudflare/src/families/token-validation.js +95 -0
  214. package/packages/connectors/cloudflare/src/families/workflows.js +156 -0
  215. package/packages/connectors/cloudflare/src/index.js +102 -265
  216. package/packages/connectors/cloudflare/src/oauth-persist.js +336 -0
  217. package/packages/connectors/cloudflare/src/owner.js +42 -12
  218. package/packages/connectors/cloudflare/src/permission-options.js +1064 -0
  219. package/packages/connectors/cloudflare/src/routes.js +309 -144
  220. package/packages/connectors/cloudflare/src/scope-catalog.js +345 -0
  221. package/packages/connectors/cloudflare/src/vault.js +2 -2
  222. package/packages/connectors/cloudflare/tests/capabilities.test.mjs +276 -0
  223. package/packages/connectors/cloudflare/tests/connector.test.mjs +26 -30
  224. package/packages/connectors/cloudflare/tests/oauth-persist.test.mjs +125 -0
  225. package/packages/identity/.agentsam/features/oauth-login-portal/providers.json +22 -2
  226. package/packages/identity/.agentsam/features/oauth-login-portal/resources.json +10 -4
  227. package/packages/identity/.agentsam/features/oauth-login-portal/routes.json +20 -0
  228. package/packages/identity/README.md +1 -1
  229. package/packages/identity/backend/README.md +1 -1
  230. package/packages/identity/migrations/D1_SCHEMA_MAPPING.md +3 -2
  231. package/packages/identity/migrations/sqlite/004_identity_oauth_consent_catalog.sql +48 -0
  232. package/packages/identity/package.json +4 -3
  233. package/packages/identity/scripts/local-identity-bridge.mjs +184 -0
  234. package/packages/identity/scripts/preview-auth-portal.mjs +7 -7
  235. package/packages/identity/src/adapters/cloudflare-d1/index.js +31 -2
  236. package/packages/identity/src/adapters/sqlite/index.js +4 -1
  237. package/packages/identity/src/contracts/auth-config.js +28 -8
  238. package/packages/identity/src/contracts/external-identity.js +1 -1
  239. package/packages/identity/src/contracts/provider.js +1 -0
  240. package/packages/identity/src/frontend/auth-portal/README.md +2 -1
  241. package/packages/identity/src/frontend/auth-portal/pages/login.html +6 -5
  242. package/packages/identity/src/frontend/auth-portal/pages/reset.html +6 -5
  243. package/packages/identity/src/frontend/auth-portal/pages/signup.html +6 -5
  244. package/packages/identity/src/frontend/auth-portal/shared/company-branding.js +1 -1
  245. package/packages/identity/src/frontend/auth-portal/shared/desktop-identity-bridge.js +207 -0
  246. package/packages/identity/src/index.js +16 -0
  247. package/packages/identity/src/migrations/0001_identity_core.sql +19 -2
  248. package/packages/identity/src/migrations/0003_accounts_ssot.sql +20 -0
  249. package/packages/identity/src/migrations/README.md +5 -2
  250. package/packages/identity/src/oauth/README.md +10 -5
  251. package/packages/identity/src/oauth/consent-view.js +388 -0
  252. package/packages/identity/src/oauth/credentials.js +31 -11
  253. package/packages/identity/src/oauth/google-desktop-exchange.js +173 -0
  254. package/packages/identity/src/providers/cloudflare/oauth.js +3 -4
  255. package/packages/identity/src/providers/cloudflare/profile.js +49 -14
  256. package/packages/identity/src/providers/iam/index.js +27 -5
  257. package/packages/identity/src/server/identity-service.js +31 -2
  258. package/packages/identity/src/server/worker-router.js +111 -81
  259. package/packages/identity/tests/auth-config.test.mjs +3 -2
  260. package/packages/identity/tests/identity-init-scaffold.test.mjs +3 -0
  261. package/packages/identity/tests/identity-service.test.mjs +16 -0
  262. package/packages/identity/tests/native-session-worker.test.mjs +64 -0
  263. package/packages/identity/tests/oauth-consent-view.test.mjs +106 -0
  264. package/packages/identity/tests/oauth-credentials.test.mjs +17 -4
  265. package/packages/identity/tests/oauth-presets-accounts-ssot.test.mjs +58 -0
  266. package/packages/identity/tests/preview-auth-portal.test.mjs +3 -3
  267. package/packages/runtime-protocol/src/index.js +154 -0
  268. package/packages/theme-scenes/README.md +164 -0
  269. package/packages/theme-scenes/package.json +53 -0
  270. package/packages/theme-scenes/src/blocks/index.js +30 -0
  271. package/packages/theme-scenes/src/contracts/index.js +286 -0
  272. package/packages/theme-scenes/src/demos/index.js +65 -0
  273. package/packages/theme-scenes/src/index.js +75 -0
  274. package/packages/theme-scenes/src/presets/index.js +263 -0
  275. package/packages/theme-scenes/src/runtime/compile.js +119 -0
  276. package/packages/theme-scenes/src/scenes/index.js +146 -0
  277. package/packages/theme-scenes/src/shell/index.js +47 -0
  278. package/packages/theme-scenes/src/themes/index.js +129 -0
  279. package/packages/theme-scenes/src/visuals/index.js +41 -0
  280. package/packages/theme-scenes/test/theme-scenes.test.mjs +179 -0
  281. package/packages/work-graph/src/index.js +34 -1
  282. package/packages/work-graph/src/renderers/gantt-model.js +24 -0
  283. package/packages/work-graph/test/work-graph.test.mjs +27 -7
  284. package/protocol/README.md +15 -7
  285. package/protocol/apps/agentsam.app.v1.schema.json +89 -7
  286. package/protocol/apps/agentsam.host-install.v1.schema.json +36 -0
  287. package/protocol/assets/README.md +9 -0
  288. package/protocol/assets/asset-record.v1.schema.json +64 -0
  289. package/protocol/runtime/agentsam.runtime.v1.schema.json +75 -0
  290. package/protocol/scoring/README.md +10 -0
  291. package/protocol/scoring/scorecard.v1.schema.json +65 -0
  292. package/protocol/ui/icon-registry.mjs +1 -0
  293. package/registry/cms-rust-machine-20260928/installable-products.json +31 -0
  294. package/registry/cms-rust-machine-20260928/manifest.json +22 -0
  295. package/registry/cms-rust-machine-20260928/migration.sql +237 -0
  296. package/registry/cms-rust-machine-20260928/receipt.json +21 -0
  297. package/registry/cms-rust-machine-20260928/receipt.sql +27 -0
  298. package/scripts/build_rapid_rust_cli.py +83 -0
  299. package/src/attachments/index.js +6 -0
  300. package/src/attachments/intake.js +235 -0
  301. package/src/capabilities/repository-snapshot.js +19 -2
  302. package/src/cli/command-catalog.js +8 -0
  303. package/src/cli.js +182 -26
  304. package/src/commands/account-auth.js +94 -8
  305. package/src/commands/app.js +307 -3
  306. package/src/commands/billing.js +127 -0
  307. package/src/commands/brand.js +74 -60
  308. package/src/commands/cheat-sheet.js +154 -0
  309. package/src/commands/cloudflare-login.js +222 -0
  310. package/src/commands/cloudflare.js +453 -23
  311. package/src/commands/codebaseindex.js +6 -1
  312. package/src/commands/compute.js +4 -0
  313. package/src/commands/connections.js +11 -5
  314. package/src/commands/credentials.js +116 -0
  315. package/src/commands/gcloud-auth.js +427 -0
  316. package/src/commands/google-cloud.js +375 -0
  317. package/src/commands/identity-init.js +2 -2
  318. package/src/commands/mcp.js +226 -33
  319. package/src/commands/ollama.js +3 -2
  320. package/src/commands/plugins.js +7 -2
  321. package/src/commands/product.js +36 -0
  322. package/src/commands/runtime-status.js +28 -9
  323. package/src/commands/runtime.js +313 -0
  324. package/src/commands/rust.js +24 -0
  325. package/src/commands/setup.js +279 -0
  326. package/src/commands/shell.js +16 -3
  327. package/src/commands/start-local.js +2 -2
  328. package/src/commands/terminal.js +171 -0
  329. package/src/commands/update.js +140 -0
  330. package/src/commands/whoami.js +329 -65
  331. package/src/features/resolve.js +1 -0
  332. package/src/index.js +4 -0
  333. package/src/indexing/ingest/inventory.js +254 -19
  334. package/src/indexing/ingest/materials.js +3 -9
  335. package/src/indexing/ingest/style-evidence.js +181 -0
  336. package/src/knowledge/source.js +3 -3
  337. package/src/lib/account-session.js +11 -4
  338. package/src/lib/app-authority.js +172 -0
  339. package/src/lib/auth.js +94 -21
  340. package/src/lib/core-client.js +5 -6
  341. package/src/lib/credentials-audit.js +451 -0
  342. package/src/lib/deploy/health.js +24 -6
  343. package/src/lib/detect-context.js +7 -1
  344. package/src/lib/google-cloud-connection.js +270 -0
  345. package/src/lib/google-cloud-inventory.js +385 -0
  346. package/src/lib/google-desktop-oauth.js +372 -0
  347. package/src/lib/google-studio-brokered-oauth.js +158 -0
  348. package/src/lib/identity-scaffold.js +24 -6
  349. package/src/lib/init-options.js +192 -0
  350. package/src/lib/local-scaffold.js +48 -16
  351. package/src/lib/provider-command-remediation.js +308 -0
  352. package/src/lib/provider-credentials.js +8 -0
  353. package/src/lib/scaffold/index.js +8 -2
  354. package/src/lib/scaffold/mcp-server.js +43 -0
  355. package/src/lib/scaffold/templates/mcp-server/index.js +397 -0
  356. package/src/lib/scaffold/templates/mcp-server/presets.js +39 -0
  357. package/src/lib/scaffold/wizards/cms.js +93 -0
  358. package/src/lib/scaffold/wizards/mcp-server.js +61 -0
  359. package/src/lib/setup/contract.js +26 -0
  360. package/src/lib/setup/discover.js +116 -0
  361. package/src/lib/setup/execute.js +205 -0
  362. package/src/lib/setup/planner.js +134 -0
  363. package/src/lib/setup/recipes.js +235 -0
  364. package/src/lib/setup/runtime-persist.js +197 -0
  365. package/src/lib/setup/runtime.js +394 -0
  366. package/src/lib/slash-commands.js +2 -0
  367. package/src/lib/terminal/machine-identity.js +95 -0
  368. package/src/lib/terminal-local.js +164 -0
  369. package/src/lib/terminal-scopes.js +52 -0
  370. package/src/lib/whoami-capabilities.js +184 -0
  371. package/src/local-pty/server.js +34 -5
  372. package/src/mcp/authority.js +58 -108
  373. package/src/mcp/client-adapters.js +68 -144
  374. package/src/mcp/client.js +142 -122
  375. package/src/mcp/cloudflare-bundles.js +225 -0
  376. package/src/mcp/index.js +12 -0
  377. package/src/plugins/cloudflare.js +1 -1
  378. package/src/providers/ollama-chat.js +2 -1
  379. package/src/sam/types.js +27 -2
  380. package/src/security/inventory.js +12 -2
  381. package/src/security/local-vault.js +2 -0
  382. package/src/security/scan.js +1 -1
  383. package/test/account-session.test.mjs +3 -3
  384. package/test/app-authority-context.test.mjs +32 -0
  385. package/test/cli/codebaseindex-plan-ux.test.mjs +1 -1
  386. package/test/cli/mcp-client.test.mjs +21 -10
  387. package/test/cli/runtime-persist.test.mjs +56 -0
  388. package/test/cli/rust-command.test.mjs +21 -0
  389. package/test/credentials-audit.test.mjs +113 -0
  390. package/test/deploy-health-scan.test.mjs +29 -1
  391. package/test/gcloud-auth.test.mjs +111 -0
  392. package/test/google-cloud-connection.test.mjs +83 -0
  393. package/test/google-cloud-inventory.test.mjs +64 -0
  394. package/test/init-options.test.mjs +35 -0
  395. package/test/integration/app-command.test.mjs +30 -0
  396. package/test/integration/cad-project.test.mjs +4 -1
  397. package/test/integration/cms-app-scaffold.test.mjs +71 -0
  398. package/test/integration/cms-site-tenancy-contract.test.mjs +3 -2
  399. package/test/integration/codebaseindex-ingest.test.mjs +48 -0
  400. package/test/integration/features-resolve.test.mjs +30 -11
  401. package/test/integration/inspect-path-cli.test.mjs +46 -0
  402. package/test/integration/inventory-evidence.test.mjs +125 -0
  403. package/test/integration/runtime-status.integration.test.mjs +2 -1
  404. package/test/knowledge.test.mjs +35 -1
  405. package/test/loopback-oauth.test.mjs +53 -0
  406. package/test/ollama.test.mjs +22 -0
  407. package/test/security.test.mjs +23 -0
  408. package/test/setup-planner.test.mjs +74 -0
  409. package/test/setup-runtime.test.mjs +51 -0
  410. package/test/terminal/local-pty.mock.test.mjs +3 -1
  411. package/test/terminal-machine-identity.test.mjs +88 -0
  412. package/test/whoami-resume.test.mjs +27 -6
  413. package/packages/agentsam-brand/test/brand-scan.test.mjs +0 -106
  414. package/packages/work-graph/prototype/README.md +0 -32
  415. package/packages/work-graph/prototype/data/demo-workgraph.js +0 -47
  416. package/packages/work-graph/prototype/renderers/timeline-model.js +0 -21
  417. package/packages/work-graph/prototype/renderers/workgraph-runtime.js +0 -38
  418. package/packages/work-graph/prototype-gnantt.html +0 -655
@@ -0,0 +1,95 @@
1
+ /** Zone Token Validation (JWT) — real API. */
2
+ import { receipt } from '../api-client.js';
3
+
4
+ const CAP = 'cloudflare.token_validation';
5
+
6
+ export async function tokenValidationStatus(client, zoneId) {
7
+ try {
8
+ const res = await client.request('GET', client.zonePath(zoneId, '/token_validation/config'), {
9
+ capabilityId: CAP,
10
+ operation: 'token_validation.config.list',
11
+ });
12
+ return receipt(CAP, 'status', {
13
+ ok: true,
14
+ availability: 'available',
15
+ authorized: true,
16
+ zone_id: zoneId,
17
+ configs: res.result || [],
18
+ });
19
+ } catch (err) {
20
+ if (err.code === 'cloudflare_permission_denied') {
21
+ return receipt(CAP, 'status', { ok: false, authorized: false, zone_id: zoneId, ...err.toJSON() });
22
+ }
23
+ throw err;
24
+ }
25
+ }
26
+
27
+ export async function tokenValidationListConfigs(client, zoneId) {
28
+ const res = await client.request('GET', client.zonePath(zoneId, '/token_validation/config'), {
29
+ capabilityId: CAP,
30
+ operation: 'token_validation.config.list',
31
+ });
32
+ return receipt(CAP, 'config.list', { ok: true, zone_id: zoneId, configs: res.result || [] });
33
+ }
34
+
35
+ export async function tokenValidationGetConfig(client, zoneId, configId) {
36
+ const res = await client.request(
37
+ 'GET',
38
+ client.zonePath(zoneId, `/token_validation/config/${encodeURIComponent(configId)}`),
39
+ { capabilityId: CAP, operation: 'token_validation.config.get' },
40
+ );
41
+ return receipt(CAP, 'config.get', { ok: true, zone_id: zoneId, config: res.result });
42
+ }
43
+
44
+ export async function tokenValidationCreateConfig(client, zoneId, body) {
45
+ const res = await client.request('POST', client.zonePath(zoneId, '/token_validation/config'), {
46
+ capabilityId: CAP,
47
+ operation: 'token_validation.config.create',
48
+ body,
49
+ });
50
+ return receipt(CAP, 'config.create', { ok: true, zone_id: zoneId, config: res.result });
51
+ }
52
+
53
+ export async function tokenValidationEditConfig(client, zoneId, configId, body) {
54
+ const res = await client.request(
55
+ 'PATCH',
56
+ client.zonePath(zoneId, `/token_validation/config/${encodeURIComponent(configId)}`),
57
+ { capabilityId: CAP, operation: 'token_validation.config.edit', body },
58
+ );
59
+ return receipt(CAP, 'config.edit', { ok: true, zone_id: zoneId, config: res.result });
60
+ }
61
+
62
+ export async function tokenValidationDeleteConfig(client, zoneId, configId) {
63
+ const res = await client.request(
64
+ 'DELETE',
65
+ client.zonePath(zoneId, `/token_validation/config/${encodeURIComponent(configId)}`),
66
+ { capabilityId: CAP, operation: 'token_validation.config.delete' },
67
+ );
68
+ return receipt(CAP, 'config.delete', { ok: true, zone_id: zoneId, result: res.result });
69
+ }
70
+
71
+ export async function tokenValidationListRules(client, zoneId) {
72
+ const res = await client.request('GET', client.zonePath(zoneId, '/token_validation/rules'), {
73
+ capabilityId: CAP,
74
+ operation: 'token_validation.rules.list',
75
+ });
76
+ return receipt(CAP, 'rules.list', { ok: true, zone_id: zoneId, rules: res.result || [] });
77
+ }
78
+
79
+ export async function tokenValidationCreateRule(client, zoneId, body) {
80
+ const res = await client.request('POST', client.zonePath(zoneId, '/token_validation/rules'), {
81
+ capabilityId: CAP,
82
+ operation: 'token_validation.rules.create',
83
+ body,
84
+ });
85
+ return receipt(CAP, 'rules.create', { ok: true, zone_id: zoneId, rule: res.result });
86
+ }
87
+
88
+ export async function tokenValidationDeleteRule(client, zoneId, ruleId) {
89
+ const res = await client.request(
90
+ 'DELETE',
91
+ client.zonePath(zoneId, `/token_validation/rules/${encodeURIComponent(ruleId)}`),
92
+ { capabilityId: CAP, operation: 'token_validation.rules.delete' },
93
+ );
94
+ return receipt(CAP, 'rules.delete', { ok: true, zone_id: zoneId, result: res.result });
95
+ }
@@ -0,0 +1,156 @@
1
+ /** Cloudflare Workflows — real API: /accounts/{id}/workflows/... */
2
+ import { receipt } from '../api-client.js';
3
+
4
+ const CAP = 'cloudflare.workflows';
5
+
6
+ export async function workflowsStatus(client) {
7
+ client.requireAccount('workflows.status');
8
+ try {
9
+ const res = await client.request('GET', client.accountPath('/workflows'), {
10
+ capabilityId: CAP,
11
+ operation: 'workflows.list',
12
+ query: { per_page: 1 },
13
+ });
14
+ return receipt(CAP, 'status', {
15
+ ok: true,
16
+ availability: 'available',
17
+ authorized: true,
18
+ account_id: client.accountId,
19
+ workflow_count_sample: Array.isArray(res.result) ? res.result.length : null,
20
+ result_info: res.result_info,
21
+ });
22
+ } catch (err) {
23
+ if (err.code === 'cloudflare_permission_denied') {
24
+ return receipt(CAP, 'status', {
25
+ ok: false,
26
+ availability: 'available',
27
+ authorized: false,
28
+ ...err.toJSON(),
29
+ });
30
+ }
31
+ throw err;
32
+ }
33
+ }
34
+
35
+ export async function workflowsList(client, { page, per_page } = {}) {
36
+ client.requireAccount('workflows.list');
37
+ const res = await client.request('GET', client.accountPath('/workflows'), {
38
+ capabilityId: CAP,
39
+ operation: 'workflows.list',
40
+ query: { page, per_page },
41
+ });
42
+ return receipt(CAP, 'list', {
43
+ ok: true,
44
+ workflows: res.result || [],
45
+ result_info: res.result_info,
46
+ });
47
+ }
48
+
49
+ export async function workflowsInspect(client, name) {
50
+ client.requireAccount('workflows.inspect');
51
+ const res = await client.request('GET', client.accountPath(`/workflows/${encodeURIComponent(name)}`), {
52
+ capabilityId: CAP,
53
+ operation: 'workflows.inspect',
54
+ });
55
+ return receipt(CAP, 'inspect', { ok: true, workflow: res.result });
56
+ }
57
+
58
+ export async function workflowsVersions(client, name) {
59
+ client.requireAccount('workflows.versions');
60
+ const res = await client.request('GET', client.accountPath(`/workflows/${encodeURIComponent(name)}/versions`), {
61
+ capabilityId: CAP,
62
+ operation: 'workflows.versions',
63
+ });
64
+ return receipt(CAP, 'versions', { ok: true, workflow: name, versions: res.result || [] });
65
+ }
66
+
67
+ export async function workflowsGraph(client, name, versionId) {
68
+ client.requireAccount('workflows.graph');
69
+ if (!versionId) throw Object.assign(new Error('version_id required'), { code: 'version_id_required' });
70
+ const res = await client.request(
71
+ 'GET',
72
+ client.accountPath(`/workflows/${encodeURIComponent(name)}/versions/${encodeURIComponent(versionId)}/graph`),
73
+ { capabilityId: CAP, operation: 'workflows.graph' },
74
+ );
75
+ return receipt(CAP, 'graph', { ok: true, workflow: name, version_id: versionId, graph: res.result });
76
+ }
77
+
78
+ export async function workflowsRun(client, name, { instanceId, params } = {}) {
79
+ client.requireAccount('workflows.run');
80
+ const body = {};
81
+ if (instanceId) body.id = instanceId;
82
+ if (params != null) body.params = params;
83
+ const res = await client.request('POST', client.accountPath(`/workflows/${encodeURIComponent(name)}/instances`), {
84
+ capabilityId: CAP,
85
+ operation: 'workflows.run',
86
+ body: Object.keys(body).length ? body : {},
87
+ });
88
+ return receipt(CAP, 'run', { ok: true, workflow: name, instance: res.result });
89
+ }
90
+
91
+ export async function workflowsInstances(client, name, query = {}) {
92
+ client.requireAccount('workflows.instances');
93
+ const res = await client.request('GET', client.accountPath(`/workflows/${encodeURIComponent(name)}/instances`), {
94
+ capabilityId: CAP,
95
+ operation: 'workflows.instances',
96
+ query,
97
+ });
98
+ return receipt(CAP, 'instances', { ok: true, workflow: name, instances: res.result || [], result_info: res.result_info });
99
+ }
100
+
101
+ export async function workflowsInstance(client, name, instanceId) {
102
+ client.requireAccount('workflows.instance');
103
+ const res = await client.request(
104
+ 'GET',
105
+ client.accountPath(`/workflows/${encodeURIComponent(name)}/instances/${encodeURIComponent(instanceId)}`),
106
+ { capabilityId: CAP, operation: 'workflows.instance' },
107
+ );
108
+ return receipt(CAP, 'instance', { ok: true, workflow: name, instance: res.result });
109
+ }
110
+
111
+ export async function workflowsStep(client, name, instanceId) {
112
+ client.requireAccount('workflows.step');
113
+ const res = await client.request(
114
+ 'GET',
115
+ client.accountPath(`/workflows/${encodeURIComponent(name)}/instances/${encodeURIComponent(instanceId)}/step`),
116
+ { capabilityId: CAP, operation: 'workflows.step' },
117
+ );
118
+ return receipt(CAP, 'step', { ok: true, workflow: name, instance_id: instanceId, step: res.result });
119
+ }
120
+
121
+ export async function workflowsSetStatus(client, name, instanceId, status) {
122
+ client.requireAccount('workflows.status_edit');
123
+ const res = await client.request(
124
+ 'PATCH',
125
+ client.accountPath(`/workflows/${encodeURIComponent(name)}/instances/${encodeURIComponent(instanceId)}/status`),
126
+ { capabilityId: CAP, operation: `workflows.${status}`, body: { status } },
127
+ );
128
+ return receipt(CAP, status, { ok: true, workflow: name, instance_id: instanceId, result: res.result });
129
+ }
130
+
131
+ export async function workflowsEvent(client, name, instanceId, eventType, payload = {}) {
132
+ client.requireAccount('workflows.event');
133
+ const res = await client.request(
134
+ 'POST',
135
+ client.accountPath(
136
+ `/workflows/${encodeURIComponent(name)}/instances/${encodeURIComponent(instanceId)}/events/${encodeURIComponent(eventType)}`,
137
+ ),
138
+ { capabilityId: CAP, operation: 'workflows.event', body: payload },
139
+ );
140
+ return receipt(CAP, 'event', {
141
+ ok: true,
142
+ workflow: name,
143
+ instance_id: instanceId,
144
+ event_type: eventType,
145
+ result: res.result,
146
+ });
147
+ }
148
+
149
+ export async function workflowsDelete(client, name) {
150
+ client.requireAccount('workflows.delete');
151
+ const res = await client.request('DELETE', client.accountPath(`/workflows/${encodeURIComponent(name)}`), {
152
+ capabilityId: CAP,
153
+ operation: 'workflows.delete',
154
+ });
155
+ return receipt(CAP, 'delete', { ok: true, workflow: name, result: res.result });
156
+ }
@@ -10,222 +10,93 @@ export const CLOUDFLARE_FIXTURE_CLIENT_ID = 'sillynotreal';
10
10
 
11
11
  export const CLOUDFLARE_OAUTH_REVOKE_URL = 'https://dash.cloudflare.com/oauth2/revoke';
12
12
 
13
- /** Smallest useful scopes mapped to Cloudflare API token permission names. */
14
- export const CLOUDFLARE_CAPABILITY_SCOPES = Object.freeze({
15
- workers_deploy: {
16
- scopes: ['workers-scripts.write'],
17
- why: 'Deploy Workers for the connected account (Workers Scripts Edit).',
18
- },
19
- d1_inspect: {
20
- scopes: ['d1.read'],
21
- why: 'Inspect D1 databases bound to the deployable.',
22
- },
23
- r2_inspect: {
24
- scopes: ['workers-r2.read'],
25
- why: 'Inspect R2 buckets bound to the deployable.',
26
- },
27
- worker_logs: {
28
- scopes: ['workers-scripts.read'],
29
- why: 'Read Worker script metadata/logs for postdeploy health.',
30
- },
31
- });
13
+ export {
14
+ CLOUDFLARE_BASELINE_SCOPES,
15
+ CLOUDFLARE_CAPABILITIES,
16
+ CLOUDFLARE_CAPABILITY_SCOPES,
17
+ CLOUDFLARE_FEATURE_PACKS,
18
+ CLOUDFLARE_PERMISSION_CATEGORY_LABELS,
19
+ CLOUDFLARE_PERMISSION_PRODUCTS,
20
+ listCloudflareCapabilities,
21
+ listCloudflareFeaturePacks,
22
+ listCloudflarePermissionProducts,
23
+ listCloudflarePermissionOptionsByCategory,
24
+ assertPermissionCatalogCoversAllScopes,
25
+ getCloudflareCapability,
26
+ getCloudflareFeaturePack,
27
+ scopesForCapabilities,
28
+ scopesForFeaturePacks,
29
+ assessCapabilityAuthorization,
30
+ capabilityAuthorizationMatrix,
31
+ cloudflarePermissionRemediation,
32
+ } from './capabilities.js';
32
33
 
33
- // Full scope catalog for the AgentSam Local Studio OAuth client (182 total,
34
- // pasted directly from the Cloudflare dashboard's own scope picker). This is
35
- // what gets requested at mint time -- one authorize covers everything the
36
- // client is provisioned for, rather than a hand-curated subset that has to
37
- // be edited in code every time a new capability is used. CLOUDFLARE_CAPABILITY_SCOPES
38
- // above stays as documentation of which specific scopes each feature
39
- // actually touches -- it no longer restricts what's requested.
40
- export const CLOUDFLARE_ALL_SCOPES = Object.freeze([
41
- 'agent-memory.write',
42
- 'browser-rendering.read',
43
- 'browser-rendering.write',
44
- 'cf-agents.read',
45
- 'cf-agents.write',
46
- 'cloud-connector.read',
47
- 'cloud-connector.write',
48
- 'cloudchamber.read',
49
- 'cloudchamber.write',
50
- 'constellation.read',
51
- 'constellation.write',
52
- 'd1.read',
53
- 'd1.write',
54
- 'flagship.evaluate',
55
- 'flagship.read',
56
- 'flagship.write',
57
- 'query-cache.read',
58
- 'query-cache.write',
59
- 'k2.read',
60
- 'k2.write',
61
- 'k2.consume',
62
- 'k2.produce',
63
- 'mcp-portals.read',
64
- 'mcp-portals.write',
65
- 'messaging.edit',
66
- 'messaging.read',
67
- 'cfspeed.read',
68
- 'cfspeed.write',
69
- 'page.read',
70
- 'page.write',
71
- 'pipelines.read',
72
- 'pipelines.send',
73
- 'pipelines.write',
74
- 'pubsub.read',
75
- 'pubsub.write',
76
- 'queues.read',
77
- 'queues.write',
78
- 'realtime.write',
79
- 'realtime.admin',
80
- 'realtime.read',
81
- 'secrets-store.read',
82
- 'secrets-store.write',
83
- 'vectorize.read',
84
- 'vectorize.write',
85
- 'workers-ci.read',
86
- 'workers-ci.write',
87
- 'containers.read',
88
- 'containers.write',
89
- 'workers-kv-storage.read',
90
- 'workers-kv-storage.write',
91
- 'workers-observability.read',
92
- 'workers-observability-telemetry.write',
93
- 'workers-observability.write',
94
- 'r2-catalog.read',
95
- 'r2-catalog.write',
96
- 'r2-catalog-sql.read',
97
- 'workers-r2-bucket-item.read',
98
- 'workers-r2-bucket-item.write',
99
- 'workers-r2.read',
100
- 'workers-r2.write',
101
- 'workers-routes.read',
102
- 'workers-routes.write',
103
- 'workers-scripts.read',
104
- 'workers-scripts.write',
105
- 'workers-tail.read',
106
- 'aiaudit.read',
107
- 'aiaudit.write',
108
- 'aig.read',
109
- 'aig.run',
110
- 'aig.write',
111
- 'ai-search.index',
112
- 'ai-search.read',
113
- 'ai-search.run',
114
- 'ai-search.write',
115
- 'agw.read',
116
- 'agw.run',
117
- 'agw.write',
118
- 'rag.read',
119
- 'rag.write',
120
- 'rag.run',
121
- 'firewall-for-ai.read',
122
- 'firewall-for-ai.write',
123
- 'websearch.read',
124
- 'websearch.run',
125
- 'websearch.write',
126
- 'ai-model.read',
127
- 'ai-model.write',
128
- 'ai.read',
129
- 'ai.write',
130
- 'account-dns-settings.read',
131
- 'account-dns-settings.write',
132
- 'dns-firewall.read',
133
- 'dns-firewall.write',
134
- 'dns.read',
135
- 'dns-view.read',
136
- 'dns-view.write',
137
- 'dns.write',
138
- 'registrar-domains.admin',
139
- 'registrar-domains.read',
140
- 'registrar-sandbox-domains.admin',
141
- 'registrar-sandbox-domains.read',
142
- 'zone-custom-asset.read',
143
- 'zone-custom-asset.write',
144
- 'zone-dns-settings.read',
145
- 'zone-dns-settings.write',
146
- 'zone.read',
147
- 'zone-settings.read',
148
- 'zone-settings.write',
149
- 'zone-versioning.read',
150
- 'zone-versioning.write',
151
- 'zone.write',
152
- 'fraud-detection-pii.read',
153
- 'account-firewall-access-rules.read',
154
- 'account-firewall-access-rules.write',
155
- 'account-security-center-insights.read',
156
- 'account-security-center-insights.write',
157
- 'account-waf.read',
158
- 'account-waf.write',
159
- 'request-tracer.read',
160
- 'reports-application-security-report.read',
161
- 'bot-management-feedback.read',
162
- 'bot-management-feedback.write',
163
- 'bot-management.read',
164
- 'bot-management.write',
165
- 'http-applications.read',
166
- 'http-applications.write',
167
- 'http-ddos-managed-ruleset.read',
168
- 'http-ddos-managed-ruleset.write',
169
- 'tag.read',
170
- 'tag.write',
171
- 'url-scanner.read',
172
- 'url-scanner.write',
173
- 'zone-security-center-insights.read',
174
- 'zone-security-center-insights.write',
175
- 'zone-waf.read',
176
- 'zone-waf.write',
177
- 'account-custom-error-rules.read',
178
- 'account-custom-error-rules.write',
179
- 'account-custom-pages.read',
180
- 'account-custom-pages.write',
181
- 'account-rule-lists.read',
182
- 'account-rule-lists.write',
183
- 'account-rulesets.read',
184
- 'account-rulesets.write',
185
- 'config-settings.read',
186
- 'config-settings.write',
187
- 'custom-errors.read',
188
- 'custom-errors.write',
189
- 'custom-pages.read',
190
- 'custom-pages.write',
191
- 'dynamic-redirect.read',
192
- 'dynamic-redirect.write',
193
- 'managed-headers.read',
194
- 'managed-headers.write',
195
- 'mass-url-redirects.read',
196
- 'mass-url-redirects.write',
197
- 'origin.read',
198
- 'origin.write',
199
- 'payments-gateway.read',
200
- 'payments-gateway.write',
201
- 'account-ssl-and-certificates.read',
202
- 'account-ssl-and-certificates.write',
203
- 'cache.purge',
204
- 'cache-settings.read',
205
- 'cache-settings.write',
206
- 'ssl-and-certificates.read',
207
- 'ssl-and-certificates.write',
208
- 'account-api-gateway.write',
209
- 'account-api-gateway.read',
210
- 'account-custom-asset.read',
211
- 'account-custom-asset.write',
212
- 'account-settings.read',
213
- 'account-settings.write',
214
- 'apps.write',
215
- 'integration.write',
216
- 'memberships.read',
217
- 'memberships.write',
218
- 'notifications.read',
219
- 'notifications.write',
220
- 'scim-provisioning.write',
221
- 'user-details.read',
222
- 'offline_access'
223
- ]);
34
+ export {
35
+ upsertCloudflareUserOauthToken,
36
+ revokeCloudflareUserOauthTokens,
37
+ resolveCloudflareAccountId,
38
+ unionScopes,
39
+ } from './oauth-persist.js';
224
40
 
225
- export function requestedCloudflareScopes() {
226
- return [...CLOUDFLARE_ALL_SCOPES];
41
+ export {
42
+ CloudflareApiClient,
43
+ CloudflareApiError,
44
+ resolveCloudflareApiAuth,
45
+ createCloudflareApiClient,
46
+ receipt as cloudflareReceipt,
47
+ } from './api-client.js';
48
+
49
+ export {
50
+ resolveCloudflareCredential,
51
+ credentialSafeMeta,
52
+ loadCloudflareFromUserOauthTokens,
53
+ loadCloudflareFromLegacyConnections,
54
+ loadCloudflareConnectionRecord,
55
+ mapCloudflareOauthRowToConnection,
56
+ } from './credential.js';
57
+
58
+ export * as workflows from './families/workflows.js';
59
+ export * as scanner from './families/scanner.js';
60
+ export * as tags from './families/tags.js';
61
+ export * as tagGateway from './families/tag-gateway.js';
62
+ export * as brandProtection from './families/brand-protection.js';
63
+ export * as keyless from './families/keyless.js';
64
+ export * as tokenValidation from './families/token-validation.js';
65
+ export * as pages from './families/pages.js';
66
+ export * as snippets from './families/snippets.js';
67
+
68
+ import { scopesForCapabilities as _scopesForCapabilities, scopesForFeaturePacks as _scopesForFeaturePacks } from './capabilities.js';
69
+ import { CLOUDFLARE_ALL_SCOPES as _CLOUDFLARE_ALL_SCOPES, isKnownCloudflareScope } from './scope-catalog.js';
70
+
71
+ // Full Local Studio scope catalog — offerable via packs/products; pack `all` opts in wholesale.
72
+ export const CLOUDFLARE_ALL_SCOPES = _CLOUDFLARE_ALL_SCOPES;
73
+ export { isKnownCloudflareScope };
74
+
75
+ /**
76
+ * Scopes requested at OAuth mint / re-authorize.
77
+ * Default: baseline only. Pass `capabilities` and/or `packs` to upgrade deliberately.
78
+ * Host apps supply their own default capability list — this package does not.
79
+ * Pass `{ all: true }` or pack `all` when the user explicitly wants every offerable scope.
80
+ * @param {{ capabilities?: string[], packs?: string[], all?: boolean }} [opts]
81
+ */
82
+ export function requestedCloudflareScopes(opts = {}) {
83
+ if (opts && opts.all === true) return [...CLOUDFLARE_ALL_SCOPES];
84
+ const capabilities = Array.isArray(opts?.capabilities) ? opts.capabilities.filter(Boolean) : [];
85
+ const packs = Array.isArray(opts?.packs) ? opts.packs.filter(Boolean) : [];
86
+ if (packs.map((p) => String(p).toLowerCase()).includes('all')) {
87
+ return [...CLOUDFLARE_ALL_SCOPES];
88
+ }
89
+ if (packs.length) {
90
+ return _scopesForFeaturePacks(packs, capabilities);
91
+ }
92
+ return _scopesForCapabilities({
93
+ capabilities,
94
+ includeBaseline: true,
95
+ generallyAvailableOnly: true,
96
+ });
227
97
  }
228
98
 
99
+
229
100
  function clean(value) {
230
101
  return value == null ? '' : String(value).trim();
231
102
  }
@@ -303,61 +174,27 @@ export function assertConnectionOwner(connection, ownerId) {
303
174
  return connection;
304
175
  }
305
176
 
177
+ /**
178
+ * LEGACY dual-read wrapper — now SSOT-only via user_oauth_tokens.
179
+ * Prefer resolveCloudflareCredential / createCloudflareApiClient.
180
+ */
306
181
  export async function loadCloudflareAccessToken(env, ownerId, options = {}) {
307
- if (!env?.DB || !ownerId) return null;
308
- const row = await env.DB.prepare(`
309
- SELECT connection_id, owner_id, cloudflare_account_id, scopes, status,
310
- access_token_encrypted, refresh_token_encrypted, expires_at
311
- FROM agentsam_cloudflare_connections
312
- WHERE owner_id = ? AND status = 'connected'
313
- ORDER BY updated_at DESC LIMIT 1
314
- `).bind(ownerId).first();
315
- if (!row?.access_token_encrypted || row.owner_id !== ownerId) return null;
316
- const { decryptSecret, sealToken } = await import('./vault.js');
317
- const aad = `cloudflare-connection:${ownerId}`;
318
- let accessToken = await decryptSecret(env, row.access_token_encrypted, aad);
319
- let refreshToken = row.refresh_token_encrypted
320
- ? await decryptSecret(env, row.refresh_token_encrypted, aad)
321
- : '';
322
- let expiresAt = Number(row.expires_at || 0) || null;
323
- let scopes = row.scopes ? String(row.scopes).split(' ').filter(Boolean) : [];
324
- const now = Math.floor(Date.now() / 1000);
325
- if (expiresAt && expiresAt <= now + 60) {
326
- if (!refreshToken) throw new Error('cloudflare_refresh_token_missing');
327
- const refreshParams = new URLSearchParams({
328
- grant_type: 'refresh_token',
329
- refresh_token: refreshToken,
330
- client_id: String(env.CLOUDFLARE_OAUTH_CLIENT_ID || ''),
331
- });
332
- const refreshResponse = await (options.fetchImpl || fetch)(CLOUDFLARE_OAUTH_TOKEN_URL, {
333
- method: 'POST',
334
- headers: { 'content-type': 'application/x-www-form-urlencoded' },
335
- body: refreshParams,
336
- });
337
- if (!refreshResponse.ok) throw new Error(`cloudflare_token_refresh_failed:${refreshResponse.status}`);
338
- const refreshed = await refreshResponse.json();
339
- if (!refreshed?.access_token) throw new Error('cloudflare_token_refresh_missing_access_token');
340
- accessToken = refreshed.access_token;
341
- refreshToken = refreshed.refresh_token || refreshToken;
342
- scopes = String(refreshed.scope || row.scopes || '').split(' ').filter(Boolean);
343
- expiresAt = refreshed.expires_in ? now + Number(refreshed.expires_in) : null;
344
- const [accessEncrypted, refreshEncrypted] = await Promise.all([
345
- sealToken(env, accessToken, aad),
346
- sealToken(env, refreshToken, aad),
347
- ]);
348
- await env.DB.prepare(`
349
- UPDATE agentsam_cloudflare_connections
350
- SET access_token_encrypted = ?, refresh_token_encrypted = ?, scopes = ?,
351
- expires_at = ?, status = 'connected', updated_at = unixepoch()
352
- WHERE connection_id = ? AND owner_id = ?
353
- `).bind(accessEncrypted, refreshEncrypted, scopes.join(' '), expiresAt, row.connection_id, ownerId).run();
354
- }
182
+ const { resolveCloudflareCredential } = await import('./credential.js');
183
+ const cred = await resolveCloudflareCredential({
184
+ env,
185
+ ownerId,
186
+ authMode: 'oauth',
187
+ decryptUserOauthToken: options.decryptUserOauthToken,
188
+ ...options,
189
+ });
190
+ if (!cred?.bearerToken) return null;
355
191
  return {
356
- accessToken,
357
- connectionId: row.connection_id,
358
- accountId: row.cloudflare_account_id || null,
359
- scopes,
360
- expiresAt,
192
+ accessToken: cred.bearerToken,
193
+ connectionId: cred.connectionId,
194
+ accountId: cred.accountId,
195
+ scopes: cred.grantedScopes || [],
196
+ expiresAt: cred.expiresAt,
197
+ source: cred.source,
361
198
  };
362
199
  }
363
200