@ai-matrx/api 0.1.27 → 0.1.29

package/dist/files.d.cts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, J as JsonOrStream, S as SseEvent } from './index-DseWSnYe.cjs';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, J as JsonOrStream, S as SseEvent } from './index-DyDNKgdB.cjs';
 import { JsonValue, Asset, MediaRef, UserAnalysisPreferencesResponse, StorageImportResult } from './schemas.cjs';
 import '@ai-matrx/auth/credentials';
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 ed1fe1df59e1acd74be297d45d5b1b9f1bb7a637bdc54c53928db1f876875ce9
+ * CONTRACT_SHA256 2e22230d01e754f5ae210e0932290279956cc04757022cfee77b6d128f1c667c
  */
 
 /** ActivePageIdsResponse */

package/dist/files.d.ts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, J as JsonOrStream, S as SseEvent } from './index-DseWSnYe.js';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, J as JsonOrStream, S as SseEvent } from './index-DyDNKgdB.js';
 import { JsonValue, Asset, MediaRef, UserAnalysisPreferencesResponse, StorageImportResult } from './schemas.js';
 import '@ai-matrx/auth/credentials';
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 ed1fe1df59e1acd74be297d45d5b1b9f1bb7a637bdc54c53928db1f876875ce9
+ * CONTRACT_SHA256 2e22230d01e754f5ae210e0932290279956cc04757022cfee77b6d128f1c667c
  */
 
 /** ActivePageIdsResponse */

package/dist/files.js

