@ai-matrx/api 0.1.20 → 0.1.21

package/dist/index.d.cts

@@ -1,115 +1,9 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-YFW4xNti.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-YFW4xNti.cjs';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-BXLIDtlM.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-BXLIDtlM.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, ResilientFetchResult } from './net.cjs';
-export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.cjs';
-import { g as MandateKey, b as DynamicMandateKey } from './keys.generated-DPvmbTFD.cjs';
-
-/**
- * The AI API protocol-version policy — which version of the AI runtime a
- * Matrx client talks to, and the v2 → v1 transport fallback (moved in from
- * matrx-frontend `lib/api/ai-api-version.ts` + `call-api.ts::
- * fetchWithV2Fallback` under C22; server truth
- * `aidream/docs/runtime/V2_FRONTEND_MIGRATION.md`).
- *
- * Background: the Python backend exposes a `/v2` runtime-spine namespace that
- * wraps the core AI request surfaces in a request-tracking envelope. Body,
- * headers, and streaming response are BYTE-IDENTICAL to v1 — only the URL
- * differs.
- *
- * ─── The one rule that keeps burning us ─────────────────────────────────────
- * `/v2` is inserted at the FRONT of the in-app path, right before `/ai`:
- *
- *     /ai/agents/{id}  → /v2/ai/agents/{id}   ✅ correct
- *     /ai/v2/agents/…                          ❌ WRONG (nested) — 404s
- *
- * `toV2Path` below is the ONLY place this transform is spelled out.
- *
- * ─── Scope: ONLY the covered surfaces have a v2 form ────────────────────────
- * chat, manual, agents/{id}, conversations/{id} (+ singular aliases),
- * prompts/{id}, mandates/{key}. EVERYTHING ELSE — cancel, warm, resume,
- * fork-and-run, runtime operations, files … — has NO v2 route, and the server
- * does NOT auto-downgrade (a `/v2` request to an uncovered surface is a plain
- * 404). So the transform is a scoped allowlist, never a blanket prefix.
- */
-
-type MatrxAiApiVersion = "v1" | "v2";
-/**
- * The package-wide default AI API version — the production value every Matrx
- * client runs unless its host deliberately overrides
- * (`createMatrxTransport({ aiApiVersion })`).
- */
-declare const MATRX_AI_API_VERSION_DEFAULT: MatrxAiApiVersion;
-/**
- * The canonical v1 path TEMPLATES the v2 spine covers, `{param}` placeholders
- * intact — for hosts that route through a template registry.
- */
-declare const V2_COVERED_AI_PATH_TEMPLATES: readonly ["/ai/manual", "/ai/chat", "/ai/agents/{agent_id}", "/ai/agent/{agent_id}", "/ai/conversations/{conversation_id}", "/ai/conversation/{conversation_id}", "/ai/prompts/{prompt_id}", "/ai/mandates/{mandate_key}"];
-/**
- * Insert `/v2` at the front of an in-app path. Idempotent, and prefix-aware:
- * a legacy `/api/` compatibility prefix (stripped server-side) is preserved so
- * `/api/ai/chat` → `/api/v2/ai/chat`.
- */
-declare function toV2Path(path: string): string;
-/** Whether `path` (already interpolated) is one of the covered surfaces. */
-declare function isCoveredAiPath(path: string): boolean;
-/**
- * Whether an in-app path (or a full URL whose path was built by `toV2Path`)
- * targets the v2 namespace — the guard the downgrade fallback keys off.
- */
-declare function isV2Path(pathOrUrl: string): boolean;
-/**
- * The inverse of `toV2Path` — strip the `/v2` version segment so a transport
- * failure of the v2 endpoint (network error, 404/405, 5xx BEFORE any stream
- * content) can retry the identical request on the v1 route. Works on a bare
- * path, an `/api`-prefixed path, or a full URL (the `/v2/ai/` shape is unique
- * to the version namespace). Idempotent on non-v2 input.
- */
-declare function toV1FallbackUrl(url: string): string;
-/**
- * Apply the active AI API version to an ALREADY-INTERPOLATED in-app path.
- *
- * - Covered surface + v2  → `/v2` prefix inserted.
- * - Anything else (or v1) → returned unchanged.
- *
- * Pass the in-app PATH only (no scheme/host); prepend the base URL afterward.
- */
-declare function applyAiApiVersion(path: string, version: MatrxAiApiVersion): string;
-/** One v2 → v1 downgrade, surfaced to the host's diagnostics sink. */
-interface MatrxProtocolDowngrade {
-    /** The failed v2 URL. */
-    url: string;
-    /** Why the downgrade fired (thrown error text, or `HTTP <status>`). */
-    reason: string;
-    /** HTTP status when the trigger was a response (404/405/5xx). */
-    status?: number;
-}
-interface MatrxProtocolFallbackOptions extends ResilientFetchOptions {
-    /**
-     * Fired on every downgrade — a sustained stream of these means a v2 surface
-     * is unhealthy. The fallback also `console.warn`s unconditionally (parity
-     * with the original host pipeline) so the signal never disappears silently.
-     */
-    onDowngrade?: (downgrade: MatrxProtocolDowngrade) => void;
-}
-/**
- * `resilientFetch` with the v2 → v1 transport fallback. Fires ONLY when a
- * `/v2/ai/...` ENDPOINT itself fails — a network-layer throw (non-abort), a
- * 404/405 (surface not on v2), or a 5xx — always BEFORE any stream content is
- * consumed. Never on an application error (those fail identically on v1), and
- * never on a caller abort (a user cancel must not be logged as a downgrade —
- * that poisons the exact telemetry the rollout reads to judge v2 health).
- */
-declare function fetchWithMatrxProtocolFallback(url: string, init: RequestInit, opts?: MatrxProtocolFallbackOptions): Promise<ResilientFetchResult>;
-/**
- * The exact-match `pathOverrides` map for `resolveEndpointPath` — keyed on the
- * canonical templates, valued at their `/v2` siblings. Empty for v1. Every call
- * that flows through the endpoint-override registry picks up v2 for the covered
- * surfaces — and ONLY the covered surfaces. (Moved from matrx-frontend
- * `lib/api/ai-api-version.ts`, chat-package independence P9.)
- */
-declare function aiVersionPathOverrides(version: MatrxAiApiVersion): Record<string, string>;
+export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, ResilientFetchOptions, ResilientFetchResult, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.cjs';
+import { g as MandateKey, b as DynamicMandateKey } from './keys.generated-DE-t9kzx.cjs';
 
 /**
  * `@ai-matrx/api` — the Matrx transport port.
@@ -433,8 +327,6 @@ declare function getUserMessage(error: unknown): string;
  *   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/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
  *   call, so a token refresh mid-run is picked up; mapped to headers by the
  *   ONE `credentialToHeaders`;
@@ -445,7 +337,7 @@ declare function getUserMessage(error: unknown): string;
  * - **error classification** — every failure normalizes through
  *   `normalizeMatrxError` into the ONE `MatrxCallError` envelope;
  * - **diagnostics** — a typed sink the host wires to its capture/telemetry
- *   (`onRequest`, `onError`, `onProtocolDowngrade`); wiring it is optional,
+ *   (`onRequest`, `onError`); wiring it is optional,
  *   the transport works silently without it.
  *
  * Header merge order is part of the port contract: wire headers first
@@ -530,8 +422,6 @@ interface MatrxTransportDiagnostics {
      * listed in `expectedErrorStatuses`, with the classified envelope.
      */
     onError?: (error: MatrxCallError, info: MatrxRequestInfo) => void;
-    /** Fired on every v2 → v1 protocol downgrade. */
-    onProtocolDowngrade?: (downgrade: MatrxProtocolDowngrade) => void;
 }
 interface CreateMatrxTransportOptions {
     /** Fixed base URL, no trailing slash. Exactly one of `baseUrl` / `resolveTarget`. */
@@ -559,8 +449,6 @@ interface CreateMatrxTransportOptions {
      * org in the body only.
      */
     organizationId?: string | (() => string | null | undefined);
-    /** AI API protocol version (value or per-call getter). Default `"v2"`. */
-    aiApiVersion?: MatrxAiApiVersion | (() => MatrxAiApiVersion);
     /** Max ms request start → response headers. Default 15_000. */
     connectTimeoutMs?: number;
     /**
@@ -741,14 +629,11 @@ interface ExecuteMatrxCallRequest<E = MatrxStreamEnvelope> {
     onStreamError?: (error: MatrxCallError) => void;
 }
 interface ExecuteMatrxCallHooks<E = MatrxStreamEnvelope> {
-    /** Every v2 → v1 protocol downgrade. */
-    onProtocolDowngrade?: (downgrade: MatrxProtocolDowngrade) => void;
     /** The host's stream parser (default `parseMatrxNdjsonResponse`). */
     parseStream?: (response: Response, signal?: AbortSignal) => MatrxStreamParse<E>;
 }
 /**
- * Execute one call over the v2 → v1 protocol fallback. An HTTP error
- * response resolves as `{ error }`; a thrown failure (network, timeout,
+ * Execute one call. An HTTP error response resolves as `{ error }`; a thrown failure (network, timeout,
  * abort, a broken stream) propagates — the caller normalizes it with
  * `normalizeMatrxError` and decides what to capture.
  */
@@ -2795,4 +2680,4 @@ declare const ENDPOINTS: {
     };
 };
 
