@inneranimalmedia/agentsam-sdk 2.6.10 → 2.6.11

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 (261) hide show
  1. package/README.md +3 -0
  2. package/TRADEMARKS.md +22 -0
  3. package/apps/README.md +3 -0
  4. package/apps/cad-creator/LICENSE +21 -0
  5. package/apps/cad-creator/README.md +4 -1
  6. package/apps/cad-creator/shared/cad/package.json +1 -1
  7. package/apps/client-cms-editor/LICENSE +21 -0
  8. package/apps/client-cms-editor/README.md +3 -0
  9. package/apps/client-cms-editor/backend/package.json +2 -2
  10. package/apps/client-cms-editor/frontend/package.json +3 -3
  11. package/apps/client-cms-editor/package-lock.json +43 -43
  12. package/apps/client-cms-editor/package.json +3 -3
  13. package/apps/client-cms-editor/reference/harvest/HARVEST_RECEIPT.json +1 -1
  14. package/apps/client-cms-editor/reference/harvest/README.md +1 -1
  15. package/apps/client-cms-editor/reference/harvest/plans/ARCHIVE-INTAKE.md +1 -1
  16. package/apps/client-cms-editor/reference/harvest/plans/HARVEST-INDEX.md +1 -1
  17. package/apps/client-cms-editor/reference/harvest/plans/TOOLING-LAB.md +1 -1
  18. package/apps/client-cms-editor/shared/cms/package.json +1 -1
  19. package/docs/MINI.md +4 -2
  20. package/docs/REPO_FILE_MAP.txt +0 -1
  21. package/docs/SOURCE_ARCHITECTURE.md +1 -1
  22. package/docs/architecture/DUAL_ANALYTICS_PRODUCT.md +140 -0
  23. package/docs/content-studio/REVISION_GATE_2026-09-27.md +1 -1
  24. package/docs/engineering/go-portability/01-product-project-deployment-authority.md +69 -0
  25. package/docs/engineering/provider-internal-renames/01-lane-initialization.md +20 -0
  26. package/docs/engineering/provider-internal-renames/01a-runtime-environment-contract.md +115 -0
  27. package/docs/engineering/provider-internal-renames/02-cfoa.md +57 -0
  28. package/docs/engineering/provider-internal-renames/03-gclioa.md +32 -0
  29. package/docs/engineering/provider-internal-renames/04-goaude.md +50 -0
  30. package/docs/engineering/provider-internal-renames/05-gdrv.md +33 -0
  31. package/docs/engineering/provider-internal-renames/06-verification.md +103 -0
  32. package/docs/engineering/provider-internal-renames/README.md +77 -0
  33. package/docs/engineering/provider-internal-renames/runtime-environment-contract.json +220 -0
  34. package/docs/engineering/test-diagnostics/go-cli-test-hang-20261003.md +49 -0
  35. package/docs/engineering/test-diagnostics/go-skip-deploy-docker-fix.md +90 -0
  36. package/docs/knowledge-service-verification.md +3 -3
  37. package/docs/plans/AGENTSAM-SUSPEND-QUEUE-KNOWLEDGE-RDP-2026-10-03.md +870 -0
  38. package/docs/plans/LOCAL-STUDIO-GRADUATION-2026-09-26.md +9 -9
  39. package/docs/plans/MACHINE-FIRST-APPS-TUI-2026-09-24.md +11 -11
  40. package/docs/plans/RECONCILIATION-2026-09-19.md +6 -6
  41. package/docs/plans/SAM_WORK_PROTOCOL.md +667 -0
  42. package/docs/plans/TOMORROW-EXTENSIVE-TODO-2026-09-26.md +2 -2
  43. package/docs/plans/UNIVERSAL-INGEST-MACHINE-FIRST-2026-09-24.md +3 -3
  44. package/examples/hyperspace-demo/src/main.tsx +227 -110
  45. package/migrations/d1/0020_agentsam_receipt_catalog.sql +35 -0
  46. package/migrations/runtime/0006_agent_run_suspend_activity.sql +53 -0
  47. package/migrations/runtime/0007_queue_control.sql +40 -0
  48. package/migrations/runtime/0008_agent_run_dependencies.sql +24 -0
  49. package/migrations/runtime/0008_analytics_legacy_bootstrap.sql +43 -0
  50. package/migrations/runtime/0009_analytics_authority.sql +108 -0
  51. package/package.json +26 -11
  52. package/packages/agentsam-brand/README.md +3 -0
  53. package/packages/agentsam-brand/package.json +2 -2
  54. package/packages/agentsam-contracts/dist/adapter.d.ts +22 -0
  55. package/packages/agentsam-contracts/dist/adapter.js +0 -0
  56. package/packages/agentsam-contracts/dist/agent.d.ts +66 -0
  57. package/packages/agentsam-contracts/dist/agent.js +15 -0
  58. package/packages/agentsam-contracts/dist/artifacts.d.ts +70 -0
  59. package/packages/agentsam-contracts/dist/artifacts.js +0 -0
  60. package/packages/agentsam-contracts/dist/authority.d.ts +21 -0
  61. package/packages/agentsam-contracts/dist/authority.js +0 -0
  62. package/packages/agentsam-contracts/dist/context.d.ts +14 -0
  63. package/packages/agentsam-contracts/dist/context.js +0 -0
  64. package/packages/agentsam-contracts/dist/errors.d.ts +121 -0
  65. package/packages/agentsam-contracts/dist/errors.js +5 -0
  66. package/packages/agentsam-contracts/dist/events.d.ts +53 -0
  67. package/packages/agentsam-contracts/dist/events.js +0 -0
  68. package/packages/agentsam-contracts/dist/execution.d.ts +38 -0
  69. package/packages/agentsam-contracts/dist/execution.js +0 -0
  70. package/packages/agentsam-contracts/dist/hooks.d.ts +31 -0
  71. package/packages/agentsam-contracts/dist/hooks.js +0 -0
  72. package/packages/agentsam-contracts/dist/identity.d.ts +15 -0
  73. package/packages/agentsam-contracts/dist/identity.js +0 -0
  74. package/packages/agentsam-contracts/dist/index.d.ts +16 -0
  75. package/packages/agentsam-contracts/dist/index.js +164 -0
  76. package/packages/agentsam-contracts/dist/models.d.ts +9 -0
  77. package/packages/agentsam-contracts/dist/models.js +0 -0
  78. package/packages/agentsam-contracts/dist/providers.d.ts +27 -0
  79. package/packages/agentsam-contracts/dist/providers.js +0 -0
  80. package/packages/agentsam-contracts/dist/repository.d.ts +56 -0
  81. package/packages/agentsam-contracts/dist/repository.js +15 -0
  82. package/packages/agentsam-contracts/dist/run.d.ts +113 -0
  83. package/packages/agentsam-contracts/dist/run.js +132 -0
  84. package/packages/agentsam-contracts/dist/tools.d.ts +82 -0
  85. package/packages/agentsam-contracts/dist/tools.js +0 -0
  86. package/packages/agentsam-contracts/dist/widgets.d.ts +38 -0
  87. package/packages/agentsam-contracts/dist/widgets.js +0 -0
  88. package/packages/agentsam-contracts/package.json +9 -1
  89. package/packages/agentsam-contracts/scripts/build.mjs +1 -1
  90. package/packages/agentsam-contracts/src/agent.ts +78 -3
  91. package/packages/agentsam-contracts/src/index.ts +2 -0
  92. package/packages/agentsam-contracts/src/run.ts +320 -0
  93. package/packages/agentsam-contracts/src/widgets.ts +58 -0
  94. package/packages/agentsam-contracts/test/contracts.test.mjs +1 -1
  95. package/packages/agentsam-contracts/test/run-contract.test.mjs +94 -0
  96. package/packages/agentsam-errors/package.json +1 -1
  97. package/packages/agentsam-goap/README.md +3 -0
  98. package/packages/agentsam-goap/package.json +2 -2
  99. package/packages/agentsam-hooks/package.json +2 -2
  100. package/packages/agentsam-hooks/src/adapters/agents.js +48 -22
  101. package/packages/agentsam-hooks/src/index.d.ts +16 -0
  102. package/packages/agentsam-knowledge/package.json +1 -1
  103. package/packages/agentsam-knowledge/src/backends/index.js +1 -1
  104. package/packages/agentsam-merch/README.md +62 -0
  105. package/packages/agentsam-merch/bin/agentsam-merch.mjs +16 -0
  106. package/packages/agentsam-merch/package.json +65 -0
  107. package/packages/agentsam-merch/profiles/completeful/dtg-back-large.json +42 -0
  108. package/packages/agentsam-merch/profiles/completeful/laser-engraving.json +39 -0
  109. package/packages/agentsam-merch/profiles/generic/embroidery-digitization.json +22 -0
  110. package/packages/agentsam-merch/schemas/collection-candidate.schema.json +66 -0
  111. package/packages/agentsam-merch/schemas/manufacturing-profile.schema.json +221 -0
  112. package/packages/agentsam-merch/src/adapters-completeful.js +50 -0
  113. package/packages/agentsam-merch/src/cli.js +93 -0
  114. package/packages/agentsam-merch/src/collection-lab.js +60 -0
  115. package/packages/agentsam-merch/src/compatibility.js +501 -0
  116. package/packages/agentsam-merch/src/derivatives.js +112 -0
  117. package/packages/agentsam-merch/src/index.d.ts +316 -0
  118. package/packages/agentsam-merch/src/index.js +46 -0
  119. package/packages/agentsam-merch/src/node/index.d.ts +58 -0
  120. package/packages/agentsam-merch/src/node/index.js +6 -0
  121. package/packages/agentsam-merch/src/node/raster.js +142 -0
  122. package/packages/agentsam-merch/src/node/vector.js +239 -0
  123. package/packages/agentsam-merch/src/product-concepts.js +118 -0
  124. package/packages/agentsam-merch/src/profile-registry.js +104 -0
  125. package/packages/agentsam-merch/src/profile.js +158 -0
  126. package/packages/agentsam-merch/src/transforms.js +215 -0
  127. package/packages/agentsam-merch/test/merch.test.mjs +332 -0
  128. package/packages/agentsam-merch/test/node-transforms.test.mjs +149 -0
  129. package/packages/agentsam-nav/dist/browser.global.js +71 -34
  130. package/packages/agentsam-nav/dist/browser.js +3179 -781
  131. package/packages/agentsam-nav/dist/index.js +3171 -773
  132. package/packages/agentsam-nav/package.json +1 -1
  133. package/packages/agentsam-queue-control/README.md +4 -1
  134. package/packages/agentsam-queue-control/package.json +4 -3
  135. package/packages/agentsam-queue-control/schemas/job-envelope.schema.json +111 -11
  136. package/packages/agentsam-queue-control/src/adapters/cloudflare.js +34 -6
  137. package/packages/agentsam-queue-control/src/adapters/memory.js +11 -2
  138. package/packages/agentsam-queue-control/src/adapters/sqlite.js +259 -0
  139. package/packages/agentsam-queue-control/src/contracts.js +207 -3
  140. package/packages/agentsam-queue-control/src/control-plane.js +62 -2
  141. package/packages/agentsam-queue-control/src/index.js +1 -0
  142. package/packages/agentsam-queue-control/test/queue-control.test.mjs +310 -0
  143. package/packages/agentsam-queue-control/test/sqlite-adapter.test.mjs +91 -0
  144. package/packages/agentsam-rapid-rust/README.md +3 -0
  145. package/packages/agentsam-repository/README.md +3 -0
  146. package/packages/agentsam-repository/package.json +1 -1
  147. package/packages/agentsam-vault/package.json +1 -1
  148. package/packages/agentsam-workbench/README.md +43 -0
  149. package/packages/agentsam-workbench/package.json +13 -3
  150. package/packages/agentsam-workbench/src/agent/AgentConversationSurface.tsx +108 -0
  151. package/packages/agentsam-workbench/src/agent/AgentPanel.tsx +25 -8
  152. package/packages/agentsam-workbench/src/agent/AgentRuntimeField.tsx +152 -0
  153. package/packages/agentsam-workbench/src/agent/Composer.tsx +10 -1
  154. package/packages/agentsam-workbench/src/agent/RunMode.ts +26 -0
  155. package/packages/agentsam-workbench/src/agent/Thread.tsx +18 -3
  156. package/packages/agentsam-workbench/src/agent/index.ts +3 -0
  157. package/packages/agentsam-workbench/src/index.ts +4 -0
  158. package/packages/agentsam-workbench/src/manufacturing/PreflightIndicator.tsx +203 -0
  159. package/packages/agentsam-workbench/src/manufacturing/index.ts +2 -0
  160. package/packages/agentsam-workbench/src/manufacturing/loading.ts +147 -0
  161. package/packages/agentsam-workbench/src/widgets/BuiltinWidget.tsx +22 -0
  162. package/packages/agentsam-workbench/src/widgets/CountdownWidget.tsx +68 -0
  163. package/packages/agentsam-workbench/src/widgets/WidgetFrame.tsx +56 -0
  164. package/packages/agentsam-workbench/src/widgets/countdown.ts +25 -0
  165. package/packages/agentsam-workbench/src/widgets/index.ts +6 -0
  166. package/packages/agentsam-workbench/src/widgets/registry.ts +13 -0
  167. package/packages/agentsam-workbench/src/widgets/useCountdown.ts +128 -0
  168. package/packages/agentsam-workbench/src/widgets/widgets.css +102 -0
  169. package/packages/connectors/{cloudflare → cfoa}/package.json +3 -3
  170. package/packages/heuristic-theme/package.json +1 -1
  171. package/packages/identity/README.md +3 -0
  172. package/packages/identity/backend/README.md +3 -0
  173. package/packages/identity/package.json +1 -1
  174. package/packages/identity/src/frontend/auth-portal/README.md +3 -0
  175. package/packages/identity/src/index.js +1 -1
  176. package/packages/identity/src/oauth/README.md +4 -1
  177. package/packages/identity/src/oauth/credentials.js +1 -1
  178. package/packages/identity/src/server/worker-router.js +1 -1
  179. package/packages/identity/tests/google-desktop-identity-login.test.mjs +1 -1
  180. package/packages/identity/tests/lane1-packed-consumer.test.mjs +1 -1
  181. package/packages/identity/tests/oauth-presets-accounts-ssot.test.mjs +1 -1
  182. package/packages/providers/completeful/package.json +1 -1
  183. package/packages/theme-church-site/package.json +1 -1
  184. package/packages/theme-companions-site/package.json +1 -1
  185. package/packages/theme-floors-site/package.json +1 -1
  186. package/packages/theme-fuelnfree-site/package.json +1 -1
  187. package/packages/theme-handyman-site/package.json +1 -1
  188. package/packages/theme-insurance-site/package.json +1 -1
  189. package/packages/theme-scenes/package.json +1 -1
  190. package/packages/theme-shinshu-site/package.json +1 -1
  191. package/packages/work-graph/package.json +1 -1
  192. package/protocol/models/README.md +3 -0
  193. package/protocol/receipts/agentsam.receipt.v1.json +95 -0
  194. package/protocol/theme-refinery/receipts/products-registry-batch-20260924.json +6 -6
  195. package/protocol/theme-refinery/receipts/theme-harvest-20260924.json +6 -6
  196. package/skills/README.md +3 -0
  197. package/src/acp/agent-executor.js +106 -0
  198. package/src/acp/client.js +316 -0
  199. package/src/acp/dependencies.js +426 -0
  200. package/src/acp/http.js +207 -0
  201. package/src/acp/index.js +22 -0
  202. package/src/acp/runs.js +125 -0
  203. package/src/acp/runtime-selection.js +180 -0
  204. package/src/cli/command-catalog.js +3 -0
  205. package/src/cli.js +24 -0
  206. package/src/commands/cloudflare-login.js +1 -1
  207. package/src/commands/cloudflare.js +2 -2
  208. package/src/commands/connections.js +1 -1
  209. package/src/commands/go.js +76 -6
  210. package/src/commands/merch.js +5 -0
  211. package/src/commands/mini.js +1 -1
  212. package/src/commands/receipts.js +140 -0
  213. package/src/commands/run.js +253 -0
  214. package/src/go/container.js +1 -1
  215. package/src/go/contract.js +61 -18
  216. package/src/go/discover.js +0 -4
  217. package/src/go/index.js +13 -1
  218. package/src/go/probe.js +109 -0
  219. package/src/go/{cloudflare.js → providers/cloudflare.js} +36 -136
  220. package/src/go/verify.js +1 -1
  221. package/src/indexing/ingest/inventory.js +1 -1
  222. package/src/lib/deploy/local-studio.js +2 -2
  223. package/src/lib/mini/scaffold.js +1 -1
  224. package/src/lib/whoami-capabilities.js +1 -1
  225. package/src/local/runtime-store.js +8 -0
  226. package/src/mcp/cloudflare-bundles.js +1 -1
  227. package/src/plugins/index.js +1 -0
  228. package/src/plugins/registry.js +59 -6
  229. package/src/receipts/contract.js +68 -0
  230. package/src/receipts/index.js +20 -0
  231. package/src/receipts/prune.js +64 -0
  232. package/src/receipts/sinks.js +285 -0
  233. package/templates/mini/gadget/app.js +15 -40
  234. package/templates/mini/gadget/index.html +7 -7
  235. package/templates/mini/shared/style.css +1 -1
  236. package/packages/agentsam-repository/src/goap.js.bak-20260922011251 +0 -670
  237. /package/packages/connectors/{cloudflare → cfoa}/OAUTH_STORAGE_AUDIT.md +0 -0
  238. /package/packages/connectors/{cloudflare → cfoa}/src/api-client.js +0 -0
  239. /package/packages/connectors/{cloudflare → cfoa}/src/capabilities.js +0 -0
  240. /package/packages/connectors/{cloudflare → cfoa}/src/credential.js +0 -0
  241. /package/packages/connectors/{cloudflare → cfoa}/src/families/brand-protection.js +0 -0
  242. /package/packages/connectors/{cloudflare → cfoa}/src/families/keyless.js +0 -0
  243. /package/packages/connectors/{cloudflare → cfoa}/src/families/pages.js +0 -0
  244. /package/packages/connectors/{cloudflare → cfoa}/src/families/scanner.js +0 -0
  245. /package/packages/connectors/{cloudflare → cfoa}/src/families/snippets.js +0 -0
  246. /package/packages/connectors/{cloudflare → cfoa}/src/families/tag-gateway.js +0 -0
  247. /package/packages/connectors/{cloudflare → cfoa}/src/families/tags.js +0 -0
  248. /package/packages/connectors/{cloudflare → cfoa}/src/families/token-validation.js +0 -0
  249. /package/packages/connectors/{cloudflare → cfoa}/src/families/vectorize.js +0 -0
  250. /package/packages/connectors/{cloudflare → cfoa}/src/families/workflows.js +0 -0
  251. /package/packages/connectors/{cloudflare → cfoa}/src/index.js +0 -0
  252. /package/packages/connectors/{cloudflare → cfoa}/src/oauth-persist.js +0 -0
  253. /package/packages/connectors/{cloudflare → cfoa}/src/owner.js +0 -0
  254. /package/packages/connectors/{cloudflare → cfoa}/src/permission-options.js +0 -0
  255. /package/packages/connectors/{cloudflare → cfoa}/src/routes.js +0 -0
  256. /package/packages/connectors/{cloudflare → cfoa}/src/scope-catalog.js +0 -0
  257. /package/packages/connectors/{cloudflare → cfoa}/src/vault.js +0 -0
  258. /package/packages/connectors/{cloudflare → cfoa}/tests/capabilities.test.mjs +0 -0
  259. /package/packages/connectors/{cloudflare → cfoa}/tests/connector.test.mjs +0 -0
  260. /package/packages/connectors/{cloudflare → cfoa}/tests/oauth-persist.test.mjs +0 -0
  261. /package/packages/identity/src/oauth/{google-desktop-exchange.js → goaude.js} +0 -0
package/README.md CHANGED
@@ -289,3 +289,6 @@ tarball fixtures in unrelated repositories, Python tests, and a complete depende
289
289
 
290
290
  License: MIT. Optional visual experiments and host-specific integrations retain their
291
291
  documented boundaries; they are not automatically installed into customer applications.
292
+
293
+ <!-- agentsam:trademark-notice -->
294
+ > Independent project. Not affiliated with, endorsed by, or sponsored by Cloudflare, Inc. or by any other company whose products are named here. Cloudflare is a registered trademark of Cloudflare, Inc. Other names are trademarks of their respective owners. See [TRADEMARKS](https://github.com/SamPrimeaux/agentsam-sdk/blob/main/TRADEMARKS.md).
package/TRADEMARKS.md ADDED
@@ -0,0 +1,22 @@
1
+ <!-- generated by brand_compliance; delete this line to take manual control of this file -->
2
+ # Trademarks, affiliations, and use
3
+
4
+ AgentSam is an independent project of Inner Animal Media.
5
+
6
+ AgentSam is not affiliated with, endorsed by, sponsored by, or partnered with Cloudflare, Inc., or with any other company whose products or services are named in this repository.
7
+
8
+ Cloudflare is a registered trademark of Cloudflare, Inc. Cloudflare Workers, D1, R2, Vectorize, Durable Objects, Cloudflare Images, Cloudflare Stream, Cloudflare Containers, and Wrangler are names of Cloudflare products and services.
9
+
10
+ Other product, service, and company names mentioned in this repository, including Google, GitHub, OpenAI, Anthropic, xAI, Supabase, Vercel, HubSpot, Canva, Meshy, FreeCAD, OpenSCAD, Tauri, Cursor, Resend, Stripe, and Blender, are trademarks or service marks of their respective owners. They are used only to identify the products and services that AgentSam can work with. Their use does not indicate affiliation, endorsement, or sponsorship.
11
+
12
+ ## Naming
13
+
14
+ Packages, commands, skills, and presets in this repository are intended to describe what they do rather than borrow another company's brand. Names of integration targets (adapter ids, CLI subcommands, environment variable names) appear where needed to describe what the software connects to.
15
+
16
+ ## Using AgentSam in your own projects
17
+
18
+ AgentSam may flag common trademark and copyright patterns in a project, for example third-party marks in names, recreated third-party logos, or material without a recorded source. Results are informational. They are not legal advice and are not a determination that anything is or is not infringing, licensed, or approved. You are responsible for the names, marks, images, fonts, text, and code in your own projects and for the licenses and terms that apply to them.
19
+
20
+ ## Contact
21
+
22
+ Questions about names or wording in this repository: https://github.com/SamPrimeaux/agentsam-sdk/issues
package/apps/README.md CHANGED
@@ -62,3 +62,6 @@ npm pack --dry-run --json
62
62
  ```
63
63
 
64
64
  Frontend packages must publish compiled browser-safe assets only when they are intentionally public. Backend packages must keep secrets, `.dev.vars`, local databases, and host credentials out of `files`. Cloudflare Worker configuration remains backend-owned and is deployed separately from the npm tarball unless the app's package contract explicitly includes it.
65
+
66
+ <!-- agentsam:trademark-notice -->
67
+ > Independent project. Not affiliated with, endorsed by, or sponsored by Cloudflare, Inc. or by any other company whose products are named here. Cloudflare is a registered trademark of Cloudflare, Inc. Other names are trademarks of their respective owners. See [TRADEMARKS](https://github.com/SamPrimeaux/agentsam-sdk/blob/main/TRADEMARKS.md).
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Inner Animal Media
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -303,7 +303,7 @@ video-generation workflows
303
303
  real-time WebSocket collaboration
304
304
  owner / editor / viewer collaboration roles
305
305
 
306
- The current implementation uses a React/Three.js frontend with a lightweight TypeScript server and Gemini-powered multimodal capabilities.
306
+ The current implementation uses a React/Three.js frontend with a lightweight TypeScript server and multimodal capabilities that use Gemini.
307
307
 
308
308
  This is still an experimental architecture.
309
309
 
@@ -726,3 +726,6 @@ External engines such as IfcOpenShell, build123d, FreeCAD, OpenSCAD and Blender
726
726
  Use CAD Creator as the production/reference host that proves the abstraction. When an operation survives real app usage, tests, failure cases, discovery, auth/authority rules and deployment, keep that machinery reusable rather than copying it into another app.
727
727
 
728
728
  This is the same product-development pattern used elsewhere in AgentSam: the SDK owns normalized contracts and execution machinery; real applications prove them.
729
+
730
+ <!-- agentsam:trademark-notice -->
731
+ > Independent project. Not affiliated with, endorsed by, or sponsored by Cloudflare, Inc. or by any other company whose products are named here. Cloudflare is a registered trademark of Cloudflare, Inc. Other names are trademarks of their respective owners. See [TRADEMARKS](https://github.com/SamPrimeaux/agentsam-sdk/blob/main/TRADEMARKS.md).
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-cad-shared",
3
- "version": "2.6.10",
3
+ "version": "2.6.11",
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "exports": {
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Inner Animal Media
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -98,3 +98,6 @@ Release (`private:false` required):
98
98
  npm run verify:cms-release
99
99
  npm publish --tag alpha --access public
100
100
  ```
101
+
102
+ <!-- agentsam:trademark-notice -->
103
+ > Independent project. Not affiliated with, endorsed by, or sponsored by Cloudflare, Inc. or by any other company whose products are named here. Cloudflare is a registered trademark of Cloudflare, Inc. Other names are trademarks of their respective owners. See [TRADEMARKS](https://github.com/SamPrimeaux/agentsam-sdk/blob/main/TRADEMARKS.md).
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-cms-backend",
3
- "version": "2.6.10",
3
+ "version": "2.6.11",
4
4
  "description": "Internal CMS backend bridge (bundled into @inneranimalmedia/client-cms-editor — not published separately).",
5
5
  "type": "module",
6
6
  "exports": {
@@ -14,7 +14,7 @@
14
14
  "typecheck": "tsc --noEmit -p tsconfig.json"
15
15
  },
16
16
  "dependencies": {
17
- "@inneranimalmedia/agentsam-cms-shared": "2.6.10"
17
+ "@inneranimalmedia/agentsam-cms-shared": "2.6.11"
18
18
  },
19
19
  "devDependencies": {
20
20
  "typescript": "^5.9.3"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-cms-frontend",
3
- "version": "2.6.10",
3
+ "version": "2.6.11",
4
4
  "description": "Internal CMS frontend (bundled into @inneranimalmedia/client-cms-editor — not published separately).",
5
5
  "type": "module",
6
6
  "exports": {
@@ -15,8 +15,8 @@
15
15
  "test": "vitest run --passWithNoTests"
16
16
  },
17
17
  "dependencies": {
18
- "@inneranimalmedia/agentsam-cms-backend": "2.6.10",
19
- "@inneranimalmedia/agentsam-cms-shared": "2.6.10",
18
+ "@inneranimalmedia/agentsam-cms-backend": "2.6.11",
19
+ "@inneranimalmedia/agentsam-cms-shared": "2.6.11",
20
20
  "react": "^19.2.0",
21
21
  "react-dom": "^19.2.0"
22
22
  },
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/client-cms-editor",
3
- "version": "2.6.10",
3
+ "version": "2.6.11",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@inneranimalmedia/client-cms-editor",
9
- "version": "2.6.10",
10
- "license": "UNLICENSED",
9
+ "version": "2.6.11",
10
+ "license": "MIT",
11
11
  "workspaces": [
12
12
  "frontend",
13
13
  "backend",
@@ -25,7 +25,7 @@
25
25
  "react-dom": "^19.2.0",
26
26
  "tsup": "^8.5.0",
27
27
  "typescript": "^5.9.3",
28
- "wrangler": "4.145.0"
28
+ "wrangler": "4.147.0"
29
29
  },
30
30
  "engines": {
31
31
  "node": ">=20"
@@ -37,9 +37,9 @@
37
37
  },
38
38
  "backend": {
39
39
  "name": "@inneranimalmedia/agentsam-cms-backend",
40
- "version": "2.6.10",
40
+ "version": "2.6.11",
41
41
  "dependencies": {
42
- "@inneranimalmedia/agentsam-cms-shared": "2.6.10"
42
+ "@inneranimalmedia/agentsam-cms-shared": "2.6.11"
43
43
  },
44
44
  "devDependencies": {
45
45
  "typescript": "^5.9.3"
@@ -47,10 +47,10 @@
47
47
  },
48
48
  "frontend": {
49
49
  "name": "@inneranimalmedia/agentsam-cms-frontend",
50
- "version": "2.6.10",
50
+ "version": "2.6.11",
51
51
  "dependencies": {
52
- "@inneranimalmedia/agentsam-cms-backend": "2.6.10",
53
- "@inneranimalmedia/agentsam-cms-shared": "2.6.10",
52
+ "@inneranimalmedia/agentsam-cms-backend": "2.6.11",
53
+ "@inneranimalmedia/agentsam-cms-shared": "2.6.11",
54
54
  "react": "^19.2.0",
55
55
  "react-dom": "^19.2.0"
56
56
  },
@@ -372,9 +372,9 @@
372
372
  }
373
373
  },
374
374
  "node_modules/@cloudflare/workerd-darwin-64": {
375
- "version": "1.20260930.2",
376
- "resolved": "https://registry.npmjs.org/@cloudflare/workerd-darwin-64/-/workerd-darwin-64-1.20260930.2.tgz",
377
- "integrity": "sha512-wxKsfekWeev6xkjHEMx3x7nz6WfWOn1/scQ8geqWQhUm8qRl1ZRZhjnj+rucIMLhLhP9RGSYMZIjEm3AV0zwVQ==",
375
+ "version": "1.20261001.1",
376
+ "resolved": "https://registry.npmjs.org/@cloudflare/workerd-darwin-64/-/workerd-darwin-64-1.20261001.1.tgz",
377
+ "integrity": "sha512-4cgSgDf28JSw/P5Dj5GCS59hzVqS5XnmGAWNkvYHLI6ODU9idGaMMNEuhJXDkEG/lsABmlVlnCgsdh2VbKWepw==",
378
378
  "cpu": [
379
379
  "x64"
380
380
  ],
@@ -389,9 +389,9 @@
389
389
  }
390
390
  },
391
391
  "node_modules/@cloudflare/workerd-darwin-arm64": {
392
- "version": "1.20260930.2",
393
- "resolved": "https://registry.npmjs.org/@cloudflare/workerd-darwin-arm64/-/workerd-darwin-arm64-1.20260930.2.tgz",
394
- "integrity": "sha512-cviPpheZGQ2H5X+Ctxd3wfxhksNrdyoNprjSgg3br2+psetKacjdEvK8CILdN/2GF+u1KOExvr45amSL6lgzGA==",
392
+ "version": "1.20261001.1",
393
+ "resolved": "https://registry.npmjs.org/@cloudflare/workerd-darwin-arm64/-/workerd-darwin-arm64-1.20261001.1.tgz",
394
+ "integrity": "sha512-8ulAWruEVouNmEIsQsy9WSSCS9zkLu93W2MTwp5esiFyoPp05BNSVFIFsYSPi1pkFmBBd7fsnwMpbLkaJLaVPQ==",
395
395
  "cpu": [
396
396
  "arm64"
397
397
  ],
@@ -406,9 +406,9 @@
406
406
  }
407
407
  },
408
408
  "node_modules/@cloudflare/workerd-linux-64": {
409
- "version": "1.20260930.2",
410
- "resolved": "https://registry.npmjs.org/@cloudflare/workerd-linux-64/-/workerd-linux-64-1.20260930.2.tgz",
411
- "integrity": "sha512-cwrJAC5y/avPd1OzGyhc5OvUUfPXBFc065TY5CjXp7Hb3dhiTx6JeB5Pc8L3G8L8M44HyAfRHSpoLtRr+SR3cQ==",
409
+ "version": "1.20261001.1",
410
+ "resolved": "https://registry.npmjs.org/@cloudflare/workerd-linux-64/-/workerd-linux-64-1.20261001.1.tgz",
411
+ "integrity": "sha512-kZbTZJGrhsMOdqZ2BIybjaBRLZjYsRLWj7mcNw/6Y3hodOhp5MrNzcz4iWGwNVWwyIV+7Pl+/LX5VcgnRqdHOg==",
412
412
  "cpu": [
413
413
  "x64"
414
414
  ],
@@ -423,9 +423,9 @@
423
423
  }
424
424
  },