@@ -1,3 +1,3 @@
-export { activePagesEndpoint, addGroupMember, appGenerateDirectoryStructure, appGenerateDirectoryStructurePost, assetsPdfCompress, assetsPdfCompressMultipart, assetsPreview, assetsPreviewMultipart, authorizeStorage, batchExtract, boxCallback, browseProviderFolder, bulkDeleteFiles, bulkFromCandidatesEndpoint, bulkMoveFiles, bulkMoveFolders, bulkOpDiscriminator, call, cancelDownload, childFileShare, classifyPagesEndpoint, cleanDocumentContent, cloudDebug, cloudFilesBridgeDeleteFile, cloudFilesBridgeGetFile, cloudFilesBridgeListFiles, cloudInstanceDryRun, compressPdf, configureSync, convertOfficePdf, copyFile, createAnnotationEndpoint, createEntityEndpoint, createFileShareLink, createFolder, createFolderShareLink, createGroup, createMapping, createNode, createPresignedUpload, cropPages, deactivateShareLink, deleteAnnotationEndpoint, deleteEntityEndpoint, deleteFolder, deleteMapping, deleteNode, deletePages, detectRepeatedRegionsEndpoint, disconnectStorage, dismissDownload, downloadFile, downloadShare, downloadSharedChildFile, downloadSharedFile, downloadStream, downloadVersion, drainMediaHealQueue, dropboxCallback, duplicatePages, enqueueDownload, escrowRecover, escrowWrappingKey, excludePageEndpoint, extractAtBboxEndpoint, extractAudio, extractAudioOnFiles, extractPages, extractReadingOrderEndpoint, extractRegionEndpoint, extractTables, extractTextFromPdf, extractTextRemote, extractedTextEndpoint, fetchAnalysis, fetchLabelCatalog, filesDeleteFile, filesGetFile, filesListFiles, filesystemIndexAction, filesystemStatus, finalizePresignedUpload, findPaths, findSimilarEndpoint, flattenAnnotationsEndpoint, fullPipeline, generateDirectoryStructureJson, getAnalysisPreferences, getAsset, getCloudSettings, getDocument, getDownload, getFileAsAsset, getFileAsAssetOnFiles, getFileByPath, getFileDocument, getFileLineageSummary, getFileRagStatus, getFileTree, getFolder, getIndexingSettings, getInstanceInfo, getPageEndpoint, getPlaces, getQuota, getStorageUsage, getVersion, grantFilePermission, grantFolderPermission, health, heartbeat, importProviderFile, includePageEndpoint, ingestFileForRag, ingestFileForRagStream, insertPages, integrationsAidream, keyFindingsEndpoint, listAdapters, listAnnotationsEndpoint, listChanges, listDirectory, listDocuments, listDownloads, listEntitiesEndpoint, listFilePermissions, listFileShareLinks, listFiles, listFolderPermissions, listFolderShareLinks, listFolders, listGroupMembers, listGroupsIndex, listInstances, listMappings, listNodes, listOverridesEndpoint, listPagesEndpoint, listPresets, listTrash, manifestEndpoint, mergePdfs, mintFileSession, mintFileSessionOnFiles, moveNode, overridePageTextEndpoint, patchAsset, patchFolder, pdfFromImages, prepareOpen, processWithAi, promoteToEntityEndpoint, pullSettings, pushSettings, putAnalysisPreferences, putFile, readContent, readiness, reconfigureSync, redactMask, redactPatternEndpoint, redactPatternsCatalog, redactRegionsEndpoint, redactRepeatedRegionsEndpoint, redactRestore, refreshAnalysis, refreshFileRag, refreshStorage, removeGroupMember, renameFile, renameNode, renderAllPages, renderMoreVariants, renderPage, renderPageWithOverlayEndpoint, renderThumbnail, reorderPages, reportObservation, resetSettings, resolve, restoreFile, revokeFilePermission, revokeFolderPermission, revokeSession, rotatePageEndpoint, rotatePages, saveContent, saveNewVersion, scrubEndpoint, searchContent, searchEndpoint, searchFiles, searchSemantic, selectPdfPages, snapBboxEndpoint, splitPdf, stripMetadataEndpoint, stripRepeatedRegionsEndpoint, studioPresets, studioRender, syncChanges, syncFolders, triggerSync, tusCreate, tusCreateOnFiles, tusDelete, tusDeleteOnFiles, tusHead, tusHeadOnFiles, tusOptions, tusOptionsOnFiles, tusPatch, tusPatchOnFiles, updateAnnotationEndpoint, updateCloudSettings, updateEntityEndpoint, updateFileMetadata, updateIndexingSettings, updateInstanceName, updatePriorityRoots, uploadAsset, uploadFile, versionsListVersions, versionsRestoreVersion, virtualListVersions, virtualRestoreVersion } from './chunk-OWI6FDHV.js';
-import './chunk-MFZXWYK6.js';
+export { activePagesEndpoint, addGroupMember, appGenerateDirectoryStructure, appGenerateDirectoryStructurePost, assetsPdfCompress, assetsPdfCompressMultipart, assetsPreview, assetsPreviewMultipart, authorizeStorage, batchExtract, boxCallback, browseProviderFolder, bulkDeleteFiles, bulkFromCandidatesEndpoint, bulkMoveFiles, bulkMoveFolders, bulkOpDiscriminator, call, cancelDownload, childFileShare, classifyPagesEndpoint, cleanDocumentContent, cloudDebug, cloudFilesBridgeDeleteFile, cloudFilesBridgeGetFile, cloudFilesBridgeListFiles, cloudInstanceDryRun, compressPdf, configureSync, convertOfficePdf, copyFile, createAnnotationEndpoint, createEntityEndpoint, createFileShareLink, createFolder, createFolderShareLink, createGroup, createMapping, createNode, createPresignedUpload, cropPages, deactivateShareLink, deleteAnnotationEndpoint, deleteEntityEndpoint, deleteFolder, deleteMapping, deleteNode, deletePages, detectRepeatedRegionsEndpoint, disconnectStorage, dismissDownload, downloadFile, downloadShare, downloadSharedChildFile, downloadSharedFile, downloadStream, downloadVersion, drainMediaHealQueue, dropboxCallback, duplicatePages, enqueueDownload, escrowRecover, escrowWrappingKey, excludePageEndpoint, extractAtBboxEndpoint, extractAudio, extractAudioOnFiles, extractPages, extractReadingOrderEndpoint, extractRegionEndpoint, extractTables, extractTextFromPdf, extractTextRemote, extractedTextEndpoint, fetchAnalysis, fetchLabelCatalog, filesDeleteFile, filesGetFile, filesListFiles, filesystemIndexAction, filesystemStatus, finalizePresignedUpload, findPaths, findSimilarEndpoint, flattenAnnotationsEndpoint, fullPipeline, generateDirectoryStructureJson, getAnalysisPreferences, getAsset, getCloudSettings, getDocument, getDownload, getFileAsAsset, getFileAsAssetOnFiles, getFileByPath, getFileDocument, getFileLineageSummary, getFileRagStatus, getFileTree, getFolder, getIndexingSettings, getInstanceInfo, getPageEndpoint, getPlaces, getQuota, getStorageUsage, getVersion, grantFilePermission, grantFolderPermission, health, heartbeat, importProviderFile, includePageEndpoint, ingestFileForRag, ingestFileForRagStream, insertPages, integrationsAidream, keyFindingsEndpoint, listAdapters, listAnnotationsEndpoint, listChanges, listDirectory, listDocuments, listDownloads, listEntitiesEndpoint, listFilePermissions, listFileShareLinks, listFiles, listFolderPermissions, listFolderShareLinks, listFolders, listGroupMembers, listGroupsIndex, listInstances, listMappings, listNodes, listOverridesEndpoint, listPagesEndpoint, listPresets, listTrash, manifestEndpoint, mergePdfs, mintFileSession, mintFileSessionOnFiles, moveNode, overridePageTextEndpoint, patchAsset, patchFolder, pdfFromImages, prepareOpen, processWithAi, promoteToEntityEndpoint, pullSettings, pushSettings, putAnalysisPreferences, putFile, readContent, readiness, reconfigureSync, redactMask, redactPatternEndpoint, redactPatternsCatalog, redactRegionsEndpoint, redactRepeatedRegionsEndpoint, redactRestore, refreshAnalysis, refreshFileRag, refreshStorage, removeGroupMember, renameFile, renameNode, renderAllPages, renderMoreVariants, renderPage, renderPageWithOverlayEndpoint, renderThumbnail, reorderPages, reportObservation, resetSettings, resolve, restoreFile, revokeFilePermission, revokeFolderPermission, revokeSession, rotatePageEndpoint, rotatePages, saveContent, saveNewVersion, scrubEndpoint, searchContent, searchEndpoint, searchFiles, searchSemantic, selectPdfPages, snapBboxEndpoint, splitPdf, stripMetadataEndpoint, stripRepeatedRegionsEndpoint, studioPresets, studioRender, syncChanges, syncFolders, triggerSync, tusCreate, tusCreateOnFiles, tusDelete, tusDeleteOnFiles, tusHead, tusHeadOnFiles, tusOptions, tusOptionsOnFiles, tusPatch, tusPatchOnFiles, updateAnnotationEndpoint, updateCloudSettings, updateEntityEndpoint, updateFileMetadata, updateIndexingSettings, updateInstanceName, updatePriorityRoots, uploadAsset, uploadFile, versionsListVersions, versionsRestoreVersion, virtualListVersions, virtualRestoreVersion } from './chunk-QCDALTHR.js';
+import './chunk-BIHYNQOU.js';
 import './chunk-KIEAFMKB.js';

