@tangle-network/agent-app 0.63.19 → 0.63.21

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 (62) hide show
  1. package/README.md +3 -3
  2. package/dist/{DesignCanvas-IQKYAEC4.js → DesignCanvas-CFNV5JGQ.js} +6 -6
  3. package/dist/DesignCanvasEditor-KH4BDUE3.js +19 -0
  4. package/dist/agent-enrollment/drizzle.js +3 -3
  5. package/dist/agent-enrollment/index.js +3 -3
  6. package/dist/app-auth/index.js +3 -3
  7. package/dist/chat-routes/index.js +6 -6
  8. package/dist/{chunk-WP2GYFZ4.js → chunk-ALIWB2P3.js} +1 -1
  9. package/dist/{chunk-WP2GYFZ4.js.map → chunk-ALIWB2P3.js.map} +1 -1
  10. package/dist/{chunk-K3A2YAIX.js → chunk-B5YYKYMM.js} +6 -6
  11. package/dist/{chunk-BTKI4XMM.js → chunk-CPWMBYLQ.js} +2 -2
  12. package/dist/{chunk-UJYEBQMS.js → chunk-H4JL74GP.js} +165 -7
  13. package/dist/chunk-H4JL74GP.js.map +1 -0
  14. package/dist/{chunk-PIPNDZ6H.js → chunk-I4CFBLSJ.js} +3 -3
  15. package/dist/{chunk-BI5AZAOO.js → chunk-JUQMVD4U.js} +2 -2
  16. package/dist/{chunk-KH4QSBNI.js → chunk-KADVQCAS.js} +4 -4
  17. package/dist/{chunk-CPVGRQ43.js → chunk-QFIVY6WA.js} +5 -5
  18. package/dist/{chunk-UGFCLD32.js → chunk-SFR7FPWL.js} +2 -2
  19. package/dist/{chunk-OODZCBSM.js → chunk-SJ73F7HD.js} +2 -2
  20. package/dist/{chunk-ZWJ3SZ2G.js → chunk-VCG4DQC4.js} +2 -2
  21. package/dist/{chunk-LMIP4OVR.js → chunk-VOXKDO4T.js} +10 -4
  22. package/dist/chunk-VOXKDO4T.js.map +1 -0
  23. package/dist/{chunk-4FEH6266.js → chunk-W3KXRU5N.js} +2 -2
  24. package/dist/{chunk-UTL6TEN6.js → chunk-WTNW4NFS.js} +3 -3
  25. package/dist/{chunk-CQGEGPY7.js → chunk-ZNE4NYU7.js} +2 -2
  26. package/dist/design-canvas/index.js +3 -3
  27. package/dist/design-canvas-react/engine.js +5 -5
  28. package/dist/design-canvas-react/index.js +8 -8
  29. package/dist/design-canvas-react/lazy.js +1 -1
  30. package/dist/hosted-agent/application.js +2 -2
  31. package/dist/interactions/index.js +2 -2
  32. package/dist/openui/index.js +1 -1
  33. package/dist/platform/index.js +5 -5
  34. package/dist/preset-cloudflare/index.js +2 -1
  35. package/dist/preset-cloudflare/index.js.map +1 -1
  36. package/dist/public-consultation/index.d.ts +1 -1
  37. package/dist/public-consultation/index.js +6 -6
  38. package/dist/sandbox/index.d.ts +1 -0
  39. package/dist/sandbox/index.js +4 -2
  40. package/dist/sandbox/recovery-original.d.ts +25 -0
  41. package/dist/sandbox/recovery.d.ts +18 -0
  42. package/dist/sequences/index.js +2 -2
  43. package/dist/web/core.d.ts +2 -2
  44. package/dist/web/index.js +2 -2
  45. package/package.json +10 -9
  46. package/dist/DesignCanvasEditor-O7OCZTGC.js +0 -19
  47. package/dist/chunk-LMIP4OVR.js.map +0 -1
  48. package/dist/chunk-UJYEBQMS.js.map +0 -1
  49. /package/dist/{DesignCanvas-IQKYAEC4.js.map → DesignCanvas-CFNV5JGQ.js.map} +0 -0
  50. /package/dist/{DesignCanvasEditor-O7OCZTGC.js.map → DesignCanvasEditor-KH4BDUE3.js.map} +0 -0
  51. /package/dist/{chunk-K3A2YAIX.js.map → chunk-B5YYKYMM.js.map} +0 -0
  52. /package/dist/{chunk-BTKI4XMM.js.map → chunk-CPWMBYLQ.js.map} +0 -0
  53. /package/dist/{chunk-PIPNDZ6H.js.map → chunk-I4CFBLSJ.js.map} +0 -0
  54. /package/dist/{chunk-BI5AZAOO.js.map → chunk-JUQMVD4U.js.map} +0 -0
  55. /package/dist/{chunk-KH4QSBNI.js.map → chunk-KADVQCAS.js.map} +0 -0
  56. /package/dist/{chunk-CPVGRQ43.js.map → chunk-QFIVY6WA.js.map} +0 -0
  57. /package/dist/{chunk-UGFCLD32.js.map → chunk-SFR7FPWL.js.map} +0 -0
  58. /package/dist/{chunk-OODZCBSM.js.map → chunk-SJ73F7HD.js.map} +0 -0
  59. /package/dist/{chunk-ZWJ3SZ2G.js.map → chunk-VCG4DQC4.js.map} +0 -0
  60. /package/dist/{chunk-4FEH6266.js.map → chunk-W3KXRU5N.js.map} +0 -0
  61. /package/dist/{chunk-UTL6TEN6.js.map → chunk-WTNW4NFS.js.map} +0 -0
  62. /package/dist/{chunk-CQGEGPY7.js.map → chunk-ZNE4NYU7.js.map} +0 -0
package/README.md CHANGED
@@ -218,11 +218,11 @@ Failures retain their SDK cause for the redacted diagnostic serializer and prese
218
218
  ```bash
219
219
  pnpm install
220
220
  pnpm typecheck && pnpm test && pnpm build
221
- pnpm test:eval-compat # retained Eval 0.204 application contracts
221
+ pnpm test:eval-compat # application contracts for the declared Eval compatibility lines
222
222
  ```
223
223
 
224
- The compatibility suite reruns the Eval, campaign, profile, knowledge, and catalog seams against published Eval 0.204.0.
225
- A package identity assertion prevents the latest development peer from silently supplying that proof.
224
+ The compatibility suite reruns the Eval, campaign, profile, knowledge, and catalog seams against each published line named by `test:eval-compat`.
225
+ A package identity assertion prevents the development peer from silently supplying that proof. These checks qualify the app's Eval seams separately from Runtime and Knowledge cohort compatibility.
226
226
 
227
227
  Build is [tsup](https://tsup.egoist.dev) for the ESM output plus `tsc` for the `.d.ts`, tests are [vitest](https://vitest.dev). A change keeps the suite green and follows the layering rule above — anything engine-general is contributed down to the substrate, not duplicated here. See [AGENTS.md](./AGENTS.md) for the full contributor contract.
228
228
 
@@ -1,16 +1,16 @@
1
1
  import {
2
2
  DesignCanvas
3
- } from "./chunk-PIPNDZ6H.js";
3
+ } from "./chunk-I4CFBLSJ.js";
4
4
  import "./chunk-P4RRC4AO.js";
5
- import "./chunk-BTKI4XMM.js";
6
- import "./chunk-ZWJ3SZ2G.js";
7
- import "./chunk-CQGEGPY7.js";
5
+ import "./chunk-CPWMBYLQ.js";
6
+ import "./chunk-VCG4DQC4.js";
7
+ import "./chunk-ZNE4NYU7.js";
8
8
  import "./chunk-RN4WPTBH.js";
9
- import "./chunk-WP2GYFZ4.js";
9
+ import "./chunk-ALIWB2P3.js";
10
10
  import "./chunk-TXD5HXLE.js";
11
11
  import "./chunk-6Z7TZVKZ.js";
12
12
  import "./chunk-57XPEL7X.js";
13
13
  export {
14
14
  DesignCanvas
15
15
  };
16
- //# sourceMappingURL=DesignCanvas-IQKYAEC4.js.map
16
+ //# sourceMappingURL=DesignCanvas-CFNV5JGQ.js.map
@@ -0,0 +1,19 @@
1
+ import {
2
+ DesignCanvasEditor
3
+ } from "./chunk-QFIVY6WA.js";
4
+ import "./chunk-I4CFBLSJ.js";
5
+ import "./chunk-P4RRC4AO.js";
6
+ import "./chunk-SJ73F7HD.js";
7
+ import "./chunk-CPWMBYLQ.js";
8
+ import "./chunk-VCG4DQC4.js";
9
+ import "./chunk-ZNE4NYU7.js";
10
+ import "./chunk-RN4WPTBH.js";
11
+ import "./chunk-ALIWB2P3.js";
12
+ import "./chunk-TXD5HXLE.js";
13
+ import "./chunk-6Z7TZVKZ.js";
14
+ import "./chunk-57XPEL7X.js";
15
+ import "./chunk-UTF7H6BK.js";
16
+ export {
17
+ DesignCanvasEditor
18
+ };
19
+ //# sourceMappingURL=DesignCanvasEditor-KH4BDUE3.js.map
@@ -1,8 +1,8 @@
1
1
  import {
2
2
  EnrollmentTargetError
3
- } from "../chunk-UGFCLD32.js";
4
- import "../chunk-4FEH6266.js";
5
- import "../chunk-WP2GYFZ4.js";
3
+ } from "../chunk-SFR7FPWL.js";
4
+ import "../chunk-W3KXRU5N.js";
5
+ import "../chunk-ALIWB2P3.js";
6
6
  import "../chunk-TXD5HXLE.js";
7
7
 
8
8
  // src/agent-enrollment/drizzle.ts
@@ -2,9 +2,9 @@ import {
2
2
  EnrollmentTargetError,
3
3
  createAgentEnrollment,
4
4
  createEnrolledApplicationLineHandler
5
- } from "../chunk-UGFCLD32.js";
6
- import "../chunk-4FEH6266.js";
7
- import "../chunk-WP2GYFZ4.js";
5
+ } from "../chunk-SFR7FPWL.js";
6
+ import "../chunk-W3KXRU5N.js";
7
+ import "../chunk-ALIWB2P3.js";
8
8
  import "../chunk-TXD5HXLE.js";
9
9
  export {
10
10
  EnrollmentTargetError,
@@ -2,13 +2,13 @@ import {
2
2
  createAuthGuard,
3
3
  createBetterAuthSessionCookieMinter,
4
4
  createTangleSsoHandlers
5
- } from "../chunk-BI5AZAOO.js";
5
+ } from "../chunk-JUQMVD4U.js";
6
6
  import {
7
7
  noticeEmail
8
8
  } from "../chunk-WOTWQ2ST.js";
9
- import "../chunk-CQGEGPY7.js";
9
+ import "../chunk-ZNE4NYU7.js";
10
10
  import "../chunk-RN4WPTBH.js";
11
- import "../chunk-WP2GYFZ4.js";
11
+ import "../chunk-ALIWB2P3.js";
12
12
  import "../chunk-D6UJEOZQ.js";
13
13
  import "../chunk-TXD5HXLE.js";
14
14
  import "../chunk-6Z7TZVKZ.js";
