@inneranimalmedia/agentsam-sdk 2.6.2 → 2.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (497) hide show
  1. package/AGENTSAM.md +45 -1
  2. package/README.md +80 -0
  3. package/apps/README.md +34 -0
  4. package/apps/cad-creator/README.md +728 -0
  5. package/apps/cad-creator/shared/cad/package.json +19 -0
  6. package/apps/cad-creator/shared/cad/src/domain/operations.ts +7 -0
  7. package/apps/cad-creator/shared/cad/src/domain/project-contract.d.ts +3 -0
  8. package/apps/cad-creator/shared/cad/src/domain/project-contract.js +75 -0
  9. package/apps/cad-creator/shared/cad/src/domain/project-tools.d.ts +1 -0
  10. package/apps/cad-creator/shared/cad/src/domain/project-tools.js +24 -0
  11. package/apps/cad-creator/shared/cad/src/domain/validation.ts +191 -0
  12. package/apps/cad-creator/shared/cad/src/index.ts +4 -0
  13. package/apps/cad-creator/shared/cad/src/robotics/types.ts +232 -0
  14. package/apps/cad-creator/shared/cad/src/types.ts +507 -0
  15. package/apps/cad-creator/shared/cad/tsconfig.json +14 -0
  16. package/docs/AUTORAG.md +58 -0
  17. package/docs/BRAND_INTELLIGENCE.md +30 -0
  18. package/docs/CLI_SHELL.md +4 -2
  19. package/docs/CMS_CONTEXTUAL_COMPOSER.md +38 -0
  20. package/docs/MERKLE.md +4 -0
  21. package/docs/PROJECT_CONFIG.md +3 -0
  22. package/docs/REPOSITORY_KNOWLEDGE.md +2 -0
  23. package/docs/THEME_REFINERY.md +120 -0
  24. package/docs/architecture/PROVIDER-TOOLS-AND-COMPACTION.md +60 -0
  25. package/docs/architecture/STORAGE.md +87 -0
  26. package/docs/cad-project-tools.md +69 -0
  27. package/docs/cms-scaffolding-pattern-reference.md +73 -0
  28. package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS-codex-tui-20260919.md +113 -0
  29. package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS.md +85 -0
  30. package/docs/plans/AGENTSAM-MCP-CLIENT-2026-09-19.md +181 -0
  31. package/docs/plans/ASBD-PORTABLE-WORKGRAPH-UI-DEFERRED.md +34 -0
  32. package/docs/plans/ASTRA-BRIEF-2026-09-18.md +258 -0
  33. package/docs/plans/MULTI-AGENT-SPRINTS-2026-09-19.md +373 -0
  34. package/docs/plans/NEXT-AGENT-HANDOFF.md +167 -0
  35. package/docs/plans/RECONCILIATION-2026-09-19.md +178 -0
  36. package/docs/plugins.md +43 -0
  37. package/docs/tools/README.md +57 -0
  38. package/docs/tools/agent-and-orchestration.md +49 -0
  39. package/docs/tools/browser-and-research.md +46 -0
  40. package/docs/tools/cloudflare-platform.md +32 -0
  41. package/docs/tools/cms.md +25 -0
  42. package/docs/tools/communications.md +41 -0
  43. package/docs/tools/database-and-storage.md +62 -0
  44. package/docs/tools/design-and-media.md +64 -0
  45. package/docs/tools/filesystem-and-code.md +55 -0
  46. package/docs/tools/github.md +56 -0
  47. package/docs/tools/integrations-and-misc.md +16 -0
  48. package/docs/tools/memory.md +21 -0
  49. package/docs/tools/terminal-and-execution.md +29 -0
  50. package/docs/tools/tickets-and-platform.md +30 -0
  51. package/migrations/d1/0001_agentsam_plugin_runtime.sql +177 -0
  52. package/migrations/d1/0002_agentsam_ticket_ownership.sql +8 -0
  53. package/migrations/d1/0002_dynamic_model_policies.sql +23 -0
  54. package/migrations/d1/0003_expand_tool_handler_families.sql +18 -0
  55. package/migrations/d1/0004_project_aware_retrieval_lanes.sql +24 -0
  56. package/migrations/d1/0005_portable_knowledge_identity.sql +104 -0
  57. package/migrations/d1/0006_repair_ops_trail_account_scope.sql +14 -0
  58. package/migrations/d1/0007_repair_ops_trail_agent_run_account.sql +13 -0
  59. package/migrations/d1/0008_backfill_knowledge_run_legacy_tenant.sql +14 -0
  60. package/migrations/d1/0009_normalize_cloudflare_plugin_installations.sql +137 -0
  61. package/migrations/runtime/0001_cli_runtime.sql +67 -0
  62. package/migrations/runtime/0002_project_sessions.sql +15 -0
  63. package/migrations/runtime/0003_provider_continuations.sql +8 -0
  64. package/package.json +92 -12
  65. package/packages/agentsam-brand/README.md +21 -0
  66. package/packages/agentsam-brand/package.json +22 -0
  67. package/packages/agentsam-brand/src/contract.js +59 -0
  68. package/packages/agentsam-brand/src/extract.js +126 -0
  69. package/packages/agentsam-brand/src/goap-actions.js +73 -0
  70. package/packages/agentsam-brand/src/index.js +48 -0
  71. package/packages/agentsam-brand/src/plan.js +115 -0
  72. package/packages/agentsam-brand/src/resolve.js +139 -0
  73. package/packages/agentsam-brand/src/scan.js +250 -0
  74. package/packages/agentsam-brand/test/brand-scan.test.mjs +106 -0
  75. package/packages/agentsam-contracts/README.md +23 -0
  76. package/packages/agentsam-contracts/package.json +32 -0
  77. package/packages/agentsam-contracts/src/adapter.ts +25 -0
  78. package/packages/agentsam-contracts/src/agent.ts +35 -0
  79. package/packages/agentsam-contracts/src/artifacts.ts +33 -0
  80. package/packages/agentsam-contracts/src/authority.ts +29 -0
  81. package/packages/agentsam-contracts/src/context.ts +16 -0
  82. package/packages/agentsam-contracts/src/errors.ts +46 -0
  83. package/packages/agentsam-contracts/src/events.ts +47 -0
  84. package/packages/agentsam-contracts/src/execution.ts +50 -0
  85. package/packages/agentsam-contracts/src/hooks.ts +40 -0
  86. package/packages/agentsam-contracts/src/identity.ts +16 -0
  87. package/packages/agentsam-contracts/src/index.ts +14 -0
  88. package/packages/agentsam-contracts/src/models.ts +9 -0
  89. package/packages/agentsam-contracts/src/providers.ts +33 -0
  90. package/packages/agentsam-contracts/src/repository.ts +64 -0
  91. package/packages/agentsam-contracts/src/tools.ts +98 -0
  92. package/packages/agentsam-contracts/test/contracts.test.mjs +16 -0
  93. package/packages/agentsam-contracts/test/errors-catalog.test.mjs +25 -0
  94. package/packages/agentsam-contracts/test/repository.test.mjs +18 -0
  95. package/packages/agentsam-contracts/tsconfig.json +12 -0
  96. package/packages/agentsam-errors/package.json +17 -0
  97. package/packages/agentsam-errors/src/adapters/anthropic.js +15 -0
  98. package/packages/agentsam-errors/src/adapters/cad.js +109 -0
  99. package/packages/agentsam-errors/src/adapters/cloudflare.js +21 -0
  100. package/packages/agentsam-errors/src/adapters/cursor.js +4 -0
  101. package/packages/agentsam-errors/src/adapters/device.js +38 -0
  102. package/packages/agentsam-errors/src/adapters/docker.js +28 -0
  103. package/packages/agentsam-errors/src/adapters/gcp.js +14 -0
  104. package/packages/agentsam-errors/src/adapters/github.js +22 -0
  105. package/packages/agentsam-errors/src/adapters/google.js +17 -0
  106. package/packages/agentsam-errors/src/adapters/index.js +55 -0
  107. package/packages/agentsam-errors/src/adapters/internal.js +40 -0
  108. package/packages/agentsam-errors/src/adapters/oauth.js +24 -0
  109. package/packages/agentsam-errors/src/adapters/openai.js +17 -0
  110. package/packages/agentsam-errors/src/adapters/process.js +35 -0
  111. package/packages/agentsam-errors/src/adapters/provider.js +114 -0
  112. package/packages/agentsam-errors/src/envelope.js +186 -0
  113. package/packages/agentsam-errors/src/error.js +24 -0
  114. package/packages/agentsam-errors/src/fingerprint.js +35 -0
  115. package/packages/agentsam-errors/src/index.js +10 -0
  116. package/packages/agentsam-errors/src/normalize.js +30 -0
  117. package/packages/agentsam-errors/src/redaction.js +52 -0
  118. package/packages/agentsam-errors/src/render.js +16 -0
  119. package/packages/agentsam-errors/src/retry.js +10 -0
  120. package/packages/agentsam-errors/src/transport.js +52 -0
  121. package/packages/agentsam-errors/src/vocabulary.js +320 -0
  122. package/packages/agentsam-errors/test/envelope.test.mjs +70 -0
  123. package/packages/agentsam-errors/test/providers.test.mjs +99 -0
  124. package/packages/agentsam-errors/test/redaction.test.mjs +21 -0
  125. package/packages/agentsam-errors/test/runtime-cad-device.test.mjs +76 -0
  126. package/packages/agentsam-errors/test/transport.test.mjs +46 -0
  127. package/packages/agentsam-knowledge/package.json +15 -0
  128. package/packages/agentsam-knowledge/src/autorag/index.js +64 -0
  129. package/packages/agentsam-knowledge/src/backends/index.js +26 -0
  130. package/packages/agentsam-knowledge/src/index.js +3 -0
  131. package/packages/agentsam-knowledge/src/providers/index.js +95 -0
  132. package/packages/agentsam-knowledge/test/autorag.test.mjs +42 -0
  133. package/packages/agentsam-nav/README.md +40 -0
  134. package/packages/agentsam-nav/dist/Nav.d.ts +43 -0
  135. package/packages/agentsam-nav/dist/NavCollapsible.d.ts +10 -0
  136. package/packages/agentsam-nav/dist/NavContent.d.ts +2 -0
  137. package/packages/agentsam-nav/dist/NavFooter.d.ts +2 -0
  138. package/packages/agentsam-nav/dist/NavGroup.d.ts +3 -0
  139. package/packages/agentsam-nav/dist/NavHeader.d.ts +2 -0
  140. package/packages/agentsam-nav/dist/NavMenu.d.ts +22 -0
  141. package/packages/agentsam-nav/dist/NavProvider.d.ts +35 -0
  142. package/packages/agentsam-nav/dist/NavTrigger.d.ts +2 -0
  143. package/packages/agentsam-nav/dist/Surfaces.d.ts +41 -0
  144. package/packages/agentsam-nav/dist/browser.d.ts +11 -0
  145. package/packages/agentsam-nav/dist/browser.global.js +132 -0
  146. package/packages/agentsam-nav/dist/browser.js +613 -0
  147. package/packages/agentsam-nav/dist/contracts.d.ts +76 -0
  148. package/packages/agentsam-nav/dist/index.d.ts +11 -0
  149. package/packages/agentsam-nav/dist/index.js +614 -0
  150. package/packages/agentsam-nav/dist/legacy.css +83 -0
  151. package/packages/agentsam-nav/dist/shell.css +113 -0
  152. package/packages/agentsam-nav/dist/theme.css +113 -0
  153. package/packages/agentsam-nav/dist/utils.d.ts +1 -0
  154. package/packages/agentsam-nav/package.json +43 -0
  155. package/packages/agentsam-queue-control/README.md +107 -0
  156. package/packages/agentsam-queue-control/package.json +31 -0
  157. package/packages/agentsam-queue-control/schemas/job-envelope.schema.json +56 -0
  158. package/packages/agentsam-queue-control/src/adapters/cloudflare.js +152 -0
  159. package/packages/agentsam-queue-control/src/adapters/memory.js +38 -0
  160. package/packages/agentsam-queue-control/src/contracts.js +130 -0
  161. package/packages/agentsam-queue-control/src/control-plane.js +141 -0
  162. package/packages/agentsam-queue-control/src/dispatch.js +43 -0
  163. package/packages/agentsam-queue-control/src/index.js +7 -0
  164. package/packages/agentsam-queue-control/src/policy.js +88 -0
  165. package/packages/agentsam-queue-control/src/topology.js +66 -0
  166. package/packages/agentsam-queue-control/test/queue-control.test.mjs +100 -0
  167. package/packages/agentsam-repository/src/goap.js +718 -0
  168. package/packages/agentsam-repository/src/goap.js.bak-20260922011251 +670 -0
  169. package/packages/agentsam-repository/src/index.js +5 -0
  170. package/packages/agentsam-repository/src/merkle/cloudflare-persistence.js +2 -2
  171. package/packages/agentsam-repository/src/tickets.js +184 -0
  172. package/packages/agentsam-repository/src/work-tracking.js +199 -0
  173. package/packages/agentsam-repository/src/workspace-state.js +176 -0
  174. package/packages/agentsam-repository/test/goap-tickets-workspace-state.test.mjs +152 -0
  175. package/packages/connectors/cloudflare/src/index.js +297 -15
  176. package/packages/connectors/cloudflare/src/owner.js +43 -40
  177. package/packages/connectors/cloudflare/src/routes.js +167 -26
  178. package/packages/connectors/cloudflare/tests/connector.test.mjs +112 -2
  179. package/packages/heuristic-theme/README.md +11 -0
  180. package/packages/heuristic-theme/package.json +25 -0
  181. package/packages/heuristic-theme/src/index.js +2 -0
  182. package/packages/heuristic-theme/src/registry.js +36 -0
  183. package/packages/heuristic-theme/src/theme.js +41 -0
  184. package/packages/heuristic-theme/test/theme.test.mjs +26 -0
  185. package/packages/identity/.agentsam/features/oauth-login-portal/agentsam.feature.json +64 -0
  186. package/packages/identity/.agentsam/features/oauth-login-portal/providers.json +96 -0
  187. package/packages/identity/.agentsam/features/oauth-login-portal/resources.json +47 -0
  188. package/packages/identity/.agentsam/features/oauth-login-portal/routes.json +74 -0
  189. package/packages/identity/.agentsam/features/oauth-login-portal/ui.json +35 -0
  190. package/packages/identity/package.json +3 -2
  191. package/packages/identity/src/adapters/cloudflare-d1/ids.js +4 -0
  192. package/packages/identity/src/adapters/cloudflare-d1/index.js +39 -1
  193. package/packages/identity/src/contracts/provider.js +3 -2
  194. package/packages/identity/src/frontend/auth-portal/pages/login.html +7 -0
  195. package/packages/identity/src/index.js +2 -0
  196. package/packages/identity/src/oauth/credentials.js +13 -0
  197. package/packages/identity/src/oauth/iam-platform.js +5 -5
  198. package/packages/identity/src/providers/cloudflare/index.js +19 -0
  199. package/packages/identity/src/providers/cloudflare/mapper.js +21 -0
  200. package/packages/identity/src/providers/cloudflare/oauth.js +48 -0
  201. package/packages/identity/src/providers/cloudflare/profile.js +28 -0
  202. package/packages/identity/src/providers/index.js +18 -2
  203. package/packages/identity/src/server/identity-service.js +13 -3
  204. package/packages/identity/src/server/worker-router.js +63 -8
  205. package/packages/identity/tests/identity-service.test.mjs +15 -0
  206. package/packages/providers/completeful/README.md +38 -0
  207. package/packages/providers/completeful/package.json +29 -0
  208. package/packages/providers/completeful/src/client.js +162 -0
  209. package/packages/providers/completeful/src/events.js +49 -0
  210. package/packages/providers/completeful/src/index.js +22 -0
  211. package/packages/providers/completeful/src/tools.js +579 -0
  212. package/packages/providers/completeful/src/webhooks.js +55 -0
  213. package/packages/providers/completeful/test/provider.test.mjs +196 -0
  214. package/packages/theme-church-site/README.md +10 -0
  215. package/packages/theme-church-site/package.json +30 -0
  216. package/packages/theme-church-site/src/harvest.json +14 -0
  217. package/packages/theme-church-site/src/index.js +84 -0
  218. package/packages/theme-church-site/test/theme.test.mjs +19 -0
  219. package/packages/theme-companions-site/README.md +10 -0
  220. package/packages/theme-companions-site/package.json +30 -0
  221. package/packages/theme-companions-site/src/harvest.json +12 -0
  222. package/packages/theme-companions-site/src/index.js +82 -0
  223. package/packages/theme-companions-site/test/theme.test.mjs +19 -0
  224. package/packages/theme-floors-site/README.md +10 -0
  225. package/packages/theme-floors-site/package.json +30 -0
  226. package/packages/theme-floors-site/src/harvest.json +14 -0
  227. package/packages/theme-floors-site/src/index.js +82 -0
  228. package/packages/theme-floors-site/test/theme.test.mjs +19 -0
  229. package/packages/theme-fuelnfree-site/README.md +10 -0
  230. package/packages/theme-fuelnfree-site/package.json +30 -0
  231. package/packages/theme-fuelnfree-site/src/harvest.json +13 -0
  232. package/packages/theme-fuelnfree-site/src/index.js +81 -0
  233. package/packages/theme-fuelnfree-site/test/theme.test.mjs +19 -0
  234. package/packages/theme-handyman-site/README.md +10 -0
  235. package/packages/theme-handyman-site/package.json +30 -0
  236. package/packages/theme-handyman-site/src/harvest.json +10 -0
  237. package/packages/theme-handyman-site/src/index.js +83 -0
  238. package/packages/theme-handyman-site/test/theme.test.mjs +19 -0
  239. package/packages/theme-insurance-site/README.md +10 -0
  240. package/packages/theme-insurance-site/package.json +30 -0
  241. package/packages/theme-insurance-site/src/harvest.json +10 -0
  242. package/packages/theme-insurance-site/src/index.js +83 -0
  243. package/packages/theme-insurance-site/test/theme.test.mjs +19 -0
  244. package/packages/theme-shinshu-site/README.md +10 -0
  245. package/packages/theme-shinshu-site/package.json +30 -0
  246. package/packages/theme-shinshu-site/src/harvest.json +12 -0
  247. package/packages/theme-shinshu-site/src/index.js +83 -0
  248. package/packages/theme-shinshu-site/test/theme.test.mjs +19 -0
  249. package/packages/work-graph/README.md +49 -0
  250. package/packages/work-graph/package.json +19 -0
  251. package/packages/work-graph/prototype/README.md +32 -0
  252. package/packages/work-graph/prototype/data/demo-workgraph.js +47 -0
  253. package/packages/work-graph/prototype/renderers/timeline-model.js +21 -0
  254. package/packages/work-graph/prototype/renderers/workgraph-runtime.js +38 -0
  255. package/packages/work-graph/prototype-gnantt.html +655 -0
  256. package/packages/work-graph/src/adapters/business/projects.js +23 -0
  257. package/packages/work-graph/src/adapters/engineering/git.js +22 -0
  258. package/packages/work-graph/src/adapters/engineering/mcp.js +22 -0
  259. package/packages/work-graph/src/index.js +76 -0
  260. package/packages/work-graph/src/renderers/gantt-model.js +11 -0
  261. package/packages/work-graph/src/renderers/timeline.js +16 -0
  262. package/packages/work-graph/test/work-graph.test.mjs +37 -0
  263. package/protocol/README.md +12 -0
  264. package/protocol/capabilities/cloudflare-cpu-audit-input.schema.json +30 -6
  265. package/protocol/capabilities/cloudflare-cpu-profile-input.schema.json +18 -4
  266. package/protocol/capabilities/cloudflare-wrangler-native-input.schema.json +59 -10
  267. package/protocol/capabilities/knowledge-search-input.schema.json +35 -0
  268. package/protocol/capabilities/manifest.json +163 -1
  269. package/protocol/capabilities/repository-audit-input.schema.json +39 -6
  270. package/protocol/capabilities/repository-snapshot-input.schema.json +15 -3
  271. package/protocol/capabilities/terminal-exec-input.schema.json +55 -0
  272. package/protocol/commerce/catalog.v1.json +50 -0
  273. package/protocol/errors/error-catalog.json +164 -0
  274. package/protocol/errors/error-envelope.schema.json +544 -0
  275. package/protocol/features/README.md +57 -0
  276. package/protocol/features/agentsam.feature.v1.schema.json +290 -0
  277. package/protocol/features/catalog.json +65 -0
  278. package/protocol/features/examples/provider-resend.feature.json +17 -0
  279. package/protocol/go/agentsam-go-runtime.v1.json +17 -0
  280. package/protocol/knowledge/LIFECYCLE.md +140 -0
  281. package/protocol/knowledge/README.md +4 -0
  282. package/protocol/presets/catalog.json +128 -19
  283. package/protocol/rpc/v1/errors.proto +24 -0
  284. package/protocol/theme-refinery/d1-reconciliation.md +48 -0
  285. package/protocol/theme-refinery/product-metadata.schema.json +27 -0
  286. package/protocol/theme-refinery/receipts/products-registry-batch-20260924.json +318 -0
  287. package/protocol/theme-refinery/receipts/theme-harvest-20260924.json +472 -0
  288. package/protocol/theme-refinery/reconciliation-receipt.schema.json +83 -0
  289. package/services/cad/server.py +249 -2
  290. package/src/agent/capability-adapter.js +15 -5
  291. package/src/agent/index.js +2 -1
  292. package/src/agent/model-turn.js +51 -0
  293. package/src/agent/responses-runner.js +304 -38
  294. package/src/capabilities/index.js +1 -0
  295. package/src/capabilities/terminal-exec.js +78 -0
  296. package/src/cli.js +117 -9
  297. package/src/cloudflare/index.js +6 -0
  298. package/src/cloudflare/runtime-status.js +393 -0
  299. package/src/cloudflare/wrangler.js +17 -1
  300. package/src/commands/app.js +106 -0
  301. package/src/commands/autorag.js +77 -0
  302. package/src/commands/brand.js +293 -0
  303. package/src/commands/cad.js +1 -0
  304. package/src/commands/connections.js +126 -29
  305. package/src/commands/context-economics.js +8 -0
  306. package/src/commands/db.js +7 -0
  307. package/src/commands/env.js +5 -4
  308. package/src/commands/eval.js +209 -14
  309. package/src/commands/go.js +365 -0
  310. package/src/commands/goap.js +176 -0
  311. package/src/commands/identity-init.js +27 -3
  312. package/src/commands/identity-protocol.js +195 -0
  313. package/src/commands/knowledge.js +64 -5
  314. package/src/commands/mcp.js +341 -0
  315. package/src/commands/merkle-persist.js +3 -1
  316. package/src/commands/merkle.js +18 -3
  317. package/src/commands/models.js +109 -23
  318. package/src/commands/plugins.js +175 -0
  319. package/src/commands/preferences.js +28 -8
  320. package/src/commands/product.js +53 -10
  321. package/src/commands/providers.js +118 -37
  322. package/src/commands/resume.js +9 -5
  323. package/src/commands/runtime-status.js +154 -0
  324. package/src/commands/shell.js +466 -55
  325. package/src/commands/status.js +82 -7
  326. package/src/commands/tunnel.js +228 -195
  327. package/src/commands/whoami.js +78 -6
  328. package/src/context/budget.js +6 -0
  329. package/src/context/index.js +2 -1
  330. package/src/context/project-card.js +75 -0
  331. package/src/errors/contract.js +34 -211
  332. package/src/errors/diagnostic.js +95 -51
  333. package/src/errors/index.js +6 -13
  334. package/src/eval/index.js +6 -0
  335. package/src/eval/live.js +439 -0
  336. package/src/features/resolve.js +242 -0
  337. package/src/go/build.js +108 -0
  338. package/src/go/cloudflare.js +207 -0
  339. package/src/go/contract.js +139 -0
  340. package/src/go/discover.js +96 -0
  341. package/src/go/index.js +13 -0
  342. package/src/go/receipts.js +77 -0
  343. package/src/go/registry.js +223 -0
  344. package/src/go/verify.js +31 -0
  345. package/src/index.js +100 -1
  346. package/src/knowledge/config.js +13 -5
  347. package/src/knowledge/engine.js +23 -8
  348. package/src/knowledge/index.js +1 -0
  349. package/src/knowledge/lane-registry.js +46 -0
  350. package/src/knowledge/providers/gemini.js +48 -8
  351. package/src/knowledge/service/client.js +13 -1
  352. package/src/knowledge/service/grpc-codec.js +156 -53
  353. package/src/knowledge/service/job-engine.js +133 -11
  354. package/src/knowledge/service/job-worker.js +34 -5
  355. package/src/knowledge/service/server.js +10 -1
  356. package/src/knowledge/store-discovery.js +77 -0
  357. package/src/lib/account-session.js +8 -2
  358. package/src/lib/agent-instructions.js +3 -0
  359. package/src/lib/auth.js +7 -3
  360. package/src/lib/cad/blender.js +42 -3
  361. package/src/lib/cad/d1-project-store.js +43 -0
  362. package/src/lib/cad/discovery.js +616 -0
  363. package/src/lib/cad/docker-executor.js +352 -0
  364. package/src/lib/cad/freecad.js +253 -0
  365. package/src/lib/cad/index.js +40 -0
  366. package/src/lib/cad/openscad.js +198 -0
  367. package/src/lib/cad/project-cli.d.ts +2 -0
  368. package/src/lib/cad/project-cli.js +21 -0
  369. package/src/lib/cad/project-contract.d.ts +3 -0
  370. package/src/lib/cad/project-contract.js +1 -0
  371. package/src/lib/cad/project-recipe.js +30 -0
  372. package/src/lib/cad/project-runtime.d.ts +2 -0
  373. package/src/lib/cad/project-runtime.js +53 -0
  374. package/src/lib/cad/project-store.js +25 -0
  375. package/src/lib/cad/project-workflows.js +31 -0
  376. package/src/lib/cad-docker.js +21 -2
  377. package/src/lib/cli-preferences.js +17 -2
  378. package/src/lib/core-client.js +37 -18
  379. package/src/lib/deploy/local-studio.js +6 -5
  380. package/src/lib/dockerize.js +3 -0
  381. package/src/lib/execution-approvals.js +1 -0
  382. package/src/lib/identity-scaffold.js +4 -1
  383. package/src/lib/knowledge-docker.js +9 -1
  384. package/src/lib/local-sessions.js +124 -34
  385. package/src/lib/local-status.js +35 -14
  386. package/src/lib/project-config.js +9 -0
  387. package/src/lib/provider-credentials.js +73 -11
  388. package/src/lib/scaffold/resolve-cloudflare-account.js +37 -0
  389. package/src/lib/scaffold/wizards/cms.js +2 -8
  390. package/src/lib/scaffold/wizards/worker-api.js +2 -8
  391. package/src/lib/slash-commands.js +9 -2
  392. package/src/local/migrations.js +109 -1
  393. package/src/local/runtime-store.js +31 -5
  394. package/src/local/sqlite.js +36 -1
  395. package/src/mcp/authority.js +348 -0
  396. package/src/mcp/client-adapters.js +431 -0
  397. package/src/mcp/client.js +172 -0
  398. package/src/mcp/index.js +47 -0
  399. package/src/mcp/telemetry.js +103 -0
  400. package/src/models/catalog.js +329 -51
  401. package/src/models/discovery.js +24 -4
  402. package/src/models/index.js +2 -0
  403. package/src/models/inventory-core.js +182 -0
  404. package/src/models/policy.js +20 -0
  405. package/src/plugins/cloudflare.js +103 -0
  406. package/src/plugins/completeful.js +69 -0
  407. package/src/plugins/contracts.js +86 -0
  408. package/src/plugins/index.js +11 -0
  409. package/src/plugins/registry.js +207 -0
  410. package/src/plugins/resource-scope.js +45 -0
  411. package/src/plugins/runtime.js +118 -0
  412. package/src/plugins/vectorize.js +31 -0
  413. package/src/progression/engine.js +171 -0
  414. package/src/progression/index.js +1 -0
  415. package/src/providers/cloudflare-chat.js +1 -1
  416. package/src/providers/gemini-generate-content.js +2 -1
  417. package/src/providers/openai-responses.js +45 -16
  418. package/src/providers/tool-schema.js +85 -0
  419. package/src/repository/index.js +29 -0
  420. package/src/rpc/generated/errors_pb.js +961 -1
  421. package/src/security/local-vault.js +415 -0
  422. package/src/security/process.js +20 -4
  423. package/src/status/actions.js +192 -0
  424. package/src/tools/hydrate.js +5 -1
  425. package/src/tools/index.js +7 -0
  426. package/src/tools/redact.js +64 -0
  427. package/src/tools/registry.js +83 -0
  428. package/src/tools/runtime.js +257 -0
  429. package/src/tools/search.js +21 -8
  430. package/src/ui/ansi.js +117 -3
  431. package/src/ui/cli/activity.js +76 -7
  432. package/src/ui/cli/footer.js +110 -9
  433. package/src/ui/cli/help.js +11 -4
  434. package/src/ui/wireframes.js +166 -0
  435. package/test/account-session.test.mjs +28 -0
  436. package/test/apps-scaffold-contract.test.mjs +16 -1
  437. package/test/capabilities.test.mjs +1 -1
  438. package/test/cli/eval-live.test.mjs +219 -0
  439. package/test/cli/go.test.mjs +71 -0
  440. package/test/cli/local-vault-and-provider-setup.test.mjs +268 -0
  441. package/test/cli/mcp-client.test.mjs +245 -0
  442. package/test/cli/runtime-ui.test.mjs +69 -2
  443. package/test/cli/status-actions.test.mjs +88 -0
  444. package/test/cli/wireframes-go-registry.test.mjs +54 -0
  445. package/test/cloudflare-connector.test.mjs +3 -6
  446. package/test/cloudflare-runtime.test.mjs +8 -1
  447. package/test/context.test.mjs +15 -0
  448. package/test/error-diagnostics.test.mjs +9 -0
  449. package/test/fixtures/cad/courtyard-house.json +208 -0
  450. package/test/go/cloudflare-probe.test.mjs +53 -0
  451. package/test/integration/app-command.test.mjs +55 -0
  452. package/test/integration/cad-discovery.test.mjs +158 -0
  453. package/test/integration/cad-docker-executor.test.mjs +249 -0
  454. package/test/integration/cad-execution.test.mjs +184 -0
  455. package/test/integration/cad-project-app.test.mjs +31 -0
  456. package/test/integration/cad-project-d1.test.mjs +25 -0
  457. package/test/integration/cad-project-native.test.mjs +24 -0
  458. package/test/integration/cad-project-workflow.test.mjs +9 -0
  459. package/test/integration/cad-project.test.mjs +82 -0
  460. package/test/integration/cli-help.test.mjs +4 -0
  461. package/test/integration/cms-site-tenancy-contract.test.mjs +256 -0
  462. package/test/integration/core-client.integration.test.mjs +55 -0
  463. package/test/integration/error-runtime-rpc.test.mjs +71 -0
  464. package/test/integration/features-resolve.test.mjs +128 -0
  465. package/test/integration/install-script.test.mjs +107 -0
  466. package/test/integration/inventory-core.test.mjs +53 -0
  467. package/test/integration/plugins-cloudflare.integration.test.mjs +28 -0
  468. package/test/integration/provider-env-cli.test.mjs +1 -1
  469. package/test/integration/runtime-migrations.test.mjs +6 -1
  470. package/test/integration/runtime-status.integration.test.mjs +211 -0
  471. package/test/integration/scaffold-cloudflare.test.mjs +46 -0
  472. package/test/integration/storage-architecture.test.mjs +154 -0
  473. package/test/integration/store-discovery.test.mjs +44 -0
  474. package/test/integration/terminal-exec.integration.test.mjs +86 -0
  475. package/test/integration/tool-runtime.test.mjs +124 -0
  476. package/test/integration/tool-schema.test.mjs +59 -0
  477. package/test/knowledge-service.test.mjs +4 -0
  478. package/test/local-sessions.test.mjs +11 -2
  479. package/test/local-studio-deploy.test.mjs +1 -1
  480. package/test/model-catalog.test.mjs +28 -1
  481. package/test/models.test.mjs +159 -5
  482. package/test/openai-responses.test.mjs +60 -0
  483. package/test/provider-credentials.test.mjs +15 -5
  484. package/test/responses-runner.test.mjs +321 -6
  485. package/test/shell.test.mjs +149 -4
  486. package/test/smoke.mjs +2 -2
  487. package/test/tools-search.test.mjs +33 -0
  488. package/test/unit/website-assets-bindings.test.mjs +60 -0
  489. package/test/whoami-resume.test.mjs +82 -3
  490. package/examples/gorilla-shell/README.md +0 -15
  491. package/src/lib/gorilla-template.js +0 -54
  492. package/templates/gorilla-shell/App.tsx +0 -639
  493. package/templates/gorilla-shell/README.md +0 -34
  494. package/templates/gorilla-shell/index.html +0 -15
  495. package/templates/gorilla-shell/main.jsx +0 -9
  496. package/templates/gorilla-shell/package.json +0 -19
  497. package/templates/gorilla-shell/vite.config.js +0 -21