package/dist/human-resources.d.cts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions } from './index-DseWSnYe.cjs';
+import { A as Api, C as CallOptions } from './index-DyDNKgdB.cjs';
 import { JsonValue } from './schemas.cjs';
 import '@ai-matrx/auth/credentials';
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 ed1fe1df59e1acd74be297d45d5b1b9f1bb7a637bdc54c53928db1f876875ce9
+ * CONTRACT_SHA256 2e22230d01e754f5ae210e0932290279956cc04757022cfee77b6d128f1c667c
  */
 
 /** E-13's body, byte-for-byte against the frozen stub. */

package/dist/human-resources.d.ts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions } from './index-DseWSnYe.js';
+import { A as Api, C as CallOptions } from './index-DyDNKgdB.js';
 import { JsonValue } from './schemas.js';
 import '@ai-matrx/auth/credentials';
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 ed1fe1df59e1acd74be297d45d5b1b9f1bb7a637bdc54c53928db1f876875ce9
+ * CONTRACT_SHA256 2e22230d01e754f5ae210e0932290279956cc04757022cfee77b6d128f1c667c
  */
 
 /** E-13's body, byte-for-byte against the frozen stub. */

package/dist/{index-DseWSnYe.d.cts → index-DyDNKgdB.d.cts}

