@ai-matrx/api 0.1.7 → 0.1.9

package/dist/{index-Xx6L_pWk.d.cts → index-C3ZlP3BI.d.cts}

@@ -16,6 +16,11 @@ interface MatrxStreamEnvelope<TData = unknown> {
     data: TData;
     /** Monotonic transport sequence from full envelopes, when supplied. */
     stream_seq?: number;
+    /**
+     * The request's latency id, on the ONE frame the server wrote first after the AI
+     * provider responded. The client stamps its receipt (LEG 3 of the run's latency).
+     */
+    latency_mark?: string;
 }
 interface MatrxNdjsonIssue {
     line: string;
@@ -78,7 +83,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 —
@@ -326,6 +331,13 @@ 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>;
     /** Extra headers on every call (never overrides credentials or org). */
     headers?: Record<string, string>;
     /** Observability sink; the client works fully without it. */

package/dist/{index-Xx6L_pWk.d.ts → index-C3ZlP3BI.d.ts}

@@ -16,6 +16,11 @@ interface MatrxStreamEnvelope<TData = unknown> {
     data: TData;
     /** Monotonic transport sequence from full envelopes, when supplied. */
     stream_seq?: number;
+    /**
+     * The request's latency id, on the ONE frame the server wrote first after the AI
+     * provider responded. The client stamps its receipt (LEG 3 of the run's latency).
+     */
+    latency_mark?: string;
 }
 interface MatrxNdjsonIssue {
     line: string;
@@ -78,7 +83,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 —
@@ -326,6 +331,13 @@ 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>;
     /** Extra headers on every call (never overrides credentials or org). */
     headers?: Record<string, string>;
     /** Observability sink; the client works fully without it. */