@@ -0,0 +1,83 @@
1
+ @import './shell.css';
2
+
3
+ :root[data-theme="light"] {
4
+ --nav-glass-bg: color-mix(in srgb, var(--dashboard-panel, var(--color-card)) 72%, transparent);
5
+ --nav-glass-border: color-mix(in srgb, var(--dashboard-border, var(--color-border)) 60%, transparent);
6
+ --nav-glass-blur: 16px;
7
+ }
8
+
9
+ :root[data-theme="dark"],
10
+ :root:not([data-theme="light"]) {
11
+ --nav-glass-bg: color-mix(in srgb, var(--dashboard-canvas, var(--color-background)) 55%, transparent);
12
+ --nav-glass-border: color-mix(in srgb, var(--solar-blue, var(--color-accent)) 25%, transparent);
13
+ --nav-glass-blur: 20px;
14
+ }
15
+
16
+ .agentsam-nav {
17
+ --agentsam-nav-width: 16.75rem;
18
+ --agentsam-nav-collapsed-width: 4.5rem;
19
+ box-sizing: border-box;
20
+ display: flex;
21
+ width: var(--agentsam-nav-width);
22
+ min-width: var(--agentsam-nav-width);
23
+ height: 100%;
24
+ flex-direction: column;
25
+ overflow: hidden;
26
+ color: var(--dashboard-text, var(--color-foreground));
27
+ background: var(--nav-glass-bg);
28
+ border-right: 1px solid var(--nav-glass-border);
29
+ backdrop-filter: blur(var(--nav-glass-blur)) saturate(150%);
30
+ -webkit-backdrop-filter: blur(var(--nav-glass-blur)) saturate(150%);
31
+ transition: width 180ms ease, min-width 180ms ease, transform 180ms ease;
32
+ z-index: 40;
33
+ position: relative;
34
+ }
35
+
36
+ .agentsam-nav[data-open="false"]:not([data-mobile="true"]):not([data-peeking="true"]) {
37
+ width: var(--agentsam-nav-collapsed-width);
38
+ min-width: var(--agentsam-nav-collapsed-width);
39
+ }
40
+
41
+ .agentsam-nav__header,
42
+ .agentsam-nav__footer { padding: .75rem; }
43
+ .agentsam-nav__footer { margin-top: auto; border-top: 1px solid var(--nav-glass-border); }
44
+ .agentsam-nav__content { min-height: 0; flex: 1; overflow-y: auto; padding: .25rem .5rem .75rem; }
45
+ .agentsam-nav__group + .agentsam-nav__group { margin-top: 1.25rem; }
46
+ .agentsam-nav__group-label { margin: 0 0 .45rem; padding: 0 .55rem; color: var(--dashboard-text-muted, var(--color-muted-foreground)); font-size: .69rem; font-weight: 700; letter-spacing: .09em; text-transform: uppercase; }
47
+ .agentsam-nav__menu,
48
+ .agentsam-nav__menu-sub { display: grid; gap: .2rem; margin: 0; padding: 0; list-style: none; }
49
+ .agentsam-nav__menu-item { min-width: 0; list-style: none; }
50
+ .agentsam-nav__menu-button,
51
+ .agentsam-nav__menu-sub-button,
52
+ .agentsam-nav__trigger { box-sizing: border-box; border: 1px solid transparent; color: inherit; font: inherit; cursor: pointer; }
53
+ .agentsam-nav__menu-button { display: flex; width: 100%; min-height: 2.65rem; align-items: center; gap: .72rem; padding: .55rem .7rem; border-radius: .75rem; background: transparent; color: var(--dashboard-text-muted, var(--color-muted-foreground)); text-align: left; transition: color 150ms ease, background-color 150ms ease, border-color 150ms ease; }
54
+ .agentsam-nav__menu-button:hover,
55
+ .agentsam-nav__menu-button[data-active="true"] { color: var(--dashboard-text, var(--color-foreground)); background: color-mix(in srgb, var(--solar-cyan, var(--color-accent)) 12%, transparent); border-color: color-mix(in srgb, var(--nav-glass-border) 80%, transparent); }
56
+ .agentsam-nav__menu-icon { width: 1.15rem; height: 1.15rem; flex: 0 0 auto; }
57
+ .agentsam-nav__menu-label { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: .9rem; font-weight: 560; }
58
+ .agentsam-nav__chevron { width: 1rem; height: 1rem; margin-left: auto; transition: transform 150ms ease; }
59
+ .agentsam-nav__menu-button[aria-expanded="true"] .agentsam-nav__chevron { transform: rotate(90deg); }
60
+ .agentsam-nav__collapsible-content { padding: .2rem 0 .3rem 1.75rem; }
61
+ .agentsam-nav__menu-sub-button { display: block; padding: .46rem .6rem; border-radius: .55rem; color: var(--dashboard-text-muted, var(--color-muted-foreground)); font-size: .84rem; text-decoration: none; }
62
+ .agentsam-nav__menu-sub-button:hover,
63
+ .agentsam-nav__menu-sub-button[data-active="true"] { color: var(--dashboard-text, var(--color-foreground)); background: color-mix(in srgb, var(--solar-blue, var(--color-accent)) 12%, transparent); }
64
+ .agentsam-nav__trigger { display: inline-grid; width: 2.55rem; height: 2.55rem; place-items: center; border-radius: .72rem; background: color-mix(in srgb, var(--nav-glass-bg) 78%, transparent); color: var(--dashboard-text, var(--color-foreground)); }
65
+ .agentsam-nav__trigger:hover { border-color: var(--nav-glass-border); background: color-mix(in srgb, var(--solar-cyan, var(--color-accent)) 14%, transparent); }
66
+ .agentsam-nav__trigger svg { width: 1.25rem; height: 1.25rem; }
67
+ .agentsam-nav__backdrop { position: fixed; inset: 0; z-index: 39; border: 0; background: rgb(0 0 0 / .46); }
68
+ .agentsam-nav__resize-handle { position: absolute; inset: 0 -5px 0 auto; z-index: 2; width: 10px; cursor: col-resize; touch-action: none; }
69
+ .agentsam-nav__resize-handle::after { position: absolute; top: 50%; right: 3px; width: 2px; height: 2.5rem; border-radius: 99px; background: var(--nav-glass-border); content: ''; opacity: 0; transform: translateY(-50%); transition: opacity 150ms ease; }
70
+ .agentsam-nav:hover .agentsam-nav__resize-handle::after,
71
+ .agentsam-nav__resize-handle:focus-visible::after { opacity: 1; }
72
+
73
+ .agentsam-nav[data-open="false"]:not([data-mobile="true"]):not([data-peeking="true"]) .agentsam-nav__group-label,
74
+ .agentsam-nav[data-open="false"]:not([data-mobile="true"]):not([data-peeking="true"]) .agentsam-nav__menu-label,
75
+ .agentsam-nav[data-open="false"]:not([data-mobile="true"]):not([data-peeking="true"]) .agentsam-nav__chevron,
76
+ .agentsam-nav[data-open="false"]:not([data-mobile="true"]):not([data-peeking="true"]) .agentsam-nav__collapsible-content { display: none; }
77
+ .agentsam-nav[data-open="false"]:not([data-mobile="true"]):not([data-peeking="true"]) .agentsam-nav__menu-button { justify-content: center; padding-inline: .55rem; }
78
+
79
+ .agentsam-nav[data-mobile="true"] { position: fixed; inset: 0 auto 0 0; width: min(100vw, 25rem); min-width: min(100vw, 25rem); transform: translateX(-101%); box-shadow: 1rem 0 4rem rgb(0 0 0 / .3); }
80
+ .agentsam-nav[data-mobile="true"][data-open="true"] { transform: translateX(0); }
81
+ .agentsam-nav[data-mobile="true"] .agentsam-nav__mobile-subview { position: absolute; inset: 0; z-index: 3; box-sizing: border-box; overflow-y: auto; padding: .75rem; background: var(--nav-glass-bg); backdrop-filter: blur(var(--nav-glass-blur)) saturate(150%); }
82
+ .agentsam-nav__mobile-back { display: flex; width: 100%; min-height: 2.65rem; align-items: center; gap: .55rem; margin-bottom: .75rem; padding: .55rem .7rem; border: 1px solid transparent; border-radius: .75rem; color: var(--dashboard-text, var(--color-foreground)); background: color-mix(in srgb, var(--solar-cyan, var(--color-accent)) 12%, transparent); font: inherit; font-weight: 600; text-align: left; cursor: pointer; }
83
+ .agentsam-nav__mobile-back:hover { border-color: var(--nav-glass-border); }
@@ -0,0 +1,113 @@
1
+ /* Portable semantic tokens. Scope never changes the host document or another instance. */
2
+ .as-nav-scope {
3
+ --nav-canvas: #171717; --nav-sidebar: #212121; --nav-surface: #262626;
4
+ --nav-popover: #292929; --nav-text: #ececec; --nav-muted: #aaa;
5
+ --nav-border: #ffffff1a; --nav-hover: #ffffff0d; --nav-selected: #ffffff12;
6
+ --nav-danger: #ff8b8b; --nav-accent: #8b5cf6;
7
+ --nav-font: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
8
+ --nav-label-size: 14px; --nav-meta-size: 12px; --nav-row-height: 36px;
9
+ --nav-radius: 8px; --nav-menu-radius: 14px; --nav-width: 264px; --nav-rail-width: 56px;
10
+ --nav-shadow: 0 16px 40px #0006;
11
+ color: var(--nav-text); font: 400 var(--nav-label-size)/1.45 var(--nav-font); color-scheme: dark;
12
+ box-sizing: border-box;
13
+ }
14
+ .as-nav-scope[data-nav-theme="light"] { --nav-canvas: #fafafa; --nav-sidebar: #f1f1f1; --nav-surface: #fff; --nav-popover: #fff; --nav-text: #202020; --nav-muted: #636363; --nav-border: #0000001f; --nav-hover: #00000008; --nav-selected: #0000000d; --nav-danger: #b42323; --nav-shadow: 0 16px 40px #0002; color-scheme: light; }
15
+ @media (prefers-color-scheme: light) { .as-nav-scope[data-nav-theme="system"] { --nav-canvas: #fafafa; --nav-sidebar: #f1f1f1; --nav-surface: #fff; --nav-popover: #fff; --nav-text: #202020; --nav-muted: #636363; --nav-border: #0000001f; --nav-hover: #00000008; --nav-selected: #0000000d; --nav-danger: #b42323; --nav-shadow: 0 16px 40px #0002; color-scheme: light; } }
16
+ .as-nav-scope *, .as-nav-scope *::before, .as-nav-scope *::after { box-sizing: border-box; }
17
+ .as-nav-scope button, .as-nav-scope input, .as-nav-scope summary { font: inherit; color: inherit; }
18
+ .as-nav-scope button { cursor: pointer; }
19
+ .as-nav-scope button:disabled { opacity: .45; cursor: default; }
20
+ .as-nav-scope :focus-visible { outline: 2px solid var(--nav-accent); outline-offset: 2px; }
21
+ .as-nav-scope ::selection { background: color-mix(in srgb, var(--nav-accent) 35%, transparent); color: var(--nav-text); }
22
+ .as-nav-scope svg { width: 18px; height: 18px; flex-shrink: 0; stroke-width: 1.65; }
23
+ .as-nav-button { display: inline-flex; align-items: center; justify-content: center; gap: 8px; min-width: 36px; min-height: 36px; padding: 6px 8px; background: transparent; border: 1px solid transparent; border-radius: var(--nav-radius); white-space: nowrap; }
24
+ .as-nav-button:hover, .as-nav-button[data-state="open"] { background: var(--nav-hover); }
25
+ .as-nav-button[aria-pressed="true"] { border-color: var(--nav-accent); }
26
+ .as-nav-brand { position: relative; flex-shrink: 0; }
27
+ .as-nav-brand img, .as-nav-brand-mark { display: grid; place-items: center; width: 24px; height: 24px; object-fit: contain; }
28
+ .as-nav-brand img.as-nav-logo-light { display: none; }
29
+ .as-nav-logo-light[data-fallback] { filter: brightness(0); }
30
+ [data-nav-theme="light"] .as-nav-logo-dark { display: none; }
31
+ [data-nav-theme="light"] .as-nav-brand img.as-nav-logo-light { display: block; }
32
+ @media (prefers-color-scheme: light) { [data-nav-theme="system"] .as-nav-logo-dark { display: none; } [data-nav-theme="system"] .as-nav-brand img.as-nav-logo-light { display: block; } }
33
+ .as-nav-topbar { display: flex; align-items: center; gap: 8px; min-width: 0; height: 56px; flex-shrink: 0; padding: 0 16px; background: var(--nav-canvas); border-bottom: 1px solid var(--nav-border); position: relative; }
34
+ .as-nav-topbar--startup { border-bottom-color: transparent; }
35
+ .as-nav-topbar-leading, .as-nav-topbar-actions { display: flex; align-items: center; gap: 4px; min-width: 0; }
36
+ .as-nav-topbar-actions { flex-shrink: 0; }
37
+ .as-nav-topbar-center { position: absolute; left: 50%; transform: translateX(-50%); }
38
+ .as-nav-spacer { flex: 1; }
39
+ .as-nav-context { display: flex; align-items: center; gap: 8px; min-width: 0; }
40
+ .as-nav-title { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
41
+ .as-nav-project-name { max-width: 180px; overflow: hidden; text-overflow: ellipsis; }
42
+ .as-nav-separator, .as-nav-mode-label { color: var(--nav-muted); }
43
+ .as-nav-mode-label { white-space: nowrap; }
44
+ .as-nav-mode-switch { display: flex; padding: 3px; gap: 2px; border-radius: 24px; background: var(--nav-surface); }
45
+ .as-nav-mode-switch button { border: 0; border-radius: 20px; background: transparent; padding: 6px 24px; color: var(--nav-muted); }
46
+ .as-nav-mode-switch button[aria-pressed="true"] { background: var(--nav-selected); color: var(--nav-text); }
47
+ .as-nav-popover { z-index: 100; min-width: 224px; max-width: min(340px, calc(100vw - 24px)); max-height: var(--radix-dropdown-menu-content-available-height); overflow: auto; padding: 6px; background: var(--nav-popover); border: 1px solid var(--nav-border); border-radius: var(--nav-menu-radius); box-shadow: var(--nav-shadow); animation: as-nav-enter 120ms ease-out; }
48
+ .as-nav-menu-heading { padding: 8px 10px; color: var(--nav-muted); font-size: var(--nav-meta-size); }
49
+ .as-nav-menu-separator { height: 1px; margin: 6px 4px; background: var(--nav-border); }
50
+ .as-nav-menu-row { display: flex; align-items: center; gap: 10px; min-height: var(--nav-row-height); padding: 8px 10px; border-radius: var(--nav-radius); cursor: pointer; outline: none; }
51
+ .as-nav-menu-row[data-highlighted] { background: var(--nav-selected); }
52
+ .as-nav-menu-row[data-disabled] { opacity: .45; cursor: default; }
53
+ .as-nav-menu-row[data-destructive] { color: var(--nav-danger); }
54
+ .as-nav-icon { display: grid; place-items: center; width: 18px; }
55
+ .as-nav-avatar { width: 28px; height: 28px; border-radius: 50%; display: grid; place-items: center; background: var(--nav-selected); overflow: hidden; }
56
+ .as-nav-avatar img { width: 100%; height: 100%; object-fit: cover; }
57
+ .as-nav-account--expanded .as-nav-button { width: 100%; justify-content: flex-start; }
58
+ .as-nav-account-copy { display: flex; flex: 1; min-width: 0; text-align: left; flex-direction: column; }
59
+ .as-nav-account-copy strong { font-weight: 500; overflow: hidden; text-overflow: ellipsis; }
60
+ .as-nav-account-copy small { color: var(--nav-muted); font-size: var(--nav-meta-size); }
61
+ .as-nav-sidenav-reserve { width: var(--nav-rail-width); flex-shrink: 0; position: relative; height: 100%; z-index: 45; }
62
+ .as-nav-sidenav-reserve[data-open="true"] { width: var(--nav-width); }
63
+ .as-nav-sidenav { display: flex; flex-direction: column; width: var(--nav-rail-width); height: 100%; background: var(--nav-sidebar); border-right: 1px solid var(--nav-border); position: absolute; inset: 0 auto 0 0; overflow: hidden; }
64
+ .as-nav-sidenav[data-expanded="true"] { width: var(--nav-width); }
65
+ .as-nav-sidenav-reserve[data-open="false"] .as-nav-sidenav[data-expanded="true"] { box-shadow: var(--nav-shadow); }
66
+ .as-nav-sidenav-head { display: flex; align-items: center; min-height: 56px; padding: 8px; }
67
+ .as-nav-sidenav-main { display: flex; flex: 1; min-height: 0; flex-direction: column; }
68
+ .as-nav-destinations { padding: 4px 8px 12px; flex-shrink: 0; }
69
+ .as-nav-destination { display: flex; align-items: center; gap: 12px; padding: 8px 12px; min-height: var(--nav-row-height); width: 100%; text-align: left; background: transparent; border: 0; border-radius: var(--nav-radius); }
70
+ .as-nav-destination:hover, .as-nav-destination[data-active] { background: var(--nav-selected); }
71
+ .as-nav-history { overflow-y: auto; flex: 1; min-height: 0; padding: 0 8px 16px; scrollbar-width: thin; scrollbar-color: var(--nav-border) transparent; }
72
+ .as-nav-history h2 { font-size: var(--nav-meta-size); color: var(--nav-muted); font-weight: 500; margin: 20px 12px 8px; }
73
+ .as-nav-search { display: flex; align-items: center; gap: 8px; padding: 8px 10px; color: var(--nav-muted); }
74
+ .as-nav-search input { width: 100%; min-width: 0; background: transparent; border: 0; font-size: var(--nav-meta-size); }
75
+ .as-nav-conversation { position: relative; display: flex; align-items: center; border-radius: var(--nav-radius); }
76
+ .as-nav-conversation:hover, .as-nav-conversation:focus-within, .as-nav-conversation[data-active] { background: var(--nav-selected); }
77
+ .as-nav-conversation-link { display:flex; align-items:center; gap:8px; flex: 1; min-width: 0; text-align: left; border: 0; background: transparent; padding: 9px 10px; white-space: nowrap; overflow: hidden; }
78
+ .as-nav-conversation-link span { min-width:0; overflow:hidden; text-overflow:ellipsis; }
79
+ .as-nav-conversation-link svg { width:15px; height:15px; color:var(--nav-muted); }
80
+ .as-nav-row-actions { display: none; padding-right: 4px; }
81
+ .as-nav-row-actions .as-nav-button { min-width: 28px; min-height: 28px; padding: 5px; }
82
+ .as-nav-row-actions svg { width: 14px; height: 14px; }
83
+ .as-nav-conversation:hover .as-nav-row-actions, .as-nav-conversation:focus-within .as-nav-row-actions { display: flex; }
84
+ .as-nav-project { border-radius: var(--nav-radius); }
85
+ .as-nav-project[data-active] { background: color-mix(in srgb, var(--nav-accent) 9%, transparent); }
86
+ .as-nav-project-row { display:flex; align-items:center; border-radius:var(--nav-radius); }
87
+ .as-nav-project-row:hover, .as-nav-project-row:focus-within { background:var(--nav-selected); }
88
+ .as-nav-project-toggle { display:flex; align-items:center; gap:8px; flex:1; min-width:0; border:0; background:transparent; padding:9px 10px; text-align:left; }
89
+ .as-nav-project-toggle span { flex:1; min-width:0; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
90
+ .as-nav-project-toggle > svg:last-child { width:14px; height:14px; color:var(--nav-muted); transition:transform .12s ease; }
91
+ .as-nav-project-toggle[aria-expanded="true"] > svg:last-child { transform:rotate(180deg); }
92
+ .as-nav-project-row:hover .as-nav-row-actions, .as-nav-project-row:focus-within .as-nav-row-actions { display:flex; }
93
+ .as-nav-project-conversations { margin-left: 12px; border-left: 1px solid var(--nav-border); padding-left: 4px; }
94
+ .as-nav-project-home { border: 0; background: transparent; color: var(--nav-muted) !important; padding: 8px 12px; font-size: var(--nav-meta-size) !important; }
95
+ .as-nav-sidenav-foot { margin-top: auto; padding: 8px; }
96
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-expanded-only,
97
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-account-copy,
98
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-account .as-nav-button > svg { display: none; }
99
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-destination { justify-content:center; padding-inline:0; }
100
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-destination span { display:none; }
101
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-sidenav-foot .as-nav-button { width:100%; padding-inline:0; }
102
+ .as-nav-empty { color: var(--nav-muted); padding: 12px; font-size: var(--nav-meta-size); }
103
+ .as-nav-dialog-overlay { position: fixed; inset: 0; z-index: 80; background: #0008; }
104
+ .as-nav-dialog { position: fixed; z-index: 81; top: 50%; left: 50%; transform: translate(-50%,-50%); width: min(400px, calc(100vw - 32px)); background: var(--nav-popover); border: 1px solid var(--nav-border); border-radius: var(--nav-menu-radius); padding: 24px; box-shadow: var(--nav-shadow); }
105
+ .as-nav-dialog h2 { font-size: 18px; margin: 0 0 8px; }
106
+ .as-nav-dialog p { color: var(--nav-muted); margin-bottom: 20px; }
107
+ .as-nav-dialog input { background: var(--nav-surface); border: 1px solid var(--nav-border); padding: 10px 12px; border-radius: var(--nav-radius); width: 100%; }
108
+ .as-nav-dialog-actions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 16px; }
109
+ .as-nav-mobile-drawer { position: fixed; z-index: 81; inset: 0 auto 0 0; display: flex; flex-direction: column; width: min(320px, 90vw); background: var(--nav-sidebar); }
110
+ .as-nav-sr-only { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0,0,0,0); }
111
+ @keyframes as-nav-enter { from { opacity: 0; transform: translateY(-3px); } to { opacity: 1; transform: translateY(0); } }
112
+ @media (max-width: 767px) { .as-nav-topbar { padding: 0 8px; gap: 4px; } .as-nav-mode-label, .as-nav-share-label, .as-nav-project-name { display: none; } .as-nav-context { gap: 4px; } .as-nav-button { min-width: 44px; min-height: 44px; } .as-nav-menu-row { min-height: 44px; } .as-nav-topbar-center .as-nav-mode-switch button { padding-inline: 16px; } .as-nav-row-actions { display: flex; } }
113
+ @media (prefers-reduced-motion: reduce) { .as-nav-scope *, .as-nav-scope *::before { animation: none !important; transition: none !important; scroll-behavior: auto !important; } }
@@ -0,0 +1,113 @@
1
+ /* Portable semantic tokens. Scope never changes the host document or another instance. */
2
+ .as-nav-scope {
3
+ --nav-canvas: #171717; --nav-sidebar: #212121; --nav-surface: #262626;
4
+ --nav-popover: #292929; --nav-text: #ececec; --nav-muted: #aaa;
5
+ --nav-border: #ffffff1a; --nav-hover: #ffffff0d; --nav-selected: #ffffff12;
6
+ --nav-danger: #ff8b8b; --nav-accent: #8b5cf6;
7
+ --nav-font: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
8
+ --nav-label-size: 14px; --nav-meta-size: 12px; --nav-row-height: 36px;
9
+ --nav-radius: 8px; --nav-menu-radius: 14px; --nav-width: 264px; --nav-rail-width: 56px;
10
+ --nav-shadow: 0 16px 40px #0006;
11
+ color: var(--nav-text); font: 400 var(--nav-label-size)/1.45 var(--nav-font); color-scheme: dark;
12
+ box-sizing: border-box;
13
+ }
14
+ .as-nav-scope[data-nav-theme="light"] { --nav-canvas: #fafafa; --nav-sidebar: #f1f1f1; --nav-surface: #fff; --nav-popover: #fff; --nav-text: #202020; --nav-muted: #636363; --nav-border: #0000001f; --nav-hover: #00000008; --nav-selected: #0000000d; --nav-danger: #b42323; --nav-shadow: 0 16px 40px #0002; color-scheme: light; }
15
+ @media (prefers-color-scheme: light) { .as-nav-scope[data-nav-theme="system"] { --nav-canvas: #fafafa; --nav-sidebar: #f1f1f1; --nav-surface: #fff; --nav-popover: #fff; --nav-text: #202020; --nav-muted: #636363; --nav-border: #0000001f; --nav-hover: #00000008; --nav-selected: #0000000d; --nav-danger: #b42323; --nav-shadow: 0 16px 40px #0002; color-scheme: light; } }
16
+ .as-nav-scope *, .as-nav-scope *::before, .as-nav-scope *::after { box-sizing: border-box; }
17
+ .as-nav-scope button, .as-nav-scope input, .as-nav-scope summary { font: inherit; color: inherit; }
18
+ .as-nav-scope button { cursor: pointer; }
19
+ .as-nav-scope button:disabled { opacity: .45; cursor: default; }
20
+ .as-nav-scope :focus-visible { outline: 2px solid var(--nav-accent); outline-offset: 2px; }
21
+ .as-nav-scope ::selection { background: color-mix(in srgb, var(--nav-accent) 35%, transparent); color: var(--nav-text); }
22
+ .as-nav-scope svg { width: 18px; height: 18px; flex-shrink: 0; stroke-width: 1.65; }
23
+ .as-nav-button { display: inline-flex; align-items: center; justify-content: center; gap: 8px; min-width: 36px; min-height: 36px; padding: 6px 8px; background: transparent; border: 1px solid transparent; border-radius: var(--nav-radius); white-space: nowrap; }
24
+ .as-nav-button:hover, .as-nav-button[data-state="open"] { background: var(--nav-hover); }
25
+ .as-nav-button[aria-pressed="true"] { border-color: var(--nav-accent); }
26
+ .as-nav-brand { position: relative; flex-shrink: 0; }
27
+ .as-nav-brand img, .as-nav-brand-mark { display: grid; place-items: center; width: 24px; height: 24px; object-fit: contain; }
28
+ .as-nav-brand img.as-nav-logo-light { display: none; }
29
+ .as-nav-logo-light[data-fallback] { filter: brightness(0); }
30
+ [data-nav-theme="light"] .as-nav-logo-dark { display: none; }
31
+ [data-nav-theme="light"] .as-nav-brand img.as-nav-logo-light { display: block; }
32
+ @media (prefers-color-scheme: light) { [data-nav-theme="system"] .as-nav-logo-dark { display: none; } [data-nav-theme="system"] .as-nav-brand img.as-nav-logo-light { display: block; } }
33
+ .as-nav-topbar { display: flex; align-items: center; gap: 8px; min-width: 0; height: 56px; flex-shrink: 0; padding: 0 16px; background: var(--nav-canvas); border-bottom: 1px solid var(--nav-border); position: relative; }
34
+ .as-nav-topbar--startup { border-bottom-color: transparent; }
35
+ .as-nav-topbar-leading, .as-nav-topbar-actions { display: flex; align-items: center; gap: 4px; min-width: 0; }
36
+ .as-nav-topbar-actions { flex-shrink: 0; }
37
+ .as-nav-topbar-center { position: absolute; left: 50%; transform: translateX(-50%); }
38
+ .as-nav-spacer { flex: 1; }
39
+ .as-nav-context { display: flex; align-items: center; gap: 8px; min-width: 0; }
40
+ .as-nav-title { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
41
+ .as-nav-project-name { max-width: 180px; overflow: hidden; text-overflow: ellipsis; }
42
+ .as-nav-separator, .as-nav-mode-label { color: var(--nav-muted); }
43
+ .as-nav-mode-label { white-space: nowrap; }
44
+ .as-nav-mode-switch { display: flex; padding: 3px; gap: 2px; border-radius: 24px; background: var(--nav-surface); }
45
+ .as-nav-mode-switch button { border: 0; border-radius: 20px; background: transparent; padding: 6px 24px; color: var(--nav-muted); }
46
+ .as-nav-mode-switch button[aria-pressed="true"] { background: var(--nav-selected); color: var(--nav-text); }
47
+ .as-nav-popover { z-index: 100; min-width: 224px; max-width: min(340px, calc(100vw - 24px)); max-height: var(--radix-dropdown-menu-content-available-height); overflow: auto; padding: 6px; background: var(--nav-popover); border: 1px solid var(--nav-border); border-radius: var(--nav-menu-radius); box-shadow: var(--nav-shadow); animation: as-nav-enter 120ms ease-out; }
48
+ .as-nav-menu-heading { padding: 8px 10px; color: var(--nav-muted); font-size: var(--nav-meta-size); }
49
+ .as-nav-menu-separator { height: 1px; margin: 6px 4px; background: var(--nav-border); }
50
+ .as-nav-menu-row { display: flex; align-items: center; gap: 10px; min-height: var(--nav-row-height); padding: 8px 10px; border-radius: var(--nav-radius); cursor: pointer; outline: none; }
51
+ .as-nav-menu-row[data-highlighted] { background: var(--nav-selected); }
52
+ .as-nav-menu-row[data-disabled] { opacity: .45; cursor: default; }
53
+ .as-nav-menu-row[data-destructive] { color: var(--nav-danger); }
54
+ .as-nav-icon { display: grid; place-items: center; width: 18px; }
55
+ .as-nav-avatar { width: 28px; height: 28px; border-radius: 50%; display: grid; place-items: center; background: var(--nav-selected); overflow: hidden; }
56
+ .as-nav-avatar img { width: 100%; height: 100%; object-fit: cover; }
57
+ .as-nav-account--expanded .as-nav-button { width: 100%; justify-content: flex-start; }
58
+ .as-nav-account-copy { display: flex; flex: 1; min-width: 0; text-align: left; flex-direction: column; }
59
+ .as-nav-account-copy strong { font-weight: 500; overflow: hidden; text-overflow: ellipsis; }
60
+ .as-nav-account-copy small { color: var(--nav-muted); font-size: var(--nav-meta-size); }
61
+ .as-nav-sidenav-reserve { width: var(--nav-rail-width); flex-shrink: 0; position: relative; height: 100%; z-index: 45; }
62
+ .as-nav-sidenav-reserve[data-open="true"] { width: var(--nav-width); }
63
+ .as-nav-sidenav { display: flex; flex-direction: column; width: var(--nav-rail-width); height: 100%; background: var(--nav-sidebar); border-right: 1px solid var(--nav-border); position: absolute; inset: 0 auto 0 0; overflow: hidden; }
64
+ .as-nav-sidenav[data-expanded="true"] { width: var(--nav-width); }
65
+ .as-nav-sidenav-reserve[data-open="false"] .as-nav-sidenav[data-expanded="true"] { box-shadow: var(--nav-shadow); }
66
+ .as-nav-sidenav-head { display: flex; align-items: center; min-height: 56px; padding: 8px; }
67
+ .as-nav-sidenav-main { display: flex; flex: 1; min-height: 0; flex-direction: column; }
68
+ .as-nav-destinations { padding: 4px 8px 12px; flex-shrink: 0; }
69
+ .as-nav-destination { display: flex; align-items: center; gap: 12px; padding: 8px 12px; min-height: var(--nav-row-height); width: 100%; text-align: left; background: transparent; border: 0; border-radius: var(--nav-radius); }
70
+ .as-nav-destination:hover, .as-nav-destination[data-active] { background: var(--nav-selected); }
71
+ .as-nav-history { overflow-y: auto; flex: 1; min-height: 0; padding: 0 8px 16px; scrollbar-width: thin; scrollbar-color: var(--nav-border) transparent; }
72
+ .as-nav-history h2 { font-size: var(--nav-meta-size); color: var(--nav-muted); font-weight: 500; margin: 20px 12px 8px; }
73
+ .as-nav-search { display: flex; align-items: center; gap: 8px; padding: 8px 10px; color: var(--nav-muted); }
74
+ .as-nav-search input { width: 100%; min-width: 0; background: transparent; border: 0; font-size: var(--nav-meta-size); }
75
+ .as-nav-conversation { position: relative; display: flex; align-items: center; border-radius: var(--nav-radius); }
76
+ .as-nav-conversation:hover, .as-nav-conversation:focus-within, .as-nav-conversation[data-active] { background: var(--nav-selected); }
77
+ .as-nav-conversation-link { display:flex; align-items:center; gap:8px; flex: 1; min-width: 0; text-align: left; border: 0; background: transparent; padding: 9px 10px; white-space: nowrap; overflow: hidden; }
78
+ .as-nav-conversation-link span { min-width:0; overflow:hidden; text-overflow:ellipsis; }
79
+ .as-nav-conversation-link svg { width:15px; height:15px; color:var(--nav-muted); }
80
+ .as-nav-row-actions { display: none; padding-right: 4px; }
81
+ .as-nav-row-actions .as-nav-button { min-width: 28px; min-height: 28px; padding: 5px; }
82
+ .as-nav-row-actions svg { width: 14px; height: 14px; }
83
+ .as-nav-conversation:hover .as-nav-row-actions, .as-nav-conversation:focus-within .as-nav-row-actions { display: flex; }
84
+ .as-nav-project { border-radius: var(--nav-radius); }
85
+ .as-nav-project[data-active] { background: color-mix(in srgb, var(--nav-accent) 9%, transparent); }
86
+ .as-nav-project-row { display:flex; align-items:center; border-radius:var(--nav-radius); }
87
+ .as-nav-project-row:hover, .as-nav-project-row:focus-within { background:var(--nav-selected); }
88
+ .as-nav-project-toggle { display:flex; align-items:center; gap:8px; flex:1; min-width:0; border:0; background:transparent; padding:9px 10px; text-align:left; }
89
+ .as-nav-project-toggle span { flex:1; min-width:0; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
90
+ .as-nav-project-toggle > svg:last-child { width:14px; height:14px; color:var(--nav-muted); transition:transform .12s ease; }
91
+ .as-nav-project-toggle[aria-expanded="true"] > svg:last-child { transform:rotate(180deg); }
92
+ .as-nav-project-row:hover .as-nav-row-actions, .as-nav-project-row:focus-within .as-nav-row-actions { display:flex; }
93
+ .as-nav-project-conversations { margin-left: 12px; border-left: 1px solid var(--nav-border); padding-left: 4px; }
94
+ .as-nav-project-home { border: 0; background: transparent; color: var(--nav-muted) !important; padding: 8px 12px; font-size: var(--nav-meta-size) !important; }
95
+ .as-nav-sidenav-foot { margin-top: auto; padding: 8px; }
96
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-expanded-only,
97
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-account-copy,
98
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-account .as-nav-button > svg { display: none; }
99
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-destination { justify-content:center; padding-inline:0; }
100
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-destination span { display:none; }
101
+ .as-nav-sidenav:not([data-expanded="true"]) .as-nav-sidenav-foot .as-nav-button { width:100%; padding-inline:0; }
102
+ .as-nav-empty { color: var(--nav-muted); padding: 12px; font-size: var(--nav-meta-size); }
103
+ .as-nav-dialog-overlay { position: fixed; inset: 0; z-index: 80; background: #0008; }
104
+ .as-nav-dialog { position: fixed; z-index: 81; top: 50%; left: 50%; transform: translate(-50%,-50%); width: min(400px, calc(100vw - 32px)); background: var(--nav-popover); border: 1px solid var(--nav-border); border-radius: var(--nav-menu-radius); padding: 24px; box-shadow: var(--nav-shadow); }
105
+ .as-nav-dialog h2 { font-size: 18px; margin: 0 0 8px; }
106
+ .as-nav-dialog p { color: var(--nav-muted); margin-bottom: 20px; }
107
+ .as-nav-dialog input { background: var(--nav-surface); border: 1px solid var(--nav-border); padding: 10px 12px; border-radius: var(--nav-radius); width: 100%; }
108
+ .as-nav-dialog-actions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 16px; }
109
+ .as-nav-mobile-drawer { position: fixed; z-index: 81; inset: 0 auto 0 0; display: flex; flex-direction: column; width: min(320px, 90vw); background: var(--nav-sidebar); }
110
+ .as-nav-sr-only { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0,0,0,0); }
111
+ @keyframes as-nav-enter { from { opacity: 0; transform: translateY(-3px); } to { opacity: 1; transform: translateY(0); } }
112
+ @media (max-width: 767px) { .as-nav-topbar { padding: 0 8px; gap: 4px; } .as-nav-mode-label, .as-nav-share-label, .as-nav-project-name { display: none; } .as-nav-context { gap: 4px; } .as-nav-button { min-width: 44px; min-height: 44px; } .as-nav-menu-row { min-height: 44px; } .as-nav-topbar-center .as-nav-mode-switch button { padding-inline: 16px; } .as-nav-row-actions { display: flex; } }
113
+ @media (prefers-reduced-motion: reduce) { .as-nav-scope *, .as-nav-scope *::before { animation: none !important; transition: none !important; scroll-behavior: auto !important; } }
@@ -0,0 +1 @@
1
+ export declare function cx(...values: Array<string | false | null | undefined>): string;
@@ -0,0 +1,43 @@
1
+ {
2
+ "name": "@inneranimalmedia/agentsam-nav",
3
+ "version": "0.1.0",
4
+ "private": false,
5
+ "description": "Reusable responsive navigation primitives for AgentSam dashboard-family applications.",
6
+ "type": "module",
7
+ "main": "./dist/index.js",
8
+ "types": "./dist/index.d.ts",
9
+ "files": ["dist", "README.md"],
10
+ "sideEffects": ["**/*.css"],
11
+ "license": "MIT",
12
+ "publishConfig": { "access": "public" },
13
+ "exports": {
14
+ ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
15
+ "./browser": { "types": "./dist/browser.d.ts", "import": "./dist/browser.js" },
16
+ "./browser.global.js": "./dist/browser.global.js",
17
+ "./theme.css": "./dist/theme.css",
18
+ "./legacy.css": "./dist/legacy.css"
19
+ },
20
+ "scripts": {
21
+ "typecheck": "tsc --noEmit -p tsconfig.json",
22
+ "build": "node scripts/build.mjs",
23
+ "test": "npm run build && node --test test/*.test.mjs",
24
+ "prepack": "npm run build"
25
+ },
26
+ "peerDependencies": {
27
+ "react": ">=18",
28
+ "react-dom": ">=18"
29
+ },
30
+ "devDependencies": {
31
+ "@types/react": "^19.2.0",
32
+ "@types/react-dom": "^19.2.0",
33
+ "esbuild": "^0.28.1",
34
+ "react": "^19.2.0",
35
+ "react-dom": "^19.2.0",
36
+ "typescript": "^5.9.3"
37
+ },
38
+ "dependencies": {
39
+ "@radix-ui/react-dialog": "^1.1.23",
40
+ "@radix-ui/react-dropdown-menu": "^2.1.24",
41
+ "lucide-react": "^0.510.0"
42
+ }
43
+ }
@@ -0,0 +1,107 @@
1
+ # @inneranimalmedia/agentsam-queue-control
2
+
3
+ Portable queue and execution-control primitives for AgentSam.
4
+
5
+ The package deliberately separates four concerns:
6
+
7
+ - **WorkGraph** answers what depends on what.
8
+ - **Queue Control** answers when, where, and how a ready work unit executes.
9
+ - **Provider adapters** perform the concrete queue or runtime operation.
10
+ - **MCP/CLI/HTTP/UI** are exposure surfaces, not execution authority.
11
+
12
+ ## Goals
13
+
14
+ - Cloudflare-first without Cloudflare lock-in.
15
+ - One stable job envelope across CAD, code indexing, CMS, commerce, deployment, webhook, batch-AI, and future worker types.
16
+ - Logical queues stay stable while physical topology can start compact and split later.
17
+ - Deterministic routing keeps LLMs out of timers, polling loops, retries, and ordinary scheduling.
18
+ - Infrastructure creation is approval-gated by default.
19
+ - OpenAI/Gemini batch execution is represented as an executor choice, not confused with the queue itself.
20
+
21
+ ## Fast start
22
+
23
+ ```js
24
+ import {
25
+ QueueControl,
26
+ MemoryQueueAdapter,
27
+ buildQueueTopology,
28
+ } from '@inneranimalmedia/agentsam-queue-control';
29
+
30
+ const queue = new QueueControl({
31
+ adapter: new MemoryQueueAdapter(),
32
+ topology: buildQueueTopology({
33
+ namespace: 'my-app',
34
+ environment: 'dev',
35
+ mode: 'compact',
36
+ }),
37
+ });
38
+
39
+ queue.register('cad.*', async (job) => {
40
+ return buildCadModel(job.payload);
41
+ });
42
+
43
+ await queue.enqueue({
44
+ account_id: account.id,
45
+ kind: 'cad.generate',
46
+ payload: { project_id: 'project_123' },
47
+ });
48
+ ```
49
+
50
+ The same application contract can later swap the adapter for Cloudflare Queues without rewriting job definitions.
51
+
52
+ ## Logical vs physical queues
53
+
54
+ A developer can use stable logical lanes such as:
55
+
56
+ ```text
57
+ deployments
58
+ cad
59
+ indexing
60
+ cms
61
+ webhooks
62
+ batch_ai
63
+ ```
64
+
65
+ In `compact` mode those lanes share one physical queue plus a DLQ. In `segmented` mode they can map to separate physical queues. Apps do not need to change when topology changes.
66
+
67
+ ## Cloudflare
68
+
69
+ Two adapters are intentionally separate:
70
+
71
+ - `CloudflareQueueBindingAdapter`: runtime publishing through Worker Queue bindings.
72
+ - `CloudflareQueueApiAdapter`: control-plane provisioning through Cloudflare's account API.
73
+
74
+ This avoids mixing application messages with infrastructure mutation credentials.
75
+
76
+ Provisioning is approval-gated by `QueueControl.provision()` unless the host explicitly sets `routingPolicy.allow_infrastructure_mutation = true`.
77
+
78
+ ## Batch AI
79
+
80
+ `routeWork()` can classify deferred, independent bulk inference as `openai_batch` or `gemini_batch`. Queue Control records and routes that decision; provider-specific batch clients can execute it behind the same job contract.
81
+
82
+ ## Multi-worker job kinds
83
+
84
+ Use namespaced kinds instead of one giant worker:
85
+
86
+ ```text
87
+ deploy.worker
88
+ infra.migrate
89
+ cad.generate
90
+ cad.render
91
+ code.index
92
+ repository.index
93
+ cms.publish
94
+ commerce.order.sync
95
+ webhook.process
96
+ ai.batch.submit
97
+ ```
98
+
99
+ Dispatch supports exact kinds and prefix wildcards such as `cad.*`.
100
+
101
+ ## Relationship to WorkGraph
102
+
103
+ Queue Control does not replace `@inneranimalmedia/work-graph`. A WorkGraph can release ready nodes; Queue Control then schedules those nodes to an executor. Completion receipts can be projected back into the graph by the host.
104
+
105
+ ## Relationship to AgentSam tools and MCP
106
+
107
+ The canonical capability/tool contract should sit above transports. A tool may be called inline, queued, from a WorkGraph, from a hook, from CLI, or exposed through MCP. Queue Control only owns execution routing and job lifecycle semantics.
@@ -0,0 +1,31 @@
1
+ {
2
+ "name": "@inneranimalmedia/agentsam-queue-control",
3
+ "version": "0.1.0",
4
+ "description": "Portable AgentSam queue, job-routing, batching, and execution-control primitives with Cloudflare-first adapters.",
5
+ "type": "module",
6
+ "main": "./src/index.js",
7
+ "exports": {
8
+ ".": "./src/index.js",
9
+ "./contracts": "./src/contracts.js",
10
+ "./policy": "./src/policy.js",
11
+ "./topology": "./src/topology.js",
12
+ "./dispatch": "./src/dispatch.js",
13
+ "./adapters/memory": "./src/adapters/memory.js",
14
+ "./adapters/cloudflare": "./src/adapters/cloudflare.js"
15
+ },
16
+ "files": [
17
+ "src",
18
+ "schemas",
19
+ "README.md"
20
+ ],
21
+ "scripts": {
22
+ "test": "node --test test/*.test.mjs"
23
+ },
24
+ "engines": {
25
+ "node": ">=22 <25"
26
+ },
27
+ "publishConfig": {
28
+ "access": "public"
29
+ },
30
+ "license": "MIT"
31
+ }
@@ -0,0 +1,56 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://inneranimalmedia.com/schemas/agentsam/queue-control/job-envelope.v1.schema.json",
4
+ "title": "AgentSam Queue Job Envelope v1",
5
+ "type": "object",
6
+ "required": [
7
+ "schema_version",
8
+ "id",
9
+ "account_id",
10
+ "kind",
11
+ "executor",
12
+ "priority",
13
+ "status",
14
+ "created_at"
15
+ ],
16
+ "properties": {
17
+ "schema_version": { "const": "1" },
18
+ "id": { "type": "string", "minLength": 1 },
19
+ "account_id": { "type": "string", "minLength": 1 },
20
+ "kind": { "type": "string", "minLength": 1 },
21
+ "logical_queue": { "type": ["string", "null"] },
22
+ "executor": {
23
+ "enum": [
24
+ "inline",
25
+ "queue",
26
+ "workflow",
27
+ "execos",
28
+ "worker_rpc",
29
+ "openai_batch",
30
+ "gemini_batch",
31
+ "external"
32
+ ]
33
+ },
34
+ "priority": { "enum": ["low", "normal", "high", "urgent"] },
35
+ "status": {
36
+ "enum": [
37
+ "queued",
38
+ "claimed",
39
+ "running",
40
+ "waiting",
41
+ "batch_waiting",
42
+ "awaiting_input",
43
+ "completed",
44
+ "failed",
45
+ "cancelled"
46
+ ]
47
+ },
48
+ "payload": {},
49
+ "payload_ref": { "type": ["string", "null"] },
50
+ "metadata": { "type": "object" },
51
+ "retry": { "type": "object" },
52
+ "attempt": { "type": "integer", "minimum": 0 },
53
+ "created_at": { "type": "integer", "minimum": 0 }
54
+ },
55
+ "additionalProperties": true
56
+ }