@agent-native/core 0.81.3 → 0.82.0

package/dist/file-upload/actions/upload-image.d.ts

@@ -3,18 +3,18 @@ declare const _default: import("../../action.js").ActionDefinition<{
     url?: string;
     filename?: string;
 }, {
-    id?: undefined;
     error: string;
     configured?: undefined;
     connectPath?: undefined;
     url?: undefined;
+    id?: undefined;
     provider?: undefined;
 } | {
-    id?: undefined;
     error: string;
     configured: boolean;
     connectPath: string;
     url?: undefined;
+    id?: undefined;
     provider?: undefined;
 } | {
     error?: undefined;

package/dist/file-upload/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/file-upload/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AAuJpB;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBA4DvC,CAAC"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/file-upload/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,YAAY,CAAC;AA4LpB;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAuLvC,CAAC"}

package/dist/file-upload/builder.js

@@ -25,28 +25,12 @@ async function assertOk(res, label) {
     }
 }
 async function uploadLargeFileViaSignedUrl(input, privateKey, bareMimeType, bytes) {
-    const host = builderUploadHost();
-    const authHeader = { Authorization: `Bearer ${privateKey}` };
     const name = input.filename ?? "upload";
     const mb = (bytes.byteLength / (1024 * 1024)).toFixed(1);
     console.log(`[builder-upload] large-file path: ${name} ${mb}MB ${bareMimeType}`);
     // Step 1 — request a signed URL.
     console.log(`[builder-upload] step 1: requesting signed URL`);
-    const step1Res = await fetchWithTimeout(new URL("/api/v1/upload/signed-url", host).toString(), {
-        method: "POST",
-        headers: { ...authHeader, "Content-Type": "application/json" },
-        body: JSON.stringify({
-            fileName: name,
-            contentType: bareMimeType,
-            size: bytes.byteLength,
-        }),
-    });
-    await assertOk(step1Res, "Builder.io signed-URL request failed");
-    const step1Json = (await step1Res.json());
-    const { uploadUrl, assetId, requiredHeaders } = step1Json;
-    if (!uploadUrl || !assetId || !requiredHeaders) {
-        throw new Error(`Builder.io signed-URL response missing required fields: ${JSON.stringify(Object.keys(step1Json))}`);
-    }
+    const { uploadUrl, assetId, requiredHeaders } = await requestBuilderSignedUrl(privateKey, name, bareMimeType, bytes.byteLength);
     console.log(`[builder-upload] step 1 ok: assetId=${assetId}`);
     // Step 2 — PUT bytes directly to GCS. Only requiredHeaders; no Authorization
     // (signed URL carries its own auth — extra signed headers break the signature).
@@ -60,17 +44,52 @@ async function uploadLargeFileViaSignedUrl(input, privateKey, bareMimeType, byte
     console.log(`[builder-upload] step 2 ok [${assetId}]: GCS ${step2Res.status} etag=${step2Res.headers.get("etag") ?? "none"}`);
     // Step 3 — register the asset and get the CDN URL.
     console.log(`[builder-upload] step 3: registering asset - ${assetId}, ${input.filename}`);
-    const step3Res = await fetchWithTimeout(new URL("/api/v1/upload/complete", host).toString(), {
+    const { url, id } = await completeBuilderUpload(privateKey, assetId, input.filename);
+    console.log(`[builder-upload] done [${assetId}]: ${url}`);
+    return { url, id, provider: "builder" };
+}
+async function requestBuilderSignedUrl(privateKey, filename, mimeType, size, resumable = false) {
+    const host = builderUploadHost();
+    const url = new URL("/api/v1/upload/signed-url", host);
+    const res = await fetchWithTimeout(url.toString(), {
         method: "POST",
-        headers: { ...authHeader, "Content-Type": "application/json" },
-        body: JSON.stringify({ assetId, name: input.filename }),
+        headers: {
+            Authorization: `Bearer ${privateKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            fileName: filename,
+            contentType: mimeType,
+            size,
+            resumable,
+        }),
+    });
+    await assertOk(res, "Builder.io signed-URL request failed");
+    const json = (await res.json());
+    if (!json.uploadUrl || !json.assetId || !json.requiredHeaders) {
+        throw new Error(`Builder.io signed-URL response missing required fields: ${JSON.stringify(Object.keys(json))}`);
+    }
+    return {
+        uploadUrl: json.uploadUrl,
+        assetId: json.assetId,
+        requiredHeaders: json.requiredHeaders,
+    };
+}
+async function completeBuilderUpload(privateKey, assetId, filename) {
+    const host = builderUploadHost();
+    const res = await fetchWithTimeout(new URL("/api/v1/upload/complete", host).toString(), {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${privateKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ assetId, name: filename }),
     });
-    await assertOk(step3Res, "Builder.io upload complete failed");
-    const { url, id } = (await step3Res.json());
-    if (!url)
+    await assertOk(res, "Builder.io upload complete failed");
+    const json = (await res.json());
+    if (!json.url)
         throw new Error("Builder.io upload/complete returned no URL");
-    console.log(`[builder-upload] done [${assetId}]: ${url}`);
-    return { url, id, provider: "builder" };
+    return { url: json.url, id: json.id };
 }
 // Retry transient 5xx once with backoff. Builder.io's upload service
 // occasionally returns a bodyless 500 ("Internal Error") on the first
@@ -151,5 +170,98 @@ export const builderFileUploadProvider = {
         console.log(`[builder-upload] done: ${json.url}`);
         return { url: json.url, id: json.id, provider: "builder" };
     },
+    resumable: {
+        async startSession(filename, mimeType, maxBytes) {
+            const { resolveBuilderPrivateKey } = await import("../server/credential-provider.js");
+            const privateKey = await resolveBuilderPrivateKey();
+            if (!privateKey)
+                throw new Error("BUILDER_PRIVATE_KEY is not set");
+            console.log(`[builder-resumable] starting session: ${filename} ${mimeType} ${maxBytes} bytes`);
+            const { uploadUrl, assetId, requiredHeaders } = await requestBuilderSignedUrl(privateKey, filename, mimeType, maxBytes, true);
+            console.log(`[builder-resumable] session step 1 ok: assetId=${assetId}`);
+            const initHeaders = {
+                "Content-Type": mimeType,
+                "x-goog-resumable": "start",
+            };
+            const contentLengthRange = requiredHeaders?.["x-goog-content-length-range"];
+            if (contentLengthRange)
+                initHeaders["x-goog-content-length-range"] = contentLengthRange;
+            console.log(`[builder-resumable] session step 2: initiating GCS session`);
+            const initRes = await fetchWithTimeout(uploadUrl, {
+                method: "POST",
+                headers: initHeaders,
+                body: new Uint8Array(0),
+            });
+            if (!initRes.ok) {
+                const body = await initRes.text().catch(() => "");
+                throw new Error(`GCS resumable session initiation failed (${initRes.status}): ${body}`);
+            }
+            const sessionUri = initRes.headers.get("location");
+            if (!sessionUri)
+                throw new Error("GCS did not return a Location header for the resumable session");
+            console.log(`[builder-resumable] session ready: assetId=${assetId}`);
+            return {
+                sessionId: sessionUri,
+                meta: { assetId, filename, mimeType },
+            };
+        },
+        async relayChunk(session, contentRange, bytes, options) {
+            const sessionUri = session.sessionId;
+            const MAX_ATTEMPTS = 4;
+            const RETRYABLE = new Set([408, 429, 500, 502, 503, 504]);
+            const delayMs = (attempt) => Math.min(2000, 300 * 2 ** (attempt - 1));
+            let lastError = null;
+            for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+                try {
+                    const headers = {
+                        "Content-Range": contentRange,
+                    };
+                    if (options?.mimeType)
+                        headers["Content-Type"] = options.mimeType;
+                    const res = await fetch(sessionUri, {
+                        method: "PUT",
+                        headers,
+                        body: bytes,
+                    });
+                    if (res.status === 308 || res.ok)
+                        return {
+                            ok: true,
+                            status: res.status,
+                        };
+                    if (RETRYABLE.has(res.status) && attempt < MAX_ATTEMPTS) {
+                        await res.text().catch(() => "");
+                        console.warn(`[builder-resumable] transient ${res.status} on attempt ${attempt}, retrying`);
+                        await new Promise((r) => setTimeout(r, delayMs(attempt)));
+                        continue;
+                    }
+                    return {
+                        ok: false,
+                        status: res.status,
+                    };
+                }
+                catch (err) {
+                    lastError = err;
+                    if (attempt >= MAX_ATTEMPTS)
+                        break;
+                    console.warn(`[builder-resumable] network error on attempt ${attempt}:`, err instanceof Error ? err.message : String(err));
+                    await new Promise((r) => setTimeout(r, delayMs(attempt)));
+                }
+            }
+            throw lastError instanceof Error
+                ? lastError
+                : new Error("GCS PUT failed after retries");
+        },
+        async completeSession(session, filename) {
+            const { resolveBuilderPrivateKey } = await import("../server/credential-provider.js");
+            const privateKey = await resolveBuilderPrivateKey();
+            if (!privateKey)
+                throw new Error("BUILDER_PRIVATE_KEY is not set");
+            const assetId = session.meta.assetId;
+            console.log(`[builder-resumable] completing upload: assetId=${assetId}`);
+            const { url } = await completeBuilderUpload(privateKey, assetId, filename);
+            console.log(`[builder-resumable] upload complete: ${url}`);
+            return url;
+        },
+    },
 };
 //# sourceMappingURL=builder.js.map

package/dist/file-upload/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/file-upload/builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  FileUploadProvider,\n  FileUploadInput,\n  FileUploadResult,\n} from \"./types.js\";\n\nconst DEFAULT_BUILDER_APP_HOST = \"https://builder.io\";\n\n/** Files larger than this are routed through the GCS signed-URL flow. */\nconst LARGE_FILE_THRESHOLD_BYTES = 30 * 1024 * 1024;\nconst UPLOAD_TIMEOUT_MS = 120_000;\nconst SMALL_FILE_RETRY_DELAYS_MS = [600, 1800];\n\nfunction builderUploadHost(): string {\n  return (\n    process.env.BUILDER_APP_HOST ||\n    process.env.BUILDER_PUBLIC_APP_HOST ||\n    DEFAULT_BUILDER_APP_HOST\n  );\n}\n\nfunction makeBody(bytes: Uint8Array, mimeType: string): BodyInit {\n  return typeof Blob !== \"undefined\"\n    ? new Blob([bytes as unknown as BlobPart], { type: mimeType })\n    : (bytes as unknown as BodyInit);\n}\n\nfunction fetchWithTimeout(url: string, init: RequestInit): Promise<Response> {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), UPLOAD_TIMEOUT_MS);\n  return fetch(url, { ...init, signal: controller.signal }).finally(() =>\n    clearTimeout(timer),\n  );\n}\n\nasync function assertOk(res: Response, label: string): Promise<void> {\n  if (!res.ok) {\n    const body = await res.text().catch(() => \"\");\n    throw new Error(`${label} (${res.status}): ${body || res.statusText}`);\n  }\n}\n\nasync function uploadLargeFileViaSignedUrl(\n  input: FileUploadInput,\n  privateKey: string,\n  bareMimeType: string,\n  bytes: Uint8Array,\n): Promise<FileUploadResult> {\n  const host = builderUploadHost();\n  const authHeader = { Authorization: `Bearer ${privateKey}` };\n  const name = input.filename ?? \"upload\";\n  const mb = (bytes.byteLength / (1024 * 1024)).toFixed(1);\n\n  console.log(\n    `[builder-upload] large-file path: ${name} ${mb}MB ${bareMimeType}`,\n  );\n\n  // Step 1 — request a signed URL.\n  console.log(`[builder-upload] step 1: requesting signed URL`);\n  const step1Res = await fetchWithTimeout(\n    new URL(\"/api/v1/upload/signed-url\", host).toString(),\n    {\n      method: \"POST\",\n      headers: { ...authHeader, \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        fileName: name,\n        contentType: bareMimeType,\n        size: bytes.byteLength,\n      }),\n    },\n  );\n  await assertOk(step1Res, \"Builder.io signed-URL request failed\");\n\n  const step1Json = (await step1Res.json()) as {\n    uploadUrl?: string;\n    assetId?: string;\n    expiresAt?: string;\n    requiredHeaders?: Record<string, string>;\n  };\n  const { uploadUrl, assetId, requiredHeaders } = step1Json;\n  if (!uploadUrl || !assetId || !requiredHeaders) {\n    throw new Error(\n      `Builder.io signed-URL response missing required fields: ${JSON.stringify(Object.keys(step1Json))}`,\n    );\n  }\n  console.log(`[builder-upload] step 1 ok: assetId=${assetId}`);\n\n  // Step 2 — PUT bytes directly to GCS. Only requiredHeaders; no Authorization\n  // (signed URL carries its own auth — extra signed headers break the signature).\n  console.log(`[builder-upload] step 2 [${assetId}]: PUT ${mb}MB to GCS`);\n  const step2Res = await fetchWithTimeout(uploadUrl, {\n    method: \"PUT\",\n    headers: requiredHeaders,\n    body: makeBody(bytes, bareMimeType),\n  });\n  await assertOk(step2Res, \"GCS upload failed\");\n  console.log(\n    `[builder-upload] step 2 ok [${assetId}]: GCS ${step2Res.status} etag=${step2Res.headers.get(\"etag\") ?? \"none\"}`,\n  );\n\n  // Step 3 — register the asset and get the CDN URL.\n  console.log(\n    `[builder-upload] step 3: registering asset - ${assetId}, ${input.filename}`,\n  );\n  const step3Res = await fetchWithTimeout(\n    new URL(\"/api/v1/upload/complete\", host).toString(),\n    {\n      method: \"POST\",\n      headers: { ...authHeader, \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ assetId, name: input.filename }),\n    },\n  );\n  await assertOk(step3Res, \"Builder.io upload complete failed\");\n\n  const { url, id } = (await step3Res.json()) as { url?: string; id?: string };\n  if (!url) throw new Error(\"Builder.io upload/complete returned no URL\");\n\n  console.log(`[builder-upload] done [${assetId}]: ${url}`);\n  return { url, id, provider: \"builder\" };\n}\n\n// Retry transient 5xx once with backoff. Builder.io's upload service\n// occasionally returns a bodyless 500 (\"Internal Error\") on the first\n// attempt — usually GCS write hiccups that succeed on retry.\nasync function uploadSmallFile(url: URL, init: RequestInit): Promise<Response> {\n  let response: Response | null = null;\n  let lastErrorBody = \"\";\n\n  for (\n    let attempt = 0;\n    attempt <= SMALL_FILE_RETRY_DELAYS_MS.length;\n    attempt++\n  ) {\n    const retryDelay = SMALL_FILE_RETRY_DELAYS_MS[attempt]; // undefined on last attempt\n    try {\n      response = await fetchWithTimeout(url.toString(), init);\n    } catch (err) {\n      if (!retryDelay) throw err;\n      await new Promise((r) => setTimeout(r, retryDelay));\n      continue;\n    }\n    if (response.ok) return response;\n    lastErrorBody = await response.text().catch(() => \"\");\n    const isTransient = response.status >= 500 && response.status !== 501;\n    if (!isTransient || !retryDelay) break;\n    await new Promise((r) => setTimeout(r, retryDelay));\n  }\n\n  const status = response?.status ?? 0;\n  const statusText = response?.statusText ?? \"no response\";\n  throw new Error(\n    `Builder.io upload failed (${status}): ${lastErrorBody || statusText}`,\n  );\n}\n\n/**\n * Built-in Builder.io file upload provider.\n * Uses the same BUILDER_PRIVATE_KEY as the browser/background-agent flows,\n * so connecting Builder once (via the sidebar \"Connect Builder\" action)\n * automatically enables file uploads.\n *\n * Upload API: https://www.builder.io/c/docs/upload-api\n */\nexport const builderFileUploadProvider: FileUploadProvider = {\n  id: \"builder\",\n  name: \"Builder.io\",\n  isConfigured: () => !!process.env.BUILDER_PRIVATE_KEY,\n  upload: async ({ data, filename, mimeType }: FileUploadInput) => {\n    const { resolveBuilderPrivateKey } =\n      await import(\"../server/credential-provider.js\");\n    const privateKey = await resolveBuilderPrivateKey();\n    if (!privateKey) {\n      throw new Error(\"BUILDER_PRIVATE_KEY is not set\");\n    }\n\n    // Strip any media-type parameters (e.g. `;codecs=avc1,opus` from\n    // MediaRecorder blobs) — Builder's upload API parses the body as raw\n    // binary only when Content-Type is a bare MIME type. A parameterized\n    // Content-Type falls through to the multipart/base64 paths which look\n    // for an `image` field, and returns \"No image specified\" when it\n    // doesn't find one.\n    const bareMimeType = (mimeType || \"application/octet-stream\")\n      .split(\";\")[0]\n      .trim();\n\n    const bytes =\n      data instanceof Uint8Array ? data : new Uint8Array(data as any);\n    const mb = (bytes.byteLength / (1024 * 1024)).toFixed(1);\n\n    if (bytes.byteLength > LARGE_FILE_THRESHOLD_BYTES) {\n      return uploadLargeFileViaSignedUrl(\n        { data, filename, mimeType },\n        privateKey,\n        bareMimeType,\n        bytes,\n      );\n    }\n\n    console.log(\n      `[builder-upload] small-file path: ${filename ?? \"upload\"} ${mb}MB ${bareMimeType}`,\n    );\n\n    const url = new URL(\"/api/v1/upload\", builderUploadHost());\n    if (filename) url.searchParams.set(\"name\", filename);\n\n    const response = await uploadSmallFile(url, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${privateKey}`,\n        \"Content-Type\": bareMimeType,\n      },\n      body: makeBody(bytes, bareMimeType),\n    });\n\n    const json = (await response.json().catch(() => ({}))) as {\n      url?: string;\n      id?: string;\n    };\n    if (!json.url) throw new Error(\"Builder.io upload returned no URL\");\n\n    console.log(`[builder-upload] done: ${json.url}`);\n    return { url: json.url, id: json.id, provider: \"builder\" };\n  },\n};\n"]}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/file-upload/builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  FileUploadProvider,\n  FileUploadInput,\n  FileUploadResult,\n  ResumableUploadSession,\n  ResumableChunkResult,\n} from \"./types.js\";\n\nconst DEFAULT_BUILDER_APP_HOST = \"https://builder.io\";\n\n/** Files larger than this are routed through the GCS signed-URL flow. */\nconst LARGE_FILE_THRESHOLD_BYTES = 30 * 1024 * 1024;\nconst UPLOAD_TIMEOUT_MS = 120_000;\nconst SMALL_FILE_RETRY_DELAYS_MS = [600, 1800];\n\nfunction builderUploadHost(): string {\n  return (\n    process.env.BUILDER_APP_HOST ||\n    process.env.BUILDER_PUBLIC_APP_HOST ||\n    DEFAULT_BUILDER_APP_HOST\n  );\n}\n\nfunction makeBody(bytes: Uint8Array, mimeType: string): BodyInit {\n  return typeof Blob !== \"undefined\"\n    ? new Blob([bytes as unknown as BlobPart], { type: mimeType })\n    : (bytes as unknown as BodyInit);\n}\n\nfunction fetchWithTimeout(url: string, init: RequestInit): Promise<Response> {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), UPLOAD_TIMEOUT_MS);\n  return fetch(url, { ...init, signal: controller.signal }).finally(() =>\n    clearTimeout(timer),\n  );\n}\n\nasync function assertOk(res: Response, label: string): Promise<void> {\n  if (!res.ok) {\n    const body = await res.text().catch(() => \"\");\n    throw new Error(`${label} (${res.status}): ${body || res.statusText}`);\n  }\n}\n\nasync function uploadLargeFileViaSignedUrl(\n  input: FileUploadInput,\n  privateKey: string,\n  bareMimeType: string,\n  bytes: Uint8Array,\n): Promise<FileUploadResult> {\n  const name = input.filename ?? \"upload\";\n  const mb = (bytes.byteLength / (1024 * 1024)).toFixed(1);\n\n  console.log(\n    `[builder-upload] large-file path: ${name} ${mb}MB ${bareMimeType}`,\n  );\n\n  // Step 1 — request a signed URL.\n  console.log(`[builder-upload] step 1: requesting signed URL`);\n  const { uploadUrl, assetId, requiredHeaders } = await requestBuilderSignedUrl(\n    privateKey,\n    name,\n    bareMimeType,\n    bytes.byteLength,\n  );\n  console.log(`[builder-upload] step 1 ok: assetId=${assetId}`);\n\n  // Step 2 — PUT bytes directly to GCS. Only requiredHeaders; no Authorization\n  // (signed URL carries its own auth — extra signed headers break the signature).\n  console.log(`[builder-upload] step 2 [${assetId}]: PUT ${mb}MB to GCS`);\n  const step2Res = await fetchWithTimeout(uploadUrl, {\n    method: \"PUT\",\n    headers: requiredHeaders,\n    body: makeBody(bytes, bareMimeType),\n  });\n  await assertOk(step2Res, \"GCS upload failed\");\n  console.log(\n    `[builder-upload] step 2 ok [${assetId}]: GCS ${step2Res.status} etag=${step2Res.headers.get(\"etag\") ?? \"none\"}`,\n  );\n\n  // Step 3 — register the asset and get the CDN URL.\n  console.log(\n    `[builder-upload] step 3: registering asset - ${assetId}, ${input.filename}`,\n  );\n  const { url, id } = await completeBuilderUpload(\n    privateKey,\n    assetId,\n    input.filename,\n  );\n  console.log(`[builder-upload] done [${assetId}]: ${url}`);\n  return { url, id, provider: \"builder\" };\n}\n\nasync function requestBuilderSignedUrl(\n  privateKey: string,\n  filename: string,\n  mimeType: string,\n  size: number,\n  resumable = false,\n): Promise<{\n  uploadUrl: string;\n  assetId: string;\n  requiredHeaders: Record<string, string>;\n}> {\n  const host = builderUploadHost();\n  const url = new URL(\"/api/v1/upload/signed-url\", host);\n  const res = await fetchWithTimeout(url.toString(), {\n    method: \"POST\",\n    headers: {\n      Authorization: `Bearer ${privateKey}`,\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({\n      fileName: filename,\n      contentType: mimeType,\n      size,\n      resumable,\n    }),\n  });\n  await assertOk(res, \"Builder.io signed-URL request failed\");\n  const json = (await res.json()) as {\n    uploadUrl?: string;\n    assetId?: string;\n    requiredHeaders?: Record<string, string>;\n  };\n  if (!json.uploadUrl || !json.assetId || !json.requiredHeaders) {\n    throw new Error(\n      `Builder.io signed-URL response missing required fields: ${JSON.stringify(Object.keys(json))}`,\n    );\n  }\n  return {\n    uploadUrl: json.uploadUrl,\n    assetId: json.assetId,\n    requiredHeaders: json.requiredHeaders,\n  };\n}\n\nasync function completeBuilderUpload(\n  privateKey: string,\n  assetId: string,\n  filename: string | undefined,\n): Promise<{ url: string; id?: string }> {\n  const host = builderUploadHost();\n  const res = await fetchWithTimeout(\n    new URL(\"/api/v1/upload/complete\", host).toString(),\n    {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${privateKey}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({ assetId, name: filename }),\n    },\n  );\n  await assertOk(res, \"Builder.io upload complete failed\");\n  const json = (await res.json()) as { url?: string; id?: string };\n  if (!json.url) throw new Error(\"Builder.io upload/complete returned no URL\");\n  return { url: json.url, id: json.id };\n}\n\n// Retry transient 5xx once with backoff. Builder.io's upload service\n// occasionally returns a bodyless 500 (\"Internal Error\") on the first\n// attempt — usually GCS write hiccups that succeed on retry.\nasync function uploadSmallFile(url: URL, init: RequestInit): Promise<Response> {\n  let response: Response | null = null;\n  let lastErrorBody = \"\";\n\n  for (\n    let attempt = 0;\n    attempt <= SMALL_FILE_RETRY_DELAYS_MS.length;\n    attempt++\n  ) {\n    const retryDelay = SMALL_FILE_RETRY_DELAYS_MS[attempt]; // undefined on last attempt\n    try {\n      response = await fetchWithTimeout(url.toString(), init);\n    } catch (err) {\n      if (!retryDelay) throw err;\n      await new Promise((r) => setTimeout(r, retryDelay));\n      continue;\n    }\n    if (response.ok) return response;\n    lastErrorBody = await response.text().catch(() => \"\");\n    const isTransient = response.status >= 500 && response.status !== 501;\n    if (!isTransient || !retryDelay) break;\n    await new Promise((r) => setTimeout(r, retryDelay));\n  }\n\n  const status = response?.status ?? 0;\n  const statusText = response?.statusText ?? \"no response\";\n  throw new Error(\n    `Builder.io upload failed (${status}): ${lastErrorBody || statusText}`,\n  );\n}\n\n/**\n * Built-in Builder.io file upload provider.\n * Uses the same BUILDER_PRIVATE_KEY as the browser/background-agent flows,\n * so connecting Builder once (via the sidebar \"Connect Builder\" action)\n * automatically enables file uploads.\n *\n * Upload API: https://www.builder.io/c/docs/upload-api\n */\nexport const builderFileUploadProvider: FileUploadProvider = {\n  id: \"builder\",\n  name: \"Builder.io\",\n  isConfigured: () => !!process.env.BUILDER_PRIVATE_KEY,\n  upload: async ({ data, filename, mimeType }: FileUploadInput) => {\n    const { resolveBuilderPrivateKey } =\n      await import(\"../server/credential-provider.js\");\n    const privateKey = await resolveBuilderPrivateKey();\n    if (!privateKey) {\n      throw new Error(\"BUILDER_PRIVATE_KEY is not set\");\n    }\n\n    // Strip any media-type parameters (e.g. `;codecs=avc1,opus` from\n    // MediaRecorder blobs) — Builder's upload API parses the body as raw\n    // binary only when Content-Type is a bare MIME type. A parameterized\n    // Content-Type falls through to the multipart/base64 paths which look\n    // for an `image` field, and returns \"No image specified\" when it\n    // doesn't find one.\n    const bareMimeType = (mimeType || \"application/octet-stream\")\n      .split(\";\")[0]\n      .trim();\n\n    const bytes =\n      data instanceof Uint8Array ? data : new Uint8Array(data as any);\n    const mb = (bytes.byteLength / (1024 * 1024)).toFixed(1);\n\n    if (bytes.byteLength > LARGE_FILE_THRESHOLD_BYTES) {\n      return uploadLargeFileViaSignedUrl(\n        { data, filename, mimeType },\n        privateKey,\n        bareMimeType,\n        bytes,\n      );\n    }\n\n    console.log(\n      `[builder-upload] small-file path: ${filename ?? \"upload\"} ${mb}MB ${bareMimeType}`,\n    );\n\n    const url = new URL(\"/api/v1/upload\", builderUploadHost());\n    if (filename) url.searchParams.set(\"name\", filename);\n\n    const response = await uploadSmallFile(url, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${privateKey}`,\n        \"Content-Type\": bareMimeType,\n      },\n      body: makeBody(bytes, bareMimeType),\n    });\n\n    const json = (await response.json().catch(() => ({}))) as {\n      url?: string;\n      id?: string;\n    };\n    if (!json.url) throw new Error(\"Builder.io upload returned no URL\");\n\n    console.log(`[builder-upload] done: ${json.url}`);\n    return { url: json.url, id: json.id, provider: \"builder\" };\n  },\n\n  resumable: {\n    async startSession(filename, mimeType, maxBytes) {\n      const { resolveBuilderPrivateKey } =\n        await import(\"../server/credential-provider.js\");\n      const privateKey = await resolveBuilderPrivateKey();\n      if (!privateKey) throw new Error(\"BUILDER_PRIVATE_KEY is not set\");\n\n      console.log(\n        `[builder-resumable] starting session: ${filename} ${mimeType} ${maxBytes} bytes`,\n      );\n      const { uploadUrl, assetId, requiredHeaders } =\n        await requestBuilderSignedUrl(\n          privateKey,\n          filename,\n          mimeType,\n          maxBytes,\n          true,\n        );\n      console.log(`[builder-resumable] session step 1 ok: assetId=${assetId}`);\n\n      const initHeaders: Record<string, string> = {\n        \"Content-Type\": mimeType,\n        \"x-goog-resumable\": \"start\",\n      };\n      const contentLengthRange =\n        requiredHeaders?.[\"x-goog-content-length-range\"];\n      if (contentLengthRange)\n        initHeaders[\"x-goog-content-length-range\"] = contentLengthRange;\n\n      console.log(`[builder-resumable] session step 2: initiating GCS session`);\n      const initRes = await fetchWithTimeout(uploadUrl, {\n        method: \"POST\",\n        headers: initHeaders,\n        body: new Uint8Array(0),\n      });\n      if (!initRes.ok) {\n        const body = await initRes.text().catch(() => \"\");\n        throw new Error(\n          `GCS resumable session initiation failed (${initRes.status}): ${body}`,\n        );\n      }\n      const sessionUri = initRes.headers.get(\"location\");\n      if (!sessionUri)\n        throw new Error(\n          \"GCS did not return a Location header for the resumable session\",\n        );\n\n      console.log(`[builder-resumable] session ready: assetId=${assetId}`);\n      return {\n        sessionId: sessionUri,\n        meta: { assetId, filename, mimeType },\n      } satisfies ResumableUploadSession;\n    },\n\n    async relayChunk(session, contentRange, bytes, options) {\n      const sessionUri = session.sessionId;\n      const MAX_ATTEMPTS = 4;\n      const RETRYABLE = new Set([408, 429, 500, 502, 503, 504]);\n      const delayMs = (attempt: number) =>\n        Math.min(2000, 300 * 2 ** (attempt - 1));\n\n      let lastError: unknown = null;\n      for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {\n        try {\n          const headers: Record<string, string> = {\n            \"Content-Range\": contentRange,\n          };\n          if (options?.mimeType) headers[\"Content-Type\"] = options.mimeType;\n          const res = await fetch(sessionUri, {\n            method: \"PUT\",\n            headers,\n            body: bytes as unknown as BodyInit,\n          });\n          if (res.status === 308 || res.ok)\n            return {\n              ok: true,\n              status: res.status,\n            } satisfies ResumableChunkResult;\n          if (RETRYABLE.has(res.status) && attempt < MAX_ATTEMPTS) {\n            await res.text().catch(() => \"\");\n            console.warn(\n              `[builder-resumable] transient ${res.status} on attempt ${attempt}, retrying`,\n            );\n            await new Promise((r) => setTimeout(r, delayMs(attempt)));\n            continue;\n          }\n          return {\n            ok: false,\n            status: res.status,\n          } satisfies ResumableChunkResult;\n        } catch (err) {\n          lastError = err;\n          if (attempt >= MAX_ATTEMPTS) break;\n          console.warn(\n            `[builder-resumable] network error on attempt ${attempt}:`,\n            err instanceof Error ? err.message : String(err),\n          );\n          await new Promise((r) => setTimeout(r, delayMs(attempt)));\n        }\n      }\n      throw lastError instanceof Error\n        ? lastError\n        : new Error(\"GCS PUT failed after retries\");\n    },\n\n    async completeSession(session, filename) {\n      const { resolveBuilderPrivateKey } =\n        await import(\"../server/credential-provider.js\");\n      const privateKey = await resolveBuilderPrivateKey();\n      if (!privateKey) throw new Error(\"BUILDER_PRIVATE_KEY is not set\");\n\n      const assetId = session.meta.assetId as string;\n      console.log(`[builder-resumable] completing upload: assetId=${assetId}`);\n      const { url } = await completeBuilderUpload(\n        privateKey,\n        assetId,\n        filename,\n      );\n      console.log(`[builder-resumable] upload complete: ${url}`);\n      return url;\n    },\n  },\n};\n"]}

package/dist/file-upload/index.d.ts

@@ -1,4 +1,4 @@
-export type { FileUploadInput, FileUploadProvider, FileUploadResult, } from "./types.js";
+export type { FileUploadInput, FileUploadProvider, FileUploadResult, ResumableUploadSession, ResumableChunkResult, } from "./types.js";
 export { registerFileUploadProvider, unregisterFileUploadProvider, listFileUploadProviders, getActiveFileUploadProvider, getActiveFileUploadProviderForRequest, uploadFile, } from "./registry.js";
 export { builderFileUploadProvider } from "./builder.js";
 export { preUploadImageAttachments, preUploadAttachments, isFileUploadProviderConfigured, type PreUploadAttachmentsResult, type PreUploadedImageAttachment, type PreUploadedFileAttachment, } from "./pre-upload-attachments.js";

package/dist/file-upload/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file-upload/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,qCAAqC,EACrC,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file-upload/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,qCAAqC,EACrC,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC"}

package/dist/file-upload/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/file-upload/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,qCAAqC,EACrC,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,GAI/B,MAAM,6BAA6B,CAAC","sourcesContent":["export type {\n  FileUploadInput,\n  FileUploadProvider,\n  FileUploadResult,\n} from \"./types.js\";\nexport {\n  registerFileUploadProvider,\n  unregisterFileUploadProvider,\n  listFileUploadProviders,\n  getActiveFileUploadProvider,\n  getActiveFileUploadProviderForRequest,\n  uploadFile,\n} from \"./registry.js\";\nexport { builderFileUploadProvider } from \"./builder.js\";\nexport {\n  preUploadImageAttachments,\n  preUploadAttachments,\n  isFileUploadProviderConfigured,\n  type PreUploadAttachmentsResult,\n  type PreUploadedImageAttachment,\n  type PreUploadedFileAttachment,\n} from \"./pre-upload-attachments.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/file-upload/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,qCAAqC,EACrC,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,GAI/B,MAAM,6BAA6B,CAAC","sourcesContent":["export type {\n  FileUploadInput,\n  FileUploadProvider,\n  FileUploadResult,\n  ResumableUploadSession,\n  ResumableChunkResult,\n} from \"./types.js\";\nexport {\n  registerFileUploadProvider,\n  unregisterFileUploadProvider,\n  listFileUploadProviders,\n  getActiveFileUploadProvider,\n  getActiveFileUploadProviderForRequest,\n  uploadFile,\n} from \"./registry.js\";\nexport { builderFileUploadProvider } from \"./builder.js\";\nexport {\n  preUploadImageAttachments,\n  preUploadAttachments,\n  isFileUploadProviderConfigured,\n  type PreUploadAttachmentsResult,\n  type PreUploadedImageAttachment,\n  type PreUploadedFileAttachment,\n} from \"./pre-upload-attachments.js\";\n"]}

package/dist/file-upload/types.d.ts

@@ -24,6 +24,20 @@ export interface FileUploadResult {
     /** The provider that handled the upload. */
     provider: string;
 }
+/** Opaque session handle returned by {@link FileUploadProvider.resumable.startSession}.
+ * `sessionId` is provider-specific (GCS Location URI, S3 UploadId, etc.).
+ * `meta` holds any provider state needed for subsequent relay and complete calls. */
+export interface ResumableUploadSession {
+    sessionId: string;
+    meta: Record<string, unknown>;
+}
+export interface ResumableChunkResult {
+    ok: boolean;
+    status: number;
+    /** Providers that need per-chunk state (e.g. S3 ETags) return updated meta
+     * here; the chunk route merges it back into the stored session. */
+    updatedMeta?: Record<string, unknown>;
+}
 export interface FileUploadProvider {
     /** Unique id, e.g. "builder", "s3". */
     id: string;
@@ -38,5 +52,17 @@ export interface FileUploadProvider {
     isConfiguredForRequest?: () => Promise<boolean>;
     /** Upload a file and return a URL. Throw on failure. */
     upload: (input: FileUploadInput) => Promise<FileUploadResult>;
+    /**
+     * Optional resumable/streaming upload capability.
+     * When present, create-recording will initialise a session and stream chunks
+     * during recording instead of assembling the full blob after stop().
+     */
+    resumable?: {
+        startSession(filename: string, mimeType: string, maxBytes: number): Promise<ResumableUploadSession>;
+        relayChunk(session: ResumableUploadSession, contentRange: string, bytes: Uint8Array, options?: {
+            mimeType?: string;
+        }): Promise<ResumableChunkResult>;
+        completeSession(session: ResumableUploadSession, filename: string): Promise<string>;
+    };
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/file-upload/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/file-upload/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,wDAAwD;IACxD,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/file-upload/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;qFAEqF;AACrF,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf;uEACmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,wDAAwD;IACxD,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9D;;;;OAIG;IACH,SAAS,CAAC,EAAE;QACV,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACnC,UAAU,CACR,OAAO,EAAE,sBAAsB,EAC/B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACjC,eAAe,CACb,OAAO,EAAE,sBAAsB,EAC/B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAAC;KACpB,CAAC;CACH"}

package/dist/file-upload/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/file-upload/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG","sourcesContent":["/**\n * File upload framework primitive.\n *\n * Templates call `uploadFile()` to upload a file and get back a URL.\n * The framework dispatches to whichever provider is registered (Builder.io\n * built-in, or a user-supplied one). If no provider is active, it falls back\n * to the SQL resources store — fine for dev, not recommended for production.\n */\n\nexport interface FileUploadInput {\n  /** File contents. */\n  data: Uint8Array | Buffer;\n  /** Original filename, used for extension/display. */\n  filename?: string;\n  /** MIME type, e.g. \"image/png\". */\n  mimeType?: string;\n  /** Optional owner email for per-user scoping in fallback storage. */\n  ownerEmail?: string;\n}\n\nexport interface FileUploadResult {\n  /** Public URL where the file can be fetched. */\n  url: string;\n  /** Optional provider-specific id (e.g. resource id, Builder asset id). */\n  id?: string;\n  /** The provider that handled the upload. */\n  provider: string;\n}\n\nexport interface FileUploadProvider {\n  /** Unique id, e.g. \"builder\", \"s3\". */\n  id: string;\n  /** Human-readable name. */\n  name: string;\n  /** Returns true if this provider is configured from synchronous runtime state. */\n  isConfigured: () => boolean;\n  /**\n   * Returns true if this provider is configured for the active request.\n   * Use for DB-backed user/org/workspace secrets that require request context.\n   */\n  isConfiguredForRequest?: () => Promise<boolean>;\n  /** Upload a file and return a URL. Throw on failure. */\n  upload: (input: FileUploadInput) => Promise<FileUploadResult>;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/file-upload/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG","sourcesContent":["/**\n * File upload framework primitive.\n *\n * Templates call `uploadFile()` to upload a file and get back a URL.\n * The framework dispatches to whichever provider is registered (Builder.io\n * built-in, or a user-supplied one). If no provider is active, it falls back\n * to the SQL resources store — fine for dev, not recommended for production.\n */\n\nexport interface FileUploadInput {\n  /** File contents. */\n  data: Uint8Array | Buffer;\n  /** Original filename, used for extension/display. */\n  filename?: string;\n  /** MIME type, e.g. \"image/png\". */\n  mimeType?: string;\n  /** Optional owner email for per-user scoping in fallback storage. */\n  ownerEmail?: string;\n}\n\nexport interface FileUploadResult {\n  /** Public URL where the file can be fetched. */\n  url: string;\n  /** Optional provider-specific id (e.g. resource id, Builder asset id). */\n  id?: string;\n  /** The provider that handled the upload. */\n  provider: string;\n}\n\n/** Opaque session handle returned by {@link FileUploadProvider.resumable.startSession}.\n * `sessionId` is provider-specific (GCS Location URI, S3 UploadId, etc.).\n * `meta` holds any provider state needed for subsequent relay and complete calls. */\nexport interface ResumableUploadSession {\n  sessionId: string;\n  meta: Record<string, unknown>;\n}\n\nexport interface ResumableChunkResult {\n  ok: boolean;\n  status: number;\n  /** Providers that need per-chunk state (e.g. S3 ETags) return updated meta\n   * here; the chunk route merges it back into the stored session. */\n  updatedMeta?: Record<string, unknown>;\n}\n\nexport interface FileUploadProvider {\n  /** Unique id, e.g. \"builder\", \"s3\". */\n  id: string;\n  /** Human-readable name. */\n  name: string;\n  /** Returns true if this provider is configured from synchronous runtime state. */\n  isConfigured: () => boolean;\n  /**\n   * Returns true if this provider is configured for the active request.\n   * Use for DB-backed user/org/workspace secrets that require request context.\n   */\n  isConfiguredForRequest?: () => Promise<boolean>;\n  /** Upload a file and return a URL. Throw on failure. */\n  upload: (input: FileUploadInput) => Promise<FileUploadResult>;\n  /**\n   * Optional resumable/streaming upload capability.\n   * When present, create-recording will initialise a session and stream chunks\n   * during recording instead of assembling the full blob after stop().\n   */\n  resumable?: {\n    startSession(\n      filename: string,\n      mimeType: string,\n      maxBytes: number,\n    ): Promise<ResumableUploadSession>;\n    relayChunk(\n      session: ResumableUploadSession,\n      contentRange: string,\n      bytes: Uint8Array,\n      options?: { mimeType?: string },\n    ): Promise<ResumableChunkResult>;\n    completeSession(\n      session: ResumableUploadSession,\n      filename: string,\n    ): Promise<string>;\n  };\n}\n"]}

package/dist/notifications/routes.d.ts

@@ -11,24 +11,24 @@
  *   DELETE /_agent-native/notifications/:id         — delete
  */
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
-    error?: undefined;
     count: number;
     updated?: undefined;
     ok?: undefined;
-} | {
     error?: undefined;
+} | {
     count?: undefined;
     updated: number;
     ok?: undefined;
+    error?: undefined;
 } | {
     count?: undefined;
     updated?: undefined;
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     count?: undefined;
     updated?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/observability/routes.d.ts

@@ -41,28 +41,28 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
-    error?: undefined;
+    ok?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
+    error?: undefined;
     id?: undefined;
-    ok?: undefined;
 } | {
-    error?: undefined;
+    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
-    ok?: undefined;
+    error?: undefined;
 } | {
+    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
-    id?: undefined;
     error: any;
-    ok?: undefined;
+    id?: undefined;
 } | {
-    error?: undefined;
     summary?: undefined;
     spans?: undefined;
-    id?: undefined;
     ok: boolean;
+    error?: undefined;
+    id?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/progress/routes.d.ts

@@ -15,7 +15,7 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/resources/handlers.d.ts

@@ -49,11 +49,11 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
 }>;
 /** DELETE /_agent-native/resources/:id — delete a resource */
 export declare function handleDeleteResource(event: any): Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>;
 /** POST /_agent-native/resources/upload — upload a file as a resource */
 export declare function handleUploadResource(event: any): Promise<import("./store.js").Resource | {
@@ -73,9 +73,9 @@ export declare function handleUploadResource(event: any): Promise<import("./stor
     runId: string | null;
     expiresAt: number | null;
     metadata: string | null;
+    error?: undefined;
     url: string;
     provider: string;
-    error?: undefined;
 }>;
 export {};
 //# sourceMappingURL=handlers.d.ts.map

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,11 +27,11 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};
 //# sourceMappingURL=agent-engine-api-key-route.d.ts.map

package/dist/server/transcribe-voice.d.ts

@@ -20,7 +20,7 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    text: string;
     error?: undefined;
+    text: string;
 }>>;
 //# sourceMappingURL=transcribe-voice.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.81.3",
+  "version": "0.82.0",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {