@ai-matrx/api 0.1.19 → 0.1.21

package/dist/{chunk-PKYPPATQ.cjs → chunk-2SXAAKGV.cjs}

@@ -143,58 +143,6 @@ function toNetError(err) {
   );
 }
 
-// src/net/retry.ts
-function defaultRetryOn(err) {
-  return isNetError(err) && err.retryable;
-}
-function sleep(ms, signal) {
-  return new Promise((resolve, reject) => {
-    const timer = setTimeout(() => {
-      resolve();
-      if (signal) signal.removeEventListener("abort", onAbort);
-    }, ms);
-    const onAbort = () => {
-      clearTimeout(timer);
-      reject(signal?.reason ?? new Error("Aborted"));
-    };
-    if (signal) {
-      if (signal.aborted) {
-        clearTimeout(timer);
-        reject(signal.reason);
-      } else {
-        signal.addEventListener("abort", onAbort, { once: true });
-      }
-    }
-  });
-}
-async function withRetry(fn, opts = {}) {
-  const attempts = Math.max(1, opts.attempts ?? 3);
-  const initialDelayMs = opts.initialDelayMs ?? 250;
-  const maxDelayMs = opts.maxDelayMs ?? 4e3;
-  const factor = opts.backoffFactor ?? 2;
-  const jitter = Math.max(0, Math.min(1, opts.jitter ?? 0.25));
-  const retryOn = opts.retryOn ?? defaultRetryOn;
-  let lastErr;
-  for (let attempt = 1; attempt <= attempts; attempt++) {
-    if (opts.signal?.aborted) throw opts.signal.reason;
-    try {
-      return await fn(attempt);
-    } catch (err) {
-      lastErr = err;
-      if (attempt === attempts || !retryOn(err)) throw err;
-      const base = Math.min(
-        maxDelayMs,
-        initialDelayMs * Math.pow(factor, attempt - 1)
-      );
-      const jitterAmount = base * jitter * (Math.random() * 2 - 1);
-      const delayMs = Math.max(0, Math.round(base + jitterAmount));
-      opts.onRetry?.(attempt, err, delayMs);
-      await sleep(delayMs, opts.signal);
-    }
-  }
-  throw lastErr;
-}
-
 // src/net/resilient-fetch.ts
 var DEFAULTS = {
   connectTimeoutMs: 15e3,
@@ -263,58 +211,56 @@ async function resilientFetch(url, init = {}, opts = {}) {
   }
 }
 
-// src/net/stream-monitor.ts
-var DEFAULTS2 = {
-  heartbeatTimeoutMs: 3e4,
-  maxLifetimeMs: 6e5
-};
-async function* monitorStream(source, opts = {}) {
-  const heartbeatTimeoutMs = opts.heartbeatTimeoutMs ?? DEFAULTS2.heartbeatTimeoutMs;
-  const maxLifetimeMs = opts.maxLifetimeMs ?? DEFAULTS2.maxLifetimeMs;
-  const abort = opts.abortController;
-  const startedAt = Date.now();
-  const iter = source[Symbol.asyncIterator]();
-  while (true) {
-    const elapsed = Date.now() - startedAt;
-    const remainingLifetime = maxLifetimeMs - elapsed;
-    if (remainingLifetime <= 0) {
-      abort?.abort("total-timeout");
-      throw new TotalTimeoutError(maxLifetimeMs);
+// src/net/retry.ts
+function defaultRetryOn(err) {
+  return isNetError(err) && err.retryable;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      resolve();
+      if (signal) signal.removeEventListener("abort", onAbort);
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signal?.reason ?? new Error("Aborted"));
+    };
+    if (signal) {
+      if (signal.aborted) {
+        clearTimeout(timer);
+        reject(signal.reason);
+      } else {
+        signal.addEventListener("abort", onAbort, { once: true });
+      }
     }
-    const deadline = Math.min(heartbeatTimeoutMs, remainingLifetime);
-    let timer = null;
-    let timedOutKind = null;
-    const timeoutPromise = new Promise((_, reject) => {
-      timer = setTimeout(() => {
-        timedOutKind = deadline === remainingLifetime ? "total" : "heartbeat";
-        abort?.abort(
-          timedOutKind === "total" ? "total-timeout" : "heartbeat-timeout"
-        );
-        reject(
-          timedOutKind === "total" ? new TotalTimeoutError(maxLifetimeMs) : new HeartbeatTimeoutError(heartbeatTimeoutMs)
-        );
-      }, deadline);
-    });
-    let result;
+  });
+}
+async function withRetry(fn, opts = {}) {
+  const attempts = Math.max(1, opts.attempts ?? 3);
+  const initialDelayMs = opts.initialDelayMs ?? 250;
+  const maxDelayMs = opts.maxDelayMs ?? 4e3;
+  const factor = opts.backoffFactor ?? 2;
+  const jitter = Math.max(0, Math.min(1, opts.jitter ?? 0.25));
+  const retryOn = opts.retryOn ?? defaultRetryOn;
+  let lastErr;
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    if (opts.signal?.aborted) throw opts.signal.reason;
     try {
-      result = await Promise.race([iter.next(), timeoutPromise]);
+      return await fn(attempt);
     } catch (err) {
-      if (timer !== null) clearTimeout(timer);
-      try {
-        const cleanup = iter.return?.(void 0);
-        if (cleanup) {
-          void Promise.resolve(cleanup).catch(() => {
-          });
-        }
-      } catch {
-      }
-      throw err;
+      lastErr = err;
+      if (attempt === attempts || !retryOn(err)) throw err;
+      const base = Math.min(
+        maxDelayMs,
+        initialDelayMs * Math.pow(factor, attempt - 1)
+      );
+      const jitterAmount = base * jitter * (Math.random() * 2 - 1);
+      const delayMs = Math.max(0, Math.round(base + jitterAmount));
+      opts.onRetry?.(attempt, err, delayMs);
+      await sleep(delayMs, opts.signal);
     }
-    if (timer !== null) clearTimeout(timer);
-    if (result.done) return;
-    opts.onHeartbeat?.(Date.now());
-    yield result.value;
   }