425
425
  "node_modules/@cloudflare/workerd-linux-arm64": {
426
- "version": "1.20260930.2",
427
- "resolved": "https://registry.npmjs.org/@cloudflare/workerd-linux-arm64/-/workerd-linux-arm64-1.20260930.2.tgz",
428
- "integrity": "sha512-FHucB4gak1IuT+IxLx3KbtMBMapZhcqD9EdhHvBxk1FpHwD2QU5x26MRRVN53jIKG/O25HUmE9yffb3cMANQgw==",
426
+ "version": "1.20261001.1",
427
+ "resolved": "https://registry.npmjs.org/@cloudflare/workerd-linux-arm64/-/workerd-linux-arm64-1.20261001.1.tgz",
428
+ "integrity": "sha512-oOk3Zj6k/8oP0FJgZBWDn7+BqbsqIMEMaV95pulHPVbwVu4wYoLfQq2hp0vkbCNsCFLqZb7cqixXdrwD54ZIow==",
429
429
  "cpu": [
430
430
  "arm64"
431
431
  ],
@@ -440,9 +440,9 @@
440
440
  }
441
441
  },
442
442
  "node_modules/@cloudflare/workerd-windows-64": {
443
- "version": "1.20260930.2",
444
- "resolved": "https://registry.npmjs.org/@cloudflare/workerd-windows-64/-/workerd-windows-64-1.20260930.2.tgz",
445
- "integrity": "sha512-JHFMdGFMqP+M2QiVzZq1S8Ie66Gvxo7Og5EYz/KtmDvGCqge5L3lK+ksZxAhF3j/tpSLqdvlUvcTKoR9PkwTTQ==",
443
+ "version": "1.20261001.1",
444
+ "resolved": "https://registry.npmjs.org/@cloudflare/workerd-windows-64/-/workerd-windows-64-1.20261001.1.tgz",
445
+ "integrity": "sha512-uRxm5W4VyBkoSaoP1BfOuH0873tE+vxsknF4sab6/5YIRvIAufChq3QDp+zlAn67PuGPGcn7W8QraA0t4ucmOQ==",
446
446
  "cpu": [
447
447
  "x64"
448
448
  ],
@@ -2681,16 +2681,16 @@
2681
2681
  }
