@ai-matrx/api 0.1.8 → 0.1.10

package/dist/crm.js

@@ -1,5 +1,5 @@
-import { openStream } from './chunk-5BBHAAIG.js';
-import './chunk-KIEAFMKB.js';
+import { openStream } from './chunk-FLANGLCG.js';
+import './chunk-PIPE5OML.js';
 
 // src/generated/crm.ts
 var $listSendingIdentities = { m: "GET", p: "/sending-identities", d: "aidream", a: "user", o: "optional", n: "crm.list_sending_identities" };

package/dist/data.d.cts

@@ -1,4 +1,4 @@
-import { A as Api, C as CallOptions } from './index-D_ZjxGwP.cjs';
+import { A as Api, C as CallOptions } from './index-Gj30ybjE.cjs';
 import { JsonValue } from './schemas.cjs';
 import '@ai-matrx/auth/credentials';
 

package/dist/data.d.ts

@@ -1,4 +1,4 @@
-import { A as Api, C as CallOptions } from './index-D_ZjxGwP.js';
+import { A as Api, C as CallOptions } from './index-Gj30ybjE.js';
 import { JsonValue } from './schemas.js';
 import '@ai-matrx/auth/credentials';
 

package/dist/education.cjs

@@ -1,20 +1,20 @@
 'use strict';
 
-var chunkNMBDYPFZ_cjs = require('./chunk-NMBDYPFZ.cjs');
-require('./chunk-2SXAAKGV.cjs');
+var chunkSPASYIUH_cjs = require('./chunk-SPASYIUH.cjs');
+require('./chunk-PKYPPATQ.cjs');
 
 // src/generated/education.ts
 var $sourceCard = { m: "POST", p: "/education/images/source-card", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "education.source_card" };
 function sourceCard(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $sourceCard, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $sourceCard, args, options);
 }
 var $generateCard = { m: "POST", p: "/education/images/generate-card", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "education.generate_card" };
 function generateCard(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $generateCard, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $generateCard, args, options);
 }
 var $sourceSet = { m: "POST", p: "/education/images/source-set", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "education.source_set" };
 function sourceSet(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $sourceSet, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $sourceSet, args, options);
 }
 var TABLE = {};
 function call(api, key, args, options) {

package/dist/education.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-Gj30ybjE.cjs';
 import '@ai-matrx/auth/credentials';
 
 /**

package/dist/education.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-Gj30ybjE.js';
 import '@ai-matrx/auth/credentials';
 
 /**

package/dist/education.js

@@ -1,5 +1,5 @@
-import { openStream } from './chunk-5BBHAAIG.js';
-import './chunk-KIEAFMKB.js';
+import { openStream } from './chunk-FLANGLCG.js';
+import './chunk-PIPE5OML.js';
 
 // src/generated/education.ts
 var $sourceCard = { m: "POST", p: "/education/images/source-card", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "education.source_card" };

package/dist/files.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkNMBDYPFZ_cjs = require('./chunk-NMBDYPFZ.cjs');
-require('./chunk-2SXAAKGV.cjs');
+var chunkSPASYIUH_cjs = require('./chunk-SPASYIUH.cjs');
+require('./chunk-PKYPPATQ.cjs');
 
 // src/generated/files.ts
 var $compressPdf = { m: "POST", p: "/utilities/pdf/compress", d: "aidream", a: "guest", o: "required", n: "files.compress_pdf" };
@@ -10,7 +10,7 @@ function compressPdf(api, args, options) {
 }
 var $extractTextFromPdf = { m: "POST", p: "/utilities/pdf/extract-text", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.extract_text_from_pdf" };
 function extractTextFromPdf(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $extractTextFromPdf, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $extractTextFromPdf, args, options);
 }
 var $extractPages = { m: "POST", p: "/utilities/pdf/extract-pages", d: "aidream", a: "guest", o: "required", n: "files.extract_pages" };
 function extractPages(api, args, options) {
@@ -34,7 +34,7 @@ function mergePdfs(api, args, options) {
 }
 var $splitPdf = { m: "POST", p: "/utilities/pdf/split", d: "aidream", a: "guest", o: "required", s: "bytes_or_json", n: "files.split_pdf" };
 function splitPdf(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openJsonOrStream(api, $splitPdf, args, options);
+  return chunkSPASYIUH_cjs.openJsonOrStream(api, $splitPdf, args, options);
 }
 var $reorderPages = { m: "POST", p: "/utilities/pdf/reorder-pages", d: "aidream", a: "guest", o: "required", n: "files.reorder_pages" };
 function reorderPages(api, args, options) {
@@ -70,19 +70,19 @@ function studioRender(api, args, options) {
 }
 var $detectRepeatedRegionsEndpoint = { m: "POST", p: "/utilities/pdf/detect-repeated-regions", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.detect_repeated_regions_endpoint" };
 function detectRepeatedRegionsEndpoint(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $detectRepeatedRegionsEndpoint, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $detectRepeatedRegionsEndpoint, args, options);
 }
 var $stripRepeatedRegionsEndpoint = { m: "POST", p: "/utilities/pdf/strip-repeated-regions", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.strip_repeated_regions_endpoint" };
 function stripRepeatedRegionsEndpoint(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $stripRepeatedRegionsEndpoint, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $stripRepeatedRegionsEndpoint, args, options);
 }
 var $classifyPagesEndpoint = { m: "POST", p: "/utilities/pdf/classify-pages", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.classify_pages_endpoint" };
 function classifyPagesEndpoint(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $classifyPagesEndpoint, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $classifyPagesEndpoint, args, options);
 }
 var $extractReadingOrderEndpoint = { m: "POST", p: "/utilities/pdf/extract-reading-order", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.extract_reading_order_endpoint" };
 function extractReadingOrderEndpoint(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $extractReadingOrderEndpoint, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $extractReadingOrderEndpoint, args, options);
 }
 var $redactPatternsCatalog = { m: "GET", p: "/utilities/pdf/redact/patterns", d: "aidream", a: "guest", o: "optional", n: "files.redact_patterns_catalog" };
 function redactPatternsCatalog(api, args, options) {
@@ -114,31 +114,31 @@ function flattenAnnotationsEndpoint(api, args, options) {
 }
 var $extractTextRemote = { m: "POST", p: "/utilities/pdf/extract-text-remote", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.extract_text_remote" };
 function extractTextRemote(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $extractTextRemote, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $extractTextRemote, args, options);
 }
 var $extractTables = { m: "POST", p: "/utilities/pdf/extract-tables", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.extract_tables" };
 function extractTables(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $extractTables, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $extractTables, args, options);
 }
 var $processWithAi = { m: "POST", p: "/utilities/pdf/process-with-ai", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.process_with_ai" };
 function processWithAi(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $processWithAi, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $processWithAi, args, options);
 }
 var $fullPipeline = { m: "POST", p: "/utilities/pdf/full-pipeline", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.full_pipeline" };
 function fullPipeline(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $fullPipeline, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $fullPipeline, args, options);
 }
 var $batchExtract = { m: "POST", p: "/utilities/pdf/batch-extract", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.batch_extract" };
 function batchExtract(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $batchExtract, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $batchExtract, args, options);
 }
 var $pdfFromImages = { m: "POST", p: "/utilities/pdf/from-images", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.pdf_from_images" };
 function pdfFromImages(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $pdfFromImages, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $pdfFromImages, args, options);
 }
 var $cleanDocumentContent = { m: "POST", p: "/utilities/pdf/clean-content/{doc_id}", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.clean_document_content" };
 function cleanDocumentContent(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $cleanDocumentContent, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $cleanDocumentContent, args, options);
 }
 var $listDocuments = { m: "GET", p: "/utilities/pdf/documents", d: "aidream", a: "guest", o: "optional", n: "files.list_documents" };
 function listDocuments(api, args, options) {
@@ -406,15 +406,15 @@ function getFileLineageSummary(api, args, options) {
 }
 var $ingestFileForRag = { m: "POST", p: "/files/{file_id}/ingest", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.ingest_file_for_rag" };
 function ingestFileForRag(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $ingestFileForRag, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $ingestFileForRag, args, options);
 }
 var $ingestFileForRagStream = { m: "POST", p: "/files/{file_id}/ingest/stream", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.ingest_file_for_rag_stream" };
 function ingestFileForRagStream(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $ingestFileForRagStream, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $ingestFileForRagStream, args, options);
 }
 var $refreshFileRag = { m: "POST", p: "/files/{file_id}/refresh", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.refresh_file_rag" };
 function refreshFileRag(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $refreshFileRag, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $refreshFileRag, args, options);
 }
 var $versionsListVersions = { m: "GET", p: "/files/{file_id}/versions", d: "aidream", a: "guest", o: "required", n: "files.versions_list_versions" };
 function versionsListVersions(api, args, options) {
@@ -546,7 +546,7 @@ function fetchAnalysis(api, args, options) {
 }
 var $refreshAnalysis = { m: "POST", p: "/files/{file_id}/analysis/refresh", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.refresh_analysis" };
 function refreshAnalysis(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $refreshAnalysis, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $refreshAnalysis, args, options);
 }
 var $redactMask = { m: "POST", p: "/files/{file_id}/redact/mask", d: "aidream", a: "guest", o: "required", n: "files.redact_mask" };
 function redactMask(api, args, options) {
@@ -654,7 +654,7 @@ function listOverridesEndpoint(api, args, options) {
 }
 var $searchEndpoint = { m: "POST", p: "/files/{file_id}/search", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "files.search_endpoint" };
 function searchEndpoint(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $searchEndpoint, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $searchEndpoint, args, options);
 }
 var $extractRegionEndpoint = { m: "POST", p: "/files/{file_id}/regions/extract", d: "aidream", a: "guest", o: "required", n: "files.extract_region_endpoint" };
 function extractRegionEndpoint(api, args, options) {
@@ -882,7 +882,7 @@ function searchSemantic(api, args, options) {
 }
 var $downloadStream = { m: "GET", p: "/downloads/stream", d: "matrx-local", a: "loopback_token", o: "exempt", s: "sse", n: "files.download_stream" };
 function downloadStream(api, args, options) {
-  return chunkNMBDYPFZ_cjs.openStream(api, $downloadStream, args, options);
+  return chunkSPASYIUH_cjs.openStream(api, $downloadStream, args, options);
 }
 var $listDownloads = { m: "GET", p: "/downloads", d: "matrx-local", a: "loopback_token", o: "exempt", n: "files.list_downloads" };
 function listDownloads(api, args, options) {

package/dist/files.d.cts

@@ -1,4 +1,4 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, S as SseEvent, J as JsonOrStream } from './index-D_ZjxGwP.cjs';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, S as SseEvent, J as JsonOrStream } from './index-Gj30ybjE.cjs';
 import { JsonValue, Asset, MediaRef, UserAnalysisPreferencesResponse, StorageImportResult } from './schemas.cjs';
 import '@ai-matrx/auth/credentials';
 

package/dist/files.d.ts

@@ -1,4 +1,4 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, S as SseEvent, J as JsonOrStream } from './index-D_ZjxGwP.js';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, S as SseEvent, J as JsonOrStream } from './index-Gj30ybjE.js';
 import { JsonValue, Asset, MediaRef, UserAnalysisPreferencesResponse, StorageImportResult } from './schemas.js';
 import '@ai-matrx/auth/credentials';
 

package/dist/files.js

@@ -1,5 +1,5 @@
-import { openStream, openJsonOrStream } from './chunk-5BBHAAIG.js';
-import './chunk-KIEAFMKB.js';
+import { openStream, openJsonOrStream } from './chunk-FLANGLCG.js';
+import './chunk-PIPE5OML.js';
 
 // src/generated/files.ts
 var $compressPdf = { m: "POST", p: "/utilities/pdf/compress", d: "aidream", a: "guest", o: "required", n: "files.compress_pdf" };

package/dist/human-resources.d.cts

@@ -1,4 +1,4 @@
-import { A as Api, C as CallOptions } from './index-D_ZjxGwP.cjs';
+import { A as Api, C as CallOptions } from './index-Gj30ybjE.cjs';
 import { JsonValue } from './schemas.cjs';
 import '@ai-matrx/auth/credentials';
 

package/dist/human-resources.d.ts

@@ -1,4 +1,4 @@
-import { A as Api, C as CallOptions } from './index-D_ZjxGwP.js';
+import { A as Api, C as CallOptions } from './index-Gj30ybjE.js';
 import { JsonValue } from './schemas.js';
 import '@ai-matrx/auth/credentials';
 

package/dist/{index-D_ZjxGwP.d.cts → index-Gj30ybjE.d.cts}

@@ -1,5 +1,36 @@
 import { CredentialsSetting } from '@ai-matrx/auth/credentials';
 
+/**
+ * THE ONE WIRE — every request `@ai-matrx/api` sends leaves through
+ * {@link sendOnWire}. `createApi` (generated operations), `createMatrxTransport`
+ * (the run/stream port), `executeMatrxCall` and `sendMatrxRequest` are thin
+ * shapes over it; none of them call `fetch` on their own.
+ *
+ * What the wire owns, once:
+ *
+ * - every HTTP method and every body (`BodyInit` as-is, anything else JSON);
+ * - the session-ready wait: a credentials port that exposes `ready()` is
+ *   awaited (bounded by `readyTimeoutMs`) before the credential is read, so a
+ *   call issued while sign-in is still settling never leaves anonymously;
+ * - credentials read fresh per call and mapped by the ONE `credentialToHeaders`;
+ * - connect/total timeouts, the v2 → v1 protocol fallback, retry of
+ *   idempotent non-stream reads on transport failures;
+ * - 401 → `refreshCredentials()` → exactly one retry with the fresh credential
+ *   (the refused body is cancelled first; a second 401 is surfaced);
+ * - upload progress: `onUploadProgress` sends through `XMLHttpRequest` where
+ *   it exists (browsers) and reports monotonic `loaded/total`; elsewhere the
+ *   request goes through `fetch` and reports one final 100%.
+ *
+ * The wire never throws on an HTTP status — callers decide what a non-2xx
+ * means (typed error, expected domain outcome, stream error callback).
+ */
+
+/** Bytes sent so far on an upload. `total` is 0 when the size is unknown. */
+interface UploadProgress {
+    loaded: number;
+    total: number;
+}
+
 /**
  * Canonical AI Matrx NDJSON wire kernel.
  *
@@ -83,7 +114,7 @@ declare function createMatrxNdjsonFramer(options?: MatrxNdjsonFramerOptions): Ma
 declare function readMatrxNdjsonStream(body: ReadableStream<Uint8Array>, options?: ReadMatrxNdjsonOptions): AsyncGenerator<MatrxStreamEnvelope, void, undefined>;
 
 /**
- * `@ai-matrx/agents/stream/sse` — the Matrx SSE frame kernel.
+ * `@ai-matrx/api/stream` — the Matrx SSE frame kernel.
  *
  * Two Matrx clients hand-rolled the identical `text/event-stream` framing —
  * the same separator regex, the same field parsing, the same CRLF incident —
@@ -269,8 +300,8 @@ declare const DOMAINS: readonly ["account", "agents", "ai", "apps", "architectur
  *   `required` fails closed before the wire, `optional` sends one when bound,
  *   `exempt` never sends one;
  * - `X-Request-Id` on every call;
- * - connect/total timeouts (`net/resilient-fetch`) and retry of idempotent
- *   reads (`net/retry`);
+ * - the ONE wire (`core/wire.ts`): session-ready wait, timeouts, retry of
+ *   idempotent reads, 401 refresh-and-retry once, upload progress;
  * - one error model (`MatrxApiError`, `NetError`, `OrganizationContextError`);
  * - stream parsing (NDJSON, SSE, bytes, and the conditional `*_or_json`).
  *
@@ -331,6 +362,19 @@ interface CreateApiOptions {
     retryAttempts?: number;
     /** Mints the `X-Request-Id`. Default `crypto.randomUUID()`. */
     requestId?: () => string;
+    /**
+     * Called once when the server answers 401: refresh the credential (e.g. the
+     * host's session refresh) and resolve `true` to retry the call ONCE with the
+     * fresh credential, `false` to surface the 401. A second 401 is never
+     * retried. Omit to surface every 401 as-is.
+     */
+    refreshCredentials?: () => Promise<boolean>;
+    /**
+     * Upper bound (ms) on the session-ready wait: when the credentials port
+     * exposes `ready()`, every call waits for it first so nothing leaves
+     * before sign-in settles. Default 3 000; then the call goes anyway.
+     */
+    readyTimeoutMs?: number;
     /** Extra headers on every call (never overrides credentials or org). */
     headers?: Record<string, string>;
     /** Observability sink; the client works fully without it. */
@@ -344,6 +388,8 @@ interface CallOptions {
     headers?: Record<string, string>;
     connectTimeoutMs?: number;
     totalTimeoutMs?: number | null;
+    /** Upload progress (bytes sent). Browsers report as the body streams out; elsewhere one final 100%. */
+    onUploadProgress?: (progress: UploadProgress) => void;
 }
 /** The arguments a generated operation accepts (each operation narrows them). */
 interface OperationArgs {
@@ -387,4 +433,4 @@ declare function openStream<E>(api: Api, op: OperationDescriptor, args?: Operati
 /** Send a conditional (`*_or_json`) operation: JSON when the server answered JSON, else the stream. */
 declare function openJsonOrStream<J, E>(api: Api, op: OperationDescriptor, args?: OperationArgs, options?: CallOptions): Promise<JsonOrStream<J, E>>;
 
-export { type Api as A, readMatrxSseStream as B, type CallOptions as C, DEPLOYMENTS as D, type Environment as E, type HttpMethod as H, type JsonOrStream as J, type MatrxStreamEnvelope as M, type NdjsonEvent as N, type OperationArgs as O, type ReadMatrxNdjsonOptions as R, type SseEvent as S, type ApiStream as a, type MatrxNdjsonIssue as b, type MatrxStreamEnvelopeObservation as c, type MatrxSseFrame as d, type ApiRequestInfo as e, type AuthTier as f, CONTRACT_SHA256 as g, type CreateApiOptions as h, DOMAINS as i, type DeploymentName as j, type OperationDescriptor as k, type OrgRule as l, type StreamKind as m, createApi as n, openJsonOrStream as o, openStream as p, DEFAULT_MATRX_NDJSON_READ_AHEAD as q, type MatrxNdjsonFramer as r, type MatrxNdjsonFramerOptions as s, type MatrxSseFramer as t, type ReadMatrxSseOptions as u, createMatrxNdjsonFramer as v, createMatrxSseFramer as w, normalizeMatrxStreamEnvelope as x, parseMatrxSseFrame as y, readMatrxNdjsonStream as z };
+export { type Api as A, readMatrxSseStream as B, type CallOptions as C, DEPLOYMENTS as D, type Environment as E, type HttpMethod as H, type JsonOrStream as J, type MatrxStreamEnvelope as M, type NdjsonEvent as N, type OperationArgs as O, type ReadMatrxNdjsonOptions as R, type SseEvent as S, type UploadProgress as U, type ApiStream as a, type MatrxNdjsonIssue as b, type MatrxStreamEnvelopeObservation as c, type MatrxSseFrame as d, type ApiRequestInfo as e, type AuthTier as f, CONTRACT_SHA256 as g, type CreateApiOptions as h, DOMAINS as i, type DeploymentName as j, type OperationDescriptor as k, type OrgRule as l, type StreamKind as m, createApi as n, openJsonOrStream as o, openStream as p, DEFAULT_MATRX_NDJSON_READ_AHEAD as q, type MatrxNdjsonFramer as r, type MatrxNdjsonFramerOptions as s, type MatrxSseFramer as t, type ReadMatrxSseOptions as u, createMatrxNdjsonFramer as v, createMatrxSseFramer as w, normalizeMatrxStreamEnvelope as x, parseMatrxSseFrame as y, readMatrxNdjsonStream as z };

package/dist/{index-D_ZjxGwP.d.ts → index-Gj30ybjE.d.ts}

@@ -1,5 +1,36 @@
 import { CredentialsSetting } from '@ai-matrx/auth/credentials';
 
+/**
+ * THE ONE WIRE — every request `@ai-matrx/api` sends leaves through
+ * {@link sendOnWire}. `createApi` (generated operations), `createMatrxTransport`
+ * (the run/stream port), `executeMatrxCall` and `sendMatrxRequest` are thin
+ * shapes over it; none of them call `fetch` on their own.
+ *
+ * What the wire owns, once:
+ *
+ * - every HTTP method and every body (`BodyInit` as-is, anything else JSON);
+ * - the session-ready wait: a credentials port that exposes `ready()` is
+ *   awaited (bounded by `readyTimeoutMs`) before the credential is read, so a
+ *   call issued while sign-in is still settling never leaves anonymously;
+ * - credentials read fresh per call and mapped by the ONE `credentialToHeaders`;
+ * - connect/total timeouts, the v2 → v1 protocol fallback, retry of
+ *   idempotent non-stream reads on transport failures;
+ * - 401 → `refreshCredentials()` → exactly one retry with the fresh credential
+ *   (the refused body is cancelled first; a second 401 is surfaced);
+ * - upload progress: `onUploadProgress` sends through `XMLHttpRequest` where
+ *   it exists (browsers) and reports monotonic `loaded/total`; elsewhere the
+ *   request goes through `fetch` and reports one final 100%.
+ *
+ * The wire never throws on an HTTP status — callers decide what a non-2xx
+ * means (typed error, expected domain outcome, stream error callback).
+ */
+
+/** Bytes sent so far on an upload. `total` is 0 when the size is unknown. */
+interface UploadProgress {
+    loaded: number;
+    total: number;
+}
+
 /**
  * Canonical AI Matrx NDJSON wire kernel.
  *
@@ -83,7 +114,7 @@ declare function createMatrxNdjsonFramer(options?: MatrxNdjsonFramerOptions): Ma
 declare function readMatrxNdjsonStream(body: ReadableStream<Uint8Array>, options?: ReadMatrxNdjsonOptions): AsyncGenerator<MatrxStreamEnvelope, void, undefined>;
 
 /**
- * `@ai-matrx/agents/stream/sse` — the Matrx SSE frame kernel.
+ * `@ai-matrx/api/stream` — the Matrx SSE frame kernel.
  *
  * Two Matrx clients hand-rolled the identical `text/event-stream` framing —
  * the same separator regex, the same field parsing, the same CRLF incident —
@@ -269,8 +300,8 @@ declare const DOMAINS: readonly ["account", "agents", "ai", "apps", "architectur
  *   `required` fails closed before the wire, `optional` sends one when bound,
  *   `exempt` never sends one;
  * - `X-Request-Id` on every call;
- * - connect/total timeouts (`net/resilient-fetch`) and retry of idempotent
- *   reads (`net/retry`);
+ * - the ONE wire (`core/wire.ts`): session-ready wait, timeouts, retry of
+ *   idempotent reads, 401 refresh-and-retry once, upload progress;
  * - one error model (`MatrxApiError`, `NetError`, `OrganizationContextError`);
  * - stream parsing (NDJSON, SSE, bytes, and the conditional `*_or_json`).
  *
@@ -331,6 +362,19 @@ interface CreateApiOptions {
     retryAttempts?: number;
     /** Mints the `X-Request-Id`. Default `crypto.randomUUID()`. */
     requestId?: () => string;
+    /**
+     * Called once when the server answers 401: refresh the credential (e.g. the
+     * host's session refresh) and resolve `true` to retry the call ONCE with the
+     * fresh credential, `false` to surface the 401. A second 401 is never
+     * retried. Omit to surface every 401 as-is.
+     */
+    refreshCredentials?: () => Promise<boolean>;
+    /**
+     * Upper bound (ms) on the session-ready wait: when the credentials port
+     * exposes `ready()`, every call waits for it first so nothing leaves
+     * before sign-in settles. Default 3 000; then the call goes anyway.
+     */
+    readyTimeoutMs?: number;
     /** Extra headers on every call (never overrides credentials or org). */
     headers?: Record<string, string>;
     /** Observability sink; the client works fully without it. */
@@ -344,6 +388,8 @@ interface CallOptions {
     headers?: Record<string, string>;
     connectTimeoutMs?: number;
     totalTimeoutMs?: number | null;
+    /** Upload progress (bytes sent). Browsers report as the body streams out; elsewhere one final 100%. */
+    onUploadProgress?: (progress: UploadProgress) => void;
 }
 /** The arguments a generated operation accepts (each operation narrows them). */
 interface OperationArgs {
@@ -387,4 +433,4 @@ declare function openStream<E>(api: Api, op: OperationDescriptor, args?: Operati
 /** Send a conditional (`*_or_json`) operation: JSON when the server answered JSON, else the stream. */
 declare function openJsonOrStream<J, E>(api: Api, op: OperationDescriptor, args?: OperationArgs, options?: CallOptions): Promise<JsonOrStream<J, E>>;
 
-export { type Api as A, readMatrxSseStream as B, type CallOptions as C, DEPLOYMENTS as D, type Environment as E, type HttpMethod as H, type JsonOrStream as J, type MatrxStreamEnvelope as M, type NdjsonEvent as N, type OperationArgs as O, type ReadMatrxNdjsonOptions as R, type SseEvent as S, type ApiStream as a, type MatrxNdjsonIssue as b, type MatrxStreamEnvelopeObservation as c, type MatrxSseFrame as d, type ApiRequestInfo as e, type AuthTier as f, CONTRACT_SHA256 as g, type CreateApiOptions as h, DOMAINS as i, type DeploymentName as j, type OperationDescriptor as k, type OrgRule as l, type StreamKind as m, createApi as n, openJsonOrStream as o, openStream as p, DEFAULT_MATRX_NDJSON_READ_AHEAD as q, type MatrxNdjsonFramer as r, type MatrxNdjsonFramerOptions as s, type MatrxSseFramer as t, type ReadMatrxSseOptions as u, createMatrxNdjsonFramer as v, createMatrxSseFramer as w, normalizeMatrxStreamEnvelope as x, parseMatrxSseFrame as y, readMatrxNdjsonStream as z };
+export { type Api as A, readMatrxSseStream as B, type CallOptions as C, DEPLOYMENTS as D, type Environment as E, type HttpMethod as H, type JsonOrStream as J, type MatrxStreamEnvelope as M, type NdjsonEvent as N, type OperationArgs as O, type ReadMatrxNdjsonOptions as R, type SseEvent as S, type UploadProgress as U, type ApiStream as a, type MatrxNdjsonIssue as b, type MatrxStreamEnvelopeObservation as c, type MatrxSseFrame as d, type ApiRequestInfo as e, type AuthTier as f, CONTRACT_SHA256 as g, type CreateApiOptions as h, DOMAINS as i, type DeploymentName as j, type OperationDescriptor as k, type OrgRule as l, type StreamKind as m, createApi as n, openJsonOrStream as o, openStream as p, DEFAULT_MATRX_NDJSON_READ_AHEAD as q, type MatrxNdjsonFramer as r, type MatrxNdjsonFramerOptions as s, type MatrxSseFramer as t, type ReadMatrxSseOptions as u, createMatrxNdjsonFramer as v, createMatrxSseFramer as w, normalizeMatrxStreamEnvelope as x, parseMatrxSseFrame as y, readMatrxNdjsonStream as z };