@ai-matrx/api 0.0.0-stage → 0.1.1

package/dist/agents.d.cts

@@ -0,0 +1,3417 @@
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, J as JsonOrStream } from './index-wC2vtb70.cjs';
+import { JsonValue, ContextAnchor, TextPart, ThinkingPart, ToolCallPart, ToolResultPart, UserImageMediaPart, UserAudioMediaPart, UserVideoMediaPart, UserDocumentMediaPart, UserYouTubeMediaPart, CodeExecPart, CodeResultPart, WebSearchPart, WebpageInputPart, NotesInputPart, TaskInputPart, AgentInputPart, ProjectInputPart, AgentAppInputPart, TranscriptInputPart, TranscriptSessionInputPart, WorkbookInputPart, DocumentInputPart, TableInputPart, ListInputPart, DataInputPart, ContextInputPart, RemarksInputPart, DecisionQuestionsPart, DecisionAnswersPart, SpeechScriptPart, LLMParams, AgentStartRequest, DirectiveItemApplied, DirectiveItemFailed, PageContext, RegisteredToolSpec, InlineToolSpec, AgentToolSpec, ClientContext, UserOverrides, ActionNeeded, PromptStartRequest } from './schemas.cjs';
+import './credentials.cjs';
+
+/**
+ * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
+ * CONTRACT_SHA256 50a790edb39e682b46e0fa9e674faf5ce2a0ba7de2cd01930a497fca4c47844a
+ */
+
+/** AgentBlocksStartRequest */
+type AgentBlocksStartRequest = {
+    /** Organization explicitly selected for this new AI conversation. Required except for fingerprint guests, whose organization is resolved by the AI funnel. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    /** Active context-scope ids selected by the caller and membership-validated server-side. */
+    scope_ids?: string[] | null;
+    /** Active scope-type ids selected by the caller (type-level selection with no specific scope chosen). */
+    active_scope_type_ids?: string[] | null;
+    /** Durable resource identity from which authoritative organization and task context is reloaded. */
+    context_anchor?: ContextAnchor | null;
+    store: boolean;
+    /** Specific connected desktop instance allowed to claim delegated local tools. */
+    target_instance_id?: string | null;
+    conversation_id: string;
+    is_new: boolean;
+    user_input?: string | ((TextPart | ThinkingPart | ToolCallPart | ToolResultPart | (UserImageMediaPart | UserAudioMediaPart | UserVideoMediaPart | UserDocumentMediaPart | UserYouTubeMediaPart) | CodeExecPart | CodeResultPart | WebSearchPart | WebpageInputPart | NotesInputPart | TaskInputPart | AgentInputPart | ProjectInputPart | AgentAppInputPart | TranscriptInputPart | TranscriptSessionInputPart | WorkbookInputPart | DocumentInputPart | TableInputPart | ListInputPart | DataInputPart | ContextInputPart | RemarksInputPart | DecisionQuestionsPart | DecisionAnswersPart | SpeechScriptPart)[]) | null;
+    variables?: {
+        [key: string]: unknown;
+    } | null;
+    config_overrides?: LLMParams | null;
+    stream?: boolean;
+    debug?: boolean;
+};
+/** An optional named context object the agent's context system fills. */
+type AgentContextPolicy = {
+    /** Mandate key; content is passed to the run under this key. */
+    key: string;
+    /** Context object type (document / text / …). */
+    type?: string;
+    /** Human label for the slot. */
+    label?: string | null;
+    /** What this slot holds. */
+    description?: string | null;
+    /** Agent may ctx_patch this slot. */
+    mutable?: boolean | null;
+    /** auto | never | client. */
+    persist?: string | null;
+    /** The agent layer's inline limit for this key (0 = never inline); resolved with the page's and the person's by the context gate. */
+    max_inline_chars?: number | null;
+    /** Agent that writes this slot's summary on request. */
+    summary_agent_id?: string | null;
+    [key: string]: unknown;
+};
+/** Everything a caller needs to invoke an agent correctly. */
+type AgentDetail = {
+    id: string;
+    /** Owning agent definition id; equals id for a live definition and names the parent for a version snapshot. */
+    agent_id?: string;
+    name: string;
+    description?: string;
+    agent_type?: string;
+    category?: string | null;
+    tags?: string[];
+    is_active?: boolean;
+    version?: number;
+    model_id?: string | null;
+    /** The canonical authored agent messages. Runtime-injected skill/tool preambles are not persisted here. */
+    messages?: {
+        [key: string]: JsonValue;
+    }[];
+    variables?: AgentVariableDetail[];
+    variable_definitions?: AgentVariableDefinition[];
+    context_policies?: AgentContextPolicy[];
+    output_schema?: {
+        [key: string]: JsonValue;
+    } | null;
+    settings?: {
+        [key: string]: JsonValue;
+    };
+    /** The agent's executable tools as canonical NAMES — rendered from the authoritative agent.definition.tools column the executor reads (NOT from tool_config, which never assigns tools). */
+    tools?: string[];
+    tool_config?: {
+        [key: string]: JsonValue;
+    };
+    skill_config?: {
+        [key: string]: JsonValue;
+    };
+};
+/** AgentFromChatRequest */
+type AgentFromChatRequest = {
+    /** The chat to turn into an agent. */
+    conversation_id: string;
+    /** Person-supplied example inputs (R52). On the Agent Factory path each is one more proof case beside the chat's own request; the legacy builder ignores them. */
+    examples?: string[];
+};
+/** WHO an agent belongs to — the Expert who built it. */
+type AgentOwnership = {
+    /** auth.users id of the Expert this agent belongs to. */
+    user_id: string;
+    /** The organization this agent is born in — READ off the caller's request context or the record being processed, never defaulted. NULL org is never 'global'. */
+    organization_id: string;
+};
+/** The in-memory build request the Agent Service constructs from the */
+type AgentSpec = {
+    name: string;
+    title?: string;
+    display_name?: string | null;
+    summary?: string;
+    purpose?: string;
+    variables?: SpecVariable[];
+    response_format?: string;
+    sample_inputs?: string;
+    grading_rubric?: string;
+    model_guidance?: string;
+    model_profile?: ("balanced" | "strongest") | null;
+    model_id?: string | null;
+    output_json_schema?: JsonValue;
+    tools?: string[];
+    owner?: AgentOwnership | null;
+    [key: string]: unknown;
+};
+/** Lightweight catalog row. */
+type AgentSummary = {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string | null;
+    tags?: string[];
+    agent_type?: string;
+    version?: number;
+    orchestra?: OrchestraBadge | null;
+};
+/** AgentTestBatchRequest */
+type AgentTestBatchRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    exemplar_ids?: string[] | null;
+    include_candidates?: boolean;
+};
+/** AgentTestBatchResponse */
+type AgentTestBatchResponse = {
+    agent_id: string;
+    exemplar_count: number;
+    results: AgentTestResult[];
+};
+/** One test run of one exemplar, persisted on the exemplar's metadata. */
+type AgentTestResult = {
+    id?: string;
+    created_at?: string;
+    agent_id: string;
+    exemplar_id: string;
+    exemplar_label: string;
+    output?: string;
+    parsed?: {
+        [key: string]: JsonValue;
+    } | JsonValue[] | null;
+    usage?: {
+        [key: string]: JsonValue;
+    };
+    model_id?: string | null;
+    duration_ms?: number;
+    error?: string | null;
+};
+/** Bind a variable to a model control (controls as first-class variables). */
+type AgentVariableControlInput = {
+    /** The model control this variable sets for the run (e.g. 'temperature', 'aspect_ratio', 'voice'). Pick one the chosen model exposes AND your organization lets callers bind — agent_catalog list_models re */
+    key: string;
+};
+/** Full variable definition — the shape the FE VariableInputComponent renders. */
+type AgentVariableDefinition = {
+    /** Variable name the agent template references as {{name}}. */
+    name: string;
+    /** What the person called the variable ("Normal Text"); screens show it. Absent → screens humanize `name`. */
+    label?: string | null;
+    /** Pre-filled value if the caller provides none. */
+    defaultValue?: JsonValue;
+    /** Help text shown under the field. */
+    helpText?: string | null;
+    /** Must be provided before the agent runs. */
+    required?: boolean;
+    /** UI input component config (defaults to a textarea). */
+    customComponent?: VariableComponentSpec | null;
+    /** When set, the variable is filled at run time: from a scope context item (inherits its component), or — kind 'merge_field' — by a merge field. */
+    binding?: MergeFieldBinding | ContextItemBinding | null;
+    /** When set, this variable is a model control exposed as an input: its resolved value is sent as that control (controls as first-class variables). */
+    control?: ControlBinding | null;
+    [key: string]: unknown;
+};
+/** AgentVariableDetail */
+type AgentVariableDetail = {
+    name: string;
+    label?: string | null;
+    description?: string;
+    required?: boolean;
+    default_value?: string;
+};
+/** AgentVariableInput */
+type AgentVariableInput = {
+    /** Variable name the agent template references. */
+    name: string;
+    /** The person-facing name screens show for this variable ("Normal Text"). Omit and screens humanize `name`. */
+    label?: string | null;
+    /** What this variable contains. */
+    description?: string;
+    /** The variable's default. For a control-bound variable this IS the agent's own value for that control (the setting is not written separately). */
+    default_value?: string;
+    /** Bind this variable to a model control: {"key": "aspect_ratio"}. */
+    control?: AgentVariableControlInput | null;
+};
+/** AgentVersionInfo */
+type AgentVersionInfo = {
+    id: string;
+    agent_id: string;
+    version_number: number;
+    name?: string;
+    change_note?: string | null;
+    changed_at?: string | null;
+};
+/** BuildResponse */
+type BuildResponse = {
+    build_id: string;
+    execution_status: string;
+    state?: {
+        [key: string]: JsonValue;
+    } | null;
+};
+/** BuiltinPromptCatalogResponse */
+type BuiltinPromptCatalogResponse = {
+    builtins: AgentSummary[];
+    count: number;
+};
+/** CacheBustResponse */
+type CacheBustResponse = {
+    cleared: string[];
+    tool_registry_count: number;
+    timestamp: string;
+};
+/** CatalogRpcRequest */
+type CatalogRpcRequest = {
+    /** Must be 'agx_get_list_full' */
+    fn: string;
+    args?: {
+        [key: string]: unknown;
+    } | null;
+};
+/** Faceted catalog view: distinct categories + tag counts + the agents. */
+type CatalogTree = {
+    total: number;
+    categories?: {
+        [key: string]: number;
+    };
+    tags?: {
+        [key: string]: number;
+    };
+    agents?: AgentSummary[];
+};
+/** POST /skills/categories body. `user_id` is forced server-side: when */
+type CategoryCreate = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    category_key: string;
+    label: string;
+    description?: string | null;
+    icon_name?: string | null;
+    color?: string | null;
+    parent_category_id?: string | null;
+    sort_order?: number;
+    is_system?: boolean;
+};
+/** CategoryList */
+type CategoryList = {
+    count: number;
+    categories: CategoryRow[];
+};
+/** PATCH /skills/categories/{id} body. All fields optional. */
+type CategoryPatch = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    category_key?: string | null;
+    label?: string | null;
+    description?: string | null;
+    icon_name?: string | null;
+    color?: string | null;
+    parent_category_id?: string | null;
+    sort_order?: number | null;
+    is_active?: boolean | null;
+};
+/** CategoryRow */
+type CategoryRow = {
+    id: string;
+    category_key: string;
+    label: string;
+    description?: string | null;
+    icon_name?: string | null;
+    color?: string | null;
+    parent_category_id?: string | null;
+    sort_order?: number;
+    is_active?: boolean;
+};
+/** CellRef */
+type CellRef = {
+    row_id: string;
+    column_id: string;
+    repeat?: number;
+};
+/** Clearance */
+type Clearance = "public" | "internal" | "restricted" | "privileged";
+/** CodeDeclaration */
+type CodeDeclaration = {
+    name: string;
+    function_path: string;
+    executor?: string | null;
+    validate_enabled?: boolean;
+    deprecated?: boolean;
+    parameters?: JsonValue;
+};
+/** CombinedPromptCatalogResponse */
+type CombinedPromptCatalogResponse = {
+    prompts: AgentSummary[];
+    builtins: AgentSummary[];
+    total_count: number;
+};
+/** ContextAnswer */
+type ContextAnswer = {
+    path: "old" | "new";
+    answer?: string | null;
+    error?: string | null;
+    model?: string | null;
+    duration_ms?: number | null;
+    input_tokens?: number | null;
+    output_tokens?: number | null;
+    system_sha256?: string | null;
+    system_byte_length?: number | null;
+    context_sha256?: string | null;
+    provenance?: ContextProvenance | null;
+};
+/** One question, answered once from each resolver (lane SC-3', P9 "answer on both paths"). */
+type ContextAnswerBothRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    /** Active context-scope ids selected by the caller and membership-validated server-side. */
+    scope_ids?: string[] | null;
+    /** Active scope-type ids selected by the caller (type-level selection with no specific scope chosen). */
+    active_scope_type_ids?: string[] | null;
+    /** Durable resource identity from which authoritative organization and task context is reloaded. */
+    context_anchor?: ContextAnchor | null;
+    /** Persist request outputs when true; run ephemerally when false. */
+    store?: boolean;
+    /** Specific connected desktop instance allowed to claim delegated local tools. */
+    target_instance_id?: string | null;
+    conversation_id?: string | null;
+    agent_id?: string | null;
+    entity_is_new?: boolean | null;
+    path?: "old" | "new" | "both";
+    selection?: ContextSelection | null;
+    context?: {
+        [key: string]: ContextEnvelope | JsonValue;
+    } | null;
+    /** The context keys the client withheld this turn (off by the page, the agent or the person's rule). When sent, the context receipt lists saved-rule rows only for these keys; omitted, it lists every save */
+    context_withheld?: string[] | null;
+    surface?: string | null;
+    /** This conversation is the page's own (mode 'own') or the person switched the page off (mode 'off'): the page's values, the screens around it and what identifies the conversation are withheld by the con */
+    page_context?: PageContext | null;
+    /** The surface whose page published each context value that the primary surface (client.surface) does not declare: a screen mounted inside the page (a transcript open on the Knowledge page). Sent or with */
+    context_surfaces?: {
+        [key: string]: string;
+    } | null;
+    view?: ContextViewTarget | null;
+    question: string;
+};
+/** ContextAnswerBothResponse */
+type ContextAnswerBothResponse = {
+    question: string;
+    agent_id: string;
+    compare: ContextCompare;
+    answers: ContextAnswer[];
+    says: string;
+};
+/** ContextCompare */
+type ContextCompare = {
+    ruling?: string;
+    selection: ContextCompareSelection;
+    old: ContextCompareSide;
+    new: ContextCompareSide;
+    differences?: ContextCompareDifference[];
+    counts?: {
+        [key: string]: number;
+    };
+    identical_cells?: number;
+    defects?: number;
+    follow: ContextFollowLag;
+    excluded?: string[];
+    system_items?: ContextSystemItems;
+};
+/** One record the new path considered, and what it decided for this person. */
+type ContextCompareCheck = {
+    record_id: string;
+    via: string;
+    admitted: boolean;
+    reason?: string | null;
+    says?: string | null;
+    organization_id?: string | null;
+    name?: string | null;
+};
+/** ContextCompareDifference */
+type ContextCompareDifference = {
+    item_id: string;
+    key: string;
+    scope_id?: string | null;
+    scope_name?: string | null;
+    old_value?: JsonValue | null;
+    new_value?: JsonValue | null;
+    old_tier?: string | null;
+    new_tier?: string | null;
+    difference_class: "copy lag" | "declared tier move" | "old path delivered without a check" | "defect";
+    why: string;
+};
+/** What BOTH resolvers are handed for one compare — identical on both sides. */
+type ContextCompareSelection = {
+    depth: "organization" | "scope_type" | "scope" | "context_item" | "active";
+    organization_id?: string | null;
+    scope_type_ids?: string[];
+    scope_ids?: string[];
+    context_item_id?: string | null;
+    system_item_ids?: string[];
+};
+/** ContextCompareSide */
+type ContextCompareSide = {
+    path: "old" | "new";
+    available?: boolean;
+    unavailable_reason?: string | null;
+    block?: string | null;
+    block_sha256?: string | null;
+    value_fingerprint?: string | null;
+    scope_ids?: string[];
+    scope_labels?: {
+        [key: string]: JsonValue;
+    };
+    direct?: {
+        [key: string]: JsonValue;
+    };
+    tool_accessible?: {
+        [key: string]: JsonValue;
+    };
+    searchable?: {
+        [key: string]: JsonValue;
+    };
+    cell_values?: {
+        [key: string]: JsonValue;
+    };
+    checks?: ContextCompareCheck[];
+    withheld?: {
+        [key: string]: JsonValue;
+    }[];
+    resolve_ms?: number | null;
+};
+/** Which layer decided each knob of one context value. */
+type ContextDecidedBy = {
+    include: "default" | "page" | "agent" | "you";
+    max_inline_chars: "default" | "page" | "agent" | "you";
+};
+/** What the model gets today beside what it would get from the record store (lane INSPECTOR-DIFF). */
+type ContextDelivered = {
+    today: ContextDeliveredSide;
+    record_store?: ContextDeliveredSide | null;
+    identical?: boolean | null;
+    arguments?: {
+        [key: string]: JsonValue;
+    };
+    says: string;
+};
+/** What the model read for one value or block, by SIZE and HASH only — never the text */
+type ContextDeliveredRef = {
+    chars: number;
+    sha256: string;
+};
+/** One side's context EXACTLY as the model is fed it — the run path's assembler's bytes. */
+type ContextDeliveredSide = {
+    path: "today" | "record_store";
+    available?: boolean;
+    unavailable_reason?: string | null;
+    intro?: string | null;
+    active?: string | null;
+    injected_block?: string | null;
+    block_sha256?: string | null;
+    block_byte_length?: number | null;
+    provenance?: ContextProvenance | null;
+};
+/** The rich per-value form a client may send in ``context`` instead of a bare value. */
+type ContextEnvelope = {
+    content?: JsonValue;
+    type?: string | null;
+    label?: string | null;
+    description?: string | null;
+    mutable?: boolean | null;
+    persist?: ("auto" | "never" | "client") | null;
+    source?: {
+        [key: string]: JsonValue;
+    } | null;
+    max_inline_chars?: number | null;
+    default_max_inline_chars?: number | null;
+    summary_agent_id?: string | null;
+};
+/** ContextFollowLag */
+type ContextFollowLag = {
+    running?: boolean;
+    pending?: number;
+    oldest_pending_at?: string | null;
+    last_applied_at?: string | null;
+    alert?: boolean;
+    alert_after_seconds?: number | null;
+    says: string;
+};
+/** Binds a variable to a scope context item; it inherits that item's component. */
+type ContextItemBinding = {
+    /** ctx_context_items.id supplying the value. */
+    contextItemId: string;
+    /** Scope type whose active scope supplies the value. */
+    scopeTypeId: string;
+    /** The item's machine key resolved against the active scope. */
+    itemKey: string;
+    /** empty | skip | error when no active scope supplies it. */
+    onMissing?: string | null;
+    [key: string]: unknown;
+};
+/** ContextOrganizationOption */
+type ContextOrganizationOption = {
+    id: string;
+    name: string;
+    slug: string;
+};
+/** ContextOrganizationsResponse */
+type ContextOrganizationsResponse = {
+    organizations: ContextOrganizationOption[];
+};
+/** ContextPreviewBindings */
+type ContextPreviewBindings = {
+    variables?: {
+        [key: string]: JsonValue;
+    };
+    context?: {
+        [key: string]: JsonValue;
+    };
+    picklist_bindings?: {
+        [key: string]: {
+            [key: string]: JsonValue;
+        };
+    };
+    traces?: {
+        [key: string]: JsonValue;
+    }[];
+};
+/** One selected id that did NOT reach the agent, and why, in words. */
+type ContextPreviewRefusal = {
+    id: string;
+    kind: string;
+    reason: string;
+    message: string;
+};
+/** ContextPreviewRequest */
+type ContextPreviewRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    /** Active context-scope ids selected by the caller and membership-validated server-side. */
+    scope_ids?: string[] | null;
+    /** Active scope-type ids selected by the caller (type-level selection with no specific scope chosen). */
+    active_scope_type_ids?: string[] | null;
+    /** Durable resource identity from which authoritative organization and task context is reloaded. */
+    context_anchor?: ContextAnchor | null;
+    /** Persist request outputs when true; run ephemerally when false. */
+    store?: boolean;
+    /** Specific connected desktop instance allowed to claim delegated local tools. */
+    target_instance_id?: string | null;
+    conversation_id?: string | null;
+    agent_id?: string | null;
+    entity_is_new?: boolean | null;
+    path?: "old" | "new" | "both";
+    selection?: ContextSelection | null;
+    context?: {
+        [key: string]: ContextEnvelope | JsonValue;
+    } | null;
+    /** The context keys the client withheld this turn (off by the page, the agent or the person's rule). When sent, the context receipt lists saved-rule rows only for these keys; omitted, it lists every save */
+    context_withheld?: string[] | null;
+    surface?: string | null;
+    /** This conversation is the page's own (mode 'own') or the person switched the page off (mode 'off'): the page's values, the screens around it and what identifies the conversation are withheld by the con */
+    page_context?: PageContext | null;
+    /** The surface whose page published each context value that the primary surface (client.surface) does not declare: a screen mounted inside the page (a transcript open on the Knowledge page). Sent or with */
+    context_surfaces?: {
+        [key: string]: string;
+    } | null;
+    view?: ContextViewTarget | null;
+};
+/** ContextPreviewResponse */
+type ContextPreviewResponse = {
+    injected_block: string | null;
+    block_producer: string | null;
+    block_sha256: string | null;
+    block_byte_length: number | null;
+    organization_id: string | null;
+    scope_ids: string[];
+    scope_labels: {
+        [key: string]: JsonValue;
+    };
+    variables: ContextPreviewVariables;
+    cell_values: {
+        [key: string]: JsonValue;
+    };
+    bindings: ContextPreviewBindings | null;
+    selection: ContextPreviewSelection;
+    entity_type: string;
+    entity_id: string;
+    entity_is_new: boolean;
+    path?: "old" | "new" | "both";
+    compare?: ContextCompare | null;
+    provenance?: ContextProvenance | null;
+    delivered?: ContextDelivered | null;
+    receipt?: ContextReceipt | null;
+    viewed?: ContextViewedText | null;
+};
+/** What the caller asked for vs. what this turn actually resolved. */
+type ContextPreviewSelection = {
+    organization_id?: string | null;
+    organization_name?: string | null;
+    organization_snapped_from_id?: string | null;
+    organization_snapped_from_name?: string | null;
+    organization_snapped?: boolean;
+    snap_message?: string | null;
+    requested_scope_ids?: string[];
+    delivered_scope_ids?: string[];
+    refusals?: ContextPreviewRefusal[];
+};
+/** ContextPreviewVariables */
+type ContextPreviewVariables = {
+    direct?: {
+        [key: string]: JsonValue;
+    };
+    tool_accessible?: {
+        [key: string]: JsonValue;
+    };
+    searchable?: {
+        [key: string]: JsonValue;
+    };
+};
+/** Where a shown block came from — printed on the inspector's tabs. */
+type ContextProvenance = {
+    function?: string;
+    module?: string;
+    git_sha: string;
+    run_path_callers: string[];
+    resolver: "chosen" | "record_store";
+    says: string;
+};
+/** What the server did with every context value this turn (RULES.md §5). */
+type ContextReceipt = {
+    version?: 1;
+    surface?: string | null;
+    cap: number;
+    model_reads_context?: boolean;
+    rows?: ContextReceiptRow[];
+    rules_error?: string | null;
+    blocks?: ContextReceiptBlock[];
+    room_view?: ContextReceiptRoomView | null;
+};
+/** One block of text the server put in front of the model this turn that is NOT a single */
+type ContextReceiptBlock = {
+    id: string;
+    label: string;
+    delivered: ContextDeliveredRef;
+};
+/** What the Group Chat view (per-turn slot ``room_view``) chose for this participant this */
+type ContextReceiptRoomView = {
+    participant_id: string;
+    participant_key: string;
+    round: number;
+    policy_version: number;
+    included?: string[];
+    digested?: string[];
+    withheld?: ContextReceiptWithheldItem[];
+    error?: string | null;
+};
+/** One context value this turn: whether it reached the model, and how. */
+type ContextReceiptRow = {
+    key: string;
+    label: string;
+    surface_key: string;
+    origin: "client" | "server" | "surroundings" | "rule";
+    chars?: number | null;
+    include: boolean;
+    max_inline_chars: number;
+    delivery: "inline" | "on_request" | "off";
+    decided_by: ContextDecidedBy;
+    user_rule?: ContextRule | null;
+    clamped?: boolean;
+    client_sent_excluded?: boolean;
+    blocked_by?: ("model" | "self_check") | null;
+    consumed_as?: ("expanded" | "directive" | "renamed" | "unaccounted") | null;
+    consumed_into?: string[];
+    delivered?: ContextDeliveredRef | null;
+    on_request?: ContextDeliveredRef | null;
+};
+/** One message of the group the participant's view policy kept from the model this turn. */
+type ContextReceiptWithheldItem = {
+    message_id: string;
+    conversation_id: string;
+    speaker: string;
+    rule: string;
+};
+/** ContextRenderRequest */
+type ContextRenderRequest = {
+    target: ContextTarget;
+    invocation: InvocationContext;
+};
+/** ContextRenderResponse */
+type ContextRenderResponse = {
+    rendered: string;
+    metadata: {
+        [key: string]: JsonValue;
+    };
+};
+/** A person's saved rule for one context value (``users.user_surface_state``, */
+type ContextRule = {
+    include?: boolean | null;
+    max_inline_chars?: number | null;
+};
+/** The inspector's drill-down, one step per field. A later step needs every earlier one. */
+type ContextSelection = {
+    /** The organization the selection is in. */
+    organization_id: string;
+    /** A scope type of that organization — every scope of it. */
+    scope_type_id?: string | null;
+    /** One scope of that type. */
+    scope_id?: string | null;
+    /** One context item — the page narrows what it shows to it. */
+    context_item_id?: string | null;
+    /** System (platform) context items picked explicitly. A System item reaches the agent only when something names it: the agent's bindings, the platform's default list, or this pick. */
+    system_item_ids?: string[];
+};
+/** One System (platform) item this compare named, who named it, and which side delivered it. */
+type ContextSystemItem = {
+    key?: string | null;
+    context_item_id?: string | null;
+    named_by?: string[];
+    old?: boolean;
+    new?: boolean;
+};
+/** THE "System items" line (lane CONTEXT-VALUES-NAMED): a System item reaches an agent only */
+type ContextSystemItems = {
+    named?: ContextSystemItem[];
+    withheld?: string[];
+    says?: string;
+};
+/** ContextTarget */
+type ContextTarget = {
+    kind: "scope_system";
+    tier: "overview" | "scope" | "scope_type" | "context_item";
+    variation?: "a1" | "a2" | "fk_a" | "fk_b" | "d_elements" | "d_attributes";
+    scope_slug?: string | null;
+    scope_type_slug?: string | null;
+    item_key?: string | null;
+};
+/** One thing to view: ``kind`` + the value's key or the block's id. */
+type ContextViewTarget = {
+    kind: "delivered" | "on_request" | "block" | "fetchable";
+    key: string;
+};
+/** The exact text the model received (or will receive) for one value or block. */
+type ContextViewedText = {
+    kind: "delivered" | "on_request" | "block" | "fetchable";
+    key: string;
+    text: string;
+    chars: number;
+    sha256: string;
+    source: "preview" | "wire" | "conversation_prompt" | "turn_record" | "fetched_now" | "tool_result";
+    available?: boolean;
+    fetched?: boolean | null;
+};
+/** Binds a variable to a model control: the variable's value IS that control's value. */
+type ControlBinding = {
+    /** Canonical control key (aspect_ratio, quality, tts_voice, temperature, ...). While bound, the key is absent from the agent's settings and the variable's defaultValue is the agent's value. */
+    key: string;
+    [key: string]: unknown;
+};
+/** Structured agent request. Goes through the trained agent-builder */
+type CreateAgentInput = {
+    /** The agent's display name — a Title Case Pretty Name ('Keyword Analysis Master'), never snake_case (Arman, 2026-08-22). */
+    name: string;
+    /** Goals / objectives — what the agent must accomplish. */
+    goals: string;
+    /** One-sentence description of the agent. */
+    summary?: string;
+    /** Variables the agent will be given, each with a description. */
+    variables?: AgentVariableInput[];
+    /** 'text' (prose), 'json' (free JSON), or 'json_schema' (schema-enforced). */
+    response_format?: "text" | "json" | "json_schema";
+    /** The person's own words for the answer's format, e.g. 'a Markdown table with columns Owner | Task | Due'. Wins over response_format's prose meaning; the Agent Factory locks and proves it. */
+    output_format?: string;
+    /** Required when response_format='json_schema'. Validated against provider rules. */
+    output_schema?: {
+        [key: string]: JsonValue;
+    } | null;
+    /** Optional sample output; checked for consistency against output_schema. */
+    sample_output?: {
+        [key: string]: JsonValue;
+    } | null;
+    /** Optional example variable values. */
+    sample_inputs?: string;
+    /** Model preference/guidance, e.g. cost vs speed vs intelligence. */
+    model_guidance?: string;
+    /** How a run of this agent is judged: the automatic checks and the owner's pass bar from the mandate brief. The builder writes the prompt against it. */
+    grading_rubric?: string;
+    /** Optional database-owned model class. 'balanced' selects a primary, non-premium mid-cost text model; 'strongest' selects a primary premium text model. */
+    model_profile?: ("balanced" | "strongest") | null;
+    /** Optional EXPLICIT model pin (an id from agent_catalog list_models). A pin always wins over model_profile; it is validated by the live runnable-model gate and refused by name if unknown — never replace */
+    model_id?: string | null;
+    /** Executable tools to assign, by canonical tool NAME (from agent_catalog list_tools; DB UUIDs also accepted). Validated against the live registry — unknown or inactive tools are rejected loudly. Written */
+    tools?: string[];
+    /** Term lists (glossary / pronunciation / house terms) to ATTACH to the agent, by term-list id. REPLACES the attached set (omitted = unchanged; [] = detach all). Each list must be one you can view; an un */
+    term_list_ids?: string[];
+    /** WHO this agent belongs to. Set it whenever the agent is being built FOR a user (a Masterwork's Maker/Editor/Chief, anything a customer's build produces): the agent is born agent_type='user', created_b */
+    owner_user_id?: string | null;
+    /** Org placement for an owned agent. Ignored unless owner_user_id is set; REQUIRED when it is — the organization the caller was admitted for (context_organization_id(ctx)) or the one on the record being  */
+    owner_organization_id?: string | null;
+};
+/** DirectiveApplyResult */
+type DirectiveApplyResult = {
+    directive: string;
+    applied: number;
+    failed: number;
+    receipts: DirectiveReceipt[];
+};
+/** The shells a client read out of stored content — a conversation's */
+type DirectiveApplyStateRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    shells?: {
+        [key: string]: unknown;
+    }[];
+    conversation_id?: string | null;
+};
+/** DirectiveApplyStateResult */
+type DirectiveApplyStateResult = {
+    conversation_id?: string | null;
+    shells: DirectiveShellState[];
+};
+/** The whole grid: class axis + noun rows + Kind Actions. */
+type DirectiveCatalog = {
+    directive_version: number;
+    classes: string[];
+    nouns: NounDirectives[];
+    actions?: KindActionEntry[];
+    aliases?: {
+        [key: string]: string;
+    };
+    item_kinds?: {
+        [key: string]: string;
+    };
+    catalog_version?: string;
+};
+/** The two-key shell the client received in the proposal, POSTed back verbatim. */
+type DirectiveConfirmRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    directive: string;
+    items?: {
+        [key: string]: unknown;
+    }[];
+    proposal_id?: string | null;
+    force?: boolean;
+    conversation_id?: string | null;
+};
+/** DirectiveConfirmResult */
+type DirectiveConfirmResult = {
+    directive: string;
+    proposal_id: string;
+    applied: number;
+    failed: number;
+    receipts: (DirectiveItemApplied | DirectiveItemFailed)[];
+    message: string;
+};
+/** Body for `POST /directives/execute` — one write directive. */
+type DirectiveExecuteRequest = {
+    directive: string;
+    items?: {
+        [key: string]: unknown;
+    }[];
+    conversation_id?: string | null;
+    force?: boolean;
+};
+/** DirectiveItemState */
+type DirectiveItemState = {
+    index: number;
+    state: string;
+    message?: string | null;
+    resource_ids?: string[];
+    copies?: number;
+    before?: {
+        [key: string]: unknown;
+    } | null;
+};
+/** ONE noun's per-write-class item JSON schemas — fetched on demand when a */
+type DirectiveNounSchemas = {
+    noun: string;
+    catalog_version: string;
+    schemas?: {
+        [key: string]: unknown;
+    };
+};
+/** DirectiveReceipt */
+type DirectiveReceipt = {
+    directive_class: string;
+    noun: string;
+    status: "applied" | "already_applied" | "not_implemented" | "failed";
+    resource_ids?: string[];
+    summary?: string;
+    idempotency_key?: string;
+    error?: string | null;
+    detail?: {
+        [key: string]: unknown;
+    } | null;
+    before?: {
+        [key: string]: unknown;
+    } | null;
+};
+/** DirectiveShellState */
+type DirectiveShellState = {
+    directive: string;
+    proposal_id: string;
+    directive_class: string;
+    noun: string;
+    item_count: number;
+    message: string;
+    items: DirectiveItemState[];
+    approvable: boolean;
+    unreadable?: string | null;
+};
+/** Complete, portable agent definition consumed by every execution host. */
+type ExecutionAgentDefinition = {
+    definition_id: string;
+    agent_id: string;
+    is_version?: boolean;
+    version_number?: number | null;
+    revision?: string | null;
+    definition_hash?: string | null;
+    name?: string;
+    model_id: string;
+    messages: unknown[];
+    settings?: {
+        [key: string]: unknown;
+    };
+    tools?: string[];
+    custom_tools?: unknown[];
+    mcp_servers?: string[];
+    variable_definitions?: {
+        [key: string]: unknown;
+    }[];
+    context_policies?: {
+        [key: string]: unknown;
+    }[];
+    auto_context_disabled?: boolean;
+    tool_config?: {
+        [key: string]: unknown;
+    };
+    output_schema?: {
+        [key: string]: unknown;
+    } | null;
+    matrx_actions?: {
+        [key: string]: unknown;
+    } | null;
+    skill_config?: {
+        [key: string]: unknown;
+    };
+};
+/** FailureAnalyticsResponse */
+type FailureAnalyticsResponse = {
+    by_domain: FaultDomainCount[];
+    by_tool: ToolFailureStat[];
+    sample_size: number;
+};
+/** FaultDomainCount */
+type FaultDomainCount = {
+    fault_domain: string;
+    count: number;
+};
+/** FirstRunsResponse */
+type FirstRunsResponse = {
+    judgment: {
+        [key: string]: JsonValue;
+    };
+};
+/** GetToolResponse */
+type GetToolResponse = {
+    tool: ToolRecord;
+    related: {
+        [key: string]: JsonValue;
+    } | string;
+    [key: string]: unknown;
+};
+/** IngestReport */
+type IngestReport = {
+    parsed: number;
+    created: number;
+    updated: number;
+    unchanged: number;
+    errors: string[];
+    skills: {
+        [key: string]: string;
+    }[];
+    roots?: string[];
+};
+/** Result of evicting one agent definition from the server caches. */
+type InvalidateAgentCacheResponse = {
+    cleared: boolean;
+    agent_id: string;
+    is_version: boolean;
+};
+/** Normal-call inputs retained here as expansion points for all context producers. */
+type InvocationContext = {
+    organization_id: string;
+    project_id?: string | null;
+    task_id?: string | null;
+    conversation_id?: string | null;
+    entity_type?: string;
+    entity_id?: string | null;
+    scope_ids?: string[];
+    agent_id?: string | null;
+    channel?: string | null;
+    clearance?: Clearance;
+    [key: string]: unknown;
+};
+/** KeepResponse */
+type KeepResponse = {
+    agent_id: string;
+};
+/** One Kind Action — the `action` class of the grammar. */
+type KindActionEntry = {
+    name: string;
+    slug: string;
+    doc?: string;
+    item_schema?: {
+        [key: string]: unknown;
+    } | null;
+    item_kind?: string | null;
+};
+/** LibraryPut */
+type LibraryPut = {
+    entries?: {
+        [key: string]: unknown;
+    }[];
+};
+/** ListToolsBySourceKindResponse */
+type ListToolsBySourceKindResponse = {
+    tools: ToolRecord[];
+    count: number;
+    source_kind: string;
+};
+/** ListToolsForExecutorResponse */
+type ListToolsForExecutorResponse = {
+    tools: ToolRecord[];
+    count: number;
+    executor_name: string;
+    requested_executor: string;
+};
+/** ListToolsResponse */
+type ListToolsResponse = {
+    tools: ToolRecord[];
+    count: number;
+};
+/** ListsPut */
+type ListsPut = {
+    lists?: {
+        [key: string]: unknown;
+    }[];
+};
+/** One declared CLIENT TOOL (``ui.ui_surface_client_tool``). */
+type ManifestClientToolEntry = {
+    name: string;
+    label?: string;
+    description?: string;
+    input_schema?: {
+        [key: string]: JsonValue;
+    };
+    mode?: string;
+};
+/** One canonical value group (machine key + order only). */
+type ManifestGroupEntry = {
+    key: string;
+    sort_order?: number;
+};
+/** ManifestToolEntry */
+type ManifestToolEntry = {
+    name: string;
+    disposition: "default" | "optional";
+    kind: "registered" | "inline";
+    delegate: boolean;
+};
+/** One declared surface value binding (``ui.ui_surface_value``). */
+type ManifestValueEntry = {
+    name: string;
+    auto_context?: boolean;
+    group_key?: string;
+    sort_order?: number;
+    always_available?: boolean;
+};
+/** One thing an agent may WRITE into this surface. */
+type ManifestWriteTargetEntry = {
+    name: string;
+    value_type?: string;
+    mode?: string;
+    description?: string;
+    apply_policy?: string;
+    updates_value?: string | null;
+    group_key?: string;
+    sort_order?: number;
+};
+/** MatrixCancelResponse */
+type MatrixCancelResponse = {
+    set_id: string;
+    cancelled_queued?: number;
+    cancel_signalled?: number;
+    request_ids?: string[];
+};
+/** ``POST /agent-battles/{set_id}/run``. */
+type MatrixRunRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    /** Active context-scope ids selected by the caller and membership-validated server-side. */
+    scope_ids?: string[] | null;
+    /** Active scope-type ids selected by the caller (type-level selection with no specific scope chosen). */
+    active_scope_type_ids?: string[] | null;
+    /** Durable resource identity from which authoritative organization and task context is reloaded. */
+    context_anchor?: ContextAnchor | null;
+    /** Persist request outputs when true; run ephemerally when false. */
+    store?: boolean;
+    /** Specific connected desktop instance allowed to claim delegated local tools. */
+    target_instance_id?: string | null;
+    cells?: CellRef[] | null;
+    scope?: "all" | "unfinished";
+};
+/** A variable filled by a MERGE FIELD — the declaration ``matrx_records.merge`` */
+type MergeFieldBinding = {
+    /** Discriminator for this binding kind. */
+    kind: "merge_field";
+    /** Where the value comes from. */
+    source: "record";
+    /** What it resolves into. */
+    semantic_type: "collection" | "reference" | "value";
+    /** custom Table id the value is read from. */
+    table_id: string;
+    /** One record of that Table. */
+    record_id?: string | null;
+    /** With record_id: the one field. */
+    field_key?: string | null;
+    /** Exact-equality filter {field_key: value} for a collection. */
+    match?: {
+        [key: string]: JsonValue;
+    } | null;
+    /** Collection row order. */
+    sort?: MergeFieldSort | null;
+    /** Collection row cap (default 40). */
+    limit?: number | null;
+    /** How it reads. */
+    transform?: MergeFieldTransform | null;
+    /** absent: a NAMED absence in the prompt (default). block: the run refuses. */
+    missing?: ("absent" | "block") | null;
+    /** Default shown_locked (client value discarded). */
+    override_policy?: ("must_supply" | "shown_overridable" | "shown_locked" | "server_fixed" | "derived") | null;
+    [key: string]: unknown;
+};
+/** Row order for a collection merge-field binding. */
+type MergeFieldSort = {
+    /** Field key to order the rows by. */
+    field: string;
+    /** asc | desc. */
+    dir?: "asc" | "desc";
+};
+/** How the resolved value READS (DYN-16) — applied after resolution. */
+type MergeFieldTransform = {
+    /** list | currency | number | date | upper | title. */
+    name: string;
+    /** list: per-row render, e.g. '- {purpose}: {model.name} (`{model.id}`)'. An entity-reference field exposes .name/.title/.label/.id/.token. Without a template each row reads '- key: value; key: value'. */
+    template?: string | null;
+    /** list: text between rows. */
+    join?: string | null;
+    /** list: rows shown; the rest are announced. */
+    max?: number | null;
+    [key: string]: unknown;
+};
+/** MockScenario */
+type MockScenario = {
+    name: string;
+    description: string;
+};
+/** MockScenarioList */
+type MockScenarioList = {
+    scenarios: MockScenario[];
+};
+/** MockStreamRequest */
+type MockStreamRequest = {
+    chunk_count?: number;
+    chunk_delay_ms?: number;
+    heartbeat_interval_ms?: number;
+    max_lifetime_ms?: number;
+    include_preamble?: boolean;
+};
+/** What the runtime will accept for this model — so an authoring agent never */
+type ModelAuthoringFacts = {
+    /** decision_questions: 'native' = a decision model computes the probabilities; 'verbalized' = a text model states them; 'none' = not a text/decision route. */
+    decision: "native" | "verbalized" | "none";
+    /** True = a trailing assistant message flagged prefill is sent natively. False = the organization's flag_compatibility_mode decides (refuse | convert | drop). */
+    prefill: boolean;
+    /** This organization's mode for unsupported flags. */
+    flag_compatibility_mode: string;
+    /** Audio models only: the most distinct speakers one speech_script may use (null on an audio model = uncapped; omitted for non-audio models). */
+    speaker_cap?: number | null;
+    /** Image reference roles this model takes and how many of each ('total' = overall cap). Empty = none. */
+    image_reference_roles?: {
+        [key: string]: number;
+    };
+    /** Video/audio reference roles (extend, restyle, lip_sync, named, …) and counts. Empty = none. */
+    video_reference_roles?: {
+        [key: string]: number;
+    };
+    /** Controls with a catalog rule on this model that it supports. */
+    controls?: ModelControlInfo[];
+};
+/** What a model can actually do — for a capability-driven model picker. Two */
+type ModelCapabilitySummary = {
+    input_modalities?: string[];
+    output_modalities?: string[];
+    output_type?: "text" | "image" | "video" | "audio" | "realtime" | "extraction" | "decision" | "agent";
+    interaction?: "turn" | "realtime" | "extraction" | "decision" | "agent";
+    features?: string[];
+    native_tools?: string[];
+    supports_vision?: boolean;
+    supports_audio_input?: boolean;
+    supports_function_calling?: boolean;
+    supports_web_search?: boolean;
+    multilingual?: boolean;
+    accepts_documents?: boolean;
+    accepts_video?: boolean;
+    accepts_youtube?: boolean;
+};
+/** One serving CLASS of a model (its endpoint brand: "Matrx Fast", */
+type ModelClassInfo = {
+    offering_id: string;
+    served_via: string;
+    authoring?: ModelAuthoringFacts | null;
+};
+/** One control this model exposes, and whether a variable may set it here. */
+type ModelControlInfo = {
+    key: string;
+    /** True when the caller's organization lets a run set this control through a bound variable (agents.controls/variable_bindable_keys). False = binding is allowed but the agent's own value is always used. */
+    variable_bindable: boolean;
+};
+/** An AI model an agent can be assigned. Agents stop hallucinating 'gpt-4'. */
+type ModelInfo = {
+    id: string;
+    name: string;
+    common_name?: string;
+    provider?: string;
+    context_window?: number | null;
+    is_premium?: boolean;
+    is_primary?: boolean;
+    is_deprecated?: boolean;
+    successor_id?: string | null;
+    cost_rating?: number | null;
+    speed_rating?: number | null;
+    output_type?: "text" | "image" | "video" | "audio" | "realtime" | "extraction" | "decision" | "agent";
+    capabilities?: ModelCapabilitySummary | null;
+    classes?: ModelClassInfo[];
+    authoring?: ModelAuthoringFacts | null;
+};
+/** One row of the grid — a noun (Dimension 2) and its state for every class. */
+type NounDirectives = {
+    noun: string;
+    family: string;
+    table: string;
+    reference: "yes" | "planned" | "no";
+    view: "yes" | "planned" | "no";
+    create: "yes" | "planned" | "no";
+    update: "yes" | "planned" | "no";
+    delete: "yes" | "planned" | "no";
+    label?: string;
+    title_column?: string | null;
+    identity_fields?: string[];
+};
+/** The catalog-level answer to "is this agent an Orchestra, and how big?". */
+type OrchestraBadge = {
+    member_count?: number;
+    mode?: string;
+    tagline?: string | null;
+    member_titles?: string[];
+    member_depth_ceiling?: number | null;
+};
+/** PicklistBinding */
+type PicklistBinding = {
+    /** The id of the pick list (a Table of choices) the options come from. */
+    listId: string;
+    /** Optional group filter within the picklist. */
+    groupName?: string | null;
+    /** Multi-select picklist. */
+    multiple?: boolean;
+    [key: string]: unknown;
+};
+/** PortableAgentBundle */
+type PortableAgentBundle = {
+    contract?: "portable-agent.v1";
+    agent_id: string;
+    version_id?: string | null;
+    version_number?: number | null;
+    is_version?: boolean;
+    name: string;
+    definition_hash: string;
+    model_id: string;
+    instructions: string;
+    variables?: {
+        [key: string]: JsonValue;
+    }[];
+    filled_variables?: string[];
+    skills?: PortableSkill[];
+    tools?: PortableTool[];
+    surface: string;
+    unavailable?: PortableUnavailable[];
+};
+/** What the host sends: the person's variable values, and the tool surface. */
+type PortableAgentRequest = {
+    variables?: {
+        [key: string]: JsonValue;
+    };
+    surface?: string;
+};
+/** What a picker needs the moment a person chooses an agent — no skills, no */
+type PortableAgentSummary = {
+    agent_id: string;
+    name: string;
+    version_id?: string | null;
+    version_number?: number | null;
+    definition_hash: string;
+    variables?: {
+        [key: string]: JsonValue;
+    }[];
+    versions?: PortableAgentVersion[];
+};
+/** PortableAgentVersion */
+type PortableAgentVersion = {
+    id: string;
+    version_number: number;
+    changed_at?: string | null;
+    definition_hash?: string | null;
+};
+/** PortableSkill */
+type PortableSkill = {
+    id: string;
+    tier: "included" | "listed";
+    slug: string;
+    label: string;
+    description: string;
+    path: string;
+    content: string;
+    body: string;
+    content_hash: string;
+};
+/** PortableTool */
+type PortableTool = {
+    name: string;
+    canonical_name: string;
+    description?: string;
+    parameters?: {
+        [key: string]: JsonValue;
+    };
+};
+/** PortableUnavailable */
+type PortableUnavailable = {
+    kind: "tool" | "skill" | "variable" | "message" | "mcp_server" | "tools";
+    name: string;
+    reason: string;
+};
+/** PromptWarmRequest */
+type PromptWarmRequest = {
+    source?: string | null;
+};
+/** PromptWarmResponse */
+type PromptWarmResponse = {
+    status: string;
+    prompt_id: string;
+};
+/** PromptsPut */
+type PromptsPut = {
+    prompts?: {
+        [key: string]: unknown;
+    }[];
+};
+/** Which agent row the session runs: the live agent, or a version row. */
+type RealtimeSessionRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    /** Resolve against an agent VERSION row rather than the live agent. */
+    is_version?: boolean;
+};
+/** Everything a realtime voice session needs — never the definition itself. */
+type RealtimeSessionResponse = {
+    /** The agent the session runs (the owner of a version row). */
+    agent_id: string;
+    /** builtin / user / … — gates the person's voice choice. */
+    agent_type?: string | null;
+    /** The catalog model id the agent is set to. */
+    model_id: string;
+    /** The model value xAI's realtime socket expects. */
+    wire_model: string;
+    /** The agent's own voice (settings.voice_id). */
+    voice_id?: string | null;
+    /** The agent's system message — the session persona. */
+    instructions: string;
+};
+/** One tool declared to a realtime session, in xAI function shape. */
+type RealtimeTool = {
+    name: string;
+    canonical_name?: string;
+    description?: string;
+    parameters?: {
+        [key: string]: JsonValue;
+    };
+    /** "server" | "client" | "builtin" */
+    execution: string;
+};
+/** RealtimeToolsRequest */
+type RealtimeToolsRequest = {
+    /** UI surface, e.g. matrx-user/chat-voice */
+    surface: string;
+    added_tool_ids?: string[];
+    is_version?: boolean;
+    client?: ClientContext | null;
+    user?: UserOverrides | null;
+};
+/** RealtimeToolsResponse */
+type RealtimeToolsResponse = {
+    agent_id: string;
+    model_supports_tools: boolean;
+    tools: RealtimeTool[];
+    tool_adaptations?: {
+        [key: string]: JsonValue;
+    }[];
+};
+/** SchemaFinding */
+type SchemaFinding = {
+    provider: string;
+    severity: "error" | "warning";
+    path: string;
+    message: string;
+};
+/** Outcome of validating an output schema (+ optional sample). ``ok`` is */
+type SchemaGateReport = {
+    ok: boolean;
+    findings?: SchemaFinding[];
+    portable_schema?: {
+        [key: string]: JsonValue;
+    } | null;
+};
+/** The ask a screen shows in place: the same record and form as an agent's. */
+type ScreenRunApproval = {
+    action_request_id: string;
+    organization_id?: string | null;
+    estimate_usd?: number | null;
+    ceiling_cap_usd?: number | null;
+    what_it_buys?: string | null;
+    expires_at?: string | null;
+    render?: {
+        [key: string]: JsonValue;
+    } | null;
+};
+/** ScreenRunError */
+type ScreenRunError = {
+    error_type: string;
+    message: string;
+    suggested_action?: string | null;
+};
+/** ScreenRunRequest */
+type ScreenRunRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    /** Active context-scope ids selected by the caller and membership-validated server-side. */
+    scope_ids?: string[] | null;
+    /** Active scope-type ids selected by the caller (type-level selection with no specific scope chosen). */
+    active_scope_type_ids?: string[] | null;
+    /** Durable resource identity from which authoritative organization and task context is reloaded. */
+    context_anchor?: ContextAnchor | null;
+    /** Persist request outputs when true; run ephemerally when false. */
+    store?: boolean;
+    /** Specific connected desktop instance allowed to claim delegated local tools. */
+    target_instance_id?: string | null;
+    /** The registered tool's name, e.g. seo_domain */
+    tool_name: string;
+    arguments?: {
+        [key: string]: unknown;
+    };
+    /** The approval a person granted for this call (from a previous needs_approval answer). Passed to the tool as its own argument. */
+    spend_approval_id?: string | null;
+};
+/** ScreenRunResponse */
+type ScreenRunResponse = {
+    call_id: string;
+    tool_name: string;
+    status: "ok" | "needs_approval" | "error";
+    output?: JsonValue;
+    error?: ScreenRunError | null;
+    approval?: ScreenRunApproval | null;
+};
+/** SkillCreate */
+type SkillCreate = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    skill_id: string;
+    label: string;
+    description: string;
+    skill_type?: string;
+    body?: string;
+    icon_name?: string | null;
+    model_preference?: string | null;
+    allowed_tools?: string[];
+    trigger_patterns?: string[];
+    disable_auto_invocation?: boolean;
+    platform_targets?: string[];
+    version?: string | null;
+    config?: JsonValue;
+    category_id?: string | null;
+    parent_skill_id?: string | null;
+    is_public?: boolean;
+};
+/** A skill that can be attached to an agent (skill_config). */
+type SkillInfo = {
+    id: string;
+    skill_id: string;
+    label: string;
+    description?: string;
+    skill_type?: string;
+    category_path?: string[];
+};
+/** SkillPatch */
+type SkillPatch = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    label?: string | null;
+    description?: string | null;
+    skill_type?: string | null;
+    body?: string | null;
+    icon_name?: string | null;
+    model_preference?: string | null;
+    allowed_tools?: string[] | null;
+    trigger_patterns?: string[] | null;
+    disable_auto_invocation?: boolean | null;
+    platform_targets?: string[] | null;
+    version?: string | null;
+    config?: JsonValue | null;
+    category_id?: string | null;
+    parent_skill_id?: string | null;
+    is_public?: boolean | null;
+    is_active?: boolean | null;
+};
+/** Wire shape for skill responses. Mirrors the active fields on */
+type SkillRow = {
+    id: string;
+    skill_id: string;
+    label: string;
+    description: string;
+    skill_type: string;
+    body?: string | null;
+    icon_name?: string | null;
+    model_preference?: string | null;
+    allowed_tools?: string[];
+    trigger_patterns?: string[];
+    disable_auto_invocation?: boolean;
+    platform_targets?: string[];
+    version?: string | null;
+    config?: JsonValue;
+    category_id?: string | null;
+    parent_skill_id?: string | null;
+    is_active?: boolean;
+    is_system?: boolean;
+    is_public?: boolean;
+    sort_order?: number;
+    user_id?: string | null;
+    organization_id?: string | null;
+    project_id?: string | null;
+};
+/** SkillsList */
+type SkillsList = {
+    count: number;
+    skills: SkillRow[];
+};
+/** One declared variable of the agent being built. */
+type SpecVariable = {
+    name: string;
+    description?: string;
+};
+/** StartBuildBody */
+type StartBuildBody = {
+    spec: AgentSpec;
+    mandate_key?: string | null;
+    /** The same key never starts a second build. */
+    idempotency_key?: string | null;
+    /** Build unproven (R34): with fewer than 3 example inputs, save the agent badged unproven and judge its first 3 real runs instead of refusing. */
+    unproven?: boolean;
+    /** The browser door that started this build (pipeline_door.DOORS, e.g. 'generate', 'mandate_holder_draft'); the page read the door's knob. Recorded on the build. */
+    door?: string | null;
+    /** A platform builtin (the system rung of a mandate's holder controls). Admins only; for anyone else the agent is the caller's own, as with a named owner. */
+    builtin?: boolean;
+};
+/** StartBuildResponse */
+type StartBuildResponse = {
+    build_id: string;
+    idempotency_key: string;
+};
+/** The server's authoritative view of one surface's tool manifest. */
+type SurfaceManifest = {
+    name: string;
+    source: string;
+    description: string;
+    requires_auth: boolean;
+    default_tools: ManifestToolEntry[];
+    optional_tools: ManifestToolEntry[];
+    inherited_from_base?: boolean;
+    value_bindings?: string[];
+    values?: ManifestValueEntry[];
+    groups?: ManifestGroupEntry[];
+    write_targets?: ManifestWriteTargetEntry[];
+    client_tools?: ManifestClientToolEntry[];
+    intro?: string | null;
+};
+/** TemplatesPut */
+type TemplatesPut = {
+    templates?: {
+        [key: string]: unknown;
+    }[];
+};
+/** ToolDetail */
+type ToolDetail = {
+    name: string;
+    db?: ToolRow | null;
+    code?: CodeDeclaration | null;
+    findings?: ToolFinding[];
+    recent_failures?: ToolFailureRow[];
+};
+/** ToolDetailResponse */
+type ToolDetailResponse = {
+    tool: {
+        [key: string]: JsonValue;
+    };
+};
+/** ToolExecuteRequest */
+type ToolExecuteRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    /** Active context-scope ids selected by the caller and membership-validated server-side. */
+    scope_ids?: string[] | null;
+    /** Active scope-type ids selected by the caller (type-level selection with no specific scope chosen). */
+    active_scope_type_ids?: string[] | null;
+    /** Durable resource identity from which authoritative organization and task context is reloaded. */
+    context_anchor?: ContextAnchor | null;
+    /** Persist request outputs when true; run ephemerally when false. */
+    store?: boolean;
+    /** Specific connected desktop instance allowed to claim delegated local tools. */
+    target_instance_id?: string | null;
+    agent_id: string;
+    conversation_id?: string | null;
+    tool_name: string;
+    arguments?: {
+        [key: string]: unknown;
+    };
+    call_id?: string | null;
+    /** UI surface, for allowed-set resolution */
+    surface: string;
+    is_version?: boolean;
+    added_tool_ids?: string[];
+    tools?: (RegisteredToolSpec | InlineToolSpec | AgentToolSpec)[];
+    tools_replace?: ((RegisteredToolSpec | InlineToolSpec | AgentToolSpec)[]) | null;
+    client?: ClientContext | null;
+    user?: UserOverrides | null;
+};
+/** ToolExecuteResponse */
+type ToolExecuteResponse = {
+    call_id: string;
+    ok: boolean;
+    output: string;
+};
+/** ToolFailureRow */
+type ToolFailureRow = {
+    tool_name: string;
+    fault_domain?: string | null;
+    err_type?: string | null;
+    err_msg?: string | null;
+    ts?: string | null;
+    conversation_id?: string | null;
+    call_id?: string | null;
+};
+/** ToolFailureStat */
+type ToolFailureStat = {
+    tool_name: string;
+    total: number;
+    model_error: number;
+    tool_defect: number;
+    infra: number;
+    user: number;
+};
+/** ToolFinding */
+type ToolFinding = {
+    kind: string;
+    severity: string;
+    tool_name: string;
+    message: string;
+    detail?: JsonValue;
+};
+/** A registered tool an agent can be given. */
+type ToolInfo = {
+    name: string;
+    description?: string;
+    category?: string | null;
+    tags?: string[];
+    admin_only?: boolean;
+};
+/** Tool definition row as returned by ``ToolDefinition.to_dict()``. */
+type ToolRecord = {
+    id?: string | null;
+    name?: string | null;
+    description?: string | null;
+    source_kind?: string | null;
+    managed_by_server_id?: string | null;
+    [key: string]: unknown;
+};
+/** ToolRequest */
+type ToolRequest = {
+    /** Tool name to invoke */
+    tool: string;
+    /** Tool parameters */
+    input?: {
+        [key: string]: unknown;
+    };
+};
+/** ToolResponse */
+type ToolResponse = {
+    type: string;
+    output: string;
+    image?: {
+        [key: string]: unknown;
+    } | null;
+    artifact?: {
+        [key: string]: unknown;
+    } | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    action_needed?: ActionNeeded | null;
+};
+/** A tool_def row plus its derived drift status, for the list/detail views. */
+type ToolRow = {
+    name: string;
+    source_kind?: string | null;
+    managed_by_server_id?: string | null;
+    function_path?: string | null;
+    description?: string | null;
+    category?: string | null;
+    tier?: string | null;
+    is_active?: boolean;
+    admin_only?: boolean;
+    validation_exempt?: boolean;
+    surfaces?: string[];
+    parameters?: JsonValue;
+    version?: number | null;
+    declared_in_code?: boolean;
+    exists_in_db?: boolean;
+    is_owned?: boolean;
+    drift_count?: number;
+    drift_severity?: string | null;
+    [key: string]: unknown;
+};
+/** ToolSummary */
+type ToolSummary = {
+    code_count: number;
+    db_count: number;
+    external_count: number;
+    errors: number;
+    warnings: number;
+    exempt: number;
+    in_sync: number;
+    inactive?: number;
+};
+/** ToolTestExecuteRequest */
+type ToolTestExecuteRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    tool_name: string;
+    arguments: {
+        [key: string]: JsonValue;
+    };
+    conversation_id?: string | null;
+};
+/** ToolTestSessionResponse */
+type ToolTestSessionResponse = {
+    conversation_id: string;
+    user_id: string;
+};
+/** Admin-editable tool_def settings. All optional; only provided fields change. */
+type ToolUpdateRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    is_active?: boolean | null;
+    validation_exempt?: boolean | null;
+    admin_only?: boolean | null;
+    category?: string | null;
+    tier?: string | null;
+    description?: string | null;
+    parameters?: {
+        [key: string]: JsonValue;
+    } | null;
+};
+/** Partial update — only provided (non-None) fields are written. This is the */
+type UpdateAgentInput = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    name?: string | null;
+    description?: string | null;
+    model_id?: string | null;
+    category?: string | null;
+    tags?: string[] | null;
+    is_active?: boolean | null;
+    is_archived?: boolean | null;
+    output_schema?: {
+        [key: string]: JsonValue;
+    } | null;
+    settings?: {
+        [key: string]: JsonValue;
+    } | null;
+    /** Executable tools, by canonical tool NAME (from agent_catalog list_tools; DB UUIDs also accepted). REPLACES the agent's whole tool set — the authoritative agent.definition.tools column the executor rea */
+    tools?: string[] | null;
+    tool_config?: {
+        [key: string]: JsonValue;
+    } | null;
+    skill_config?: {
+        [key: string]: JsonValue;
+    } | null;
+    context_policies?: {
+        [key: string]: JsonValue;
+    }[] | null;
+    messages?: {
+        [key: string]: JsonValue;
+    }[] | null;
+    /** The stored column name for the agent's variable definitions. `variables` is the caller-facing alias and folds into this. */
+    variable_definitions?: {
+        [key: string]: JsonValue;
+    }[] | null;
+    /** The agent's variable definitions — REPLACES the whole list. Named `variables` to match every other surface (the create path, the read path, `agent_run`); it is written to the `variable_definitions` co */
+    variables?: {
+        [key: string]: JsonValue;
+    }[] | null;
+    /** Publish the agent itself to the web (the only anonymous lane). Leave a builtin unpublished — reach for a builtin is org placement (the ownerless Matrx System org), not this column. Independent of `car */
+    published_to_web?: boolean | null;
+    /** Who the agent is listed for (a list filter, never security). */
+    shown_to?: ("only_me" | "my_team" | "everyone" | "everyone_on_ai_matrx") | null;
+    visibility?: ("personal" | "internal" | "link" | "public" | "shared" | "private") | null;
+    /** Who may see the agent's CARD (the browse list / surface agent menu). 🚨 A builtin MUST be 'public': it has created_by NULL in the ownerless system org, where iam.has_org_access can never be true, so ' */
+    card_visibility?: ("internal" | "link" | "personal" | "public") | null;
+    /** Term lists (glossary / pronunciation / house terms) to ATTACH to the agent, by term-list id. REPLACES the attached set (omitted = unchanged; [] = detach all). Each list must be one you can view; an un */
+    term_list_ids?: string[] | null;
+};
+/** UserPromptCatalogResponse */
+type UserPromptCatalogResponse = {
+    prompts: AgentSummary[];
+    count: number;
+};
+/** Standalone schema-gate request — validate without creating anything. */
+type ValidateSchemaRequest = {
+    /** Candidate JSON Schema for an agent's structured output. */
+    output_schema: {
+        [key: string]: JsonValue;
+    };
+    /** Optional sample output checked against the schema. */
+    sample_output?: {
+        [key: string]: JsonValue;
+    } | null;
+};
+/** ValidationReportResponse */
+type ValidationReportResponse = {
+    ok: boolean;
+    summary: ToolSummary;
+    findings: ToolFinding[];
+    import_failures?: string[];
+};
+/** VariableAssignmentSpec */
+type VariableAssignmentSpec = {
+    /** Allow callers to request a server-side random option assignment. */
+    random?: boolean;
+    [key: string]: unknown;
+};
+/** VariableBindingPreviewRequest */
+type VariableBindingPreviewRequest = {
+    /** The organization the binding is read in. Required — never a default. */
+    organization_id: string;
+    /** The merge-field binding to preview. */
+    binding: MergeFieldBinding;
+    /** Optional: the variable's name, used in the trace and sentences. */
+    variable_name?: string | null;
+};
+/** VariableBindingPreviewResponse */
+type VariableBindingPreviewResponse = {
+    /** Exactly what the agent receives for {{variable}}. */
+    text: string;
+    /** False when the text is a named absence. */
+    present: boolean;
+    /** Rows delivered (1 for a record or a single value). */
+    row_count: number;
+    /** Rows that matched before the cap. */
+    total_rows: number;
+    /** True when the cap left rows out (announced in text). */
+    truncated: boolean;
+    /** What a client-sent value does (shown_locked…). */
+    override_policy: string;
+    /** delivered | absent (the agent is told `text`, a named absence) | blocks_run (missing=block: the run would be STOPPED — the agent is told nothing; `text` is the sentence a person sees). */
+    outcome: string;
+    /** Why nothing was delivered, for a person. */
+    absent_reason?: string | null;
+    /** no_field | empty | forbidden | record_unavailable | table_unavailable | no_rows | switched_off | no_person | no_organization | invalid_binding. */
+    absent_kind?: string | null;
+    /** Where the value comes from and whether it can be typed in. */
+    source_note?: string | null;
+    /** Cap, template and freshness notes. */
+    notes?: string[];
+    /** Field keys masked for you — named, never shown. */
+    withheld?: string[];
+    /** The same trace entry a run records. */
+    trace: {
+        [key: string]: JsonValue;
+    };
+};
+/** The input component a variable renders as (customComponent). */
+type VariableComponentSpec = {
+    /** Component type: textarea, toggle, radio, select, number, slider, image, … */
+    type: string;
+    /** Choices for choice-style components. */
+    options?: string[] | null;
+    /** Allow a free-text 'Other' entry alongside the choices. */
+    allowOther?: boolean | null;
+    /** [off, on] labels for toggle / light-switch. */
+    toggleValues?: string[] | null;
+    /** Min for number / slider. */
+    min?: number | null;
+    /** Max for number / slider. */
+    max?: number | null;
+    /** Step for number / slider. */
+    step?: number | null;
+    /** Bind the options to a user pick list. */
+    pick_list?: PicklistBinding | null;
+    /** Legacy read-only alias for pick_list. */
+    structured_list?: PicklistBinding | null;
+    /** Legacy read-only alias for pick_list. */
+    picklist?: PicklistBinding | null;
+    /** Server-side automatic-assignment strategies enabled here. */
+    assignment?: VariableAssignmentSpec | null;
+    [key: string]: unknown;
+};
+/** VariationBatchesPut */
+type VariationBatchesPut = {
+    batches?: {
+        [key: string]: unknown;
+    }[];
+};
+/** WarmAgentBlocksResponse */
+type WarmAgentBlocksResponse = {
+    status: string;
+    agent_id: string;
+};
+/** WarmAgentResponse */
+type WarmAgentResponse = {
+    status: string;
+    agent_id: string;
+};
+/** WarmRequest */
+type aidream__api__routers__agents__WarmRequest = {
+    is_version?: boolean;
+};
+/** WarmRequest */
+type aidream__api__routers__agents_blocks__WarmRequest = {
+    source?: string | null;
+};
+/** IngestRequest */
+type aidream__api__routers__skills__IngestRequest = {
+    /** Organization context for the request; omitted to use the authenticated context. */
+    organization_id?: string | null;
+    /** Optional associated project selected by the caller. */
+    project_id?: string | null;
+    /** Optional associated task selected by the caller. */
+    task_id?: string | null;
+    /** Stable application slug that initiated the request. */
+    source_app?: string | null;
+    /** Stable feature slug within the source application. */
+    source_feature?: string | null;
+    /** How the client initiated this request: 'user' for a direct human action, 'auto' for client-code automation. Omit for API callers. */
+    initiation?: ("user" | "auto") | null;
+    /** Absolute paths to scan. Each can be a leaf skills directory OR a repo root — conventional locations (.claude/skills, .cursor/skills, .agent[s]/skills, .matrx/skills, skills) are auto-discovered inside */
+    roots: string[];
+    /** When true, parse + report but do not write to the DB. */
+    dry_run?: boolean;
+};
+/** ToolListResponse */
+type aidream__api__routers__tool_testing__ToolListResponse = {
+    tools?: {
+        [key: string]: JsonValue;
+    }[];
+    count: number;
+};
+/** ToolListResponse */
+type aidream__services__admin_ops__tools_wire__ToolListResponse = {
+    summary: ToolSummary;
+    items: ToolRow[];
+    import_failures?: string[];
+};
+type WarmAgentArgs = {
+    path: {
+        agent_id: string;
+    };
+    body?: aidream__api__routers__agents__WarmRequest | null;
+};
+type WarmAgentResult = WarmAgentResponse;
+/** Warm Agent */
+/** `POST /ai/agents/{agent_id}/warm` · aidream · auth public · org required */
+declare function warmAgent(api: Api, args: WarmAgentArgs, options?: CallOptions): Promise<WarmAgentResult>;
+type GetAllPromptBuiltinsArgs = {
+    [key: string]: never;
+};
+type GetAllPromptBuiltinsResult = BuiltinPromptCatalogResponse;
+/** Get All Prompt Builtins */
+/** `GET /ai/prompts/builtins` · aidream · auth guest · org optional */
+declare function getAllPromptBuiltins(api: Api, args?: GetAllPromptBuiltinsArgs, options?: CallOptions): Promise<GetAllPromptBuiltinsResult>;
+type WarmPromptArgs = {
+    path: {
+        prompt_id: string;
+    };
+    body?: PromptWarmRequest | null;
+};
+type WarmPromptResult = PromptWarmResponse;
+/** Warm Prompt */
+/** `POST /ai/prompts/{prompt_id}/warm` · aidream · auth public · org required */
+declare function warmPrompt(api: Api, args: WarmPromptArgs, options?: CallOptions): Promise<WarmPromptResult>;
+type WarmAgentBlocksArgs = {
+    path: {
+        agent_id: string;
+    };
+    body?: aidream__api__routers__agents_blocks__WarmRequest | null;
+};
+type WarmAgentBlocksResult = WarmAgentBlocksResponse;
+/** Warm Agent Blocks */
+/** `POST /ai/agents-blocks/{agent_id}/warm` · aidream · auth public · org required */
+declare function warmAgentBlocks(api: Api, args: WarmAgentBlocksArgs, options?: CallOptions): Promise<WarmAgentBlocksResult>;
+type GetAllToolsArgs = {
+    [key: string]: never;
+};
+type GetAllToolsResult = ListToolsResponse;
+/** Get All Tools */
+/** `GET /ai-tools` · aidream · auth guest · org optional */
+declare function getAllTools(api: Api, args?: GetAllToolsArgs, options?: CallOptions): Promise<GetAllToolsResult>;
+type GetToolsBySourceKindArgs = {
+    path: {
+        source_kind: string;
+    };
+};
+type GetToolsBySourceKindResult = ListToolsBySourceKindResponse;
+/** Get Tools By Source Kind */
+/** `GET /ai-tools/source-kind/{source_kind}` · aidream · auth guest · org optional */
+declare function getToolsBySourceKind(api: Api, args: GetToolsBySourceKindArgs, options?: CallOptions): Promise<GetToolsBySourceKindResult>;
+type GetNativeToolsArgs = {
+    [key: string]: never;
+};
+type GetNativeToolsResult = ListToolsBySourceKindResponse;
+/** Get Native Tools */
+/** `GET /ai-tools/native/all` · aidream · auth guest · org optional */
+declare function getNativeTools(api: Api, args?: GetNativeToolsArgs, options?: CallOptions): Promise<GetNativeToolsResult>;
+type GetMcpDiscoveredToolsArgs = {
+    [key: string]: never;
+};
+type GetMcpDiscoveredToolsResult = ListToolsBySourceKindResponse;
+/** Get Mcp Discovered Tools */
+/** `GET /ai-tools/mcp-discovered/all` · aidream · auth guest · org optional */
+declare function getMcpDiscoveredTools(api: Api, args?: GetMcpDiscoveredToolsArgs, options?: CallOptions): Promise<GetMcpDiscoveredToolsResult>;
+type GetToolsForAppArgs = {
+    path: {
+        executor_name: string;
+    };
+};
+type GetToolsForAppResult = ListToolsForExecutorResponse;
+/** Get Tools For App */
+/** `GET /ai-tools/app/{executor_name}/all` · aidream · auth guest · org optional */
+declare function getToolsForApp(api: Api, args: GetToolsForAppArgs, options?: CallOptions): Promise<GetToolsForAppResult>;
+type GetToolByIdArgs = {
+    path: {
+        tool_id: string;
+    };
+};
+type GetToolByIdResult = GetToolResponse;
+/** Get Tool By Id */
+/** `GET /ai-tools/{tool_id}` · aidream · auth guest · org optional */
+declare function getToolById(api: Api, args: GetToolByIdArgs, options?: CallOptions): Promise<GetToolByIdResult>;
+type AgentsStartAgentArgs = {
+    path: {
+        agent_id: string;
+    };
+    query?: {
+        is_version?: boolean;
+    };
+    body: AgentStartRequest;
+};
+type AgentsStartAgentResult = unknown;
+/** Start Agent */
+/** `POST /ai/agent/{agent_id}` · aidream · auth guest · org required · ndjson_or_json */
+declare function agentsStartAgent(api: Api, args: AgentsStartAgentArgs, options?: CallOptions): Promise<JsonOrStream<AgentsStartAgentResult, NdjsonEvent>>;
+type AgentsStartAgentPostArgs = {
+    path: {
+        agent_id: string;
+    };
+    query?: {
+        is_version?: boolean;
+    };
+    body: AgentStartRequest;
+};
+type AgentsStartAgentPostResult = unknown;
+/** Start Agent */
+/** `POST /ai/agents/{agent_id}` · aidream · auth guest · org required · ndjson_or_json */
+declare function agentsStartAgentPost(api: Api, args: AgentsStartAgentPostArgs, options?: CallOptions): Promise<JsonOrStream<AgentsStartAgentPostResult, NdjsonEvent>>;
+type StartMandatedAgentArgs = {
+    path: {
+        mandate_key: string;
+    };
+    body: AgentStartRequest;
+};
+type StartMandatedAgentResult = unknown;
+/** Start Mandated Agent */
+/** `POST /ai/mandates/{mandate_key}` · aidream · auth guest · org required · ndjson */
+declare function startMandatedAgent(api: Api, args: StartMandatedAgentArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type InvalidateAgentCacheArgs = {
+    path: {
+        agent_id: string;
+    };
+    query?: {
+        is_version?: boolean;
+    };
+};
+type InvalidateAgentCacheResult = InvalidateAgentCacheResponse;
+/** Invalidate Agent Cache */
+/** `POST /ai/agents/{agent_id}/invalidate-cache` · aidream · auth guest · org required */
+declare function invalidateAgentCache(api: Api, args: InvalidateAgentCacheArgs, options?: CallOptions): Promise<InvalidateAgentCacheResult>;
+type MockStreamArgs = {
+    path: {
+        scenario: string;
+    };
+    body?: MockStreamRequest;
+};
+type MockStreamResult = unknown;
+/** Mock Stream */
+/** `POST /ai/mock-stream/{scenario}` · aidream · auth guest · org required · ndjson */
+declare function mockStream(api: Api, args: MockStreamArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type ListScenariosArgs = {
+    [key: string]: never;
+};
+type ListScenariosResult = MockScenarioList;
+/** List Scenarios */
+/** `GET /ai/mock-stream/scenarios` · aidream · auth guest · org optional */
+declare function listScenarios(api: Api, args?: ListScenariosArgs, options?: CallOptions): Promise<ListScenariosResult>;
+type GetUserPromptsArgs = {
+    [key: string]: never;
+};
+type GetUserPromptsResult = UserPromptCatalogResponse;
+/** Get User Prompts */
+/** `GET /ai/prompts` · aidream · auth guest · org optional */
+declare function getUserPrompts(api: Api, args?: GetUserPromptsArgs, options?: CallOptions): Promise<GetUserPromptsResult>;
+type GetUserPromptsAndBuiltinsArgs = {
+    [key: string]: never;
+};
+type GetUserPromptsAndBuiltinsResult = CombinedPromptCatalogResponse;
+/** Get User Prompts And Builtins */
+/** `GET /ai/prompts/all` · aidream · auth guest · org optional */
+declare function getUserPromptsAndBuiltins(api: Api, args?: GetUserPromptsAndBuiltinsArgs, options?: CallOptions): Promise<GetUserPromptsAndBuiltinsResult>;
+type StartPromptArgs = {
+    path: {
+        prompt_id: string;
+    };
+    body: PromptStartRequest;
+};
+type StartPromptResult = unknown;
+/** Start Prompt */
+/** `POST /ai/prompts/{prompt_id}` · aidream · auth guest · org required · ndjson */
+declare function startPrompt(api: Api, args: StartPromptArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type StartAgentBlocksArgs = {
+    path: {
+        agent_id: string;
+    };
+    body: AgentBlocksStartRequest;
+};
+type StartAgentBlocksResult = unknown;
+/** Start Agent Blocks */
+/** `POST /ai/agents-blocks/{agent_id}` · aidream · auth guest · org required · ndjson */
+declare function startAgentBlocks(api: Api, args: StartAgentBlocksArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type PreviewContextArgs = {
+    body: ContextPreviewRequest;
+};
+type PreviewContextResult = ContextPreviewResponse;
+/** Preview Context */
+/** `POST /ai/context/preview` · aidream · auth guest · org required */
+declare function previewContext(api: Api, args: PreviewContextArgs, options?: CallOptions): Promise<PreviewContextResult>;
+type PreviewAnswerBothArgs = {
+    body: ContextAnswerBothRequest;
+};
+type PreviewAnswerBothResult = ContextAnswerBothResponse;
+/** Preview Answer Both */
+/** `POST /ai/context/preview/answer-both` · aidream · auth guest · org required */
+declare function previewAnswerBoth(api: Api, args: PreviewAnswerBothArgs, options?: CallOptions): Promise<PreviewAnswerBothResult>;
+type ContextDeliveredArgs = {
+    query: {
+        conversation_id: string;
+        message_id: string;
+        kind: "delivered" | "on_request" | "block" | "fetchable";
+        key: string;
+    };
+};
+type ContextDeliveredResult = ContextViewedText;
+/** Context Delivered */
+/** `GET /ai/context/delivered` · aidream · auth guest · org optional */
+declare function contextDelivered(api: Api, args: ContextDeliveredArgs, options?: CallOptions): Promise<ContextDeliveredResult>;
+type GetRealtimeToolsArgs = {
+    path: {
+        agent_id: string;
+    };
+    body: RealtimeToolsRequest;
+};
+type GetRealtimeToolsResult = RealtimeToolsResponse;
+/** Get Realtime Tools */
+/** `POST /ai/agents/{agent_id}/realtime-tools` · aidream · auth guest · org required */
+declare function getRealtimeTools(api: Api, args: GetRealtimeToolsArgs, options?: CallOptions): Promise<GetRealtimeToolsResult>;
+type GetRealtimeSessionArgs = {
+    path: {
+        agent_id: string;
+    };
+    body: RealtimeSessionRequest;
+};
+type GetRealtimeSessionResult = RealtimeSessionResponse;
+/** Get Realtime Session */
+/** `POST /ai/agents/{agent_id}/realtime-session` · aidream · auth guest · org required */
+declare function getRealtimeSession(api: Api, args: GetRealtimeSessionArgs, options?: CallOptions): Promise<GetRealtimeSessionResult>;
+type ExecuteRealtimeToolRouteArgs = {
+    body: ToolExecuteRequest;
+};
+type ExecuteRealtimeToolRouteResult = ToolExecuteResponse;
+/** Execute Realtime Tool Route */
+/** `POST /ai/tools/execute` · aidream · auth guest · org required */
+declare function executeRealtimeToolRoute(api: Api, args: ExecuteRealtimeToolRouteArgs, options?: CallOptions): Promise<ExecuteRealtimeToolRouteResult>;
+type GetPortableAgentVersionArgs = {
+    path: {
+        version_id: string;
+    };
+    body: PortableAgentRequest;
+};
+type GetPortableAgentVersionResult = PortableAgentBundle;
+/** Get Portable Agent Version */
+/** `POST /ai/agents/versions/{version_id}/portable` · aidream · auth guest · org required */
+declare function getPortableAgentVersion(api: Api, args: GetPortableAgentVersionArgs, options?: CallOptions): Promise<GetPortableAgentVersionResult>;
+type GetPortableAgentArgs = {
+    path: {
+        agent_id: string;
+    };
+    body: PortableAgentRequest;
+};
+type GetPortableAgentResult = PortableAgentBundle;
+/** Get Portable Agent */
+/** `POST /ai/agents/{agent_id}/portable` · aidream · auth guest · org required */
+declare function getPortableAgent(api: Api, args: GetPortableAgentArgs, options?: CallOptions): Promise<GetPortableAgentResult>;
+type GetPortableAgentSummaryArgs = {
+    path: {
+        agent_id: string;
+    };
+};
+type GetPortableAgentSummaryResult = PortableAgentSummary;
+/** Get Portable Agent Summary */
+/** `GET /ai/agents/{agent_id}/portable/summary` · aidream · auth guest · org optional */
+declare function getPortableAgentSummary(api: Api, args: GetPortableAgentSummaryArgs, options?: CallOptions): Promise<GetPortableAgentSummaryResult>;
+type SkillsListSkillsArgs = {
+    query?: {
+        category_id?: string | null;
+        is_public_only?: boolean;
+        project_id?: string | null;
+        limit?: number;
+    };
+};
+type SkillsListSkillsResult = SkillsList;
+/** List Skills */
+/** `GET /skills` · aidream · auth guest · org optional */
+declare function skillsListSkills(api: Api, args?: SkillsListSkillsArgs, options?: CallOptions): Promise<SkillsListSkillsResult>;
+type CreateSkillArgs = {
+    body: SkillCreate;
+};
+type CreateSkillResult = SkillRow;
+/** Create Skill */
+/** `POST /skills` · aidream · auth guest · org required */
+declare function createSkill(api: Api, args: CreateSkillArgs, options?: CallOptions): Promise<CreateSkillResult>;
+type ListCategoriesArgs = {
+    [key: string]: never;
+};
+type ListCategoriesResult = CategoryList;
+/** List Categories */
+/** `GET /skills/categories` · aidream · auth guest · org optional */
+declare function listCategories(api: Api, args?: ListCategoriesArgs, options?: CallOptions): Promise<ListCategoriesResult>;
+type CreateCategoryArgs = {
+    body: CategoryCreate;
+};
+type CreateCategoryResult = CategoryRow;
+/** Create Category */
+/** `POST /skills/categories` · aidream · auth guest · org required */
+declare function createCategory(api: Api, args: CreateCategoryArgs, options?: CallOptions): Promise<CreateCategoryResult>;
+type PatchCategoryArgs = {
+    path: {
+        category_id: string;
+    };
+    body: CategoryPatch;
+};
+type PatchCategoryResult = CategoryRow;
+/** Patch Category */
+/** `PATCH /skills/categories/{category_id}` · aidream · auth guest · org required */
+declare function patchCategory(api: Api, args: PatchCategoryArgs, options?: CallOptions): Promise<PatchCategoryResult>;
+type DeleteCategoryArgs = {
+    path: {
+        category_id: string;
+    };
+};
+type DeleteCategoryResult = void;
+/** Delete Category */
+/** `DELETE /skills/categories/{category_id}` · aidream · auth guest · org required */
+declare function deleteCategory(api: Api, args: DeleteCategoryArgs, options?: CallOptions): Promise<DeleteCategoryResult>;
+type GetSkillArgs = {
+    path: {
+        skill_ref: string;
+    };
+};
+type GetSkillResult = SkillRow;
+/** Get Skill */
+/** `GET /skills/{skill_ref}` · aidream · auth guest · org optional */
+declare function getSkill(api: Api, args: GetSkillArgs, options?: CallOptions): Promise<GetSkillResult>;
+type PatchSkillArgs = {
+    path: {
+        skill_id: string;
+    };
+    body: SkillPatch;
+};
+type PatchSkillResult = SkillRow;
+/** Patch Skill */
+/** `PATCH /skills/{skill_id}` · aidream · auth guest · org required */
+declare function patchSkill(api: Api, args: PatchSkillArgs, options?: CallOptions): Promise<PatchSkillResult>;
+type DeleteSkillArgs = {
+    path: {
+        skill_id: string;
+    };
+};
+type DeleteSkillResult = void;
+/** Delete Skill */
+/** `DELETE /skills/{skill_id}` · aidream · auth guest · org required */
+declare function deleteSkill(api: Api, args: DeleteSkillArgs, options?: CallOptions): Promise<DeleteSkillResult>;
+type AdminIngestFilesystemArgs = {
+    body: aidream__api__routers__skills__IngestRequest;
+};
+type AdminIngestFilesystemResult = IngestReport;
+/** Admin Ingest Filesystem */
+/** `POST /skills/ingest` · aidream · auth guest · org required */
+declare function adminIngestFilesystem(api: Api, args: AdminIngestFilesystemArgs, options?: CallOptions): Promise<AdminIngestFilesystemResult>;
+type ScreenRunArgs = {
+    body: ScreenRunRequest;
+};
+type ScreenRunResult = ScreenRunResponse;
+/** Screen Run */
+/** `POST /tools/screen-run` · aidream · auth guest · org required */
+declare function screenRun(api: Api, args: ScreenRunArgs, options?: CallOptions): Promise<ScreenRunResult>;
+type ListAgentsArgs = {
+    query?: {
+        category?: string | null;
+        tags?: string[] | null;
+        query?: string | null;
+        limit?: number;
+    };
+};
+type ListAgentsResult = CatalogTree;
+/** List Agents */
+/** `GET /agent-service/agents` · aidream · auth guest · org optional */
+declare function listAgents(api: Api, args?: ListAgentsArgs, options?: CallOptions): Promise<ListAgentsResult>;
+type CreateAgentArgs = {
+    body: CreateAgentInput;
+};
+type CreateAgentResult = AgentDetail;
+/** Create Agent */
+/** `POST /agent-service/agents` · aidream · auth guest · org required */
+declare function createAgent(api: Api, args: CreateAgentArgs, options?: CallOptions): Promise<CreateAgentResult>;
+type GetAgentArgs = {
+    path: {
+        agent_id: string;
+    };
+};
+type GetAgentResult = AgentDetail;
+/** Get Agent */
+/** `GET /agent-service/agents/{agent_id}` · aidream · auth guest · org optional */
+declare function getAgent(api: Api, args: GetAgentArgs, options?: CallOptions): Promise<GetAgentResult>;
+type UpdateAgentArgs = {
+    path: {
+        agent_id: string;
+    };
+    body: UpdateAgentInput;
+};
+type UpdateAgentResult = AgentDetail;
+/** Update Agent */
+/** `PATCH /agent-service/agents/{agent_id}` · aidream · auth guest · org required */
+declare function updateAgent(api: Api, args: UpdateAgentArgs, options?: CallOptions): Promise<UpdateAgentResult>;
+type ListVersionsArgs = {
+    path: {
+        agent_id: string;
+    };
+};
+type ListVersionsResult = AgentVersionInfo[];
+/** List Versions */
+/** `GET /agent-service/agents/{agent_id}/versions` · aidream · auth guest · org optional */
+declare function listVersions(api: Api, args: ListVersionsArgs, options?: CallOptions): Promise<ListVersionsResult>;
+type GetVersionArgs = {
+    path: {
+        version_id: string;
+    };
+};
+type GetVersionResult = AgentDetail;
+/** Get Version */
+/** `GET /agent-service/versions/{version_id}` · aidream · auth guest · org optional */
+declare function getVersion(api: Api, args: GetVersionArgs, options?: CallOptions): Promise<GetVersionResult>;
+type ListModelsArgs = {
+    query?: {
+        include_deprecated?: boolean;
+        output_types?: string[] | null;
+        capability?: string | null;
+        provider?: string | null;
+        query?: string | null;
+        primary_only?: boolean;
+        model_ids?: string[] | null;
+    };
+};
+type ListModelsResult = ModelInfo[];
+/** List Models */
+/** `GET /agent-service/models` · aidream · auth guest · org optional */
+declare function listModels(api: Api, args?: ListModelsArgs, options?: CallOptions): Promise<ListModelsResult>;
+type AgentServiceListToolsArgs = {
+    query?: {
+        category?: string | null;
+        tags?: string[] | null;
+        query?: string | null;
+    };
+};
+type AgentServiceListToolsResult = ToolInfo[];
+/** List Tools */
+/** `GET /agent-service/tools` · aidream · auth guest · org optional */
+declare function agentServiceListTools(api: Api, args?: AgentServiceListToolsArgs, options?: CallOptions): Promise<AgentServiceListToolsResult>;
+type AgentServiceListSkillsArgs = {
+    query?: {
+        category?: string | null;
+        query?: string | null;
+        limit?: number;
+    };
+};
+type AgentServiceListSkillsResult = SkillInfo[];
+/** List Skills */
+/** `GET /agent-service/skills` · aidream · auth guest · org optional */
+declare function agentServiceListSkills(api: Api, args?: AgentServiceListSkillsArgs, options?: CallOptions): Promise<AgentServiceListSkillsResult>;
+type CreateStructuredAgentArgs = {
+    body: CreateAgentInput;
+};
+type CreateStructuredAgentResult = AgentDetail;
+/** Create Structured Agent */
+/** `POST /agent-service/agents/structured` · aidream · auth guest · org required */
+declare function createStructuredAgent(api: Api, args: CreateStructuredAgentArgs, options?: CallOptions): Promise<CreateStructuredAgentResult>;
+type ValidateSchemaArgs = {
+    body: ValidateSchemaRequest;
+};
+type ValidateSchemaResult = SchemaGateReport;
+/** Validate Schema */
+/** `POST /agent-service/validate-schema` · aidream · auth guest · org required */
+declare function validateSchema(api: Api, args: ValidateSchemaArgs, options?: CallOptions): Promise<ValidateSchemaResult>;
+type StartBuildArgs = {
+    body: StartBuildBody;
+};
+type StartBuildResult = StartBuildResponse;
+/** Start Build */
+/** `POST /agent-factory/builds` · aidream · auth user · org required */
+declare function startBuild(api: Api, args: StartBuildArgs, options?: CallOptions): Promise<StartBuildResult>;
+type ReadBuildArgs = {
+    path: {
+        build_id: string;
+    };
+};
+type ReadBuildResult = BuildResponse;
+/** Read Build */
+/** `GET /agent-factory/builds/{build_id}` · aidream · auth user · org required */
+declare function readBuild(api: Api, args: ReadBuildArgs, options?: CallOptions): Promise<ReadBuildResult>;
+type KeepBuildArgs = {
+    path: {
+        build_id: string;
+    };
+};
+type KeepBuildResult = KeepResponse;
+/** Keep Build */
+/** `POST /agent-factory/builds/{build_id}/keep` · aidream · auth user · org required */
+declare function keepBuild(api: Api, args: KeepBuildArgs, options?: CallOptions): Promise<KeepBuildResult>;
+type JudgeFirstRunsArgs = {
+    path: {
+        agent_id: string;
+    };
+};
+type JudgeFirstRunsResult = FirstRunsResponse;
+/** Judge First Runs */
+/** `POST /agent-factory/agents/{agent_id}/first-runs` · aidream · auth user · org required */
+declare function judgeFirstRuns(api: Api, args: JudgeFirstRunsArgs, options?: CallOptions): Promise<JudgeFirstRunsResult>;
+type AgentFromChatArgs = {
+    body: AgentFromChatRequest;
+};
+type AgentFromChatResult = unknown;
+/** Agent From Chat */
+/** `POST /agent-studio/from-chat` · aidream · auth user · org required · ndjson */
+declare function agentFromChat(api: Api, args: AgentFromChatArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type AdminAgentFromChatArgs = {
+    body: AgentFromChatRequest;
+};
+type AdminAgentFromChatResult = unknown;
+/** Admin Agent From Chat */
+/** `POST /admin/agent-studio/from-chat` · aidream · auth admin · org exempt · ndjson */
+declare function adminAgentFromChat(api: Api, args: AdminAgentFromChatArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type AdminToolsListToolsArgs = {
+    [key: string]: never;
+};
+type AdminToolsListToolsResult = aidream__services__admin_ops__tools_wire__ToolListResponse;
+/** List Tools */
+/** `GET /admin/tools` · aidream · auth admin · org exempt */
+declare function adminToolsListTools(api: Api, args?: AdminToolsListToolsArgs, options?: CallOptions): Promise<AdminToolsListToolsResult>;
+type ValidateAllOpArgs = {
+    [key: string]: never;
+};
+type ValidateAllOpResult = ValidationReportResponse;
+/** Validate All */
+/** `POST /admin/tools/validate` · aidream · auth admin · org exempt */
+declare function validateAll(api: Api, args?: ValidateAllOpArgs, options?: CallOptions): Promise<ValidateAllOpResult>;
+type FailureAnalyticsArgs = {
+    query?: {
+        sample?: number;
+    };
+};
+type FailureAnalyticsResult = FailureAnalyticsResponse;
+/** Failure Analytics */
+/** `GET /admin/tools/failures` · aidream · auth admin · org exempt */
+declare function failureAnalytics(api: Api, args?: FailureAnalyticsArgs, options?: CallOptions): Promise<FailureAnalyticsResult>;
+type ToolDetailArgs = {
+    path: {
+        name: string;
+    };
+};
+type ToolDetailResult = ToolDetail;
+/** Tool Detail */
+/** `GET /admin/tools/{name}` · aidream · auth admin · org exempt */
+declare function toolDetail(api: Api, args: ToolDetailArgs, options?: CallOptions): Promise<ToolDetailResult>;
+type UpdateToolArgs = {
+    path: {
+        name: string;
+    };
+    body: ToolUpdateRequest;
+};
+type UpdateToolResult = ToolRow;
+/** Update Tool */
+/** `PATCH /admin/tools/{name}` · aidream · auth admin · org exempt */
+declare function updateTool(api: Api, args: UpdateToolArgs, options?: CallOptions): Promise<UpdateToolResult>;
+type ToolTestingListToolsArgs = {
+    query?: {
+        category?: string | null;
+    };
+};
+type ToolTestingListToolsResult = aidream__api__routers__tool_testing__ToolListResponse;
+/** List Tools */
+/** `GET /tools/test/list` · aidream · auth guest · org optional */
+declare function toolTestingListTools(api: Api, args?: ToolTestingListToolsArgs, options?: CallOptions): Promise<ToolTestingListToolsResult>;
+type GetToolDetailArgs = {
+    path: {
+        tool_name: string;
+    };
+};
+type GetToolDetailResult = ToolDetailResponse;
+/** Get Tool Detail */
+/** `GET /tools/test/{tool_name}` · aidream · auth guest · org optional */
+declare function getToolDetail(api: Api, args: GetToolDetailArgs, options?: CallOptions): Promise<GetToolDetailResult>;
+type GetOrCreateTestSessionArgs = {
+    [key: string]: never;
+};
+type GetOrCreateTestSessionResult = ToolTestSessionResponse;
+/** Get Or Create Test Session */
+/** `POST /tools/test/session` · aidream · auth guest · org required */
+declare function getOrCreateTestSession(api: Api, args?: GetOrCreateTestSessionArgs, options?: CallOptions): Promise<GetOrCreateTestSessionResult>;
+type ExecuteToolTestArgs = {
+    body: ToolTestExecuteRequest;
+};
+type ExecuteToolTestResult = unknown;
+/** Execute Tool Test */
+/** `POST /tools/test/execute` · aidream · auth guest · org required · ndjson */
+declare function executeToolTest(api: Api, args: ExecuteToolTestArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type GetDbSurfaceManifestArgs = {
+    path: {
+        client_name: string;
+        surface_name: string;
+    };
+};
+type GetDbSurfaceManifestResult = SurfaceManifest;
+/** Get Db Surface Manifest */
+/** `GET /surfaces/{client_name}/{surface_name}/manifest` · aidream · auth guest · org exempt */
+declare function getDbSurfaceManifest(api: Api, args: GetDbSurfaceManifestArgs, options?: CallOptions): Promise<GetDbSurfaceManifestResult>;
+type GetCapabilityManifestArgs = {
+    path: {
+        name: string;
+    };
+};
+type GetCapabilityManifestResult = SurfaceManifest;
+/** Get Capability Manifest */
+/** `GET /surfaces/{name}/manifest` · aidream · auth guest · org exempt */
+declare function getCapabilityManifest(api: Api, args: GetCapabilityManifestArgs, options?: CallOptions): Promise<GetCapabilityManifestResult>;
+type CacheBustArgs = {
+    [key: string]: never;
+};
+type CacheBustResult = CacheBustResponse;
+/** Cache Bust */
+/** `POST /admin/tool-routing/cache-bust` · aidream · auth admin · org exempt */
+declare function cacheBust(api: Api, args?: CacheBustArgs, options?: CallOptions): Promise<CacheBustResult>;
+type RunAgentTestsArgs = {
+    path: {
+        agent_id: string;
+    };
+    body: AgentTestBatchRequest;
+};
+type RunAgentTestsResult = AgentTestBatchResponse;
+/** Run Agent Tests */
+/** `POST /agent-testing/agents/{agent_id}/tests` · aidream · auth admin · org required */
+declare function runAgentTests(api: Api, args: RunAgentTestsArgs, options?: CallOptions): Promise<RunAgentTestsResult>;
+type GetAgentExecutionDefinitionArgs = {
+    path: {
+        agent_id: string;
+    };
+};
+type GetAgentExecutionDefinitionResult = ExecutionAgentDefinition;
+/** Get Agent Execution Definition */
+/** `GET /agents/{agent_id}/execution-definition` · aidream · auth guest · org optional */
+declare function getAgentExecutionDefinition(api: Api, args: GetAgentExecutionDefinitionArgs, options?: CallOptions): Promise<GetAgentExecutionDefinitionResult>;
+type GetAgentVersionExecutionDefinitionArgs = {
+    path: {
+        version_id: string;
+    };
+};
+type GetAgentVersionExecutionDefinitionResult = ExecutionAgentDefinition;
+/** Get Agent Version Execution Definition */
+/** `GET /agents/versions/{version_id}/execution-definition` · aidream · auth guest · org optional */
+declare function getAgentVersionExecutionDefinition(api: Api, args: GetAgentVersionExecutionDefinitionArgs, options?: CallOptions): Promise<GetAgentVersionExecutionDefinitionResult>;
+type PreviewVariableBindingArgs = {
+    body: VariableBindingPreviewRequest;
+};
+type PreviewVariableBindingResult = VariableBindingPreviewResponse;
+/** Preview Variable Binding */
+/** `POST /agents/variable-bindings/preview` · aidream · auth guest · org required */
+declare function previewVariableBinding(api: Api, args: PreviewVariableBindingArgs, options?: CallOptions): Promise<PreviewVariableBindingResult>;
+type RunMatrixBattleArgs = {
+    path: {
+        set_id: string;
+    };
+    body: MatrixRunRequest;
+};
+type RunMatrixBattleResult = unknown;
+/** Run Matrix Battle */
+/** `POST /agent-battles/{set_id}/run` · aidream · auth guest · org required · ndjson */
+declare function runMatrixBattle(api: Api, args: RunMatrixBattleArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type CancelMatrixBattleArgs = {
+    path: {
+        set_id: string;
+    };
+};
+type CancelMatrixBattleResult = MatrixCancelResponse;
+/** Cancel Matrix Battle */
+/** `POST /agent-battles/{set_id}/cancel` · aidream · auth guest · org required */
+declare function cancelMatrixBattle(api: Api, args: CancelMatrixBattleArgs, options?: CallOptions): Promise<CancelMatrixBattleResult>;
+type ListContextOrganizationsArgs = {
+    [key: string]: never;
+};
+type ListContextOrganizationsResult = ContextOrganizationsResponse;
+/** List Context Organizations */
+/** `GET /admin/agent-context/organizations` · aidream · auth admin · org exempt */
+declare function listContextOrganizations(api: Api, args?: ListContextOrganizationsArgs, options?: CallOptions): Promise<ListContextOrganizationsResult>;
+type RenderContextArgs = {
+    body: ContextRenderRequest;
+};
+type RenderContextResult = ContextRenderResponse;
+/** Render Context */
+/** `POST /admin/agent-context/render` · aidream · auth admin · org exempt */
+declare function renderContext(api: Api, args: RenderContextArgs, options?: CallOptions): Promise<RenderContextResult>;
+type GetDirectiveCatalogArgs = {
+    [key: string]: never;
+};
+type GetDirectiveCatalogResult = DirectiveCatalog;
+/** Get Directive Catalog */
+/** `GET /directives/catalog` · aidream · auth public · org exempt */
+declare function getDirectiveCatalog(api: Api, args?: GetDirectiveCatalogArgs, options?: CallOptions): Promise<GetDirectiveCatalogResult>;
+type GetDirectiveNounSchemasArgs = {
+    path: {
+        noun: string;
+    };
+};
+type GetDirectiveNounSchemasResult = DirectiveNounSchemas;
+/** Get Directive Noun Schemas */
+/** `GET /directives/catalog/{noun}` · aidream · auth public · org exempt */
+declare function getDirectiveNounSchemas(api: Api, args: GetDirectiveNounSchemasArgs, options?: CallOptions): Promise<GetDirectiveNounSchemasResult>;
+type ExecuteWriteDirectiveArgs = {
+    body: DirectiveExecuteRequest;
+};
+type ExecuteWriteDirectiveResult = DirectiveApplyResult;
+/** Execute Write Directive */
+/** `POST /directives/execute` · aidream · auth guest · org required */
+declare function executeWriteDirective(api: Api, args: ExecuteWriteDirectiveArgs, options?: CallOptions): Promise<ExecuteWriteDirectiveResult>;
+type ConfirmProposedDirectiveArgs = {
+    body: DirectiveConfirmRequest;
+};
+type ConfirmProposedDirectiveResult = DirectiveConfirmResult;
+/** Confirm Proposed Directive */
+/** `POST /directives/confirm` · aidream · auth guest · org required */
+declare function confirmProposedDirective(api: Api, args: ConfirmProposedDirectiveArgs, options?: CallOptions): Promise<ConfirmProposedDirectiveResult>;
+type ReadDirectiveApplyStateArgs = {
+    body: DirectiveApplyStateRequest;
+};
+type ReadDirectiveApplyStateResult = DirectiveApplyStateResult;
+/** Read Directive Apply State */
+/** `POST /directives/apply_state` · aidream · auth guest · org required */
+declare function readDirectiveApplyState(api: Api, args: ReadDirectiveApplyStateArgs, options?: CallOptions): Promise<ReadDirectiveApplyStateResult>;
+type ListToolsArgs = {
+    [key: string]: never;
+};
+type ListToolsResult = {
+    [key: string]: string[];
+};
+/** List Tools */
+/** `GET /tools/list` · matrx-local · auth public · org exempt */
+declare function listTools(api: Api, args?: ListToolsArgs, options?: CallOptions): Promise<ListToolsResult>;
+type InvokeToolArgs = {
+    body: ToolRequest;
+};
+type InvokeToolResult = ToolResponse;
+/** Invoke Tool */
+/** `POST /tools/invoke` · matrx-local · auth loopback_token · org exempt */
+declare function invokeTool(api: Api, args: InvokeToolArgs, options?: CallOptions): Promise<InvokeToolResult>;
+type GetAgentCatalogArgs = {
+    [key: string]: never;
+};
+type GetAgentCatalogResult = {
+    [key: string]: unknown;
+}[];
+/** Get Agent Catalog */
+/** `GET /agents/catalog` · matrx-local · auth loopback_open · org exempt */
+declare function getAgentCatalog(api: Api, args?: GetAgentCatalogArgs, options?: CallOptions): Promise<GetAgentCatalogResult>;
+type PostAgentCatalogRpcArgs = {
+    body: CatalogRpcRequest;
+};
+type PostAgentCatalogRpcResult = {
+    [key: string]: unknown;
+}[];
+/** Post Agent Catalog Rpc */
+/** `POST /agents/catalog/rpc` · matrx-local · auth loopback_open · org exempt */
+declare function postAgentCatalogRpc(api: Api, args: PostAgentCatalogRpcArgs, options?: CallOptions): Promise<PostAgentCatalogRpcResult>;
+type GetAgentExecutionArgs = {
+    path: {
+        agent_id: string;
+    };
+};
+type GetAgentExecutionResult = unknown;
+/** Get Agent Execution */
+/** `GET /agents/catalog/{agent_id}/execution` · matrx-local · auth loopback_open · org exempt */
+declare function getAgentExecution(api: Api, args: GetAgentExecutionArgs, options?: CallOptions): Promise<GetAgentExecutionResult>;
+type GetAgentCatalogStatusArgs = {
+    [key: string]: never;
+};
+type GetAgentCatalogStatusResult = {
+    [key: string]: unknown;
+};
+/** Get Agent Catalog Status */
+/** `GET /agents/catalog/status` · matrx-local · auth loopback_open · org exempt */
+declare function getAgentCatalogStatus(api: Api, args?: GetAgentCatalogStatusArgs, options?: CallOptions): Promise<GetAgentCatalogStatusResult>;
+type PromptMatrixPathsArgs = {
+    [key: string]: never;
+};
+type PromptMatrixPathsResult = {
+    [key: string]: string;
+};
+/** Prompt Matrix Paths */
+/** `GET /prompt-matrix/paths` · matrx-local · auth loopback_token · org exempt */
+declare function promptMatrixPaths(api: Api, args?: PromptMatrixPathsArgs, options?: CallOptions): Promise<PromptMatrixPathsResult>;
+type GetLibraryArgs = {
+    [key: string]: never;
+};
+type GetLibraryResult = {
+    [key: string]: unknown;
+};
+/** Get Library */
+/** `GET /prompt-matrix/library` · matrx-local · auth loopback_token · org exempt */
+declare function getLibrary(api: Api, args?: GetLibraryArgs, options?: CallOptions): Promise<GetLibraryResult>;
+type PutLibraryArgs = {
+    body: LibraryPut;
+};
+type PutLibraryResult = {
+    [key: string]: unknown;
+};
+/** Put Library */
+/** `PUT /prompt-matrix/library` · matrx-local · auth loopback_token · org exempt */
+declare function putLibrary(api: Api, args: PutLibraryArgs, options?: CallOptions): Promise<PutLibraryResult>;
+type GetListsArgs = {
+    [key: string]: never;
+};
+type GetListsResult = {
+    [key: string]: unknown;
+};
+/** Get Lists */
+/** `GET /prompt-matrix/lists` · matrx-local · auth loopback_token · org exempt */
+declare function getLists(api: Api, args?: GetListsArgs, options?: CallOptions): Promise<GetListsResult>;
+type PutListsArgs = {
+    body: ListsPut;
+};
+type PutListsResult = {
+    [key: string]: unknown;
+};
+/** Put Lists */
+/** `PUT /prompt-matrix/lists` · matrx-local · auth loopback_token · org exempt */
+declare function putLists(api: Api, args: PutListsArgs, options?: CallOptions): Promise<PutListsResult>;
+type GetTemplatesArgs = {
+    [key: string]: never;
+};
+type GetTemplatesResult = {
+    [key: string]: unknown;
+};
+/** Get Templates */
+/** `GET /prompt-matrix/templates` · matrx-local · auth loopback_token · org exempt */
+declare function getTemplates(api: Api, args?: GetTemplatesArgs, options?: CallOptions): Promise<GetTemplatesResult>;
+type PutTemplatesArgs = {
+    body: TemplatesPut;
+};
+type PutTemplatesResult = {
+    [key: string]: unknown;
+};
+/** Put Templates */
+/** `PUT /prompt-matrix/templates` · matrx-local · auth loopback_token · org exempt */
+declare function putTemplates(api: Api, args: PutTemplatesArgs, options?: CallOptions): Promise<PutTemplatesResult>;
+type GetPromptsArgs = {
+    [key: string]: never;
+};
+type GetPromptsResult = {
+    [key: string]: unknown;
+};
+/** Get Prompts */
+/** `GET /prompt-matrix/prompts` · matrx-local · auth loopback_token · org exempt */
+declare function getPrompts(api: Api, args?: GetPromptsArgs, options?: CallOptions): Promise<GetPromptsResult>;
+type PutPromptsArgs = {
+    body: PromptsPut;
+};
+type PutPromptsResult = {
+    [key: string]: unknown;
+};
+/** Put Prompts */
+/** `PUT /prompt-matrix/prompts` · matrx-local · auth loopback_token · org exempt */
+declare function putPrompts(api: Api, args: PutPromptsArgs, options?: CallOptions): Promise<PutPromptsResult>;
+type GetVariationBatchesArgs = {
+    [key: string]: never;
+};
+type GetVariationBatchesResult = {
+    [key: string]: unknown;
+};
+/** Get Variation Batches */
+/** `GET /prompt-matrix/variation-batches` · matrx-local · auth loopback_token · org exempt */
+declare function getVariationBatches(api: Api, args?: GetVariationBatchesArgs, options?: CallOptions): Promise<GetVariationBatchesResult>;
+type PutVariationBatchesArgs = {
+    body: VariationBatchesPut;
+};
+type PutVariationBatchesResult = {
+    [key: string]: unknown;
+};
+/** Put Variation Batches */
+/** `PUT /prompt-matrix/variation-batches` · matrx-local · auth loopback_token · org exempt */
+declare function putVariationBatches(api: Api, args: PutVariationBatchesArgs, options?: CallOptions): Promise<PutVariationBatchesResult>;
+/** Every JSON operation of this domain by `METHOD path` — for path-keyed calls. */
+interface Operations {
+    "POST /ai/agents/{agent_id}/warm": {
+        args: WarmAgentArgs;
+        result: WarmAgentResult;
+    };
+    "GET /ai/prompts/builtins": {
+        args: GetAllPromptBuiltinsArgs;
+        result: GetAllPromptBuiltinsResult;
+    };
+    "POST /ai/prompts/{prompt_id}/warm": {
+        args: WarmPromptArgs;
+        result: WarmPromptResult;
+    };
+    "POST /ai/agents-blocks/{agent_id}/warm": {
+        args: WarmAgentBlocksArgs;
+        result: WarmAgentBlocksResult;
+    };
+    "GET /ai-tools": {
+        args: GetAllToolsArgs;
+        result: GetAllToolsResult;
+    };
+    "GET /ai-tools/source-kind/{source_kind}": {
+        args: GetToolsBySourceKindArgs;
+        result: GetToolsBySourceKindResult;
+    };
+    "GET /ai-tools/native/all": {
+        args: GetNativeToolsArgs;
+        result: GetNativeToolsResult;
+    };
+    "GET /ai-tools/mcp-discovered/all": {
+        args: GetMcpDiscoveredToolsArgs;
+        result: GetMcpDiscoveredToolsResult;
+    };
+    "GET /ai-tools/app/{executor_name}/all": {
+        args: GetToolsForAppArgs;
+        result: GetToolsForAppResult;
+    };
+    "GET /ai-tools/{tool_id}": {
+        args: GetToolByIdArgs;
+        result: GetToolByIdResult;
+    };
+    "POST /ai/agents/{agent_id}/invalidate-cache": {
+        args: InvalidateAgentCacheArgs;
+        result: InvalidateAgentCacheResult;
+    };
+    "GET /ai/mock-stream/scenarios": {
+        args: ListScenariosArgs;
+        result: ListScenariosResult;
+    };
+    "GET /ai/prompts": {
+        args: GetUserPromptsArgs;
+        result: GetUserPromptsResult;
+    };
+    "GET /ai/prompts/all": {
+        args: GetUserPromptsAndBuiltinsArgs;
+        result: GetUserPromptsAndBuiltinsResult;
+    };
+    "POST /ai/context/preview": {
+        args: PreviewContextArgs;
+        result: PreviewContextResult;
+    };
+    "POST /ai/context/preview/answer-both": {
+        args: PreviewAnswerBothArgs;
+        result: PreviewAnswerBothResult;
+    };
+    "GET /ai/context/delivered": {
+        args: ContextDeliveredArgs;
+        result: ContextDeliveredResult;
+    };
+    "POST /ai/agents/{agent_id}/realtime-tools": {
+        args: GetRealtimeToolsArgs;
+        result: GetRealtimeToolsResult;
+    };
+    "POST /ai/agents/{agent_id}/realtime-session": {
+        args: GetRealtimeSessionArgs;
+        result: GetRealtimeSessionResult;
+    };
+    "POST /ai/tools/execute": {
+        args: ExecuteRealtimeToolRouteArgs;
+        result: ExecuteRealtimeToolRouteResult;
+    };
+    "POST /ai/agents/versions/{version_id}/portable": {
+        args: GetPortableAgentVersionArgs;
+        result: GetPortableAgentVersionResult;
+    };
+    "POST /ai/agents/{agent_id}/portable": {
+        args: GetPortableAgentArgs;
+        result: GetPortableAgentResult;
+    };
+    "GET /ai/agents/{agent_id}/portable/summary": {
+        args: GetPortableAgentSummaryArgs;
+        result: GetPortableAgentSummaryResult;
+    };
+    "GET /skills": {
+        args: SkillsListSkillsArgs;
+        result: SkillsListSkillsResult;
+    };
+    "POST /skills": {
+        args: CreateSkillArgs;
+        result: CreateSkillResult;
+    };
+    "GET /skills/categories": {
+        args: ListCategoriesArgs;
+        result: ListCategoriesResult;
+    };
+    "POST /skills/categories": {
+        args: CreateCategoryArgs;
+        result: CreateCategoryResult;
+    };
+    "PATCH /skills/categories/{category_id}": {
+        args: PatchCategoryArgs;
+        result: PatchCategoryResult;
+    };
+    "DELETE /skills/categories/{category_id}": {
+        args: DeleteCategoryArgs;
+        result: DeleteCategoryResult;
+    };
+    "GET /skills/{skill_ref}": {
+        args: GetSkillArgs;
+        result: GetSkillResult;
+    };
+    "PATCH /skills/{skill_id}": {
+        args: PatchSkillArgs;
+        result: PatchSkillResult;
+    };
+    "DELETE /skills/{skill_id}": {
+        args: DeleteSkillArgs;
+        result: DeleteSkillResult;
+    };
+    "POST /skills/ingest": {
+        args: AdminIngestFilesystemArgs;
+        result: AdminIngestFilesystemResult;
+    };
+    "POST /tools/screen-run": {
+        args: ScreenRunArgs;
+        result: ScreenRunResult;
+    };
+    "GET /agent-service/agents": {
+        args: ListAgentsArgs;
+        result: ListAgentsResult;
+    };
+    "POST /agent-service/agents": {
+        args: CreateAgentArgs;
+        result: CreateAgentResult;
+    };
+    "GET /agent-service/agents/{agent_id}": {
+        args: GetAgentArgs;
+        result: GetAgentResult;
+    };
+    "PATCH /agent-service/agents/{agent_id}": {
+        args: UpdateAgentArgs;
+        result: UpdateAgentResult;
+    };
+    "GET /agent-service/agents/{agent_id}/versions": {
+        args: ListVersionsArgs;
+        result: ListVersionsResult;
+    };
+    "GET /agent-service/versions/{version_id}": {
+        args: GetVersionArgs;
+        result: GetVersionResult;
+    };
+    "GET /agent-service/models": {
+        args: ListModelsArgs;
+        result: ListModelsResult;
+    };
+    "GET /agent-service/tools": {
+        args: AgentServiceListToolsArgs;
+        result: AgentServiceListToolsResult;
+    };
+    "GET /agent-service/skills": {
+        args: AgentServiceListSkillsArgs;
+        result: AgentServiceListSkillsResult;
+    };
+    "POST /agent-service/agents/structured": {
+        args: CreateStructuredAgentArgs;
+        result: CreateStructuredAgentResult;
+    };
+    "POST /agent-service/validate-schema": {
+        args: ValidateSchemaArgs;
+        result: ValidateSchemaResult;
+    };
+    "POST /agent-factory/builds": {
+        args: StartBuildArgs;
+        result: StartBuildResult;
+    };
+    "GET /agent-factory/builds/{build_id}": {
+        args: ReadBuildArgs;
+        result: ReadBuildResult;
+    };
+    "POST /agent-factory/builds/{build_id}/keep": {
+        args: KeepBuildArgs;
+        result: KeepBuildResult;
+    };
+    "POST /agent-factory/agents/{agent_id}/first-runs": {
+        args: JudgeFirstRunsArgs;
+        result: JudgeFirstRunsResult;
+    };
+    "GET /admin/tools": {
+        args: AdminToolsListToolsArgs;
+        result: AdminToolsListToolsResult;
+    };
+    "POST /admin/tools/validate": {
+        args: ValidateAllOpArgs;
+        result: ValidateAllOpResult;
+    };
+    "GET /admin/tools/failures": {
+        args: FailureAnalyticsArgs;
+        result: FailureAnalyticsResult;
+    };
+    "GET /admin/tools/{name}": {
+        args: ToolDetailArgs;
+        result: ToolDetailResult;
+    };
+    "PATCH /admin/tools/{name}": {
+        args: UpdateToolArgs;
+        result: UpdateToolResult;
+    };
+    "GET /tools/test/list": {
+        args: ToolTestingListToolsArgs;
+        result: ToolTestingListToolsResult;
+    };
+    "GET /tools/test/{tool_name}": {
+        args: GetToolDetailArgs;
+        result: GetToolDetailResult;
+    };
+    "POST /tools/test/session": {
+        args: GetOrCreateTestSessionArgs;
+        result: GetOrCreateTestSessionResult;
+    };
+    "GET /surfaces/{client_name}/{surface_name}/manifest": {
+        args: GetDbSurfaceManifestArgs;
+        result: GetDbSurfaceManifestResult;
+    };
+    "GET /surfaces/{name}/manifest": {
+        args: GetCapabilityManifestArgs;
+        result: GetCapabilityManifestResult;
+    };
+    "POST /admin/tool-routing/cache-bust": {
+        args: CacheBustArgs;
+        result: CacheBustResult;
+    };
+    "POST /agent-testing/agents/{agent_id}/tests": {
+        args: RunAgentTestsArgs;
+        result: RunAgentTestsResult;
+    };
+    "GET /agents/{agent_id}/execution-definition": {
+        args: GetAgentExecutionDefinitionArgs;
+        result: GetAgentExecutionDefinitionResult;
+    };
+    "GET /agents/versions/{version_id}/execution-definition": {
+        args: GetAgentVersionExecutionDefinitionArgs;
+        result: GetAgentVersionExecutionDefinitionResult;
+    };
+    "POST /agents/variable-bindings/preview": {
+        args: PreviewVariableBindingArgs;
+        result: PreviewVariableBindingResult;
+    };
+    "POST /agent-battles/{set_id}/cancel": {
+        args: CancelMatrixBattleArgs;
+        result: CancelMatrixBattleResult;
+    };
+    "GET /admin/agent-context/organizations": {
+        args: ListContextOrganizationsArgs;
+        result: ListContextOrganizationsResult;
+    };
+    "POST /admin/agent-context/render": {
+        args: RenderContextArgs;
+        result: RenderContextResult;
+    };
+    "GET /directives/catalog": {
+        args: GetDirectiveCatalogArgs;
+        result: GetDirectiveCatalogResult;
+    };
+    "GET /directives/catalog/{noun}": {
+        args: GetDirectiveNounSchemasArgs;
+        result: GetDirectiveNounSchemasResult;
+    };
+    "POST /directives/execute": {
+        args: ExecuteWriteDirectiveArgs;
+        result: ExecuteWriteDirectiveResult;
+    };
+    "POST /directives/confirm": {
+        args: ConfirmProposedDirectiveArgs;
+        result: ConfirmProposedDirectiveResult;
+    };
+    "POST /directives/apply_state": {
+        args: ReadDirectiveApplyStateArgs;
+        result: ReadDirectiveApplyStateResult;
+    };
+    "GET /tools/list": {
+        args: ListToolsArgs;
+        result: ListToolsResult;
+    };
+    "POST /tools/invoke": {
+        args: InvokeToolArgs;
+        result: InvokeToolResult;
+    };
+    "GET /agents/catalog": {
+        args: GetAgentCatalogArgs;
+        result: GetAgentCatalogResult;
+    };
+    "POST /agents/catalog/rpc": {
+        args: PostAgentCatalogRpcArgs;
+        result: PostAgentCatalogRpcResult;
+    };
+    "GET /agents/catalog/{agent_id}/execution": {
+        args: GetAgentExecutionArgs;
+        result: GetAgentExecutionResult;
+    };
+    "GET /agents/catalog/status": {
+        args: GetAgentCatalogStatusArgs;
+        result: GetAgentCatalogStatusResult;
+    };
+    "GET /prompt-matrix/paths": {
+        args: PromptMatrixPathsArgs;
+        result: PromptMatrixPathsResult;
+    };
+    "GET /prompt-matrix/library": {
+        args: GetLibraryArgs;
+        result: GetLibraryResult;
+    };
+    "PUT /prompt-matrix/library": {
+        args: PutLibraryArgs;
+        result: PutLibraryResult;
+    };
+    "GET /prompt-matrix/lists": {
+        args: GetListsArgs;
+        result: GetListsResult;
+    };
+    "PUT /prompt-matrix/lists": {
+        args: PutListsArgs;
+        result: PutListsResult;
+    };
+    "GET /prompt-matrix/templates": {
+        args: GetTemplatesArgs;
+        result: GetTemplatesResult;
+    };
+    "PUT /prompt-matrix/templates": {
+        args: PutTemplatesArgs;
+        result: PutTemplatesResult;
+    };
+    "GET /prompt-matrix/prompts": {
+        args: GetPromptsArgs;
+        result: GetPromptsResult;
+    };
+    "PUT /prompt-matrix/prompts": {
+        args: PutPromptsArgs;
+        result: PutPromptsResult;
+    };
+    "GET /prompt-matrix/variation-batches": {
+        args: GetVariationBatchesArgs;
+        result: GetVariationBatchesResult;
+    };
+    "PUT /prompt-matrix/variation-batches": {
+        args: PutVariationBatchesArgs;
+        result: PutVariationBatchesResult;
+    };
+}
+/** Path-keyed call, scoped to this domain only (never a global path map). */
+declare function call<K extends keyof Operations>(api: Api, key: K, args?: Operations[K]["args"], options?: CallOptions): Promise<Operations[K]["result"]>;
+
+export { type AdminAgentFromChatArgs, type AdminAgentFromChatResult, type AdminIngestFilesystemArgs, type AdminIngestFilesystemResult, type AdminToolsListToolsArgs, type AdminToolsListToolsResult, type AgentBlocksStartRequest, type AgentContextPolicy, type AgentDetail, type AgentFromChatArgs, type AgentFromChatRequest, type AgentFromChatResult, type AgentOwnership, type AgentServiceListSkillsArgs, type AgentServiceListSkillsResult, type AgentServiceListToolsArgs, type AgentServiceListToolsResult, type AgentSpec, type AgentSummary, type AgentTestBatchRequest, type AgentTestBatchResponse, type AgentTestResult, type AgentVariableControlInput, type AgentVariableDefinition, type AgentVariableDetail, type AgentVariableInput, type AgentVersionInfo, type AgentsStartAgentArgs, type AgentsStartAgentPostArgs, type AgentsStartAgentPostResult, type AgentsStartAgentResult, type BuildResponse, type BuiltinPromptCatalogResponse, type CacheBustArgs, type CacheBustResponse, type CacheBustResult, type CancelMatrixBattleArgs, type CancelMatrixBattleResult, type CatalogRpcRequest, type CatalogTree, type CategoryCreate, type CategoryList, type CategoryPatch, type CategoryRow, type CellRef, type Clearance, type CodeDeclaration, type CombinedPromptCatalogResponse, type ConfirmProposedDirectiveArgs, type ConfirmProposedDirectiveResult, type ContextAnswer, type ContextAnswerBothRequest, type ContextAnswerBothResponse, type ContextCompare, type ContextCompareCheck, type ContextCompareDifference, type ContextCompareSelection, type ContextCompareSide, type ContextDecidedBy, type ContextDelivered, type ContextDeliveredArgs, type ContextDeliveredRef, type ContextDeliveredResult, type ContextDeliveredSide, type ContextEnvelope, type ContextFollowLag, type ContextItemBinding, type ContextOrganizationOption, type ContextOrganizationsResponse, type ContextPreviewBindings, type ContextPreviewRefusal, type ContextPreviewRequest, type ContextPreviewResponse, type ContextPreviewSelection, type ContextPreviewVariables, type ContextProvenance, type ContextReceipt, type ContextReceiptBlock, type ContextReceiptRoomView, type ContextReceiptRow, type ContextReceiptWithheldItem, type ContextRenderRequest, type ContextRenderResponse, type ContextRule, type ContextSelection, type ContextSystemItem, type ContextSystemItems, type ContextTarget, type ContextViewTarget, type ContextViewedText, type ControlBinding, type CreateAgentArgs, type CreateAgentInput, type CreateAgentResult, type CreateCategoryArgs, type CreateCategoryResult, type CreateSkillArgs, type CreateSkillResult, type CreateStructuredAgentArgs, type CreateStructuredAgentResult, type DeleteCategoryArgs, type DeleteCategoryResult, type DeleteSkillArgs, type DeleteSkillResult, type DirectiveApplyResult, type DirectiveApplyStateRequest, type DirectiveApplyStateResult, type DirectiveCatalog, type DirectiveConfirmRequest, type DirectiveConfirmResult, type DirectiveExecuteRequest, type DirectiveItemState, type DirectiveNounSchemas, type DirectiveReceipt, type DirectiveShellState, type ExecuteRealtimeToolRouteArgs, type ExecuteRealtimeToolRouteResult, type ExecuteToolTestArgs, type ExecuteToolTestResult, type ExecuteWriteDirectiveArgs, type ExecuteWriteDirectiveResult, type ExecutionAgentDefinition, type FailureAnalyticsArgs, type FailureAnalyticsResponse, type FailureAnalyticsResult, type FaultDomainCount, type FirstRunsResponse, type GetAgentArgs, type GetAgentCatalogArgs, type GetAgentCatalogResult, type GetAgentCatalogStatusArgs, type GetAgentCatalogStatusResult, type GetAgentExecutionArgs, type GetAgentExecutionDefinitionArgs, type GetAgentExecutionDefinitionResult, type GetAgentExecutionResult, type GetAgentResult, type GetAgentVersionExecutionDefinitionArgs, type GetAgentVersionExecutionDefinitionResult, type GetAllPromptBuiltinsArgs, type GetAllPromptBuiltinsResult, type GetAllToolsArgs, type GetAllToolsResult, type GetCapabilityManifestArgs, type GetCapabilityManifestResult, type GetDbSurfaceManifestArgs, type GetDbSurfaceManifestResult, type GetDirectiveCatalogArgs, type GetDirectiveCatalogResult, type GetDirectiveNounSchemasArgs, type GetDirectiveNounSchemasResult, type GetLibraryArgs, type GetLibraryResult, type GetListsArgs, type GetListsResult, type GetMcpDiscoveredToolsArgs, type GetMcpDiscoveredToolsResult, type GetNativeToolsArgs, type GetNativeToolsResult, type GetOrCreateTestSessionArgs, type GetOrCreateTestSessionResult, type GetPortableAgentArgs, type GetPortableAgentResult, type GetPortableAgentSummaryArgs, type GetPortableAgentSummaryResult, type GetPortableAgentVersionArgs, type GetPortableAgentVersionResult, type GetPromptsArgs, type GetPromptsResult, type GetRealtimeSessionArgs, type GetRealtimeSessionResult, type GetRealtimeToolsArgs, type GetRealtimeToolsResult, type GetSkillArgs, type GetSkillResult, type GetTemplatesArgs, type GetTemplatesResult, type GetToolByIdArgs, type GetToolByIdResult, type GetToolDetailArgs, type GetToolDetailResult, type GetToolResponse, type GetToolsBySourceKindArgs, type GetToolsBySourceKindResult, type GetToolsForAppArgs, type GetToolsForAppResult, type GetUserPromptsAndBuiltinsArgs, type GetUserPromptsAndBuiltinsResult, type GetUserPromptsArgs, type GetUserPromptsResult, type GetVariationBatchesArgs, type GetVariationBatchesResult, type GetVersionArgs, type GetVersionResult, type IngestReport, type InvalidateAgentCacheArgs, type InvalidateAgentCacheResponse, type InvalidateAgentCacheResult, type InvocationContext, type InvokeToolArgs, type InvokeToolResult, type JudgeFirstRunsArgs, type JudgeFirstRunsResult, type KeepBuildArgs, type KeepBuildResult, type KeepResponse, type KindActionEntry, type LibraryPut, type ListAgentsArgs, type ListAgentsResult, type ListCategoriesArgs, type ListCategoriesResult, type ListContextOrganizationsArgs, type ListContextOrganizationsResult, type ListModelsArgs, type ListModelsResult, type ListScenariosArgs, type ListScenariosResult, type ListToolsArgs, type ListToolsBySourceKindResponse, type ListToolsForExecutorResponse, type ListToolsResponse, type ListToolsResult, type ListVersionsArgs, type ListVersionsResult, type ListsPut, type ManifestClientToolEntry, type ManifestGroupEntry, type ManifestToolEntry, type ManifestValueEntry, type ManifestWriteTargetEntry, type MatrixCancelResponse, type MatrixRunRequest, type MergeFieldBinding, type MergeFieldSort, type MergeFieldTransform, type MockScenario, type MockScenarioList, type MockStreamArgs, type MockStreamRequest, type MockStreamResult, type ModelAuthoringFacts, type ModelCapabilitySummary, type ModelClassInfo, type ModelControlInfo, type ModelInfo, type NounDirectives, type Operations, type OrchestraBadge, type PatchCategoryArgs, type PatchCategoryResult, type PatchSkillArgs, type PatchSkillResult, type PicklistBinding, type PortableAgentBundle, type PortableAgentRequest, type PortableAgentSummary, type PortableAgentVersion, type PortableSkill, type PortableTool, type PortableUnavailable, type PostAgentCatalogRpcArgs, type PostAgentCatalogRpcResult, type PreviewAnswerBothArgs, type PreviewAnswerBothResult, type PreviewContextArgs, type PreviewContextResult, type PreviewVariableBindingArgs, type PreviewVariableBindingResult, type PromptMatrixPathsArgs, type PromptMatrixPathsResult, type PromptWarmRequest, type PromptWarmResponse, type PromptsPut, type PutLibraryArgs, type PutLibraryResult, type PutListsArgs, type PutListsResult, type PutPromptsArgs, type PutPromptsResult, type PutTemplatesArgs, type PutTemplatesResult, type PutVariationBatchesArgs, type PutVariationBatchesResult, type ReadBuildArgs, type ReadBuildResult, type ReadDirectiveApplyStateArgs, type ReadDirectiveApplyStateResult, type RealtimeSessionRequest, type RealtimeSessionResponse, type RealtimeTool, type RealtimeToolsRequest, type RealtimeToolsResponse, type RenderContextArgs, type RenderContextResult, type RunAgentTestsArgs, type RunAgentTestsResult, type RunMatrixBattleArgs, type RunMatrixBattleResult, type SchemaFinding, type SchemaGateReport, type ScreenRunApproval, type ScreenRunArgs, type ScreenRunError, type ScreenRunRequest, type ScreenRunResponse, type ScreenRunResult, type SkillCreate, type SkillInfo, type SkillPatch, type SkillRow, type SkillsList, type SkillsListSkillsArgs, type SkillsListSkillsResult, type SpecVariable, type StartAgentBlocksArgs, type StartAgentBlocksResult, type StartBuildArgs, type StartBuildBody, type StartBuildResponse, type StartBuildResult, type StartMandatedAgentArgs, type StartMandatedAgentResult, type StartPromptArgs, type StartPromptResult, type SurfaceManifest, type TemplatesPut, type ToolDetail, type ToolDetailArgs, type ToolDetailResponse, type ToolDetailResult, type ToolExecuteRequest, type ToolExecuteResponse, type ToolFailureRow, type ToolFailureStat, type ToolFinding, type ToolInfo, type ToolRecord, type ToolRequest, type ToolResponse, type ToolRow, type ToolSummary, type ToolTestExecuteRequest, type ToolTestSessionResponse, type ToolTestingListToolsArgs, type ToolTestingListToolsResult, type ToolUpdateRequest, type UpdateAgentArgs, type UpdateAgentInput, type UpdateAgentResult, type UpdateToolArgs, type UpdateToolResult, type UserPromptCatalogResponse, type ValidateAllOpArgs, type ValidateAllOpResult, type ValidateSchemaArgs, type ValidateSchemaRequest, type ValidateSchemaResult, type ValidationReportResponse, type VariableAssignmentSpec, type VariableBindingPreviewRequest, type VariableBindingPreviewResponse, type VariableComponentSpec, type VariationBatchesPut, type WarmAgentArgs, type WarmAgentBlocksArgs, type WarmAgentBlocksResponse, type WarmAgentBlocksResult, type WarmAgentResponse, type WarmAgentResult, type WarmPromptArgs, type WarmPromptResult, adminAgentFromChat, adminIngestFilesystem, adminToolsListTools, agentFromChat, agentServiceListSkills, agentServiceListTools, agentsStartAgent, agentsStartAgentPost, type aidream__api__routers__agents__WarmRequest, type aidream__api__routers__agents_blocks__WarmRequest, type aidream__api__routers__skills__IngestRequest, type aidream__api__routers__tool_testing__ToolListResponse, type aidream__services__admin_ops__tools_wire__ToolListResponse, cacheBust, call, cancelMatrixBattle, confirmProposedDirective, contextDelivered, createAgent, createCategory, createSkill, createStructuredAgent, deleteCategory, deleteSkill, executeRealtimeToolRoute, executeToolTest, executeWriteDirective, failureAnalytics, getAgent, getAgentCatalog, getAgentCatalogStatus, getAgentExecution, getAgentExecutionDefinition, getAgentVersionExecutionDefinition, getAllPromptBuiltins, getAllTools, getCapabilityManifest, getDbSurfaceManifest, getDirectiveCatalog, getDirectiveNounSchemas, getLibrary, getLists, getMcpDiscoveredTools, getNativeTools, getOrCreateTestSession, getPortableAgent, getPortableAgentSummary, getPortableAgentVersion, getPrompts, getRealtimeSession, getRealtimeTools, getSkill, getTemplates, getToolById, getToolDetail, getToolsBySourceKind, getToolsForApp, getUserPrompts, getUserPromptsAndBuiltins, getVariationBatches, getVersion, invalidateAgentCache, invokeTool, judgeFirstRuns, keepBuild, listAgents, listCategories, listContextOrganizations, listModels, listScenarios, listTools, listVersions, mockStream, patchCategory, patchSkill, postAgentCatalogRpc, previewAnswerBoth, previewContext, previewVariableBinding, promptMatrixPaths, putLibrary, putLists, putPrompts, putTemplates, putVariationBatches, readBuild, readDirectiveApplyState, renderContext, runAgentTests, runMatrixBattle, screenRun, skillsListSkills, startAgentBlocks, startBuild, startMandatedAgent, startPrompt, toolDetail, toolTestingListTools, updateAgent, updateTool, validateAll, validateSchema, warmAgent, warmAgentBlocks, warmPrompt };