+  throw lastErr;
 }
 
 exports.AbortedError = AbortedError;
@@ -328,7 +274,6 @@ exports.TotalTimeoutError = TotalTimeoutError;
 exports.extractErrorMessage = extractErrorMessage;
 exports.isNetError = isNetError;
 exports.isTransportFailure = isTransportFailure;
-exports.monitorStream = monitorStream;
 exports.resilientFetch = resilientFetch;
 exports.toNetError = toNetError;
 exports.withRetry = withRetry;

package/dist/{chunk-JRPLPAIX.js → chunk-ER7WV43R.js}

@@ -1,90 +1,7 @@
-import { resilientFetch, isNetError, withRetry, isTransportFailure, AbortedError, TotalTimeoutError } from './chunk-PIPE5OML.js';
+import { withRetry, isTransportFailure, AbortedError, resilientFetch, TotalTimeoutError } from './chunk-KIEAFMKB.js';
 import { isUuidShape } from '@ai-matrx/kit/uuid';
 import { credentialToHeaders, toCredentialsPort, MATRX_HEADERS } from '@ai-matrx/auth/credentials';
 
-// 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 resilientFetch(url, init, fetchOpts);
-  let result;
-  try {
-    result = await resilientFetch(url, init, fetchOpts);
-  } catch (err) {
-    const isAbort = isNetError(err) && err.code === "aborted" || err instanceof Error && err.name === "AbortError";
-    if (isAbort) throw err;
-    logDowngrade(String(err));
-    return resilientFetch(toV1FallbackUrl(url), init, fetchOpts);
-  }
-  const status = result.response.status;
-  if (status === 404 || status === 405 || status >= 500) {
-    logDowngrade(`HTTP ${status}`, status);
-    return 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/backend-errors.ts
 var BackendApiError = class extends Error {
   /** Machine-readable error code */
@@ -1049,15 +966,14 @@ async function sendOnWire(request, auth = {}) {
         );
       }
     }
