@ai-matrx/api 0.1.11 → 0.1.12

package/dist/files.js

@@ -1,4 +1,4 @@
-import { openStream, openJsonOrStream } from './chunk-6KHHHBG5.js';
+import { openStream, openJsonOrStream } from './chunk-ILLQUHLF.js';
 import './chunk-PIPE5OML.js';
 
 // src/generated/files.ts
@@ -134,9 +134,9 @@ var $pdfFromImages = { m: "POST", p: "/utilities/pdf/from-images", d: "aidream",
 function pdfFromImages(api, args, options) {
   return openStream(api, $pdfFromImages, args, options);
 }
-var $cleanDocumentContent = { m: "POST", p: "/utilities/pdf/clean-content/{doc_id}", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.clean_document_content" };
+var $cleanDocumentContent = { m: "POST", p: "/utilities/pdf/clean-content/{doc_id}", d: "aidream", a: "guest", o: "required", s: "ndjson_or_json", n: "files.clean_document_content" };
 function cleanDocumentContent(api, args, options) {
-  return openStream(api, $cleanDocumentContent, args, options);
+  return openJsonOrStream(api, $cleanDocumentContent, args, options);
 }
 var $listDocuments = { m: "GET", p: "/utilities/pdf/documents", d: "aidream", a: "guest", o: "optional", n: "files.list_documents" };
 function listDocuments(api, args, options) {

package/dist/human-resources.d.cts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions } from './index-Gj30ybjE.cjs';
+import { A as Api, C as CallOptions } from './index-BSrN3TFD.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 7a09c07daad8cd41c7ae301d9ce90aace006a8f2d3a21dde98885807e5881da5
+ * CONTRACT_SHA256 2516265e2f8f78e7709d9315a452303f8c16b9ff2cddf7e89ab0ef55a93eaf31
  */
 
 /** 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-Gj30ybjE.js';
+import { A as Api, C as CallOptions } from './index-BSrN3TFD.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 7a09c07daad8cd41c7ae301d9ce90aace006a8f2d3a21dde98885807e5881da5
+ * CONTRACT_SHA256 2516265e2f8f78e7709d9315a452303f8c16b9ff2cddf7e89ab0ef55a93eaf31
  */
 
 /** E-13's body, byte-for-byte against the frozen stub. */

package/dist/{index-Gj30ybjE.d.cts → index-BSrN3TFD.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 7a09c07daad8cd41c7ae301d9ce90aace006a8f2d3a21dde98885807e5881da5
+ * CONTRACT_SHA256 2516265e2f8f78e7709d9315a452303f8c16b9ff2cddf7e89ab0ef55a93eaf31
  */
 /** The server contract's hash; the Python `matrx-api` and any native client carry the same value. */
-declare const CONTRACT_SHA256 = "7a09c07daad8cd41c7ae301d9ce90aace006a8f2d3a21dde98885807e5881da5";
+declare const CONTRACT_SHA256 = "2516265e2f8f78e7709d9315a452303f8c16b9ff2cddf7e89ab0ef55a93eaf31";
 /** Which deployment answers (api-deployments.json): default base URLs and the existing env names that override them. */
 declare const DEPLOYMENTS: {
     readonly files: {
@@ -428,9 +428,11 @@ interface Api {
 }
 /** Build the one client. */
 declare function createApi(options?: CreateApiOptions): Api;
+/** A response body that is bytes, not text: octet-stream, archives, PDFs, pictures, sound, video, fonts. */
+declare function isBinaryType(contentType: string): boolean;
 /** Send a streaming operation and parse it per its contract stream kind. */
 declare function openStream<E>(api: Api, op: OperationDescriptor, args?: OperationArgs, options?: CallOptions): Promise<ApiStream<E>>;
 /** Send a conditional (`*_or_json`) operation: JSON when the server answered JSON, else the stream. */
 declare function openJsonOrStream<J, E>(api: Api, op: OperationDescriptor, args?: OperationArgs, options?: CallOptions): Promise<JsonOrStream<J, E>>;
 
-export { type Api as A, readMatrxSseStream as B, type CallOptions as C, DEPLOYMENTS as D, type Environment as E, type HttpMethod as H, type JsonOrStream as J, type MatrxStreamEnvelope as M, type NdjsonEvent as N, type OperationArgs as O, type ReadMatrxNdjsonOptions as R, type SseEvent as S, type UploadProgress as U, type ApiStream as a, type MatrxNdjsonIssue as b, type MatrxStreamEnvelopeObservation as c, type MatrxSseFrame as d, type ApiRequestInfo as e, type AuthTier as f, CONTRACT_SHA256 as g, type CreateApiOptions as h, DOMAINS as i, type DeploymentName as j, type OperationDescriptor as k, type OrgRule as l, type StreamKind as m, createApi as n, openJsonOrStream as o, openStream as p, DEFAULT_MATRX_NDJSON_READ_AHEAD as q, type MatrxNdjsonFramer as r, type MatrxNdjsonFramerOptions as s, type MatrxSseFramer as t, type ReadMatrxSseOptions as u, createMatrxNdjsonFramer as v, createMatrxSseFramer as w, normalizeMatrxStreamEnvelope as x, parseMatrxSseFrame as y, readMatrxNdjsonStream as z };
+export { type Api as A, readMatrxNdjsonStream as B, type CallOptions as C, DEPLOYMENTS as D, type Environment as E, readMatrxSseStream as F, type HttpMethod as H, type JsonOrStream as J, type MatrxStreamEnvelope as M, type NdjsonEvent as N, type OperationArgs as O, type ReadMatrxNdjsonOptions as R, type SseEvent as S, type UploadProgress as U, type ApiStream as a, type MatrxNdjsonIssue as b, type MatrxStreamEnvelopeObservation as c, type MatrxSseFrame as d, type ApiRequestInfo as e, type AuthTier as f, CONTRACT_SHA256 as g, type CreateApiOptions as h, DOMAINS as i, type DeploymentName as j, type OperationDescriptor as k, type OrgRule as l, type StreamKind as m, createApi as n, isBinaryType as o, openJsonOrStream as p, openStream as q, DEFAULT_MATRX_NDJSON_READ_AHEAD as r, type MatrxNdjsonFramer as s, type MatrxNdjsonFramerOptions as t, type MatrxSseFramer as u, type ReadMatrxSseOptions as v, createMatrxNdjsonFramer as w, createMatrxSseFramer as x, normalizeMatrxStreamEnvelope as y, parseMatrxSseFrame as z };

package/dist/{index-Gj30ybjE.d.ts → index-BSrN3TFD.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 7a09c07daad8cd41c7ae301d9ce90aace006a8f2d3a21dde98885807e5881da5
+ * CONTRACT_SHA256 2516265e2f8f78e7709d9315a452303f8c16b9ff2cddf7e89ab0ef55a93eaf31
  */
 /** The server contract's hash; the Python `matrx-api` and any native client carry the same value. */
-declare const CONTRACT_SHA256 = "7a09c07daad8cd41c7ae301d9ce90aace006a8f2d3a21dde98885807e5881da5";
+declare const CONTRACT_SHA256 = "2516265e2f8f78e7709d9315a452303f8c16b9ff2cddf7e89ab0ef55a93eaf31";
 /** Which deployment answers (api-deployments.json): default base URLs and the existing env names that override them. */
 declare const DEPLOYMENTS: {
     readonly files: {
@@ -428,9 +428,11 @@ interface Api {
 }
 /** Build the one client. */
 declare function createApi(options?: CreateApiOptions): Api;
+/** A response body that is bytes, not text: octet-stream, archives, PDFs, pictures, sound, video, fonts. */
+declare function isBinaryType(contentType: string): boolean;
 /** Send a streaming operation and parse it per its contract stream kind. */
 declare function openStream<E>(api: Api, op: OperationDescriptor, args?: OperationArgs, options?: CallOptions): Promise<ApiStream<E>>;
 /** Send a conditional (`*_or_json`) operation: JSON when the server answered JSON, else the stream. */
 declare function openJsonOrStream<J, E>(api: Api, op: OperationDescriptor, args?: OperationArgs, options?: CallOptions): Promise<JsonOrStream<J, E>>;
 
-export { type Api as A, readMatrxSseStream as B, type CallOptions as C, DEPLOYMENTS as D, type Environment as E, type HttpMethod as H, type JsonOrStream as J, type MatrxStreamEnvelope as M, type NdjsonEvent as N, type OperationArgs as O, type ReadMatrxNdjsonOptions as R, type SseEvent as S, type UploadProgress as U, type ApiStream as a, type MatrxNdjsonIssue as b, type MatrxStreamEnvelopeObservation as c, type MatrxSseFrame as d, type ApiRequestInfo as e, type AuthTier as f, CONTRACT_SHA256 as g, type CreateApiOptions as h, DOMAINS as i, type DeploymentName as j, type OperationDescriptor as k, type OrgRule as l, type StreamKind as m, createApi as n, openJsonOrStream as o, openStream as p, DEFAULT_MATRX_NDJSON_READ_AHEAD as q, type MatrxNdjsonFramer as r, type MatrxNdjsonFramerOptions as s, type MatrxSseFramer as t, type ReadMatrxSseOptions as u, createMatrxNdjsonFramer as v, createMatrxSseFramer as w, normalizeMatrxStreamEnvelope as x, parseMatrxSseFrame as y, readMatrxNdjsonStream as z };
+export { type Api as A, readMatrxNdjsonStream as B, type CallOptions as C, DEPLOYMENTS as D, type Environment as E, readMatrxSseStream as F, type HttpMethod as H, type JsonOrStream as J, type MatrxStreamEnvelope as M, type NdjsonEvent as N, type OperationArgs as O, type ReadMatrxNdjsonOptions as R, type SseEvent as S, type UploadProgress as U, type ApiStream as a, type MatrxNdjsonIssue as b, type MatrxStreamEnvelopeObservation as c, type MatrxSseFrame as d, type ApiRequestInfo as e, type AuthTier as f, CONTRACT_SHA256 as g, type CreateApiOptions as h, DOMAINS as i, type DeploymentName as j, type OperationDescriptor as k, type OrgRule as l, type StreamKind as m, createApi as n, isBinaryType as o, openJsonOrStream as p, openStream as q, DEFAULT_MATRX_NDJSON_READ_AHEAD as r, type MatrxNdjsonFramer as s, type MatrxNdjsonFramerOptions as t, type MatrxSseFramer as u, type ReadMatrxSseOptions as v, createMatrxNdjsonFramer as w, createMatrxSseFramer as x, normalizeMatrxStreamEnvelope as y, parseMatrxSseFrame as z };

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkMVXD6WI6_cjs = require('./chunk-MVXD6WI6.cjs');
-var chunk2ZHIYXHV_cjs = require('./chunk-2ZHIYXHV.cjs');
+var chunkU63KIQSS_cjs = require('./chunk-U63KIQSS.cjs');
 var chunkPKYPPATQ_cjs = require('./chunk-PKYPPATQ.cjs');
 var format = require('@ai-matrx/kit/format');
 
@@ -43,7 +43,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 chunk2ZHIYXHV_cjs.OrganizationContextError(
+    throw new chunkU63KIQSS_cjs.OrganizationContextError(
       "organization_context_mismatch",
       "Request body organization_id must match the request context organization."
     );
@@ -115,14 +115,14 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
   };
   async function* events() {
     if (!response.body) {
-      throw new chunk2ZHIYXHV_cjs.BackendApiError({
+      throw new chunkU63KIQSS_cjs.BackendApiError({
         code: "internal_error",
         detail: "Response has no body",
         userMessage: "No response received from server"
       });
     }
     try {
-      for await (const envelope of chunk2ZHIYXHV_cjs.readMatrxNdjsonStream(response.body, {
+      for await (const envelope of chunkU63KIQSS_cjs.readMatrxNdjsonStream(response.body, {
         ...signal ? { signal } : {},
         ...hooks.onMalformedLine ? { onMalformedLine: hooks.onMalformedLine } : {},
         ...hooks.onUnknownEnvelope ? { onUnknownEnvelope: hooks.onUnknownEnvelope } : {}
@@ -134,7 +134,7 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
       if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
         return;
       }
-      const transportError = error instanceof chunk2ZHIYXHV_cjs.BackendApiError ? error : new chunk2ZHIYXHV_cjs.StreamTransportError({
+      const transportError = error instanceof chunkU63KIQSS_cjs.BackendApiError ? error : new chunkU63KIQSS_cjs.StreamTransportError({
         detail: error instanceof Error ? error.message : "The response stream ended unexpectedly.",
         details: error,
         ...ids.requestId ? { requestId: ids.requestId } : {}
@@ -151,7 +151,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: chunk2ZHIYXHV_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
+    message: chunkU63KIQSS_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
     status: response.status,
     serverDetail
   };
@@ -159,7 +159,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 chunk2ZHIYXHV_cjs.sendOnWire({
+  const { response } = await chunkU63KIQSS_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 chunk2ZHIYXHV_cjs.WIRE_FETCH_OPTION_KEYS) {
+  for (const key of chunkU63KIQSS_cjs.WIRE_FETCH_OPTION_KEYS) {
     if (init[key] !== void 0) fetchOptions[key] = init[key];
   }
   try {
-    const { response } = await chunk2ZHIYXHV_cjs.sendOnWire({
+    const { response } = await chunkU63KIQSS_cjs.sendOnWire({
       url,
       method: init.method ?? "GET",
       fetchOptions,
@@ -232,8 +232,8 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
     if (chunkPKYPPATQ_cjs.isNetError(error) && error.code === "aborted") {
       throw callerSignal?.reason instanceof Error ? callerSignal.reason : new DOMException("The request was cancelled.", "AbortError");
     }
-    if (options.timeoutMs !== void 0 && chunkPKYPPATQ_cjs.isNetError(error) && error.code === "connect-timeout") {
-      throw new chunk2ZHIYXHV_cjs.BackendApiError({
+    if (options.timeoutMs !== void 0 && chunkPKYPPATQ_cjs.isNetError(error) && (error.code === "connect-timeout" || error.code === "total-timeout")) {
+      throw new chunkU63KIQSS_cjs.BackendApiError({
         code: "request_timeout",
         detail: `${init.method ?? "GET"} ${url} exceeded ${options.timeoutMs}ms`,
         userMessage: "The request timed out \u2014 please retry.",
@@ -247,7 +247,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
   }
 }
 async function readMatrxJsonResponse(response) {
-  if (!response.ok) throw await chunk2ZHIYXHV_cjs.parseHttpError(response);
+  if (!response.ok) throw await chunkU63KIQSS_cjs.parseHttpError(response);
   if (response.status === 204) return null;
   return await response.json();
 }
@@ -257,7 +257,7 @@ function classifyStatus(status) {
   return status >= 400 && status < 500 ? "validation_error" : "http_error";
 }
 function normalizeMatrxError(err) {
-  if (err instanceof chunk2ZHIYXHV_cjs.OrganizationContextError) {
+  if (err instanceof chunkU63KIQSS_cjs.OrganizationContextError) {
     return {
       type: "validation_error",
       message: err.message,
@@ -269,7 +269,7 @@ function normalizeMatrxError(err) {
   if (err instanceof DOMException && err.name === "AbortError") {
     return { type: "abort_error", message: "Request was cancelled." };
   }
-  if (err instanceof chunk2ZHIYXHV_cjs.MatrxApiError) {
+  if (err instanceof chunkU63KIQSS_cjs.MatrxApiError) {
     return {
       type: classifyStatus(err.status),
       message: honestTransportMessage(err.message, err.status),
@@ -279,7 +279,7 @@ function normalizeMatrxError(err) {
       name: err.name
     };
   }
-  if (err instanceof chunk2ZHIYXHV_cjs.BackendApiError) {
+  if (err instanceof chunkU63KIQSS_cjs.BackendApiError) {
     return {
       type: "network_error",
       message: honestTransportMessage(
@@ -375,26 +375,26 @@ function createMatrxTransport(options) {
   }
   const resolve = resolveTarget ?? (() => ({ baseUrl }));
   const resolveVersion = () => {
-    if (aiApiVersion === void 0) return chunk2ZHIYXHV_cjs.MATRX_AI_API_VERSION_DEFAULT;
+    if (aiApiVersion === void 0) return chunkU63KIQSS_cjs.MATRX_AI_API_VERSION_DEFAULT;
     return typeof aiApiVersion === "function" ? aiApiVersion() : aiApiVersion;
   };
   const resolveOrganizationId = (callOrganizationId) => {
     if (organizationId === void 0) return null;
-    if (callOrganizationId !== null) return chunk2ZHIYXHV_cjs.requireOrganizationContext(callOrganizationId);
+    if (callOrganizationId !== null) return chunkU63KIQSS_cjs.requireOrganizationContext(callOrganizationId);
     const candidate = typeof organizationId === "function" ? organizationId() : organizationId;
-    return chunk2ZHIYXHV_cjs.requireOrganizationContext(candidate);
+    return chunkU63KIQSS_cjs.requireOrganizationContext(candidate);
   };
   return {
     async fetch(path, init) {
       const target = await resolve(init);
       const callOrganizationId = readOrganizationHeader(init.headers);
-      const versionedPath = chunk2ZHIYXHV_cjs.applyAiApiVersion(path, resolveVersion());
+      const versionedPath = chunkU63KIQSS_cjs.applyAiApiVersion(path, resolveVersion());
       const url = `${target.baseUrl}${versionedPath}`;
       const policyHeaders = stripContentType(target.policyHeaders ?? {});
       let overHeaders = callOrganizationId === null ? policyHeaders : stripOrganizationHeader(policyHeaders);
       const orgId = resolveOrganizationId(callOrganizationId);
       if (orgId !== null) {
-        overHeaders = chunk2ZHIYXHV_cjs.applyOrganizationContextHeader(overHeaders, orgId);
+        overHeaders = chunkU63KIQSS_cjs.applyOrganizationContextHeader(overHeaders, orgId);
       }
       const wireHeaders = callOrganizationId === null ? { ...init.headers } : stripOrganizationHeader({ ...init.headers });
       const info = {
@@ -407,7 +407,7 @@ function createMatrxTransport(options) {
       diagnostics?.onRequest?.(info);
       let response;
       try {
-        ({ response } = await chunk2ZHIYXHV_cjs.sendOnWire(
+        ({ response } = await chunkU63KIQSS_cjs.sendOnWire(
           {
             url,
             method: init.method,
@@ -432,11 +432,11 @@ function createMatrxTransport(options) {
       }
       if (!response.ok && !expectedErrorStatuses?.includes(response.status)) {
         const serverDetail = await response.clone().json().catch(() => void 0);
-        const code = chunk2ZHIYXHV_cjs.extractMatrxErrorCode(serverDetail);
+        const code = chunkU63KIQSS_cjs.extractMatrxErrorCode(serverDetail);
         diagnostics?.onError?.(
           {
             type: classifyStatus(response.status),
-            message: chunk2ZHIYXHV_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
+            message: chunkU63KIQSS_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
             status: response.status,
             serverDetail,
             ...code ? { code } : {}
@@ -715,7 +715,7 @@ async function readServerDetail(response) {
   }
 }
 async function throwApiError(path, response) {
-  throw new chunk2ZHIYXHV_cjs.MatrxApiError({
+  throw new chunkU63KIQSS_cjs.MatrxApiError({
     status: response.status,
     path,
     serverDetail: await readServerDetail(response)
@@ -736,7 +736,7 @@ function toRunHandle(response, options) {
   return {
     requestId: response.headers.get("X-Request-ID"),
     conversationId: response.headers.get("X-Conversation-ID"),
-    events: chunk2ZHIYXHV_cjs.readMatrxNdjsonStream(response.body, {
+    events: chunkU63KIQSS_cjs.readMatrxNdjsonStream(response.body, {
       ...options.signal ? { signal: options.signal } : {},
       ...options.maxReadAhead !== void 0 ? { maxReadAhead: options.maxReadAhead } : {},
       ...options.onMalformedLine ? { onMalformedLine: options.onMalformedLine } : {},
@@ -759,7 +759,7 @@ async function requestStream(transport, path, options) {
   });
   if (!response.ok) return throwApiError(path, response);
   if (!response.body) {
-    throw new chunk2ZHIYXHV_cjs.MatrxApiError({
+    throw new chunkU63KIQSS_cjs.MatrxApiError({
       status: response.status,
       path,
       serverDetail: { code: "missing_response_body" },
@@ -819,7 +819,7 @@ async function getRuntimeOperationStatus(transport, requestId, options = {}) {
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunk2ZHIYXHV_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkU63KIQSS_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -834,7 +834,7 @@ async function getRuntimeOperationsByLink(transport, linkKind, linkId, options =
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunk2ZHIYXHV_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkU63KIQSS_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -875,7 +875,7 @@ async function* followRuntimeOperationEvents(transport, executionId, options = {
       ...options.signal ? { signal: options.signal } : {}
     }
   );
-  const frames = chunk2ZHIYXHV_cjs.readMatrxSseStream(
+  const frames = chunkU63KIQSS_cjs.readMatrxSseStream(
     response.body,
     options.onIncomplete ? { onIncomplete: options.onIncomplete } : {}
   );
@@ -1078,7 +1078,7 @@ async function openMatrxStream(transport, path, options = {}) {
   return toRunHandle(response, options);
 }
 function withRunOrganization(transport, organizationId) {
-  const orgId = chunk2ZHIYXHV_cjs.requireOrganizationContext(organizationId);
+  const orgId = chunkU63KIQSS_cjs.requireOrganizationContext(organizationId);
   return {
     fetch: (path, init) => transport.fetch(path, {
       ...init,
@@ -1105,7 +1105,7 @@ async function followWorkflowRunEvents(transport, runId, options) {
     throw error;
   }
   try {
-    for await (const frame of chunk2ZHIYXHV_cjs.readMatrxSseStream(
+    for await (const frame of chunkU63KIQSS_cjs.readMatrxSseStream(
       response.body
     )) {
       if (frame.event === "end") return { ended: true };
@@ -1151,7 +1151,7 @@ async function resumeOrRejoin(transport, resumeCall, options) {
   } catch (error) {
     const target = readLiveRunRejoin(error);
     if (!target) {
-      if (error instanceof chunk2ZHIYXHV_cjs.MatrxApiError && isResumeConflict(error)) {
+      if (error instanceof chunkU63KIQSS_cjs.MatrxApiError && isResumeConflict(error)) {
         return { kind: "resume_conflict", error };
       }
       throw error;
@@ -1567,7 +1567,7 @@ async function reportProviderSessionUsage(transport, usage, options = {}) {
     });
     return "ok";
   } catch (error) {
-    if (error instanceof chunk2ZHIYXHV_cjs.MatrxApiError) {
+    if (error instanceof chunkU63KIQSS_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})`);
@@ -2267,147 +2267,151 @@ Object.defineProperty(exports, "toCredentialsPort", {
 });
 Object.defineProperty(exports, "BackendApiError", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.BackendApiError; }
+  get: function () { return chunkU63KIQSS_cjs.BackendApiError; }
 });
 Object.defineProperty(exports, "CONTRACT_SHA256", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.CONTRACT_SHA256; }
+  get: function () { return chunkU63KIQSS_cjs.CONTRACT_SHA256; }
 });
 Object.defineProperty(exports, "DEPLOYMENTS", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.DEPLOYMENTS; }
+  get: function () { return chunkU63KIQSS_cjs.DEPLOYMENTS; }
 });
 Object.defineProperty(exports, "DOMAINS", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.DOMAINS; }
+  get: function () { return chunkU63KIQSS_cjs.DOMAINS; }
 });
 Object.defineProperty(exports, "MATRX_AI_API_VERSION_DEFAULT", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.MATRX_AI_API_VERSION_DEFAULT; }
+  get: function () { return chunkU63KIQSS_cjs.MATRX_AI_API_VERSION_DEFAULT; }
 });
 Object.defineProperty(exports, "MatrxApiError", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.MatrxApiError; }
+  get: function () { return chunkU63KIQSS_cjs.MatrxApiError; }
 });
 Object.defineProperty(exports, "OrganizationContextError", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.OrganizationContextError; }
+  get: function () { return chunkU63KIQSS_cjs.OrganizationContextError; }
 });
 Object.defineProperty(exports, "StreamTransportError", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.StreamTransportError; }
+  get: function () { return chunkU63KIQSS_cjs.StreamTransportError; }
 });
 Object.defineProperty(exports, "V2_COVERED_AI_PATH_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.V2_COVERED_AI_PATH_TEMPLATES; }
+  get: function () { return chunkU63KIQSS_cjs.V2_COVERED_AI_PATH_TEMPLATES; }
 });
 Object.defineProperty(exports, "aiVersionPathOverrides", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.aiVersionPathOverrides; }
+  get: function () { return chunkU63KIQSS_cjs.aiVersionPathOverrides; }
 });
 Object.defineProperty(exports, "applyAiApiVersion", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.applyAiApiVersion; }
+  get: function () { return chunkU63KIQSS_cjs.applyAiApiVersion; }
 });
 Object.defineProperty(exports, "applyOrganizationContextHeader", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.applyOrganizationContextHeader; }
+  get: function () { return chunkU63KIQSS_cjs.applyOrganizationContextHeader; }
 });
 Object.defineProperty(exports, "assertOrganizationMatchesOperation", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.assertOrganizationMatchesOperation; }
+  get: function () { return chunkU63KIQSS_cjs.assertOrganizationMatchesOperation; }
 });
 Object.defineProperty(exports, "assertQueryOrganizationMatchesContext", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.assertQueryOrganizationMatchesContext; }
+  get: function () { return chunkU63KIQSS_cjs.assertQueryOrganizationMatchesContext; }
 });
 Object.defineProperty(exports, "createApi", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.createApi; }
+  get: function () { return chunkU63KIQSS_cjs.createApi; }
 });
 Object.defineProperty(exports, "createOrganizationOperation", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.createOrganizationOperation; }
+  get: function () { return chunkU63KIQSS_cjs.createOrganizationOperation; }
 });
 Object.defineProperty(exports, "describeBackendFailure", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.describeBackendFailure; }
+  get: function () { return chunkU63KIQSS_cjs.describeBackendFailure; }
 });
 Object.defineProperty(exports, "extractMatrxErrorCode", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.extractMatrxErrorCode; }
+  get: function () { return chunkU63KIQSS_cjs.extractMatrxErrorCode; }
 });
 Object.defineProperty(exports, "extractMatrxErrorMessage", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.extractMatrxErrorMessage; }
+  get: function () { return chunkU63KIQSS_cjs.extractMatrxErrorMessage; }
 });
 Object.defineProperty(exports, "fetchWithMatrxProtocolFallback", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.fetchWithMatrxProtocolFallback; }
+  get: function () { return chunkU63KIQSS_cjs.fetchWithMatrxProtocolFallback; }
 });
 Object.defineProperty(exports, "getUserMessage", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.getUserMessage; }
+  get: function () { return chunkU63KIQSS_cjs.getUserMessage; }
+});
+Object.defineProperty(exports, "isBinaryType", {
+  enumerable: true,
+  get: function () { return chunkU63KIQSS_cjs.isBinaryType; }
 });
 Object.defineProperty(exports, "isCoveredAiPath", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.isCoveredAiPath; }
+  get: function () { return chunkU63KIQSS_cjs.isCoveredAiPath; }
 });
 Object.defineProperty(exports, "isGenericUserMessage", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.isGenericUserMessage; }
+  get: function () { return chunkU63KIQSS_cjs.isGenericUserMessage; }
 });
 Object.defineProperty(exports, "isStreamTransportLost", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.isStreamTransportLost; }
+  get: function () { return chunkU63KIQSS_cjs.isStreamTransportLost; }
 });
 Object.defineProperty(exports, "isV2Path", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.isV2Path; }
+  get: function () { return chunkU63KIQSS_cjs.isV2Path; }
 });
 Object.defineProperty(exports, "openJsonOrStream", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.openJsonOrStream; }
+  get: function () { return chunkU63KIQSS_cjs.openJsonOrStream; }
 });
 Object.defineProperty(exports, "openStream", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.openStream; }
+  get: function () { return chunkU63KIQSS_cjs.openStream; }
 });
 Object.defineProperty(exports, "parseCallApiError", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.parseCallApiError; }
+  get: function () { return chunkU63KIQSS_cjs.parseCallApiError; }
 });
 Object.defineProperty(exports, "parseHttpError", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.parseHttpError; }
+  get: function () { return chunkU63KIQSS_cjs.parseHttpError; }
 });
 Object.defineProperty(exports, "parseHttpErrorBody", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.parseHttpErrorBody; }
+  get: function () { return chunkU63KIQSS_cjs.parseHttpErrorBody; }
 });
 Object.defineProperty(exports, "parsePersistedBackendError", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.parsePersistedBackendError; }
+  get: function () { return chunkU63KIQSS_cjs.parsePersistedBackendError; }
 });
 Object.defineProperty(exports, "parseStreamError", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.parseStreamError; }
+  get: function () { return chunkU63KIQSS_cjs.parseStreamError; }
 });
 Object.defineProperty(exports, "requireOrganizationContext", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.requireOrganizationContext; }
+  get: function () { return chunkU63KIQSS_cjs.requireOrganizationContext; }
 });
 Object.defineProperty(exports, "toV1FallbackUrl", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.toV1FallbackUrl; }
+  get: function () { return chunkU63KIQSS_cjs.toV1FallbackUrl; }
 });
 Object.defineProperty(exports, "toV2Path", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.toV2Path; }
+  get: function () { return chunkU63KIQSS_cjs.toV2Path; }
 });
 Object.defineProperty(exports, "unwrapUpstreamError", {
   enumerable: true,
-  get: function () { return chunk2ZHIYXHV_cjs.unwrapUpstreamError; }
+  get: function () { return chunkU63KIQSS_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-Gj30ybjE.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 openJsonOrStream, p as openStream } from './index-Gj30ybjE.cjs';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-BSrN3TFD.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-BSrN3TFD.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';
 import { ResilientFetchOptions, ResilientFetchResult } from './net.cjs';

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-Gj30ybjE.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 openJsonOrStream, p as openStream } from './index-Gj30ybjE.js';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-BSrN3TFD.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-BSrN3TFD.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';
 import { ResilientFetchOptions, ResilientFetchResult } from './net.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 export { API_KEY_PREFIX, MATRX_HEADERS, credentialToHeaders, toCredentialsPort } from './chunk-7MZPBCFV.js';
-import { OrganizationContextError, sendOnWire, WIRE_FETCH_OPTION_KEYS, BackendApiError, parseHttpError, MatrxApiError, applyAiApiVersion, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, MATRX_AI_API_VERSION_DEFAULT, StreamTransportError } from './chunk-6KHHHBG5.js';
-export { BackendApiError, CONTRACT_SHA256, DEPLOYMENTS, DOMAINS, MATRX_AI_API_VERSION_DEFAULT, MatrxApiError, OrganizationContextError, StreamTransportError, V2_COVERED_AI_PATH_TEMPLATES, aiVersionPathOverrides, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, fetchWithMatrxProtocolFallback, getUserMessage, isCoveredAiPath, isGenericUserMessage, isStreamTransportLost, isV2Path, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parsePersistedBackendError, parseStreamError, requireOrganizationContext, toV1FallbackUrl, toV2Path, unwrapUpstreamError } from './chunk-6KHHHBG5.js';
+import { OrganizationContextError, sendOnWire, WIRE_FETCH_OPTION_KEYS, BackendApiError, parseHttpError, MatrxApiError, applyAiApiVersion, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, MATRX_AI_API_VERSION_DEFAULT, StreamTransportError } from './chunk-ILLQUHLF.js';
+export { BackendApiError, CONTRACT_SHA256, DEPLOYMENTS, DOMAINS, MATRX_AI_API_VERSION_DEFAULT, MatrxApiError, OrganizationContextError, StreamTransportError, V2_COVERED_AI_PATH_TEMPLATES, aiVersionPathOverrides, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, fetchWithMatrxProtocolFallback, getUserMessage, isBinaryType, isCoveredAiPath, isGenericUserMessage, isStreamTransportLost, isV2Path, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parsePersistedBackendError, parseStreamError, requireOrganizationContext, toV1FallbackUrl, toV2Path, unwrapUpstreamError } from './chunk-ILLQUHLF.js';
 import { isNetError, extractErrorMessage } from './chunk-PIPE5OML.js';
 export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetworkError, OfflineError, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './chunk-PIPE5OML.js';
 import { formatDurationSeconds } from '@ai-matrx/kit/format';
@@ -232,7 +232,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
     if (isNetError(error) && error.code === "aborted") {
       throw callerSignal?.reason instanceof Error ? callerSignal.reason : new DOMException("The request was cancelled.", "AbortError");
     }
-    if (options.timeoutMs !== void 0 && isNetError(error) && error.code === "connect-timeout") {
+    if (options.timeoutMs !== void 0 && isNetError(error) && (error.code === "connect-timeout" || error.code === "total-timeout")) {
       throw new BackendApiError({
         code: "request_timeout",
         detail: `${init.method ?? "GET"} ${url} exceeded ${options.timeoutMs}ms`,