-export { BackendApiError, type BackendApiErrorData, type BackendErrorCode, type BackendFailureExplanation, type CreateMatrxTransportOptions, type CreateWarmupOptions, ENDPOINTS, type EndpointOverrideConfig, type ExecuteMatrxCallHooks, type ExecuteMatrxCallRequest, type FollowRuntimeOperationOptions, type FollowRuntimeOperationToEndOptions, type FollowRuntimeOperationToEndResult, type FollowServerJobOptions, type FollowUnavailableRejoinOptions, type JsonRequestOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, MATRX_UI_ONLY_BODY_FIELDS, type MatrxAgentStartRequest, type MatrxAiApiVersion, MatrxApiError, type MatrxCallError, type MatrxCallResult, type MatrxCallScope, type MatrxCancelResponse, type MatrxChatMessage, type MatrxClientSessionProvider, type MatrxClientToolResult, type MatrxCompletedRun, type MatrxContextAnchor, type MatrxConversationContinueRequest, type MatrxConversationResumeRequest, type MatrxConversationStart, type MatrxEphemeralConversation, type MatrxFollowedOutcome, type MatrxHttpErrorLike, type MatrxHttpMethod, type MatrxJsonObject, type MatrxJsonValue, type MatrxLiveRunRejoin, type MatrxLiveStreamUnavailable, type MatrxMandateStartRequest, type MatrxOperationEventsPage, type MatrxOperationFollowEvent, type MatrxOperationStatusResponse, type MatrxOperationsByLinkResponse, type MatrxPendingCallSummary, type MatrxProtocolDowngrade, type MatrxProtocolFallbackOptions, type MatrxQueryParams, type MatrxRequestInfo, type MatrxRequestScope, MatrxRunError, type MatrxRunHandle, type MatrxRunPickup, type MatrxRunPickupSettlement, type MatrxRuntimeExecutionStatus, type MatrxRuntimeOperationEvent, type MatrxRuntimeOperationView, type MatrxStoredConversationContinue, type MatrxStoredConversationCreate, type MatrxStreamCallOptions, type MatrxStreamCursorStamp, type MatrxStreamIds, type MatrxStreamParse, type MatrxToolResultsResponse, type MatrxTransport, type MatrxTransportDiagnostics, type MatrxTransportRequest, type MatrxTransportTarget, type MatrxTurnFields, OrganizationContextError, type OrganizationContextErrorCode, type OrganizationOperation, type ParseMatrxNdjsonResponseHooks, type ProviderSessionFailure, type ProviderSessionFailureVerdict, type ProviderSessionUsage, type ProviderSessionUsageReceipt, type ProviderUsageReporter, type ProviderUsageReporterOptions, type ProviderUsageSendResult, type QueryValue, RUN_OUTPUT_KINDS, RUN_STREAM_LIFETIME_BACKSTOP_MS, RUN_WAIT_KNOB_FEATURE, ResilientFetchOptions, ResilientFetchResult, type ResumeOrRejoinOptions, type ResumeOrRejoinOutcome, type RunAgentToCompletionOptions, type RunOutputKind, type RunWait, type RunWaitKnobReader, type SendMatrxRequestOptions, type ServerJobFinalStatus, type ServerJobOutcome, type ServerJobPath, type ServerJobStatus, type ServerJobTarget, type SettleRunPickupOptions, type StreamReplayCursor, type StreamReplayCursorOptions, type StreamRequestOptions, StreamTransportError, TERMINAL_MATRX_RUNTIME_STATUSES, type UpstreamErrorPayload, V2_COVERED_AI_PATH_TEMPLATES, WARM_PATH, type WarmItem, type WarmReason, type Warmup, aiVersionPathOverrides, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, bareStatusSentence, buildMatrxRequestBody, buildMatrxRequestUrl, buildQuery, buildSafeRequestLog, cancelAgentRun, continueAgentConversation, continueEphemeralConversationStart, continueStoredConversationStart, createMatrxTransport, createOrganizationOperation, createProviderUsageReporter, createStreamReplayCursor, createWarmup, describeBackendFailure, encodePathSegment, executeMatrxCall, extractMatrxErrorCode, extractMatrxErrorMessage, fetchWithMatrxProtocolFallback, followRuntimeOperationEvents, followRuntimeOperationToEnd, followServerJob, followUnavailableRejoin, followWorkflowRunEvents, getRuntimeOperationStatus, getRuntimeOperationsByLink, getUserMessage, honestTransportMessage, isBareTransportCode, isCoveredAiPath, isEmptyProviderUsage, isGenericUserMessage, isJobOutputKind, isLiveStreamUnavailable, isResumeConflict, isServerJobSettled, isStreamTransportLost, isV2Path, listConversationPendingToolCalls, listRuntimeOperationEvents, listUserPendingToolCalls, mintMatrxConversationId, newEphemeralConversationStart, newStoredConversationStart, normalizeMatrxError, openMatrxStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxNdjsonResponse, parsePersistedBackendError, parseStreamError, pickServerJobOperation, preconnectServer, providerSessionFailureBody, providerSessionUsageBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, readMatrxJsonResponse, readStreamCursor, redactUrlForRequestLog, rejoinRuntimeOperation, reportProviderSessionFailure, reportProviderSessionUsage, requestJson, requestStream, requireOrganizationContext, resetPreconnectedForTests, resolveEndpointPath, resolveRunWaitWith, resumeAgentConversation, resumeOrRejoin, runAgentToCompletion, runJobLabel, runOutputKindFromModalities, runWaitKnobKey, runWaitTimeoutMessage, runtimeOperationRejoinPath, sendMatrxRequest, serverJobRejoinHandle, settleRunPickup, shouldReportMatrxCallError, startAgentRun, startMandateRun, streamErrorText, submitAgentToolResults, toRunHandle, toV1FallbackUrl, toV2Path, unwrapUpstreamError, withRunOrganization };
+export { BackendApiError, type BackendApiErrorData, type BackendErrorCode, type BackendFailureExplanation, type CreateMatrxTransportOptions, type CreateWarmupOptions, ENDPOINTS, type EndpointOverrideConfig, type ExecuteMatrxCallHooks, type ExecuteMatrxCallRequest, type FollowRuntimeOperationOptions, type FollowRuntimeOperationToEndOptions, type FollowRuntimeOperationToEndResult, type FollowServerJobOptions, type FollowUnavailableRejoinOptions, type JsonRequestOptions, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, MATRX_UI_ONLY_BODY_FIELDS, type MatrxAgentStartRequest, MatrxApiError, type MatrxCallError, type MatrxCallResult, type MatrxCallScope, type MatrxCancelResponse, type MatrxChatMessage, type MatrxClientSessionProvider, type MatrxClientToolResult, type MatrxCompletedRun, type MatrxContextAnchor, type MatrxConversationContinueRequest, type MatrxConversationResumeRequest, type MatrxConversationStart, type MatrxEphemeralConversation, type MatrxFollowedOutcome, type MatrxHttpErrorLike, type MatrxHttpMethod, type MatrxJsonObject, type MatrxJsonValue, type MatrxLiveRunRejoin, type MatrxLiveStreamUnavailable, type MatrxMandateStartRequest, type MatrxOperationEventsPage, type MatrxOperationFollowEvent, type MatrxOperationStatusResponse, type MatrxOperationsByLinkResponse, type MatrxPendingCallSummary, type MatrxQueryParams, type MatrxRequestInfo, type MatrxRequestScope, MatrxRunError, type MatrxRunHandle, type MatrxRunPickup, type MatrxRunPickupSettlement, type MatrxRuntimeExecutionStatus, type MatrxRuntimeOperationEvent, type MatrxRuntimeOperationView, type MatrxStoredConversationContinue, type MatrxStoredConversationCreate, type MatrxStreamCallOptions, type MatrxStreamCursorStamp, type MatrxStreamIds, type MatrxStreamParse, type MatrxToolResultsResponse, type MatrxTransport, type MatrxTransportDiagnostics, type MatrxTransportRequest, type MatrxTransportTarget, type MatrxTurnFields, OrganizationContextError, type OrganizationContextErrorCode, type OrganizationOperation, type ParseMatrxNdjsonResponseHooks, type ProviderSessionFailure, type ProviderSessionFailureVerdict, type ProviderSessionUsage, type ProviderSessionUsageReceipt, type ProviderUsageReporter, type ProviderUsageReporterOptions, type ProviderUsageSendResult, type QueryValue, RUN_OUTPUT_KINDS, RUN_STREAM_LIFETIME_BACKSTOP_MS, RUN_WAIT_KNOB_FEATURE, type ResumeOrRejoinOptions, type ResumeOrRejoinOutcome, type RunAgentToCompletionOptions, type RunOutputKind, type RunWait, type RunWaitKnobReader, type SendMatrxRequestOptions, type ServerJobFinalStatus, type ServerJobOutcome, type ServerJobPath, type ServerJobStatus, type ServerJobTarget, type SettleRunPickupOptions, type StreamReplayCursor, type StreamReplayCursorOptions, type StreamRequestOptions, StreamTransportError, TERMINAL_MATRX_RUNTIME_STATUSES, type UpstreamErrorPayload, WARM_PATH, type WarmItem, type WarmReason, type Warmup, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, bareStatusSentence, buildMatrxRequestBody, buildMatrxRequestUrl, buildQuery, buildSafeRequestLog, cancelAgentRun, continueAgentConversation, continueEphemeralConversationStart, continueStoredConversationStart, createMatrxTransport, createOrganizationOperation, createProviderUsageReporter, createStreamReplayCursor, createWarmup, describeBackendFailure, encodePathSegment, executeMatrxCall, extractMatrxErrorCode, extractMatrxErrorMessage, followRuntimeOperationEvents, followRuntimeOperationToEnd, followServerJob, followUnavailableRejoin, followWorkflowRunEvents, getRuntimeOperationStatus, getRuntimeOperationsByLink, getUserMessage, honestTransportMessage, isBareTransportCode, isEmptyProviderUsage, isGenericUserMessage, isJobOutputKind, isLiveStreamUnavailable, isResumeConflict, isServerJobSettled, isStreamTransportLost, listConversationPendingToolCalls, listRuntimeOperationEvents, listUserPendingToolCalls, mintMatrxConversationId, newEphemeralConversationStart, newStoredConversationStart, normalizeMatrxError, openMatrxStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxNdjsonResponse, parsePersistedBackendError, parseStreamError, pickServerJobOperation, preconnectServer, providerSessionFailureBody, providerSessionUsageBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, readMatrxJsonResponse, readStreamCursor, redactUrlForRequestLog, rejoinRuntimeOperation, reportProviderSessionFailure, reportProviderSessionUsage, requestJson, requestStream, requireOrganizationContext, resetPreconnectedForTests, resolveEndpointPath, resolveRunWaitWith, resumeAgentConversation, resumeOrRejoin, runAgentToCompletion, runJobLabel, runOutputKindFromModalities, runWaitKnobKey, runWaitTimeoutMessage, runtimeOperationRejoinPath, sendMatrxRequest, serverJobRejoinHandle, settleRunPickup, shouldReportMatrxCallError, startAgentRun, startMandateRun, streamErrorText, submitAgentToolResults, toRunHandle, unwrapUpstreamError, withRunOrganization };

package/dist/index.d.ts

