@ai-matrx/api 0.1.8 → 0.1.10

package/dist/index.d.cts

@@ -1,13 +1,118 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-D_ZjxGwP.cjs';
-export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as openJsonOrStream, p as openStream } from './index-D_ZjxGwP.cjs';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-Gj30ybjE.cjs';
+export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as openJsonOrStream, p as openStream } from './index-Gj30ybjE.cjs';
 import { CredentialsPort } from '@ai-matrx/auth/credentials';
 export { API_KEY_PREFIX, CredentialsPort, CredentialsSetting, MATRX_HEADERS, MatrxCredential, MatrxCredentialKind, credentialToHeaders, toCredentialsPort } from '@ai-matrx/auth/credentials';
-import { ResilientFetchOptions } from './net.cjs';
-export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, ResilientFetchResult, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.cjs';
-import { g as MandateKey, b as DynamicMandateKey } from './keys.generated-CK_C5UXG.cjs';
+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-DZUiM-uA.cjs';
 
 /**
- * `@ai-matrx/agents/matrx` — the Matrx transport port.
+ * 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>;
+
+/**
+ * `@ai-matrx/api` — the Matrx transport port.
  *
  * The ONE seam between this package's wire semantics and a host's connection
  * policy. This package owns WHAT is said to the AI Matrx server — paths,
@@ -41,17 +146,22 @@ import { g as MandateKey, b as DynamicMandateKey } from './keys.generated-CK_C5U
  * so a host can spread it straight into `fetch`.
  */
 interface MatrxTransportRequest {
-    method: "GET" | "POST";
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
     /**
      * Wire-semantic headers the CALL requires (`Content-Type`, `Accept`,
      * `Last-Event-ID`). The host merges its policy headers (auth, org) on top;
      * it must not drop these.
      */
     headers: Record<string, string>;
-    /** Pre-serialized JSON body, present on POST calls that carry one. */
-    body?: string;
+    /** The body: a pre-serialized JSON string, or any `BodyInit` (`FormData`, `Blob`, bytes). */
+    body?: BodyInit;
     /** Caller cancellation. The host must wire it to the underlying fetch. */
     signal?: AbortSignal;
+    /** Upload progress (bytes sent); the production transport reports it. */
+    onUploadProgress?: (progress: {
+        loaded: number;
+        total: number;
+    }) => void;
 }
 /**
  * The transport port. `path` is server-relative and always starts with `/`
@@ -100,7 +210,7 @@ declare function extractMatrxErrorMessage(serverDetail: unknown): string | undef
 declare function extractMatrxErrorCode(serverDetail: unknown): string | null;
 
 /**
- * `@ai-matrx/agents/matrx` — the AI Matrx server's error model, as every
+ * `@ai-matrx/api` — the AI Matrx server's error model, as every
  * client reads it: `BackendApiError` (the server's `APIError` body),
  * `StreamTransportError` (the socket died mid-run; the run may still finish
  * and is reattachable), parsing of HTTP / stream / persisted errors, and the
@@ -304,113 +414,6 @@ declare function describeBackendFailure(error: unknown): BackendFailureExplanati
  */
 declare function getUserMessage(error: unknown): string;
 
-/**
- * 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<{
-    response: Response;
-}>;
-/**
- * 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>;
-
 /**
  * The PRODUCTION `MatrxTransport` — the full connection pipeline every Matrx
  * host used to hand-roll, moved in under C22 (THE HARD PARTS LIVE IN THE
@@ -429,7 +432,7 @@ declare function aiVersionPathOverrides(version: MatrxAiApiVersion): Record<stri
  * - **timeouts** — connect 15s (for a non-streaming FastAPI handler this is
  *   effectively time-to-response), total UNCAPPED (the port cannot tell a JSON
  *   call from a long-lived NDJSON/SSE stream; the connect timeout is the JSON
- *   guard), via `@ai-matrx/data/net`'s `resilientFetch`;
+ *   guard), via `@ai-matrx/api/net`'s `resilientFetch`;
  * - **protocol** — the AI API version transform (`applyAiApiVersion`, default
  *   v2) + the loud v2 → v1 transport fallback (`./protocol`);
  * - **credentials** — read fresh from the injected `CredentialsPort` on EVERY
@@ -507,7 +510,7 @@ interface MatrxTransportTarget {
 interface MatrxRequestInfo {
     /** The final URL (base + version-transformed path). */
     url: string;
-    method: "GET" | "POST";
+    method: MatrxTransportRequest["method"];
     /** The server-relative path as the package requested it. */
     path: string;
     /** The resolved routing channel (default "default"). */
@@ -576,6 +579,10 @@ interface CreateMatrxTransportOptions {
     /** Short call-site label surfaced on `MatrxRequestInfo` (default "matrxTransport"). */
     source?: string;
     diagnostics?: MatrxTransportDiagnostics;
+    /** One refresh on a 401; resolve `true` to retry the call once with the fresh credential. */
+    refreshCredentials?: () => Promise<boolean>;
+    /** Upper bound on the credentials port's `ready()` wait. Default 3 000 ms. */
+    readyTimeoutMs?: number;
 }
 /**
  * Build the production `MatrxTransport`. See the module doc for the pipeline;
@@ -584,7 +591,7 @@ interface CreateMatrxTransportOptions {
 declare function createMatrxTransport(options: CreateMatrxTransportOptions): MatrxTransport;
 
 /**
- * `@ai-matrx/agents/matrx` — THE request pipeline every typed Matrx server call
+ * `@ai-matrx/api` — THE request pipeline every typed Matrx server call
  * rides (chat package independence P9b). One implementation for every client:
  * matrx-frontend's `lib/api` `callApi` and the chat package's bare-host default
  * both build on it, and supply only their host facts — where the server is,
@@ -755,6 +762,8 @@ interface SendMatrxRequestOptions {
      * fake caller cancellation. Omit for no deadline.
      */
     timeoutMs?: number;
+    /** Upload progress (bytes sent); XHR in browsers, one final 100% elsewhere. */
+    onUploadProgress?: (progress: UploadProgress) => void;
 }
 /**
  * Send one request and resolve with the raw `Response`, whatever its status.
@@ -815,52 +824,8 @@ declare function applyOrganizationContextHeader(headers: Record<string, string>,
  */
 declare function assertQueryOrganizationMatchesContext(queryParams: Record<string, string | number | boolean> | undefined, organizationId: string): void;
 
-/** `@ai-matrx/agents/matrx` — moved from matrx-frontend `lib/api/log-api-target.ts` (chat-package independence P9). */
-/**
- * lib/api/log-api-target.ts
- *
- * ONE place that logs the *final, resolved* destination of every outbound
- * backend call — at the last moment, after every layer of server-address
- * resolution has run and the URL can no longer change before `fetch()`.
- *
- * Why this exists:
- *   We have several independent resolution layers — `selectResolvedBaseUrl`
- *   (apiConfigSlice), the EC2 / sandbox override channel in
- *   `resolve-base-url.ts`, per-call `forceBaseUrl` / `baseUrlOverride`, and
- *   the env-var fallback in `python-client.ts`. A bug in any one of them can
- *   silently send traffic to the wrong host (or to the sandbox URL, which is
- *   reserved for a single rare case). This logger makes the actual target of
- *   EVERY call visible in the console so misrouting is impossible to miss.
- *
- * Call this immediately before the `fetch()` / `resilientFetch()` /
- * `XMLHttpRequest.open()` that uses the URL — never earlier.
- */
-interface ApiTargetLogContext {
-    /** Short label of the call site, e.g. "callApi", "python-client.postJson". */
-    source: string;
-    /** HTTP method when known. */
-    method?: string;
-    /**
-     * Resolution channel when the call site knows it — "global" / "override" /
-     * "ec2-dedicated" / "force" / "env-fallback". Surfaces sandbox routing.
-     */
-    channel?: string;
-    /** The active server environment key from apiConfigSlice, when available. */
-    activeServer?: string;
-    /** Anything else worth seeing (conversationId, requestId, etc.). */
-    [extra: string]: unknown;
-}
-/**
- * Log the final resolved target URL for an outbound backend call.
- *
- * Normal calls log at `console.info` with a green tag. Calls whose host looks
- * like a sandbox/override target log at `console.error` with a red tag so they
- * are impossible to miss while hunting a misrouting bug.
- */
-declare function logApiTarget(url: string, context: ApiTargetLogContext): void;
-
 /**
- * `@ai-matrx/agents/matrx` — the single primitive that transforms a server
+ * `@ai-matrx/api` — the single primitive that transforms a server
  * endpoint PATH (never the base URL) before it is sent: an exact per-path
  * override, else a global version prefix. Moved from matrx-frontend
  * `lib/api/resolve-endpoint-path.ts` (chat-package independence P9).
@@ -890,23 +855,7 @@ interface EndpointOverrideConfig {
 declare function resolveEndpointPath(canonicalPath: string, config?: EndpointOverrideConfig | null): string;
 
 /**
- * Stamp the admin desktop-target preference onto a request body — but ONLY
- * when the body already declares a live `desktop-native` capability.
- *
- * The preference (Settings → Admin Server, `adminPreferences.
- * desktopTargetInstanceId`, persisted local-only) may DIRECT delegation to a
- * specific desktop; it must never DECLARE one. Fabricating the capability
- * here used to override the presence gate in `desktop-native.provider.ts`,
- * so a stale preference silently rode every AI turn: the server stamped
- * `target_instance_id` onto delegated tool calls while the smart-input
- * indicator truthfully showed no desktop bound, and browser-executed tools
- * (war_room_*, ui-first) 404'd their own /tool_results (submission-binding
- * check) and wedged the turn.
- */
-declare function applyDesktopTargetToRequestBody(body: unknown, targetInstanceId: string | null | undefined): void;
-
-/**
- * `@ai-matrx/agents/matrx` — moved from matrx-frontend `lib/api/run-wait.ts` (chat-package
+ * `@ai-matrx/api` — moved from matrx-frontend `lib/api/run-wait.ts` (chat-package
  * independence P9). The knob read is injected (`resolveRunWaitWith`); the host wraps it.
  */
 /**
@@ -991,7 +940,7 @@ declare function runJobLabel(kind: RunOutputKind, modelLabel: string | null): st
 declare function runWaitTimeoutMessage(kind: RunOutputKind, modelLabel: string | null, seconds: number | null): string;
 
 /**
- * `@ai-matrx/agents/matrx` — the client warm-up primitive.
+ * `@ai-matrx/api` — the client warm-up primitive.
  *
  * Contract: common-docs `systems/architecture/warm-cache/CONTRACT.md`.
  *
@@ -1063,7 +1012,7 @@ declare function preconnectServer(baseUrl: string | null | undefined): void;
 declare function resetPreconnectedForTests(): void;
 
 /**
- * Internal request plumbing for `@ai-matrx/agents/matrx`. Not part of the
+ * Internal request plumbing for `@ai-matrx/api`. Not part of the
  * public surface — `matrx/index.ts` deliberately does not re-export this
  * module. Everything here is pure: no globals, no work at import time.
  */