@@ -79,16 +79,15 @@ import {
79
79
  turnCarriesFiles,
80
80
  turnPromptText,
81
81
  withProducerStream
82
- } from "../chunk-K3A2YAIX.js";
83
- import "../chunk-KH4QSBNI.js";
82
+ } from "../chunk-B5YYKYMM.js";
83
+ import "../chunk-KADVQCAS.js";
84
84
  import {
85
85
  sniffMimeFromName
86
- } from "../chunk-CQGEGPY7.js";
86
+ } from "../chunk-ZNE4NYU7.js";
87
87
  import "../chunk-RN4WPTBH.js";
88
- import "../chunk-WP2GYFZ4.js";
89
88
  import "../chunk-4DBHC63F.js";
90
89
  import "../chunk-MM6RLOXF.js";
91
- import "../chunk-LMIP4OVR.js";
90
+ import "../chunk-VOXKDO4T.js";
92
91
  import "../chunk-F4TUZYMX.js";
93
92
  import {
94
93
  redactErrorMessage
@@ -146,7 +145,8 @@ import {
146
145
  mergePersistedPart
147
146
  } from "../chunk-VUBJZEZB.js";
148
147
  import "../chunk-6VQCFJWP.js";
149
- import "../chunk-UJYEBQMS.js";
148
+ import "../chunk-H4JL74GP.js";
149
+ import "../chunk-ALIWB2P3.js";
150
150
  import {
151
151
  DEFAULT_STALE_TURN_LOCK_GRACE_MS,
152
152
  DEFAULT_TERMINAL_TURN_LOCK_GRACE_MS,
@@ -350,4 +350,4 @@ export {
350
350
  addSecurityHeaders,
351
351
  assertMediaUrl
352
352
  };
353
- //# sourceMappingURL=chunk-WP2GYFZ4.js.map
353
+ //# sourceMappingURL=chunk-ALIWB2P3.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/web/rate-limit.ts","../src/web/free-route-limit.ts","../src/web/core.ts"],"sourcesContent":["/**\n * The KV-backed sliding-window rate limiter. Lives in its own leaf so policy\n * layers (`./free-route-limit`) can build on it without importing the web\n * barrel and creating an import cycle. Re-exported from `./index`, which is the\n * published surface.\n */\n\n/** Minimal KV contract (Cloudflare `KVNamespace` satisfies it structurally). */\nexport interface KvLike {\n get(key: string): Promise<string | null>\n put(key: string, value: string, options?: { expirationTtl?: number }): Promise<void>\n}\n\n/** Describe the outcome of a rate limit check including allowance, remaining count, and reset time */\nexport interface RateLimitResult {\n allowed: boolean\n remaining: number\n resetAt: number\n}\n\n/** Request-lifetime persistence for a coarse limiter. Callers must retain the\n * promise until it settles and observe write failures; hard quotas must await. */\nexport interface RateLimitOptions {\n waitUntil?: (persist: Promise<void>) => void\n}\n\n/** KV-backed sliding-window rate limit. Stores recent timestamps per key,\n * prunes the window, allows until `limit` is hit.\n *\n * Read-modify-write is best-effort, NOT atomic: KV has no compare-and-swap, so\n * two requests racing on the same key can each read the same pre-state and both\n * write — a concurrent burst can momentarily admit up to one extra request per\n * racing writer. This is acceptable for coarse abuse limiting; it is NOT a hard\n * quota gate.\n *\n * Fail-CLOSED on unreadable state: corrupt/non-array KV (a poisoned or\n * truncated value) is treated as a full window, so a tampered key cannot reset\n * the count and bypass the limiter. A bare `JSON.parse` here would throw and\n * abort the request handler, silently disabling the limit (fail-open). */\nexport async function checkRateLimit(kv: KvLike, key: string, limit: number, windowSeconds: number, options: RateLimitOptions = {}): Promise<RateLimitResult> {\n const now = Math.floor(Date.now() / 1000)\n const windowStart = now - windowSeconds\n const kvKey = `rl:${key}`\n const raw = await kv.get(kvKey)\n const parsed = parseRateLimitState(raw)\n if (parsed === POISONED_STATE) {\n // Unreadable state (parse threw or value is not a JSON array): deny rather\n // than reset the window to empty. A poisoned key must not become a bypass.\n return { allowed: false, remaining: 0, resetAt: now + windowSeconds }\n }\n const valid = parsed.filter((t) => t > windowStart)\n if (valid.length >= limit) return { allowed: false, remaining: 0, resetAt: (valid[0] ?? now) + windowSeconds }\n valid.push(now)\n const persist = kv.put(kvKey, JSON.stringify(valid), { expirationTtl: windowSeconds * 2 })\n if (options.waitUntil) options.waitUntil(persist)\n else await persist\n return { allowed: true, remaining: limit - valid.length, resetAt: now + windowSeconds }\n}\n\n/** Sentinel returned by `parseRateLimitState` when the stored value cannot be\n * read as a timestamp array — distinct from an empty window so the limiter can\n * fail closed instead of treating corruption as a fresh window. */\nconst POISONED_STATE = Symbol('rate-limit-poisoned-state')\n\n/** Parse stored rate-limit state into a timestamp array. Absent state is a\n * fresh (empty) window. A value that fails to parse, or parses to a non-array,\n * returns `POISONED_STATE`; numeric junk inside a valid array is dropped. */\nfunction parseRateLimitState(raw: string | null): number[] | typeof POISONED_STATE {\n if (raw === null) return []\n let parsed: unknown\n try {\n parsed = JSON.parse(raw)\n } catch {\n return POISONED_STATE\n }\n if (!Array.isArray(parsed)) return POISONED_STATE\n return parsed.filter((t): t is number => typeof t === 'number' && Number.isFinite(t))\n}\n\n/** Timing of one limiter decision, for a product that logs it. */\nexport interface RateLimitTiming {\n readMs: number\n /** Present once the counter write settled. */\n writeMs?: number\n /** Present on the decision event. */\n decisionMs?: number\n allowed?: boolean\n deferred: boolean\n}\n\nexport interface RateLimiterBindingOptions {\n /** Called when the counter write settles and when the decision is made. */\n onTiming?: (event: 'counter' | 'decision', timing: RateLimitTiming) => void\n /** Called when a deferred counter write fails; the decision already stood. */\n onPersistError?: (error: unknown) => void\n}\n\n/**\n * A product's limiter bound once to its KV namespace at worker start:\n * `setKV(env.RATE_LIMIT_KV)`, then `check(key, limit, windowSeconds)` anywhere.\n * Pass `waitUntil` to defer the counter write past the response.\n */\nexport function createRateLimiterBinding(options: RateLimiterBindingOptions = {}) {\n let bound: KvLike | null = null\n\n function setKV(kv: KvLike): void { bound = kv }\n\n async function check(\n key: string,\n limit: number,\n windowSeconds: number,\n waitUntil?: (persist: Promise<void>) => void,\n ): Promise<RateLimitResult> {\n if (!bound) throw new Error('RATE_LIMIT_KV not initialized')\n const { onTiming, onPersistError } = options\n const kv = bound\n const deferred = Boolean(waitUntil)\n const startedAt = Date.now()\n let readMs = 0\n const measured: KvLike = onTiming\n ? {\n async get(counterKey) {\n const began = Date.now()\n try { return await kv.get(counterKey) } finally { readMs = Date.now() - began }\n },\n async put(counterKey, value, putOptions) {\n const began = Date.now()\n try { await kv.put(counterKey, value, putOptions) } finally {\n onTiming('counter', { readMs, writeMs: Date.now() - began, deferred })\n }\n },\n }\n : kv\n const result = await checkRateLimit(measured, key, limit, windowSeconds, waitUntil\n ? { waitUntil: (persist) => waitUntil(persist.catch((error: unknown) => onPersistError?.(error))) }\n : {})\n onTiming?.('decision', { readMs, decisionMs: Date.now() - startedAt, allowed: result.allowed, deferred })\n return result\n }\n\n return { setKV, check }\n}\n","/**\n * Rate-limit policy for FREE routes: authenticated, unmetered, compute-bearing\n * endpoints.\n *\n * Billing meters the chat turn. Everything deterministic a product adds beside\n * it — a planning recompute fired on every slider drag, a redline diff, a\n * deadline computation — runs unmetered, so nothing bounds how much worker CPU\n * one authenticated caller can spend. `checkRateLimit` is the primitive; this\n * is the policy around it, so a route declares a cost class instead of each one\n * inventing a key format, a budget, and a denial response.\n *\n * Three rules this enforces that a hand-rolled call site usually does not:\n *\n * 1. **Identity is required.** A missing subject is denied, never pooled into a\n * shared bucket and never quietly keyed by IP — a shared bucket makes one\n * heavy user throttle everyone, and an IP key makes one NAT do the same.\n * 2. **A limiter that throws denies.** KV `get`/`put` failures are transport\n * failures; treating them as \"allowed\" converts a KV outage into an\n * unbounded-compute hole, which is exactly when the limiter matters most.\n * 3. **The denial is a typed, correctable outcome** — reason, HTTP status and\n * `Retry-After` — so the caller answers the client rather than failing\n * opaquely or, worse, continuing.\n *\n * ```ts\n * export const action = withFreeRouteLimit(\n * {\n * route: 'tax.plan.recompute',\n * costClass: 'interactive',\n * kv: ({ context }) => context.cloudflare.env.RATE_LIMIT_KV,\n * identify: async ({ request }) => {\n * const session = await requireSession(request)\n * return { subject: session.userId, workspace: session.workspaceId }\n * },\n * },\n * async ({ request }) => Response.json(recompute(await request.json())),\n * )\n * ```\n */\n\nimport { checkRateLimit, type KvLike, type RateLimitResult } from './rate-limit'\n\n/** Requests allowed per identity inside a sliding window. */\nexport interface RateLimitBudget {\n limit: number\n windowSeconds: number\n}\n\n/**\n * How expensive one call is, which is what picks the default budget.\n *\n * - `interactive` — a control the user drags or types into, recomputed per\n * tick. Sized for sustained two-per-second interaction, so a real slider\n * never trips it and a script still stops.\n * - `compute` — a derivation the user triggers deliberately (recalculate a\n * plan, diff a document, compute a deadline set). The default.\n * - `heavy` — whole-document or whole-matter work measured in seconds of CPU.\n */\nexport type FreeRouteClass = 'interactive' | 'compute' | 'heavy'\n\n/** Default budget per cost class. A product overrides with an explicit\n * `budget` when it has measured its own route. */\nexport const FREE_ROUTE_BUDGETS: Readonly<Record<FreeRouteClass, RateLimitBudget>> = Object.freeze({\n interactive: Object.freeze({ limit: 120, windowSeconds: 60 }),\n compute: Object.freeze({ limit: 30, windowSeconds: 60 }),\n heavy: Object.freeze({ limit: 10, windowSeconds: 300 }),\n})\n\n/** A workspace's shared ceiling defaults to this many times one member's, so a\n * multi-seat tenant is bounded without a single active member tripping it. */\nexport const WORKSPACE_BUDGET_MULTIPLIER = 5\n\n/** Why a call was refused. Every value is a REFUSAL — there is no reason code\n * that lets the handler run. */\nexport type FreeRouteDenialReason =\n /** No authenticated subject. Not correctable by waiting. */\n | 'unidentified'\n /** The window is full for this subject or workspace. */\n | 'rate-limited'\n /** The limiter itself failed (KV read/write threw). Denied, not passed. */\n | 'limiter-unavailable'\n\n/** Which window refused the call. `null` when no window was consulted. */\nexport type FreeRouteDimension = 'subject' | 'workspace' | null\n\n/**\n * A correctable refusal: the caller maps `status` + `retryAfterSeconds` onto a\n * response (see {@link freeRouteLimitResponse}) so the client learns what to do\n * next. Carrying the limiter's own failure in `cause` keeps a KV outage\n * diagnosable instead of collapsing into a generic 429.\n */\nexport class FreeRouteLimitError extends Error {\n readonly reason: FreeRouteDenialReason\n readonly status: 401 | 429 | 503\n readonly retryAfterSeconds: number\n readonly dimension: FreeRouteDimension\n readonly route: string\n\n constructor(init: {\n reason: FreeRouteDenialReason\n status: 401 | 429 | 503\n retryAfterSeconds: number\n dimension: FreeRouteDimension\n route: string\n message: string\n cause?: unknown\n }) {\n super(init.message, init.cause === undefined ? undefined : { cause: init.cause })\n this.name = 'FreeRouteLimitError'\n this.reason = init.reason\n this.status = init.status\n this.retryAfterSeconds = init.retryAfterSeconds\n this.dimension = init.dimension\n this.route = init.route\n }\n}\n\n/** What remains of the binding window after an allowed call. */\nexport interface FreeRouteAllowance {\n /** Remaining calls in whichever window is tightest. */\n remaining: number\n /** Unix seconds at which that window resets. */\n resetAt: number\n /** The budget that window enforces. */\n budget: RateLimitBudget\n /** Which window is tightest — `subject` unless a workspace ceiling binds. */\n dimension: Exclude<FreeRouteDimension, null>\n}\n\n/** Typed outcome at the route boundary: an allowance, or a refusal that says\n * how to correct it. There is no third state and no silent pass. */\nexport type FreeRouteLimitOutcome =\n | { succeeded: true; value: FreeRouteAllowance }\n | { succeeded: false; error: FreeRouteLimitError }\n\nexport interface FreeRouteLimitInput {\n kv: KvLike\n /** Stable route name. Part of the key, so two routes never share a window. */\n route: string\n /** The authenticated subject (user id). Absent or blank ⇒ denied. */\n subject: string | null | undefined\n /** Tenant the call belongs to. When present, a second, wider window bounds\n * the workspace as a whole. */\n workspace?: string | null\n /** Cost class picking the default budget. Ignored when `budget` is given.\n * Default `'compute'`. */\n costClass?: FreeRouteClass\n budget?: RateLimitBudget\n /** Workspace ceiling. Defaults to the subject budget's limit multiplied by\n * {@link WORKSPACE_BUDGET_MULTIPLIER} over the same window. */\n workspaceBudget?: RateLimitBudget\n}\n\n/** Key components are percent-encoded so a route name or subject containing the\n * separator cannot be crafted to collide with another caller's window. */\nfunction limitKey(route: string, dimension: string, id: string): string {\n return `free:${encodeURIComponent(route)}:${dimension}:${encodeURIComponent(id)}`\n}\n\nfunction assertBudget(budget: RateLimitBudget, label: string): void {\n const valid =\n Number.isInteger(budget.limit) &&\n budget.limit >= 1 &&\n Number.isInteger(budget.windowSeconds) &&\n budget.windowSeconds >= 1\n if (!valid) {\n throw new Error(\n `${label} must be positive integers (got limit=${budget.limit}, windowSeconds=${budget.windowSeconds})`,\n )\n }\n}\n\nfunction secondsUntil(resetAt: number): number {\n return Math.max(1, resetAt - Math.floor(Date.now() / 1000))\n}\n\n/**\n * Run one window. A throw from KV becomes a `limiter-unavailable` refusal\n * rather than propagating — the caller must be able to answer 503 with a\n * `Retry-After` instead of the handler running or the route 500ing opaquely.\n */\nasync function runWindow(\n kv: KvLike,\n route: string,\n dimension: Exclude<FreeRouteDimension, null>,\n id: string,\n budget: RateLimitBudget,\n): Promise<{ succeeded: true; value: RateLimitResult } | { succeeded: false; error: FreeRouteLimitError }> {\n try {\n const value = await checkRateLimit(kv, limitKey(route, dimension, id), budget.limit, budget.windowSeconds)\n return { succeeded: true, value }\n } catch (cause) {\n return {\n succeeded: false,\n error: new FreeRouteLimitError({\n reason: 'limiter-unavailable',\n status: 503,\n retryAfterSeconds: Math.min(budget.windowSeconds, 30),\n dimension,\n route,\n message: `Rate limiter unavailable for route '${route}' — the request is refused rather than admitted unmetered`,\n cause,\n }),\n }\n }\n}\n\n/**\n * Decide whether one authenticated, unmetered call may run.\n *\n * Checks the subject's window first, then the workspace ceiling when a\n * workspace is supplied; the tighter of the two is what the allowance reports.\n * Every failure path returns a refusal — none returns an allowance.\n */\nexport async function checkFreeRouteLimit(input: FreeRouteLimitInput): Promise<FreeRouteLimitOutcome> {\n const budget = input.budget ?? FREE_ROUTE_BUDGETS[input.costClass ?? 'compute']\n assertBudget(budget, `Free-route budget for '${input.route}'`)\n const workspaceBudget =\n input.workspaceBudget ?? { limit: budget.limit * WORKSPACE_BUDGET_MULTIPLIER, windowSeconds: budget.windowSeconds }\n if (input.workspace) assertBudget(workspaceBudget, `Free-route workspace budget for '${input.route}'`)\n\n const subject = input.subject?.trim()\n if (!subject) {\n return {\n succeeded: false,\n error: new FreeRouteLimitError({\n reason: 'unidentified',\n status: 401,\n // Not correctable by waiting: the caller must authenticate.\n retryAfterSeconds: 0,\n dimension: null,\n route: input.route,\n message: `Route '${input.route}' is authenticated-only — an unidentified caller cannot be rate limited, so it is refused`,\n }),\n }\n }\n\n const subjectWindow = await runWindow(input.kv, input.route, 'subject', subject, budget)\n if (!subjectWindow.succeeded) return subjectWindow\n if (!subjectWindow.value.allowed) {\n return { succeeded: false, error: rateLimited(input.route, 'subject', subjectWindow.value) }\n }\n\n let tightest: { result: RateLimitResult; budget: RateLimitBudget; dimension: Exclude<FreeRouteDimension, null> } = {\n result: subjectWindow.value,\n budget,\n dimension: 'subject',\n }\n\n if (input.workspace) {\n const workspaceWindow = await runWindow(input.kv, input.route, 'workspace', input.workspace, workspaceBudget)\n if (!workspaceWindow.succeeded) return workspaceWindow\n if (!workspaceWindow.value.allowed) {\n return { succeeded: false, error: rateLimited(input.route, 'workspace', workspaceWindow.value) }\n }\n if (workspaceWindow.value.remaining < tightest.result.remaining) {\n tightest = { result: workspaceWindow.value, budget: workspaceBudget, dimension: 'workspace' }\n }\n }\n\n return {\n succeeded: true,\n value: {\n remaining: tightest.result.remaining,\n resetAt: tightest.result.resetAt,\n budget: tightest.budget,\n dimension: tightest.dimension,\n },\n }\n}\n\nfunction rateLimited(\n route: string,\n dimension: Exclude<FreeRouteDimension, null>,\n result: RateLimitResult,\n): FreeRouteLimitError {\n const retryAfterSeconds = secondsUntil(result.resetAt)\n return new FreeRouteLimitError({\n reason: 'rate-limited',\n status: 429,\n retryAfterSeconds,\n dimension,\n route,\n message: `Route '${route}' rate limit reached for this ${dimension}; retry in ${retryAfterSeconds}s`,\n })\n}\n\nexport interface FreeRouteLimitResponseOptions {\n /** Extra response headers (a product's security headers, CORS). */\n headers?: Record<string, string>\n /** Client-facing message. Defaults to the error's own message. */\n message?: string\n}\n\n/** The refusal as an HTTP response: the error's status, a JSON body carrying\n * the machine-readable `reason`, and `Retry-After` when waiting can fix it. */\nexport function freeRouteLimitResponse(\n error: FreeRouteLimitError,\n options: FreeRouteLimitResponseOptions = {},\n): Response {\n const headers = new Headers(options.headers)\n headers.set('Content-Type', 'application/json')\n if (error.retryAfterSeconds > 0) headers.set('Retry-After', String(error.retryAfterSeconds))\n return new Response(\n JSON.stringify({\n error: options.message ?? error.message,\n reason: error.reason,\n retryAfterSeconds: error.retryAfterSeconds,\n }),\n { status: error.status, headers },\n )\n}\n\n/** The authenticated caller behind one request. */\nexport interface FreeRouteIdentity {\n subject: string\n workspace?: string | null\n}\n\nexport interface WithFreeRouteLimitOptions<TArgs> {\n /** Stable route name; part of the key. */\n route: string\n costClass?: FreeRouteClass\n budget?: RateLimitBudget\n workspaceBudget?: RateLimitBudget\n /** The KV binding for this request. */\n kv: (args: TArgs) => KvLike\n /**\n * Resolve the authenticated caller. Return `null` for an unauthenticated\n * request — the wrapper then refuses with 401 and the handler never runs.\n *\n * A THROW here propagates: an auth lookup that failed is not the same as an\n * absent session, and the wrapper will not invent a status for it. The\n * handler still does not run, so the failure stays closed.\n */\n identify: (args: TArgs) => Promise<FreeRouteIdentity | null> | FreeRouteIdentity | null\n /** Build the refusal response. Defaults to {@link freeRouteLimitResponse}. */\n onDenied?: (error: FreeRouteLimitError, args: TArgs) => Response | Promise<Response>\n}\n\n/**\n * Wrap an authenticated, unmetered, compute-bearing route handler in its\n * budget. The limit is applied BEFORE the handler is entered — including\n * before the request body is read — so a refused call costs a KV read, not the\n * compute the route exists to do.\n *\n * The handler's own response is returned untouched: this never rewrites status,\n * body or headers on the success path, so it cannot break a streaming or\n * pre-built response.\n *\n * `TArgs` is the router's handler-argument object (react-router's\n * `ActionFunctionArgs`, or any single-object shape a product uses).\n */\nexport function withFreeRouteLimit<TArgs>(\n options: WithFreeRouteLimitOptions<TArgs>,\n handler: (args: TArgs) => Response | Promise<Response>,\n): (args: TArgs) => Promise<Response> {\n return async (args: TArgs): Promise<Response> => {\n const identity = await options.identify(args)\n const outcome = await checkFreeRouteLimit({\n kv: options.kv(args),\n route: options.route,\n subject: identity?.subject,\n workspace: identity?.workspace,\n costClass: options.costClass,\n budget: options.budget,\n workspaceBudget: options.workspaceBudget,\n })\n if (!outcome.succeeded) {\n return options.onDenied ? await options.onDenied(outcome.error, args) : freeRouteLimitResponse(outcome.error)\n }\n return await handler(args)\n }\n}\n","/**\n * Web-boundary utilities every agent app's routes hand-roll: JSON body parsing\n * + narrowing, request-context extraction (real client IP behind Cloudflare),\n * a KV-backed sliding-window rate limiter, the free-route budget policy built\n * on it, and security response headers. Pure mechanism — no DB, no domain. The\n * KV is a structural interface so this needs no `@cloudflare/workers-types`\n * dependency.\n */\n\nexport * from './rate-limit'\nexport * from './free-route-limit'\n\nexport type JsonObject = Record<string, unknown>\n\n/** Parse + object-narrow a Request body. `[body, null]` on success, `[null,\n * errorResponse]` on a non-object body (callers `if (err) return err`). */\nexport async function parseJsonObjectBody(\n request: Request,\n options: { maxBytes?: number } = {},\n): Promise<[JsonObject, null] | [null, Response]> {\n const maxBytes = options.maxBytes\n if (maxBytes !== undefined && (!Number.isSafeInteger(maxBytes) || maxBytes < 1))\n throw new TypeError('maxBytes must be a positive safe integer')\n let raw: unknown\n try {\n if (maxBytes === undefined) raw = await request.json()\n else {\n const length = request.headers.get('content-length')\n if (length !== null && Number(length) > maxBytes)\n return [null, Response.json({ error: 'JSON body is too large' }, { status: 413 })]\n if (!request.body) return [null, Response.json({ error: 'Invalid JSON body' }, { status: 400 })]\n const reader = request.body.getReader()\n const chunks: Uint8Array[] = []\n let size = 0\n try {\n for (;;) {\n const next = await reader.read()\n if (next.done) break\n size += next.value.byteLength\n if (size > maxBytes)\n return [null, Response.json({ error: 'JSON body is too large' }, { status: 413 })]\n chunks.push(next.value)\n }\n } finally {\n await reader.cancel().catch(() => undefined)\n }\n const bytes = new Uint8Array(size)\n let offset = 0\n for (const chunk of chunks) { bytes.set(chunk, offset); offset += chunk.byteLength }\n raw = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes))\n }\n } catch {\n return [null, Response.json({ error: 'Invalid JSON body' }, { status: 400 })]\n }\n if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {\n return [null, Response.json({ error: 'Body must be a JSON object' }, { status: 400 })]\n }\n return [raw as JsonObject, null]\n}\n\n/** Narrow one required string field, 400 if missing/empty. */\nexport function requireString(body: JsonObject, field: string): string | Response {\n const v = body[field]\n if (typeof v !== 'string' || v.length === 0) {\n return Response.json({ error: `Missing or non-string field: ${field}` }, { status: 400 })\n }\n return v\n}\n\n/** Define the context of a request including IP address, user agent, timestamp, and request ID */\nexport interface RequestContext {\n ipAddress: string\n userAgent: string\n timestamp: string\n requestId: string\n}\n\n/** Extract request context for audit trails. Uses `CF-Connecting-IP` for the\n * real client IP behind Cloudflare. */\nexport function extractRequestContext(request: Request): RequestContext {\n const ipAddress =\n request.headers.get('CF-Connecting-IP') ??\n request.headers.get('X-Forwarded-For')?.split(',')[0]?.trim() ??\n '0.0.0.0'\n return {\n ipAddress,\n userAgent: request.headers.get('User-Agent') ?? '',\n timestamp: new Date().toISOString(),\n requestId: crypto.randomUUID(),\n }\n}\n\n/** Define options for configuring cookie attributes and behavior */\nexport interface CookieOptions {\n name: string\n /** Default '/'. */\n path?: string\n /** Default true. */\n httpOnly?: boolean\n /** Adds the `Secure` attribute. Default false. */\n secure?: boolean\n /** Default 'Lax'. */\n sameSite?: 'Lax' | 'Strict' | 'None'\n maxAgeSeconds?: number\n}\n\n/** Serialize a Set-Cookie header value: `name=encodeURIComponent(value)` plus\n * attributes in Path / HttpOnly / SameSite / Max-Age / Secure order.\n * Throws on `SameSite=None` without `secure` — browsers silently drop that\n * combination, which would otherwise fail invisibly. */\nexport function serializeCookie(value: string, opts: CookieOptions): string {\n if (opts.sameSite === 'None' && !opts.secure) {\n throw new Error('SameSite=None cookies require secure: true (browsers reject them otherwise)')\n }\n const parts = [`${opts.name}=${encodeURIComponent(value)}`, `Path=${opts.path ?? '/'}`]\n if (opts.httpOnly !== false) parts.push('HttpOnly')\n parts.push(`SameSite=${opts.sameSite ?? 'Lax'}`)\n if (opts.maxAgeSeconds !== undefined) parts.push(`Max-Age=${opts.maxAgeSeconds}`)\n if (opts.secure) parts.push('Secure')\n return parts.join('; ')\n}\n\n/** Set-Cookie header value that deletes the cookie (empty value, Max-Age=0). */\nexport function clearCookieHeader(opts: Omit<CookieOptions, 'maxAgeSeconds'>): string {\n return serializeCookie('', { ...opts, maxAgeSeconds: 0 })\n}\n\n/** Read + decode one cookie from a Cookie request header; null when absent. */\nexport function readCookieValue(cookieHeader: string | null, name: string): string | null {\n if (!cookieHeader) return null\n for (const part of cookieHeader.split(/;\\s*/)) {\n const [cookieName, ...rest] = part.split('=')\n if (cookieName === name) {\n try {\n return decodeURIComponent(rest.join('='))\n } catch {\n return null\n }\n }\n }\n return null\n}\n\n/** Define options for configuring security-related HTTP headers including disclaimers and retention labels */\nexport interface SecurityHeaderOptions {\n /** Product disclaimer (e.g. \"AI-powered tool. Not legal advice.\"). Omitted if absent. */\n disclaimer?: string\n /** Data-retention label (e.g. \"7-years\"). Omitted if absent. */\n retention?: string\n /** Extra headers to set. */\n extra?: Record<string, string>\n}\n\n/** Canonical generic response headers used by {@link addSecurityHeaders}.\n * Exported so static-asset hosts can apply the same policy without copying\n * values that silently drift from Worker/API responses. */\nexport const STANDARD_SECURITY_HEADERS = Object.freeze({\n 'Strict-Transport-Security':\n 'max-age=31536000; includeSubDomains; preload',\n 'X-Content-Type-Options': 'nosniff',\n 'X-Frame-Options': 'SAMEORIGIN',\n 'Referrer-Policy': 'same-origin',\n 'X-XSS-Protection': '1; mode=block',\n} as const)\n\n/** Set standard security headers on a response (HSTS, nosniff, frame-options,\n * referrer-policy, XSS) + optional product disclaimer/retention. The security\n * set is generic; the disclaimer/retention are the product's. */\nexport function addSecurityHeaders(response: Response, opts: SecurityHeaderOptions = {}): Response {\n for (const [name, value] of Object.entries(STANDARD_SECURITY_HEADERS)) {\n response.headers.set(name, value)\n }\n if (opts.disclaimer) response.headers.set('X-AI-Disclaimer', opts.disclaimer)\n if (opts.retention) response.headers.set('X-Data-Retention', opts.retention)\n for (const [k, v] of Object.entries(opts.extra ?? {})) response.headers.set(k, v)\n return response\n}\n\n/** Local-sandbox / inline schemes a stored media reference must never use.\n * Reachable from neither a browser nor the product worker, and a `file:`/`data:`\n * url is the tell of an agent substituting local ffmpeg output for a real\n * provider artifact. `blob:` and `javascript:` are inert/active client schemes\n * with no server reachability. */\nconst REJECTED_MEDIA_SCHEMES = ['file:', 'data:', 'blob:', 'javascript:', 'vbscript:'] as const\n\n/**\n * Canonical media-reference boundary shared by every surface that persists a\n * media url (sequences clips, design-canvas image/video src). The ONE rule:\n * remote `http(s)` or a rooted `/api/` path are allowed; everything else is\n * rejected, with a named reason for known-bad local/inline schemes so the\n * thrown message is actionable for an LLM planner. The url is trimmed before\n * the scheme check so leading whitespace cannot smuggle a rejected scheme past\n * a naive `startsWith`.\n *\n * @param what - noun for the error message (e.g. 'media url', 'src').\n */\nexport function assertMediaUrl(url: string, what = 'media url'): void {\n const trimmed = url.trim()\n if (/^https?:\\/\\//i.test(trimmed)) return\n if (trimmed.startsWith('/api/')) return\n const shown = trimmed.length > 96 ? `${trimmed.slice(0, 96)}…` : trimmed\n const lower = trimmed.toLowerCase()\n if (\n REJECTED_MEDIA_SCHEMES.some((scheme) => lower.startsWith(scheme)) ||\n lower.startsWith('/tmp/') ||\n lower.startsWith('/home/')\n ) {\n throw new Error(`${what} must reference a provider http(s) URL or a rooted /api/ path, not a local sandbox file (${shown})`)\n }\n throw new Error(`${what} must be http(s) or a rooted /api/ path (${shown})`)\n}\n\nexport { isWorkspaceFileExportable } from './file-export'\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/web/rate-limit.ts","../src/web/free-route-limit.ts","../src/web/core.ts"],"sourcesContent":["/**\n * The KV-backed sliding-window rate limiter. Lives in its own leaf so policy\n * layers (`./free-route-limit`) can build on it without importing the web\n * barrel and creating an import cycle. Re-exported from `./index`, which is the\n * published surface.\n */\n\n/** Minimal KV contract (Cloudflare `KVNamespace` satisfies it structurally). */\nexport interface KvLike {\n get(key: string): Promise<string | null>\n put(key: string, value: string, options?: { expirationTtl?: number }): Promise<void>\n}\n\n/** Describe the outcome of a rate limit check including allowance, remaining count, and reset time */\nexport interface RateLimitResult {\n allowed: boolean\n remaining: number\n resetAt: number\n}\n\n/** Request-lifetime persistence for a coarse limiter. Callers must retain the\n * promise until it settles and observe write failures; hard quotas must await. */\nexport interface RateLimitOptions {\n waitUntil?: (persist: Promise<void>) => void\n}\n\n/** KV-backed sliding-window rate limit. Stores recent timestamps per key,\n * prunes the window, allows until `limit` is hit.\n *\n * Read-modify-write is best-effort, NOT atomic: KV has no compare-and-swap, so\n * two requests racing on the same key can each read the same pre-state and both\n * write — a concurrent burst can momentarily admit up to one extra request per\n * racing writer. This is acceptable for coarse abuse limiting; it is NOT a hard\n * quota gate.\n *\n * Fail-CLOSED on unreadable state: corrupt/non-array KV (a poisoned or\n * truncated value) is treated as a full window, so a tampered key cannot reset\n * the count and bypass the limiter. A bare `JSON.parse` here would throw and\n * abort the request handler, silently disabling the limit (fail-open). */\nexport async function checkRateLimit(kv: KvLike, key: string, limit: number, windowSeconds: number, options: RateLimitOptions = {}): Promise<RateLimitResult> {\n const now = Math.floor(Date.now() / 1000)\n const windowStart = now - windowSeconds\n const kvKey = `rl:${key}`\n const raw = await kv.get(kvKey)\n const parsed = parseRateLimitState(raw)\n if (parsed === POISONED_STATE) {\n // Unreadable state (parse threw or value is not a JSON array): deny rather\n // than reset the window to empty. A poisoned key must not become a bypass.\n return { allowed: false, remaining: 0, resetAt: now + windowSeconds }\n }\n const valid = parsed.filter((t) => t > windowStart)\n if (valid.length >= limit) return { allowed: false, remaining: 0, resetAt: (valid[0] ?? now) + windowSeconds }\n valid.push(now)\n const persist = kv.put(kvKey, JSON.stringify(valid), { expirationTtl: windowSeconds * 2 })\n if (options.waitUntil) options.waitUntil(persist)\n else await persist\n return { allowed: true, remaining: limit - valid.length, resetAt: now + windowSeconds }\n}\n\n/** Sentinel returned by `parseRateLimitState` when the stored value cannot be\n * read as a timestamp array — distinct from an empty window so the limiter can\n * fail closed instead of treating corruption as a fresh window. */\nconst POISONED_STATE = Symbol('rate-limit-poisoned-state')\n\n/** Parse stored rate-limit state into a timestamp array. Absent state is a\n * fresh (empty) window. A value that fails to parse, or parses to a non-array,\n * returns `POISONED_STATE`; numeric junk inside a valid array is dropped. */\nfunction parseRateLimitState(raw: string | null): number[] | typeof POISONED_STATE {\n if (raw === null) return []\n let parsed: unknown\n try {\n parsed = JSON.parse(raw)\n } catch {\n return POISONED_STATE\n }\n if (!Array.isArray(parsed)) return POISONED_STATE\n return parsed.filter((t): t is number => typeof t === 'number' && Number.isFinite(t))\n}\n\n/** Timing of one limiter decision, for a product that logs it. */\nexport interface RateLimitTiming {\n readMs: number\n /** Present once the counter write settled. */\n writeMs?: number\n /** Present on the decision event. */\n decisionMs?: number\n allowed?: boolean\n deferred: boolean\n}\n\nexport interface RateLimiterBindingOptions {\n /** Called when the counter write settles and when the decision is made. */\n onTiming?: (event: 'counter' | 'decision', timing: RateLimitTiming) => void\n /** Called when a deferred counter write fails; the decision already stood. */\n onPersistError?: (error: unknown) => void\n}\n\n/**\n * A product's limiter bound once to its KV namespace at worker start:\n * `setKV(env.RATE_LIMIT_KV)`, then `check(key, limit, windowSeconds)` anywhere.\n * Pass `waitUntil` to defer the counter write past the response.\n */\nexport function createRateLimiterBinding(options: RateLimiterBindingOptions = {}) {\n let bound: KvLike | null = null\n\n function setKV(kv: KvLike): void { bound = kv }\n\n async function check(\n key: string,\n limit: number,\n windowSeconds: number,\n waitUntil?: (persist: Promise<void>) => void,\n ): Promise<RateLimitResult> {\n if (!bound) throw new Error('RATE_LIMIT_KV not initialized')\n const { onTiming, onPersistError } = options\n const kv = bound\n const deferred = Boolean(waitUntil)\n const startedAt = Date.now()\n let readMs = 0\n const measured: KvLike = onTiming\n ? {\n async get(counterKey) {\n const began = Date.now()\n try { return await kv.get(counterKey) } finally { readMs = Date.now() - began }\n },\n async put(counterKey, value, putOptions) {\n const began = Date.now()\n try { await kv.put(counterKey, value, putOptions) } finally {\n onTiming('counter', { readMs, writeMs: Date.now() - began, deferred })\n }\n },\n }\n : kv\n const result = await checkRateLimit(measured, key, limit, windowSeconds, waitUntil\n ? { waitUntil: (persist) => waitUntil(persist.catch((error: unknown) => onPersistError?.(error))) }\n : {})\n onTiming?.('decision', { readMs, decisionMs: Date.now() - startedAt, allowed: result.allowed, deferred })\n return result\n }\n\n return { setKV, check }\n}\n","/**\n * Rate-limit policy for FREE routes: authenticated, unmetered, compute-bearing\n * endpoints.\n *\n * Billing meters the chat turn. Everything deterministic a product adds beside\n * it — a planning recompute fired on every slider drag, a redline diff, a\n * deadline computation — runs unmetered, so nothing bounds how much worker CPU\n * one authenticated caller can spend. `checkRateLimit` is the primitive; this\n * is the policy around it, so a route declares a cost class instead of each one\n * inventing a key format, a budget, and a denial response.\n *\n * Three rules this enforces that a hand-rolled call site usually does not:\n *\n * 1. **Identity is required.** A missing subject is denied, never pooled into a\n * shared bucket and never quietly keyed by IP — a shared bucket makes one\n * heavy user throttle everyone, and an IP key makes one NAT do the same.\n * 2. **A limiter that throws denies.** KV `get`/`put` failures are transport\n * failures; treating them as \"allowed\" converts a KV outage into an\n * unbounded-compute hole, which is exactly when the limiter matters most.\n * 3. **The denial is a typed, correctable outcome** — reason, HTTP status and\n * `Retry-After` — so the caller answers the client rather than failing\n * opaquely or, worse, continuing.\n *\n * ```ts\n * export const action = withFreeRouteLimit(\n * {\n * route: 'tax.plan.recompute',\n * costClass: 'interactive',\n * kv: ({ context }) => context.cloudflare.env.RATE_LIMIT_KV,\n * identify: async ({ request }) => {\n * const session = await requireSession(request)\n * return { subject: session.userId, workspace: session.workspaceId }\n * },\n * },\n * async ({ request }) => Response.json(recompute(await request.json())),\n * )\n * ```\n */\n\nimport { checkRateLimit, type KvLike, type RateLimitResult } from './rate-limit'\n\n/** Requests allowed per identity inside a sliding window. */\nexport interface RateLimitBudget {\n limit: number\n windowSeconds: number\n}\n\n/**\n * How expensive one call is, which is what picks the default budget.\n *\n * - `interactive` — a control the user drags or types into, recomputed per\n * tick. Sized for sustained two-per-second interaction, so a real slider\n * never trips it and a script still stops.\n * - `compute` — a derivation the user triggers deliberately (recalculate a\n * plan, diff a document, compute a deadline set). The default.\n * - `heavy` — whole-document or whole-matter work measured in seconds of CPU.\n */\nexport type FreeRouteClass = 'interactive' | 'compute' | 'heavy'\n\n/** Default budget per cost class. A product overrides with an explicit\n * `budget` when it has measured its own route. */\nexport const FREE_ROUTE_BUDGETS: Readonly<Record<FreeRouteClass, RateLimitBudget>> = Object.freeze({\n interactive: Object.freeze({ limit: 120, windowSeconds: 60 }),\n compute: Object.freeze({ limit: 30, windowSeconds: 60 }),\n heavy: Object.freeze({ limit: 10, windowSeconds: 300 }),\n})\n\n/** A workspace's shared ceiling defaults to this many times one member's, so a\n * multi-seat tenant is bounded without a single active member tripping it. */\nexport const WORKSPACE_BUDGET_MULTIPLIER = 5\n\n/** Why a call was refused. Every value is a REFUSAL — there is no reason code\n * that lets the handler run. */\nexport type FreeRouteDenialReason =\n /** No authenticated subject. Not correctable by waiting. */\n | 'unidentified'\n /** The window is full for this subject or workspace. */\n | 'rate-limited'\n /** The limiter itself failed (KV read/write threw). Denied, not passed. */\n | 'limiter-unavailable'\n\n/** Which window refused the call. `null` when no window was consulted. */\nexport type FreeRouteDimension = 'subject' | 'workspace' | null\n\n/**\n * A correctable refusal: the caller maps `status` + `retryAfterSeconds` onto a\n * response (see {@link freeRouteLimitResponse}) so the client learns what to do\n * next. Carrying the limiter's own failure in `cause` keeps a KV outage\n * diagnosable instead of collapsing into a generic 429.\n */\nexport class FreeRouteLimitError extends Error {\n readonly reason: FreeRouteDenialReason\n readonly status: 401 | 429 | 503\n readonly retryAfterSeconds: number\n readonly dimension: FreeRouteDimension\n readonly route: string\n\n constructor(init: {\n reason: FreeRouteDenialReason\n status: 401 | 429 | 503\n retryAfterSeconds: number\n dimension: FreeRouteDimension\n route: string\n message: string\n cause?: unknown\n }) {\n super(init.message, init.cause === undefined ? undefined : { cause: init.cause })\n this.name = 'FreeRouteLimitError'\n this.reason = init.reason\n this.status = init.status\n this.retryAfterSeconds = init.retryAfterSeconds\n this.dimension = init.dimension\n this.route = init.route\n }\n}\n\n/** What remains of the binding window after an allowed call. */\nexport interface FreeRouteAllowance {\n /** Remaining calls in whichever window is tightest. */\n remaining: number\n /** Unix seconds at which that window resets. */\n resetAt: number\n /** The budget that window enforces. */\n budget: RateLimitBudget\n /** Which window is tightest — `subject` unless a workspace ceiling binds. */\n dimension: Exclude<FreeRouteDimension, null>\n}\n\n/** Typed outcome at the route boundary: an allowance, or a refusal that says\n * how to correct it. There is no third state and no silent pass. */\nexport type FreeRouteLimitOutcome =\n | { succeeded: true; value: FreeRouteAllowance }\n | { succeeded: false; error: FreeRouteLimitError }\n\nexport interface FreeRouteLimitInput {\n kv: KvLike\n /** Stable route name. Part of the key, so two routes never share a window. */\n route: string\n /** The authenticated subject (user id). Absent or blank ⇒ denied. */\n subject: string | null | undefined\n /** Tenant the call belongs to. When present, a second, wider window bounds\n * the workspace as a whole. */\n workspace?: string | null\n /** Cost class picking the default budget. Ignored when `budget` is given.\n * Default `'compute'`. */\n costClass?: FreeRouteClass\n budget?: RateLimitBudget\n /** Workspace ceiling. Defaults to the subject budget's limit multiplied by\n * {@link WORKSPACE_BUDGET_MULTIPLIER} over the same window. */\n workspaceBudget?: RateLimitBudget\n}\n\n/** Key components are percent-encoded so a route name or subject containing the\n * separator cannot be crafted to collide with another caller's window. */\nfunction limitKey(route: string, dimension: string, id: string): string {\n return `free:${encodeURIComponent(route)}:${dimension}:${encodeURIComponent(id)}`\n}\n\nfunction assertBudget(budget: RateLimitBudget, label: string): void {\n const valid =\n Number.isInteger(budget.limit) &&\n budget.limit >= 1 &&\n Number.isInteger(budget.windowSeconds) &&\n budget.windowSeconds >= 1\n if (!valid) {\n throw new Error(\n `${label} must be positive integers (got limit=${budget.limit}, windowSeconds=${budget.windowSeconds})`,\n )\n }\n}\n\nfunction secondsUntil(resetAt: number): number {\n return Math.max(1, resetAt - Math.floor(Date.now() / 1000))\n}\n\n/**\n * Run one window. A throw from KV becomes a `limiter-unavailable` refusal\n * rather than propagating — the caller must be able to answer 503 with a\n * `Retry-After` instead of the handler running or the route 500ing opaquely.\n */\nasync function runWindow(\n kv: KvLike,\n route: string,\n dimension: Exclude<FreeRouteDimension, null>,\n id: string,\n budget: RateLimitBudget,\n): Promise<{ succeeded: true; value: RateLimitResult } | { succeeded: false; error: FreeRouteLimitError }> {\n try {\n const value = await checkRateLimit(kv, limitKey(route, dimension, id), budget.limit, budget.windowSeconds)\n return { succeeded: true, value }\n } catch (cause) {\n return {\n succeeded: false,\n error: new FreeRouteLimitError({\n reason: 'limiter-unavailable',\n status: 503,\n retryAfterSeconds: Math.min(budget.windowSeconds, 30),\n dimension,\n route,\n message: `Rate limiter unavailable for route '${route}' — the request is refused rather than admitted unmetered`,\n cause,\n }),\n }\n }\n}\n\n/**\n * Decide whether one authenticated, unmetered call may run.\n *\n * Checks the subject's window first, then the workspace ceiling when a\n * workspace is supplied; the tighter of the two is what the allowance reports.\n * Every failure path returns a refusal — none returns an allowance.\n */\nexport async function checkFreeRouteLimit(input: FreeRouteLimitInput): Promise<FreeRouteLimitOutcome> {\n const budget = input.budget ?? FREE_ROUTE_BUDGETS[input.costClass ?? 'compute']\n assertBudget(budget, `Free-route budget for '${input.route}'`)\n const workspaceBudget =\n input.workspaceBudget ?? { limit: budget.limit * WORKSPACE_BUDGET_MULTIPLIER, windowSeconds: budget.windowSeconds }\n if (input.workspace) assertBudget(workspaceBudget, `Free-route workspace budget for '${input.route}'`)\n\n const subject = input.subject?.trim()\n if (!subject) {\n return {\n succeeded: false,\n error: new FreeRouteLimitError({\n reason: 'unidentified',\n status: 401,\n // Not correctable by waiting: the caller must authenticate.\n retryAfterSeconds: 0,\n dimension: null,\n route: input.route,\n message: `Route '${input.route}' is authenticated-only — an unidentified caller cannot be rate limited, so it is refused`,\n }),\n }\n }\n\n const subjectWindow = await runWindow(input.kv, input.route, 'subject', subject, budget)\n if (!subjectWindow.succeeded) return subjectWindow\n if (!subjectWindow.value.allowed) {\n return { succeeded: false, error: rateLimited(input.route, 'subject', subjectWindow.value) }\n }\n\n let tightest: { result: RateLimitResult; budget: RateLimitBudget; dimension: Exclude<FreeRouteDimension, null> } = {\n result: subjectWindow.value,\n budget,\n dimension: 'subject',\n }\n\n if (input.workspace) {\n const workspaceWindow = await runWindow(input.kv, input.route, 'workspace', input.workspace, workspaceBudget)\n if (!workspaceWindow.succeeded) return workspaceWindow\n if (!workspaceWindow.value.allowed) {\n return { succeeded: false, error: rateLimited(input.route, 'workspace', workspaceWindow.value) }\n }\n if (workspaceWindow.value.remaining < tightest.result.remaining) {\n tightest = { result: workspaceWindow.value, budget: workspaceBudget, dimension: 'workspace' }\n }\n }\n\n return {\n succeeded: true,\n value: {\n remaining: tightest.result.remaining,\n resetAt: tightest.result.resetAt,\n budget: tightest.budget,\n dimension: tightest.dimension,\n },\n }\n}\n\nfunction rateLimited(\n route: string,\n dimension: Exclude<FreeRouteDimension, null>,\n result: RateLimitResult,\n): FreeRouteLimitError {\n const retryAfterSeconds = secondsUntil(result.resetAt)\n return new FreeRouteLimitError({\n reason: 'rate-limited',\n status: 429,\n retryAfterSeconds,\n dimension,\n route,\n message: `Route '${route}' rate limit reached for this ${dimension}; retry in ${retryAfterSeconds}s`,\n })\n}\n\nexport interface FreeRouteLimitResponseOptions {\n /** Extra response headers (a product's security headers, CORS). */\n headers?: Record<string, string>\n /** Client-facing message. Defaults to the error's own message. */\n message?: string\n}\n\n/** The refusal as an HTTP response: the error's status, a JSON body carrying\n * the machine-readable `reason`, and `Retry-After` when waiting can fix it. */\nexport function freeRouteLimitResponse(\n error: FreeRouteLimitError,\n options: FreeRouteLimitResponseOptions = {},\n): Response {\n const headers = new Headers(options.headers)\n headers.set('Content-Type', 'application/json')\n if (error.retryAfterSeconds > 0) headers.set('Retry-After', String(error.retryAfterSeconds))\n return new Response(\n JSON.stringify({\n error: options.message ?? error.message,\n reason: error.reason,\n retryAfterSeconds: error.retryAfterSeconds,\n }),\n { status: error.status, headers },\n )\n}\n\n/** The authenticated caller behind one request. */\nexport interface FreeRouteIdentity {\n subject: string\n workspace?: string | null\n}\n\nexport interface WithFreeRouteLimitOptions<TArgs> {\n /** Stable route name; part of the key. */\n route: string\n costClass?: FreeRouteClass\n budget?: RateLimitBudget\n workspaceBudget?: RateLimitBudget\n /** The KV binding for this request. */\n kv: (args: TArgs) => KvLike\n /**\n * Resolve the authenticated caller. Return `null` for an unauthenticated\n * request — the wrapper then refuses with 401 and the handler never runs.\n *\n * A THROW here propagates: an auth lookup that failed is not the same as an\n * absent session, and the wrapper will not invent a status for it. The\n * handler still does not run, so the failure stays closed.\n */\n identify: (args: TArgs) => Promise<FreeRouteIdentity | null> | FreeRouteIdentity | null\n /** Build the refusal response. Defaults to {@link freeRouteLimitResponse}. */\n onDenied?: (error: FreeRouteLimitError, args: TArgs) => Response | Promise<Response>\n}\n\n/**\n * Wrap an authenticated, unmetered, compute-bearing route handler in its\n * budget. The limit is applied BEFORE the handler is entered — including\n * before the request body is read — so a refused call costs a KV read, not the\n * compute the route exists to do.\n *\n * The handler's own response is returned untouched: this never rewrites status,\n * body or headers on the success path, so it cannot break a streaming or\n * pre-built response.\n *\n * `TArgs` is the router's handler-argument object (react-router's\n * `ActionFunctionArgs`, or any single-object shape a product uses).\n */\nexport function withFreeRouteLimit<TArgs>(\n options: WithFreeRouteLimitOptions<TArgs>,\n handler: (args: TArgs) => Response | Promise<Response>,\n): (args: TArgs) => Promise<Response> {\n return async (args: TArgs): Promise<Response> => {\n const identity = await options.identify(args)\n const outcome = await checkFreeRouteLimit({\n kv: options.kv(args),\n route: options.route,\n subject: identity?.subject,\n workspace: identity?.workspace,\n costClass: options.costClass,\n budget: options.budget,\n workspaceBudget: options.workspaceBudget,\n })\n if (!outcome.succeeded) {\n return options.onDenied ? await options.onDenied(outcome.error, args) : freeRouteLimitResponse(outcome.error)\n }\n return await handler(args)\n }\n}\n","/**\n * Web-boundary utilities every agent app's routes hand-roll: JSON body parsing\n * + narrowing, request-context extraction (real client IP behind Cloudflare),\n * a KV-backed sliding-window rate limiter, the free-route budget policy built\n * on it, and security response headers. Pure mechanism — no DB, no domain. The\n * KV is a structural interface so this needs no `@cloudflare/workers-types`\n * dependency.\n */\n\nexport * from './rate-limit'\nexport * from './free-route-limit'\n\nexport type JsonObject = Record<string, unknown>\n\n/** Parse + object-narrow a Request or Response body. `[body, null]` on success, `[null,\n * errorResponse]` on a non-object body (callers `if (err) return err`). */\nexport async function parseJsonObjectBody(\n request: Pick<Request, 'headers' | 'body' | 'json'>,\n options: { maxBytes?: number } = {},\n): Promise<[JsonObject, null] | [null, Response]> {\n const maxBytes = options.maxBytes\n if (maxBytes !== undefined && (!Number.isSafeInteger(maxBytes) || maxBytes < 1))\n throw new TypeError('maxBytes must be a positive safe integer')\n let raw: unknown\n try {\n if (maxBytes === undefined) raw = await request.json()\n else {\n const length = request.headers.get('content-length')\n if (length !== null && Number(length) > maxBytes)\n return [null, Response.json({ error: 'JSON body is too large' }, { status: 413 })]\n if (!request.body) return [null, Response.json({ error: 'Invalid JSON body' }, { status: 400 })]\n const reader = request.body.getReader()\n const chunks: Uint8Array[] = []\n let size = 0\n try {\n for (;;) {\n const next = await reader.read()\n if (next.done) break\n size += next.value.byteLength\n if (size > maxBytes)\n return [null, Response.json({ error: 'JSON body is too large' }, { status: 413 })]\n chunks.push(next.value)\n }\n } finally {\n await reader.cancel().catch(() => undefined)\n }\n const bytes = new Uint8Array(size)\n let offset = 0\n for (const chunk of chunks) { bytes.set(chunk, offset); offset += chunk.byteLength }\n raw = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes))\n }\n } catch {\n return [null, Response.json({ error: 'Invalid JSON body' }, { status: 400 })]\n }\n if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {\n return [null, Response.json({ error: 'Body must be a JSON object' }, { status: 400 })]\n }\n return [raw as JsonObject, null]\n}\n\n/** Narrow one required string field, 400 if missing/empty. */\nexport function requireString(body: JsonObject, field: string): string | Response {\n const v = body[field]\n if (typeof v !== 'string' || v.length === 0) {\n return Response.json({ error: `Missing or non-string field: ${field}` }, { status: 400 })\n }\n return v\n}\n\n/** Define the context of a request including IP address, user agent, timestamp, and request ID */\nexport interface RequestContext {\n ipAddress: string\n userAgent: string\n timestamp: string\n requestId: string\n}\n\n/** Extract request context for audit trails. Uses `CF-Connecting-IP` for the\n * real client IP behind Cloudflare. */\nexport function extractRequestContext(request: Request): RequestContext {\n const ipAddress =\n request.headers.get('CF-Connecting-IP') ??\n request.headers.get('X-Forwarded-For')?.split(',')[0]?.trim() ??\n '0.0.0.0'\n return {\n ipAddress,\n userAgent: request.headers.get('User-Agent') ?? '',\n timestamp: new Date().toISOString(),\n requestId: crypto.randomUUID(),\n }\n}\n\n/** Define options for configuring cookie attributes and behavior */\nexport interface CookieOptions {\n name: string\n /** Default '/'. */\n path?: string\n /** Default true. */\n httpOnly?: boolean\n /** Adds the `Secure` attribute. Default false. */\n secure?: boolean\n /** Default 'Lax'. */\n sameSite?: 'Lax' | 'Strict' | 'None'\n maxAgeSeconds?: number\n}\n\n/** Serialize a Set-Cookie header value: `name=encodeURIComponent(value)` plus\n * attributes in Path / HttpOnly / SameSite / Max-Age / Secure order.\n * Throws on `SameSite=None` without `secure` — browsers silently drop that\n * combination, which would otherwise fail invisibly. */\nexport function serializeCookie(value: string, opts: CookieOptions): string {\n if (opts.sameSite === 'None' && !opts.secure) {\n throw new Error('SameSite=None cookies require secure: true (browsers reject them otherwise)')\n }\n const parts = [`${opts.name}=${encodeURIComponent(value)}`, `Path=${opts.path ?? '/'}`]\n if (opts.httpOnly !== false) parts.push('HttpOnly')\n parts.push(`SameSite=${opts.sameSite ?? 'Lax'}`)\n if (opts.maxAgeSeconds !== undefined) parts.push(`Max-Age=${opts.maxAgeSeconds}`)\n if (opts.secure) parts.push('Secure')\n return parts.join('; ')\n}\n\n/** Set-Cookie header value that deletes the cookie (empty value, Max-Age=0). */\nexport function clearCookieHeader(opts: Omit<CookieOptions, 'maxAgeSeconds'>): string {\n return serializeCookie('', { ...opts, maxAgeSeconds: 0 })\n}\n\n/** Read + decode one cookie from a Cookie request header; null when absent. */\nexport function readCookieValue(cookieHeader: string | null, name: string): string | null {\n if (!cookieHeader) return null\n for (const part of cookieHeader.split(/;\\s*/)) {\n const [cookieName, ...rest] = part.split('=')\n if (cookieName === name) {\n try {\n return decodeURIComponent(rest.join('='))\n } catch {\n return null\n }\n }\n }\n return null\n}\n\n/** Define options for configuring security-related HTTP headers including disclaimers and retention labels */\nexport interface SecurityHeaderOptions {\n /** Product disclaimer (e.g. \"AI-powered tool. Not legal advice.\"). Omitted if absent. */\n disclaimer?: string\n /** Data-retention label (e.g. \"7-years\"). Omitted if absent. */\n retention?: string\n /** Extra headers to set. */\n extra?: Record<string, string>\n}\n\n/** Canonical generic response headers used by {@link addSecurityHeaders}.\n * Exported so static-asset hosts can apply the same policy without copying\n * values that silently drift from Worker/API responses. */\nexport const STANDARD_SECURITY_HEADERS = Object.freeze({\n 'Strict-Transport-Security':\n 'max-age=31536000; includeSubDomains; preload',\n 'X-Content-Type-Options': 'nosniff',\n 'X-Frame-Options': 'SAMEORIGIN',\n 'Referrer-Policy': 'same-origin',\n 'X-XSS-Protection': '1; mode=block',\n} as const)\n\n/** Set standard security headers on a response (HSTS, nosniff, frame-options,\n * referrer-policy, XSS) + optional product disclaimer/retention. The security\n * set is generic; the disclaimer/retention are the product's. */\nexport function addSecurityHeaders(response: Response, opts: SecurityHeaderOptions = {}): Response {\n for (const [name, value] of Object.entries(STANDARD_SECURITY_HEADERS)) {\n response.headers.set(name, value)\n }\n if (opts.disclaimer) response.headers.set('X-AI-Disclaimer', opts.disclaimer)\n if (opts.retention) response.headers.set('X-Data-Retention', opts.retention)\n for (const [k, v] of Object.entries(opts.extra ?? {})) response.headers.set(k, v)\n return response\n}\n\n/** Local-sandbox / inline schemes a stored media reference must never use.\n * Reachable from neither a browser nor the product worker, and a `file:`/`data:`\n * url is the tell of an agent substituting local ffmpeg output for a real\n * provider artifact. `blob:` and `javascript:` are inert/active client schemes\n * with no server reachability. */\nconst REJECTED_MEDIA_SCHEMES = ['file:', 'data:', 'blob:', 'javascript:', 'vbscript:'] as const\n\n/**\n * Canonical media-reference boundary shared by every surface that persists a\n * media url (sequences clips, design-canvas image/video src). The ONE rule:\n * remote `http(s)` or a rooted `/api/` path are allowed; everything else is\n * rejected, with a named reason for known-bad local/inline schemes so the\n * thrown message is actionable for an LLM planner. The url is trimmed before\n * the scheme check so leading whitespace cannot smuggle a rejected scheme past\n * a naive `startsWith`.\n *\n * @param what - noun for the error message (e.g. 'media url', 'src').\n */\nexport function assertMediaUrl(url: string, what = 'media url'): void {\n const trimmed = url.trim()\n if (/^https?:\\/\\//i.test(trimmed)) return\n if (trimmed.startsWith('/api/')) return\n const shown = trimmed.length > 96 ? `${trimmed.slice(0, 96)}…` : trimmed\n const lower = trimmed.toLowerCase()\n if (\n REJECTED_MEDIA_SCHEMES.some((scheme) => lower.startsWith(scheme)) ||\n lower.startsWith('/tmp/') ||\n lower.startsWith('/home/')\n ) {\n throw new Error(`${what} must reference a provider http(s) URL or a rooted /api/ path, not a local sandbox file (${shown})`)\n }\n throw new Error(`${what} must be http(s) or a rooted /api/ path (${shown})`)\n}\n\nexport { isWorkspaceFileExportable } from './file-export'\n"],"mappings":"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","names":[]}
@@ -1,9 +1,6 @@
1
1
  import {
2
2
  createInteractionAnswerRoute
3
- } from "./chunk-KH4QSBNI.js";
4
- import {
5
- parseJsonObjectBody
6
- } from "./chunk-WP2GYFZ4.js";
3
+ } from "./chunk-KADVQCAS.js";
7
4
  import {
8
5
  noteMeasuredTurnFacts,
9
6
  readableTurnFailure
@@ -29,7 +26,7 @@ import {
29
26
  sandboxPromptRunner,
30
27
  streamSandboxPrompt,
31
28
  turnStorageBindings
32
- } from "./chunk-LMIP4OVR.js";
29
+ } from "./chunk-VOXKDO4T.js";
33
30
  import {
34
31
  redactErrorMessage
35
32
  } from "./chunk-MH74DY2I.js";
@@ -90,6 +87,9 @@ import {
90
87
  parseInteractionCancel,
91
88
  parseInteractionRequest
92
89
  } from "./chunk-6VQCFJWP.js";
90
+ import {
91
+ parseJsonObjectBody
92
+ } from "./chunk-ALIWB2P3.js";
93
93
  import {
94
94
  coalesceDeltas,
95
95
  createBufferedTurnTap,
@@ -3912,4 +3912,4 @@ export {
3912
3912
  createChatTurnRoutes,
3913
3913
  streamChatRouteAsSandboxEvents
3914
3914
  };
3915
- //# sourceMappingURL=chunk-K3A2YAIX.js.map
3915
+ //# sourceMappingURL=chunk-B5YYKYMM.js.map
@@ -3,7 +3,7 @@ import {
3
3
  applySceneOperations,
4
4
  requireElement,
5
5
  requirePage
6
- } from "./chunk-ZWJ3SZ2G.js";
6
+ } from "./chunk-VCG4DQC4.js";
7
7
 
8
8
  // src/design-canvas-react/engine/command-stack.ts
9
9
  var SCENE_COMMAND_HISTORY_LIMIT = 200;
@@ -601,4 +601,4 @@ export {
601
601
  bindSlotCommand,
602
602
  setDocumentTitleCommand
603
603
  };
604
- //# sourceMappingURL=chunk-BTKI4XMM.js.map
604
+ //# sourceMappingURL=chunk-CPWMBYLQ.js.map
@@ -1,3 +1,140 @@
1
+ import {
2
+ parseJsonObjectBody
3
+ } from "./chunk-ALIWB2P3.js";
4
+
5
+ // src/sandbox/recovery-original.ts
6
+ var MAX_RECOVERY_READ_BYTES = 256 * 1024;
7
+ var MAX_RECOVERY_READ_RECORDS = 256;
8
+ async function committedOriginal(recovery, options, now) {
9
+ const response = await options.client.fetch(`/v1/sandboxes/${encodeURIComponent(recovery.sandboxId)}`, { method: "GET" }, { timeoutMs: 5e3 });
10
+ if (!response.ok) {
11
+ await response.body?.cancel();
12
+ return void 0;
13
+ }
14
+ const [box, error] = await parseJsonObjectBody(response, { maxBytes: MAX_RECOVERY_READ_BYTES });
15
+ if (error) {
16
+ await response.body?.cancel().catch(() => void 0);
17
+ return void 0;
18
+ }
19
+ if (box.id !== recovery.sandboxId || box.status !== "stopped" || box.lifecycleState !== "suspended" || typeof box.name !== "string" || !box.name.trim()) return void 0;
20
+ const id = box.filesystemIncarnationId;
21
+ const provenance = box.filesystemIncarnationProvenance;
22
+ const readiness = box.filesystemIncarnationReadiness;
23
+ const absent = id === void 0 && provenance === void 0 && readiness === void 0;
24
+ if (!absent && (typeof id !== "string" || !id.trim() || provenance !== "fresh" && provenance !== "restored" && provenance !== "unknown" || readiness !== "ready")) return void 0;
25
+ const suspendedAt = typeof box.suspendedAt === "string" ? Date.parse(box.suspendedAt) : NaN;
26
+ if (!Number.isFinite(suspendedAt) || suspendedAt > now) return void 0;
27
+ if (!options.ownsOriginalBoxKey({ workspaceId: options.workspaceId, sandboxId: recovery.sandboxId, boxKey: box.name })) return void 0;
28
+ return { boxKey: box.name, suspendedAt, incarnationId: typeof id === "string" ? id : void 0 };
29
+ }
30
+ function record(value) {
31
+ return value !== null && typeof value === "object" && !Array.isArray(value);
32
+ }
33
+ async function inspectReplacement(client, boxKey) {
34
+ const response = await client.fetch("/v1/sandboxes", { method: "GET" }, { timeoutMs: 5e3 });
35
+ if (!response.ok) {
36
+ await response.body?.cancel();
37
+ return "unverified";
38
+ }
39
+ const [body, error] = await parseJsonObjectBody(response, { maxBytes: MAX_RECOVERY_READ_BYTES });
40
+ if (error) {
41
+ await response.body?.cancel().catch(() => void 0);
42
+ return "unverified";
43
+ }
44
+ const entries = body.sandboxes;
45
+ if (!Array.isArray(entries) || entries.length > MAX_RECOVERY_READ_RECORDS) return "unverified";
46
+ const ids = /* @__PURE__ */ new Set();
47
+ for (const entry of entries) {
48
+ if (!record(entry) || typeof entry.id !== "string" || !entry.id.trim() || typeof entry.name !== "string" || !entry.name.trim() || ids.has(entry.id)) return "unverified";
49
+ ids.add(entry.id);
50
+ if (entry.name === boxKey) return "present";
51
+ }
52
+ if (body.listingComplete !== true || Object.keys(body).some((key) => !["sandboxes", "listingComplete", "total", "count"].includes(key)) || body.total !== void 0 && body.total !== entries.length || body.count !== void 0 && body.count !== entries.length) return "unverified";
53
+ return "clear";
54
+ }
55
+ function finalSnapshot(body, recovery, original, now) {
56
+ const entries = body.snapshots;
57
+ if (!Array.isArray(entries) || entries.length === 0 || entries.length > MAX_RECOVERY_READ_RECORDS) return void 0;
58
+ if (body.success !== void 0 && body.success !== true) return void 0;
59
+ if (body.source !== void 0 && body.source !== "primary" && body.source !== "customer") return void 0;
60
+ if (Object.keys(body).some((key) => !["snapshots", "total", "count", "success", "source"].includes(key))) return void 0;
61
+ if (body.total !== void 0 && body.total !== entries.length) return void 0;
62
+ if (body.count !== void 0 && body.count !== entries.length) return void 0;
63
+ const previous = recovery.snapshot.snapshot;
64
+ const previousAt = previous && Date.parse(previous.createdAt);
65
+ if (!previous || previous.fromSandboxId !== recovery.sandboxId || previousAt === void 0 || !Number.isFinite(previousAt)) return void 0;
66
+ let latest;
67
+ const ids = /* @__PURE__ */ new Set();
68
+ for (const entry of entries) {
69
+ if (!record(entry)) return void 0;
70
+ const id = entry.snapshotId ?? entry.id;
71
+ const owner = entry.sandboxId ?? entry.projectRef;
72
+ const createdAt = typeof entry.createdAt === "string" ? Date.parse(entry.createdAt) : NaN;
73
+ if (typeof id !== "string" || !id.trim() || ids.has(id) || owner !== void 0 && owner !== recovery.sandboxId || entry.sandboxId !== void 0 && entry.sandboxId !== recovery.sandboxId || entry.projectRef !== void 0 && entry.projectRef !== recovery.sandboxId || !Number.isFinite(createdAt) || createdAt > now || !Array.isArray(entry.tags) || !entry.tags.every((tag) => typeof tag === "string")) return void 0;
74
+ ids.add(id);
75
+ const final = entry.tags.includes("pre-suspend") && entry.remoteSync === "synced" && createdAt >= original.suspendedAt && createdAt > previousAt && now - createdAt <= WORKSPACE_SANDBOX_SNAPSHOT_MAX_AGE_MS;
76
+ if (!latest || createdAt > latest.createdAt) latest = { snapshotId: id, createdAt, final };
77
+ else if (createdAt === latest.createdAt && id !== latest.snapshotId) return void 0;
78
+ }
79
+ return latest?.final ? latest : void 0;
80
+ }
81
+ async function reconcileWorkspaceSandboxOriginal(store, options) {
82
+ const current = await store.read(options.workspaceId);
83
+ const result = (status2, reason) => ({ status: status2, recovery: current, reason });
84
+ if (!current || current.code !== WORKSPACE_SANDBOX_MISSING) return result("unchanged");
85
+ if (current.action === "original_recovered") return result("recovered");
86
+ if (current.action !== "missing_replacement_started") return result("unchanged");
87
+ if (current.replacementSandboxId) return result("conflict", "replacement_already_bound");
88
+ if (!current.replacementBoxKey?.trim() || !store.compareAndSet || !store.insertIfAbsent) return result("unverified", "atomic_transition_required");
89
+ const now = options.now ?? Date.now();
90
+ if (!Number.isFinite(now)) return result("unverified", "invalid_clock");
91
+ let first;
92
+ let last;
93
+ let snapshot;
94
+ try {
95
+ const replacement = await inspectReplacement(options.client, current.replacementBoxKey);
96
+ if (replacement === "present") return result("conflict", "replacement_physically_present");
97
+ if (replacement !== "clear") return result("unverified", "replacement_listing_unverified");
98
+ first = await committedOriginal(current, options, now);
99
+ if (!first || first.boxKey === current.replacementBoxKey) return result("unverified", "original_not_committed_or_owned");
100
+ const response = await options.client.fetch(`/v1/sandboxes/${encodeURIComponent(current.sandboxId)}/snapshots`, { method: "GET" }, { timeoutMs: 5e3 });
101
+ if (!response.ok) {
102
+ await response.body?.cancel();
103
+ return result("unverified", "snapshot_read_refused");
104
+ }
105
+ const [body, error] = await parseJsonObjectBody(response, { maxBytes: MAX_RECOVERY_READ_BYTES });
106
+ if (error) {
107
+ await response.body?.cancel().catch(() => void 0);
108
+ return result("unverified", "snapshot_body_unreadable");
109
+ }
110
+ snapshot = finalSnapshot(body, current, first, now);
111
+ if (!snapshot) return result("unverified", "final_snapshot_unverified");
112
+ last = await committedOriginal(current, options, now);
113
+ const replacementAfter = await inspectReplacement(options.client, current.replacementBoxKey);
114
+ if (replacementAfter === "present") return result("conflict", "replacement_physically_present");
115
+ if (replacementAfter !== "clear") return result("unverified", "replacement_listing_unverified");
116
+ } catch {
117
+ return result("unverified", "original_read_failed");
118
+ }
119
+ if (!last || last.boxKey !== first.boxKey || last.suspendedAt !== first.suspendedAt || last.incarnationId !== first.incarnationId) return result("unverified", "original_changed_during_read");
120
+ const next = {
121
+ ...current,
122
+ action: "original_recovered",
123
+ originalBoxKey: first.boxKey,
124
+ // Keep replacementBoxKey as invalidation evidence. The action no longer
125
+ // chooses it; an unknown in-flight remote create is not called absent.
126
+ originalRecovered: {
127
+ snapshotId: snapshot.snapshotId,
128
+ snapshotCreatedAt: new Date(snapshot.createdAt).toISOString(),
129
+ suspendedAt: new Date(first.suspendedAt).toISOString(),
130
+ ...first.incarnationId ? { filesystemIncarnationId: first.incarnationId } : {},
131
+ verifiedAt: new Date(now).toISOString()
132
+ }
133
+ };
134
+ if (!await store.compareAndSet(options.workspaceId, current, next)) return result("conflict", "recovery_changed");
135
+ return { status: "recovered", recovery: next };
136
+ }
137
+
1
138
  // src/sandbox/recovery.ts
2
139
  var EGRESS_PROXY_RECOVERY_REQUIRED = "EGRESS_PROXY_RECOVERY_REQUIRED";
3
140
  var EGRESS_PROXY_RECOVERY_PHASE = "egress_proxy_recovery";
@@ -12,6 +149,7 @@ var CODES = {
12
149
  [WORKSPACE_SANDBOX_UNRECOVERABLE]: { snapshotUsable: false }
13
150
  };
14
151
  var ACTIONS = {
152
+ original_recovered: { replacementChosen: false },
15
153
  confirmation_required: { replacementChosen: false, canDecide: true },
16
154
  deletion_declined: { replacementChosen: false, canDecide: true },
17
155
  replacement_authorized: { replacementChosen: false },
@@ -90,7 +228,7 @@ function isWorkspaceSandboxRecoveryCode(value) {
90
228
  }
91
229
  function isWorkspaceSandboxRecoveryState(value) {
92
230
  if (!isRecord(value)) return false;
93
- return isWorkspaceSandboxRecoveryCode(value.code) && !!asNonEmptyString(value.sandboxId) && !!asNonEmptyString(value.detectedAt) && isSnapshotAssessment(value.snapshot) && isWorkspaceSandboxRecoveryAction(value.action);
231
+ return isWorkspaceSandboxRecoveryCode(value.code) && !!asNonEmptyString(value.sandboxId) && !!asNonEmptyString(value.detectedAt) && isSnapshotAssessment(value.snapshot) && isWorkspaceSandboxRecoveryAction(value.action) && (value.action !== "original_recovered" || !!asNonEmptyString(value.originalBoxKey) && isRecord(value.originalRecovered) && !!asNonEmptyString(value.originalRecovered.snapshotId) && typeof value.originalRecovered.snapshotCreatedAt === "string" && Number.isFinite(Date.parse(value.originalRecovered.snapshotCreatedAt)) && typeof value.originalRecovered.suspendedAt === "string" && Number.isFinite(Date.parse(value.originalRecovered.suspendedAt)) && typeof value.originalRecovered.verifiedAt === "string" && Number.isFinite(Date.parse(value.originalRecovered.verifiedAt)));
94
232
  }
95
233
  function workspaceSandboxRecoveryFromError(error) {
96
234
  for (const current of errorChain(error)) {
@@ -100,6 +238,9 @@ function workspaceSandboxRecoveryFromError(error) {
100
238
  return void 0;
101
239
  }
102
240
  function workspaceSandboxRecoveryMessage(recovery) {
241
+ if (recovery.action === "original_recovered") {
242
+ return "The original sandbox was recovered with its committed saved work. The pending replacement is no longer selected.";
243
+ }
103
244
  if (recovery.code === WORKSPACE_SANDBOX_MISSING) {
104
245
  return "The sandbox behind this workspace no longer exists on the platform. A replacement is being provisioned and your saved work is restored into it.";
105
246
  }
@@ -119,6 +260,7 @@ function workspaceSandboxRecoveryMessage(recovery) {
119
260
  return "Sandbox recovery is required before chat can continue. The stopped sandbox has not been deleted.";
120
261
  }
121
262
  function workspaceSandboxRecoveryRecommendedActions(recovery) {
263
+ if (recovery.action === "original_recovered") return ["Continue with the recovered original sandbox."];
122
264
  if (!CODES[recovery.code].snapshotUsable) {
123
265
  return ["Retry after the replacement sandbox finishes provisioning."];
124
266
  }
@@ -144,11 +286,12 @@ function workspaceSandboxRecoveryDiagnostic(recovery) {
144
286
  };
145
287
  }
146
288
  function preferredWorkspaceSandboxRecoveryBoxKey(recovery) {
289
+ if (recovery?.action === "original_recovered") return recovery.originalBoxKey;
147
290
  if (!recovery?.replacementBoxKey) return void 0;
148
291
  return ACTIONS[recovery.action].replacementChosen ? recovery.replacementBoxKey : void 0;
149
292
  }
150
293
  function shouldRestoreWorkspaceSandboxRecovery(recovery) {
151
- if (!recovery) return false;
294
+ if (!recovery || recovery.action === "original_recovered") return false;
152
295
  if (!CODES[recovery.code].snapshotUsable) return false;
153
296
  return !!preferredWorkspaceSandboxRecoveryBoxKey(recovery) && recovery.snapshot.availability === "available";
154
297
  }
@@ -164,7 +307,21 @@ function createWorkspaceSandboxRecoveryManager(store) {
164
307
  }
165
308
  return {
166
309
  read: (workspaceId) => store.read(workspaceId),
167
- record: (workspaceId, recovery) => store.write(workspaceId, recovery),
310
+ async record(workspaceId, recovery) {
311
+ const current = await store.read(workspaceId);
312
+ if (current) {
313
+ const currentPolicy = ACTIONS[current.action];
314
+ if (current.sandboxId === recovery.sandboxId && recovery.code === WORKSPACE_SANDBOX_MISSING && (current.action === "original_recovered" || currentPolicy.replacementChosen && !("completedAs" in currentPolicy)))
315
+ throw new Error("Sandbox recovery changed; reload before recording a replacement");
316
+ await transition(workspaceId, current, recovery);
317
+ } else if (store.insertIfAbsent) {
318
+ if (!await store.insertIfAbsent(workspaceId, recovery))
319
+ throw new Error("Sandbox recovery changed; reload before recording a replacement");
320
+ } else {
321
+ await store.write(workspaceId, recovery);
322
+ }
323
+ },
324
+ reconcileOriginal: (args) => reconcileWorkspaceSandboxOriginal(store, args),
168
325
  async decide({ workspaceId, sandboxId, decision, replacementBoxKey }) {
169
326
  const current = await store.read(workspaceId);
170
327
  if (!current || current.sandboxId !== sandboxId || !("canDecide" in ACTIONS[current.action])) return void 0;
@@ -183,6 +340,7 @@ function createWorkspaceSandboxRecoveryManager(store) {
183
340
  if (replacementBoxKey !== void 0 && current.replacementBoxKey !== replacementBoxKey) return void 0;
184
341
  const policy = ACTIONS[current.action];
185
342
  if (!("completedAs" in policy)) return void 0;
343
+ if (asNonEmptyString(current.replacementSandboxId) && current.replacementSandboxId !== replacementSandboxId) return void 0;
186
344
  if (!asNonEmptyString(replacementSandboxId)) throw new Error("A replacement sandbox id is required");
187
345
  return transition(workspaceId, current, { ...current, action: policy.completedAs, replacementSandboxId });
188
346
  }
@@ -437,15 +595,15 @@ var SANDBOX_TRANSIENT_DEADLINE_MS = 15 * 6e4;
437
595
  function sandboxTransientBackoffMs(attempt) {
438
596
  return Math.min(6e4, 5e3 * 2 ** Math.max(0, attempt - 1));
439
597
  }
440
- function record(value) {
598
+ function record2(value) {
441
599
  return value !== null && typeof value === "object" ? value : void 0;
442
600
  }
443
601
  function causeChain(error) {
444
602
  const chain = [];
445
- let current = record(error);
603
+ let current = record2(error);
446
604
  for (let depth = 0; current && depth < 8 && !chain.includes(current); depth += 1) {
447
605
  chain.push(current);
448
- current = record(current.cause);
606
+ current = record2(current.cause);
449
607
  }
450
608
  return chain;
451
609
  }
@@ -577,4 +735,4 @@ export {
577
735
  SandboxTransientDeadlineError,
578
736
  retrySandboxTransient
579
737
  };
580
- //# sourceMappingURL=chunk-UJYEBQMS.js.map
738
+ //# sourceMappingURL=chunk-H4JL74GP.js.map