takos-control 1.0.0

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 (747) hide show
  1. package/package.json +169 -0
  2. package/src/__tests__/db-runtime-contracts.test.ts +57 -0
  3. package/src/adapters/analytics-engine-binding.ts +104 -0
  4. package/src/adapters/dynamo-kv-store.ts +284 -0
  5. package/src/adapters/firestore-kv-store.ts +287 -0
  6. package/src/adapters/gcs-object-store.ts +506 -0
  7. package/src/adapters/openai-binding.ts +83 -0
  8. package/src/adapters/pgvector-store.ts +236 -0
  9. package/src/adapters/pubsub-queue.ts +127 -0
  10. package/src/adapters/r2-compat-types.ts +54 -0
  11. package/src/adapters/s3-object-store.ts +539 -0
  12. package/src/adapters/sqs-queue.ts +133 -0
  13. package/src/adapters/workflow-binding.ts +131 -0
  14. package/src/application/services/actions/actions-env.ts +49 -0
  15. package/src/application/services/actions/actions-execution.ts +156 -0
  16. package/src/application/services/actions/actions-triggers.ts +224 -0
  17. package/src/application/services/actions/index.ts +18 -0
  18. package/src/application/services/activitypub/remote-install.ts +170 -0
  19. package/src/application/services/activitypub/remote-store-client.ts +435 -0
  20. package/src/application/services/activitypub/store-registry.ts +341 -0
  21. package/src/application/services/activitypub/store-subscription.ts +240 -0
  22. package/src/application/services/activitypub/stores.ts +389 -0
  23. package/src/application/services/agent/agent-models.ts +55 -0
  24. package/src/application/services/agent/delegation.ts +328 -0
  25. package/src/application/services/agent/execute-run.ts +46 -0
  26. package/src/application/services/agent/index.ts +46 -0
  27. package/src/application/services/agent/langgraph-agent.ts +282 -0
  28. package/src/application/services/agent/langgraph-checkpointer.ts +556 -0
  29. package/src/application/services/agent/langgraph-graph.ts +357 -0
  30. package/src/application/services/agent/langgraph-runner.ts +326 -0
  31. package/src/application/services/agent/langgraph-tools.ts +157 -0
  32. package/src/application/services/agent/llm-manager.ts +51 -0
  33. package/src/application/services/agent/llm.ts +106 -0
  34. package/src/application/services/agent/memory-manager.ts +84 -0
  35. package/src/application/services/agent/message-persistence.ts +151 -0
  36. package/src/application/services/agent/message-utils.ts +167 -0
  37. package/src/application/services/agent/model-catalog.ts +71 -0
  38. package/src/application/services/agent/official-skills.ts +437 -0
  39. package/src/application/services/agent/prompt-assets.generated.ts +23 -0
  40. package/src/application/services/agent/prompt-budget.ts +140 -0
  41. package/src/application/services/agent/prompt-builder.ts +72 -0
  42. package/src/application/services/agent/prompts/core.md +9 -0
  43. package/src/application/services/agent/prompts/general-workflow.md +6 -0
  44. package/src/application/services/agent/prompts/modes/assistant.md +4 -0
  45. package/src/application/services/agent/prompts/modes/default.md +8 -0
  46. package/src/application/services/agent/prompts/modes/implementer.md +5 -0
  47. package/src/application/services/agent/prompts/modes/planner.md +4 -0
  48. package/src/application/services/agent/prompts/modes/researcher.md +5 -0
  49. package/src/application/services/agent/prompts/modes/reviewer.md +4 -0
  50. package/src/application/services/agent/prompts/response-guidelines.md +20 -0
  51. package/src/application/services/agent/prompts/runtime-tool-catalog-empty.md +3 -0
  52. package/src/application/services/agent/prompts/runtime-tool-catalog-header.md +3 -0
  53. package/src/application/services/agent/prompts/runtime-tool-catalog-selective.md +8 -0
  54. package/src/application/services/agent/prompts/skills/planning-structurer.en.md +1 -0
  55. package/src/application/services/agent/prompts/skills/planning-structurer.ja.md +1 -0
  56. package/src/application/services/agent/prompts/skills/repo-app-operator.en.md +1 -0
  57. package/src/application/services/agent/prompts/skills/repo-app-operator.ja.md +1 -0
  58. package/src/application/services/agent/prompts/skills/research-brief.en.md +1 -0
  59. package/src/application/services/agent/prompts/skills/research-brief.ja.md +1 -0
  60. package/src/application/services/agent/prompts/skills/slides-author.en.md +1 -0
  61. package/src/application/services/agent/prompts/skills/slides-author.ja.md +1 -0
  62. package/src/application/services/agent/prompts/skills/writing-draft.en.md +1 -0
  63. package/src/application/services/agent/prompts/skills/writing-draft.ja.md +1 -0
  64. package/src/application/services/agent/prompts/tool-runtime-rules.md +6 -0
  65. package/src/application/services/agent/providers/llm-providers.ts +484 -0
  66. package/src/application/services/agent/remote-tool-executor.ts +78 -0
  67. package/src/application/services/agent/run-lifecycle.ts +59 -0
  68. package/src/application/services/agent/runner-config.ts +77 -0
  69. package/src/application/services/agent/runner-events.ts +169 -0
  70. package/src/application/services/agent/runner-history.ts +368 -0
  71. package/src/application/services/agent/runner-types.ts +73 -0
  72. package/src/application/services/agent/runner.ts +682 -0
  73. package/src/application/services/agent/security/injection-detector.ts +145 -0
  74. package/src/application/services/agent/session-closer.ts +438 -0
  75. package/src/application/services/agent/simple-loop.ts +367 -0
  76. package/src/application/services/agent/skill-contracts.ts +21 -0
  77. package/src/application/services/agent/skill-loader.ts +319 -0
  78. package/src/application/services/agent/skill-plan.ts +67 -0
  79. package/src/application/services/agent/skill-resolution.ts +328 -0
  80. package/src/application/services/agent/skill-scoring.ts +261 -0
  81. package/src/application/services/agent/skill-templates.ts +51 -0
  82. package/src/application/services/agent/skills.ts +54 -0
  83. package/src/application/services/agent/thread-context.ts +472 -0
  84. package/src/application/services/agent/workflow-pr.ts +150 -0
  85. package/src/application/services/agent/workflow-review.ts +116 -0
  86. package/src/application/services/agent/workflow-session.ts +156 -0
  87. package/src/application/services/agent/workflow-types.ts +133 -0
  88. package/src/application/services/agent/workflow.ts +264 -0
  89. package/src/application/services/billing/billing-accounts.ts +165 -0
  90. package/src/application/services/billing/billing-plans.ts +252 -0
  91. package/src/application/services/billing/billing-run-usage.ts +89 -0
  92. package/src/application/services/billing/billing-types.ts +94 -0
  93. package/src/application/services/billing/billing-usage.ts +370 -0
  94. package/src/application/services/billing/billing.ts +64 -0
  95. package/src/application/services/billing/stripe.ts +331 -0
  96. package/src/application/services/cloudflare/api-client.ts +195 -0
  97. package/src/application/services/cloudflare/resources.ts +134 -0
  98. package/src/application/services/common-env/audit.ts +65 -0
  99. package/src/application/services/common-env/crypto.ts +184 -0
  100. package/src/application/services/common-env/db-helpers.ts +16 -0
  101. package/src/application/services/common-env/index.ts +4 -0
  102. package/src/application/services/common-env/link-state.ts +70 -0
  103. package/src/application/services/common-env/maintenance.ts +36 -0
  104. package/src/application/services/common-env/manual-link-ops.ts +385 -0
  105. package/src/application/services/common-env/orchestrator.ts +146 -0
  106. package/src/application/services/common-env/reconcile-jobs.ts +529 -0
  107. package/src/application/services/common-env/reconciler.ts +103 -0
  108. package/src/application/services/common-env/repository.ts +185 -0
  109. package/src/application/services/common-env/service-link-ops.ts +144 -0
  110. package/src/application/services/common-env/service.ts +355 -0
  111. package/src/application/services/common-env/space-env-ops.ts +245 -0
  112. package/src/application/services/common-env/takos-builtins.ts +386 -0
  113. package/src/application/services/deployment/artifacts.ts +105 -0
  114. package/src/application/services/deployment/deployment-artifacts.ts +143 -0
  115. package/src/application/services/deployment/execute.ts +364 -0
  116. package/src/application/services/deployment/group-deploy-manifest.ts +71 -0
  117. package/src/application/services/deployment/group-deploy-types.ts +116 -0
  118. package/src/application/services/deployment/group-deploy.ts +349 -0
  119. package/src/application/services/deployment/index.ts +7 -0
  120. package/src/application/services/deployment/models.ts +154 -0
  121. package/src/application/services/deployment/provider.ts +358 -0
  122. package/src/application/services/deployment/resource-provisioner.ts +175 -0
  123. package/src/application/services/deployment/rollback-orchestrator.ts +260 -0
  124. package/src/application/services/deployment/rollback.ts +110 -0
  125. package/src/application/services/deployment/routing.ts +311 -0
  126. package/src/application/services/deployment/service.ts +325 -0
  127. package/src/application/services/deployment/state.ts +85 -0
  128. package/src/application/services/deployment/store.ts +386 -0
  129. package/src/application/services/deployment/wrangler-config-gen.ts +182 -0
  130. package/src/application/services/execution/embeddings.ts +457 -0
  131. package/src/application/services/execution/run-creation.ts +138 -0
  132. package/src/application/services/execution/run-events.ts +127 -0
  133. package/src/application/services/execution/runtime-request-handler.ts +173 -0
  134. package/src/application/services/execution/sql-validation.ts +202 -0
  135. package/src/application/services/execution/workflow-engine-converters.ts +75 -0
  136. package/src/application/services/execution/workflow-engine-types.ts +77 -0
  137. package/src/application/services/execution/workflow-engine.ts +104 -0
  138. package/src/application/services/execution/workflow-job-scheduler.ts +344 -0
  139. package/src/application/services/execution/workflow-run-lifecycle.ts +389 -0
  140. package/src/application/services/execution/workflow-storage.ts +83 -0
  141. package/src/application/services/git-smart/client/fetch-pack.ts +167 -0
  142. package/src/application/services/git-smart/client/fetch-refs.ts +134 -0
  143. package/src/application/services/git-smart/client/index.ts +10 -0
  144. package/src/application/services/git-smart/core/commit-index.ts +436 -0
  145. package/src/application/services/git-smart/core/merge.ts +102 -0
  146. package/src/application/services/git-smart/core/object-store.ts +235 -0
  147. package/src/application/services/git-smart/core/object.ts +238 -0
  148. package/src/application/services/git-smart/core/readable-commit.ts +59 -0
  149. package/src/application/services/git-smart/core/refs.ts +364 -0
  150. package/src/application/services/git-smart/core/sha1.ts +40 -0
  151. package/src/application/services/git-smart/core/tree-ops.ts +228 -0
  152. package/src/application/services/git-smart/git-objects.ts +122 -0
  153. package/src/application/services/git-smart/index.ts +135 -0
  154. package/src/application/services/git-smart/operations.ts +154 -0
  155. package/src/application/services/git-smart/protocol/capabilities.ts +28 -0
  156. package/src/application/services/git-smart/protocol/packfile-reader.ts +368 -0
  157. package/src/application/services/git-smart/protocol/packfile-writer.ts +129 -0
  158. package/src/application/services/git-smart/protocol/pkt-line.ts +97 -0
  159. package/src/application/services/git-smart/smart-http/info-refs.ts +67 -0
  160. package/src/application/services/git-smart/smart-http/receive-pack.ts +485 -0
  161. package/src/application/services/git-smart/smart-http/upload-pack.ts +72 -0
  162. package/src/application/services/identity/auth-utils.ts +432 -0
  163. package/src/application/services/identity/locale.ts +19 -0
  164. package/src/application/services/identity/membership-resolver.ts +28 -0
  165. package/src/application/services/identity/principals.ts +76 -0
  166. package/src/application/services/identity/profile-activity.ts +248 -0
  167. package/src/application/services/identity/response-formatters.ts +88 -0
  168. package/src/application/services/identity/session.ts +221 -0
  169. package/src/application/services/identity/shortcut-groups.ts +421 -0
  170. package/src/application/services/identity/shortcuts.ts +216 -0
  171. package/src/application/services/identity/space-access.ts +128 -0
  172. package/src/application/services/identity/space-crud.ts +494 -0
  173. package/src/application/services/identity/space-members.ts +177 -0
  174. package/src/application/services/identity/space-models.ts +50 -0
  175. package/src/application/services/identity/spaces.ts +29 -0
  176. package/src/application/services/identity/takos-access-tokens.ts +149 -0
  177. package/src/application/services/identity/user-cache.ts +66 -0
  178. package/src/application/services/identity/user-settings.ts +146 -0
  179. package/src/application/services/maintenance/backup-maintenance.ts +453 -0
  180. package/src/application/services/maintenance/custom-domain-maintenance.ts +415 -0
  181. package/src/application/services/maintenance/index.ts +31 -0
  182. package/src/application/services/maintenance/resource-orphan-gc.ts +66 -0
  183. package/src/application/services/maintenance/session-maintenance.ts +50 -0
  184. package/src/application/services/maintenance/snapshot-maintenance.ts +147 -0
  185. package/src/application/services/memory/consolidation.ts +365 -0
  186. package/src/application/services/memory/extractor.ts +320 -0
  187. package/src/application/services/memory/index.ts +17 -0
  188. package/src/application/services/memory/llm-parser.ts +44 -0
  189. package/src/application/services/memory/memories.ts +392 -0
  190. package/src/application/services/memory-graph/activation.ts +60 -0
  191. package/src/application/services/memory-graph/claim-store.ts +306 -0
  192. package/src/application/services/memory-graph/graph-models.ts +119 -0
  193. package/src/application/services/memory-graph/memory-graph-runtime.ts +220 -0
  194. package/src/application/services/memory-graph/observer.ts +158 -0
  195. package/src/application/services/memory-graph/overlay.ts +101 -0
  196. package/src/application/services/notifications/notification-models.ts +58 -0
  197. package/src/application/services/notifications/service.ts +522 -0
  198. package/src/application/services/oauth/audit.ts +50 -0
  199. package/src/application/services/oauth/authorization.ts +286 -0
  200. package/src/application/services/oauth/client.ts +346 -0
  201. package/src/application/services/oauth/consent.ts +244 -0
  202. package/src/application/services/oauth/device.ts +295 -0
  203. package/src/application/services/oauth/pkce.ts +60 -0
  204. package/src/application/services/oauth/scopes.ts +61 -0
  205. package/src/application/services/oauth/token.ts +555 -0
  206. package/src/application/services/offload/index.ts +31 -0
  207. package/src/application/services/offload/messages.ts +67 -0
  208. package/src/application/services/offload/run-events.ts +128 -0
  209. package/src/application/services/offload/usage-client.ts +39 -0
  210. package/src/application/services/offload/usage-events.ts +100 -0
  211. package/src/application/services/platform/app-deployments.ts +397 -0
  212. package/src/application/services/platform/capabilities.ts +288 -0
  213. package/src/application/services/platform/custom-domains/access.ts +93 -0
  214. package/src/application/services/platform/custom-domains/cloudflare.ts +64 -0
  215. package/src/application/services/platform/custom-domains/dns.ts +55 -0
  216. package/src/application/services/platform/custom-domains/domain-crud.ts +230 -0
  217. package/src/application/services/platform/custom-domains/domain-models.ts +71 -0
  218. package/src/application/services/platform/custom-domains/domain-verification.ts +345 -0
  219. package/src/application/services/platform/custom-domains.ts +27 -0
  220. package/src/application/services/platform/desired-state-types.ts +111 -0
  221. package/src/application/services/platform/env-state-resolution.ts +249 -0
  222. package/src/application/services/platform/infra.ts +246 -0
  223. package/src/application/services/platform/mcp/crud.ts +343 -0
  224. package/src/application/services/platform/mcp/crypto.ts +63 -0
  225. package/src/application/services/platform/mcp/mcp-models.ts +119 -0
  226. package/src/application/services/platform/mcp/oauth.ts +375 -0
  227. package/src/application/services/platform/mcp/validation.ts +69 -0
  228. package/src/application/services/platform/mcp.ts +51 -0
  229. package/src/application/services/platform/resource-bindings.ts +172 -0
  230. package/src/application/services/platform/rollout-health.ts +48 -0
  231. package/src/application/services/platform/rollout.ts +358 -0
  232. package/src/application/services/platform/runtime-config.ts +155 -0
  233. package/src/application/services/platform/ui-extensions.ts +190 -0
  234. package/src/application/services/platform/worker-desired-state.ts +397 -0
  235. package/src/application/services/platform/workers.ts +426 -0
  236. package/src/application/services/platform/workflow-artifacts.ts +204 -0
  237. package/src/application/services/pull-requests/ai-review.ts +362 -0
  238. package/src/application/services/pull-requests/event-tasks.ts +67 -0
  239. package/src/application/services/pull-requests/index.ts +25 -0
  240. package/src/application/services/pull-requests/merge-resolution.ts +501 -0
  241. package/src/application/services/r2/orphaned-object-gc.ts +268 -0
  242. package/src/application/services/resources/access.ts +180 -0
  243. package/src/application/services/resources/bindings.ts +185 -0
  244. package/src/application/services/resources/format.ts +76 -0
  245. package/src/application/services/resources/index.ts +32 -0
  246. package/src/application/services/resources/lifecycle.ts +92 -0
  247. package/src/application/services/resources/store.ts +387 -0
  248. package/src/application/services/routing/cache.ts +176 -0
  249. package/src/application/services/routing/phase.ts +20 -0
  250. package/src/application/services/routing/resolver.ts +227 -0
  251. package/src/application/services/routing/routing-models.ts +46 -0
  252. package/src/application/services/routing/service.ts +298 -0
  253. package/src/application/services/routing/sharding.ts +41 -0
  254. package/src/application/services/run-notifier/client.ts +32 -0
  255. package/src/application/services/run-notifier/index.ts +20 -0
  256. package/src/application/services/run-notifier/run-events-contract.ts +114 -0
  257. package/src/application/services/run-notifier/run-failure-events.ts +62 -0
  258. package/src/application/services/run-notifier/run-notifier-payload.ts +28 -0
  259. package/src/application/services/runs/create-thread-run-store.ts +527 -0
  260. package/src/application/services/runs/create-thread-run-validation.ts +88 -0
  261. package/src/application/services/runs/run-serialization.ts +102 -0
  262. package/src/application/services/seed-repositories.ts +37 -0
  263. package/src/application/services/source/__tests__/app-manifest-template.test.ts +211 -0
  264. package/src/application/services/source/app-manifest-bundle.ts +427 -0
  265. package/src/application/services/source/app-manifest-parser.ts +375 -0
  266. package/src/application/services/source/app-manifest-template.ts +93 -0
  267. package/src/application/services/source/app-manifest-types.ts +241 -0
  268. package/src/application/services/source/app-manifest-validation.ts +212 -0
  269. package/src/application/services/source/app-manifest.ts +38 -0
  270. package/src/application/services/source/apps.ts +130 -0
  271. package/src/application/services/source/explore-catalog.ts +446 -0
  272. package/src/application/services/source/explore-packages.ts +612 -0
  273. package/src/application/services/source/explore-repos.ts +189 -0
  274. package/src/application/services/source/explore-types.ts +155 -0
  275. package/src/application/services/source/explore.ts +20 -0
  276. package/src/application/services/source/external-import-utils.ts +126 -0
  277. package/src/application/services/source/external-import.ts +430 -0
  278. package/src/application/services/source/fork.ts +349 -0
  279. package/src/application/services/source/git.ts +556 -0
  280. package/src/application/services/source/info-units.ts +383 -0
  281. package/src/application/services/source/official-packages.ts +50 -0
  282. package/src/application/services/source/repo-release-assets.ts +55 -0
  283. package/src/application/services/source/repos.ts +231 -0
  284. package/src/application/services/source/search.ts +247 -0
  285. package/src/application/services/source/skill-search.ts +315 -0
  286. package/src/application/services/source/skills.ts +584 -0
  287. package/src/application/services/source/source-exploration.ts +221 -0
  288. package/src/application/services/source/space-storage.ts +484 -0
  289. package/src/application/services/sync/git-sync-types.ts +35 -0
  290. package/src/application/services/sync/git-sync.ts +228 -0
  291. package/src/application/services/sync/index.ts +6 -0
  292. package/src/application/services/sync/models.ts +65 -0
  293. package/src/application/services/sync/runtime-session.ts +444 -0
  294. package/src/application/services/sync/session-files.ts +370 -0
  295. package/src/application/services/sync/snapshot-cleanup.ts +290 -0
  296. package/src/application/services/sync/snapshot-compressor.ts +79 -0
  297. package/src/application/services/sync/snapshot-storage.ts +136 -0
  298. package/src/application/services/sync/snapshot.ts +426 -0
  299. package/src/application/services/threads/thread-export.ts +140 -0
  300. package/src/application/services/threads/thread-history.ts +422 -0
  301. package/src/application/services/threads/thread-search.ts +299 -0
  302. package/src/application/services/threads/thread-service.ts +394 -0
  303. package/src/application/services/threads/thread-shares.ts +200 -0
  304. package/src/application/services/threads/thread-timeline.ts +44 -0
  305. package/src/application/services/wfp/assets.ts +218 -0
  306. package/src/application/services/wfp/bindings.ts +176 -0
  307. package/src/application/services/wfp/client.ts +199 -0
  308. package/src/application/services/wfp/d1.ts +133 -0
  309. package/src/application/services/wfp/index.ts +23 -0
  310. package/src/application/services/wfp/kv.ts +38 -0
  311. package/src/application/services/wfp/orchestrator.ts +339 -0
  312. package/src/application/services/wfp/queues.ts +77 -0
  313. package/src/application/services/wfp/r2.ts +131 -0
  314. package/src/application/services/wfp/service.ts +341 -0
  315. package/src/application/services/wfp/vectorize.ts +48 -0
  316. package/src/application/services/wfp/wfp-contracts.ts +102 -0
  317. package/src/application/services/wfp/worker-metadata.ts +54 -0
  318. package/src/application/services/wfp/workers.ts +307 -0
  319. package/src/application/services/workflow-runs/commands.ts +354 -0
  320. package/src/application/services/workflow-runs/read-model.ts +202 -0
  321. package/src/application/services/workflow-runs/stream.ts +54 -0
  322. package/src/application/tools/builtin/agent.ts +383 -0
  323. package/src/application/tools/builtin/artifact.ts +163 -0
  324. package/src/application/tools/builtin/browser/definitions.ts +167 -0
  325. package/src/application/tools/builtin/browser/handler-action.ts +76 -0
  326. package/src/application/tools/builtin/browser/handler-close.ts +31 -0
  327. package/src/application/tools/builtin/browser/handler-extract.ts +42 -0
  328. package/src/application/tools/builtin/browser/handler-goto.ts +41 -0
  329. package/src/application/tools/builtin/browser/handler-html.ts +38 -0
  330. package/src/application/tools/builtin/browser/handler-open.ts +68 -0
  331. package/src/application/tools/builtin/browser/handler-screenshot.ts +33 -0
  332. package/src/application/tools/builtin/browser/session.ts +51 -0
  333. package/src/application/tools/builtin/browser.ts +27 -0
  334. package/src/application/tools/builtin/container/availability.ts +65 -0
  335. package/src/application/tools/builtin/container/definitions.ts +119 -0
  336. package/src/application/tools/builtin/container/handler-commit.ts +182 -0
  337. package/src/application/tools/builtin/container/handler-create-repository.ts +54 -0
  338. package/src/application/tools/builtin/container/handler-start.ts +236 -0
  339. package/src/application/tools/builtin/container/handler-status.ts +108 -0
  340. package/src/application/tools/builtin/container/handler-stop.ts +64 -0
  341. package/src/application/tools/builtin/container/session.ts +116 -0
  342. package/src/application/tools/builtin/container.ts +39 -0
  343. package/src/application/tools/builtin/deploy.ts +65 -0
  344. package/src/application/tools/builtin/discovery.ts +142 -0
  345. package/src/application/tools/builtin/file/definitions.ts +220 -0
  346. package/src/application/tools/builtin/file/file-operations.ts +112 -0
  347. package/src/application/tools/builtin/file/handler-copy.ts +77 -0
  348. package/src/application/tools/builtin/file/handler-delete.ts +34 -0
  349. package/src/application/tools/builtin/file/handler-list.ts +26 -0
  350. package/src/application/tools/builtin/file/handler-mkdir.ts +25 -0
  351. package/src/application/tools/builtin/file/handler-read.ts +27 -0
  352. package/src/application/tools/builtin/file/handler-rename.ts +85 -0
  353. package/src/application/tools/builtin/file/handler-write-binary.ts +63 -0
  354. package/src/application/tools/builtin/file/handler-write.ts +41 -0
  355. package/src/application/tools/builtin/file/limits.ts +114 -0
  356. package/src/application/tools/builtin/file/session.ts +86 -0
  357. package/src/application/tools/builtin/file.ts +54 -0
  358. package/src/application/tools/builtin/index.ts +9 -0
  359. package/src/application/tools/builtin/info-unit.ts +403 -0
  360. package/src/application/tools/builtin/mcp.ts +232 -0
  361. package/src/application/tools/builtin/memory-graph.ts +97 -0
  362. package/src/application/tools/builtin/memory.ts +247 -0
  363. package/src/application/tools/builtin/platform/deployment-history.ts +185 -0
  364. package/src/application/tools/builtin/platform/deployments.ts +298 -0
  365. package/src/application/tools/builtin/platform/domains.ts +264 -0
  366. package/src/application/tools/builtin/platform/worker-settings.ts +482 -0
  367. package/src/application/tools/builtin/platform.ts +63 -0
  368. package/src/application/tools/builtin/registry.ts +133 -0
  369. package/src/application/tools/builtin/repo.ts +135 -0
  370. package/src/application/tools/builtin/runtime-tool-executor.ts +259 -0
  371. package/src/application/tools/builtin/space-app-deployments.ts +136 -0
  372. package/src/application/tools/builtin/space-common-env.ts +125 -0
  373. package/src/application/tools/builtin/space-files.ts +414 -0
  374. package/src/application/tools/builtin/space-skills.ts +482 -0
  375. package/src/application/tools/builtin/space-source.ts +193 -0
  376. package/src/application/tools/builtin/storage/d1.ts +309 -0
  377. package/src/application/tools/builtin/storage/kv.ts +201 -0
  378. package/src/application/tools/builtin/storage/r2.ts +344 -0
  379. package/src/application/tools/builtin/storage/resources.ts +288 -0
  380. package/src/application/tools/builtin/storage/validators.ts +35 -0
  381. package/src/application/tools/builtin/storage.ts +64 -0
  382. package/src/application/tools/builtin/web.ts +492 -0
  383. package/src/application/tools/candidate-selector.ts +131 -0
  384. package/src/application/tools/capabilities.ts +51 -0
  385. package/src/application/tools/capability-registry.ts +79 -0
  386. package/src/application/tools/capability-types.ts +44 -0
  387. package/src/application/tools/circuit-breaker.ts +149 -0
  388. package/src/application/tools/descriptor-builder.ts +185 -0
  389. package/src/application/tools/executor-setup.ts +195 -0
  390. package/src/application/tools/executor-utils.ts +21 -0
  391. package/src/application/tools/executor.ts +399 -0
  392. package/src/application/tools/idempotency.ts +137 -0
  393. package/src/application/tools/index.ts +61 -0
  394. package/src/application/tools/loaders/mcp-tools.ts +261 -0
  395. package/src/application/tools/mcp-client.ts +116 -0
  396. package/src/application/tools/namespace-map.ts +133 -0
  397. package/src/application/tools/resolver.ts +125 -0
  398. package/src/application/tools/tool-circuit-breaker.ts +84 -0
  399. package/src/application/tools/tool-definitions.ts +140 -0
  400. package/src/application/tools/tool-error-classifier.ts +115 -0
  401. package/src/application/tools/tool-permission.ts +103 -0
  402. package/src/application/tools/tool-policy-helpers.ts +107 -0
  403. package/src/application/tools/tool-policy-types.ts +98 -0
  404. package/src/application/tools/tool-policy.ts +579 -0
  405. package/src/dispatch.ts +183 -0
  406. package/src/index.ts +3 -0
  407. package/src/infra/db/client.ts +28 -0
  408. package/src/infra/db/index.ts +174 -0
  409. package/src/infra/db/schema-accounts.ts +198 -0
  410. package/src/infra/db/schema-agents.ts +305 -0
  411. package/src/infra/db/schema-auth.ts +58 -0
  412. package/src/infra/db/schema-billing.ts +120 -0
  413. package/src/infra/db/schema-oauth.ts +194 -0
  414. package/src/infra/db/schema-platform.ts +437 -0
  415. package/src/infra/db/schema-repos.ts +348 -0
  416. package/src/infra/db/schema-services.ts +74 -0
  417. package/src/infra/db/schema-workers.ts +359 -0
  418. package/src/infra/db/schema-workflows.ts +114 -0
  419. package/src/infra/db/schema.ts +172 -0
  420. package/src/local-platform/adapters/local.redis.test.ts +145 -0
  421. package/src/local-platform/bootstrap.test.ts +1374 -0
  422. package/src/local-platform/bootstrap.ts +1 -0
  423. package/src/local-platform/cloudflare-containers-shim.mjs +28 -0
  424. package/src/local-platform/cloudflare-workers-shim.mjs +8 -0
  425. package/src/local-platform/container-backend.ts +65 -0
  426. package/src/local-platform/d1-migrations.ts +338 -0
  427. package/src/local-platform/d1-prepared-statement.ts +104 -0
  428. package/src/local-platform/d1-shared.ts +131 -0
  429. package/src/local-platform/d1-sql-rewrite.ts +386 -0
  430. package/src/local-platform/docker-container-backend.ts +205 -0
  431. package/src/local-platform/execution-context.ts +24 -0
  432. package/src/local-platform/executor-control-rpc.ts +398 -0
  433. package/src/local-platform/fetch-server.ts +8 -0
  434. package/src/local-platform/in-memory-bindings.test.ts +49 -0
  435. package/src/local-platform/in-memory-bindings.ts +91 -0
  436. package/src/local-platform/in-memory-d1.ts +126 -0
  437. package/src/local-platform/in-memory-kv.ts +84 -0
  438. package/src/local-platform/in-memory-queue.ts +23 -0
  439. package/src/local-platform/in-memory-r2.ts +272 -0
  440. package/src/local-platform/k8s-container-backend.ts +364 -0
  441. package/src/local-platform/load-adapter.ts +42 -0
  442. package/src/local-platform/miniflare-bindings.ts +353 -0
  443. package/src/local-platform/miniflare-registry.ts +351 -0
  444. package/src/local-platform/node-fetch-server.ts +70 -0
  445. package/src/local-platform/node-resolve-loader.mjs +97 -0
  446. package/src/local-platform/oci-orchestrator-node.ts +23 -0
  447. package/src/local-platform/oci-orchestrator.test.ts +110 -0
  448. package/src/local-platform/oci-orchestrator.ts +529 -0
  449. package/src/local-platform/persistent-bindings.test.ts +173 -0
  450. package/src/local-platform/persistent-bindings.ts +6 -0
  451. package/src/local-platform/persistent-d1.ts +171 -0
  452. package/src/local-platform/persistent-durable-objects.ts +57 -0
  453. package/src/local-platform/persistent-kv.ts +121 -0
  454. package/src/local-platform/persistent-queue.ts +59 -0
  455. package/src/local-platform/persistent-r2.test.ts +72 -0
  456. package/src/local-platform/persistent-r2.ts +376 -0
  457. package/src/local-platform/persistent-shared.ts +27 -0
  458. package/src/local-platform/public-runtime-contract.test.ts +211 -0
  459. package/src/local-platform/queue-runtime.ts +85 -0
  460. package/src/local-platform/redis-bindings.ts +185 -0
  461. package/src/local-platform/routing-store.ts +118 -0
  462. package/src/local-platform/run-smoke-proxyless.ts +67 -0
  463. package/src/local-platform/run-smoke.ts +176 -0
  464. package/src/local-platform/runtime-env.ts +114 -0
  465. package/src/local-platform/runtime-gateway-stubs.ts +168 -0
  466. package/src/local-platform/runtime-host-fetch.ts +154 -0
  467. package/src/local-platform/runtime-http.ts +63 -0
  468. package/src/local-platform/runtime-types.ts +96 -0
  469. package/src/local-platform/runtime.ts +114 -0
  470. package/src/local-platform/tenant-binding-polyfills.ts +203 -0
  471. package/src/local-platform/tenant-binding-rpc.ts +216 -0
  472. package/src/local-platform/tenant-resource-limits.ts +32 -0
  473. package/src/local-platform/tenant-worker-runtime.ts +179 -0
  474. package/src/local-platform/url-registry.ts +75 -0
  475. package/src/local-platform/worker.test.ts +78 -0
  476. package/src/local-platform/worker.ts +186 -0
  477. package/src/node-platform/env-builder.ts +317 -0
  478. package/src/node-platform/index.ts +7 -0
  479. package/src/node-platform/resolvers/ai-resolver.ts +39 -0
  480. package/src/node-platform/resolvers/bucket-resolver.ts +89 -0
  481. package/src/node-platform/resolvers/db-resolver.ts +17 -0
  482. package/src/node-platform/resolvers/dispatch-resolver.ts +119 -0
  483. package/src/node-platform/resolvers/durable-object-resolver.ts +17 -0
  484. package/src/node-platform/resolvers/env-helpers.ts +47 -0
  485. package/src/node-platform/resolvers/kv-resolver.ts +39 -0
  486. package/src/node-platform/resolvers/queue-resolver.ts +99 -0
  487. package/src/node-platform/resolvers/routing-resolver.ts +103 -0
  488. package/src/platform/accessors.ts +100 -0
  489. package/src/platform/adapters/node.ts +236 -0
  490. package/src/platform/adapters/shared.ts +161 -0
  491. package/src/platform/adapters/workers.ts +133 -0
  492. package/src/platform/context.ts +26 -0
  493. package/src/platform/index.ts +43 -0
  494. package/src/platform/platform-config.ts +170 -0
  495. package/src/platform/providers/cloudflare/pdf-render.ts +30 -0
  496. package/src/platform/providers/cloudflare/resources.ts +19 -0
  497. package/src/platform/providers/cloudflare/wfp.ts +22 -0
  498. package/src/platform/providers/node/pdf-render.ts +123 -0
  499. package/src/runtime/container-hosts/browser-session-host.ts +359 -0
  500. package/src/runtime/container-hosts/browser-session-types.ts +33 -0
  501. package/src/runtime/container-hosts/container-runtime.ts +52 -0
  502. package/src/runtime/container-hosts/d1-raw.ts +22 -0
  503. package/src/runtime/container-hosts/executor-auth.ts +161 -0
  504. package/src/runtime/container-hosts/executor-control-rpc.ts +449 -0
  505. package/src/runtime/container-hosts/executor-dispatch.ts +84 -0
  506. package/src/runtime/container-hosts/executor-host.ts +447 -0
  507. package/src/runtime/container-hosts/executor-proxy-config.ts +38 -0
  508. package/src/runtime/container-hosts/executor-proxy-handlers.ts +427 -0
  509. package/src/runtime/container-hosts/executor-run-state.ts +389 -0
  510. package/src/runtime/container-hosts/executor-utils.ts +269 -0
  511. package/src/runtime/container-hosts/proxy-token-manager.ts +188 -0
  512. package/src/runtime/container-hosts/runtime-host.ts +241 -0
  513. package/src/runtime/durable-objects/do-header-utils.ts +160 -0
  514. package/src/runtime/durable-objects/git-push-lock.ts +94 -0
  515. package/src/runtime/durable-objects/notification-notifier.ts +257 -0
  516. package/src/runtime/durable-objects/rate-limiter.ts +268 -0
  517. package/src/runtime/durable-objects/routing.ts +339 -0
  518. package/src/runtime/durable-objects/run-notifier.ts +555 -0
  519. package/src/runtime/durable-objects/session.ts +167 -0
  520. package/src/runtime/executor-proxy-api.ts +211 -0
  521. package/src/runtime/indexer/handlers.ts +133 -0
  522. package/src/runtime/indexer/index.ts +103 -0
  523. package/src/runtime/queues/deploy-jobs.ts +89 -0
  524. package/src/runtime/queues/parallel-steps.ts +433 -0
  525. package/src/runtime/queues/workflow-dlq.ts +132 -0
  526. package/src/runtime/queues/workflow-events.ts +34 -0
  527. package/src/runtime/queues/workflow-expressions.ts +69 -0
  528. package/src/runtime/queues/workflow-job-handler.ts +193 -0
  529. package/src/runtime/queues/workflow-job-phases.ts +335 -0
  530. package/src/runtime/queues/workflow-jobs.ts +43 -0
  531. package/src/runtime/queues/workflow-runner.ts +87 -0
  532. package/src/runtime/queues/workflow-runtime-client.ts +180 -0
  533. package/src/runtime/queues/workflow-secrets.ts +78 -0
  534. package/src/runtime/queues/workflow-steps.ts +62 -0
  535. package/src/runtime/queues/workflow-types.ts +163 -0
  536. package/src/runtime/runner/cron-handler.ts +78 -0
  537. package/src/runtime/runner/index.ts +20 -0
  538. package/src/runtime/runner/queue-handler.ts +247 -0
  539. package/src/runtime/runner/runner-constants.ts +7 -0
  540. package/src/runtime/worker/egress.ts +375 -0
  541. package/src/runtime/worker/env.ts +63 -0
  542. package/src/runtime/worker/index.ts +11 -0
  543. package/src/runtime/worker/runtime-factory.ts +111 -0
  544. package/src/server/middleware/auth.ts +210 -0
  545. package/src/server/middleware/billing.ts +62 -0
  546. package/src/server/middleware/body-size.ts +59 -0
  547. package/src/server/middleware/cache.ts +192 -0
  548. package/src/server/middleware/content-type.ts +59 -0
  549. package/src/server/middleware/git-auth.ts +103 -0
  550. package/src/server/middleware/oauth-auth.ts +204 -0
  551. package/src/server/middleware/param-validation.ts +59 -0
  552. package/src/server/middleware/plan-gates.ts +71 -0
  553. package/src/server/middleware/space-access.ts +125 -0
  554. package/src/server/middleware/static-assets.ts +25 -0
  555. package/src/server/middleware/trust-tier.ts +42 -0
  556. package/src/server/middleware/turnstile.ts +50 -0
  557. package/src/server/routes/activitypub-store/activitypub-queries.ts +234 -0
  558. package/src/server/routes/activitypub-store/routes.ts +512 -0
  559. package/src/server/routes/agent-tasks-handlers.ts +211 -0
  560. package/src/server/routes/agent-tasks.ts +352 -0
  561. package/src/server/routes/api.ts +399 -0
  562. package/src/server/routes/app-deployments.ts +201 -0
  563. package/src/server/routes/apps.ts +393 -0
  564. package/src/server/routes/auth/cli.ts +226 -0
  565. package/src/server/routes/auth/external.ts +366 -0
  566. package/src/server/routes/auth/html.ts +398 -0
  567. package/src/server/routes/auth/link.ts +158 -0
  568. package/src/server/routes/auth/provisioning.ts +210 -0
  569. package/src/server/routes/auth/session.ts +277 -0
  570. package/src/server/routes/auth-api.ts +155 -0
  571. package/src/server/routes/billing/routes.ts +494 -0
  572. package/src/server/routes/billing/stripe.ts +128 -0
  573. package/src/server/routes/browser-sessions.ts +258 -0
  574. package/src/server/routes/common-env/handlers.ts +23 -0
  575. package/src/server/routes/custom-domains.ts +132 -0
  576. package/src/server/routes/explore/explore-filters.ts +262 -0
  577. package/src/server/routes/explore/index.ts +1 -0
  578. package/src/server/routes/explore/packages.ts +392 -0
  579. package/src/server/routes/explore/repos.ts +218 -0
  580. package/src/server/routes/explore/routes.ts +14 -0
  581. package/src/server/routes/explore/users.ts +139 -0
  582. package/src/server/routes/git.ts +218 -0
  583. package/src/server/routes/index/graph.ts +127 -0
  584. package/src/server/routes/index/handlers.ts +210 -0
  585. package/src/server/routes/index/index-context.ts +80 -0
  586. package/src/server/routes/index/index.ts +50 -0
  587. package/src/server/routes/index/jobs.ts +159 -0
  588. package/src/server/routes/mcp.ts +343 -0
  589. package/src/server/routes/me.ts +408 -0
  590. package/src/server/routes/memories.ts +366 -0
  591. package/src/server/routes/notifications-sse.ts +54 -0
  592. package/src/server/routes/notifications.ts +158 -0
  593. package/src/server/routes/oauth/authorize.ts +311 -0
  594. package/src/server/routes/oauth/device.ts +344 -0
  595. package/src/server/routes/oauth/introspect.ts +82 -0
  596. package/src/server/routes/oauth/register.ts +185 -0
  597. package/src/server/routes/oauth/request-utils.ts +94 -0
  598. package/src/server/routes/oauth/revoke.ts +69 -0
  599. package/src/server/routes/oauth/routes.ts +255 -0
  600. package/src/server/routes/oauth/token.ts +409 -0
  601. package/src/server/routes/oauth/userinfo.ts +101 -0
  602. package/src/server/routes/oauth-consent-api.ts +468 -0
  603. package/src/server/routes/profiles/api.ts +14 -0
  604. package/src/server/routes/profiles/block-follow-helpers.ts +166 -0
  605. package/src/server/routes/profiles/block-mute.ts +127 -0
  606. package/src/server/routes/profiles/dto.ts +42 -0
  607. package/src/server/routes/profiles/follow.ts +449 -0
  608. package/src/server/routes/profiles/index.ts +12 -0
  609. package/src/server/routes/profiles/profile-crud.ts +276 -0
  610. package/src/server/routes/profiles/profile-queries.ts +245 -0
  611. package/src/server/routes/profiles/register.ts +20 -0
  612. package/src/server/routes/profiles/repo.ts +382 -0
  613. package/src/server/routes/profiles/view.ts +213 -0
  614. package/src/server/routes/public-share.ts +143 -0
  615. package/src/server/routes/pull-requests/comments.ts +159 -0
  616. package/src/server/routes/pull-requests/diff.ts +309 -0
  617. package/src/server/routes/pull-requests/dto.ts +238 -0
  618. package/src/server/routes/pull-requests/git-store.ts +2 -0
  619. package/src/server/routes/pull-requests/index.ts +12 -0
  620. package/src/server/routes/pull-requests/merge-handlers.ts +266 -0
  621. package/src/server/routes/pull-requests/merge.ts +423 -0
  622. package/src/server/routes/pull-requests/read-model.ts +201 -0
  623. package/src/server/routes/pull-requests/reviews.ts +259 -0
  624. package/src/server/routes/pull-requests/routes.ts +305 -0
  625. package/src/server/routes/pull-requests/workflow-trigger.ts +61 -0
  626. package/src/server/routes/reminders.ts +173 -0
  627. package/src/server/routes/repos/actions/artifacts.ts +90 -0
  628. package/src/server/routes/repos/actions/jobs.ts +137 -0
  629. package/src/server/routes/repos/actions/logs.ts +74 -0
  630. package/src/server/routes/repos/actions/runs.ts +174 -0
  631. package/src/server/routes/repos/actions/secrets.ts +145 -0
  632. package/src/server/routes/repos/external-import.ts +158 -0
  633. package/src/server/routes/repos/forks.ts +196 -0
  634. package/src/server/routes/repos/git-advanced.ts +509 -0
  635. package/src/server/routes/repos/git-commits.ts +344 -0
  636. package/src/server/routes/repos/git-files.ts +218 -0
  637. package/src/server/routes/repos/git-refs.ts +203 -0
  638. package/src/server/routes/repos/git-shared.ts +57 -0
  639. package/src/server/routes/repos/git-write-operations.ts +217 -0
  640. package/src/server/routes/repos/git.ts +12 -0
  641. package/src/server/routes/repos/index.ts +30 -0
  642. package/src/server/routes/repos/release-assets.ts +299 -0
  643. package/src/server/routes/repos/release-crud.ts +419 -0
  644. package/src/server/routes/repos/release-shared.ts +59 -0
  645. package/src/server/routes/repos/releases.ts +8 -0
  646. package/src/server/routes/repos/repo-helpers.ts +168 -0
  647. package/src/server/routes/repos/routes.ts +338 -0
  648. package/src/server/routes/repos/shared.ts +110 -0
  649. package/src/server/routes/repos/stars.ts +200 -0
  650. package/src/server/routes/repos/sync.ts +500 -0
  651. package/src/server/routes/repos/workflows.ts +388 -0
  652. package/src/server/routes/resources/access.ts +109 -0
  653. package/src/server/routes/resources/bindings.ts +157 -0
  654. package/src/server/routes/resources/d1.ts +294 -0
  655. package/src/server/routes/resources/index.ts +16 -0
  656. package/src/server/routes/resources/r2.ts +181 -0
  657. package/src/server/routes/resources/routes.ts +407 -0
  658. package/src/server/routes/resources/tokens.ts +365 -0
  659. package/src/server/routes/rpc-types.ts +87 -0
  660. package/src/server/routes/runs/access.ts +34 -0
  661. package/src/server/routes/runs/create.ts +42 -0
  662. package/src/server/routes/runs/list.ts +120 -0
  663. package/src/server/routes/runs/observation.ts +161 -0
  664. package/src/server/routes/runs/routes.ts +274 -0
  665. package/src/server/routes/runs/sse.ts +62 -0
  666. package/src/server/routes/search.ts +220 -0
  667. package/src/server/routes/seed-repositories.ts +17 -0
  668. package/src/server/routes/sessions/auth.ts +33 -0
  669. package/src/server/routes/sessions/heartbeat.ts +120 -0
  670. package/src/server/routes/sessions/index.ts +57 -0
  671. package/src/server/routes/sessions/lifecycle.ts +337 -0
  672. package/src/server/routes/sessions/session-mappers.ts +49 -0
  673. package/src/server/routes/setup.ts +111 -0
  674. package/src/server/routes/shared/route-auth.ts +245 -0
  675. package/src/server/routes/shortcuts.ts +335 -0
  676. package/src/server/routes/skills.ts +443 -0
  677. package/src/server/routes/smart-http.ts +380 -0
  678. package/src/server/routes/spaces/common-env.ts +92 -0
  679. package/src/server/routes/spaces/members.ts +326 -0
  680. package/src/server/routes/spaces/repositories.ts +69 -0
  681. package/src/server/routes/spaces/routes.ts +386 -0
  682. package/src/server/routes/spaces/storage-downloads.ts +257 -0
  683. package/src/server/routes/spaces/storage-management.ts +354 -0
  684. package/src/server/routes/spaces/storage-operations.ts +46 -0
  685. package/src/server/routes/spaces/storage-uploads.ts +195 -0
  686. package/src/server/routes/spaces/storage.ts +10 -0
  687. package/src/server/routes/spaces/store-registry.ts +413 -0
  688. package/src/server/routes/spaces/stores.ts +139 -0
  689. package/src/server/routes/thread-messages.ts +141 -0
  690. package/src/server/routes/thread-shares.ts +113 -0
  691. package/src/server/routes/threads.ts +450 -0
  692. package/src/server/routes/well-known.ts +120 -0
  693. package/src/server/routes/workers/deployments.ts +339 -0
  694. package/src/server/routes/workers/index.ts +12 -0
  695. package/src/server/routes/workers/routes.ts +305 -0
  696. package/src/server/routes/workers/settings-bindings.ts +184 -0
  697. package/src/server/routes/workers/settings-common-env.ts +272 -0
  698. package/src/server/routes/workers/settings-config.ts +95 -0
  699. package/src/server/routes/workers/settings-env-vars.ts +107 -0
  700. package/src/server/routes/workers/settings.ts +14 -0
  701. package/src/server/routes/workers/slug.ts +149 -0
  702. package/src/server/routes/zod-validator.ts +24 -0
  703. package/src/shared/config/index.ts +38 -0
  704. package/src/shared/config/limits.ts +104 -0
  705. package/src/shared/config/timeouts.ts +71 -0
  706. package/src/shared/constants/app.ts +62 -0
  707. package/src/shared/constants/dns.ts +12 -0
  708. package/src/shared/constants/index.ts +11 -0
  709. package/src/shared/constants/roles.ts +45 -0
  710. package/src/shared/types/bindings.ts +71 -0
  711. package/src/shared/types/drizzle-helpers.ts +5 -0
  712. package/src/shared/types/env.ts +151 -0
  713. package/src/shared/types/index.ts +172 -0
  714. package/src/shared/types/models.ts +506 -0
  715. package/src/shared/types/oauth.ts +216 -0
  716. package/src/shared/types/queue-messages.ts +140 -0
  717. package/src/shared/types/routing.ts +54 -0
  718. package/src/shared/utils/content-type.ts +39 -0
  719. package/src/shared/utils/crypto.ts +181 -0
  720. package/src/shared/utils/date-utils.ts +16 -0
  721. package/src/shared/utils/db-guards.ts +39 -0
  722. package/src/shared/utils/db-transaction.ts +157 -0
  723. package/src/shared/utils/device-auth-rate-limit.ts +40 -0
  724. package/src/shared/utils/domain-validation.ts +428 -0
  725. package/src/shared/utils/encoding-utils.ts +77 -0
  726. package/src/shared/utils/error-response.ts +51 -0
  727. package/src/shared/utils/gzip.ts +67 -0
  728. package/src/shared/utils/hash.ts +36 -0
  729. package/src/shared/utils/http-response.ts +37 -0
  730. package/src/shared/utils/index.ts +65 -0
  731. package/src/shared/utils/lcs-diff.ts +65 -0
  732. package/src/shared/utils/logger.ts +220 -0
  733. package/src/shared/utils/naming-utils.ts +16 -0
  734. package/src/shared/utils/path-validation.ts +124 -0
  735. package/src/shared/utils/rate-limiter.ts +149 -0
  736. package/src/shared/utils/service-client.ts +109 -0
  737. package/src/shared/utils/sliding-window.ts +103 -0
  738. package/src/shared/utils/spa-fallback.ts +26 -0
  739. package/src/shared/utils/token-bucket.ts +106 -0
  740. package/src/shared/utils/unified-diff.ts +109 -0
  741. package/src/shared/utils/url-utils.ts +18 -0
  742. package/src/shared/utils/validate-env.ts +126 -0
  743. package/src/shared/utils/with-timeout.ts +32 -0
  744. package/src/shared/utils/zip-stream.ts +226 -0
  745. package/src/web.ts +505 -0
  746. package/src/worker-emulation/redis-durable-object.ts +246 -0
  747. package/src/worker-emulation/sse-notifier.ts +316 -0