@@ -1,115 +1,9 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-YFW4xNti.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-YFW4xNti.js';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-BXLIDtlM.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-BXLIDtlM.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, ResilientFetchResult } from './net.js';
-export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.js';
-import { g as MandateKey, b as DynamicMandateKey } from './keys.generated-DPvmbTFD.js';
-
-/**
- * The AI API protocol-version policy — which version of the AI runtime a
- * Matrx client talks to, and the v2 → v1 transport fallback (moved in from
- * matrx-frontend `lib/api/ai-api-version.ts` + `call-api.ts::
- * fetchWithV2Fallback` under C22; server truth
- * `aidream/docs/runtime/V2_FRONTEND_MIGRATION.md`).
- *
- * Background: the Python backend exposes a `/v2` runtime-spine namespace that
- * wraps the core AI request surfaces in a request-tracking envelope. Body,
- * headers, and streaming response are BYTE-IDENTICAL to v1 — only the URL
- * differs.
- *
- * ─── The one rule that keeps burning us ─────────────────────────────────────
- * `/v2` is inserted at the FRONT of the in-app path, right before `/ai`:
- *
- *     /ai/agents/{id}  → /v2/ai/agents/{id}   ✅ correct
- *     /ai/v2/agents/…                          ❌ WRONG (nested) — 404s
- *
- * `toV2Path` below is the ONLY place this transform is spelled out.
- *
- * ─── Scope: ONLY the covered surfaces have a v2 form ────────────────────────
- * chat, manual, agents/{id}, conversations/{id} (+ singular aliases),
- * prompts/{id}, mandates/{key}. EVERYTHING ELSE — cancel, warm, resume,
- * fork-and-run, runtime operations, files … — has NO v2 route, and the server
- * does NOT auto-downgrade (a `/v2` request to an uncovered surface is a plain
- * 404). So the transform is a scoped allowlist, never a blanket prefix.
- */
-
-type MatrxAiApiVersion = "v1" | "v2";
-/**
- * The package-wide default AI API version — the production value every Matrx
- * client runs unless its host deliberately overrides
- * (`createMatrxTransport({ aiApiVersion })`).
- */
-declare const MATRX_AI_API_VERSION_DEFAULT: MatrxAiApiVersion;
-/**
- * The canonical v1 path TEMPLATES the v2 spine covers, `{param}` placeholders
- * intact — for hosts that route through a template registry.
- */
-declare const V2_COVERED_AI_PATH_TEMPLATES: readonly ["/ai/manual", "/ai/chat", "/ai/agents/{agent_id}", "/ai/agent/{agent_id}", "/ai/conversations/{conversation_id}", "/ai/conversation/{conversation_id}", "/ai/prompts/{prompt_id}", "/ai/mandates/{mandate_key}"];
-/**
- * Insert `/v2` at the front of an in-app path. Idempotent, and prefix-aware:
- * a legacy `/api/` compatibility prefix (stripped server-side) is preserved so
- * `/api/ai/chat` → `/api/v2/ai/chat`.
- */
-declare function toV2Path(path: string): string;
-/** Whether `path` (already interpolated) is one of the covered surfaces. */
-declare function isCoveredAiPath(path: string): boolean;
-/**
- * Whether an in-app path (or a full URL whose path was built by `toV2Path`)
- * targets the v2 namespace — the guard the downgrade fallback keys off.
- */
-declare function isV2Path(pathOrUrl: string): boolean;
-/**
- * The inverse of `toV2Path` — strip the `/v2` version segment so a transport
- * failure of the v2 endpoint (network error, 404/405, 5xx BEFORE any stream
- * content) can retry the identical request on the v1 route. Works on a bare
- * path, an `/api`-prefixed path, or a full URL (the `/v2/ai/` shape is unique
- * to the version namespace). Idempotent on non-v2 input.
- */
-declare function toV1FallbackUrl(url: string): string;
-/**
- * Apply the active AI API version to an ALREADY-INTERPOLATED in-app path.
- *
- * - Covered surface + v2  → `/v2` prefix inserted.
- * - Anything else (or v1) → returned unchanged.
- *
- * Pass the in-app PATH only (no scheme/host); prepend the base URL afterward.
- */
-declare function applyAiApiVersion(path: string, version: MatrxAiApiVersion): string;
-/** One v2 → v1 downgrade, surfaced to the host's diagnostics sink. */
-interface MatrxProtocolDowngrade {
-    /** The failed v2 URL. */
-    url: string;
-    /** Why the downgrade fired (thrown error text, or `HTTP <status>`). */
-    reason: string;
-    /** HTTP status when the trigger was a response (404/405/5xx). */
-    status?: number;
-}
-interface MatrxProtocolFallbackOptions extends ResilientFetchOptions {
-    /**
-     * Fired on every downgrade — a sustained stream of these means a v2 surface
-     * is unhealthy. The fallback also `console.warn`s unconditionally (parity
-     * with the original host pipeline) so the signal never disappears silently.
-     */
-    onDowngrade?: (downgrade: MatrxProtocolDowngrade) => void;
-}
-/**
- * `resilientFetch` with the v2 → v1 transport fallback. Fires ONLY when a
- * `/v2/ai/...` ENDPOINT itself fails — a network-layer throw (non-abort), a
- * 404/405 (surface not on v2), or a 5xx — always BEFORE any stream content is
- * consumed. Never on an application error (those fail identically on v1), and
- * never on a caller abort (a user cancel must not be logged as a downgrade —
- * that poisons the exact telemetry the rollout reads to judge v2 health).
- */
-declare function fetchWithMatrxProtocolFallback(url: string, init: RequestInit, opts?: MatrxProtocolFallbackOptions): Promise<ResilientFetchResult>;
-/**
- * The exact-match `pathOverrides` map for `resolveEndpointPath` — keyed on the
- * canonical templates, valued at their `/v2` siblings. Empty for v1. Every call
- * that flows through the endpoint-override registry picks up v2 for the covered
- * surfaces — and ONLY the covered surfaces. (Moved from matrx-frontend
- * `lib/api/ai-api-version.ts`, chat-package independence P9.)
- */
-declare function aiVersionPathOverrides(version: MatrxAiApiVersion): Record<string, string>;
+export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, ResilientFetchOptions, ResilientFetchResult, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.js';
+import { g as MandateKey, b as DynamicMandateKey } from './keys.generated-DE-t9kzx.js';
 
 /**
  * `@ai-matrx/api` — the Matrx transport port.
@@ -433,8 +327,6 @@ declare function getUserMessage(error: unknown): string;
  *   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/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
  *   call, so a token refresh mid-run is picked up; mapped to headers by the
  *   ONE `credentialToHeaders`;
@@ -445,7 +337,7 @@ declare function getUserMessage(error: unknown): string;
  * - **error classification** — every failure normalizes through
  *   `normalizeMatrxError` into the ONE `MatrxCallError` envelope;
  * - **diagnostics** — a typed sink the host wires to its capture/telemetry
- *   (`onRequest`, `onError`, `onProtocolDowngrade`); wiring it is optional,
+ *   (`onRequest`, `onError`); wiring it is optional,
  *   the transport works silently without it.
  *
  * Header merge order is part of the port contract: wire headers first
@@ -530,8 +422,6 @@ interface MatrxTransportDiagnostics {
      * listed in `expectedErrorStatuses`, with the classified envelope.
      */
     onError?: (error: MatrxCallError, info: MatrxRequestInfo) => void;