@@ -1078,7 +1027,7 @@ type QueryValue = string | number | boolean | readonly string[] | undefined;
  */
 declare function buildQuery(params: Record<string, QueryValue>): string;
 interface JsonRequestOptions {
-    method: "GET" | "POST";
+    method: MatrxTransportRequest["method"];
     body?: unknown;
     signal?: AbortSignal;
 }
@@ -1124,7 +1073,7 @@ interface MatrxRunHandle {
  */
 declare function toRunHandle(response: Response, options: MatrxStreamCallOptions): MatrxRunHandle;
 interface StreamRequestOptions {
-    method: "GET" | "POST";
+    method: MatrxTransportRequest["method"];
     body?: unknown;
     /** Extra wire-semantic headers (`Accept`, `Last-Event-ID`). */
     headers?: Record<string, string>;
@@ -2369,7 +2318,7 @@ declare function listUserPendingToolCalls(transport: MatrxTransport, options?: {
 }): Promise<MatrxPendingCallSummary[]>;
 
 /**
- * `@ai-matrx/agents/matrx` — every AI Matrx server endpoint path, by feature
+ * `@ai-matrx/api` — every AI Matrx server endpoint path, by feature
  * area (matching the server's router structure). Paths only, rooted at the
  * host (`/ai/...`, `/health`); the HOST owns the base URL.
  *
@@ -2439,7 +2388,7 @@ declare const ENDPOINTS: {
          * 404 `{code: "mandate_unfulfilled"}` when the mandate cannot be resolved —
          * surfaced verbatim, never swallowed into a client-side re-resolve.
          */
-        readonly mandateStart: (mandateKey: MandateKey | DynamicMandateKey) => "/ai/mandates/agent_apps.prompt_app_dev" | "/ai/mandates/agent_factory.build" | "/ai/mandates/agent_factory.contract" | "/ai/mandates/agent_factory.instructions" | "/ai/mandates/agent_factory.proof_review" | "/ai/mandates/agent_factory.structure_builder" | "/ai/mandates/agent_factory.system_plan" | "/ai/mandates/agent_factory.tool_choice" | "/ai/mandates/agent_studio.chat_brief" | "/ai/mandates/ai.translation_cell_draft" | "/ai/mandates/alchemy.prepare_content" | "/ai/mandates/ambient.page_guidance" | "/ai/mandates/ambient.spoken_summary" | "/ai/mandates/applets.build" | "/ai/mandates/applets.fix" | "/ai/mandates/audio.live_music" | "/ai/mandates/audio.speech" | "/ai/mandates/brand.voice_rewrite" | "/ai/mandates/chat.cx_default" | "/ai/mandates/chat.default_new_chat" | "/ai/mandates/chat.quick_audio_plan" | "/ai/mandates/chat.quick_fair_news" | "/ai/mandates/chat.quick_flashcards" | "/ai/mandates/chat.quick_image" | "/ai/mandates/chat.quick_org_chart" | "/ai/mandates/chat.quick_research" | "/ai/mandates/chat.quick_showcase" | "/ai/mandates/chat.quick_writing_partner" | "/ai/mandates/chat.response_mode_brainstorm" | "/ai/mandates/chat.response_mode_data" | "/ai/mandates/chat.response_mode_research" | "/ai/mandates/chat.response_mode_video" | "/ai/mandates/checks.cleanup_bakeoff.answer" | "/ai/mandates/checks.cleanup_bakeoff.judge" | "/ai/mandates/checks.finding_disposition" | "/ai/mandates/checks.finding_disposition_review" | "/ai/mandates/cms.content_writing" | "/ai/mandates/cms.publish_review" | "/ai/mandates/cms.seo_metadata" | "/ai/mandates/cms.site_editing" | "/ai/mandates/cms.theme_design" | "/ai/mandates/code_editor.code_edit" | "/ai/mandates/code_editor.dynamic_context_edit" | "/ai/mandates/code_editor.prompt_app_ui_edit" | "/ai/mandates/coding_session.conversation_responder" | "/ai/mandates/coding_session.managed_translation_reference" | "/ai/mandates/commerce_intake.assess_value" | "/ai/mandates/commerce_intake.extract_vision" | "/ai/mandates/commerce_intake.grading" | "/ai/mandates/commerce_intake.instant_analysis" | "/ai/mandates/commerce_intake.refute_no_value" | "/ai/mandates/commerce_intake.research_product" | "/ai/mandates/commerce_intake.segment_photos" | "/ai/mandates/commerce_intake.verify_enrichment" | "/ai/mandates/content_gate.section_relevance_decision" | "/ai/mandates/content_ir.component_artisan" | "/ai/mandates/content_ir.kind_architect" | "/ai/mandates/content_ir.kind_component_builder" | "/ai/mandates/content_ir.kind_creator" | "/ai/mandates/content_plan.branch_purpose" | "/ai/mandates/content_plan.brief_writer" | "/ai/mandates/content_plan.deepen_page" | "/ai/mandates/content_plan.entity_attacher" | "/ai/mandates/content_plan.entity_curator" | "/ai/mandates/content_plan.family_namer" | "/ai/mandates/content_plan.keyword_strategist" | "/ai/mandates/content_plan.merge_wave" | "/ai/mandates/content_plan.p3_family" | "/ai/mandates/content_plan.p4_write" | "/ai/mandates/content_plan.p5_review" | "/ai/mandates/content_plan.p6_build" | "/ai/mandates/content_plan.p6_build.about" | "/ai/mandates/content_plan.p6_build.blog" | "/ai/mandates/content_plan.p6_build.comparison" | "/ai/mandates/content_plan.p6_build.contact" | "/ai/mandates/content_plan.p6_build.faq" | "/ai/mandates/content_plan.p6_build.guide" | "/ai/mandates/content_plan.p6_build.home" | "/ai/mandates/content_plan.p6_build.index" | "/ai/mandates/content_plan.p6_build.location" | "/ai/mandates/content_plan.p6_build.pillar" | "/ai/mandates/content_plan.p6_build.pricing" | "/ai/mandates/content_plan.p6_build.service" | "/ai/mandates/content_plan.plan_reviewer" | "/ai/mandates/content_plan.research_wave.audience_journey" | "/ai/mandates/content_plan.research_wave.competitor_coverage" | "/ai/mandates/content_plan.research_wave.keyword_value" | "/ai/mandates/content_plan.route_picker" | "/ai/mandates/content_plan.shape_planner" | "/ai/mandates/conversation.action_auditor" | "/ai/mandates/conversation.decision_ledger" | "/ai/mandates/conversation.drift_auditor" | "/ai/mandates/conversation.label_agent_run" | "/ai/mandates/conversation.label_chat" | "/ai/mandates/conversation.outcome_summarizer" | "/ai/mandates/conversation.vision_extractor" | "/ai/mandates/conversation.vision_interviewer" | "/ai/mandates/crm.journalist_beat_analyst" | "/ai/mandates/crm.media_list_ranker" | "/ai/mandates/crm.outreach_draft_reviewer" | "/ai/mandates/crm.outreach_fact_check" | "/ai/mandates/crm.outreach_personalization_coach" | "/ai/mandates/crm.outreach_personalization_writer" | "/ai/mandates/crm.outreach_pitch_writer" | "/ai/mandates/crm.outreach_recipient_shortlister" | "/ai/mandates/crm.outreach_reply_drafter" | "/ai/mandates/crm.outreach_strategy" | "/ai/mandates/crm.party_kind_judge" | "/ai/mandates/crm.save_contact" | "/ai/mandates/data.formula_writing" | "/ai/mandates/data.page_guidance" | "/ai/mandates/data.row_action" | "/ai/mandates/data.table_chat" | "/ai/mandates/desktop.cloud_chat" | "/ai/mandates/dictionary.workspace_guide" | "/ai/mandates/distillation.timeline_distiller" | "/ai/mandates/distillation.timeline_unfolder" | "/ai/mandates/docproc.content_structure" | "/ai/mandates/education.admin_guidance" | "/ai/mandates/education.analytics_narrate" | "/ai/mandates/education.audio_study_guidance" | "/ai/mandates/education.card_image_generator" | "/ai/mandates/education.card_image_prompt_writer" | "/ai/mandates/education.card_image_qc_judge" | "/ai/mandates/education.card_image_web_source" | "/ai/mandates/education.classes_guidance" | "/ai/mandates/education.creator_guidance" | "/ai/mandates/education.data_guidance" | "/ai/mandates/education.exam_prep_guidance" | "/ai/mandates/education.family_guidance" | "/ai/mandates/education.fastfire_guidance" | "/ai/mandates/education.features_guidance" | "/ai/mandates/education.flashcards_guidance" | "/ai/mandates/education.game_guidance" | "/ai/mandates/education.grade_handwritten" | "/ai/mandates/education.grade_work_guidance" | "/ai/mandates/education.kit_title" | "/ai/mandates/education.learn_guidance" | "/ai/mandates/education.levels_guidance" | "/ai/mandates/education.library_guidance" | "/ai/mandates/education.media_guidance" | "/ai/mandates/education.memory_generate" | "/ai/mandates/education.memory_guidance" | "/ai/mandates/education.memory_hint" | "/ai/mandates/education.mind_maps_guidance" | "/ai/mandates/education.mindmap_generate" | "/ai/mandates/education.notes_generate" | "/ai/mandates/education.notes_guidance" | "/ai/mandates/education.offline_guidance" | "/ai/mandates/education.page_guidance" | "/ai/mandates/education.plan_generate" | "/ai/mandates/education.planner_guidance" | "/ai/mandates/education.practice_oral_guidance" | "/ai/mandates/education.practice_tests_guidance" | "/ai/mandates/education.progress_guidance" | "/ai/mandates/education.quiz_deepen_item" | "/ai/mandates/education.quiz_generate" | "/ai/mandates/education.quiz_generate_from_source" | "/ai/mandates/education.quizzes_guidance" | "/ai/mandates/education.spoken_practice_design" | "/ai/mandates/education.spoken_practice_design_language" | "/ai/mandates/education.spoken_practice_grade" | "/ai/mandates/education.spoken_practice_grade_pronunciation" | "/ai/mandates/education.spoken_practice_review" | "/ai/mandates/education.start_guidance" | "/ai/mandates/education.study_aids_guidance" | "/ai/mandates/education.study_pack_flashcards" | "/ai/mandates/education.study_pack_lessons" | "/ai/mandates/education.study_pack_notes" | "/ai/mandates/education.study_pack_quiz" | "/ai/mandates/education.study_pack_v2_flashcards" | "/ai/mandates/education.study_pack_v2_lessons" | "/ai/mandates/education.study_pack_v2_notes" | "/ai/mandates/education.study_pack_v2_quiz" | "/ai/mandates/education.subjects_guidance" | "/ai/mandates/education.summaries_guidance" | "/ai/mandates/education.summarize" | "/ai/mandates/education.tutor_guidance" | "/ai/mandates/education.tutor_message" | "/ai/mandates/education.voice_tutor" | "/ai/mandates/evaluators.comparative_judge" | "/ai/mandates/evaluators.rubric_judge" | "/ai/mandates/extend.browser_chat" | "/ai/mandates/extend.pattern_from_data" | "/ai/mandates/extend.structured_extractor" | "/ai/mandates/feedback.item_triage_decision" | "/ai/mandates/flashcards.enrich_card" | "/ai/mandates/flashcards.expand_card" | "/ai/mandates/flashcards.fix_giveaway_cards" | "/ai/mandates/flashcards.generate_cards" | "/ai/mandates/flashcards.generate_from_source" | "/ai/mandates/flashcards.grade_spoken" | "/ai/mandates/flashcards.grade_typed_answer" | "/ai/mandates/flashcards.help_live" | "/ai/mandates/flashcards.helper_tts" | "/ai/mandates/flashcards.make_quiz_items" | "/ai/mandates/flashcards.micro_coach" | "/ai/mandates/flashcards.review_batch" | "/ai/mandates/flashcards.spoken_front_tts" | "/ai/mandates/flashcards.verify_against_source" | "/ai/mandates/foundry.planner" | "/ai/mandates/google.channel_video_plan" | "/ai/mandates/google.desk_work" | "/ai/mandates/google.traffic_change_explanation" | "/ai/mandates/growth_loop.quality_analyze" | "/ai/mandates/growth_loop.quality_brief" | "/ai/mandates/growth_loop.quality_crawl" | "/ai/mandates/growth_loop.quality_fill" | "/ai/mandates/growth_loop.quality_measure" | "/ai/mandates/growth_loop.quality_plan" | "/ai/mandates/growth_loop.quality_publish" | "/ai/mandates/growth_loop.quality_realize" | "/ai/mandates/growth_loop.quality_research" | "/ai/mandates/growth_loop.quality_serve" | "/ai/mandates/growth_loop.quality_suggest" | "/ai/mandates/growth_loop.quality_writeback" | "/ai/mandates/growth_loop.supervisor" | "/ai/mandates/hindsight.crystallizer" | "/ai/mandates/hindsight.replay_judge" | "/ai/mandates/hindsight.reviewer" | "/ai/mandates/human_decisions.fallback_decider" | "/ai/mandates/image.generate" | "/ai/mandates/image_pipeline.concept" | "/ai/mandates/image_pipeline.prompt_write" | "/ai/mandates/image_pipeline.qc_judge" | "/ai/mandates/iteration.architect" | "/ai/mandates/iteration.diagnostic" | "/ai/mandates/iteration.root_cause" | "/ai/mandates/iteration.thinking_display" | "/ai/mandates/kg.cluster_namer" | "/ai/mandates/kg.ner_extractor" | "/ai/mandates/knowledge.document_verifier" | "/ai/mandates/knowledge.qa_generator" | "/ai/mandates/knowledge.section_summarizer" | "/ai/mandates/local.answer_question" | "/ai/mandates/local.chat_persona_brainstorm" | "/ai/mandates/local.chat_persona_code_review" | "/ai/mandates/local.chat_persona_explain_simply" | "/ai/mandates/local.chat_persona_helpful" | "/ai/mandates/local.chat_persona_spoken_replies" | "/ai/mandates/local.chat_persona_summarize" | "/ai/mandates/local.chat_persona_transcript_polish" | "/ai/mandates/local.cloud_chat" | "/ai/mandates/local.cloud_chat_reply" | "/ai/mandates/local.confidential_chat" | "/ai/mandates/local.explain_code" | "/ai/mandates/local.extract_action_items" | "/ai/mandates/local.improve_writing" | "/ai/mandates/local.polish_style_action_items" | "/ai/mandates/local.polish_style_bullets" | "/ai/mandates/local.polish_style_custom" | "/ai/mandates/local.polish_style_formal" | "/ai/mandates/local.polish_style_light_cleanup" | "/ai/mandates/local.polish_style_meeting_notes" | "/ai/mandates/local.polish_style_standard" | "/ai/mandates/local.polish_transcript" | "/ai/mandates/local.raw_completion" | "/ai/mandates/local.summarize_text" | "/ai/mandates/local.tool_calling_chat" | "/ai/mandates/make.describe_template" | "/ai/mandates/mandate_outcome.goal_clause_extraction" | "/ai/mandates/mandate_outcome.goal_fitness_decision" | "/ai/mandates/mandates.holder_draft" | "/ai/mandates/marketing.endowment_analysis" | "/ai/mandates/marketing.endowment_portfolio" | "/ai/mandates/marketing.image_prompt" | "/ai/mandates/marketing.page_image" | "/ai/mandates/marketing.page_image_all_in_one" | "/ai/mandates/marketing.video_metadata" | "/ai/mandates/masterwork.approach_selector" | "/ai/mandates/masterwork.audition_judge" | "/ai/mandates/masterwork.bad_draft" | "/ai/mandates/masterwork.bad_example_probe" | "/ai/mandates/masterwork.case_oracle" | "/ai/mandates/masterwork.checkup_auditor" | "/ai/mandates/masterwork.coherence_partner" | "/ai/mandates/masterwork.conductor" | "/ai/mandates/masterwork.corpus_cleaner" | "/ai/mandates/masterwork.corpus_synthesizer" | "/ai/mandates/masterwork.counterparty" | "/ai/mandates/masterwork.critique_distiller" | "/ai/mandates/masterwork.draft_triage" | "/ai/mandates/masterwork.drip_distiller" | "/ai/mandates/masterwork.drip_question" | "/ai/mandates/masterwork.elicitation_judge" | "/ai/mandates/masterwork.exception_hunter" | "/ai/mandates/masterwork.exemplar_distiller" | "/ai/mandates/masterwork.faithfulness_judge" | "/ai/mandates/masterwork.intake_designer" | "/ai/mandates/masterwork.markup_distiller" | "/ai/mandates/masterwork.meeting_scavenger" | "/ai/mandates/masterwork.monologue_distiller" | "/ai/mandates/masterwork.outcome_judge" | "/ai/mandates/masterwork.pairwise_judge" | "/ai/mandates/masterwork.prediction_boundary" | "/ai/mandates/masterwork.prediction_distiller" | "/ai/mandates/masterwork.relationship_auditor" | "/ai/mandates/masterwork.rule_improver" | "/ai/mandates/masterwork.rulebook_auditor" | "/ai/mandates/masterwork.scout" | "/ai/mandates/masterwork.sealed_case_oracle" | "/ai/mandates/masterwork.sort_case_writer" | "/ai/mandates/masterwork.sort_distiller" | "/ai/mandates/masterwork.source_distiller" | "/ai/mandates/masterwork.teach_back_distiller" | "/ai/mandates/masterwork.teach_back_explainer" | "/ai/mandates/masterwork.template.chief_edit" | "/ai/mandates/masterwork.template.chief_generate" | "/ai/mandates/masterwork.template.editor" | "/ai/mandates/masterwork.template.maker" | "/ai/mandates/masterwork.timeline_distiller" | "/ai/mandates/masterwork.timeline_segmenter" | "/ai/mandates/masterwork.transcript_distiller" | "/ai/mandates/masterwork.transcript_shortlister" | "/ai/mandates/masterwork.triad_distiller" | "/ai/mandates/masterwork.triad_generator" | "/ai/mandates/masterwork.understudy" | "/ai/mandates/masterwork.unfolding_judge" | "/ai/mandates/masterworks.bench.a2_loop" | "/ai/mandates/masterworks.bench.calibration_decoy" | "/ai/mandates/masterworks.bench.consensus" | "/ai/mandates/masterworks.bench.extract" | "/ai/mandates/masterworks.bench.judge" | "/ai/mandates/masterworks.bench.panel" | "/ai/mandates/masterworks.bench.raw_arm" | "/ai/mandates/masterworks.vanilla_arm.answer_from_facts" | "/ai/mandates/masterworks.vanilla_arm.best_work" | "/ai/mandates/masterworks.vanilla_arm.outcome_case" | "/ai/mandates/masterworks.vanilla_arm.professional_help" | "/ai/mandates/media.youtube_analyzer" | "/ai/mandates/media_catalog.item_vetting_decision" | "/ai/mandates/meet.agenda_draft" | "/ai/mandates/meet.caption_translation" | "/ai/mandates/meet.live_intelligence" | "/ai/mandates/meet.live_notes" | "/ai/mandates/meet.pre_meeting_brief" | "/ai/mandates/meet.transcription" | "/ai/mandates/meet.wrap_up" | "/ai/mandates/memory.observer" | "/ai/mandates/memory.reflector" | "/ai/mandates/mermaid.diagram_editing" | "/ai/mandates/messaging.action_item_extraction" | "/ai/mandates/messaging.conversation_catch_up" | "/ai/mandates/messaging.conversation_summary" | "/ai/mandates/messaging.reply_drafting" | "/ai/mandates/messenger.answer_anything" | "/ai/mandates/models.availability_probe" | "/ai/mandates/ner.deep_chunk_extractor" | "/ai/mandates/ner.document_orienter" | "/ai/mandates/ner.entity_canonicalizer" | "/ai/mandates/ner.finisher" | "/ai/mandates/ner.item_proposer" | "/ai/mandates/ner.magic_moment_detector" | "/ai/mandates/ner.scope_proposer" | "/ai/mandates/ner.scope_slot_filler" | "/ai/mandates/ner.suggestion_reviewer" | "/ai/mandates/ner.sweep_scope_discoverer" | "/ai/mandates/ner.sweep_scope_reference_finder" | "/ai/mandates/ner.sweep_value_miner" | "/ai/mandates/news.angles" | "/ai/mandates/news.coarse_relevance" | "/ai/mandates/news.monitor_setup_proposer" | "/ai/mandates/news.report" | "/ai/mandates/news.story_origin" | "/ai/mandates/news.triage" | "/ai/mandates/notes.organizer" | "/ai/mandates/notes.page_guidance" | "/ai/mandates/observability.tool_trace_pattern_detection" | "/ai/mandates/observability.tool_trace_triage" | "/ai/mandates/orchestras.role_describer" | "/ai/mandates/orchestration.tool_failure_standoff_decision" | "/ai/mandates/org_chart.seat_job_suggester" | "/ai/mandates/pdf.chunk_clean_ocr_text" | "/ai/mandates/pdf.chunk_flashcards_json" | "/ai/mandates/pdf.chunk_flashcards_typescript" | "/ai/mandates/pdf.content_cleaner" | "/ai/mandates/personal_staff.escalation" | "/ai/mandates/personal_staff.front_line" | "/ai/mandates/podcast.audience_adapter" | "/ai/mandates/podcast.audio_dialogue" | "/ai/mandates/podcast.audio_english" | "/ai/mandates/podcast.audio_persian" | "/ai/mandates/podcast.chapter_marker" | "/ai/mandates/podcast.content_extractor" | "/ai/mandates/podcast.deep_research" | "/ai/mandates/podcast.image_v1" | "/ai/mandates/podcast.image_v2" | "/ai/mandates/podcast.image_v3" | "/ai/mandates/podcast.image_v4" | "/ai/mandates/podcast.image_v5" | "/ai/mandates/podcast.image_v6_feature" | "/ai/mandates/podcast.image_v6_feature_prompt" | "/ai/mandates/podcast.live_rewrite" | "/ai/mandates/podcast.metadata" | "/ai/mandates/podcast.multihost_script" | "/ai/mandates/podcast.post_prep_expansion" | "/ai/mandates/podcast.post_prep_fact_checking" | "/ai/mandates/podcast.post_prep_summarization" | "/ai/mandates/podcast.post_prep_translation" | "/ai/mandates/podcast.race_frontier" | "/ai/mandates/podcast.relevance_gate" | "/ai/mandates/podcast.roundtable_script" | "/ai/mandates/podcast.script_educational" | "/ai/mandates/podcast.script_news" | "/ai/mandates/podcast.script_persian" | "/ai/mandates/podcast.solo_script" | "/ai/mandates/podcast.title_optimizer" | "/ai/mandates/podcast.video_v1" | "/ai/mandates/podcast.video_v2" | "/ai/mandates/podcast_client.blog_writer" | "/ai/mandates/podcast_client.show_notes" | "/ai/mandates/podcast_client.topic_ideas" | "/ai/mandates/podcast_client.web_content_extractor" | "/ai/mandates/podcast_client.youtube_research" | "/ai/mandates/product_capture.instant_analysis" | "/ai/mandates/projects.creation_guide" | "/ai/mandates/proof_runs.judge" | "/ai/mandates/purpose.writer" | "/ai/mandates/rag.chunk_contextualizer" | "/ai/mandates/rag.grounded_synthesis" | "/ai/mandates/rag.grounding_claim_extract" | "/ai/mandates/rag.grounding_judge" | "/ai/mandates/rag.hyde_generator" | "/ai/mandates/rag.image_caption" | "/ai/mandates/rag.pdf_page_cleaner" | "/ai/mandates/rag.query_expander" | "/ai/mandates/rag_kinds.grounded_synthesis" | "/ai/mandates/records.enrichment" | "/ai/mandates/research.auto_tagger" | "/ai/mandates/research.condenser_1" | "/ai/mandates/research.condenser_2" | "/ai/mandates/research.coverage_audit" | "/ai/mandates/research.cross_cutting_tags" | "/ai/mandates/research.document_assembly" | "/ai/mandates/research.keyword_synthesis" | "/ai/mandates/research.report" | "/ai/mandates/research.report_updater" | "/ai/mandates/research.source_authority" | "/ai/mandates/research.source_triage_decision" | "/ai/mandates/research.structured_page_summary" | "/ai/mandates/research.suggest_setup" | "/ai/mandates/research.tag_consolidation" | "/ai/mandates/research.topic_deep_research" | "/ai/mandates/research_client.output_blog" | "/ai/mandates/research_client.output_brand_card" | "/ai/mandates/research_client.output_brand_profile" | "/ai/mandates/research_client.output_competitive_landscape" | "/ai/mandates/research_client.output_gap_analysis" | "/ai/mandates/research_client.output_literature_review" | "/ai/mandates/research_client.output_reputation_business" | "/ai/mandates/research_client.output_reputation_personal" | "/ai/mandates/research_client.output_seo" | "/ai/mandates/research_client.output_slides" | "/ai/mandates/scraper.fact_check" | "/ai/mandates/scraper.keyword_analysis" | "/ai/mandates/scraper.page_fetch_verdict" | "/ai/mandates/seo.ai_visibility_blind_question_writer" | "/ai/mandates/seo.ai_visibility_buyer_jobs" | "/ai/mandates/seo.ai_visibility_decision_analyst" | "/ai/mandates/seo.ai_visibility_evidence_icp" | "/ai/mandates/seo.ai_visibility_panel_designer" | "/ai/mandates/seo.ai_visibility_panel_report" | "/ai/mandates/seo.ai_visibility_question_architect" | "/ai/mandates/seo.ai_visibility_question_qa" | "/ai/mandates/seo.ai_visibility_writing_audit" | "/ai/mandates/seo.backlink_analysis" | "/ai/mandates/seo.backlink_context_assessor" | "/ai/mandates/seo.backlink_work_planner" | "/ai/mandates/seo.business_model_verdict" | "/ai/mandates/seo.competitor_classifier" | "/ai/mandates/seo.competitor_opportunity_autopsy" | "/ai/mandates/seo.competitor_page_autopsy" | "/ai/mandates/seo.coverage_analyst" | "/ai/mandates/seo.digital_pr_reputation_adjudicator" | "/ai/mandates/seo.evidence_workbench" | "/ai/mandates/seo.finding_fixer" | "/ai/mandates/seo.guidelines_drafter" | "/ai/mandates/seo.ideal_customer_profile" | "/ai/mandates/seo.keyword_classifier" | "/ai/mandates/seo.keyword_expander" | "/ai/mandates/seo.keyword_researcher" | "/ai/mandates/seo.keyword_serp_intent_analyst" | "/ai/mandates/seo.landscape_brief" | "/ai/mandates/seo.map_author" | "/ai/mandates/seo.map_curation" | "/ai/mandates/seo.money_map" | "/ai/mandates/seo.offering_extraction" | "/ai/mandates/seo.offering_valuation" | "/ai/mandates/seo.page_analyzer" | "/ai/mandates/seo.page_intent_proposer" | "/ai/mandates/seo.page_keyword_mapper" | "/ai/mandates/seo.page_mapper" | "/ai/mandates/seo.press_calendar_planner" | "/ai/mandates/seo.press_clip_reviewer" | "/ai/mandates/seo.press_headlines" | "/ai/mandates/seo.press_moment_researcher" | "/ai/mandates/seo.press_newsworthiness_check" | "/ai/mandates/seo.press_source_request_responder" | "/ai/mandates/seo.press_story_analyst" | "/ai/mandates/seo.press_strategist" | "/ai/mandates/seo.reputation_crisis_holding" | "/ai/mandates/seo.session_rule_writer" | "/ai/mandates/seo.session_stamp_proposer" | "/ai/mandates/seo.site_intake" | "/ai/mandates/seo.site_link_authority_router" | "/ai/mandates/seo.site_strategist" | "/ai/mandates/seo.starter_pack_proposer" | "/ai/mandates/seo.strategy.site_brief.generate" | "/ai/mandates/seo.topic_assigner" | "/ai/mandates/seo.topic_curation" | "/ai/mandates/shapes.write_picker_description" | "/ai/mandates/sms.owner_beta" | "/ai/mandates/social.post_breakdown" | "/ai/mandates/spaces.ask_page" | "/ai/mandates/spaces.autofill" | "/ai/mandates/spaces.build" | "/ai/mandates/spaces.design_database" | "/ai/mandates/spaces.move_in" | "/ai/mandates/spaces.writing_assist" | "/ai/mandates/start_page.maintainer" | "/ai/mandates/surfaces_client.binding_mapper" | "/ai/mandates/table.ask" | "/ai/mandates/table.column_fill" | "/ai/mandates/tasks.triage" | "/ai/mandates/tool_viz.component_generator" | "/ai/mandates/tools.summarize_content" | "/ai/mandates/transcript_studio.document_edit" | "/ai/mandates/transcript_studio.scribe_live" | "/ai/mandates/transcripts.clean_with_context" | "/ai/mandates/transcripts.clean_with_context_variable" | "/ai/mandates/transcripts.clean_without_context" | "/ai/mandates/vision_interview.adversary" | "/ai/mandates/vision_interview.amplifier" | "/ai/mandates/vision_interview.answer_tracker" | "/ai/mandates/vision_interview.archaeologist" | "/ai/mandates/vision_interview.architect" | "/ai/mandates/vision_interview.cartographer" | "/ai/mandates/vision_interview.requirements_author" | "/ai/mandates/vision_interview.scribe" | "/ai/mandates/vision_interview.sounding_board" | "/ai/mandates/vision_interview.transcript_cleaner" | "/ai/mandates/vision_interview.vision_author" | "/ai/mandates/voice.communicator" | "/ai/mandates/voice.gemini_live" | "/ai/mandates/voice.intro" | "/ai/mandates/voice.owner_beta" | "/ai/mandates/war_room.master" | "/ai/mandates/war_room.room" | "/ai/mandates/war_room.thread" | "/ai/mandates/web.endpoint_family_judge" | "/ai/mandates/workflow.complex_research.keyword_synthesis" | "/ai/mandates/workflow.complex_research.page_summary" | "/ai/mandates/workflow.complex_research.report" | "/ai/mandates/workflow.conductor" | "/ai/mandates/workflow.deep_research.keyword_synthesis" | "/ai/mandates/workflow.extract_namer" | "/ai/mandates/workflow.plan_design" | "/ai/mandates/workflow.plan_input_kind_authoring" | "/ai/mandates/workflow.plan_node_type_recommender" | "/ai/mandates/workflow.plan_notes_writer" | "/ai/mandates/workflow.plan_output_kind_authoring" | "/ai/mandates/workflow.recovery_advisor" | "/ai/mandates/workflow.run_assist_suggester" | "/ai/mandates/workflow.step_intelligence" | "/ai/mandates/workflow.steward" | "/ai/mandates/workflow.steward.agent_run" | "/ai/mandates/workflow.steward.data" | "/ai/mandates/workflow.steward.decision" | "/ai/mandates/workflow.steward.user_input" | "/ai/mandates/workflow.wizard.agent_run" | `/ai/mandates/${DynamicMandateKey}`;
+        readonly mandateStart: (mandateKey: MandateKey | DynamicMandateKey) => "/ai/mandates/agent_apps.prompt_app_dev" | "/ai/mandates/agent_factory.build" | "/ai/mandates/agent_factory.contract" | "/ai/mandates/agent_factory.instructions" | "/ai/mandates/agent_factory.proof_review" | "/ai/mandates/agent_factory.structure_builder" | "/ai/mandates/agent_factory.system_plan" | "/ai/mandates/agent_factory.tool_choice" | "/ai/mandates/agent_studio.chat_brief" | "/ai/mandates/ai.translation_cell_draft" | "/ai/mandates/alchemy.prepare_content" | "/ai/mandates/ambient.page_guidance" | "/ai/mandates/ambient.spoken_summary" | "/ai/mandates/applets.build" | "/ai/mandates/applets.fix" | "/ai/mandates/audio.live_music" | "/ai/mandates/audio.speech" | "/ai/mandates/brand.voice_rewrite" | "/ai/mandates/chat.cx_default" | "/ai/mandates/chat.default_new_chat" | "/ai/mandates/chat.quick_audio_plan" | "/ai/mandates/chat.quick_fair_news" | "/ai/mandates/chat.quick_flashcards" | "/ai/mandates/chat.quick_image" | "/ai/mandates/chat.quick_org_chart" | "/ai/mandates/chat.quick_research" | "/ai/mandates/chat.quick_showcase" | "/ai/mandates/chat.quick_writing_partner" | "/ai/mandates/chat.response_mode_brainstorm" | "/ai/mandates/chat.response_mode_data" | "/ai/mandates/chat.response_mode_research" | "/ai/mandates/chat.response_mode_video" | "/ai/mandates/checks.cleanup_bakeoff.answer" | "/ai/mandates/checks.cleanup_bakeoff.judge" | "/ai/mandates/checks.finding_disposition" | "/ai/mandates/checks.finding_disposition_review" | "/ai/mandates/cms.content_writing" | "/ai/mandates/cms.publish_review" | "/ai/mandates/cms.seo_metadata" | "/ai/mandates/cms.site_editing" | "/ai/mandates/cms.theme_design" | "/ai/mandates/code_editor.code_edit" | "/ai/mandates/code_editor.dynamic_context_edit" | "/ai/mandates/code_editor.prompt_app_ui_edit" | "/ai/mandates/coding_session.conversation_responder" | "/ai/mandates/coding_session.managed_translation_reference" | "/ai/mandates/commerce_intake.assess_value" | "/ai/mandates/commerce_intake.extract_vision" | "/ai/mandates/commerce_intake.grading" | "/ai/mandates/commerce_intake.instant_analysis" | "/ai/mandates/commerce_intake.refute_no_value" | "/ai/mandates/commerce_intake.research_product" | "/ai/mandates/commerce_intake.segment_photos" | "/ai/mandates/commerce_intake.verify_enrichment" | "/ai/mandates/content_gate.section_relevance_decision" | "/ai/mandates/content_ir.component_artisan" | "/ai/mandates/content_ir.kind_architect" | "/ai/mandates/content_ir.kind_component_builder" | "/ai/mandates/content_ir.kind_creator" | "/ai/mandates/content_plan.branch_purpose" | "/ai/mandates/content_plan.brief_writer" | "/ai/mandates/content_plan.deepen_page" | "/ai/mandates/content_plan.entity_attacher" | "/ai/mandates/content_plan.entity_curator" | "/ai/mandates/content_plan.family_namer" | "/ai/mandates/content_plan.keyword_strategist" | "/ai/mandates/content_plan.merge_wave" | "/ai/mandates/content_plan.p3_family" | "/ai/mandates/content_plan.p4_write" | "/ai/mandates/content_plan.p5_review" | "/ai/mandates/content_plan.p6_build" | "/ai/mandates/content_plan.p6_build.about" | "/ai/mandates/content_plan.p6_build.blog" | "/ai/mandates/content_plan.p6_build.comparison" | "/ai/mandates/content_plan.p6_build.contact" | "/ai/mandates/content_plan.p6_build.faq" | "/ai/mandates/content_plan.p6_build.guide" | "/ai/mandates/content_plan.p6_build.home" | "/ai/mandates/content_plan.p6_build.index" | "/ai/mandates/content_plan.p6_build.location" | "/ai/mandates/content_plan.p6_build.pillar" | "/ai/mandates/content_plan.p6_build.pricing" | "/ai/mandates/content_plan.p6_build.service" | "/ai/mandates/content_plan.plan_reviewer" | "/ai/mandates/content_plan.research_wave.audience_journey" | "/ai/mandates/content_plan.research_wave.competitor_coverage" | "/ai/mandates/content_plan.research_wave.keyword_value" | "/ai/mandates/content_plan.route_picker" | "/ai/mandates/content_plan.shape_planner" | "/ai/mandates/conversation.action_auditor" | "/ai/mandates/conversation.decision_ledger" | "/ai/mandates/conversation.drift_auditor" | "/ai/mandates/conversation.label_agent_run" | "/ai/mandates/conversation.label_chat" | "/ai/mandates/conversation.outcome_summarizer" | "/ai/mandates/conversation.vision_extractor" | "/ai/mandates/conversation.vision_interviewer" | "/ai/mandates/crm.journalist_beat_analyst" | "/ai/mandates/crm.media_list_ranker" | "/ai/mandates/crm.outreach_draft_reviewer" | "/ai/mandates/crm.outreach_fact_check" | "/ai/mandates/crm.outreach_personalization_coach" | "/ai/mandates/crm.outreach_personalization_writer" | "/ai/mandates/crm.outreach_pitch_writer" | "/ai/mandates/crm.outreach_recipient_shortlister" | "/ai/mandates/crm.outreach_reply_drafter" | "/ai/mandates/crm.outreach_strategy" | "/ai/mandates/crm.party_kind_judge" | "/ai/mandates/crm.save_contact" | "/ai/mandates/data.formula_writing" | "/ai/mandates/data.page_guidance" | "/ai/mandates/data.row_action" | "/ai/mandates/data.table_chat" | "/ai/mandates/desktop.cloud_chat" | "/ai/mandates/desktop.cloud_chat_advanced" | "/ai/mandates/desktop.cloud_chat_work" | "/ai/mandates/dictionary.workspace_guide" | "/ai/mandates/distillation.timeline_distiller" | "/ai/mandates/distillation.timeline_unfolder" | "/ai/mandates/docproc.content_structure" | "/ai/mandates/education.admin_guidance" | "/ai/mandates/education.analytics_narrate" | "/ai/mandates/education.audio_study_guidance" | "/ai/mandates/education.card_image_generator" | "/ai/mandates/education.card_image_prompt_writer" | "/ai/mandates/education.card_image_qc_judge" | "/ai/mandates/education.card_image_web_source" | "/ai/mandates/education.classes_guidance" | "/ai/mandates/education.creator_guidance" | "/ai/mandates/education.data_guidance" | "/ai/mandates/education.exam_prep_guidance" | "/ai/mandates/education.family_guidance" | "/ai/mandates/education.fastfire_guidance" | "/ai/mandates/education.features_guidance" | "/ai/mandates/education.flashcards_guidance" | "/ai/mandates/education.game_guidance" | "/ai/mandates/education.grade_handwritten" | "/ai/mandates/education.grade_work_guidance" | "/ai/mandates/education.kit_title" | "/ai/mandates/education.learn_guidance" | "/ai/mandates/education.levels_guidance" | "/ai/mandates/education.library_guidance" | "/ai/mandates/education.media_guidance" | "/ai/mandates/education.memory_generate" | "/ai/mandates/education.memory_guidance" | "/ai/mandates/education.memory_hint" | "/ai/mandates/education.mind_maps_guidance" | "/ai/mandates/education.mindmap_generate" | "/ai/mandates/education.notes_generate" | "/ai/mandates/education.notes_guidance" | "/ai/mandates/education.offline_guidance" | "/ai/mandates/education.page_guidance" | "/ai/mandates/education.plan_generate" | "/ai/mandates/education.planner_guidance" | "/ai/mandates/education.practice_oral_guidance" | "/ai/mandates/education.practice_tests_guidance" | "/ai/mandates/education.progress_guidance" | "/ai/mandates/education.quiz_deepen_item" | "/ai/mandates/education.quiz_generate" | "/ai/mandates/education.quiz_generate_from_source" | "/ai/mandates/education.quizzes_guidance" | "/ai/mandates/education.spoken_practice_design" | "/ai/mandates/education.spoken_practice_design_language" | "/ai/mandates/education.spoken_practice_grade" | "/ai/mandates/education.spoken_practice_grade_pronunciation" | "/ai/mandates/education.spoken_practice_review" | "/ai/mandates/education.start_guidance" | "/ai/mandates/education.study_aids_guidance" | "/ai/mandates/education.study_pack_flashcards" | "/ai/mandates/education.study_pack_lessons" | "/ai/mandates/education.study_pack_notes" | "/ai/mandates/education.study_pack_quiz" | "/ai/mandates/education.study_pack_v2_flashcards" | "/ai/mandates/education.study_pack_v2_lessons" | "/ai/mandates/education.study_pack_v2_notes" | "/ai/mandates/education.study_pack_v2_quiz" | "/ai/mandates/education.subjects_guidance" | "/ai/mandates/education.summaries_guidance" | "/ai/mandates/education.summarize" | "/ai/mandates/education.tutor_guidance" | "/ai/mandates/education.tutor_message" | "/ai/mandates/education.voice_tutor" | "/ai/mandates/evaluators.comparative_judge" | "/ai/mandates/evaluators.rubric_judge" | "/ai/mandates/extend.browser_chat" | "/ai/mandates/extend.pattern_from_data" | "/ai/mandates/extend.structured_extractor" | "/ai/mandates/feedback.item_triage_decision" | "/ai/mandates/flashcards.enrich_card" | "/ai/mandates/flashcards.expand_card" | "/ai/mandates/flashcards.fix_giveaway_cards" | "/ai/mandates/flashcards.generate_cards" | "/ai/mandates/flashcards.generate_from_source" | "/ai/mandates/flashcards.grade_spoken" | "/ai/mandates/flashcards.grade_typed_answer" | "/ai/mandates/flashcards.help_live" | "/ai/mandates/flashcards.helper_tts" | "/ai/mandates/flashcards.make_quiz_items" | "/ai/mandates/flashcards.micro_coach" | "/ai/mandates/flashcards.review_batch" | "/ai/mandates/flashcards.spoken_front_tts" | "/ai/mandates/flashcards.verify_against_source" | "/ai/mandates/foundry.planner" | "/ai/mandates/google.channel_video_plan" | "/ai/mandates/google.desk_work" | "/ai/mandates/google.traffic_change_explanation" | "/ai/mandates/growth_loop.quality_analyze" | "/ai/mandates/growth_loop.quality_brief" | "/ai/mandates/growth_loop.quality_crawl" | "/ai/mandates/growth_loop.quality_fill" | "/ai/mandates/growth_loop.quality_measure" | "/ai/mandates/growth_loop.quality_plan" | "/ai/mandates/growth_loop.quality_publish" | "/ai/mandates/growth_loop.quality_realize" | "/ai/mandates/growth_loop.quality_research" | "/ai/mandates/growth_loop.quality_serve" | "/ai/mandates/growth_loop.quality_suggest" | "/ai/mandates/growth_loop.quality_writeback" | "/ai/mandates/growth_loop.supervisor" | "/ai/mandates/hindsight.crystallizer" | "/ai/mandates/hindsight.replay_judge" | "/ai/mandates/hindsight.reviewer" | "/ai/mandates/human_decisions.fallback_decider" | "/ai/mandates/image.generate" | "/ai/mandates/image_pipeline.concept" | "/ai/mandates/image_pipeline.prompt_write" | "/ai/mandates/image_pipeline.qc_judge" | "/ai/mandates/iteration.architect" | "/ai/mandates/iteration.diagnostic" | "/ai/mandates/iteration.root_cause" | "/ai/mandates/iteration.thinking_display" | "/ai/mandates/kg.cluster_namer" | "/ai/mandates/kg.ner_extractor" | "/ai/mandates/knowledge.document_verifier" | "/ai/mandates/knowledge.qa_generator" | "/ai/mandates/knowledge.section_summarizer" | "/ai/mandates/local.answer_question" | "/ai/mandates/local.chat_persona_brainstorm" | "/ai/mandates/local.chat_persona_code_review" | "/ai/mandates/local.chat_persona_explain_simply" | "/ai/mandates/local.chat_persona_helpful" | "/ai/mandates/local.chat_persona_spoken_replies" | "/ai/mandates/local.chat_persona_summarize" | "/ai/mandates/local.chat_persona_transcript_polish" | "/ai/mandates/local.cloud_chat" | "/ai/mandates/local.cloud_chat_reply" | "/ai/mandates/local.confidential_chat" | "/ai/mandates/local.explain_code" | "/ai/mandates/local.extract_action_items" | "/ai/mandates/local.improve_writing" | "/ai/mandates/local.polish_style_action_items" | "/ai/mandates/local.polish_style_bullets" | "/ai/mandates/local.polish_style_custom" | "/ai/mandates/local.polish_style_formal" | "/ai/mandates/local.polish_style_light_cleanup" | "/ai/mandates/local.polish_style_meeting_notes" | "/ai/mandates/local.polish_style_standard" | "/ai/mandates/local.polish_transcript" | "/ai/mandates/local.raw_completion" | "/ai/mandates/local.summarize_text" | "/ai/mandates/local.tool_calling_chat" | "/ai/mandates/make.describe_template" | "/ai/mandates/mandate_outcome.goal_clause_extraction" | "/ai/mandates/mandate_outcome.goal_fitness_decision" | "/ai/mandates/mandates.holder_draft" | "/ai/mandates/marketing.endowment_analysis" | "/ai/mandates/marketing.endowment_portfolio" | "/ai/mandates/marketing.image_prompt" | "/ai/mandates/marketing.page_image" | "/ai/mandates/marketing.page_image_all_in_one" | "/ai/mandates/marketing.video_metadata" | "/ai/mandates/masterwork.approach_selector" | "/ai/mandates/masterwork.audition_judge" | "/ai/mandates/masterwork.bad_draft" | "/ai/mandates/masterwork.bad_example_probe" | "/ai/mandates/masterwork.case_oracle" | "/ai/mandates/masterwork.checkup_auditor" | "/ai/mandates/masterwork.coherence_partner" | "/ai/mandates/masterwork.conductor" | "/ai/mandates/masterwork.corpus_cleaner" | "/ai/mandates/masterwork.corpus_synthesizer" | "/ai/mandates/masterwork.counterparty" | "/ai/mandates/masterwork.critique_distiller" | "/ai/mandates/masterwork.draft_triage" | "/ai/mandates/masterwork.drip_distiller" | "/ai/mandates/masterwork.drip_question" | "/ai/mandates/masterwork.elicitation_judge" | "/ai/mandates/masterwork.exception_hunter" | "/ai/mandates/masterwork.exemplar_distiller" | "/ai/mandates/masterwork.faithfulness_judge" | "/ai/mandates/masterwork.intake_designer" | "/ai/mandates/masterwork.markup_distiller" | "/ai/mandates/masterwork.meeting_scavenger" | "/ai/mandates/masterwork.monologue_distiller" | "/ai/mandates/masterwork.outcome_judge" | "/ai/mandates/masterwork.pairwise_judge" | "/ai/mandates/masterwork.prediction_boundary" | "/ai/mandates/masterwork.prediction_distiller" | "/ai/mandates/masterwork.relationship_auditor" | "/ai/mandates/masterwork.rule_improver" | "/ai/mandates/masterwork.rulebook_auditor" | "/ai/mandates/masterwork.scout" | "/ai/mandates/masterwork.sealed_case_oracle" | "/ai/mandates/masterwork.sort_case_writer" | "/ai/mandates/masterwork.sort_distiller" | "/ai/mandates/masterwork.source_distiller" | "/ai/mandates/masterwork.teach_back_distiller" | "/ai/mandates/masterwork.teach_back_explainer" | "/ai/mandates/masterwork.template.chief_edit" | "/ai/mandates/masterwork.template.chief_generate" | "/ai/mandates/masterwork.template.editor" | "/ai/mandates/masterwork.template.maker" | "/ai/mandates/masterwork.timeline_distiller" | "/ai/mandates/masterwork.timeline_segmenter" | "/ai/mandates/masterwork.transcript_distiller" | "/ai/mandates/masterwork.transcript_shortlister" | "/ai/mandates/masterwork.triad_distiller" | "/ai/mandates/masterwork.triad_generator" | "/ai/mandates/masterwork.understudy" | "/ai/mandates/masterwork.unfolding_judge" | "/ai/mandates/masterworks.bench.a2_loop" | "/ai/mandates/masterworks.bench.calibration_decoy" | "/ai/mandates/masterworks.bench.consensus" | "/ai/mandates/masterworks.bench.extract" | "/ai/mandates/masterworks.bench.judge" | "/ai/mandates/masterworks.bench.panel" | "/ai/mandates/masterworks.bench.raw_arm" | "/ai/mandates/masterworks.vanilla_arm.answer_from_facts" | "/ai/mandates/masterworks.vanilla_arm.best_work" | "/ai/mandates/masterworks.vanilla_arm.outcome_case" | "/ai/mandates/masterworks.vanilla_arm.professional_help" | "/ai/mandates/media.youtube_analyzer" | "/ai/mandates/media_catalog.item_vetting_decision" | "/ai/mandates/meet.agenda_draft" | "/ai/mandates/meet.caption_translation" | "/ai/mandates/meet.live_intelligence" | "/ai/mandates/meet.live_notes" | "/ai/mandates/meet.pre_meeting_brief" | "/ai/mandates/meet.transcription" | "/ai/mandates/meet.wrap_up" | "/ai/mandates/memory.observer" | "/ai/mandates/memory.reflector" | "/ai/mandates/mermaid.diagram_editing" | "/ai/mandates/messaging.action_item_extraction" | "/ai/mandates/messaging.conversation_catch_up" | "/ai/mandates/messaging.conversation_summary" | "/ai/mandates/messaging.reply_drafting" | "/ai/mandates/messenger.answer_anything" | "/ai/mandates/models.availability_probe" | "/ai/mandates/ner.deep_chunk_extractor" | "/ai/mandates/ner.document_orienter" | "/ai/mandates/ner.entity_canonicalizer" | "/ai/mandates/ner.finisher" | "/ai/mandates/ner.item_proposer" | "/ai/mandates/ner.magic_moment_detector" | "/ai/mandates/ner.scope_proposer" | "/ai/mandates/ner.scope_slot_filler" | "/ai/mandates/ner.suggestion_reviewer" | "/ai/mandates/ner.sweep_scope_discoverer" | "/ai/mandates/ner.sweep_scope_reference_finder" | "/ai/mandates/ner.sweep_value_miner" | "/ai/mandates/news.angles" | "/ai/mandates/news.coarse_relevance" | "/ai/mandates/news.monitor_setup_proposer" | "/ai/mandates/news.report" | "/ai/mandates/news.story_origin" | "/ai/mandates/news.triage" | "/ai/mandates/notes.organizer" | "/ai/mandates/notes.page_guidance" | "/ai/mandates/observability.tool_trace_pattern_detection" | "/ai/mandates/observability.tool_trace_triage" | "/ai/mandates/orchestras.role_describer" | "/ai/mandates/orchestration.tool_failure_standoff_decision" | "/ai/mandates/org_chart.seat_job_suggester" | "/ai/mandates/pdf.chunk_clean_ocr_text" | "/ai/mandates/pdf.chunk_flashcards_json" | "/ai/mandates/pdf.chunk_flashcards_typescript" | "/ai/mandates/pdf.content_cleaner" | "/ai/mandates/personal_staff.escalation" | "/ai/mandates/personal_staff.front_line" | "/ai/mandates/podcast.audience_adapter" | "/ai/mandates/podcast.audio_dialogue" | "/ai/mandates/podcast.audio_english" | "/ai/mandates/podcast.audio_persian" | "/ai/mandates/podcast.chapter_marker" | "/ai/mandates/podcast.content_extractor" | "/ai/mandates/podcast.deep_research" | "/ai/mandates/podcast.image_v1" | "/ai/mandates/podcast.image_v2" | "/ai/mandates/podcast.image_v3" | "/ai/mandates/podcast.image_v4" | "/ai/mandates/podcast.image_v5" | "/ai/mandates/podcast.image_v6_feature" | "/ai/mandates/podcast.image_v6_feature_prompt" | "/ai/mandates/podcast.live_rewrite" | "/ai/mandates/podcast.metadata" | "/ai/mandates/podcast.multihost_script" | "/ai/mandates/podcast.post_prep_expansion" | "/ai/mandates/podcast.post_prep_fact_checking" | "/ai/mandates/podcast.post_prep_summarization" | "/ai/mandates/podcast.post_prep_translation" | "/ai/mandates/podcast.race_frontier" | "/ai/mandates/podcast.relevance_gate" | "/ai/mandates/podcast.roundtable_script" | "/ai/mandates/podcast.script_educational" | "/ai/mandates/podcast.script_news" | "/ai/mandates/podcast.script_persian" | "/ai/mandates/podcast.solo_script" | "/ai/mandates/podcast.title_optimizer" | "/ai/mandates/podcast.video_v1" | "/ai/mandates/podcast.video_v2" | "/ai/mandates/podcast_client.blog_writer" | "/ai/mandates/podcast_client.show_notes" | "/ai/mandates/podcast_client.topic_ideas" | "/ai/mandates/podcast_client.web_content_extractor" | "/ai/mandates/podcast_client.youtube_research" | "/ai/mandates/product_capture.instant_analysis" | "/ai/mandates/projects.creation_guide" | "/ai/mandates/proof_runs.judge" | "/ai/mandates/purpose.writer" | "/ai/mandates/rag.chunk_contextualizer" | "/ai/mandates/rag.grounded_synthesis" | "/ai/mandates/rag.grounding_claim_extract" | "/ai/mandates/rag.grounding_judge" | "/ai/mandates/rag.hyde_generator" | "/ai/mandates/rag.image_caption" | "/ai/mandates/rag.pdf_page_cleaner" | "/ai/mandates/rag.query_expander" | "/ai/mandates/rag_kinds.grounded_synthesis" | "/ai/mandates/records.enrichment" | "/ai/mandates/research.auto_tagger" | "/ai/mandates/research.condenser_1" | "/ai/mandates/research.condenser_2" | "/ai/mandates/research.coverage_audit" | "/ai/mandates/research.cross_cutting_tags" | "/ai/mandates/research.document_assembly" | "/ai/mandates/research.keyword_synthesis" | "/ai/mandates/research.report" | "/ai/mandates/research.report_updater" | "/ai/mandates/research.source_authority" | "/ai/mandates/research.source_triage_decision" | "/ai/mandates/research.structured_page_summary" | "/ai/mandates/research.suggest_setup" | "/ai/mandates/research.tag_consolidation" | "/ai/mandates/research.topic_deep_research" | "/ai/mandates/research_client.output_blog" | "/ai/mandates/research_client.output_brand_card" | "/ai/mandates/research_client.output_brand_profile" | "/ai/mandates/research_client.output_competitive_landscape" | "/ai/mandates/research_client.output_gap_analysis" | "/ai/mandates/research_client.output_literature_review" | "/ai/mandates/research_client.output_reputation_business" | "/ai/mandates/research_client.output_reputation_personal" | "/ai/mandates/research_client.output_seo" | "/ai/mandates/research_client.output_slides" | "/ai/mandates/scraper.fact_check" | "/ai/mandates/scraper.keyword_analysis" | "/ai/mandates/scraper.page_fetch_verdict" | "/ai/mandates/seo.ai_visibility_blind_question_writer" | "/ai/mandates/seo.ai_visibility_buyer_jobs" | "/ai/mandates/seo.ai_visibility_decision_analyst" | "/ai/mandates/seo.ai_visibility_evidence_icp" | "/ai/mandates/seo.ai_visibility_panel_designer" | "/ai/mandates/seo.ai_visibility_panel_report" | "/ai/mandates/seo.ai_visibility_question_architect" | "/ai/mandates/seo.ai_visibility_question_qa" | "/ai/mandates/seo.ai_visibility_writing_audit" | "/ai/mandates/seo.backlink_analysis" | "/ai/mandates/seo.backlink_context_assessor" | "/ai/mandates/seo.backlink_work_planner" | "/ai/mandates/seo.business_model_verdict" | "/ai/mandates/seo.competitor_classifier" | "/ai/mandates/seo.competitor_opportunity_autopsy" | "/ai/mandates/seo.competitor_page_autopsy" | "/ai/mandates/seo.coverage_analyst" | "/ai/mandates/seo.digital_pr_reputation_adjudicator" | "/ai/mandates/seo.evidence_workbench" | "/ai/mandates/seo.finding_fixer" | "/ai/mandates/seo.guidelines_drafter" | "/ai/mandates/seo.ideal_customer_profile" | "/ai/mandates/seo.keyword_classifier" | "/ai/mandates/seo.keyword_expander" | "/ai/mandates/seo.keyword_researcher" | "/ai/mandates/seo.keyword_serp_intent_analyst" | "/ai/mandates/seo.landscape_brief" | "/ai/mandates/seo.map_author" | "/ai/mandates/seo.map_curation" | "/ai/mandates/seo.money_map" | "/ai/mandates/seo.offering_extraction" | "/ai/mandates/seo.offering_valuation" | "/ai/mandates/seo.page_analyzer" | "/ai/mandates/seo.page_intent_proposer" | "/ai/mandates/seo.page_keyword_mapper" | "/ai/mandates/seo.page_mapper" | "/ai/mandates/seo.press_calendar_planner" | "/ai/mandates/seo.press_clip_reviewer" | "/ai/mandates/seo.press_headlines" | "/ai/mandates/seo.press_moment_researcher" | "/ai/mandates/seo.press_newsworthiness_check" | "/ai/mandates/seo.press_source_request_responder" | "/ai/mandates/seo.press_story_analyst" | "/ai/mandates/seo.press_strategist" | "/ai/mandates/seo.reputation_crisis_holding" | "/ai/mandates/seo.session_rule_writer" | "/ai/mandates/seo.session_stamp_proposer" | "/ai/mandates/seo.site_intake" | "/ai/mandates/seo.site_link_authority_router" | "/ai/mandates/seo.site_strategist" | "/ai/mandates/seo.starter_pack_proposer" | "/ai/mandates/seo.strategy.site_brief.generate" | "/ai/mandates/seo.topic_assigner" | "/ai/mandates/seo.topic_curation" | "/ai/mandates/shapes.write_picker_description" | "/ai/mandates/sms.owner_beta" | "/ai/mandates/social.post_breakdown" | "/ai/mandates/spaces.ask_page" | "/ai/mandates/spaces.autofill" | "/ai/mandates/spaces.build" | "/ai/mandates/spaces.design_database" | "/ai/mandates/spaces.move_in" | "/ai/mandates/spaces.writing_assist" | "/ai/mandates/start_page.maintainer" | "/ai/mandates/surfaces_client.binding_mapper" | "/ai/mandates/table.ask" | "/ai/mandates/table.column_fill" | "/ai/mandates/tasks.triage" | "/ai/mandates/tool_viz.component_generator" | "/ai/mandates/tools.summarize_content" | "/ai/mandates/transcript_studio.document_edit" | "/ai/mandates/transcript_studio.scribe_live" | "/ai/mandates/transcripts.clean_with_context" | "/ai/mandates/transcripts.clean_with_context_variable" | "/ai/mandates/transcripts.clean_without_context" | "/ai/mandates/vision_interview.adversary" | "/ai/mandates/vision_interview.amplifier" | "/ai/mandates/vision_interview.answer_tracker" | "/ai/mandates/vision_interview.archaeologist" | "/ai/mandates/vision_interview.architect" | "/ai/mandates/vision_interview.cartographer" | "/ai/mandates/vision_interview.requirements_author" | "/ai/mandates/vision_interview.scribe" | "/ai/mandates/vision_interview.sounding_board" | "/ai/mandates/vision_interview.transcript_cleaner" | "/ai/mandates/vision_interview.vision_author" | "/ai/mandates/voice.communicator" | "/ai/mandates/voice.gemini_live" | "/ai/mandates/voice.intro" | "/ai/mandates/voice.owner_beta" | "/ai/mandates/war_room.master" | "/ai/mandates/war_room.room" | "/ai/mandates/war_room.thread" | "/ai/mandates/web.endpoint_family_judge" | "/ai/mandates/workflow.complex_research.keyword_synthesis" | "/ai/mandates/workflow.complex_research.page_summary" | "/ai/mandates/workflow.complex_research.report" | "/ai/mandates/workflow.conductor" | "/ai/mandates/workflow.deep_research.keyword_synthesis" | "/ai/mandates/workflow.extract_namer" | "/ai/mandates/workflow.plan_design" | "/ai/mandates/workflow.plan_input_kind_authoring" | "/ai/mandates/workflow.plan_node_type_recommender" | "/ai/mandates/workflow.plan_notes_writer" | "/ai/mandates/workflow.plan_output_kind_authoring" | "/ai/mandates/workflow.recovery_advisor" | "/ai/mandates/workflow.run_assist_suggester" | "/ai/mandates/workflow.step_intelligence" | "/ai/mandates/workflow.steward" | "/ai/mandates/workflow.steward.agent_run" | "/ai/mandates/workflow.steward.data" | "/ai/mandates/workflow.steward.decision" | "/ai/mandates/workflow.steward.user_input" | "/ai/mandates/workflow.wizard.agent_run" | `/ai/mandates/${DynamicMandateKey}`;
         /**
          * POST — Continue any existing conversation (Guest OK)
          * POST /ai/conversations/{conversationId}
@@ -2846,4 +2795,4 @@ declare const ENDPOINTS: {
     };
 };
 
-export { type ApiTargetLogContext, 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, 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, applyDesktopTargetToRequestBody, 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, logApiTarget, 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_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 };