@ai-matrx/api 0.1.8 → 0.1.9

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 var chunkFNIYADWI_cjs = require('./chunk-FNIYADWI.cjs');
 var chunkMVXD6WI6_cjs = require('./chunk-MVXD6WI6.cjs');
-var chunkNMBDYPFZ_cjs = require('./chunk-NMBDYPFZ.cjs');
+var chunkPMGKZ4FT_cjs = require('./chunk-PMGKZ4FT.cjs');
 var chunk2SXAAKGV_cjs = require('./chunk-2SXAAKGV.cjs');
 var credentials = require('@ai-matrx/auth/credentials');
 var format = require('@ai-matrx/kit/format');
@@ -128,7 +128,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 chunkNMBDYPFZ_cjs.OrganizationContextError(
+    throw new chunkPMGKZ4FT_cjs.OrganizationContextError(
       "organization_context_mismatch",
       "Request body organization_id must match the request context organization."
     );
@@ -200,14 +200,14 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
   };
   async function* events() {
     if (!response.body) {
-      throw new chunkNMBDYPFZ_cjs.BackendApiError({
+      throw new chunkPMGKZ4FT_cjs.BackendApiError({
         code: "internal_error",
         detail: "Response has no body",
         userMessage: "No response received from server"
       });
     }
     try {
-      for await (const envelope of chunkNMBDYPFZ_cjs.readMatrxNdjsonStream(response.body, {
+      for await (const envelope of chunkPMGKZ4FT_cjs.readMatrxNdjsonStream(response.body, {
         ...signal ? { signal } : {},
         ...hooks.onMalformedLine ? { onMalformedLine: hooks.onMalformedLine } : {},
         ...hooks.onUnknownEnvelope ? { onUnknownEnvelope: hooks.onUnknownEnvelope } : {}
@@ -219,7 +219,7 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
       if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
         return;
       }
-      const transportError = error instanceof chunkNMBDYPFZ_cjs.BackendApiError ? error : new chunkNMBDYPFZ_cjs.StreamTransportError({
+      const transportError = error instanceof chunkPMGKZ4FT_cjs.BackendApiError ? error : new chunkPMGKZ4FT_cjs.StreamTransportError({
         detail: error instanceof Error ? error.message : "The response stream ended unexpectedly.",
         details: error,
         ...ids.requestId ? { requestId: ids.requestId } : {}
@@ -236,7 +236,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: chunkNMBDYPFZ_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
+    message: chunkPMGKZ4FT_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
     status: response.status,
     serverDetail
   };
@@ -312,7 +312,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
     return await fetch(url, { ...init, signal: controller.signal });
   } catch (error) {
     if (timedOut) {
-      throw new chunkNMBDYPFZ_cjs.BackendApiError({
+      throw new chunkPMGKZ4FT_cjs.BackendApiError({
         code: "request_timeout",
         detail: `${init.method ?? "GET"} ${url} exceeded ${options.timeoutMs}ms`,
         userMessage: "The request timed out \u2014 please retry.",
@@ -326,7 +326,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
   }
 }
 async function readMatrxJsonResponse(response) {
-  if (!response.ok) throw await chunkNMBDYPFZ_cjs.parseHttpError(response);
+  if (!response.ok) throw await chunkPMGKZ4FT_cjs.parseHttpError(response);
   if (response.status === 204) return null;
   return await response.json();
 }
@@ -334,7 +334,7 @@ function classifyStatus(status) {
   return status >= 400 && status < 500 ? "validation_error" : "http_error";
 }
 function normalizeMatrxError(err) {
-  if (err instanceof chunkNMBDYPFZ_cjs.OrganizationContextError) {
+  if (err instanceof chunkPMGKZ4FT_cjs.OrganizationContextError) {
     return {
       type: "validation_error",
       message: err.message,
@@ -346,7 +346,7 @@ function normalizeMatrxError(err) {
   if (err instanceof DOMException && err.name === "AbortError") {
     return { type: "abort_error", message: "Request was cancelled." };
   }
-  if (err instanceof chunkNMBDYPFZ_cjs.MatrxApiError) {
+  if (err instanceof chunkPMGKZ4FT_cjs.MatrxApiError) {
     return {
       type: classifyStatus(err.status),
       message: honestTransportMessage(err.message, err.status),
@@ -356,7 +356,7 @@ function normalizeMatrxError(err) {
       name: err.name
     };
   }
-  if (err instanceof chunkNMBDYPFZ_cjs.BackendApiError) {
+  if (err instanceof chunkPMGKZ4FT_cjs.BackendApiError) {
     return {
       type: "network_error",
       message: honestTransportMessage(
@@ -454,9 +454,9 @@ function createMatrxTransport(options) {
   };
   const resolveOrganizationId = (callOrganizationId) => {
     if (organizationId === void 0) return null;
-    if (callOrganizationId !== null) return chunkNMBDYPFZ_cjs.requireOrganizationContext(callOrganizationId);
+    if (callOrganizationId !== null) return chunkPMGKZ4FT_cjs.requireOrganizationContext(callOrganizationId);
     const candidate = typeof organizationId === "function" ? organizationId() : organizationId;
-    return chunkNMBDYPFZ_cjs.requireOrganizationContext(candidate);
+    return chunkPMGKZ4FT_cjs.requireOrganizationContext(candidate);
   };
   return {
     async fetch(path, init) {
@@ -473,7 +473,7 @@ function createMatrxTransport(options) {
       };
       const orgId = resolveOrganizationId(callOrganizationId);
       if (orgId !== null) {
-        headers = chunkNMBDYPFZ_cjs.applyOrganizationContextHeader(headers, orgId);
+        headers = chunkPMGKZ4FT_cjs.applyOrganizationContextHeader(headers, orgId);
       }
       const info = {
         url,
@@ -506,11 +506,11 @@ function createMatrxTransport(options) {
       }
       if (!response.ok && !expectedErrorStatuses?.includes(response.status)) {
         const serverDetail = await response.clone().json().catch(() => void 0);
-        const code = chunkNMBDYPFZ_cjs.extractMatrxErrorCode(serverDetail);
+        const code = chunkPMGKZ4FT_cjs.extractMatrxErrorCode(serverDetail);
         diagnostics?.onError?.(
           {
             type: classifyStatus(response.status),
-            message: chunkNMBDYPFZ_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
+            message: chunkPMGKZ4FT_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
             status: response.status,
             serverDetail,
             ...code ? { code } : {}
@@ -840,7 +840,7 @@ async function readServerDetail(response) {
   }
 }
 async function throwApiError(path, response) {
-  throw new chunkNMBDYPFZ_cjs.MatrxApiError({
+  throw new chunkPMGKZ4FT_cjs.MatrxApiError({
     status: response.status,
     path,
     serverDetail: await readServerDetail(response)
@@ -861,7 +861,7 @@ function toRunHandle(response, options) {
   return {
     requestId: response.headers.get("X-Request-ID"),
     conversationId: response.headers.get("X-Conversation-ID"),
-    events: chunkNMBDYPFZ_cjs.readMatrxNdjsonStream(response.body, {
+    events: chunkPMGKZ4FT_cjs.readMatrxNdjsonStream(response.body, {
       ...options.signal ? { signal: options.signal } : {},
       ...options.maxReadAhead !== void 0 ? { maxReadAhead: options.maxReadAhead } : {},
       ...options.onMalformedLine ? { onMalformedLine: options.onMalformedLine } : {},
@@ -884,7 +884,7 @@ async function requestStream(transport, path, options) {
   });
   if (!response.ok) return throwApiError(path, response);
   if (!response.body) {
-    throw new chunkNMBDYPFZ_cjs.MatrxApiError({
+    throw new chunkPMGKZ4FT_cjs.MatrxApiError({
       status: response.status,
       path,
       serverDetail: { code: "missing_response_body" },
@@ -944,7 +944,7 @@ async function getRuntimeOperationStatus(transport, requestId, options = {}) {
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkNMBDYPFZ_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkPMGKZ4FT_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -959,7 +959,7 @@ async function getRuntimeOperationsByLink(transport, linkKind, linkId, options =
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkNMBDYPFZ_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkPMGKZ4FT_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -1000,7 +1000,7 @@ async function* followRuntimeOperationEvents(transport, executionId, options = {
       ...options.signal ? { signal: options.signal } : {}
     }
   );
-  const frames = chunkNMBDYPFZ_cjs.readMatrxSseStream(
+  const frames = chunkPMGKZ4FT_cjs.readMatrxSseStream(
     response.body,
     options.onIncomplete ? { onIncomplete: options.onIncomplete } : {}
   );
@@ -1203,7 +1203,7 @@ async function openMatrxStream(transport, path, options = {}) {
   return toRunHandle(response, options);
 }
 function withRunOrganization(transport, organizationId) {
-  const orgId = chunkNMBDYPFZ_cjs.requireOrganizationContext(organizationId);
+  const orgId = chunkPMGKZ4FT_cjs.requireOrganizationContext(organizationId);
   return {
     fetch: (path, init) => transport.fetch(path, {
       ...init,
@@ -1230,7 +1230,7 @@ async function followWorkflowRunEvents(transport, runId, options) {
     throw error;
   }
   try {
-    for await (const frame of chunkNMBDYPFZ_cjs.readMatrxSseStream(
+    for await (const frame of chunkPMGKZ4FT_cjs.readMatrxSseStream(
       response.body
     )) {
       if (frame.event === "end") return { ended: true };
@@ -1276,7 +1276,7 @@ async function resumeOrRejoin(transport, resumeCall, options) {
   } catch (error) {
     const target = readLiveRunRejoin(error);
     if (!target) {
-      if (error instanceof chunkNMBDYPFZ_cjs.MatrxApiError && isResumeConflict(error)) {
+      if (error instanceof chunkPMGKZ4FT_cjs.MatrxApiError && isResumeConflict(error)) {
         return { kind: "resume_conflict", error };
       }
       throw error;
@@ -1692,7 +1692,7 @@ async function reportProviderSessionUsage(transport, usage, options = {}) {
     });
     return "ok";
   } catch (error) {
-    if (error instanceof chunkNMBDYPFZ_cjs.MatrxApiError) {
+    if (error instanceof chunkPMGKZ4FT_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})`);
@@ -2396,111 +2396,111 @@ Object.defineProperty(exports, "toCredentialsPort", {
 });
 Object.defineProperty(exports, "BackendApiError", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.BackendApiError; }
+  get: function () { return chunkPMGKZ4FT_cjs.BackendApiError; }
 });
 Object.defineProperty(exports, "CONTRACT_SHA256", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.CONTRACT_SHA256; }
+  get: function () { return chunkPMGKZ4FT_cjs.CONTRACT_SHA256; }
 });
 Object.defineProperty(exports, "DEPLOYMENTS", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.DEPLOYMENTS; }
+  get: function () { return chunkPMGKZ4FT_cjs.DEPLOYMENTS; }
 });
 Object.defineProperty(exports, "DOMAINS", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.DOMAINS; }
+  get: function () { return chunkPMGKZ4FT_cjs.DOMAINS; }
 });
 Object.defineProperty(exports, "MatrxApiError", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.MatrxApiError; }
+  get: function () { return chunkPMGKZ4FT_cjs.MatrxApiError; }
 });
 Object.defineProperty(exports, "OrganizationContextError", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.OrganizationContextError; }
+  get: function () { return chunkPMGKZ4FT_cjs.OrganizationContextError; }
 });
 Object.defineProperty(exports, "StreamTransportError", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.StreamTransportError; }
+  get: function () { return chunkPMGKZ4FT_cjs.StreamTransportError; }
 });
 Object.defineProperty(exports, "applyOrganizationContextHeader", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.applyOrganizationContextHeader; }
+  get: function () { return chunkPMGKZ4FT_cjs.applyOrganizationContextHeader; }
 });
 Object.defineProperty(exports, "assertOrganizationMatchesOperation", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.assertOrganizationMatchesOperation; }
+  get: function () { return chunkPMGKZ4FT_cjs.assertOrganizationMatchesOperation; }
 });
 Object.defineProperty(exports, "assertQueryOrganizationMatchesContext", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.assertQueryOrganizationMatchesContext; }
+  get: function () { return chunkPMGKZ4FT_cjs.assertQueryOrganizationMatchesContext; }
 });
 Object.defineProperty(exports, "createApi", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.createApi; }
+  get: function () { return chunkPMGKZ4FT_cjs.createApi; }
 });
 Object.defineProperty(exports, "createOrganizationOperation", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.createOrganizationOperation; }
+  get: function () { return chunkPMGKZ4FT_cjs.createOrganizationOperation; }
 });
 Object.defineProperty(exports, "describeBackendFailure", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.describeBackendFailure; }
+  get: function () { return chunkPMGKZ4FT_cjs.describeBackendFailure; }
 });
 Object.defineProperty(exports, "extractMatrxErrorCode", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.extractMatrxErrorCode; }
+  get: function () { return chunkPMGKZ4FT_cjs.extractMatrxErrorCode; }
 });
 Object.defineProperty(exports, "extractMatrxErrorMessage", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.extractMatrxErrorMessage; }
+  get: function () { return chunkPMGKZ4FT_cjs.extractMatrxErrorMessage; }
 });
 Object.defineProperty(exports, "getUserMessage", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.getUserMessage; }
+  get: function () { return chunkPMGKZ4FT_cjs.getUserMessage; }
 });
 Object.defineProperty(exports, "isGenericUserMessage", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.isGenericUserMessage; }
+  get: function () { return chunkPMGKZ4FT_cjs.isGenericUserMessage; }
 });
 Object.defineProperty(exports, "isStreamTransportLost", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.isStreamTransportLost; }
+  get: function () { return chunkPMGKZ4FT_cjs.isStreamTransportLost; }
 });
 Object.defineProperty(exports, "openJsonOrStream", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.openJsonOrStream; }
+  get: function () { return chunkPMGKZ4FT_cjs.openJsonOrStream; }
 });
 Object.defineProperty(exports, "openStream", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.openStream; }
+  get: function () { return chunkPMGKZ4FT_cjs.openStream; }
 });
 Object.defineProperty(exports, "parseCallApiError", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.parseCallApiError; }
+  get: function () { return chunkPMGKZ4FT_cjs.parseCallApiError; }
 });
 Object.defineProperty(exports, "parseHttpError", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.parseHttpError; }
+  get: function () { return chunkPMGKZ4FT_cjs.parseHttpError; }
 });
 Object.defineProperty(exports, "parseHttpErrorBody", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.parseHttpErrorBody; }
+  get: function () { return chunkPMGKZ4FT_cjs.parseHttpErrorBody; }
 });
 Object.defineProperty(exports, "parsePersistedBackendError", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.parsePersistedBackendError; }
+  get: function () { return chunkPMGKZ4FT_cjs.parsePersistedBackendError; }
 });
 Object.defineProperty(exports, "parseStreamError", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.parseStreamError; }
+  get: function () { return chunkPMGKZ4FT_cjs.parseStreamError; }
 });
 Object.defineProperty(exports, "requireOrganizationContext", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.requireOrganizationContext; }
+  get: function () { return chunkPMGKZ4FT_cjs.requireOrganizationContext; }
 });
 Object.defineProperty(exports, "unwrapUpstreamError", {
   enumerable: true,
-  get: function () { return chunkNMBDYPFZ_cjs.unwrapUpstreamError; }
+  get: function () { return chunkPMGKZ4FT_cjs.unwrapUpstreamError; }
 });
 Object.defineProperty(exports, "AbortedError", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-D_ZjxGwP.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-D_ZjxGwP.cjs';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-C3ZlP3BI.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-C3ZlP3BI.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 } from './net.cjs';
@@ -7,7 +7,7 @@ export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, Ne
 import { g as MandateKey, b as DynamicMandateKey } from './keys.generated-CK_C5UXG.cjs';
 
 /**
- * `@ai-matrx/agents/matrx` — the Matrx transport port.
+ * `@ai-matrx/api` — the Matrx transport port.
  *
  * The ONE seam between this package's wire semantics and a host's connection
  * policy. This package owns WHAT is said to the AI Matrx server — paths,
@@ -100,7 +100,7 @@ declare function extractMatrxErrorMessage(serverDetail: unknown): string | undef
 declare function extractMatrxErrorCode(serverDetail: unknown): string | null;
 
 /**
- * `@ai-matrx/agents/matrx` — the AI Matrx server's error model, as every
+ * `@ai-matrx/api` — the AI Matrx server's error model, as every
  * client reads it: `BackendApiError` (the server's `APIError` body),
  * `StreamTransportError` (the socket died mid-run; the run may still finish
  * and is reattachable), parsing of HTTP / stream / persisted errors, and the
@@ -429,7 +429,7 @@ declare function aiVersionPathOverrides(version: MatrxAiApiVersion): Record<stri
  * - **timeouts** — connect 15s (for a non-streaming FastAPI handler this is
  *   effectively time-to-response), total UNCAPPED (the port cannot tell a JSON
  *   call from a long-lived NDJSON/SSE stream; the connect timeout is the JSON
- *   guard), via `@ai-matrx/data/net`'s `resilientFetch`;
+ *   guard), via `@ai-matrx/api/net`'s `resilientFetch`;
  * - **protocol** — the AI API version transform (`applyAiApiVersion`, default
  *   v2) + the loud v2 → v1 transport fallback (`./protocol`);
  * - **credentials** — read fresh from the injected `CredentialsPort` on EVERY
@@ -584,7 +584,7 @@ interface CreateMatrxTransportOptions {
 declare function createMatrxTransport(options: CreateMatrxTransportOptions): MatrxTransport;
 
 /**
- * `@ai-matrx/agents/matrx` — THE request pipeline every typed Matrx server call
+ * `@ai-matrx/api` — THE request pipeline every typed Matrx server call
  * rides (chat package independence P9b). One implementation for every client:
  * matrx-frontend's `lib/api` `callApi` and the chat package's bare-host default
  * both build on it, and supply only their host facts — where the server is,
@@ -815,7 +815,7 @@ declare function applyOrganizationContextHeader(headers: Record<string, string>,
  */
 declare function assertQueryOrganizationMatchesContext(queryParams: Record<string, string | number | boolean> | undefined, organizationId: string): void;
 
-/** `@ai-matrx/agents/matrx` — moved from matrx-frontend `lib/api/log-api-target.ts` (chat-package independence P9). */
+/** `@ai-matrx/api` — moved from matrx-frontend `lib/api/log-api-target.ts` (chat-package independence P9). */
 /**
  * lib/api/log-api-target.ts
  *
@@ -860,7 +860,7 @@ interface ApiTargetLogContext {
 declare function logApiTarget(url: string, context: ApiTargetLogContext): void;
 
 /**
- * `@ai-matrx/agents/matrx` — the single primitive that transforms a server
+ * `@ai-matrx/api` — the single primitive that transforms a server
  * endpoint PATH (never the base URL) before it is sent: an exact per-path
  * override, else a global version prefix. Moved from matrx-frontend
  * `lib/api/resolve-endpoint-path.ts` (chat-package independence P9).
@@ -906,7 +906,7 @@ declare function resolveEndpointPath(canonicalPath: string, config?: EndpointOve
 declare function applyDesktopTargetToRequestBody(body: unknown, targetInstanceId: string | null | undefined): void;
 
 /**
- * `@ai-matrx/agents/matrx` — moved from matrx-frontend `lib/api/run-wait.ts` (chat-package
+ * `@ai-matrx/api` — moved from matrx-frontend `lib/api/run-wait.ts` (chat-package
  * independence P9). The knob read is injected (`resolveRunWaitWith`); the host wraps it.
  */
 /**
@@ -991,7 +991,7 @@ declare function runJobLabel(kind: RunOutputKind, modelLabel: string | null): st
 declare function runWaitTimeoutMessage(kind: RunOutputKind, modelLabel: string | null, seconds: number | null): string;
 
 /**
- * `@ai-matrx/agents/matrx` — the client warm-up primitive.
+ * `@ai-matrx/api` — the client warm-up primitive.
  *
  * Contract: common-docs `systems/architecture/warm-cache/CONTRACT.md`.
  *
@@ -1063,7 +1063,7 @@ declare function preconnectServer(baseUrl: string | null | undefined): void;
 declare function resetPreconnectedForTests(): void;
 
 /**
- * Internal request plumbing for `@ai-matrx/agents/matrx`. Not part of the
+ * Internal request plumbing for `@ai-matrx/api`. Not part of the
  * public surface — `matrx/index.ts` deliberately does not re-export this
  * module. Everything here is pure: no globals, no work at import time.
  */
@@ -2369,7 +2369,7 @@ declare function listUserPendingToolCalls(transport: MatrxTransport, options?: {
 }): Promise<MatrxPendingCallSummary[]>;
 
 /**
- * `@ai-matrx/agents/matrx` — every AI Matrx server endpoint path, by feature
+ * `@ai-matrx/api` — every AI Matrx server endpoint path, by feature
  * area (matching the server's router structure). Paths only, rooted at the
  * host (`/ai/...`, `/health`); the HOST owns the base URL.
  *

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-D_ZjxGwP.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-D_ZjxGwP.js';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-C3ZlP3BI.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-C3ZlP3BI.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 } from './net.js';
@@ -7,7 +7,7 @@ export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, Ne
 import { g as MandateKey, b as DynamicMandateKey } from './keys.generated-CK_C5UXG.js';
 
 /**
- * `@ai-matrx/agents/matrx` — the Matrx transport port.
+ * `@ai-matrx/api` — the Matrx transport port.
  *
  * The ONE seam between this package's wire semantics and a host's connection
  * policy. This package owns WHAT is said to the AI Matrx server — paths,
@@ -100,7 +100,7 @@ declare function extractMatrxErrorMessage(serverDetail: unknown): string | undef
 declare function extractMatrxErrorCode(serverDetail: unknown): string | null;
 
 /**
- * `@ai-matrx/agents/matrx` — the AI Matrx server's error model, as every
+ * `@ai-matrx/api` — the AI Matrx server's error model, as every
  * client reads it: `BackendApiError` (the server's `APIError` body),
  * `StreamTransportError` (the socket died mid-run; the run may still finish
  * and is reattachable), parsing of HTTP / stream / persisted errors, and the
@@ -429,7 +429,7 @@ declare function aiVersionPathOverrides(version: MatrxAiApiVersion): Record<stri
  * - **timeouts** — connect 15s (for a non-streaming FastAPI handler this is
  *   effectively time-to-response), total UNCAPPED (the port cannot tell a JSON
  *   call from a long-lived NDJSON/SSE stream; the connect timeout is the JSON
- *   guard), via `@ai-matrx/data/net`'s `resilientFetch`;
+ *   guard), via `@ai-matrx/api/net`'s `resilientFetch`;
  * - **protocol** — the AI API version transform (`applyAiApiVersion`, default
  *   v2) + the loud v2 → v1 transport fallback (`./protocol`);
  * - **credentials** — read fresh from the injected `CredentialsPort` on EVERY
@@ -584,7 +584,7 @@ interface CreateMatrxTransportOptions {
 declare function createMatrxTransport(options: CreateMatrxTransportOptions): MatrxTransport;
 
 /**
- * `@ai-matrx/agents/matrx` — THE request pipeline every typed Matrx server call
+ * `@ai-matrx/api` — THE request pipeline every typed Matrx server call
  * rides (chat package independence P9b). One implementation for every client:
  * matrx-frontend's `lib/api` `callApi` and the chat package's bare-host default
  * both build on it, and supply only their host facts — where the server is,
@@ -815,7 +815,7 @@ declare function applyOrganizationContextHeader(headers: Record<string, string>,
  */
 declare function assertQueryOrganizationMatchesContext(queryParams: Record<string, string | number | boolean> | undefined, organizationId: string): void;
 
-/** `@ai-matrx/agents/matrx` — moved from matrx-frontend `lib/api/log-api-target.ts` (chat-package independence P9). */
+/** `@ai-matrx/api` — moved from matrx-frontend `lib/api/log-api-target.ts` (chat-package independence P9). */
 /**
  * lib/api/log-api-target.ts
  *
@@ -860,7 +860,7 @@ interface ApiTargetLogContext {
 declare function logApiTarget(url: string, context: ApiTargetLogContext): void;
 
 /**
- * `@ai-matrx/agents/matrx` — the single primitive that transforms a server
+ * `@ai-matrx/api` — the single primitive that transforms a server
  * endpoint PATH (never the base URL) before it is sent: an exact per-path
  * override, else a global version prefix. Moved from matrx-frontend
  * `lib/api/resolve-endpoint-path.ts` (chat-package independence P9).
@@ -906,7 +906,7 @@ declare function resolveEndpointPath(canonicalPath: string, config?: EndpointOve
 declare function applyDesktopTargetToRequestBody(body: unknown, targetInstanceId: string | null | undefined): void;
 
 /**
- * `@ai-matrx/agents/matrx` — moved from matrx-frontend `lib/api/run-wait.ts` (chat-package
+ * `@ai-matrx/api` — moved from matrx-frontend `lib/api/run-wait.ts` (chat-package
  * independence P9). The knob read is injected (`resolveRunWaitWith`); the host wraps it.
  */
 /**
@@ -991,7 +991,7 @@ declare function runJobLabel(kind: RunOutputKind, modelLabel: string | null): st
 declare function runWaitTimeoutMessage(kind: RunOutputKind, modelLabel: string | null, seconds: number | null): string;
 
 /**
- * `@ai-matrx/agents/matrx` — the client warm-up primitive.
+ * `@ai-matrx/api` — the client warm-up primitive.
  *
  * Contract: common-docs `systems/architecture/warm-cache/CONTRACT.md`.
  *
@@ -1063,7 +1063,7 @@ declare function preconnectServer(baseUrl: string | null | undefined): void;
 declare function resetPreconnectedForTests(): void;
 
 /**
- * Internal request plumbing for `@ai-matrx/agents/matrx`. Not part of the
+ * Internal request plumbing for `@ai-matrx/api`. Not part of the
  * public surface — `matrx/index.ts` deliberately does not re-export this
  * module. Everything here is pure: no globals, no work at import time.
  */
@@ -2369,7 +2369,7 @@ declare function listUserPendingToolCalls(transport: MatrxTransport, options?: {
 }): Promise<MatrxPendingCallSummary[]>;
 
 /**
- * `@ai-matrx/agents/matrx` — every AI Matrx server endpoint path, by feature
+ * `@ai-matrx/api` — every AI Matrx server endpoint path, by feature
  * area (matching the server's router structure). Paths only, rooted at the
  * host (`/ai/...`, `/health`); the HOST owns the base URL.
  *

package/dist/index.js

@@ -1,7 +1,7 @@
 export { monitorStream } from './chunk-YTEOFGFC.js';
 export { API_KEY_PREFIX, MATRX_HEADERS, credentialToHeaders, toCredentialsPort } from './chunk-7MZPBCFV.js';
-import { OrganizationContextError, BackendApiError, parseHttpError, MatrxApiError, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, StreamTransportError } from './chunk-5BBHAAIG.js';
-export { BackendApiError, CONTRACT_SHA256, DEPLOYMENTS, DOMAINS, MatrxApiError, OrganizationContextError, StreamTransportError, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, getUserMessage, isGenericUserMessage, isStreamTransportLost, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parsePersistedBackendError, parseStreamError, requireOrganizationContext, unwrapUpstreamError } from './chunk-5BBHAAIG.js';
+import { OrganizationContextError, BackendApiError, parseHttpError, MatrxApiError, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, StreamTransportError } from './chunk-PIVTHTVR.js';
+export { BackendApiError, CONTRACT_SHA256, DEPLOYMENTS, DOMAINS, MatrxApiError, OrganizationContextError, StreamTransportError, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, getUserMessage, isGenericUserMessage, isStreamTransportLost, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parsePersistedBackendError, parseStreamError, requireOrganizationContext, unwrapUpstreamError } from './chunk-PIVTHTVR.js';
 import { resilientFetch, isNetError, extractErrorMessage } from './chunk-KIEAFMKB.js';
 export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetworkError, OfflineError, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, resilientFetch, toNetError, withRetry } from './chunk-KIEAFMKB.js';
 import { credentialToHeaders } from '@ai-matrx/auth/credentials';

package/dist/integrations.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkNMBDYPFZ_cjs = require('./chunk-NMBDYPFZ.cjs');
+var chunkPMGKZ4FT_cjs = require('./chunk-PMGKZ4FT.cjs');
 require('./chunk-2SXAAKGV.cjs');
 
 // src/generated/integrations.ts
@@ -3562,11 +3562,11 @@ function bingIntegrationsDisconnect(api, args, options) {
 }
 var $importNotionZip = { m: "POST", p: "/notion-import/zip", d: "aidream", a: "user", o: "required", s: "ndjson", n: "integrations.import_notion_zip" };
 function importNotionZip(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $importNotionZip, args, options);
+  return chunkPMGKZ4FT_cjs.openStream(api, $importNotionZip, args, options);
 }
 var $importNotionConnected = { m: "POST", p: "/notion-import/connected", d: "aidream", a: "user", o: "required", s: "ndjson", n: "integrations.import_notion_connected" };
 function importNotionConnected(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $importNotionConnected, args, options);
+  return chunkPMGKZ4FT_cjs.openStream(api, $importNotionConnected, args, options);
 }
 var TABLE = {
   "GET /ebay/account-deletion": $ebayAccountDeletionChallenge,

package/dist/integrations.d.cts

@@ -1,4 +1,4 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-D_ZjxGwP.cjs';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-C3ZlP3BI.cjs';
 import { JsonValue, CalendarLocalRefreshResult, CalendarCreateResult, CalendarEventAttendee, StorageImportResult } from './schemas.cjs';
 import '@ai-matrx/auth/credentials';
 

package/dist/integrations.d.ts

@@ -1,4 +1,4 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-D_ZjxGwP.js';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-C3ZlP3BI.js';
 import { JsonValue, CalendarLocalRefreshResult, CalendarCreateResult, CalendarEventAttendee, StorageImportResult } from './schemas.js';
 import '@ai-matrx/auth/credentials';
 

package/dist/integrations.js

@@ -1,4 +1,4 @@
-import { openStream } from './chunk-5BBHAAIG.js';
+import { openStream } from './chunk-PIVTHTVR.js';
 import './chunk-KIEAFMKB.js';
 
 // src/generated/integrations.ts