2682
2682
  },
2683
2683
  "node_modules/miniflare": {
2684
- "version": "5.20260930.0-alpha",
2685
- "resolved": "https://registry.npmjs.org/miniflare/-/miniflare-5.20260930.0-alpha.tgz",
2686
- "integrity": "sha512-vZljfRtOEeynbhJtuvYsnCU8t6zF5wIUm9ql4YFHB7zvYw2+F2tpT0BzXjzaa++eiUIml1gsODCf02qShBmJdg==",
2684
+ "version": "5.20261001.0-alpha",
2685
+ "resolved": "https://registry.npmjs.org/miniflare/-/miniflare-5.20261001.0-alpha.tgz",
2686
+ "integrity": "sha512-GaimS5mSIOMyvd16ga+e1/QkI8cmp3z35QPHFex0DktqNQf2RVZQwMPQXdyoUreUiFP/0Gpe2MoQInTyMAD5xA==",
2687
2687
  "dev": true,
2688
2688
  "license": "MIT",
2689
2689
  "dependencies": {
2690
2690
  "@cspotcode/source-map-support": "0.8.1",
2691
2691
  "sharp": "0.35.4",
2692
2692
  "undici": "7.29.1",
2693
- "workerd": "1.20260930.2",
2693
+ "workerd": "1.20261001.1",
2694
2694
  "ws": "8.21.0",
2695
2695
  "youch": "4.1.0-beta.10"
2696
2696
  },
@@ -4066,9 +4066,9 @@
4066
4066
  }