@@ -190,10 +190,10 @@ declare function readMatrxSseStream(stream: ReadableStream<Uint8Array>, options?
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 ed1fe1df59e1acd74be297d45d5b1b9f1bb7a637bdc54c53928db1f876875ce9
+ * CONTRACT_SHA256 2e22230d01e754f5ae210e0932290279956cc04757022cfee77b6d128f1c667c
  */
 /** The server contract's hash; the Python `matrx-api` and any native client carry the same value. */
-declare const CONTRACT_SHA256 = "ed1fe1df59e1acd74be297d45d5b1b9f1bb7a637bdc54c53928db1f876875ce9";
+declare const CONTRACT_SHA256 = "2e22230d01e754f5ae210e0932290279956cc04757022cfee77b6d128f1c667c";
 /** Which deployment answers (api-deployments.json): default base URLs and the existing env names that override them. */
 declare const DEPLOYMENTS: {
     readonly files: {

package/dist/{index-DseWSnYe.d.ts → index-DyDNKgdB.d.ts}

@@ -190,10 +190,10 @@ declare function readMatrxSseStream(stream: ReadableStream<Uint8Array>, options?
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 ed1fe1df59e1acd74be297d45d5b1b9f1bb7a637bdc54c53928db1f876875ce9
+ * CONTRACT_SHA256 2e22230d01e754f5ae210e0932290279956cc04757022cfee77b6d128f1c667c
  */
 /** The server contract's hash; the Python `matrx-api` and any native client carry the same value. */
-declare const CONTRACT_SHA256 = "ed1fe1df59e1acd74be297d45d5b1b9f1bb7a637bdc54c53928db1f876875ce9";
+declare const CONTRACT_SHA256 = "2e22230d01e754f5ae210e0932290279956cc04757022cfee77b6d128f1c667c";
 /** Which deployment answers (api-deployments.json): default base URLs and the existing env names that override them. */
 declare const DEPLOYMENTS: {
     readonly files: {

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 var chunkFNIYADWI_cjs = require('./chunk-FNIYADWI.cjs');
 var chunkMVXD6WI6_cjs = require('./chunk-MVXD6WI6.cjs');
-var chunkBHSHMV22_cjs = require('./chunk-BHSHMV22.cjs');
+var chunkG3OJBGCU_cjs = require('./chunk-G3OJBGCU.cjs');
 var chunk2SXAAKGV_cjs = require('./chunk-2SXAAKGV.cjs');
 var format = require('@ai-matrx/kit/format');
 
@@ -44,7 +44,7 @@ function buildMatrxRequestBody(body, scope) {
   }
   const bodyOrganizationId = base.organization_id;
   if (scope.organization_id !== void 0 && bodyOrganizationId !== void 0 && (typeof bodyOrganizationId !== "string" || bodyOrganizationId.trim() !== scope.organization_id)) {
-    throw new chunkBHSHMV22_cjs.OrganizationContextError(
+    throw new chunkG3OJBGCU_cjs.OrganizationContextError(
       "organization_context_mismatch",
       "Request body organization_id must match the request context organization."
     );
@@ -116,14 +116,14 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
   };
   async function* events() {
     if (!response.body) {
-      throw new chunkBHSHMV22_cjs.BackendApiError({
+      throw new chunkG3OJBGCU_cjs.BackendApiError({
         code: "internal_error",
         detail: "Response has no body",
         userMessage: "No response received from server"
       });
     }
     try {
-      for await (const envelope of chunkBHSHMV22_cjs.readMatrxNdjsonStream(response.body, {
+      for await (const envelope of chunkG3OJBGCU_cjs.readMatrxNdjsonStream(response.body, {
         ...signal ? { signal } : {},
         ...hooks.onMalformedLine ? { onMalformedLine: hooks.onMalformedLine } : {},
         ...hooks.onUnknownEnvelope ? { onUnknownEnvelope: hooks.onUnknownEnvelope } : {}
@@ -135,7 +135,7 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
       if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
         return;
       }
-      const transportError = error instanceof chunkBHSHMV22_cjs.BackendApiError ? error : new chunkBHSHMV22_cjs.StreamTransportError({
+      const transportError = error instanceof chunkG3OJBGCU_cjs.BackendApiError ? error : new chunkG3OJBGCU_cjs.StreamTransportError({
         detail: error instanceof Error ? error.message : "The response stream ended unexpectedly.",
         details: error,
         ...ids.requestId ? { requestId: ids.requestId } : {}
@@ -152,7 +152,7 @@ async function httpErrorFrom(response) {
   const serverDetail = await response.json().catch(() => void 0);
   return {
     type: response.status >= 400 && response.status < 500 ? "validation_error" : "http_error",
-    message: chunkBHSHMV22_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
+    message: chunkG3OJBGCU_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
     status: response.status,
     serverDetail
   };
@@ -160,7 +160,7 @@ async function httpErrorFrom(response) {
 async function executeMatrxCall(request, hooks = {}) {
   const upper = request.method.toUpperCase();
   const sendsBody = request.stream || upper !== "GET" && upper !== "HEAD";
-  const { response } = await chunkBHSHMV22_cjs.sendOnWire({
+  const { response } = await chunkG3OJBGCU_cjs.sendOnWire({
     url: request.url,
     method: request.method,
     headers: request.headers,
@@ -210,11 +210,11 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
     headers[name] = value;
   });
   const fetchOptions = {};
-  for (const key of chunkBHSHMV22_cjs.WIRE_FETCH_OPTION_KEYS) {
+  for (const key of chunkG3OJBGCU_cjs.WIRE_FETCH_OPTION_KEYS) {
     if (init[key] !== void 0) fetchOptions[key] = init[key];
   }
   try {
-    const { response, controller } = await chunkBHSHMV22_cjs.sendOnWire({
+    const { response, controller } = await chunkG3OJBGCU_cjs.sendOnWire({
       url,
       method: init.method ?? "GET",
       fetchOptions,
@@ -237,7 +237,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
       throw callerSignal?.reason instanceof Error ? callerSignal.reason : new DOMException("The request was cancelled.", "AbortError");
     }
     if (options.timeoutMs !== void 0 && chunk2SXAAKGV_cjs.isNetError(error) && (error.code === "connect-timeout" || error.code === "total-timeout")) {
-      throw new chunkBHSHMV22_cjs.BackendApiError({
+      throw new chunkG3OJBGCU_cjs.BackendApiError({
         code: "request_timeout",
         detail: `${init.method ?? "GET"} ${url} exceeded ${options.timeoutMs}ms`,
         userMessage: "The request timed out \u2014 please retry.",
@@ -251,7 +251,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
   }
 }
 async function readMatrxJsonResponse(response) {
-  if (!response.ok) throw await chunkBHSHMV22_cjs.parseHttpError(response);
+  if (!response.ok) throw await chunkG3OJBGCU_cjs.parseHttpError(response);
   if (response.status === 204) return null;
   return await response.json();
 }
@@ -261,7 +261,7 @@ function classifyStatus(status) {
   return status >= 400 && status < 500 ? "validation_error" : "http_error";
 }
 function normalizeMatrxError(err) {
-  if (err instanceof chunkBHSHMV22_cjs.OrganizationContextError) {
+  if (err instanceof chunkG3OJBGCU_cjs.OrganizationContextError) {
     return {
       type: "validation_error",
       message: err.message,
@@ -273,7 +273,7 @@ function normalizeMatrxError(err) {
   if (err instanceof DOMException && err.name === "AbortError") {
     return { type: "abort_error", message: "Request was cancelled." };
   }
-  if (err instanceof chunkBHSHMV22_cjs.MatrxApiError) {
+  if (err instanceof chunkG3OJBGCU_cjs.MatrxApiError) {
     return {
       type: classifyStatus(err.status),
       message: honestTransportMessage(err.message, err.status),
@@ -283,7 +283,7 @@ function normalizeMatrxError(err) {
       name: err.name
     };
   }
-  if (err instanceof chunkBHSHMV22_cjs.BackendApiError) {
+  if (err instanceof chunkG3OJBGCU_cjs.BackendApiError) {
     return {
       type: "network_error",
       message: honestTransportMessage(
@@ -379,9 +379,9 @@ function createMatrxTransport(options) {
   const resolve = resolveTarget ?? (() => ({ baseUrl }));
   const resolveOrganizationId = (callOrganizationId) => {
     if (organizationId === void 0) return null;
-    if (callOrganizationId !== null) return chunkBHSHMV22_cjs.requireOrganizationContext(callOrganizationId);
+    if (callOrganizationId !== null) return chunkG3OJBGCU_cjs.requireOrganizationContext(callOrganizationId);
     const candidate = typeof organizationId === "function" ? organizationId() : organizationId;
-    return chunkBHSHMV22_cjs.requireOrganizationContext(candidate);
+    return chunkG3OJBGCU_cjs.requireOrganizationContext(candidate);
   };
   return {
     async fetch(path, init) {
@@ -392,7 +392,7 @@ function createMatrxTransport(options) {
       let overHeaders = callOrganizationId === null ? policyHeaders : stripOrganizationHeader(policyHeaders);
       const orgId = resolveOrganizationId(callOrganizationId);
       if (orgId !== null) {
-        overHeaders = chunkBHSHMV22_cjs.applyOrganizationContextHeader(overHeaders, orgId);
+        overHeaders = chunkG3OJBGCU_cjs.applyOrganizationContextHeader(overHeaders, orgId);
       }
       const wireHeaders = callOrganizationId === null ? { ...init.headers } : stripOrganizationHeader({ ...init.headers });
       const info = {
@@ -405,7 +405,7 @@ function createMatrxTransport(options) {
       diagnostics?.onRequest?.(info);
       let response;
       try {
-        ({ response } = await chunkBHSHMV22_cjs.sendOnWire(
+        ({ response } = await chunkG3OJBGCU_cjs.sendOnWire(
           {
             url,
             method: init.method,
@@ -429,11 +429,11 @@ function createMatrxTransport(options) {
       }
       if (!response.ok && !expectedErrorStatuses?.includes(response.status)) {
         const serverDetail = await response.clone().json().catch(() => void 0);
-        const code = chunkBHSHMV22_cjs.extractMatrxErrorCode(serverDetail);
+        const code = chunkG3OJBGCU_cjs.extractMatrxErrorCode(serverDetail);
         diagnostics?.onError?.(
           {
             type: classifyStatus(response.status),
-            message: chunkBHSHMV22_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
+            message: chunkG3OJBGCU_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
             status: response.status,
             serverDetail,
             ...code ? { code } : {}
@@ -532,6 +532,10 @@ function runWaitTimeoutMessage(kind, modelLabel, seconds) {
 var WARM_PATH = "/ai/warm";
 var DEFAULT_COALESCE_MS = 50;
 var DEFAULT_DEDUPE_MS = 6e4;
+var DEFAULT_RETRY_DELAYS_MS = [2e3, 8e3, 3e4];
+function isTransientStatus(status) {
+  return status === 408 || status === 425 || status === 429 || status >= 500 && status !== 501;
+}
 var SWEEP_AT = 256;
 var QUEUE_MAX = 64;
 function itemId(item) {
@@ -545,6 +549,7 @@ function createWarmup(options) {
     organizationId,
     coalesceMs = DEFAULT_COALESCE_MS,
     dedupeMs = DEFAULT_DEDUPE_MS,
+    retryDelaysMs = DEFAULT_RETRY_DELAYS_MS,
     now = Date.now
   } = options;
   const sentAt = /* @__PURE__ */ new Map();
@@ -594,6 +599,9 @@ function createWarmup(options) {
     if (batch.length === 0) return;
     const keys = batch.map((i) => `${current}|${itemId(i)}`);
     keys.forEach((k) => inFlight.add(k));
+    send(batch, keys, reason, current, 0);
+  }
+  function send(batch, keys, reason, sendScope, attempt2) {
     const settle = (ok) => {
       const t = now();
       for (const k of keys) {
@@ -601,6 +609,21 @@ function createWarmup(options) {
         if (ok) sentAt.set(k, t);
       }
     };
+    const failed = (transient, detail) => {
+      const delay = retryDelaysMs[attempt2];
+      if (transient && delay !== void 0) {
+        setTimeout(() => {
+          if (currentScope() !== sendScope) {
+            settle(false);
+            return;
+          }
+          send(batch, keys, reason, sendScope, attempt2 + 1);
+        }, delay);
+        return;
+      }
+      settle(false);
+      announce(attempt2 > 0 ? `${detail} after ${attempt2 + 1} attempts` : detail);
+    };
     try {
       const org = organizationId ? organizationId() : null;
       void transport.fetch(WARM_PATH, {
@@ -612,12 +635,11 @@ function createWarmup(options) {
         body: JSON.stringify({ reason, items: batch })
       }).then(
         (response) => {
-          settle(response.ok);
-          if (!response.ok) announce(`HTTP ${response.status}`);
+          if (response.ok) settle(true);
+          else failed(isTransientStatus(response.status), `HTTP ${response.status}`);
         },
         (err) => {
-          settle(false);
-          announce(String(err));
+          failed(true, String(err));
         }
       );
     } catch (err) {
@@ -712,7 +734,7 @@ async function readServerDetail(response) {
   }
 }
 async function throwApiError(path, response) {
-  throw new chunkBHSHMV22_cjs.MatrxApiError({
+  throw new chunkG3OJBGCU_cjs.MatrxApiError({
     status: response.status,
     path,
     serverDetail: await readServerDetail(response)
@@ -733,7 +755,7 @@ function toRunHandle(response, options) {
   return {
     requestId: response.headers.get("X-Request-ID"),
     conversationId: response.headers.get("X-Conversation-ID"),
-    events: chunkBHSHMV22_cjs.readMatrxNdjsonStream(response.body, {
+    events: chunkG3OJBGCU_cjs.readMatrxNdjsonStream(response.body, {
       ...options.signal ? { signal: options.signal } : {},
       ...options.maxReadAhead !== void 0 ? { maxReadAhead: options.maxReadAhead } : {},
       ...options.onMalformedLine ? { onMalformedLine: options.onMalformedLine } : {},
@@ -756,7 +778,7 @@ async function requestStream(transport, path, options) {
   });
   if (!response.ok) return throwApiError(path, response);
   if (!response.body) {
-    throw new chunkBHSHMV22_cjs.MatrxApiError({
+    throw new chunkG3OJBGCU_cjs.MatrxApiError({
       status: response.status,
       path,
       serverDetail: { code: "missing_response_body" },
@@ -816,7 +838,7 @@ async function getRuntimeOperationStatus(transport, requestId, options = {}) {
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkBHSHMV22_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkG3OJBGCU_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -831,7 +853,7 @@ async function getRuntimeOperationsByLink(transport, linkKind, linkId, options =
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkBHSHMV22_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkG3OJBGCU_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -872,7 +894,7 @@ async function* followRuntimeOperationEvents(transport, executionId, options = {
       ...options.signal ? { signal: options.signal } : {}
     }
   );
-  const frames = chunkBHSHMV22_cjs.readMatrxSseStream(
+  const frames = chunkG3OJBGCU_cjs.readMatrxSseStream(
     response.body,
     options.onIncomplete ? { onIncomplete: options.onIncomplete } : {}
   );
@@ -1075,7 +1097,7 @@ async function openMatrxStream(transport, path, options = {}) {
   return toRunHandle(response, options);
 }
 function withRunOrganization(transport, organizationId) {
-  const orgId = chunkBHSHMV22_cjs.requireOrganizationContext(organizationId);
+  const orgId = chunkG3OJBGCU_cjs.requireOrganizationContext(organizationId);
   return {
     fetch: (path, init) => transport.fetch(path, {
       ...init,
@@ -1102,7 +1124,7 @@ async function followWorkflowRunEvents(transport, runId, options) {
     throw error;
   }
   try {
-    for await (const frame of chunkBHSHMV22_cjs.readMatrxSseStream(
+    for await (const frame of chunkG3OJBGCU_cjs.readMatrxSseStream(
       response.body
     )) {
       if (frame.event === "end") return { ended: true };
@@ -1148,7 +1170,7 @@ async function resumeOrRejoin(transport, resumeCall, options) {
   } catch (error) {
     const target = readLiveRunRejoin(error);
     if (!target) {
-      if (error instanceof chunkBHSHMV22_cjs.MatrxApiError && isResumeConflict(error)) {
+      if (error instanceof chunkG3OJBGCU_cjs.MatrxApiError && isResumeConflict(error)) {
         return { kind: "resume_conflict", error };
       }
       throw error;
@@ -1564,7 +1586,7 @@ async function reportProviderSessionUsage(transport, usage, options = {}) {
     });
     return "ok";
   } catch (error) {
-    if (error instanceof chunkBHSHMV22_cjs.MatrxApiError) {
+    if (error instanceof chunkG3OJBGCU_cjs.MatrxApiError) {
       const status = error.status;
       if (status >= 400 && status < 500 && status !== 401 && status !== 408 && status !== 425 && status !== 429) {
         console.warn(`[provider-usage] server refused ${usage.provider} usage ${usage.usage_id} (${status})`);
@@ -1574,9 +1596,9 @@ async function reportProviderSessionUsage(transport, usage, options = {}) {
     return "retry";
   }
 }
-var DEFAULT_RETRY_DELAYS_MS = [1e3, 4e3, 15e3, 6e4, 18e4];
+var DEFAULT_RETRY_DELAYS_MS2 = [1e3, 4e3, 15e3, 6e4, 18e4];
 function createProviderUsageReporter(options) {
-  const delays = options.retryDelaysMs ?? DEFAULT_RETRY_DELAYS_MS;
+  const delays = options.retryDelaysMs ?? DEFAULT_RETRY_DELAYS_MS2;
   const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
   const seen = /* @__PURE__ */ new Set();
   const inflight = /* @__PURE__ */ new Set();
@@ -2260,115 +2282,115 @@ Object.defineProperty(exports, "toCredentialsPort", {
 });
 Object.defineProperty(exports, "BackendApiError", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.BackendApiError; }
+  get: function () { return chunkG3OJBGCU_cjs.BackendApiError; }
 });
 Object.defineProperty(exports, "CONTRACT_SHA256", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.CONTRACT_SHA256; }
+  get: function () { return chunkG3OJBGCU_cjs.CONTRACT_SHA256; }
 });
 Object.defineProperty(exports, "DEPLOYMENTS", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.DEPLOYMENTS; }
+  get: function () { return chunkG3OJBGCU_cjs.DEPLOYMENTS; }
 });
 Object.defineProperty(exports, "DOMAINS", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.DOMAINS; }
+  get: function () { return chunkG3OJBGCU_cjs.DOMAINS; }
 });
 Object.defineProperty(exports, "MatrxApiError", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.MatrxApiError; }
+  get: function () { return chunkG3OJBGCU_cjs.MatrxApiError; }
 });
 Object.defineProperty(exports, "OrganizationContextError", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.OrganizationContextError; }
+  get: function () { return chunkG3OJBGCU_cjs.OrganizationContextError; }
 });
 Object.defineProperty(exports, "StreamTransportError", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.StreamTransportError; }
+  get: function () { return chunkG3OJBGCU_cjs.StreamTransportError; }
 });
 Object.defineProperty(exports, "applyOrganizationContextHeader", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.applyOrganizationContextHeader; }
+  get: function () { return chunkG3OJBGCU_cjs.applyOrganizationContextHeader; }
 });
 Object.defineProperty(exports, "assertOrganizationMatchesOperation", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.assertOrganizationMatchesOperation; }
+  get: function () { return chunkG3OJBGCU_cjs.assertOrganizationMatchesOperation; }
 });
 Object.defineProperty(exports, "assertQueryOrganizationMatchesContext", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.assertQueryOrganizationMatchesContext; }
+  get: function () { return chunkG3OJBGCU_cjs.assertQueryOrganizationMatchesContext; }
 });
 Object.defineProperty(exports, "createApi", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.createApi; }
+  get: function () { return chunkG3OJBGCU_cjs.createApi; }
 });
 Object.defineProperty(exports, "createOrganizationOperation", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.createOrganizationOperation; }
+  get: function () { return chunkG3OJBGCU_cjs.createOrganizationOperation; }
 });
 Object.defineProperty(exports, "describeBackendFailure", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.describeBackendFailure; }
+  get: function () { return chunkG3OJBGCU_cjs.describeBackendFailure; }
 });
 Object.defineProperty(exports, "extractMatrxErrorCode", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.extractMatrxErrorCode; }
+  get: function () { return chunkG3OJBGCU_cjs.extractMatrxErrorCode; }
 });
 Object.defineProperty(exports, "extractMatrxErrorMessage", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.extractMatrxErrorMessage; }
+  get: function () { return chunkG3OJBGCU_cjs.extractMatrxErrorMessage; }
 });
 Object.defineProperty(exports, "getUserMessage", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.getUserMessage; }
+  get: function () { return chunkG3OJBGCU_cjs.getUserMessage; }
 });
 Object.defineProperty(exports, "isBinaryType", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.isBinaryType; }
+  get: function () { return chunkG3OJBGCU_cjs.isBinaryType; }
 });
 Object.defineProperty(exports, "isGenericUserMessage", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.isGenericUserMessage; }
+  get: function () { return chunkG3OJBGCU_cjs.isGenericUserMessage; }
 });
 Object.defineProperty(exports, "isStreamTransportLost", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.isStreamTransportLost; }
+  get: function () { return chunkG3OJBGCU_cjs.isStreamTransportLost; }
 });
 Object.defineProperty(exports, "openJsonOrStream", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.openJsonOrStream; }
+  get: function () { return chunkG3OJBGCU_cjs.openJsonOrStream; }
 });
 Object.defineProperty(exports, "openStream", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.openStream; }
+  get: function () { return chunkG3OJBGCU_cjs.openStream; }
 });
 Object.defineProperty(exports, "parseCallApiError", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.parseCallApiError; }
+  get: function () { return chunkG3OJBGCU_cjs.parseCallApiError; }
 });
 Object.defineProperty(exports, "parseHttpError", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.parseHttpError; }
+  get: function () { return chunkG3OJBGCU_cjs.parseHttpError; }
 });
 Object.defineProperty(exports, "parseHttpErrorBody", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.parseHttpErrorBody; }
+  get: function () { return chunkG3OJBGCU_cjs.parseHttpErrorBody; }
 });
 Object.defineProperty(exports, "parsePersistedBackendError", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.parsePersistedBackendError; }
+  get: function () { return chunkG3OJBGCU_cjs.parsePersistedBackendError; }
 });
 Object.defineProperty(exports, "parseStreamError", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.parseStreamError; }
+  get: function () { return chunkG3OJBGCU_cjs.parseStreamError; }
 });
 Object.defineProperty(exports, "requireOrganizationContext", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.requireOrganizationContext; }
+  get: function () { return chunkG3OJBGCU_cjs.requireOrganizationContext; }
 });
 Object.defineProperty(exports, "unwrapUpstreamError", {
   enumerable: true,
-  get: function () { return chunkBHSHMV22_cjs.unwrapUpstreamError; }
+  get: function () { return chunkG3OJBGCU_cjs.unwrapUpstreamError; }
 });
 Object.defineProperty(exports, "AbortedError", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-DseWSnYe.cjs';
-export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-DseWSnYe.cjs';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-DyDNKgdB.cjs';
+export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-DyDNKgdB.cjs';
 import { CredentialsPort } from '@ai-matrx/auth/credentials';
 export { API_KEY_PREFIX, CredentialsPort, CredentialsSetting, MATRX_HEADERS, MatrxCredential, MatrxCredentialKind, credentialToHeaders, toCredentialsPort } from '@ai-matrx/auth/credentials';
 export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, ResilientFetchOptions, ResilientFetchResult, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.cjs';
@@ -837,6 +837,12 @@ declare function runWaitTimeoutMessage(kind: RunOutputKind, modelLabel: string |
  * out → nothing is sent. Until the server endpoint exists the call answers 404
  * and the primitive stays silent (one `console.debug`, once).
  *
+ * TRANSIENT FAILURES ARE RETRIED. A server rollover (a release every ~30 min)
+ * answers `Failed to fetch` or a 502/503/504 for a few seconds — exactly when a
+ * warm-up matters most, because the new server's caches are cold. A batch that
+ * fails that way goes again after `retryDelaysMs` (default 2s, 8s, 30s) while
+ * the scope is unchanged; a refusal (4xx other than 408/425/429) never retries.
+ *
  * Auth, base URL and `X-Organization-Id` are the injected `MatrxTransport`'s
  * job, exactly as for every other call in this package.
  */
@@ -874,6 +880,11 @@ interface CreateWarmupOptions {
     coalesceMs?: number;
     /** Per-scope per-item dedupe window after a 2xx. Default 60_000ms. */
     dedupeMs?: number;
+    /**
+     * Delay before each retry of a batch that failed transiently (network error,
+     * 408/425/429/5xx); its length is the retry budget. Default 2s, 8s, 30s.
+     */
+    retryDelaysMs?: readonly number[];
     /** Clock, for tests. Default `Date.now`. */
     now?: () => number;
 }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-DseWSnYe.js';
-export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-DseWSnYe.js';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-DyDNKgdB.js';
+export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-DyDNKgdB.js';
 import { CredentialsPort } from '@ai-matrx/auth/credentials';
 export { API_KEY_PREFIX, CredentialsPort, CredentialsSetting, MATRX_HEADERS, MatrxCredential, MatrxCredentialKind, credentialToHeaders, toCredentialsPort } from '@ai-matrx/auth/credentials';
 export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, ResilientFetchOptions, ResilientFetchResult, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.js';
@@ -837,6 +837,12 @@ declare function runWaitTimeoutMessage(kind: RunOutputKind, modelLabel: string |
  * out → nothing is sent. Until the server endpoint exists the call answers 404
  * and the primitive stays silent (one `console.debug`, once).
  *
+ * TRANSIENT FAILURES ARE RETRIED. A server rollover (a release every ~30 min)
+ * answers `Failed to fetch` or a 502/503/504 for a few seconds — exactly when a
+ * warm-up matters most, because the new server's caches are cold. A batch that
+ * fails that way goes again after `retryDelaysMs` (default 2s, 8s, 30s) while
+ * the scope is unchanged; a refusal (4xx other than 408/425/429) never retries.
+ *
  * Auth, base URL and `X-Organization-Id` are the injected `MatrxTransport`'s
  * job, exactly as for every other call in this package.
  */
@@ -874,6 +880,11 @@ interface CreateWarmupOptions {
     coalesceMs?: number;
     /** Per-scope per-item dedupe window after a 2xx. Default 60_000ms. */
     dedupeMs?: number;
+    /**
+     * Delay before each retry of a batch that failed transiently (network error,
+     * 408/425/429/5xx); its length is the retry budget. Default 2s, 8s, 30s.
+     */
+    retryDelaysMs?: readonly number[];
     /** Clock, for tests. Default `Date.now`. */
     now?: () => number;
 }