@ai-matrx/api 0.1.23 → 0.1.25

package/dist/human-resources.d.cts

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

package/dist/human-resources.d.ts

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

package/dist/{index-BgjdVvrS.d.cts → index-BluxzzHL.d.cts}

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

package/dist/{index-BgjdVvrS.d.ts → index-BluxzzHL.d.ts}

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

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 var chunkFNIYADWI_cjs = require('./chunk-FNIYADWI.cjs');
 var chunkMVXD6WI6_cjs = require('./chunk-MVXD6WI6.cjs');
-var chunkZOZOF5DN_cjs = require('./chunk-ZOZOF5DN.cjs');
+var chunkHM5A33QV_cjs = require('./chunk-HM5A33QV.cjs');
 var chunk2SXAAKGV_cjs = require('./chunk-2SXAAKGV.cjs');
 var format = require('@ai-matrx/kit/format');
 
@@ -44,7 +44,7 @@ function buildMatrxRequestBody(body, scope) {
   }
   const bodyOrganizationId = base.organization_id;
   if (scope.organization_id !== void 0 && bodyOrganizationId !== void 0 && (typeof bodyOrganizationId !== "string" || bodyOrganizationId.trim() !== scope.organization_id)) {
-    throw new chunkZOZOF5DN_cjs.OrganizationContextError(
+    throw new chunkHM5A33QV_cjs.OrganizationContextError(
       "organization_context_mismatch",
       "Request body organization_id must match the request context organization."
     );
@@ -116,14 +116,14 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
   };
   async function* events() {
     if (!response.body) {
-      throw new chunkZOZOF5DN_cjs.BackendApiError({
+      throw new chunkHM5A33QV_cjs.BackendApiError({
         code: "internal_error",
         detail: "Response has no body",
         userMessage: "No response received from server"
       });
     }
     try {
-      for await (const envelope of chunkZOZOF5DN_cjs.readMatrxNdjsonStream(response.body, {
+      for await (const envelope of chunkHM5A33QV_cjs.readMatrxNdjsonStream(response.body, {
         ...signal ? { signal } : {},
         ...hooks.onMalformedLine ? { onMalformedLine: hooks.onMalformedLine } : {},
         ...hooks.onUnknownEnvelope ? { onUnknownEnvelope: hooks.onUnknownEnvelope } : {}
@@ -135,7 +135,7 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
       if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
         return;
       }
-      const transportError = error instanceof chunkZOZOF5DN_cjs.BackendApiError ? error : new chunkZOZOF5DN_cjs.StreamTransportError({
+      const transportError = error instanceof chunkHM5A33QV_cjs.BackendApiError ? error : new chunkHM5A33QV_cjs.StreamTransportError({
         detail: error instanceof Error ? error.message : "The response stream ended unexpectedly.",
         details: error,
         ...ids.requestId ? { requestId: ids.requestId } : {}
@@ -152,7 +152,7 @@ async function httpErrorFrom(response) {
   const serverDetail = await response.json().catch(() => void 0);
   return {
     type: response.status >= 400 && response.status < 500 ? "validation_error" : "http_error",
-    message: chunkZOZOF5DN_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
+    message: chunkHM5A33QV_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
     status: response.status,
     serverDetail
   };
@@ -160,7 +160,7 @@ async function httpErrorFrom(response) {
 async function executeMatrxCall(request, hooks = {}) {
   const upper = request.method.toUpperCase();
   const sendsBody = request.stream || upper !== "GET" && upper !== "HEAD";
-  const { response } = await chunkZOZOF5DN_cjs.sendOnWire({
+  const { response } = await chunkHM5A33QV_cjs.sendOnWire({
     url: request.url,
     method: request.method,
     headers: request.headers,
@@ -210,11 +210,11 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
     headers[name] = value;
   });
   const fetchOptions = {};
-  for (const key of chunkZOZOF5DN_cjs.WIRE_FETCH_OPTION_KEYS) {
+  for (const key of chunkHM5A33QV_cjs.WIRE_FETCH_OPTION_KEYS) {
     if (init[key] !== void 0) fetchOptions[key] = init[key];
   }
   try {
-    const { response } = await chunkZOZOF5DN_cjs.sendOnWire({
+    const { response, controller } = await chunkHM5A33QV_cjs.sendOnWire({
       url,
       method: init.method ?? "GET",
       fetchOptions,
@@ -227,13 +227,17 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
       totalTimeoutMs: null,
       ...options.onUploadProgress ? { onUploadProgress: options.onUploadProgress } : {}
     });
+    if (callerSignal) {
+      if (callerSignal.aborted) controller.abort(callerSignal.reason);
+      else callerSignal.addEventListener("abort", () => controller.abort(callerSignal.reason), { once: true });
+    }
     return response;
   } catch (error) {
     if (chunk2SXAAKGV_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 && chunk2SXAAKGV_cjs.isNetError(error) && (error.code === "connect-timeout" || error.code === "total-timeout")) {
-      throw new chunkZOZOF5DN_cjs.BackendApiError({
+      throw new chunkHM5A33QV_cjs.BackendApiError({
         code: "request_timeout",
         detail: `${init.method ?? "GET"} ${url} exceeded ${options.timeoutMs}ms`,
         userMessage: "The request timed out \u2014 please retry.",
@@ -247,7 +251,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
   }
 }
 async function readMatrxJsonResponse(response) {
-  if (!response.ok) throw await chunkZOZOF5DN_cjs.parseHttpError(response);
+  if (!response.ok) throw await chunkHM5A33QV_cjs.parseHttpError(response);
   if (response.status === 204) return null;
   return await response.json();
 }
@@ -257,7 +261,7 @@ function classifyStatus(status) {
   return status >= 400 && status < 500 ? "validation_error" : "http_error";
 }
 function normalizeMatrxError(err) {
-  if (err instanceof chunkZOZOF5DN_cjs.OrganizationContextError) {
+  if (err instanceof chunkHM5A33QV_cjs.OrganizationContextError) {
     return {
       type: "validation_error",
       message: err.message,
@@ -269,7 +273,7 @@ function normalizeMatrxError(err) {
   if (err instanceof DOMException && err.name === "AbortError") {
     return { type: "abort_error", message: "Request was cancelled." };
   }
-  if (err instanceof chunkZOZOF5DN_cjs.MatrxApiError) {
+  if (err instanceof chunkHM5A33QV_cjs.MatrxApiError) {
     return {
       type: classifyStatus(err.status),
       message: honestTransportMessage(err.message, err.status),
@@ -279,7 +283,7 @@ function normalizeMatrxError(err) {
       name: err.name
     };
   }
-  if (err instanceof chunkZOZOF5DN_cjs.BackendApiError) {
+  if (err instanceof chunkHM5A33QV_cjs.BackendApiError) {
     return {
       type: "network_error",
       message: honestTransportMessage(
@@ -375,9 +379,9 @@ function createMatrxTransport(options) {
   const resolve = resolveTarget ?? (() => ({ baseUrl }));
   const resolveOrganizationId = (callOrganizationId) => {
     if (organizationId === void 0) return null;
-    if (callOrganizationId !== null) return chunkZOZOF5DN_cjs.requireOrganizationContext(callOrganizationId);
+    if (callOrganizationId !== null) return chunkHM5A33QV_cjs.requireOrganizationContext(callOrganizationId);
     const candidate = typeof organizationId === "function" ? organizationId() : organizationId;
-    return chunkZOZOF5DN_cjs.requireOrganizationContext(candidate);
+    return chunkHM5A33QV_cjs.requireOrganizationContext(candidate);
   };
   return {
     async fetch(path, init) {
@@ -388,7 +392,7 @@ function createMatrxTransport(options) {
       let overHeaders = callOrganizationId === null ? policyHeaders : stripOrganizationHeader(policyHeaders);
       const orgId = resolveOrganizationId(callOrganizationId);
       if (orgId !== null) {
-        overHeaders = chunkZOZOF5DN_cjs.applyOrganizationContextHeader(overHeaders, orgId);
+        overHeaders = chunkHM5A33QV_cjs.applyOrganizationContextHeader(overHeaders, orgId);
       }
       const wireHeaders = callOrganizationId === null ? { ...init.headers } : stripOrganizationHeader({ ...init.headers });
       const info = {
@@ -401,7 +405,7 @@ function createMatrxTransport(options) {
       diagnostics?.onRequest?.(info);
       let response;
       try {
-        ({ response } = await chunkZOZOF5DN_cjs.sendOnWire(
+        ({ response } = await chunkHM5A33QV_cjs.sendOnWire(
           {
             url,
             method: init.method,
@@ -425,11 +429,11 @@ function createMatrxTransport(options) {
       }
       if (!response.ok && !expectedErrorStatuses?.includes(response.status)) {
         const serverDetail = await response.clone().json().catch(() => void 0);
-        const code = chunkZOZOF5DN_cjs.extractMatrxErrorCode(serverDetail);
+        const code = chunkHM5A33QV_cjs.extractMatrxErrorCode(serverDetail);
         diagnostics?.onError?.(
           {
             type: classifyStatus(response.status),
-            message: chunkZOZOF5DN_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
+            message: chunkHM5A33QV_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
             status: response.status,
             serverDetail,
             ...code ? { code } : {}
@@ -708,7 +712,7 @@ async function readServerDetail(response) {
   }
 }
 async function throwApiError(path, response) {
-  throw new chunkZOZOF5DN_cjs.MatrxApiError({
+  throw new chunkHM5A33QV_cjs.MatrxApiError({
     status: response.status,
     path,
     serverDetail: await readServerDetail(response)
@@ -729,7 +733,7 @@ function toRunHandle(response, options) {
   return {
     requestId: response.headers.get("X-Request-ID"),
     conversationId: response.headers.get("X-Conversation-ID"),
-    events: chunkZOZOF5DN_cjs.readMatrxNdjsonStream(response.body, {
+    events: chunkHM5A33QV_cjs.readMatrxNdjsonStream(response.body, {
       ...options.signal ? { signal: options.signal } : {},
       ...options.maxReadAhead !== void 0 ? { maxReadAhead: options.maxReadAhead } : {},
       ...options.onMalformedLine ? { onMalformedLine: options.onMalformedLine } : {},
@@ -752,7 +756,7 @@ async function requestStream(transport, path, options) {
   });
   if (!response.ok) return throwApiError(path, response);
   if (!response.body) {
-    throw new chunkZOZOF5DN_cjs.MatrxApiError({
+    throw new chunkHM5A33QV_cjs.MatrxApiError({
       status: response.status,
       path,
       serverDetail: { code: "missing_response_body" },
@@ -812,7 +816,7 @@ async function getRuntimeOperationStatus(transport, requestId, options = {}) {
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkZOZOF5DN_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkHM5A33QV_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -827,7 +831,7 @@ async function getRuntimeOperationsByLink(transport, linkKind, linkId, options =
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkZOZOF5DN_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunkHM5A33QV_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -868,7 +872,7 @@ async function* followRuntimeOperationEvents(transport, executionId, options = {
       ...options.signal ? { signal: options.signal } : {}
     }
   );
-  const frames = chunkZOZOF5DN_cjs.readMatrxSseStream(
+  const frames = chunkHM5A33QV_cjs.readMatrxSseStream(
     response.body,
     options.onIncomplete ? { onIncomplete: options.onIncomplete } : {}
   );
@@ -1071,7 +1075,7 @@ async function openMatrxStream(transport, path, options = {}) {
   return toRunHandle(response, options);
 }
 function withRunOrganization(transport, organizationId) {
-  const orgId = chunkZOZOF5DN_cjs.requireOrganizationContext(organizationId);
+  const orgId = chunkHM5A33QV_cjs.requireOrganizationContext(organizationId);
   return {
     fetch: (path, init) => transport.fetch(path, {
       ...init,
@@ -1098,7 +1102,7 @@ async function followWorkflowRunEvents(transport, runId, options) {
     throw error;
   }
   try {
-    for await (const frame of chunkZOZOF5DN_cjs.readMatrxSseStream(
+    for await (const frame of chunkHM5A33QV_cjs.readMatrxSseStream(
       response.body
     )) {
       if (frame.event === "end") return { ended: true };
@@ -1144,7 +1148,7 @@ async function resumeOrRejoin(transport, resumeCall, options) {
   } catch (error) {
     const target = readLiveRunRejoin(error);
     if (!target) {
-      if (error instanceof chunkZOZOF5DN_cjs.MatrxApiError && isResumeConflict(error)) {
+      if (error instanceof chunkHM5A33QV_cjs.MatrxApiError && isResumeConflict(error)) {
         return { kind: "resume_conflict", error };
       }
       throw error;
@@ -1560,7 +1564,7 @@ async function reportProviderSessionUsage(transport, usage, options = {}) {
     });
     return "ok";
   } catch (error) {
-    if (error instanceof chunkZOZOF5DN_cjs.MatrxApiError) {
+    if (error instanceof chunkHM5A33QV_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})`);
@@ -1797,12 +1801,9 @@ var ENDPOINTS = {
      *
      * NOTE: this replaces the legacy `/ai/chat` endpoint. The canonical
      * client-side vocabulary is `manual` (see ConversationInvocation.routing
-     * .apiEndpointMode). The legacy `chat` alias below stays for one
-     * migration cycle.
+     * .apiEndpointMode).
      */
     manual: "/ai/manual",
-    /** @deprecated Use `ENDPOINTS.ai.manual`. Kept for one migration cycle. */
-    chat: "/ai/manual",
     /**
      * POST — Start a new agent conversation (Guest OK)
      * POST /ai/agents/{agentId}
@@ -1942,11 +1943,6 @@ var ENDPOINTS = {
     /** POST — Search and scrape with limits */
     searchAndScrapeLimited: "/scraper/search-and-scrape-limited"
   },
-  /** Utility endpoints — Guest OK */
-  utilities: {
-    /** @deprecated Use ENDPOINTS.pdf.extractText instead */
-    pdfExtractText: "/utilities/pdf/extract-text"
-  },
   /**
    * PDF extraction, manipulation, and document management — Authenticated.
    * Most JSON endpoints accept a unified source via `MediaRef` (preferred for
@@ -2264,115 +2260,115 @@ Object.defineProperty(exports, "toCredentialsPort", {
 });
 Object.defineProperty(exports, "BackendApiError", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.BackendApiError; }
+  get: function () { return chunkHM5A33QV_cjs.BackendApiError; }
 });
 Object.defineProperty(exports, "CONTRACT_SHA256", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.CONTRACT_SHA256; }
+  get: function () { return chunkHM5A33QV_cjs.CONTRACT_SHA256; }
 });
 Object.defineProperty(exports, "DEPLOYMENTS", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.DEPLOYMENTS; }
+  get: function () { return chunkHM5A33QV_cjs.DEPLOYMENTS; }
 });
 Object.defineProperty(exports, "DOMAINS", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.DOMAINS; }
+  get: function () { return chunkHM5A33QV_cjs.DOMAINS; }
 });
 Object.defineProperty(exports, "MatrxApiError", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.MatrxApiError; }
+  get: function () { return chunkHM5A33QV_cjs.MatrxApiError; }
 });
 Object.defineProperty(exports, "OrganizationContextError", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.OrganizationContextError; }
+  get: function () { return chunkHM5A33QV_cjs.OrganizationContextError; }
 });
 Object.defineProperty(exports, "StreamTransportError", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.StreamTransportError; }
+  get: function () { return chunkHM5A33QV_cjs.StreamTransportError; }
 });
 Object.defineProperty(exports, "applyOrganizationContextHeader", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.applyOrganizationContextHeader; }
+  get: function () { return chunkHM5A33QV_cjs.applyOrganizationContextHeader; }
 });
 Object.defineProperty(exports, "assertOrganizationMatchesOperation", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.assertOrganizationMatchesOperation; }
+  get: function () { return chunkHM5A33QV_cjs.assertOrganizationMatchesOperation; }
 });
 Object.defineProperty(exports, "assertQueryOrganizationMatchesContext", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.assertQueryOrganizationMatchesContext; }
+  get: function () { return chunkHM5A33QV_cjs.assertQueryOrganizationMatchesContext; }
 });
 Object.defineProperty(exports, "createApi", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.createApi; }
+  get: function () { return chunkHM5A33QV_cjs.createApi; }
 });
 Object.defineProperty(exports, "createOrganizationOperation", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.createOrganizationOperation; }
+  get: function () { return chunkHM5A33QV_cjs.createOrganizationOperation; }
 });
 Object.defineProperty(exports, "describeBackendFailure", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.describeBackendFailure; }
+  get: function () { return chunkHM5A33QV_cjs.describeBackendFailure; }
 });
 Object.defineProperty(exports, "extractMatrxErrorCode", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.extractMatrxErrorCode; }
+  get: function () { return chunkHM5A33QV_cjs.extractMatrxErrorCode; }
 });
 Object.defineProperty(exports, "extractMatrxErrorMessage", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.extractMatrxErrorMessage; }
+  get: function () { return chunkHM5A33QV_cjs.extractMatrxErrorMessage; }
 });
 Object.defineProperty(exports, "getUserMessage", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.getUserMessage; }
+  get: function () { return chunkHM5A33QV_cjs.getUserMessage; }
 });
 Object.defineProperty(exports, "isBinaryType", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.isBinaryType; }
+  get: function () { return chunkHM5A33QV_cjs.isBinaryType; }
 });
 Object.defineProperty(exports, "isGenericUserMessage", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.isGenericUserMessage; }
+  get: function () { return chunkHM5A33QV_cjs.isGenericUserMessage; }
 });
 Object.defineProperty(exports, "isStreamTransportLost", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.isStreamTransportLost; }
+  get: function () { return chunkHM5A33QV_cjs.isStreamTransportLost; }
 });
 Object.defineProperty(exports, "openJsonOrStream", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.openJsonOrStream; }
+  get: function () { return chunkHM5A33QV_cjs.openJsonOrStream; }
 });
 Object.defineProperty(exports, "openStream", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.openStream; }
+  get: function () { return chunkHM5A33QV_cjs.openStream; }
 });
 Object.defineProperty(exports, "parseCallApiError", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.parseCallApiError; }
+  get: function () { return chunkHM5A33QV_cjs.parseCallApiError; }
 });
 Object.defineProperty(exports, "parseHttpError", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.parseHttpError; }
+  get: function () { return chunkHM5A33QV_cjs.parseHttpError; }
 });
 Object.defineProperty(exports, "parseHttpErrorBody", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.parseHttpErrorBody; }
+  get: function () { return chunkHM5A33QV_cjs.parseHttpErrorBody; }
 });
 Object.defineProperty(exports, "parsePersistedBackendError", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.parsePersistedBackendError; }
+  get: function () { return chunkHM5A33QV_cjs.parsePersistedBackendError; }
 });
 Object.defineProperty(exports, "parseStreamError", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.parseStreamError; }
+  get: function () { return chunkHM5A33QV_cjs.parseStreamError; }
 });
 Object.defineProperty(exports, "requireOrganizationContext", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.requireOrganizationContext; }
+  get: function () { return chunkHM5A33QV_cjs.requireOrganizationContext; }
 });
 Object.defineProperty(exports, "unwrapUpstreamError", {
   enumerable: true,
-  get: function () { return chunkZOZOF5DN_cjs.unwrapUpstreamError; }
+  get: function () { return chunkHM5A33QV_cjs.unwrapUpstreamError; }
 });
 Object.defineProperty(exports, "AbortedError", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-BgjdVvrS.cjs';
-export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-BgjdVvrS.cjs';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-BluxzzHL.cjs';
+export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-BluxzzHL.cjs';
 import { CredentialsPort } from '@ai-matrx/auth/credentials';
 export { API_KEY_PREFIX, CredentialsPort, CredentialsSetting, MATRX_HEADERS, MatrxCredential, MatrxCredentialKind, credentialToHeaders, toCredentialsPort } from '@ai-matrx/auth/credentials';
 export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, ResilientFetchOptions, ResilientFetchResult, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.cjs';
@@ -2242,12 +2242,9 @@ declare const ENDPOINTS: {
          *
          * NOTE: this replaces the legacy `/ai/chat` endpoint. The canonical
          * client-side vocabulary is `manual` (see ConversationInvocation.routing
-         * .apiEndpointMode). The legacy `chat` alias below stays for one
-         * migration cycle.
+         * .apiEndpointMode).
          */
         readonly manual: "/ai/manual";
-        /** @deprecated Use `ENDPOINTS.ai.manual`. Kept for one migration cycle. */
-        readonly chat: "/ai/manual";
         /**
          * POST — Start a new agent conversation (Guest OK)
          * POST /ai/agents/{agentId}
@@ -2387,11 +2384,6 @@ declare const ENDPOINTS: {
         /** POST — Search and scrape with limits */
         readonly searchAndScrapeLimited: "/scraper/search-and-scrape-limited";
     };
-    /** Utility endpoints — Guest OK */
-    readonly utilities: {
-        /** @deprecated Use ENDPOINTS.pdf.extractText instead */
-        readonly pdfExtractText: "/utilities/pdf/extract-text";
-    };
     /**
      * PDF extraction, manipulation, and document management — Authenticated.
      * Most JSON endpoints accept a unified source via `MediaRef` (preferred for

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-BgjdVvrS.js';
-export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-BgjdVvrS.js';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-BluxzzHL.js';
+export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-BluxzzHL.js';
 import { CredentialsPort } from '@ai-matrx/auth/credentials';
 export { API_KEY_PREFIX, CredentialsPort, CredentialsSetting, MATRX_HEADERS, MatrxCredential, MatrxCredentialKind, credentialToHeaders, toCredentialsPort } from '@ai-matrx/auth/credentials';
 export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, ResilientFetchOptions, ResilientFetchResult, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.js';
@@ -2242,12 +2242,9 @@ declare const ENDPOINTS: {
          *
          * NOTE: this replaces the legacy `/ai/chat` endpoint. The canonical
          * client-side vocabulary is `manual` (see ConversationInvocation.routing
-         * .apiEndpointMode). The legacy `chat` alias below stays for one
-         * migration cycle.
+         * .apiEndpointMode).
          */
         readonly manual: "/ai/manual";
-        /** @deprecated Use `ENDPOINTS.ai.manual`. Kept for one migration cycle. */
-        readonly chat: "/ai/manual";
         /**
          * POST — Start a new agent conversation (Guest OK)
          * POST /ai/agents/{agentId}
@@ -2387,11 +2384,6 @@ declare const ENDPOINTS: {
         /** POST — Search and scrape with limits */
         readonly searchAndScrapeLimited: "/scraper/search-and-scrape-limited";
     };
-    /** Utility endpoints — Guest OK */
-    readonly utilities: {
-        /** @deprecated Use ENDPOINTS.pdf.extractText instead */
-        readonly pdfExtractText: "/utilities/pdf/extract-text";
-    };
     /**
      * PDF extraction, manipulation, and document management — Authenticated.
      * Most JSON endpoints accept a unified source via `MediaRef` (preferred for

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, sendOnWire, WIRE_FETCH_OPTION_KEYS, BackendApiError, parseHttpError, MatrxApiError, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, StreamTransportError } from './chunk-E3PGCGP7.js';
-export { BackendApiError, CONTRACT_SHA256, DEPLOYMENTS, DOMAINS, MatrxApiError, OrganizationContextError, StreamTransportError, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, getUserMessage, isBinaryType, isGenericUserMessage, isStreamTransportLost, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parsePersistedBackendError, parseStreamError, requireOrganizationContext, unwrapUpstreamError } from './chunk-E3PGCGP7.js';
+import { OrganizationContextError, sendOnWire, WIRE_FETCH_OPTION_KEYS, BackendApiError, parseHttpError, MatrxApiError, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, StreamTransportError } from './chunk-OYD4PTWW.js';
+export { BackendApiError, CONTRACT_SHA256, DEPLOYMENTS, DOMAINS, MatrxApiError, OrganizationContextError, StreamTransportError, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, getUserMessage, isBinaryType, isGenericUserMessage, isStreamTransportLost, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parsePersistedBackendError, parseStreamError, requireOrganizationContext, unwrapUpstreamError } from './chunk-OYD4PTWW.js';
 import { 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 { formatDurationSeconds } from '@ai-matrx/kit/format';
@@ -214,7 +214,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
     if (init[key] !== void 0) fetchOptions[key] = init[key];
   }
   try {
-    const { response } = await sendOnWire({
+    const { response, controller } = await sendOnWire({
       url,
       method: init.method ?? "GET",
       fetchOptions,
@@ -227,6 +227,10 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
       totalTimeoutMs: null,
       ...options.onUploadProgress ? { onUploadProgress: options.onUploadProgress } : {}
     });
+    if (callerSignal) {
+      if (callerSignal.aborted) controller.abort(callerSignal.reason);
+      else callerSignal.addEventListener("abort", () => controller.abort(callerSignal.reason), { once: true });
+    }
     return response;
   } catch (error) {
     if (isNetError(error) && error.code === "aborted") {
@@ -1797,12 +1801,9 @@ var ENDPOINTS = {
      *
      * NOTE: this replaces the legacy `/ai/chat` endpoint. The canonical
      * client-side vocabulary is `manual` (see ConversationInvocation.routing
-     * .apiEndpointMode). The legacy `chat` alias below stays for one
-     * migration cycle.
+     * .apiEndpointMode).
      */
     manual: "/ai/manual",
-    /** @deprecated Use `ENDPOINTS.ai.manual`. Kept for one migration cycle. */
-    chat: "/ai/manual",
     /**
      * POST — Start a new agent conversation (Guest OK)
      * POST /ai/agents/{agentId}
@@ -1942,11 +1943,6 @@ var ENDPOINTS = {
     /** POST — Search and scrape with limits */
     searchAndScrapeLimited: "/scraper/search-and-scrape-limited"
   },
-  /** Utility endpoints — Guest OK */
-  utilities: {
-    /** @deprecated Use ENDPOINTS.pdf.extractText instead */
-    pdfExtractText: "/utilities/pdf/extract-text"
-  },
   /**
    * PDF extraction, manipulation, and document management — Authenticated.
    * Most JSON endpoints accept a unified source via `MediaRef` (preferred for