@@ -0,0 +1,426 @@
1
+ import type { D1Database } from '../../../shared/types/bindings.ts';
2
+ import type { SpaceRole } from '../../../shared/types';
3
+ import { generateId, now, toIsoString } from '../../../shared/utils';
4
+ import { accountMemberships, accounts, getDb, services } from '../../../infra/db';
5
+ import { eq, and, desc, sql, or, inArray } from 'drizzle-orm';
6
+ import { resolveActorPrincipalId } from '../identity/principals';
7
+ import { resolveAccessibleAccountIds } from '../identity/membership-resolver';
8
+
9
+ const MAX_SERVICES = 100;
10
+
11
+ export const WORKSPACE_SERVICE_LIMITS = {
12
+ maxServices: MAX_SERVICES,
13
+ };
14
+
15
+ export const WORKSPACE_WORKER_LIMITS = {
16
+ maxWorkers: MAX_SERVICES,
17
+ };
18
+
19
+ export interface ServiceRow {
20
+ id: string;
21
+ space_id: string;
22
+ service_type: 'app' | 'service';
23
+ status: 'pending' | 'building' | 'deployed' | 'failed' | 'stopped';
24
+ config: string | null;
25
+ hostname: string | null;
26
+ service_name: string | null;
27
+ slug: string | null;
28
+ created_at: string;
29
+ updated_at: string;
30
+ }
31
+
32
+ export interface ServiceWithSpaceName extends ServiceRow {
33
+ workspace_name: string;
34
+ }
35
+
36
+ export type ServiceRouteRecord = {
37
+ id: string;
38
+ accountId: string;
39
+ workerType: string;
40
+ status: string;
41
+ hostname: string | null;
42
+ routeRef: string | null;
43
+ slug: string | null;
44
+ };
45
+
46
+ export type ServiceRouteSummary = Pick<ServiceRouteRecord, 'id' | 'accountId' | 'hostname' | 'routeRef' | 'slug'>;
47
+
48
+ export type ServiceRouteCleanupRecord = ServiceRouteSummary & {
49
+ config: string | null;
50
+ };
51
+
52
+ export function slugifyServiceName(name: string): string {
53
+ return name
54
+ .toLowerCase()
55
+ .replace(/[^a-z0-9]+/g, '-')
56
+ .replace(/^-|-$/g, '')
57
+ .slice(0, 32);
58
+ }
59
+
60
+ export const slugifyWorkerName = slugifyServiceName;
61
+
62
+ function toApiService(row: {
63
+ id: string;
64
+ accountId: string;
65
+ workerType: string;
66
+ status: string;
67
+ config: string | null;
68
+ hostname: string | null;
69
+ routeRef: string | null;
70
+ slug: string | null;
71
+ createdAt: string | Date;
72
+ updatedAt: string | Date;
73
+ }): ServiceRow {
74
+ return {
75
+ id: row.id,
76
+ space_id: row.accountId,
77
+ service_type: row.workerType as 'app' | 'service',
78
+ status: row.status as ServiceRow['status'],
79
+ config: row.config,
80
+ hostname: row.hostname,
81
+ service_name: row.routeRef,
82
+ slug: row.slug,
83
+ created_at: toIsoString(row.createdAt),
84
+ updated_at: toIsoString(row.updatedAt),
85
+ };
86
+ }
87
+
88
+ function normalizeServiceRouteRecord(row: ServiceRouteRecord): ServiceRouteRecord {
89
+ return {
90
+ id: row.id,
91
+ accountId: row.accountId,
92
+ workerType: row.workerType,
93
+ status: row.status,
94
+ hostname: row.hostname,
95
+ routeRef: row.routeRef,
96
+ slug: row.slug,
97
+ };
98
+ }
99
+
100
+ export async function countServicesInSpace(d1: D1Database, spaceId: string): Promise<number> {
101
+ const db = getDb(d1);
102
+ const result = await db.select({ count: sql<number>`count(*)` }).from(services).where(eq(services.accountId, spaceId)).get();
103
+ return result?.count ?? 0;
104
+ }
105
+
106
+ export async function listServicesForUser(d1: D1Database, userId: string) {
107
+ const principalId = await resolveActorPrincipalId(d1, userId);
108
+ if (!principalId) return [];
109
+
110
+ const db = getDb(d1);
111
+ const allAccountIds = await resolveAccessibleAccountIds(d1, principalId);
112
+ // Exclude the user's own account — only workspace memberships matter here
113
+ const accountIds = allAccountIds.filter((id) => id !== principalId);
114
+ if (accountIds.length === 0) return [];
115
+ const serviceRows = await db.select({
116
+ id: services.id,
117
+ accountId: services.accountId,
118
+ workerType: services.workerType,
119
+ status: services.status,
120
+ config: services.config,
121
+ hostname: services.hostname,
122
+ routeRef: services.routeRef,
123
+ slug: services.slug,
124
+ createdAt: services.createdAt,
125
+ updatedAt: services.updatedAt,
126
+ }).from(services).where(sql`${services.accountId} IN (${sql.join(accountIds.map((id) => sql`${id}`), sql`, `)})`).orderBy(desc(services.updatedAt)).all();
127
+ const accountRows = await db.select({ id: accounts.id, name: accounts.name }).from(accounts).where(sql`${accounts.id} IN (${sql.join(accountIds.map((id) => sql`${id}`), sql`, `)})`).all();
128
+ const accountNameMap = new Map(accountRows.map((account) => [account.id, account.name]));
129
+ return serviceRows.map((service) => ({ ...toApiService(service), workspace_name: accountNameMap.get(service.accountId) ?? '' }));
130
+ }
131
+
132
+ export async function listServicesForSpace(d1: D1Database, spaceId: string) {
133
+ const db = getDb(d1);
134
+ const serviceRows = await db.select({
135
+ id: services.id,
136
+ accountId: services.accountId,
137
+ workerType: services.workerType,
138
+ status: services.status,
139
+ config: services.config,
140
+ hostname: services.hostname,
141
+ routeRef: services.routeRef,
142
+ slug: services.slug,
143
+ createdAt: services.createdAt,
144
+ updatedAt: services.updatedAt,
145
+ }).from(services).where(eq(services.accountId, spaceId)).orderBy(desc(services.updatedAt)).all();
146
+ return serviceRows.map((service) => toApiService(service));
147
+ }
148
+
149
+ export async function getServiceById(d1: D1Database, serviceId: string) {
150
+ const db = getDb(d1);
151
+ const service = await db.select({
152
+ id: services.id,
153
+ accountId: services.accountId,
154
+ workerType: services.workerType,
155
+ status: services.status,
156
+ config: services.config,
157
+ hostname: services.hostname,
158
+ routeRef: services.routeRef,
159
+ slug: services.slug,
160
+ createdAt: services.createdAt,
161
+ updatedAt: services.updatedAt,
162
+ }).from(services).where(eq(services.id, serviceId)).get();
163
+ if (!service) return null;
164
+ return toApiService(service);
165
+ }
166
+
167
+ export async function getServiceRouteRecord(d1: D1Database, serviceId: string): Promise<ServiceRouteRecord | null> {
168
+ const db = getDb(d1);
169
+ const service = await db.select({
170
+ id: services.id,
171
+ accountId: services.accountId,
172
+ workerType: services.workerType,
173
+ status: services.status,
174
+ hostname: services.hostname,
175
+ routeRef: services.routeRef,
176
+ slug: services.slug,
177
+ }).from(services)
178
+ .where(eq(services.id, serviceId))
179
+ .get();
180
+ return service ? normalizeServiceRouteRecord(service) : null;
181
+ }
182
+
183
+ export async function getServiceRouteRecordForSpace(
184
+ d1: D1Database,
185
+ spaceId: string,
186
+ serviceId: string,
187
+ ): Promise<ServiceRouteRecord | null> {
188
+ const service = await getServiceRouteRecord(d1, serviceId);
189
+ if (!service || service.accountId !== spaceId) return null;
190
+ return service;
191
+ }
192
+
193
+ export async function resolveServiceReferenceRecord(
194
+ d1: D1Database,
195
+ spaceId: string,
196
+ reference: string,
197
+ ): Promise<ServiceRouteRecord | null> {
198
+ const ref = reference.trim();
199
+ if (!ref) return null;
200
+
201
+ const db = getDb(d1);
202
+ const service = await db.select({
203
+ id: services.id,
204
+ accountId: services.accountId,
205
+ workerType: services.workerType,
206
+ status: services.status,
207
+ hostname: services.hostname,
208
+ routeRef: services.routeRef,
209
+ slug: services.slug,
210
+ }).from(services)
211
+ .where(and(
212
+ eq(services.accountId, spaceId),
213
+ or(
214
+ eq(services.id, ref),
215
+ eq(services.routeRef, ref),
216
+ eq(services.slug, ref),
217
+ ),
218
+ ))
219
+ .get();
220
+
221
+ return service ? normalizeServiceRouteRecord(service) : null;
222
+ }
223
+
224
+ export async function resolveServiceRouteReference(
225
+ d1: D1Database,
226
+ spaceId: string,
227
+ reference: string,
228
+ ): Promise<ServiceRouteRecord | null> {
229
+ return resolveServiceReferenceRecord(d1, spaceId, reference);
230
+ }
231
+
232
+ export async function listServiceRouteRecordsByIds(
233
+ d1: D1Database,
234
+ serviceIds: string[],
235
+ ): Promise<ServiceRouteRecord[]> {
236
+ if (serviceIds.length === 0) return [];
237
+ const db = getDb(d1);
238
+ const rows = await db.select({
239
+ id: services.id,
240
+ accountId: services.accountId,
241
+ workerType: services.workerType,
242
+ status: services.status,
243
+ hostname: services.hostname,
244
+ routeRef: services.routeRef,
245
+ slug: services.slug,
246
+ }).from(services)
247
+ .where(inArray(services.id, serviceIds))
248
+ .all();
249
+ return rows.map(normalizeServiceRouteRecord);
250
+ }
251
+
252
+ export async function getServiceRouteSummary(
253
+ d1: D1Database,
254
+ serviceId: string,
255
+ spaceId?: string,
256
+ ): Promise<ServiceRouteSummary | null> {
257
+ const db = getDb(d1);
258
+ const conditions = [eq(services.id, serviceId)];
259
+ if (spaceId) {
260
+ conditions.push(eq(services.accountId, spaceId));
261
+ }
262
+
263
+ const service = await db.select({
264
+ id: services.id,
265
+ accountId: services.accountId,
266
+ hostname: services.hostname,
267
+ routeRef: services.routeRef,
268
+ slug: services.slug,
269
+ }).from(services)
270
+ .where(and(...conditions))
271
+ .get();
272
+
273
+ return service ?? null;
274
+ }
275
+
276
+ export async function resolveServiceRouteSummaryForSpace(
277
+ d1: D1Database,
278
+ spaceId: string,
279
+ reference: string,
280
+ ): Promise<ServiceRouteSummary | null> {
281
+ const service = await resolveServiceReferenceRecord(d1, spaceId, reference);
282
+ if (!service) return null;
283
+ return {
284
+ id: service.id,
285
+ accountId: service.accountId,
286
+ hostname: service.hostname,
287
+ routeRef: service.routeRef,
288
+ slug: service.slug,
289
+ };
290
+ }
291
+
292
+ export async function findServiceRouteSummaryInSpace(
293
+ d1: D1Database,
294
+ spaceId: string,
295
+ reference: string,
296
+ ): Promise<ServiceRouteSummary | null> {
297
+ return resolveServiceRouteSummaryForSpace(d1, spaceId, reference);
298
+ }
299
+
300
+ export async function listSpaceServiceRouteCleanupRecords(
301
+ d1: D1Database,
302
+ spaceId: string,
303
+ ): Promise<ServiceRouteCleanupRecord[]> {
304
+ const db = getDb(d1);
305
+ return db.select({
306
+ id: services.id,
307
+ accountId: services.accountId,
308
+ hostname: services.hostname,
309
+ routeRef: services.routeRef,
310
+ slug: services.slug,
311
+ config: services.config,
312
+ }).from(services)
313
+ .where(eq(services.accountId, spaceId))
314
+ .all();
315
+ }
316
+
317
+ export async function listServiceRouteCleanupRecordsForSpace(
318
+ d1: D1Database,
319
+ spaceId: string,
320
+ ): Promise<ServiceRouteCleanupRecord[]> {
321
+ return listSpaceServiceRouteCleanupRecords(d1, spaceId);
322
+ }
323
+
324
+ export async function getServiceForUser(d1: D1Database, serviceId: string, userId: string) {
325
+ const principalId = await resolveActorPrincipalId(d1, userId);
326
+ if (!principalId) return null;
327
+
328
+ const db = getDb(d1);
329
+ const service = await db.select({
330
+ id: services.id,
331
+ accountId: services.accountId,
332
+ workerType: services.workerType,
333
+ status: services.status,
334
+ config: services.config,
335
+ hostname: services.hostname,
336
+ routeRef: services.routeRef,
337
+ slug: services.slug,
338
+ createdAt: services.createdAt,
339
+ updatedAt: services.updatedAt,
340
+ }).from(services).where(eq(services.id, serviceId)).get();
341
+ if (!service) return null;
342
+
343
+ const membership = await db.select({ accountId: accountMemberships.accountId }).from(accountMemberships).where(and(eq(accountMemberships.accountId, service.accountId), eq(accountMemberships.memberId, principalId))).get();
344
+ if (!membership) return null;
345
+
346
+ const account = await db.select({ name: accounts.name }).from(accounts).where(eq(accounts.id, service.accountId)).get();
347
+ return { ...toApiService(service), workspace_name: account?.name ?? '' };
348
+ }
349
+
350
+ export async function getServiceForUserWithRole(d1: D1Database, serviceId: string, userId: string, roles?: SpaceRole[]) {
351
+ const principalId = await resolveActorPrincipalId(d1, userId);
352
+ if (!principalId) return null;
353
+
354
+ const db = getDb(d1);
355
+ const service = await db.select({
356
+ id: services.id,
357
+ accountId: services.accountId,
358
+ workerType: services.workerType,
359
+ status: services.status,
360
+ config: services.config,
361
+ hostname: services.hostname,
362
+ routeRef: services.routeRef,
363
+ slug: services.slug,
364
+ createdAt: services.createdAt,
365
+ updatedAt: services.updatedAt,
366
+ }).from(services).where(eq(services.id, serviceId)).get();
367
+ if (!service) return null;
368
+
369
+ const membership = await db.select({ role: accountMemberships.role }).from(accountMemberships).where(and(eq(accountMemberships.accountId, service.accountId), eq(accountMemberships.memberId, principalId))).get();
370
+ if (!membership) return null;
371
+ if (roles && roles.length > 0 && !roles.includes(membership.role as SpaceRole)) return null;
372
+
373
+ return { ...toApiService(service), member_role: membership.role as SpaceRole };
374
+ }
375
+
376
+ export async function createService(d1: D1Database, input: { spaceId: string; workerType: 'app' | 'service'; slug?: string; config?: string | null; platformDomain: string; }) {
377
+ const db = getDb(d1);
378
+ const id = generateId();
379
+ const timestamp = now();
380
+ const slug = slugifyServiceName(input.slug ?? id);
381
+ const hostname = `${slug}.${input.platformDomain}`;
382
+ const serviceSlotName = `worker-${id}`;
383
+
384
+ await db.insert(services).values({
385
+ id,
386
+ accountId: input.spaceId,
387
+ serviceType: input.workerType,
388
+ status: 'pending',
389
+ config: input.config || null,
390
+ hostname,
391
+ routeRef: serviceSlotName,
392
+ slug,
393
+ createdAt: timestamp,
394
+ updatedAt: timestamp,
395
+ });
396
+
397
+ const service = await db.select({
398
+ id: services.id,
399
+ accountId: services.accountId,
400
+ workerType: services.workerType,
401
+ status: services.status,
402
+ config: services.config,
403
+ hostname: services.hostname,
404
+ routeRef: services.routeRef,
405
+ slug: services.slug,
406
+ createdAt: services.createdAt,
407
+ updatedAt: services.updatedAt,
408
+ }).from(services).where(eq(services.id, id)).get();
409
+
410
+ const apiService = service ? toApiService(service) : null;
411
+ return {
412
+ service: apiService,
413
+ worker: apiService,
414
+ id,
415
+ slug,
416
+ hostname,
417
+ serviceSlotName,
418
+ workerSlotName: serviceSlotName,
419
+ };
420
+ }
421
+
422
+ export async function deleteService(d1: D1Database, serviceId: string) {
423
+ const db = getDb(d1);
424
+ await db.delete(services).where(eq(services.id, serviceId));
425
+ }
426
+
@@ -0,0 +1,204 @@
1
+ import type { R2Bucket } from '../../../shared/types/bindings.ts';
2
+ import { getDb, workflowRuns, workflowArtifacts } from '../../../infra/db';
3
+ import { eq, and, desc, asc } from 'drizzle-orm';
4
+ import type { Env } from '../../../shared/types';
5
+ import { toIsoString } from '../../../shared/utils';
6
+ import { logError } from '../../../shared/utils/logger';
7
+
8
+ type ArtifactBucket = Pick<R2Bucket, 'get' | 'delete' | 'list'>;
9
+
10
+ export type WorkflowArtifactRecord = {
11
+ id: string;
12
+ runId: string;
13
+ name: string;
14
+ r2Key: string;
15
+ sizeBytes: number | null;
16
+ mimeType: string | null;
17
+ expiresAt: string | null;
18
+ createdAt: string;
19
+ };
20
+
21
+ export type ResolvedWorkflowArtifactFile = {
22
+ runId: string;
23
+ jobId: string;
24
+ artifactName: string;
25
+ artifactPath: string;
26
+ r2Key: string;
27
+ source: 'inventory' | 'prefix-fallback';
28
+ };
29
+
30
+ function normalizePath(value: string): string {
31
+ return String(value || '')
32
+ .replace(/\\/g, '/')
33
+ .replace(/^\.\/+/, '')
34
+ .replace(/^\/+/, '')
35
+ .replace(/\/{2,}/g, '/')
36
+ .trim();
37
+ }
38
+
39
+ function isExpired(expiresAt: string | null): boolean {
40
+ return !!expiresAt && new Date(expiresAt) < new Date();
41
+ }
42
+
43
+ export function buildWorkflowArtifactPrefix(jobId: string, artifactName: string): string {
44
+ return `actions/artifacts/${jobId}/${artifactName}/`;
45
+ }
46
+
47
+ async function getObjectFromSources(
48
+ primary: ArtifactBucket | null | undefined,
49
+ secondary: ArtifactBucket | null | undefined,
50
+ key: string,
51
+ ) {
52
+ const primaryObject = primary ? await primary.get(key) : null;
53
+ if (primaryObject) return primaryObject;
54
+ return secondary ? await secondary.get(key) : null;
55
+ }
56
+
57
+ export async function listWorkflowArtifactsForRun(
58
+ env: Pick<Env, 'DB'>,
59
+ repoId: string,
60
+ runId: string,
61
+ ) {
62
+ const db = getDb(env.DB);
63
+ const run = await db.select({ id: workflowRuns.id })
64
+ .from(workflowRuns)
65
+ .where(and(eq(workflowRuns.id, runId), eq(workflowRuns.repoId, repoId)))
66
+ .get();
67
+ if (!run) return null;
68
+
69
+ return await db.select()
70
+ .from(workflowArtifacts)
71
+ .where(eq(workflowArtifacts.runId, runId))
72
+ .orderBy(asc(workflowArtifacts.createdAt))
73
+ .all();
74
+ }
75
+
76
+ export async function getWorkflowArtifactById(
77
+ env: Pick<Env, 'DB'>,
78
+ repoId: string,
79
+ artifactId: string,
80
+ ) {
81
+ const db = getDb(env.DB);
82
+ // Join workflowArtifacts with workflowRuns to verify repoId
83
+ const result = await db.select({
84
+ id: workflowArtifacts.id,
85
+ runId: workflowArtifacts.runId,
86
+ name: workflowArtifacts.name,
87
+ r2Key: workflowArtifacts.r2Key,
88
+ sizeBytes: workflowArtifacts.sizeBytes,
89
+ mimeType: workflowArtifacts.mimeType,
90
+ expiresAt: workflowArtifacts.expiresAt,
91
+ createdAt: workflowArtifacts.createdAt,
92
+ repoId: workflowRuns.repoId,
93
+ })
94
+ .from(workflowArtifacts)
95
+ .innerJoin(workflowRuns, eq(workflowArtifacts.runId, workflowRuns.id))
96
+ .where(and(eq(workflowArtifacts.id, artifactId), eq(workflowRuns.repoId, repoId)))
97
+ .get();
98
+ if (!result) return null;
99
+
100
+ return {
101
+ id: result.id,
102
+ runId: result.runId,
103
+ name: result.name,
104
+ r2Key: result.r2Key,
105
+ sizeBytes: result.sizeBytes,
106
+ mimeType: result.mimeType,
107
+ expiresAt: result.expiresAt,
108
+ createdAt: result.createdAt,
109
+ workflowRun: { repoId: result.repoId },
110
+ };
111
+ }
112
+
113
+ export async function deleteWorkflowArtifactById(
114
+ env: Pick<Env, 'DB'>,
115
+ bucket: ArtifactBucket | null | undefined,
116
+ repoId: string,
117
+ artifactId: string,
118
+ ) {
119
+ const db = getDb(env.DB);
120
+ const artifact = await getWorkflowArtifactById(env, repoId, artifactId);
121
+ if (!artifact) return null;
122
+
123
+ if (bucket && artifact.r2Key) {
124
+ try {
125
+ await bucket.delete(artifact.r2Key);
126
+ } catch (err) {
127
+ logError('Failed to delete artifact from object storage', err, { module: 'services/platform/workflow-artifacts' });
128
+ }
129
+ }
130
+
131
+ await db.delete(workflowArtifacts)
132
+ .where(eq(workflowArtifacts.id, artifactId))
133
+ .run();
134
+
135
+ return artifact;
136
+ }
137
+
138
+ export async function resolveWorkflowArtifactFileForJob(
139
+ env: Pick<Env, 'DB' | 'GIT_OBJECTS' | 'TENANT_SOURCE'>,
140
+ params: {
141
+ repoId: string;
142
+ runId: string;
143
+ jobId: string;
144
+ artifactName: string;
145
+ artifactPath: string;
146
+ },
147
+ ): Promise<ResolvedWorkflowArtifactFile> {
148
+ const db = getDb(env.DB);
149
+ const artifactPath = normalizePath(params.artifactPath);
150
+ if (!artifactPath) {
151
+ throw new Error('artifact path is required');
152
+ }
153
+
154
+ // Find inventory artifact by name + runId, verifying repoId via join
155
+ const inventoryArtifact = await db.select({
156
+ runId: workflowArtifacts.runId,
157
+ name: workflowArtifacts.name,
158
+ r2Key: workflowArtifacts.r2Key,
159
+ expiresAt: workflowArtifacts.expiresAt,
160
+ })
161
+ .from(workflowArtifacts)
162
+ .innerJoin(workflowRuns, eq(workflowArtifacts.runId, workflowRuns.id))
163
+ .where(
164
+ and(
165
+ eq(workflowArtifacts.runId, params.runId),
166
+ eq(workflowArtifacts.name, params.artifactName),
167
+ eq(workflowRuns.repoId, params.repoId),
168
+ )
169
+ )
170
+ .orderBy(desc(workflowArtifacts.createdAt))
171
+ .get();
172
+
173
+ if (inventoryArtifact && !isExpired(inventoryArtifact.expiresAt)) {
174
+ const candidateKey = inventoryArtifact.r2Key.endsWith(`/${artifactPath}`)
175
+ ? inventoryArtifact.r2Key
176
+ : `${inventoryArtifact.r2Key.replace(/\/+$/, '')}/${artifactPath}`;
177
+ const artifactObject = await getObjectFromSources(env.GIT_OBJECTS, env.TENANT_SOURCE, candidateKey);
178
+ if (artifactObject) {
179
+ return {
180
+ runId: params.runId,
181
+ jobId: params.jobId,
182
+ artifactName: params.artifactName,
183
+ artifactPath,
184
+ r2Key: candidateKey,
185
+ source: 'inventory',
186
+ };
187
+ }
188
+ }
189
+
190
+ const prefixKey = `${buildWorkflowArtifactPrefix(params.jobId, params.artifactName)}${artifactPath}`;
191
+ const prefixedObject = await getObjectFromSources(env.GIT_OBJECTS, env.TENANT_SOURCE, prefixKey);
192
+ if (!prefixedObject) {
193
+ throw new Error(`Workflow artifact file not found: ${params.artifactName}@${artifactPath} (job ${params.jobId})`);
194
+ }
195
+
196
+ return {
197
+ runId: params.runId,
198
+ jobId: params.jobId,
199
+ artifactName: params.artifactName,
200
+ artifactPath,
201
+ r2Key: prefixKey,
202
+ source: 'prefix-fallback',
203
+ };
204
+ }