4067
4067
  },
4068
4068
  "node_modules/workerd": {
4069
- "version": "1.20260930.2",
4070
- "resolved": "https://registry.npmjs.org/workerd/-/workerd-1.20260930.2.tgz",
4071
- "integrity": "sha512-k1lQzEiGyCDqaRsR5+o9PBT5wVU5omtas6hXx3spbEHHMFo8a7tkAixVCMsWFeiT7xhrmg21Hd6a9jLNrkcUMg==",
4069
+ "version": "1.20261001.1",
4070
+ "resolved": "https://registry.npmjs.org/workerd/-/workerd-1.20261001.1.tgz",
4071
+ "integrity": "sha512-d/SIYHFO0PT/wiFZg8in4NpRIxYuFwslX1HdylOtWkBIIUmSpkGFhK820cV84XACFylwJ48xuRoWW/8DWDPsPQ==",
4072
4072
  "dev": true,
4073
4073
  "hasInstallScript": true,
4074
4074
  "license": "Apache-2.0",
@@ -4079,17 +4079,17 @@
4079
4079
  "node": ">=16"
4080
4080
  },
4081
4081
  "optionalDependencies": {
4082
- "@cloudflare/workerd-darwin-64": "1.20260930.2",
4083
- "@cloudflare/workerd-darwin-arm64": "1.20260930.2",
4084
- "@cloudflare/workerd-linux-64": "1.20260930.2",
4085
- "@cloudflare/workerd-linux-arm64": "1.20260930.2",
4086
- "@cloudflare/workerd-windows-64": "1.20260930.2"
4082
+ "@cloudflare/workerd-darwin-64": "1.20261001.1",
4083
+ "@cloudflare/workerd-darwin-arm64": "1.20261001.1",
4084
+ "@cloudflare/workerd-linux-64": "1.20261001.1",
4085
+ "@cloudflare/workerd-linux-arm64": "1.20261001.1",
4086
+ "@cloudflare/workerd-windows-64": "1.20261001.1"
4087
4087
  }
4088
4088
  },
4089
4089
  "node_modules/wrangler": {
4090
- "version": "4.145.0",
4091
- "resolved": "https://registry.npmjs.org/wrangler/-/wrangler-4.145.0.tgz",
4092
- "integrity": "sha512-TdO9l7RNqM2Kb5/AynhlRPF9WPhaI0W4Gcpq2FkyU1iZ+xPW25sfV8Yc48PsI1GsNEFOfdh2RTOIpW8U22AqHw==",
4090
+ "version": "4.147.0",
4091
+ "resolved": "https://registry.npmjs.org/wrangler/-/wrangler-4.147.0.tgz",
4092
+ "integrity": "sha512-pQYRoiq8PTAxphaG69z8+GC1DkSGd19EDZehQ8zxjo/Ko3mRB6Qs1mTrd8ZuKAarLklIjTqr1lUdCK9r4q2hUg==",
4093
4093
  "dev": true,
4094
4094
  "license": "MIT OR Apache-2.0",
4095
4095
  "dependencies": {
@@ -4097,10 +4097,10 @@
4097
4097
  "@cloudflare/unenv-preset": "2.16.2",
4098
4098
  "blake3-wasm": "2.1.5",
4099
4099
  "esbuild": "0.28.1",
4100
- "miniflare": "5.20260930.0-alpha",
4100
+ "miniflare": "5.20261001.0-alpha",
4101
4101
  "path-to-regexp": "6.3.0",
4102
4102
  "unenv": "2.0.0-rc.24",
4103
- "workerd": "1.20260930.2"
4103
+ "workerd": "1.20261001.1"
4104
4104
  },
4105
4105
  "bin": {
4106
4106
  "cf-wrangler": "bin/cf-wrangler.js",
@@ -4114,7 +4114,7 @@
4114
4114
  "fsevents": "2.3.3"
4115
4115
  },
4116
4116
  "peerDependencies": {
4117
- "@cloudflare/workers-types": "^5.20260930.2"
4117
+ "@cloudflare/workers-types": "^5.20261001.1"
4118
4118
  },
4119
4119
  "peerDependenciesMeta": {
4120
4120
  "@cloudflare/workers-types": {
@@ -4662,7 +4662,7 @@
4662
4662
  },
4663
4663
  "shared/cms": {
4664
4664
  "name": "@inneranimalmedia/agentsam-cms-shared",
4665
- "version": "2.6.10",
4665
+ "version": "2.6.11",
4666
4666
  "devDependencies": {
4667
4667
  "typescript": "^5.9.3"
4668
4668
  }
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/client-cms-editor",
3
- "version": "2.6.10",
3
+ "version": "2.6.11",
4
4
  "private": false,
5
5
  "description": "Reusable full-stack website + CMS kit with multi-page public sites, a protected authoring dashboard, local SQLite, starter/theme import, and pluggable auth, storage, and deployment adapters.",
6
6
  "type": "module",
7
- "license": "UNLICENSED",
7
+ "license": "MIT",
8
8
  "workspaces": [
9
9
  "frontend",
10
10
  "backend",
@@ -109,7 +109,7 @@
109
109
  "react-dom": "^19.2.0",
110
110
  "tsup": "^8.5.0",
111
111
  "typescript": "^5.9.3",
112
- "wrangler": "4.145.0"
112
+ "wrangler": "4.147.0"
113
113
  },
114
114
  "engines": {
115
115
  "node": ">=20"
@@ -9,7 +9,7 @@
9
9
  "M package-lock.json"
10
10
  ]
11
11
  },
12
- "output": "/Users/samprimeaux/studio-cms-editor-harvest-export",
12
+ "output": "local-donor://studio-cms-editor-harvest-export",
13
13
  "lanes": {
14
14
  "cms_editor_donor": [
15
15
  {
@@ -2,7 +2,7 @@
2
2
 
3
3
  Copied from `~/.agentsam/harvest/studio-cms-editor-20260929` for in-tree acceptance.
4
4
 
5
- - Donor behavioral authority remains `/Users/samprimeaux/studio-cms-editor` (not modified by this lane).
5
+ - Donor behavioral authority remains `local-donor://studio-cms-editor` (not modified by this lane).
6
6
  - Plans under `plans/` define what to keep, adapt, and drop.
7
7
  - Do not treat this folder as a runtime dependency of the published editor UI.
8
8
  - Forbidden-string scanners skip this directory so historical donor docs can mention deployment names without becoming product code.
@@ -122,7 +122,7 @@ The full AgentSam acceptance lab now accepts archive paths positionally:
122
122
 
123
123
  ```bash
124
124
  python3 scripts/harvest_tooling_lab.py \
125
- --sdk /Users/samprimeaux/agentsam-sdk \
125
+ --sdk repo://agentsam-sdk \
126
126
  --replace-export \
127
127
  --replace-db \
128
128
  ~/Downloads/theme-one.zip \
@@ -153,7 +153,7 @@ To stage the curated export inside AgentSam SDK without touching active packages
153
153
 
154
154
  ```bash
155
155
  python3 scripts/harvest_all.py \
156
- --sdk /Users/samprimeaux/agentsam-sdk \
156
+ --sdk repo://agentsam-sdk \
157
157
  --stage-sdk
158
158
  ```
159
159
 
@@ -52,7 +52,7 @@ The fixture has its own disposable Git repository and .agentsam directory so tes
52
52
 
53
53
  Suggested command:
54
54
 
55
- python3 scripts/harvest_tooling_lab.py --sdk /Users/samprimeaux/agentsam-sdk --replace-export --replace-db
55
+ python3 scripts/harvest_tooling_lab.py --sdk repo://agentsam-sdk --replace-export --replace-db
56
56
 
57
57
  For the wider product, use the same acceptance fixture on:
58
58
  - local CLI / desktop
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-cms-shared",
3
- "version": "2.6.10",
3
+ "version": "2.6.11",
4
4
  "description": "Internal CMS shared contracts (bundled into @inneranimalmedia/client-cms-editor — not published separately).",
5
5
  "type": "module",
6
6
  "exports": {
package/docs/MINI.md CHANGED
@@ -3,12 +3,12 @@
3
3
  Create a small local gadget, page, or data prototype with one command:
4
4
 
5
5
  ```bash
6
- agentsam mini focus-timer --open
6
+ agentsam mini quick-tool --open
7
7
  agentsam mini landing --template page
8
8
  agentsam mini json-viewer --template data
9
9
  ```
10
10
 
11
- The default `gadget` starter is a working focus timer. `page` offers an editable headline preview; `data` accepts and filters JSON entirely in the browser. These are ordinary HTML, CSS, and JavaScript files, with no dependency install, framework, AI call, credential setup, or container.
11
+ The default `gadget` starter is a neutral interactive canvas. `page` offers an editable headline preview; `data` accepts and filters JSON entirely in the browser. These are ordinary HTML, CSS, and JavaScript files, with no dependency install, framework, AI call, credential setup, or container.
12
12
 
13
13
  ## Files and preview lifecycle
14
14
 
@@ -32,3 +32,5 @@ agentsam mini --help
32
32
  - Multiple minis can be previewed in separate terminals; automatic ports avoid conflicts. `--open` is optional.
33
33
 
34
34
  `agentsam init` still creates the full local agent project with SQLite and runtime adapters. Mini is the smaller static-prototype path; it does not add an AI backend or publish anything.
35
+
36
+ Mini starters are scaffolds for local prototyping, not a catalog of installable prebuilds. Product features belong in their owning app or reusable package once they prove useful.
@@ -84,7 +84,6 @@ this orientation map as revision authority.
84
84
  |-- registry/ Tool and domain registries
85
85
  |-- examples/, assets/ Examples and shared assets
86
86
  |-- sites/ Public-site source/content
87
- |-- focus-timer/ Separate tracked top-level mini-app/site
88
87
  |-- .github/, .changeset/ CI workflows and release metadata
89
88
  `-- tags/ Repository tag metadata
90
89
 
@@ -36,7 +36,7 @@ Package behavior belongs with the package:
36
36
  packages/identity/tests/*
37
37
  packages/agentsam-contracts/test/*
38
38
  packages/agentsam-workbench/test/*
39
- packages/connectors/cloudflare/tests/*
39
+ packages/connectors/cfoa/tests/*
40
40
  ```
41
41
 
42
42
  Root SDK tests should move toward explicit roles:
@@ -0,0 +1,140 @@
1
+ # Dual Analytics Product Architecture
2
+
3
+ ## Non-negotiable boundary
4
+
5
+ Commerce analytics and AgentSam runtime analytics are both first-class products.
6
+
7
+ Do not collapse ecommerce into AgentSam telemetry merely because AgentSam can
8
+ measure AI cost or execute ecommerce work.
9
+
10
+ ```text
11
+ @inneranimalmedia/analytics-ui
12
+ / / @inneranimalmedia/commerce-analytics @inneranimalmedia/agentsam-analytics
13
+ | |
14
+ revenue/orders/products/customers runs/tools/models/GOAP
15
+ conversion/COGS/cohorts/AOV waits/retries/cost/scores
16
+ store health + AI attribution runtime health + priors
17
+ ```
18
+
19
+ ## Commerce stays commerce-owned
20
+
21
+ Examples:
22
+
23
+ - gross revenue
24
+ - orders
25
+ - average order value
26
+ - units sold
27
+ - product mix
28
+ - conversion funnel
29
+ - customer cohorts
30
+ - repeat customer rate
31
+ - pending/refunded share
32
+ - estimated COGS
33
+ - gross margin
34
+ - commerce infrastructure health
35
+ - AgentSam AI spend attributable to commerce operations
36
+
37
+ An order is not an AgentSam event.
38
+ A customer is not a model run.
39
+ Revenue is not a generic reward signal.
40
+
41
+ ## AgentSam runtime analytics stays runtime-owned
42
+
43
+ Examples:
44
+
45
+ - run/tool/model events
46
+ - GOAP transitions
47
+ - verification gates
48
+ - test results
49
+ - duration
50
+ - active model time
51
+ - queue wait
52
+ - external wait
53
+ - retries
54
+ - token usage
55
+ - provider/model cost
56
+ - failure origin
57
+ - artifact references
58
+ - versioned score families
59
+
60
+ ## Correlation, not collapse
61
+
62
+ The domains may correlate through stable identifiers such as:
63
+
64
+ - account_id
65
+ - tenant_id
66
+ - run_id
67
+ - receipt_id
68
+ - source_id
69
+ - dimensions.order_id
70
+ - dimensions.product_id
71
+ - dimensions.customer_id
72
+ - dimensions.campaign_id
73
+
74
+ This enables useful cross-domain questions:
75
+
76
+ - AI cost per fulfilled order
77
+ - image-generation cost per sellable product
78
+ - merchandising automation cost vs gross margin
79
+ - support-agent cost per resolved commerce incident
80
+ - test/deploy cost per storefront release
81
+
82
+ ## Storage/read path
83
+
84
+ ```text
85
+ meaningful AgentSam operation
86
+ |
87
+ v
88
+ emitAnalyticsFact()
89
+ |
90
+ +--> agentsam_analytics (D1 hot fact authority)
91
+ |
92
+ +--> AGENTSAM_ACTIVITY -> Basin -> Iceberg/Parquet
93
+ ```
94
+
95
+ Commerce continues to use commerce-owned operational and aggregate sources.
96
+
97
+ UI reads stable read models, never raw tables directly.
98
+
99
+ ## Visual grammar
100
+
101
+ Fuel & Free Time remains the donor:
102
+
103
+ - light application shell
104
+ - dark analytical cards
105
+ - compact KPI row
106
+ - dense tables
107
+ - range selector
108
+ - status indicators
109
+ - sparklines
110
+ - time-series charts
111
+ - health/incident views
112
+
113
+ AgentSam surfaces:
114
+ - Overview
115
+ - Usage & Cost
116
+ - Performance
117
+ - Health
118
+ - Scores
119
+
120
+ Commerce surfaces stay intact and can grow:
121
+ - Overview
122
+ - Finance
123
+ - Health
124
+ - Merch
125
+ - Products
126
+ - Customers
127
+ - Fulfillment
128
+ - Marketing
129
+ - AI Cost Attribution
130
+
131
+ ## Instrumentation law
132
+
133
+ Do not instrument every helper.
134
+
135
+ Instrument meaningful boundaries that consume:
136
+ time, tokens, paid APIs, compute, I/O, network, queue capacity, storage,
137
+ external quota, or durable state mutation.
138
+
139
+ Raw facts are evidence.
140
+ Scores are recomputable interpretations.
@@ -260,7 +260,7 @@ forces a package change, the seam is wrong.
260
260
 
261
261
  | Field | Value |
262
262
  |---|---|
263
- | Worktree | `/Users/samprimeaux/agent-worktrees/content-studio-audit` |
263
+ | Worktree | `worktree://content-studio-audit` |
264
264
  | Branch | `audit/agentsam-content-studio-transplant-20260927` |
265
265
  | Base head | `28ef451` (transplant on main) |
266
266
  | Brand audit | `/tmp/agentsam-brand-authority-audit.json` |