-    return fetchWithMatrxProtocolFallback(
+    return resilientFetch(
       request.url,
       { ...request.fetchOptions, method, headers: merged, ...body !== void 0 ? { body } : {} },
       {
         ...request.signal ? { signal: request.signal } : {},
         connectTimeoutMs: request.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS,
         totalTimeoutMs: request.totalTimeoutMs !== void 0 ? request.totalTimeoutMs : null,
-        throwOnHttpError: false,
-        ...request.onProtocolDowngrade ? { onDowngrade: request.onProtocolDowngrade } : {}
+        throwOnHttpError: false
       }
     ).then((result) => {
       if (request.onUploadProgress && body !== void 0) {
@@ -1278,4 +1194,4 @@ async function openJsonOrStream(api, op, args, options) {
   return { kind: "stream", stream: toStream(op, response, requestId, controller) };
 }
 
-export { BackendApiError, CONTRACT_SHA256, DEFAULT_MATRX_NDJSON_READ_AHEAD, DEPLOYMENTS, DOMAINS, MATRX_AI_API_VERSION_DEFAULT, MatrxApiError, OrganizationContextError, StreamTransportError, V2_COVERED_AI_PATH_TEMPLATES, WIRE_FETCH_OPTION_KEYS, aiVersionPathOverrides, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createMatrxNdjsonFramer, createMatrxSseFramer, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, fetchWithMatrxProtocolFallback, getUserMessage, isBinaryType, isCoveredAiPath, isGenericUserMessage, isStreamTransportLost, isV2Path, normalizeMatrxStreamEnvelope, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxSseFrame, parsePersistedBackendError, parseStreamError, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, sendOnWire, toV1FallbackUrl, toV2Path, unwrapUpstreamError };
+export { BackendApiError, CONTRACT_SHA256, DEFAULT_MATRX_NDJSON_READ_AHEAD, DEPLOYMENTS, DOMAINS, MatrxApiError, OrganizationContextError, StreamTransportError, WIRE_FETCH_OPTION_KEYS, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createMatrxNdjsonFramer, createMatrxSseFramer, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, getUserMessage, isBinaryType, isGenericUserMessage, isStreamTransportLost, normalizeMatrxStreamEnvelope, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxSseFrame, parsePersistedBackendError, parseStreamError, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, sendOnWire, unwrapUpstreamError };

package/dist/chunk-FNIYADWI.cjs

@@ -0,0 +1,59 @@
+'use strict';
+
+var chunk2SXAAKGV_cjs = require('./chunk-2SXAAKGV.cjs');
+
+// src/net/stream-monitor.ts
+var DEFAULTS = {
+  heartbeatTimeoutMs: 3e4,
+  maxLifetimeMs: 6e5
+};
+async function* monitorStream(source, opts = {}) {
+  const heartbeatTimeoutMs = opts.heartbeatTimeoutMs ?? DEFAULTS.heartbeatTimeoutMs;
+  const maxLifetimeMs = opts.maxLifetimeMs ?? DEFAULTS.maxLifetimeMs;
+  const abort = opts.abortController;
+  const startedAt = Date.now();
+  const iter = source[Symbol.asyncIterator]();
+  while (true) {
+    const elapsed = Date.now() - startedAt;
+    const remainingLifetime = maxLifetimeMs - elapsed;
+    if (remainingLifetime <= 0) {
+      abort?.abort("total-timeout");
+      throw new chunk2SXAAKGV_cjs.TotalTimeoutError(maxLifetimeMs);
+    }
+    const deadline = Math.min(heartbeatTimeoutMs, remainingLifetime);
+    let timer = null;
+    let timedOutKind = null;
+    const timeoutPromise = new Promise((_, reject) => {
+      timer = setTimeout(() => {
+        timedOutKind = deadline === remainingLifetime ? "total" : "heartbeat";
+        abort?.abort(
+          timedOutKind === "total" ? "total-timeout" : "heartbeat-timeout"
+        );
+        reject(
+          timedOutKind === "total" ? new chunk2SXAAKGV_cjs.TotalTimeoutError(maxLifetimeMs) : new chunk2SXAAKGV_cjs.HeartbeatTimeoutError(heartbeatTimeoutMs)
+        );
+      }, deadline);
+    });
+    let result;
+    try {
+      result = await Promise.race([iter.next(), timeoutPromise]);
+    } catch (err) {
+      if (timer !== null) clearTimeout(timer);
+      try {
+        const cleanup = iter.return?.(void 0);
+        if (cleanup) {
+          void Promise.resolve(cleanup).catch(() => {
+          });
+        }
+      } catch {
+      }
+      throw err;
+    }
+    if (timer !== null) clearTimeout(timer);
+    if (result.done) return;
+    opts.onHeartbeat?.(Date.now());
+    yield result.value;
+  }
+}
+
+exports.monitorStream = monitorStream;

package/dist/{chunk-PIPE5OML.js → chunk-KIEAFMKB.js}

@@ -141,58 +141,6 @@ function toNetError(err) {
   );
 }
 
-// src/net/retry.ts
-function defaultRetryOn(err) {
-  return isNetError(err) && err.retryable;
-}
-function sleep(ms, signal) {
-  return new Promise((resolve, reject) => {
-    const timer = setTimeout(() => {
-      resolve();
-      if (signal) signal.removeEventListener("abort", onAbort);
-    }, ms);
-    const onAbort = () => {
-      clearTimeout(timer);
-      reject(signal?.reason ?? new Error("Aborted"));
-    };
-    if (signal) {
-      if (signal.aborted) {
-        clearTimeout(timer);
-        reject(signal.reason);
-      } else {
-        signal.addEventListener("abort", onAbort, { once: true });
-      }
-    }
-  });
-}
-async function withRetry(fn, opts = {}) {
-  const attempts = Math.max(1, opts.attempts ?? 3);
-  const initialDelayMs = opts.initialDelayMs ?? 250;
-  const maxDelayMs = opts.maxDelayMs ?? 4e3;
-  const factor = opts.backoffFactor ?? 2;
-  const jitter = Math.max(0, Math.min(1, opts.jitter ?? 0.25));
-  const retryOn = opts.retryOn ?? defaultRetryOn;
-  let lastErr;
-  for (let attempt = 1; attempt <= attempts; attempt++) {
-    if (opts.signal?.aborted) throw opts.signal.reason;
-    try {
-      return await fn(attempt);
-    } catch (err) {
-      lastErr = err;
-      if (attempt === attempts || !retryOn(err)) throw err;
-      const base = Math.min(
-        maxDelayMs,
-        initialDelayMs * Math.pow(factor, attempt - 1)
-      );
-      const jitterAmount = base * jitter * (Math.random() * 2 - 1);
-      const delayMs = Math.max(0, Math.round(base + jitterAmount));
-      opts.onRetry?.(attempt, err, delayMs);
-      await sleep(delayMs, opts.signal);
-    }
-  }
-  throw lastErr;
-}
-
 // src/net/resilient-fetch.ts
 var DEFAULTS = {
   connectTimeoutMs: 15e3,
@@ -261,58 +209,56 @@ async function resilientFetch(url, init = {}, opts = {}) {
   }
 }
 
-// src/net/stream-monitor.ts
-var DEFAULTS2 = {
-  heartbeatTimeoutMs: 3e4,
-  maxLifetimeMs: 6e5
-};
-async function* monitorStream(source, opts = {}) {
-  const heartbeatTimeoutMs = opts.heartbeatTimeoutMs ?? DEFAULTS2.heartbeatTimeoutMs;
-  const maxLifetimeMs = opts.maxLifetimeMs ?? DEFAULTS2.maxLifetimeMs;
-  const abort = opts.abortController;
-  const startedAt = Date.now();
-  const iter = source[Symbol.asyncIterator]();
-  while (true) {
-    const elapsed = Date.now() - startedAt;
-    const remainingLifetime = maxLifetimeMs - elapsed;
-    if (remainingLifetime <= 0) {
-      abort?.abort("total-timeout");
-      throw new TotalTimeoutError(maxLifetimeMs);
+// src/net/retry.ts
+function defaultRetryOn(err) {
+  return isNetError(err) && err.retryable;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      resolve();
+      if (signal) signal.removeEventListener("abort", onAbort);
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signal?.reason ?? new Error("Aborted"));
+    };
+    if (signal) {
+      if (signal.aborted) {
+        clearTimeout(timer);
+        reject(signal.reason);
+      } else {
+        signal.addEventListener("abort", onAbort, { once: true });
+      }
     }
-    const deadline = Math.min(heartbeatTimeoutMs, remainingLifetime);
-    let timer = null;
-    let timedOutKind = null;
-    const timeoutPromise = new Promise((_, reject) => {
-      timer = setTimeout(() => {
-        timedOutKind = deadline === remainingLifetime ? "total" : "heartbeat";
-        abort?.abort(
-          timedOutKind === "total" ? "total-timeout" : "heartbeat-timeout"
-        );
-        reject(
-          timedOutKind === "total" ? new TotalTimeoutError(maxLifetimeMs) : new HeartbeatTimeoutError(heartbeatTimeoutMs)
-        );
-      }, deadline);
-    });
-    let result;
+  });
+}
+async function withRetry(fn, opts = {}) {
+  const attempts = Math.max(1, opts.attempts ?? 3);
+  const initialDelayMs = opts.initialDelayMs ?? 250;
+  const maxDelayMs = opts.maxDelayMs ?? 4e3;
+  const factor = opts.backoffFactor ?? 2;
+  const jitter = Math.max(0, Math.min(1, opts.jitter ?? 0.25));
+  const retryOn = opts.retryOn ?? defaultRetryOn;
+  let lastErr;
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    if (opts.signal?.aborted) throw opts.signal.reason;
     try {
-      result = await Promise.race([iter.next(), timeoutPromise]);
+      return await fn(attempt);
     } catch (err) {
-      if (timer !== null) clearTimeout(timer);
-      try {
-        const cleanup = iter.return?.(void 0);
-        if (cleanup) {
-          void Promise.resolve(cleanup).catch(() => {
-          });
-        }
-      } catch {
-      }
-      throw err;
+      lastErr = err;
+      if (attempt === attempts || !retryOn(err)) throw err;
+      const base = Math.min(
+        maxDelayMs,
+        initialDelayMs * Math.pow(factor, attempt - 1)
+      );
+      const jitterAmount = base * jitter * (Math.random() * 2 - 1);
+      const delayMs = Math.max(0, Math.round(base + jitterAmount));
+      opts.onRetry?.(attempt, err, delayMs);
+      await sleep(delayMs, opts.signal);
     }
-    if (timer !== null) clearTimeout(timer);
-    if (result.done) return;
-    opts.onHeartbeat?.(Date.now());
-    yield result.value;
   }
+  throw lastErr;
 }
 
-export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetworkError, OfflineError, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry };
+export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetworkError, OfflineError, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, resilientFetch, toNetError, withRetry };