-    /** Fired on every v2 → v1 protocol downgrade. */
-    onProtocolDowngrade?: (downgrade: MatrxProtocolDowngrade) => void;
 }
 interface CreateMatrxTransportOptions {
     /** Fixed base URL, no trailing slash. Exactly one of `baseUrl` / `resolveTarget`. */
@@ -559,8 +449,6 @@ interface CreateMatrxTransportOptions {
      * org in the body only.
      */
     organizationId?: string | (() => string | null | undefined);
-    /** AI API protocol version (value or per-call getter). Default `"v2"`. */
-    aiApiVersion?: MatrxAiApiVersion | (() => MatrxAiApiVersion);
     /** Max ms request start → response headers. Default 15_000. */
     connectTimeoutMs?: number;
     /**
@@ -741,14 +629,11 @@ interface ExecuteMatrxCallRequest<E = MatrxStreamEnvelope> {
     onStreamError?: (error: MatrxCallError) => void;
 }
 interface ExecuteMatrxCallHooks<E = MatrxStreamEnvelope> {
-    /** Every v2 → v1 protocol downgrade. */
-    onProtocolDowngrade?: (downgrade: MatrxProtocolDowngrade) => void;
     /** The host's stream parser (default `parseMatrxNdjsonResponse`). */
     parseStream?: (response: Response, signal?: AbortSignal) => MatrxStreamParse<E>;
 }
 /**
- * Execute one call over the v2 → v1 protocol fallback. An HTTP error
- * response resolves as `{ error }`; a thrown failure (network, timeout,
+ * Execute one call. An HTTP error response resolves as `{ error }`; a thrown failure (network, timeout,
  * abort, a broken stream) propagates — the caller normalizes it with
  * `normalizeMatrxError` and decides what to capture.
  */
@@ -2795,4 +2680,4 @@ declare const ENDPOINTS: {
     };
 };
 
