@ai-matrx/api 0.1.9 → 0.1.10

package/dist/index.cjs

@@ -1,95 +1,10 @@
 'use strict';
 
-var chunkFNIYADWI_cjs = require('./chunk-FNIYADWI.cjs');
 var chunkMVXD6WI6_cjs = require('./chunk-MVXD6WI6.cjs');
-var chunkPMGKZ4FT_cjs = require('./chunk-PMGKZ4FT.cjs');
-var chunk2SXAAKGV_cjs = require('./chunk-2SXAAKGV.cjs');
-var credentials = require('@ai-matrx/auth/credentials');
+var chunkSPASYIUH_cjs = require('./chunk-SPASYIUH.cjs');
+var chunkPKYPPATQ_cjs = require('./chunk-PKYPPATQ.cjs');
 var format = require('@ai-matrx/kit/format');
 
-// src/core/protocol.ts
-var MATRX_AI_API_VERSION_DEFAULT = "v2";
-var V2_COVERED_AI_PATH_TEMPLATES = [
-  "/ai/manual",
-  "/ai/chat",
-  "/ai/agents/{agent_id}",
-  "/ai/agent/{agent_id}",
-  // singular alias — behaves identically
-  "/ai/conversations/{conversation_id}",
-  "/ai/conversation/{conversation_id}",
-  // singular alias
-  "/ai/prompts/{prompt_id}",
-  // saved-prompt execution
-  "/ai/mandates/{mandate_key}"
-  // THE MANDATE DOOR — `/v2` sibling exists (routers/v2.py)
-];
-function toV2Path(path) {
-  const withLead = path.startsWith("/") ? path : `/${path}`;
-  if (withLead.startsWith("/api/")) {
-    const rest = withLead.slice("/api".length);
-    return rest.startsWith("/v2/") ? withLead : `/api/v2${rest}`;
-  }
-  return withLead.startsWith("/v2/") ? withLead : `/v2${withLead}`;
-}
-var COVERED_INTERPOLATED_PATH = [
-  /^(?:\/api)?\/ai\/manual$/,
-  /^(?:\/api)?\/ai\/chat$/,
-  /^(?:\/api)?\/ai\/agents\/[^/]+$/,
-  /^(?:\/api)?\/ai\/agent\/[^/]+$/,
-  /^(?:\/api)?\/ai\/conversations\/[^/]+$/,
-  /^(?:\/api)?\/ai\/conversation\/[^/]+$/,
-  /^(?:\/api)?\/ai\/prompts\/[^/]+$/,
-  // `/warm` etc. deliberately don't match
-  /^(?:\/api)?\/ai\/mandates\/[^/]+$/
-  // the mandate door
-];
-function isCoveredAiPath(path) {
-  return COVERED_INTERPOLATED_PATH.some((re) => re.test(path));
-}
-function isV2Path(pathOrUrl) {
-  return /\/v2\/ai\//.test(pathOrUrl);
-}
-function toV1FallbackUrl(url) {
-  return url.replace(/\/v2\/ai\//, "/ai/");
-}
-function applyAiApiVersion(path, version) {
-  if (version !== "v2") return path;
-  return isCoveredAiPath(path) ? toV2Path(path) : path;
-}
-async function fetchWithMatrxProtocolFallback(url, init, opts = {}) {
-  const { onDowngrade, ...fetchOpts } = opts;
-  const logDowngrade = (reason, status2) => {
-    console.warn(
-      `[matrx] ai_v2_downgrade \u2192 retrying on v1. v2=${url} reason=${reason}`
-    );
-    onDowngrade?.({ url, reason, ...status2 !== void 0 ? { status: status2 } : {} });
-  };
-  if (!isV2Path(url)) return chunk2SXAAKGV_cjs.resilientFetch(url, init, fetchOpts);
-  let result;
-  try {
-    result = await chunk2SXAAKGV_cjs.resilientFetch(url, init, fetchOpts);
-  } catch (err) {
-    const isAbort2 = chunk2SXAAKGV_cjs.isNetError(err) && err.code === "aborted" || err instanceof Error && err.name === "AbortError";
-    if (isAbort2) throw err;
-    logDowngrade(String(err));
-    return chunk2SXAAKGV_cjs.resilientFetch(toV1FallbackUrl(url), init, fetchOpts);
-  }
-  const status = result.response.status;
-  if (status === 404 || status === 405 || status >= 500) {
-    logDowngrade(`HTTP ${status}`, status);
-    return chunk2SXAAKGV_cjs.resilientFetch(toV1FallbackUrl(url), init, fetchOpts);
-  }
-  return result;
-}
-function aiVersionPathOverrides(version) {
-  if (version !== "v2") return {};
-  const map = {};
-  for (const template of V2_COVERED_AI_PATH_TEMPLATES) {
-    map[template] = toV2Path(template);
-  }
-  return map;
-}
-
 // src/core/call.ts
 function buildMatrxRequestUrl(baseUrl, pathTemplate, pathParams, queryParams) {
   let resolvedPath = pathTemplate;
@@ -128,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 chunkPMGKZ4FT_cjs.OrganizationContextError(
+    throw new chunkSPASYIUH_cjs.OrganizationContextError(
       "organization_context_mismatch",
       "Request body organization_id must match the request context organization."
     );
@@ -200,14 +115,14 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
   };
   async function* events() {
     if (!response.body) {
-      throw new chunkPMGKZ4FT_cjs.BackendApiError({
+      throw new chunkSPASYIUH_cjs.BackendApiError({
         code: "internal_error",
         detail: "Response has no body",
         userMessage: "No response received from server"
       });
     }
     try {
-      for await (const envelope of chunkPMGKZ4FT_cjs.readMatrxNdjsonStream(response.body, {
+      for await (const envelope of chunkSPASYIUH_cjs.readMatrxNdjsonStream(response.body, {
         ...signal ? { signal } : {},
         ...hooks.onMalformedLine ? { onMalformedLine: hooks.onMalformedLine } : {},
         ...hooks.onUnknownEnvelope ? { onUnknownEnvelope: hooks.onUnknownEnvelope } : {}
@@ -219,7 +134,7 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
       if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
         return;
       }
-      const transportError = error instanceof chunkPMGKZ4FT_cjs.BackendApiError ? error : new chunkPMGKZ4FT_cjs.StreamTransportError({
+      const transportError = error instanceof chunkSPASYIUH_cjs.BackendApiError ? error : new chunkSPASYIUH_cjs.StreamTransportError({
         detail: error instanceof Error ? error.message : "The response stream ended unexpectedly.",
         details: error,
         ...ids.requestId ? { requestId: ids.requestId } : {}
@@ -236,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: chunkPMGKZ4FT_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
+    message: chunkSPASYIUH_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
     status: response.status,
     serverDetail
   };
@@ -244,21 +159,17 @@ 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 fetchWithMatrxProtocolFallback(
-    request.url,
-    {
-      method: request.method,
-      headers: request.headers,
-      ...sendsBody ? { body: JSON.stringify(request.body) } : {}
-    },
-    {
-      ...request.signal ? { signal: request.signal } : {},
-      connectTimeoutMs: request.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS,
-      totalTimeoutMs: request.stream ? null : request.totalTimeoutMs === void 0 ? DEFAULT_JSON_TOTAL_TIMEOUT_MS : request.totalTimeoutMs,
-      throwOnHttpError: false,
-      ...hooks.onProtocolDowngrade ? { onDowngrade: hooks.onProtocolDowngrade } : {}
-    }
-  );
+  const { response } = await chunkSPASYIUH_cjs.sendOnWire({
+    url: request.url,
+    method: request.method,
+    headers: request.headers,
+    ...sendsBody ? { body: JSON.stringify(request.body) } : {},
+    ...request.signal ? { signal: request.signal } : {},
+    connectTimeoutMs: request.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS,
+    totalTimeoutMs: request.stream ? null : request.totalTimeoutMs === void 0 ? DEFAULT_JSON_TOTAL_TIMEOUT_MS : request.totalTimeoutMs,
+    ...request.stream ? { stream: true } : {},
+    ...hooks.onProtocolDowngrade ? { onProtocolDowngrade: hooks.onProtocolDowngrade } : {}
+  });
   const requestId = response.headers.get("X-Request-ID");
   const conversationId = response.headers.get("X-Conversation-ID");
   const idFields = {
@@ -294,47 +205,54 @@ async function executeMatrxCall(request, hooks = {}) {
 }
 async function sendMatrxRequest(url, init = {}, options = {}) {
   const callerSignal = options.signal ?? init.signal ?? void 0;
-  if (options.timeoutMs === void 0) {
-    return fetch(url, { ...init, ...callerSignal ? { signal: callerSignal } : {} });
-  }
-  const controller = new AbortController();
-  const onCallerAbort = () => controller.abort(callerSignal?.reason);
-  if (callerSignal) {
-    if (callerSignal.aborted) controller.abort(callerSignal.reason);
-    else callerSignal.addEventListener("abort", onCallerAbort, { once: true });
-  }
-  let timedOut = false;
-  const timer = setTimeout(() => {
-    timedOut = true;
-    controller.abort();
-  }, options.timeoutMs);
+  const headers = {};
+  new Headers(init.headers ?? {}).forEach((value, name) => {
+    headers[name] = value;
+  });
   try {
-    return await fetch(url, { ...init, signal: controller.signal });
+    const { response } = await chunkSPASYIUH_cjs.sendOnWire({
+      url,
+      method: init.method ?? "GET",
+      headers,
+      ...init.body !== void 0 && init.body !== null ? { body: init.body } : {},
+      ...callerSignal ? { signal: callerSignal } : {},
+      // No deadline unless the caller set one: the raw lane carries bytes
+      // and long reads whose length only the caller knows.
+      connectTimeoutMs: options.timeoutMs ?? 24 * 60 * 60 * 1e3,
+      totalTimeoutMs: null,
+      ...options.onUploadProgress ? { onUploadProgress: options.onUploadProgress } : {}
+    });
+    return response;
   } catch (error) {
-    if (timedOut) {
-      throw new chunkPMGKZ4FT_cjs.BackendApiError({
+    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 chunkSPASYIUH_cjs.BackendApiError({
         code: "request_timeout",
         detail: `${init.method ?? "GET"} ${url} exceeded ${options.timeoutMs}ms`,
         userMessage: "The request timed out \u2014 please retry.",
         status: 504
       });
     }
+    if (chunkPKYPPATQ_cjs.isNetError(error) && (error.code === "network" || error.code === "offline")) {
+      throw error.cause instanceof Error ? error.cause : error;
+    }
     throw error;
-  } finally {
-    clearTimeout(timer);
-    callerSignal?.removeEventListener("abort", onCallerAbort);
   }
 }
 async function readMatrxJsonResponse(response) {
-  if (!response.ok) throw await chunkPMGKZ4FT_cjs.parseHttpError(response);
+  if (!response.ok) throw await chunkSPASYIUH_cjs.parseHttpError(response);
   if (response.status === 204) return null;
   return await response.json();
 }
+
+// src/core/client.ts
 function classifyStatus(status) {
   return status >= 400 && status < 500 ? "validation_error" : "http_error";
 }
 function normalizeMatrxError(err) {
-  if (err instanceof chunkPMGKZ4FT_cjs.OrganizationContextError) {
+  if (err instanceof chunkSPASYIUH_cjs.OrganizationContextError) {
     return {
       type: "validation_error",
       message: err.message,
@@ -346,7 +264,7 @@ function normalizeMatrxError(err) {
   if (err instanceof DOMException && err.name === "AbortError") {
     return { type: "abort_error", message: "Request was cancelled." };
   }
-  if (err instanceof chunkPMGKZ4FT_cjs.MatrxApiError) {
+  if (err instanceof chunkSPASYIUH_cjs.MatrxApiError) {
     return {
       type: classifyStatus(err.status),
       message: honestTransportMessage(err.message, err.status),
@@ -356,7 +274,7 @@ function normalizeMatrxError(err) {
       name: err.name
     };
   }
-  if (err instanceof chunkPMGKZ4FT_cjs.BackendApiError) {
+  if (err instanceof chunkSPASYIUH_cjs.BackendApiError) {
     return {
       type: "network_error",
       message: honestTransportMessage(
@@ -369,7 +287,7 @@ function normalizeMatrxError(err) {
       ...err.details !== null ? { serverDetail: err.details } : {}
     };
   }
-  if (chunk2SXAAKGV_cjs.isNetError(err)) {
+  if (chunkPKYPPATQ_cjs.isNetError(err)) {
     if (err.code === "aborted") {
       return { type: "abort_error", message: err.message };
     }
@@ -403,7 +321,7 @@ function normalizeMatrxError(err) {
     }
     return { type: "network_error", message: err.message };
   }
-  return { type: "unknown", message: chunk2SXAAKGV_cjs.extractErrorMessage(err) };
+  return { type: "unknown", message: chunkPKYPPATQ_cjs.extractErrorMessage(err) };
 }
 var PRODUCTION_CONNECT_TIMEOUT_MS = 15e3;
 function stripContentType(headers) {
@@ -414,6 +332,7 @@ function stripContentType(headers) {
   );
 }
 var ORGANIZATION_HEADER = "x-organization-id";
+var ORGANIZATION_HEADER_CANONICAL = "X-Organization-Id";
 function readOrganizationHeader(headers) {
   for (const [name, value] of Object.entries(headers ?? {})) {
     if (name.toLowerCase() === ORGANIZATION_HEADER && value.trim().length > 0) {
@@ -433,14 +352,16 @@ function createMatrxTransport(options) {
   const {
     baseUrl,
     resolveTarget,
-    credentials: credentials$1,
+    credentials,
     organizationId,
     aiApiVersion,
     connectTimeoutMs = PRODUCTION_CONNECT_TIMEOUT_MS,
     totalTimeoutMs = null,
     expectedErrorStatuses,
     diagnostics,
-    source = "matrxTransport"
+    source = "matrxTransport",
+    refreshCredentials,
+    readyTimeoutMs
   } = options;
   if (baseUrl === void 0 === (resolveTarget === void 0)) {
     throw new Error(
@@ -449,32 +370,28 @@ function createMatrxTransport(options) {
   }
   const resolve = resolveTarget ?? (() => ({ baseUrl }));
   const resolveVersion = () => {
-    if (aiApiVersion === void 0) return MATRX_AI_API_VERSION_DEFAULT;
+    if (aiApiVersion === void 0) return chunkSPASYIUH_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 chunkPMGKZ4FT_cjs.requireOrganizationContext(callOrganizationId);
+    if (callOrganizationId !== null) return chunkSPASYIUH_cjs.requireOrganizationContext(callOrganizationId);
     const candidate = typeof organizationId === "function" ? organizationId() : organizationId;
-    return chunkPMGKZ4FT_cjs.requireOrganizationContext(candidate);
+    return chunkSPASYIUH_cjs.requireOrganizationContext(candidate);
   };
   return {
     async fetch(path, init) {
       const target = await resolve(init);
       const callOrganizationId = readOrganizationHeader(init.headers);
-      const versionedPath = applyAiApiVersion(path, resolveVersion());
+      const versionedPath = chunkSPASYIUH_cjs.applyAiApiVersion(path, resolveVersion());
       const url = `${target.baseUrl}${versionedPath}`;
-      const credentialHeaders = credentials$1 ? credentials.credentialToHeaders(await credentials$1.get()) : {};
       const policyHeaders = stripContentType(target.policyHeaders ?? {});
-      let headers = {
-        ...init.headers,
-        ...stripContentType(credentialHeaders),
-        ...callOrganizationId === null ? policyHeaders : stripOrganizationHeader(policyHeaders)
-      };
+      let overHeaders = callOrganizationId === null ? policyHeaders : stripOrganizationHeader(policyHeaders);
       const orgId = resolveOrganizationId(callOrganizationId);
       if (orgId !== null) {
-        headers = chunkPMGKZ4FT_cjs.applyOrganizationContextHeader(headers, orgId);
+        overHeaders = chunkSPASYIUH_cjs.applyOrganizationContextHeader(overHeaders, orgId);
       }
+      const wireHeaders = callOrganizationId === null ? { ...init.headers } : stripOrganizationHeader({ ...init.headers });
       const info = {
         url,
         method: init.method,
@@ -485,19 +402,23 @@ function createMatrxTransport(options) {
       diagnostics?.onRequest?.(info);
       let response;
       try {
-        ({ response } = await fetchWithMatrxProtocolFallback(
-          url,
+        ({ response } = await chunkSPASYIUH_cjs.sendOnWire(
           {
+            url,
             method: init.method,
-            headers,
-            ...init.body !== void 0 ? { body: init.body } : {}
-          },
-          {
+            headers: wireHeaders,
+            overHeaders: orgId === null && callOrganizationId !== null ? { ...overHeaders, [ORGANIZATION_HEADER_CANONICAL]: callOrganizationId } : overHeaders,
+            ...init.body !== void 0 ? { body: init.body } : {},
             ...init.signal ? { signal: init.signal } : {},
+            ...init.onUploadProgress ? { onUploadProgress: init.onUploadProgress } : {},
             connectTimeoutMs,
             totalTimeoutMs,
-            throwOnHttpError: false,
-            ...diagnostics?.onProtocolDowngrade ? { onDowngrade: diagnostics.onProtocolDowngrade } : {}
+            ...diagnostics?.onProtocolDowngrade ? { onProtocolDowngrade: diagnostics.onProtocolDowngrade } : {}
+          },
+          {
+            ...credentials ? { credentials } : {},
+            ...refreshCredentials ? { refreshCredentials } : {},
+            ...readyTimeoutMs !== void 0 ? { readyTimeoutMs } : {}
           }
         ));
       } catch (err) {
@@ -506,11 +427,11 @@ function createMatrxTransport(options) {
       }
       if (!response.ok && !expectedErrorStatuses?.includes(response.status)) {
         const serverDetail = await response.clone().json().catch(() => void 0);
-        const code = chunkPMGKZ4FT_cjs.extractMatrxErrorCode(serverDetail);
+        const code = chunkSPASYIUH_cjs.extractMatrxErrorCode(serverDetail);
         diagnostics?.onError?.(
           {
             type: classifyStatus(response.status),
-            message: chunkPMGKZ4FT_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
+            message: chunkSPASYIUH_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
             status: response.status,
             serverDetail,
             ...code ? { code } : {}
@@ -523,42 +444,6 @@ function createMatrxTransport(options) {
   };
 }
 
-// src/core/api-target-log.ts
-var SUSPECT_HOST_FRAGMENTS = ["sandbox"];
-function looksSuspect(url) {
-  const lower = url.toLowerCase();
-  return SUSPECT_HOST_FRAGMENTS.some((frag) => lower.includes(frag));
-}
-function logApiTarget(url, context) {
-  const { source, method, channel, activeServer, ...extra } = context;
-  let origin = url;
-  try {
-    origin = new URL(url).origin;
-  } catch {
-  }
-  const suspect = looksSuspect(url);
-  const tag = suspect ? "\u{1F6A8} API TARGET (SANDBOX?)" : "\u{1F4E1} API TARGET";
-  const style = suspect ? "font-weight:bold;color:#fff;background:#c0392b;padding:1px 4px;border-radius:3px;" : "font-weight:bold;color:#fff;background:#16a085;padding:1px 4px;border-radius:3px;";
-  const meta = {
-    origin,
-    fullUrl: url,
-    source
-  };
-  if (method) meta.method = method;
-  if (channel) meta.channel = channel;
-  if (activeServer) meta.activeServer = activeServer;
-  for (const [k, v] of Object.entries(extra)) {
-    if (v !== void 0) meta[k] = v;
-  }
-  const log = suspect ? console.error : console.info;
-  log(
-    `%c${tag}%c ${method ? method + " " : ""}${url}`,
-    style,
-    "color:inherit;",
-    meta
-  );
-}
-
 // src/core/endpoint-path.ts
 function normalizeLeadingSlash(value) {
   const trimmed = value.trim();
@@ -580,21 +465,6 @@ function resolveEndpointPath(canonicalPath, config) {
   }
   return canonicalPath;
 }
-
-// src/core/desktop-target.ts
-var DESKTOP_NATIVE_CAPABILITY = "desktop-native";
-function applyDesktopTargetToRequestBody(body, targetInstanceId) {
-  if (!targetInstanceId || !isRecord(body)) return;
-  const existingClient = isRecord(body.client) ? body.client : null;
-  const existingState = existingClient && isRecord(existingClient.state) ? existingClient.state : null;
-  const existingDesktopState = existingState && isRecord(existingState[DESKTOP_NATIVE_CAPABILITY]) ? existingState[DESKTOP_NATIVE_CAPABILITY] : null;
-  if (!existingClient || !existingState || !existingDesktopState) return;
-  body.target_instance_id ??= targetInstanceId;
-  existingDesktopState.target_instance_id ??= targetInstanceId;
-}
-function isRecord(value) {
-  return value != null && typeof value === "object" && !Array.isArray(value);
-}
 var RUN_OUTPUT_KINDS = ["text", "image", "video", "audio"];
 var RUN_WAIT_KNOB_FEATURE = "agents.run_wait";
 var RUN_STREAM_LIFETIME_BACKSTOP_MS = 24 * 60 * 60 * 1e3;
@@ -840,7 +710,7 @@ async function readServerDetail(response) {
   }
 }
 async function throwApiError(path, response) {
-  throw new chunkPMGKZ4FT_cjs.MatrxApiError({
+  throw new chunkSPASYIUH_cjs.MatrxApiError({
     status: response.status,
     path,
     serverDetail: await readServerDetail(response)
@@ -861,7 +731,7 @@ function toRunHandle(response, options) {
   return {
     requestId: response.headers.get("X-Request-ID"),
     conversationId: response.headers.get("X-Conversation-ID"),
-    events: chunkPMGKZ4FT_cjs.readMatrxNdjsonStream(response.body, {
+    events: chunkSPASYIUH_cjs.readMatrxNdjsonStream(response.body, {
       ...options.signal ? { signal: options.signal } : {},
       ...options.maxReadAhead !== void 0 ? { maxReadAhead: options.maxReadAhead } : {},
       ...options.onMalformedLine ? { onMalformedLine: options.onMalformedLine } : {},
@@ -884,7 +754,7 @@ async function requestStream(transport, path, options) {
   });
   if (!response.ok) return throwApiError(path, response);
   if (!response.body) {
-    throw new chunkPMGKZ4FT_cjs.MatrxApiError({
+    throw new chunkSPASYIUH_cjs.MatrxApiError({
       status: response.status,
       path,
       serverDetail: { code: "missing_response_body" },
@@ -944,7 +814,7 @@ async function getRuntimeOperationStatus(transport, requestId, options = {}) {
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkPMGKZ4FT_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkSPASYIUH_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -959,7 +829,7 @@ async function getRuntimeOperationsByLink(transport, linkKind, linkId, options =
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkPMGKZ4FT_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkSPASYIUH_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -1000,7 +870,7 @@ async function* followRuntimeOperationEvents(transport, executionId, options = {
       ...options.signal ? { signal: options.signal } : {}
     }
   );
-  const frames = chunkPMGKZ4FT_cjs.readMatrxSseStream(
+  const frames = chunkSPASYIUH_cjs.readMatrxSseStream(
     response.body,
     options.onIncomplete ? { onIncomplete: options.onIncomplete } : {}
   );
@@ -1093,27 +963,27 @@ async function rejoinRuntimeOperation(transport, requestId, options = {}) {
 var MATRX_RUN_IN_PROGRESS = "run_in_progress";
 var MATRX_RESUME_CONFLICT = "resume_conflict";
 var MATRX_LIVE_STREAM_UNAVAILABLE = "live_stream_unavailable";
-function isRecord2(value) {
+function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function nonBlank(value) {
   return typeof value === "string" && value.trim() ? value : null;
 }
 function detailCandidates(body) {
-  if (!isRecord2(body)) return [];
+  if (!isRecord(body)) return [];
   const out = [];
-  if (isRecord2(body.detail)) out.push(body.detail);
-  if (isRecord2(body.details)) out.push(body.details);
+  if (isRecord(body.detail)) out.push(body.detail);
+  if (isRecord(body.details)) out.push(body.details);
   out.push(body);
   return out;
 }
 function statusOf(error) {
-  if (!isRecord2(error) && !(error instanceof Error)) return null;
+  if (!isRecord(error) && !(error instanceof Error)) return null;
   const status = error.status;
   return typeof status === "number" ? status : null;
 }
 function bodyOf(error) {
-  if (!isRecord2(error) && !(error instanceof Error)) return void 0;
+  if (!isRecord(error) && !(error instanceof Error)) return void 0;
   return error.serverDetail;
 }
 function readMatrxErrorCode(error) {
@@ -1174,7 +1044,7 @@ function readLiveRunRejoin(error) {
     rejoinPath,
     runId: firstString(candidates, "run_id"),
     code,
-    body: isRecord2(root) ? root : {}
+    body: isRecord(root) ? root : {}
   };
 }
 function readLiveRunRequestId(error) {
@@ -1190,8 +1060,8 @@ function runtimeOperationRejoinPath(requestId) {
   return `/runtime/operations/${encodePathSegment(requestId)}/rejoin`;
 }
 function streamErrorText(eventOrPayload) {
-  if (!isRecord2(eventOrPayload)) return null;
-  const payload = typeof eventOrPayload.event === "string" && isRecord2(eventOrPayload.data) ? eventOrPayload.data : eventOrPayload;
+  if (!isRecord(eventOrPayload)) return null;
+  const payload = typeof eventOrPayload.event === "string" && isRecord(eventOrPayload.data) ? eventOrPayload.data : eventOrPayload;
   return nonBlank(payload.user_message) ?? nonBlank(payload.message);
 }
 async function openMatrxStream(transport, path, options = {}) {
@@ -1203,7 +1073,7 @@ async function openMatrxStream(transport, path, options = {}) {
   return toRunHandle(response, options);
 }
 function withRunOrganization(transport, organizationId) {
-  const orgId = chunkPMGKZ4FT_cjs.requireOrganizationContext(organizationId);
+  const orgId = chunkSPASYIUH_cjs.requireOrganizationContext(organizationId);
   return {
     fetch: (path, init) => transport.fetch(path, {
       ...init,
@@ -1230,7 +1100,7 @@ async function followWorkflowRunEvents(transport, runId, options) {
     throw error;
   }
   try {
-    for await (const frame of chunkPMGKZ4FT_cjs.readMatrxSseStream(
+    for await (const frame of chunkSPASYIUH_cjs.readMatrxSseStream(
       response.body
     )) {
       if (frame.event === "end") return { ended: true };
@@ -1241,7 +1111,7 @@ async function followWorkflowRunEvents(transport, runId, options) {
       } catch {
         continue;
       }
-      if (!isRecord2(parsed)) continue;
+      if (!isRecord(parsed)) continue;
       options.onEvent(parsed, parsed.event === "node_stream" ? null : frame.seq);
     }
   } catch (error) {
@@ -1276,7 +1146,7 @@ async function resumeOrRejoin(transport, resumeCall, options) {
   } catch (error) {
     const target = readLiveRunRejoin(error);
     if (!target) {
-      if (error instanceof chunkPMGKZ4FT_cjs.MatrxApiError && isResumeConflict(error)) {
+      if (error instanceof chunkSPASYIUH_cjs.MatrxApiError && isResumeConflict(error)) {
         return { kind: "resume_conflict", error };
       }
       throw error;
@@ -1692,7 +1562,7 @@ async function reportProviderSessionUsage(transport, usage, options = {}) {
     });
     return "ok";
   } catch (error) {
-    if (error instanceof chunkPMGKZ4FT_cjs.MatrxApiError) {
+    if (error instanceof chunkSPASYIUH_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})`);
@@ -1812,11 +1682,11 @@ var MatrxRunError = class extends Error {
     this.partialText = args.partialText ?? "";
   }
 };
-function isRecord3(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringField(value, key) {
-  if (!isRecord3(value)) return null;
+  if (!isRecord2(value)) return null;
   const field = value[key];
   return typeof field === "string" && field ? field : null;
 }
@@ -1836,7 +1706,7 @@ async function runAgentToCompletion(transport, agentId, request, options = {}) {
       continue;
     }
     if (envelope.event === "error" && failure === null) {
-      const payload = isRecord3(envelope.data) ? envelope.data : null;
+      const payload = isRecord2(envelope.data) ? envelope.data : null;
       failure = new MatrxRunError({
         message: streamErrorText(payload) ?? "The agent run failed",
         errorPayload: payload,
@@ -1844,12 +1714,12 @@ async function runAgentToCompletion(transport, agentId, request, options = {}) {
       });
       continue;
     }
-    if (envelope.event !== "completion" || !isRecord3(envelope.data)) continue;
+    if (envelope.event !== "completion" || !isRecord2(envelope.data)) continue;
     if (envelope.data.operation !== "user_request") continue;
     completion = envelope.data;
     const status = envelope.data.status;
     if ((status === "failed" || status === "cancelled") && failure === null) {
-      const result = isRecord3(envelope.data.result) ? envelope.data.result : null;
+      const result = isRecord2(envelope.data.result) ? envelope.data.result : null;
       failure = new MatrxRunError({
         message: stringField(result, "error") ?? stringField(result, "user_message") ?? `The agent run ${status}`,
         completionStatus: status,
@@ -2374,10 +2244,6 @@ var ENDPOINTS = {
   }
 };
 
-Object.defineProperty(exports, "monitorStream", {
-  enumerable: true,
-  get: function () { return chunkFNIYADWI_cjs.monitorStream; }
-});
 Object.defineProperty(exports, "API_KEY_PREFIX", {
   enumerable: true,
   get: function () { return chunkMVXD6WI6_cjs.API_KEY_PREFIX; }
@@ -2396,170 +2262,209 @@ Object.defineProperty(exports, "toCredentialsPort", {
 });
 Object.defineProperty(exports, "BackendApiError", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.BackendApiError; }
+  get: function () { return chunkSPASYIUH_cjs.BackendApiError; }
 });
 Object.defineProperty(exports, "CONTRACT_SHA256", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.CONTRACT_SHA256; }
+  get: function () { return chunkSPASYIUH_cjs.CONTRACT_SHA256; }
 });
 Object.defineProperty(exports, "DEPLOYMENTS", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.DEPLOYMENTS; }
+  get: function () { return chunkSPASYIUH_cjs.DEPLOYMENTS; }
 });
 Object.defineProperty(exports, "DOMAINS", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.DOMAINS; }
+  get: function () { return chunkSPASYIUH_cjs.DOMAINS; }
+});
+Object.defineProperty(exports, "MATRX_AI_API_VERSION_DEFAULT", {
+  enumerable: true,
+  get: function () { return chunkSPASYIUH_cjs.MATRX_AI_API_VERSION_DEFAULT; }
 });
 Object.defineProperty(exports, "MatrxApiError", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.MatrxApiError; }
+  get: function () { return chunkSPASYIUH_cjs.MatrxApiError; }
 });
 Object.defineProperty(exports, "OrganizationContextError", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.OrganizationContextError; }
+  get: function () { return chunkSPASYIUH_cjs.OrganizationContextError; }
 });
 Object.defineProperty(exports, "StreamTransportError", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.StreamTransportError; }
+  get: function () { return chunkSPASYIUH_cjs.StreamTransportError; }
+});
+Object.defineProperty(exports, "V2_COVERED_AI_PATH_TEMPLATES", {
+  enumerable: true,
+  get: function () { return chunkSPASYIUH_cjs.V2_COVERED_AI_PATH_TEMPLATES; }
+});
+Object.defineProperty(exports, "aiVersionPathOverrides", {
+  enumerable: true,
+  get: function () { return chunkSPASYIUH_cjs.aiVersionPathOverrides; }
+});
+Object.defineProperty(exports, "applyAiApiVersion", {
+  enumerable: true,
+  get: function () { return chunkSPASYIUH_cjs.applyAiApiVersion; }
 });
 Object.defineProperty(exports, "applyOrganizationContextHeader", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.applyOrganizationContextHeader; }
+  get: function () { return chunkSPASYIUH_cjs.applyOrganizationContextHeader; }
 });
 Object.defineProperty(exports, "assertOrganizationMatchesOperation", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.assertOrganizationMatchesOperation; }
+  get: function () { return chunkSPASYIUH_cjs.assertOrganizationMatchesOperation; }
 });
 Object.defineProperty(exports, "assertQueryOrganizationMatchesContext", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.assertQueryOrganizationMatchesContext; }
+  get: function () { return chunkSPASYIUH_cjs.assertQueryOrganizationMatchesContext; }
 });
 Object.defineProperty(exports, "createApi", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.createApi; }
+  get: function () { return chunkSPASYIUH_cjs.createApi; }
 });
 Object.defineProperty(exports, "createOrganizationOperation", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.createOrganizationOperation; }
+  get: function () { return chunkSPASYIUH_cjs.createOrganizationOperation; }
 });
 Object.defineProperty(exports, "describeBackendFailure", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.describeBackendFailure; }
+  get: function () { return chunkSPASYIUH_cjs.describeBackendFailure; }
 });
 Object.defineProperty(exports, "extractMatrxErrorCode", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.extractMatrxErrorCode; }
+  get: function () { return chunkSPASYIUH_cjs.extractMatrxErrorCode; }
 });
 Object.defineProperty(exports, "extractMatrxErrorMessage", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.extractMatrxErrorMessage; }
+  get: function () { return chunkSPASYIUH_cjs.extractMatrxErrorMessage; }
+});
+Object.defineProperty(exports, "fetchWithMatrxProtocolFallback", {
+  enumerable: true,
+  get: function () { return chunkSPASYIUH_cjs.fetchWithMatrxProtocolFallback; }
 });
 Object.defineProperty(exports, "getUserMessage", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.getUserMessage; }
+  get: function () { return chunkSPASYIUH_cjs.getUserMessage; }
+});
+Object.defineProperty(exports, "isCoveredAiPath", {
+  enumerable: true,
+  get: function () { return chunkSPASYIUH_cjs.isCoveredAiPath; }
 });
 Object.defineProperty(exports, "isGenericUserMessage", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.isGenericUserMessage; }
+  get: function () { return chunkSPASYIUH_cjs.isGenericUserMessage; }
 });
 Object.defineProperty(exports, "isStreamTransportLost", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.isStreamTransportLost; }
+  get: function () { return chunkSPASYIUH_cjs.isStreamTransportLost; }
+});
+Object.defineProperty(exports, "isV2Path", {
+  enumerable: true,
+  get: function () { return chunkSPASYIUH_cjs.isV2Path; }
 });
 Object.defineProperty(exports, "openJsonOrStream", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.openJsonOrStream; }
+  get: function () { return chunkSPASYIUH_cjs.openJsonOrStream; }
 });
 Object.defineProperty(exports, "openStream", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.openStream; }
+  get: function () { return chunkSPASYIUH_cjs.openStream; }
 });
 Object.defineProperty(exports, "parseCallApiError", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.parseCallApiError; }
+  get: function () { return chunkSPASYIUH_cjs.parseCallApiError; }
 });
 Object.defineProperty(exports, "parseHttpError", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.parseHttpError; }
+  get: function () { return chunkSPASYIUH_cjs.parseHttpError; }
 });
 Object.defineProperty(exports, "parseHttpErrorBody", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.parseHttpErrorBody; }
+  get: function () { return chunkSPASYIUH_cjs.parseHttpErrorBody; }
 });
 Object.defineProperty(exports, "parsePersistedBackendError", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.parsePersistedBackendError; }
+  get: function () { return chunkSPASYIUH_cjs.parsePersistedBackendError; }
 });
 Object.defineProperty(exports, "parseStreamError", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.parseStreamError; }
+  get: function () { return chunkSPASYIUH_cjs.parseStreamError; }
 });
 Object.defineProperty(exports, "requireOrganizationContext", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.requireOrganizationContext; }
+  get: function () { return chunkSPASYIUH_cjs.requireOrganizationContext; }
+});
+Object.defineProperty(exports, "toV1FallbackUrl", {
+  enumerable: true,
+  get: function () { return chunkSPASYIUH_cjs.toV1FallbackUrl; }
+});
+Object.defineProperty(exports, "toV2Path", {
+  enumerable: true,
+  get: function () { return chunkSPASYIUH_cjs.toV2Path; }
 });
 Object.defineProperty(exports, "unwrapUpstreamError", {
   enumerable: true,
-  get: function () { return chunkPMGKZ4FT_cjs.unwrapUpstreamError; }
+  get: function () { return chunkSPASYIUH_cjs.unwrapUpstreamError; }
 });
 Object.defineProperty(exports, "AbortedError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.AbortedError; }
+  get: function () { return chunkPKYPPATQ_cjs.AbortedError; }
 });
 Object.defineProperty(exports, "ConnectTimeoutError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.ConnectTimeoutError; }
+  get: function () { return chunkPKYPPATQ_cjs.ConnectTimeoutError; }
 });
 Object.defineProperty(exports, "HeartbeatTimeoutError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.HeartbeatTimeoutError; }
+  get: function () { return chunkPKYPPATQ_cjs.HeartbeatTimeoutError; }
 });
 Object.defineProperty(exports, "HttpError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.HttpError; }
+  get: function () { return chunkPKYPPATQ_cjs.HttpError; }
 });
 Object.defineProperty(exports, "NetError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.NetError; }
+  get: function () { return chunkPKYPPATQ_cjs.NetError; }
 });
 Object.defineProperty(exports, "NetworkError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.NetworkError; }
+  get: function () { return chunkPKYPPATQ_cjs.NetworkError; }
 });
 Object.defineProperty(exports, "OfflineError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.OfflineError; }
+  get: function () { return chunkPKYPPATQ_cjs.OfflineError; }
 });
 Object.defineProperty(exports, "TotalTimeoutError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.TotalTimeoutError; }
+  get: function () { return chunkPKYPPATQ_cjs.TotalTimeoutError; }
 });
 Object.defineProperty(exports, "extractErrorMessage", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.extractErrorMessage; }
+  get: function () { return chunkPKYPPATQ_cjs.extractErrorMessage; }
 });
 Object.defineProperty(exports, "isNetError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.isNetError; }
+  get: function () { return chunkPKYPPATQ_cjs.isNetError; }
 });
 Object.defineProperty(exports, "isTransportFailure", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.isTransportFailure; }
+  get: function () { return chunkPKYPPATQ_cjs.isTransportFailure; }
+});
+Object.defineProperty(exports, "monitorStream", {
+  enumerable: true,
+  get: function () { return chunkPKYPPATQ_cjs.monitorStream; }
 });
 Object.defineProperty(exports, "resilientFetch", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.resilientFetch; }
+  get: function () { return chunkPKYPPATQ_cjs.resilientFetch; }
 });
 Object.defineProperty(exports, "toNetError", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.toNetError; }
+  get: function () { return chunkPKYPPATQ_cjs.toNetError; }
 });
 Object.defineProperty(exports, "withRetry", {
   enumerable: true,
-  get: function () { return chunk2SXAAKGV_cjs.withRetry; }
+  get: function () { return chunkPKYPPATQ_cjs.withRetry; }
 });
 exports.ENDPOINTS = ENDPOINTS;
-exports.MATRX_AI_API_VERSION_DEFAULT = MATRX_AI_API_VERSION_DEFAULT;
 exports.MATRX_LIVE_STREAM_UNAVAILABLE = MATRX_LIVE_STREAM_UNAVAILABLE;
 exports.MATRX_RESUME_CONFLICT = MATRX_RESUME_CONFLICT;
 exports.MATRX_RUN_IN_PROGRESS = MATRX_RUN_IN_PROGRESS;
@@ -2569,11 +2474,7 @@ exports.RUN_OUTPUT_KINDS = RUN_OUTPUT_KINDS;
 exports.RUN_STREAM_LIFETIME_BACKSTOP_MS = RUN_STREAM_LIFETIME_BACKSTOP_MS;
 exports.RUN_WAIT_KNOB_FEATURE = RUN_WAIT_KNOB_FEATURE;
 exports.TERMINAL_MATRX_RUNTIME_STATUSES = TERMINAL_MATRX_RUNTIME_STATUSES;
-exports.V2_COVERED_AI_PATH_TEMPLATES = V2_COVERED_AI_PATH_TEMPLATES;
 exports.WARM_PATH = WARM_PATH;
-exports.aiVersionPathOverrides = aiVersionPathOverrides;
-exports.applyAiApiVersion = applyAiApiVersion;
-exports.applyDesktopTargetToRequestBody = applyDesktopTargetToRequestBody;
 exports.bareStatusSentence = bareStatusSentence;
 exports.buildMatrxRequestBody = buildMatrxRequestBody;
 exports.buildMatrxRequestUrl = buildMatrxRequestUrl;
@@ -2589,7 +2490,6 @@ exports.createStreamReplayCursor = createStreamReplayCursor;
 exports.createWarmup = createWarmup;
 exports.encodePathSegment = encodePathSegment;
 exports.executeMatrxCall = executeMatrxCall;
-exports.fetchWithMatrxProtocolFallback = fetchWithMatrxProtocolFallback;
 exports.followRuntimeOperationEvents = followRuntimeOperationEvents;
 exports.followRuntimeOperationToEnd = followRuntimeOperationToEnd;
 exports.followServerJob = followServerJob;
@@ -2599,17 +2499,14 @@ exports.getRuntimeOperationStatus = getRuntimeOperationStatus;
 exports.getRuntimeOperationsByLink = getRuntimeOperationsByLink;
 exports.honestTransportMessage = honestTransportMessage;
 exports.isBareTransportCode = isBareTransportCode;
-exports.isCoveredAiPath = isCoveredAiPath;
 exports.isEmptyProviderUsage = isEmptyProviderUsage;
 exports.isJobOutputKind = isJobOutputKind;
 exports.isLiveStreamUnavailable = isLiveStreamUnavailable;
 exports.isResumeConflict = isResumeConflict;
 exports.isServerJobSettled = isServerJobSettled;
-exports.isV2Path = isV2Path;
 exports.listConversationPendingToolCalls = listConversationPendingToolCalls;
 exports.listRuntimeOperationEvents = listRuntimeOperationEvents;
 exports.listUserPendingToolCalls = listUserPendingToolCalls;
-exports.logApiTarget = logApiTarget;
 exports.mintMatrxConversationId = mintMatrxConversationId;
 exports.newEphemeralConversationStart = newEphemeralConversationStart;
 exports.newStoredConversationStart = newStoredConversationStart;
@@ -2654,6 +2551,4 @@ exports.startMandateRun = startMandateRun;
 exports.streamErrorText = streamErrorText;
 exports.submitAgentToolResults = submitAgentToolResults;
 exports.toRunHandle = toRunHandle;
-exports.toV1FallbackUrl = toV1FallbackUrl;
-exports.toV2Path = toV2Path;
 exports.withRunOrganization = withRunOrganization;