-export { BackendApiError, type BackendApiErrorData, type BackendErrorCode, type BackendFailureExplanation, type CreateMatrxTransportOptions, type CreateWarmupOptions, ENDPOINTS, type EndpointOverrideConfig, type ExecuteMatrxCallHooks, type ExecuteMatrxCallRequest, type FollowRuntimeOperationOptions, type FollowRuntimeOperationToEndOptions, type FollowRuntimeOperationToEndResult, type FollowServerJobOptions, type FollowUnavailableRejoinOptions, type JsonRequestOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, MATRX_UI_ONLY_BODY_FIELDS, type MatrxAgentStartRequest, type MatrxAiApiVersion, MatrxApiError, type MatrxCallError, type MatrxCallResult, type MatrxCallScope, type MatrxCancelResponse, type MatrxChatMessage, type MatrxClientSessionProvider, type MatrxClientToolResult, type MatrxCompletedRun, type MatrxContextAnchor, type MatrxConversationContinueRequest, type MatrxConversationResumeRequest, type MatrxConversationStart, type MatrxEphemeralConversation, type MatrxFollowedOutcome, type MatrxHttpErrorLike, type MatrxHttpMethod, type MatrxJsonObject, type MatrxJsonValue, type MatrxLiveRunRejoin, type MatrxLiveStreamUnavailable, type MatrxMandateStartRequest, type MatrxOperationEventsPage, type MatrxOperationFollowEvent, type MatrxOperationStatusResponse, type MatrxOperationsByLinkResponse, type MatrxPendingCallSummary, type MatrxProtocolDowngrade, type MatrxProtocolFallbackOptions, type MatrxQueryParams, type MatrxRequestInfo, type MatrxRequestScope, MatrxRunError, type MatrxRunHandle, type MatrxRunPickup, type MatrxRunPickupSettlement, type MatrxRuntimeExecutionStatus, type MatrxRuntimeOperationEvent, type MatrxRuntimeOperationView, type MatrxStoredConversationContinue, type MatrxStoredConversationCreate, type MatrxStreamCallOptions, type MatrxStreamCursorStamp, type MatrxStreamIds, type MatrxStreamParse, type MatrxToolResultsResponse, type MatrxTransport, type MatrxTransportDiagnostics, type MatrxTransportRequest, type MatrxTransportTarget, type MatrxTurnFields, OrganizationContextError, type OrganizationContextErrorCode, type OrganizationOperation, type ParseMatrxNdjsonResponseHooks, type ProviderSessionFailure, type ProviderSessionFailureVerdict, type ProviderSessionUsage, type ProviderSessionUsageReceipt, type ProviderUsageReporter, type ProviderUsageReporterOptions, type ProviderUsageSendResult, type QueryValue, RUN_OUTPUT_KINDS, RUN_STREAM_LIFETIME_BACKSTOP_MS, RUN_WAIT_KNOB_FEATURE, ResilientFetchOptions, ResilientFetchResult, type ResumeOrRejoinOptions, type ResumeOrRejoinOutcome, type RunAgentToCompletionOptions, type RunOutputKind, type RunWait, type RunWaitKnobReader, type SendMatrxRequestOptions, type ServerJobFinalStatus, type ServerJobOutcome, type ServerJobPath, type ServerJobStatus, type ServerJobTarget, type SettleRunPickupOptions, type StreamReplayCursor, type StreamReplayCursorOptions, type StreamRequestOptions, StreamTransportError, TERMINAL_MATRX_RUNTIME_STATUSES, type UpstreamErrorPayload, V2_COVERED_AI_PATH_TEMPLATES, WARM_PATH, type WarmItem, type WarmReason, type Warmup, aiVersionPathOverrides, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, bareStatusSentence, buildMatrxRequestBody, buildMatrxRequestUrl, buildQuery, buildSafeRequestLog, cancelAgentRun, continueAgentConversation, continueEphemeralConversationStart, continueStoredConversationStart, createMatrxTransport, createOrganizationOperation, createProviderUsageReporter, createStreamReplayCursor, createWarmup, describeBackendFailure, encodePathSegment, executeMatrxCall, extractMatrxErrorCode, extractMatrxErrorMessage, fetchWithMatrxProtocolFallback, followRuntimeOperationEvents, followRuntimeOperationToEnd, followServerJob, followUnavailableRejoin, followWorkflowRunEvents, getRuntimeOperationStatus, getRuntimeOperationsByLink, getUserMessage, honestTransportMessage, isBareTransportCode, isCoveredAiPath, isEmptyProviderUsage, isGenericUserMessage, isJobOutputKind, isLiveStreamUnavailable, isResumeConflict, isServerJobSettled, isStreamTransportLost, isV2Path, listConversationPendingToolCalls, listRuntimeOperationEvents, listUserPendingToolCalls, mintMatrxConversationId, newEphemeralConversationStart, newStoredConversationStart, normalizeMatrxError, openMatrxStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxNdjsonResponse, parsePersistedBackendError, parseStreamError, pickServerJobOperation, preconnectServer, providerSessionFailureBody, providerSessionUsageBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, readMatrxJsonResponse, readStreamCursor, redactUrlForRequestLog, rejoinRuntimeOperation, reportProviderSessionFailure, reportProviderSessionUsage, requestJson, requestStream, requireOrganizationContext, resetPreconnectedForTests, resolveEndpointPath, resolveRunWaitWith, resumeAgentConversation, resumeOrRejoin, runAgentToCompletion, runJobLabel, runOutputKindFromModalities, runWaitKnobKey, runWaitTimeoutMessage, runtimeOperationRejoinPath, sendMatrxRequest, serverJobRejoinHandle, settleRunPickup, shouldReportMatrxCallError, startAgentRun, startMandateRun, streamErrorText, submitAgentToolResults, toRunHandle, toV1FallbackUrl, toV2Path, unwrapUpstreamError, withRunOrganization };
+export { BackendApiError, type BackendApiErrorData, type BackendErrorCode, type BackendFailureExplanation, type CreateMatrxTransportOptions, type CreateWarmupOptions, ENDPOINTS, type EndpointOverrideConfig, type ExecuteMatrxCallHooks, type ExecuteMatrxCallRequest, type FollowRuntimeOperationOptions, type FollowRuntimeOperationToEndOptions, type FollowRuntimeOperationToEndResult, type FollowServerJobOptions, type FollowUnavailableRejoinOptions, type JsonRequestOptions, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, MATRX_UI_ONLY_BODY_FIELDS, type MatrxAgentStartRequest, MatrxApiError, type MatrxCallError, type MatrxCallResult, type MatrxCallScope, type MatrxCancelResponse, type MatrxChatMessage, type MatrxClientSessionProvider, type MatrxClientToolResult, type MatrxCompletedRun, type MatrxContextAnchor, type MatrxConversationContinueRequest, type MatrxConversationResumeRequest, type MatrxConversationStart, type MatrxEphemeralConversation, type MatrxFollowedOutcome, type MatrxHttpErrorLike, type MatrxHttpMethod, type MatrxJsonObject, type MatrxJsonValue, type MatrxLiveRunRejoin, type MatrxLiveStreamUnavailable, type MatrxMandateStartRequest, type MatrxOperationEventsPage, type MatrxOperationFollowEvent, type MatrxOperationStatusResponse, type MatrxOperationsByLinkResponse, type MatrxPendingCallSummary, type MatrxQueryParams, type MatrxRequestInfo, type MatrxRequestScope, MatrxRunError, type MatrxRunHandle, type MatrxRunPickup, type MatrxRunPickupSettlement, type MatrxRuntimeExecutionStatus, type MatrxRuntimeOperationEvent, type MatrxRuntimeOperationView, type MatrxStoredConversationContinue, type MatrxStoredConversationCreate, type MatrxStreamCallOptions, type MatrxStreamCursorStamp, type MatrxStreamIds, type MatrxStreamParse, type MatrxToolResultsResponse, type MatrxTransport, type MatrxTransportDiagnostics, type MatrxTransportRequest, type MatrxTransportTarget, type MatrxTurnFields, OrganizationContextError, type OrganizationContextErrorCode, type OrganizationOperation, type ParseMatrxNdjsonResponseHooks, type ProviderSessionFailure, type ProviderSessionFailureVerdict, type ProviderSessionUsage, type ProviderSessionUsageReceipt, type ProviderUsageReporter, type ProviderUsageReporterOptions, type ProviderUsageSendResult, type QueryValue, RUN_OUTPUT_KINDS, RUN_STREAM_LIFETIME_BACKSTOP_MS, RUN_WAIT_KNOB_FEATURE, type ResumeOrRejoinOptions, type ResumeOrRejoinOutcome, type RunAgentToCompletionOptions, type RunOutputKind, type RunWait, type RunWaitKnobReader, type SendMatrxRequestOptions, type ServerJobFinalStatus, type ServerJobOutcome, type ServerJobPath, type ServerJobStatus, type ServerJobTarget, type SettleRunPickupOptions, type StreamReplayCursor, type StreamReplayCursorOptions, type StreamRequestOptions, StreamTransportError, TERMINAL_MATRX_RUNTIME_STATUSES, type UpstreamErrorPayload, WARM_PATH, type WarmItem, type WarmReason, type Warmup, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, bareStatusSentence, buildMatrxRequestBody, buildMatrxRequestUrl, buildQuery, buildSafeRequestLog, cancelAgentRun, continueAgentConversation, continueEphemeralConversationStart, continueStoredConversationStart, createMatrxTransport, createOrganizationOperation, createProviderUsageReporter, createStreamReplayCursor, createWarmup, describeBackendFailure, encodePathSegment, executeMatrxCall, extractMatrxErrorCode, extractMatrxErrorMessage, followRuntimeOperationEvents, followRuntimeOperationToEnd, followServerJob, followUnavailableRejoin, followWorkflowRunEvents, getRuntimeOperationStatus, getRuntimeOperationsByLink, getUserMessage, honestTransportMessage, isBareTransportCode, isEmptyProviderUsage, isGenericUserMessage, isJobOutputKind, isLiveStreamUnavailable, isResumeConflict, isServerJobSettled, isStreamTransportLost, listConversationPendingToolCalls, listRuntimeOperationEvents, listUserPendingToolCalls, mintMatrxConversationId, newEphemeralConversationStart, newStoredConversationStart, normalizeMatrxError, openMatrxStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxNdjsonResponse, parsePersistedBackendError, parseStreamError, pickServerJobOperation, preconnectServer, providerSessionFailureBody, providerSessionUsageBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, readMatrxJsonResponse, readStreamCursor, redactUrlForRequestLog, rejoinRuntimeOperation, reportProviderSessionFailure, reportProviderSessionUsage, requestJson, requestStream, requireOrganizationContext, resetPreconnectedForTests, resolveEndpointPath, resolveRunWaitWith, resumeAgentConversation, resumeOrRejoin, runAgentToCompletion, runJobLabel, runOutputKindFromModalities, runWaitKnobKey, runWaitTimeoutMessage, runtimeOperationRejoinPath, sendMatrxRequest, serverJobRejoinHandle, settleRunPickup, shouldReportMatrxCallError, startAgentRun, startMandateRun, streamErrorText, submitAgentToolResults, toRunHandle, unwrapUpstreamError, withRunOrganization };

package/dist/index.js

@@ -1,8 +1,9 @@
+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, applyAiApiVersion, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, MATRX_AI_API_VERSION_DEFAULT, StreamTransportError } from './chunk-JRPLPAIX.js';
-export { BackendApiError, CONTRACT_SHA256, DEPLOYMENTS, DOMAINS, MATRX_AI_API_VERSION_DEFAULT, MatrxApiError, OrganizationContextError, StreamTransportError, V2_COVERED_AI_PATH_TEMPLATES, aiVersionPathOverrides, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, fetchWithMatrxProtocolFallback, getUserMessage, isBinaryType, isCoveredAiPath, isGenericUserMessage, isStreamTransportLost, isV2Path, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parsePersistedBackendError, parseStreamError, requireOrganizationContext, toV1FallbackUrl, toV2Path, unwrapUpstreamError } from './chunk-JRPLPAIX.js';
-import { isNetError, extractErrorMessage } from './chunk-PIPE5OML.js';
-export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetworkError, OfflineError, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './chunk-PIPE5OML.js';
+import { OrganizationContextError, sendOnWire, WIRE_FETCH_OPTION_KEYS, BackendApiError, parseHttpError, MatrxApiError, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, StreamTransportError } from './chunk-ER7WV43R.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-ER7WV43R.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';
 
 // src/core/call.ts
@@ -167,8 +168,7 @@ async function executeMatrxCall(request, hooks = {}) {
     ...request.signal ? { signal: request.signal } : {},
     connectTimeoutMs: request.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS,
     totalTimeoutMs: request.stream ? null : request.totalTimeoutMs === void 0 ? DEFAULT_JSON_TOTAL_TIMEOUT_MS : request.totalTimeoutMs,
-    ...request.stream ? { stream: true } : {},
-    ...hooks.onProtocolDowngrade ? { onProtocolDowngrade: hooks.onProtocolDowngrade } : {}
+    ...request.stream ? { stream: true } : {}
   });
   const requestId = response.headers.get("X-Request-ID");
   const conversationId = response.headers.get("X-Conversation-ID");
@@ -359,7 +359,6 @@ function createMatrxTransport(options) {
     resolveTarget,
     credentials,
     organizationId,
-    aiApiVersion,
     connectTimeoutMs = PRODUCTION_CONNECT_TIMEOUT_MS,
     totalTimeoutMs = null,
     expectedErrorStatuses,
@@ -374,10 +373,6 @@ function createMatrxTransport(options) {
     );
   }
   const resolve = resolveTarget ?? (() => ({ baseUrl }));
-  const resolveVersion = () => {
-    if (aiApiVersion === void 0) return MATRX_AI_API_VERSION_DEFAULT;
-    return typeof aiApiVersion === "function" ? aiApiVersion() : aiApiVersion;
-  };
   const resolveOrganizationId = (callOrganizationId) => {
     if (organizationId === void 0) return null;
     if (callOrganizationId !== null) return requireOrganizationContext(callOrganizationId);
@@ -388,8 +383,7 @@ function createMatrxTransport(options) {
     async fetch(path, init) {
       const target = await resolve(init);
       const callOrganizationId = readOrganizationHeader(init.headers);
-      const versionedPath = applyAiApiVersion(path, resolveVersion());
-      const url = `${target.baseUrl}${versionedPath}`;
+      const url = `${target.baseUrl}${path}`;
       const policyHeaders = stripContentType(target.policyHeaders ?? {});
       let overHeaders = callOrganizationId === null ? policyHeaders : stripOrganizationHeader(policyHeaders);
       const orgId = resolveOrganizationId(callOrganizationId);
@@ -417,8 +411,7 @@ function createMatrxTransport(options) {
             ...init.signal ? { signal: init.signal } : {},
             ...init.onUploadProgress ? { onUploadProgress: init.onUploadProgress } : {},
             connectTimeoutMs,
-            totalTimeoutMs,
-            ...diagnostics?.onProtocolDowngrade ? { onProtocolDowngrade: diagnostics.onProtocolDowngrade } : {}
+            totalTimeoutMs
           },
           {
             ...credentials ? { credentials } : {},

package/dist/integrations.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkEV7AXV2X_cjs = require('./chunk-EV7AXV2X.cjs');
-require('./chunk-PKYPPATQ.cjs');
+var chunkSME66TWP_cjs = require('./chunk-SME66TWP.cjs');
+require('./chunk-2SXAAKGV.cjs');
 
 // src/generated/integrations.ts
 var $ebayAccountDeletionChallenge = { m: "GET", p: "/ebay/account-deletion", d: "aidream", a: "guest", o: "optional", n: "integrations.ebay_account_deletion_challenge" };
@@ -3634,11 +3634,11 @@ function bingIntegrationsDisconnect(api, args, options) {
 }
 var $importNotionZip = { m: "POST", p: "/notion-import/zip", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "integrations.import_notion_zip" };
 function importNotionZip(api, args, options) {
-  return chunkEV7AXV2X_cjs.openStream(api, $importNotionZip, args, options);
+  return chunkSME66TWP_cjs.openStream(api, $importNotionZip, args, options);
 }
 var $importNotionConnected = { m: "POST", p: "/notion-import/connected", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "integrations.import_notion_connected" };
 function importNotionConnected(api, args, options) {
-  return chunkEV7AXV2X_cjs.openStream(api, $importNotionConnected, args, options);
+  return chunkSME66TWP_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-YFW4xNti.cjs';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-BXLIDtlM.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-YFW4xNti.js';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-BXLIDtlM.js';
 import { JsonValue, CalendarLocalRefreshResult, CalendarCreateResult, CalendarEventAttendee, StorageImportResult } from './schemas.js';
 import '@ai-matrx/auth/credentials';
 

package/dist/integrations.js

@@ -1,5 +1,5 @@
-import { openStream } from './chunk-JRPLPAIX.js';
-import './chunk-PIPE5OML.js';
+import { openStream } from './chunk-ER7WV43R.js';
+import './chunk-KIEAFMKB.js';
 
 // src/generated/integrations.ts
 var $ebayAccountDeletionChallenge = { m: "GET", p: "/ebay/account-deletion", d: "aidream", a: "guest", o: "optional", n: "integrations.ebay_account_deletion_challenge" };

package/dist/intelligence.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkEV7AXV2X_cjs = require('./chunk-EV7AXV2X.cjs');
-require('./chunk-PKYPPATQ.cjs');
+var chunkSME66TWP_cjs = require('./chunk-SME66TWP.cjs');
+require('./chunk-2SXAAKGV.cjs');
 
 // src/intelligence/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "9a47ac0528d889ae535fae35c6356b7db8d28415",
+  aidreamRevision: "bdb99c5fe277dae3e3ab171f84c452a32cabf5c6",
   generatorVersion: "1.0.0",
   packageVersion: "0.59.0",
   retireWindow: 3
@@ -729,7 +729,7 @@ function getAgentCalibration(api, args, options) {
 }
 var $createDecision = { m: "POST", p: "/ai/decisions", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "intelligence.create_decision" };
 function createDecision(api, args, options) {
-  return chunkEV7AXV2X_cjs.openStream(api, $createDecision, args, options);
+  return chunkSME66TWP_cjs.openStream(api, $createDecision, args, options);
 }
 var $readDecision = { m: "GET", p: "/ai/decisions/{execution_id}", d: "aidream", a: "guest", o: "required", n: "intelligence.read_decision" };
 function readDecision(api, args, options) {
@@ -877,11 +877,11 @@ function captureProvisionDoor(api, args, options) {
 }
 var $runInitial = { m: "POST", p: "/agent-iteration/run-initial", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "intelligence.run_initial" };
 function runInitial(api, args, options) {
-  return chunkEV7AXV2X_cjs.openStream(api, $runInitial, args, options);
+  return chunkSME66TWP_cjs.openStream(api, $runInitial, args, options);
 }
 var $runFeedback = { m: "POST", p: "/agent-iteration/feedback", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "intelligence.run_feedback" };
 function runFeedback(api, args, options) {
-  return chunkEV7AXV2X_cjs.openStream(api, $runFeedback, args, options);
+  return chunkSME66TWP_cjs.openStream(api, $runFeedback, args, options);
 }
 var $commitChoice = { m: "POST", p: "/agent-iteration/commit-choice", d: "aidream", a: "guest", o: "required", n: "intelligence.commit_choice" };
 function commitChoice(api, args, options) {
@@ -1037,7 +1037,7 @@ function getMandateRun(api, args, options) {
 }
 var $replayMandateRun = { m: "POST", p: "/mandates/runs/{conversation_id}/replay", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "intelligence.replay_mandate_run" };
 function replayMandateRun(api, args, options) {
-  return chunkEV7AXV2X_cjs.openStream(api, $replayMandateRun, args, options);
+  return chunkSME66TWP_cjs.openStream(api, $replayMandateRun, args, options);
 }
 var $getMandateRunResult = { m: "GET", p: "/mandates/runs/{request_id}/result", d: "aidream", a: "guest", o: "optional", n: "intelligence.get_mandate_run_result" };
 function getMandateRunResult(api, args, options) {
@@ -1045,7 +1045,7 @@ function getMandateRunResult(api, args, options) {
 }
 var $answerMandateRun = { m: "POST", p: "/mandates/runs/{request_id}/answer", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "intelligence.answer_mandate_run" };
 function answerMandateRun(api, args, options) {
-  return chunkEV7AXV2X_cjs.openStream(api, $answerMandateRun, args, options);
+  return chunkSME66TWP_cjs.openStream(api, $answerMandateRun, args, options);
 }
 var $getMandateRuns = { m: "GET", p: "/mandates/{mandate_key}/runs", d: "aidream", a: "guest", o: "optional", n: "intelligence.get_mandate_runs" };
 function getMandateRuns(api, args, options) {

package/dist/intelligence.d.cts

@@ -1,6 +1,6 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-YFW4xNti.cjs';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-BXLIDtlM.cjs';
 import { JsonValue, MandateTestHolder } from './schemas.cjs';
-export { A as ALL_MANDATE_KEYS, D as DYNAMIC_MANDATE_FAMILIES, a as DynamicMandateFamilyPrefix, b as DynamicMandateKey, M as MANDATE_FAMILIES, c as MANDATE_KEYS, d as MANDATE_KEYS_META, e as MandateFamilyMember, f as MandateFamilyPrefix, g as MandateKey, R as RETIRING_MANDATE_KEYS, m as mandateKeyOfApp, h as mandateKeyOfShortcut } from './keys.generated-DPvmbTFD.cjs';
+export { A as ALL_MANDATE_KEYS, D as DYNAMIC_MANDATE_FAMILIES, a as DynamicMandateFamilyPrefix, b as DynamicMandateKey, M as MANDATE_FAMILIES, c as MANDATE_KEYS, d as MANDATE_KEYS_META, e as MandateFamilyMember, f as MandateFamilyPrefix, g as MandateKey, R as RETIRING_MANDATE_KEYS, m as mandateKeyOfApp, h as mandateKeyOfShortcut } from './keys.generated-DE-t9kzx.cjs';
 import '@ai-matrx/auth/credentials';
 
 /**

package/dist/intelligence.d.ts

@@ -1,6 +1,6 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-YFW4xNti.js';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-BXLIDtlM.js';
 import { JsonValue, MandateTestHolder } from './schemas.js';
-export { A as ALL_MANDATE_KEYS, D as DYNAMIC_MANDATE_FAMILIES, a as DynamicMandateFamilyPrefix, b as DynamicMandateKey, M as MANDATE_FAMILIES, c as MANDATE_KEYS, d as MANDATE_KEYS_META, e as MandateFamilyMember, f as MandateFamilyPrefix, g as MandateKey, R as RETIRING_MANDATE_KEYS, m as mandateKeyOfApp, h as mandateKeyOfShortcut } from './keys.generated-DPvmbTFD.js';
+export { A as ALL_MANDATE_KEYS, D as DYNAMIC_MANDATE_FAMILIES, a as DynamicMandateFamilyPrefix, b as DynamicMandateKey, M as MANDATE_FAMILIES, c as MANDATE_KEYS, d as MANDATE_KEYS_META, e as MandateFamilyMember, f as MandateFamilyPrefix, g as MandateKey, R as RETIRING_MANDATE_KEYS, m as mandateKeyOfApp, h as mandateKeyOfShortcut } from './keys.generated-DE-t9kzx.js';
 import '@ai-matrx/auth/credentials';
 
 /**

package/dist/intelligence.js

@@ -1,9 +1,9 @@
-import { openStream } from './chunk-JRPLPAIX.js';
-import './chunk-PIPE5OML.js';
+import { openStream } from './chunk-ER7WV43R.js';
+import './chunk-KIEAFMKB.js';
 
 // src/intelligence/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "9a47ac0528d889ae535fae35c6356b7db8d28415",
+  aidreamRevision: "bdb99c5fe277dae3e3ab171f84c452a32cabf5c6",
   generatorVersion: "1.0.0",
   packageVersion: "0.59.0",
   retireWindow: 3

package/dist/{keys.generated-DPvmbTFD.d.cts → keys.generated-DE-t9kzx.d.cts}

@@ -6,7 +6,7 @@
  * from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
  * boot sync writes to the database from. There is no hand list anywhere.
  *
- * aidream revision:   9a47ac0528d889ae535fae35c6356b7db8d28415
+ * aidream revision:   bdb99c5fe277dae3e3ab171f84c452a32cabf5c6
  * generator version:  1.0.0
  * package version:    0.59.0
  * active keys:        584
@@ -19,7 +19,7 @@
  */
 /** Where this module came from — surfaced so a report can name the exact build. */
 declare const MANDATE_KEYS_META: {
-    readonly aidreamRevision: "9a47ac0528d889ae535fae35c6356b7db8d28415";
+    readonly aidreamRevision: "bdb99c5fe277dae3e3ab171f84c452a32cabf5c6";
     readonly generatorVersion: "1.0.0";
     readonly packageVersion: "0.59.0";
     readonly retireWindow: 3;