@ai-matrx/api 0.0.0-stage → 0.1.1

package/dist/schemas.d.ts

@@ -0,0 +1,1353 @@
+/**
+ * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
+ * CONTRACT_SHA256 50a790edb39e682b46e0fa9e674faf5ce2a0ba7de2cd01930a497fca4c47844a
+ */
+/** Every schema reached from more than one domain (120). Types only — importing this costs nothing at runtime. */
+/** ActionNeeded */
+type ActionNeeded = {
+    /** Stable source-owned dedupe key; never a random notification id */
+    fingerprint: string;
+    code: string;
+    kind: ActionNeededKind;
+    feature: string;
+    title: string;
+    message: string;
+    action: ActionNeededAction;
+    source: string;
+    status?: ActionNeededStatus;
+    observed_at?: number;
+    details?: {
+        [key: string]: unknown;
+    } | null;
+};
+/** ActionNeededAction */
+type ActionNeededAction = {
+    /** Stable dispatcher action kind */
+    kind: string;
+    label: string;
+    permission_key?: string | null;
+    provider?: string | null;
+    route?: string | null;
+    url?: string | null;
+    resource_ids?: string[] | null;
+    choices?: ActionNeededChoice[] | null;
+    choice_route?: string | null;
+};
+/** One option the person can pick to resolve an item — a picker row. */
+type ActionNeededChoice = {
+    id: string;
+    label: string;
+    description?: string | null;
+};
+/** ActionNeededKind */
+type ActionNeededKind = "os_permission" | "filesystem_access" | "api_key" | "external_approval" | "capability_install" | "organization";
+/** ActionNeededStatus */
+type ActionNeededStatus = "active" | "checking" | "resolved";
+/** AgentAppInputPart */
+type AgentAppInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+    template?: ("full" | "compact" | "minimal") | null;
+    type: "input_agent_app";
+    agent_app_ids: string[];
+};
+/** AgentInputPart */
+type AgentInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+    template?: ("full" | "compact" | "minimal") | null;
+    type: "input_agent";
+    agent_ids: string[];
+};
+/** AgentStartRequest */
+type AgentStartRequest = {
+    /** 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;
+    applet_id?: string | null;
+    test_holder?: MandateTestHolder | null;
+    variables?: {
+        [key: string]: unknown;
+    } | null;
+    per_turn_variables?: string[] | null;
+    variable_resource_context?: {
+        [key: string]: ResourceContextPolicy;
+    } | null;
+    config_overrides?: LLMParams | null;
+    stream?: boolean;
+    debug?: boolean;
+    dry_run?: boolean;
+    tools?: (RegisteredToolSpec | InlineToolSpec | AgentToolSpec)[];
+    tools_replace?: ((RegisteredToolSpec | InlineToolSpec | AgentToolSpec)[]) | null;
+    client?: ClientContext | null;
+    user?: UserOverrides | null;
+    ide_state?: IdeState | null;
+    sandbox?: SandboxBindingRequest | null;
+    context?: {
+        [key: string]: unknown;
+    };
+    /** 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;
+    /** 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;
+    writable_variables?: string[];
+    allow_context_create?: boolean;
+    prior_messages?: ChatMessageInput[];
+    is_version?: boolean;
+    block_mode?: boolean;
+    snapshot?: boolean | null;
+    memory?: boolean | null;
+    memory_model?: string | null;
+    memory_offering_id?: string | null;
+    memory_scope?: string;
+    cache_bypass?: CacheBypass | null;
+    max_iterations?: number;
+    max_retries_per_iteration?: number;
+    skill_config?: {
+        [key: string]: unknown;
+    } | null;
+    /** Shapes (content_ir kind slugs) picked for this chat. The server resolves each to the skill that teaches it. Omit to use the chat's saved picks; send [] for none. */
+    output_kinds?: string[] | null;
+};
+/** AgentToolSpec */
+type AgentToolSpec = {
+    kind?: "agent";
+    /** UUID of the saved agent to project as a tool. */
+    agent_id: string;
+    /** When True, agent_id refers to an agx_version row instead of agx_agent. */
+    is_version?: boolean;
+    /** Optional override of the projected tool's description. When omitted, the agent's own description is used. */
+    description_override?: string | null;
+    /** The human role this projected agent plays for the caller (an Orchestra edge's role title). Projection shows it with the agent's own name on the tool card; None = the agent's name alone. */
+    display_name?: string | null;
+    max_calls_per_conversation?: number | null;
+    cost_cap_per_call?: number | null;
+    /** Per-spec agent-nesting ceiling for the projected tool. None (the default) keeps the platform constant (agent_projection.PROJECTED_AGENT_MAX_RECURSION_DEPTH). A composition that declares its own depth  */
+    max_recursion_depth?: number | null;
+    /** How the child agent's result returns to the caller. 'inline' — the full output in the tool_result (default). 'reference' — the output is stored in the conversation value store and the caller receives  */
+    result_mode?: "inline" | "reference" | "inline_once";
+    /** Agent-as-Router (Pattern 1): a successful call ENDS the caller's loop — the child's answer streams to the client and persists as the conversation's own assistant response; control returns to the calle */
+    handoff?: boolean;
+};
+/** Asset */
+type Asset = {
+    /** The master cld_files row id */
+    file_id: string;
+    /** True when the asset master is published to the web (served from the CDN). */
+    published_to_web?: boolean;
+    /** List filter of the asset master; null follows the type's default. */
+    shown_to?: ("only_me" | "my_team" | "everyone" | "everyone_on_ai_matrx") | null;
+    visibility?: "personal" | "internal" | "link" | "public";
+    share_token?: string | null;
+    share_url?: string | null;
+    /** Logical folder containing the asset master. */
+    folder: string;
+    /** Variant preset used when the asset was rendered. */
+    preset?: string | null;
+    /** Variant key selected as the asset's canonical representation. */
+    primary_key?: string;
+    /** Always-usable URL for the primary variant. */
+    primary_url?: string | null;
+    /** Rendered variants keyed by their stable variant identifier. */
+    variants?: {
+        [key: string]: AssetVariant;
+    };
+    /** Sanitized JSON metadata copied from the asset master row. */
+    metadata?: {
+        [key: string]: JsonValue;
+    };
+};
+/** AssetVariant */
+type AssetVariant = {
+    /** Variant identifier (e.g. 'original', 'cover_url', 'og_url') */
+    key: string;
+    file_id: string;
+    file_path: string;
+    width?: number | null;
+    height?: number | null;
+    mime_type?: string | null;
+    size_bytes?: number | null;
+    url?: string | null;
+    cdn_url?: string | null;
+    download_url?: string | null;
+    metadata?: {
+        [key: string]: JsonValue;
+    };
+};
+/** A pointer to the ``platform.block_states`` row a remark was made from (remarks B6). */
+type BlockStateRef = {
+    id: string;
+    state_version: number;
+};
+/** Opt-in cache invalidation flags attached to an AI request body. */
+type CacheBypass = {
+    conversation?: boolean;
+    agent?: boolean;
+    tools?: boolean;
+    models?: boolean;
+};
+/** CalendarCreateResult */
+type CalendarCreateResult = {
+    account_email: string | null;
+    calendar_id: string;
+    calendar_summary: string;
+    access_role: "owner" | "writer" | "writerWithoutPrivateAccess";
+    event_id: string;
+    summary: string;
+    description?: string | null;
+    starts_at: string;
+    ends_at: string;
+    attendees: CalendarEventAttendee[];
+    send_updates: "all" | "externalOnly" | "none";
+    guest_notification_behavior: string;
+    undo_notice?: string;
+    reconciled_after_uncertain_insert?: boolean;
+    provider_event_id: string;
+    provider_etag?: string | null;
+    local_refresh?: CalendarLocalRefreshResult | null;
+};
+/** CalendarEventAttendee */
+type CalendarEventAttendee = {
+    email: string;
+    display_name?: string | null;
+};
+/** Privacy-bounded saved-copy outcome, separate from Google's write outcome. */
+type CalendarLocalRefreshResult = {
+    status: "updated" | "scrubbed" | "not_saved" | "detached" | "pending";
+    reason?: ("refresh_pending" | "series_refresh_required") | null;
+    cache_refresh_pending?: boolean;
+};
+/** One LLM message on the request wire. */
+type ChatMessageInput = {
+    role: ("system" | "user" | "assistant" | "tool" | "developer") | string;
+    content?: string | JsonValue[] | null;
+    name?: string | null;
+    tool_call_id?: string | null;
+    tool_calls?: ChatToolCallInput[] | null;
+    [key: string]: unknown;
+};
+/** One tool-call entry inside an assistant message. */
+type ChatToolCallInput = {
+    id?: string | null;
+    type?: string | null;
+    function?: {
+        [key: string]: JsonValue;
+    } | null;
+    name?: string | null;
+    input?: JsonValue | null;
+    arguments?: JsonValue | null;
+    [key: string]: unknown;
+};
+/** Request envelope describing the calling client's surface + capabilities + state. */
+type ClientContext = {
+    surface?: string | null;
+    capabilities?: string[];
+    state?: {
+        [key: string]: {
+            [key: string]: unknown;
+        };
+    };
+    amendments?: SurfaceAmendments | null;
+    mcp?: string[];
+    apply_policy?: ("auto" | "ask" | "off") | null;
+};
+/** CodeExecPart */
+type CodeExecPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "code_exec";
+    language?: string;
+    code?: string;
+};
+/** CodeResultPart */
+type CodeResultPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "code_result";
+    output?: string;
+    outcome?: string;
+};
+/** Optional overrides for the 5-tier context compaction pipeline. */
+type CompactionSettings = {
+    tier2_minimal_prune?: boolean | null;
+    tier3_content_to_retrieval?: boolean | null;
+    tier4_threshold_trim?: boolean | null;
+    tier5_hard_compression?: boolean | null;
+};
+/** ComputeNextDueResponse */
+type ComputeNextDueResponse = {
+    next_due_at?: string | null;
+    event_driven: boolean;
+};
+/** Stable identity of the durable entity whose saved context owns a run. */
+type ContextAnchor = {
+    /** Canonical entity type whose durable row owns the request context. */
+    resource_type: string;
+    /** UUID of the durable context-owning entity. */
+    resource_id: string;
+};
+/** ContextInputPart */
+type ContextInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "input_context";
+    context_id?: string;
+    context_name?: string;
+    context_data?: {
+        [key: string]: unknown;
+    };
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+};
+/** CustomTool */
+type CustomTool = {
+    /** Unique tool name. Must match [a-zA-Z0-9_:-]{1,64}; a ':' namespace separator is serialized to '__' at the provider boundary. */
+    name: string;
+    /** Human-readable description shown to the model. */
+    description?: string;
+    /** JSON Schema describing the tool's input parameters. */
+    input_schema?: CustomToolInputSchema;
+};
+/** CustomToolInputSchema */
+type CustomToolInputSchema = {
+    type?: "object";
+    properties?: {
+        [key: string]: JsonSchemaProperty;
+    };
+    required?: string[];
+};
+/** DataInputPart */
+type DataInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "input_data";
+    refs: (DbRecordRef | DbQueryRef | DbFieldRef)[];
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+};
+/** DataRefSort */
+type DataRefSort = {
+    field: string;
+    direction?: "asc" | "desc";
+};
+/** Fetch a single field value from one row of a system table. */
+type DbFieldRef = {
+    table: "notes" | "tasks" | "projects" | "organizations";
+    label?: string;
+    optional_context?: boolean;
+    ref_type: "db_field";
+    id: string;
+    field_name: string;
+};
+/** Fetch multiple rows from a system table with optional filters. */
+type DbQueryRef = {
+    table: "notes" | "tasks" | "projects" | "organizations";
+    label?: string;
+    optional_context?: boolean;
+    ref_type: "db_query";
+    filter?: {
+        [key: string]: unknown;
+    };
+    fields?: string[] | null;
+    sort?: DataRefSort | null;
+    limit?: number;
+};
+/** Fetch one full row from a system table by primary key. */
+type DbRecordRef = {
+    table: "notes" | "tasks" | "projects" | "organizations";
+    label?: string;
+    optional_context?: boolean;
+    ref_type: "db_record";
+    id: string;
+    fields?: string[] | null;
+};
+/** One answer, with the holder's own uncertainty attached. */
+type DecisionAnswer = {
+    /** The registered kind this payload is an instance of. */
+    __kind?: "decision_answer";
+    type: "noul" | "choice" | "score";
+    answer: boolean | number | string;
+    probability?: number | null;
+    probabilities?: {
+        [key: string]: number;
+    } | null;
+    confidence: number;
+    legend?: {
+        [key: string]: string;
+    } | null;
+};
+/** DecisionAnswersPart */
+type DecisionAnswersPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "decision_answers";
+    __kind?: "decision_answers";
+    model: string;
+    method: "native" | "verbalized" | "verbalized_calibrated";
+    answers?: {
+        [key: string]: DecisionAnswer;
+    };
+    unanswerable?: {
+        [key: string]: string;
+    };
+    usage: DecisionUsage_Input;
+    cost_usd: number;
+};
+/** One question. Not a kind: it has no meaning outside its batch. */
+type DecisionQuestion = {
+    /** The registered kind this payload is an instance of, when it is one. */
+    __kind?: string;
+    name: string;
+    type: "noul" | "choice" | "score";
+    instructions: string;
+    criteria?: {
+        [key: string]: string;
+    } | string[] | null;
+    suggested_threshold?: number | null;
+};
+/** DecisionQuestionsPart */
+type DecisionQuestionsPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "decision_questions";
+    __kind?: "decision_questions";
+    questions: DecisionQuestion[];
+};
+/** What the decision call consumed. Zero is a real value, never a stand-in. */
+type DecisionUsage_Input = {
+    /** The registered kind this payload is an instance of, when it is one. */
+    __kind?: string;
+    input_tokens: number;
+    output_tokens: number;
+};
+/** DictionaryConfig */
+type DictionaryConfig = {
+    entries?: DictionaryEntry[];
+    custom_entries?: DictionaryEntry[];
+    max_inline_chars?: number | null;
+    source_count?: number;
+    glossary?: GlossaryEntry[];
+    context?: string | null;
+};
+/** DictionaryEntry */
+type DictionaryEntry = {
+    term: string;
+    sounds_like?: string[];
+    pronunciation?: string | null;
+    ipa?: string | null;
+    definition?: string | null;
+    category?: string | null;
+    source_level?: string | null;
+    source_name?: string | null;
+};
+/** DirectiveItemApplied */
+type DirectiveItemApplied = {
+    kind?: string;
+    directive: string;
+    index: number;
+    status: "applied" | "already_applied" | "failed" | "pending";
+    resource_kind: string;
+    resource_ids: string[];
+    summary: string;
+    message: string;
+    before?: {
+        [key: string]: unknown;
+    } | null;
+    thread?: ThreadLink | null;
+};
+/** DirectiveItemFailed */
+type DirectiveItemFailed = {
+    kind?: string;
+    directive: string;
+    index: number;
+    error: string;
+    fault: string;
+    message: string;
+};
+/** DocumentInputPart */
+type DocumentInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+    template?: ("full" | "compact" | "minimal") | null;
+    type: "input_document";
+    document_ids: (string | LiveResourceRefInput)[];
+};
+/** Non-secret provenance persisted under ``files.files.metadata``. */
+type ExternalSourceMetadata = {
+    provider: "google_drive" | "onedrive" | "dropbox" | "box";
+    connection_id: string;
+    source_ref: string;
+    revision?: string | null;
+    modified_at?: string | null;
+};
+/** FullListBookmark */
+type FullListBookmark = {
+    type?: "full_list";
+    list_id: string;
+    list_name?: string | null;
+    [key: string]: unknown;
+};
+/** FullTableBookmark */
+type FullTableBookmark = {
+    type?: "full_table";
+    table_id: string;
+    table_name?: string | null;
+    [key: string]: unknown;
+};
+/** One translation rule from an attached term list. */
+type GlossaryEntry = {
+    term: string;
+    translation?: string | null;
+    target_language?: string | null;
+    do_not_translate?: boolean;
+    case_sensitive?: boolean;
+};
+/** IdeDiagnostic */
+type IdeDiagnostic = {
+    message: string;
+    severity: string;
+    range: {
+        [key: string]: JsonValue;
+    };
+    source?: string | null;
+};
+/** IdeFileState */
+type IdeFileState = {
+    path: string;
+    content: string;
+    language: string;
+};
+/** IdeGitState */
+type IdeGitState = {
+    branch: string;
+    status: string;
+};
+/** Structured IDE snapshot sent with a request. */
+type IdeState = {
+    active_file?: IdeFileState | null;
+    selected_text?: string | null;
+    diagnostics?: IdeDiagnostic[];
+    workspace?: IdeWorkspaceState | null;
+    git?: IdeGitState | null;
+};
+/** IdeWorkspaceState */
+type IdeWorkspaceState = {
+    name: string;
+    folders: string[];
+};
+/** Together FLUX LoRA reference — passed through to the provider API. */
+type ImageLora = {
+    /** LoRA weights path or URL. */
+    path: string;
+    /** Blend strength (provider-native scale). */
+    scale: number;
+};
+/** InlineToolSpec */
+type InlineToolSpec = {
+    kind?: "inline";
+    /** Unique tool name. Must match [a-zA-Z0-9_:-]{1,64}; a ':' namespace separator is serialized to '__' at the provider boundary. */
+    name: string;
+    description?: string;
+    input_schema?: CustomToolInputSchema;
+};
+/** Object-root JSON Schema — agent ``output_schema.schema`` and tool roots. */
+type JsonSchemaObjectDocument = {
+    type?: "object" | null;
+    properties?: {
+        [key: string]: JsonSchemaProperty;
+    };
+    required?: string[] | null;
+    additionalProperties?: boolean | JsonValue | null;
+    [key: string]: unknown;
+};
+/** One property in a tool parameter schema or structured-output object. */
+type JsonSchemaProperty = {
+    type?: ("string" | "number" | "integer" | "boolean" | "array" | "object" | "null") | (("string" | "number" | "integer" | "boolean" | "array" | "object" | "null")[]) | null;
+    description?: string | null;
+    enum?: JsonValue[] | null;
+    default?: JsonValue | null;
+    items?: JsonSchemaProperty | null;
+    properties?: {
+        [key: string]: JsonSchemaProperty;
+    } | null;
+    required?: string[] | null;
+    additionalProperties?: boolean | JsonValue | null;
+    [key: string]: unknown;
+};
+type JsonValue = unknown;
+/** LLMParams */
+type LLMParams = {
+    model?: string | null;
+    offering_id?: string | null;
+    max_output_tokens?: number | null;
+    temperature?: number | null;
+    top_p?: number | null;
+    top_k?: number | null;
+    tool_choice?: ("none" | "auto" | "required") | null;
+    parallel_tool_calls?: boolean | null;
+    reasoning_effort?: ("auto" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max") | null;
+    reasoning_summary?: ("concise" | "detailed" | "never" | "auto" | "always") | null;
+    visualization?: ("auto" | "off") | null;
+    thinking_level?: ("minimal" | "low" | "medium" | "high") | null;
+    include_thoughts?: boolean | null;
+    thinking_budget?: number | null;
+    clear_thinking?: boolean | null;
+    disable_reasoning?: boolean | null;
+    response_format?: (ResponseFormatText | ResponseFormatJsonObject | ResponseFormatJsonSchema) | null;
+    stop_sequences?: string[] | null;
+    stream?: boolean | null;
+    store?: boolean | null;
+    previous_interaction_id?: string | null;
+    task?: ("text_to_video" | "image_to_video" | "reference_to_video" | "edit") | null;
+    verbosity?: ("low" | "medium" | "high") | null;
+    internal_web_search?: boolean | null;
+    internal_url_context?: boolean | null;
+    internal_x_search?: boolean | null;
+    aspect_ratio?: ("1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9") | null;
+    width?: number | null;
+    height?: number | null;
+    count?: number | null;
+    render_quality?: ("low" | "medium" | "high" | "auto") | null;
+    background?: ("auto" | "opaque" | "transparent") | null;
+    output_compression?: number | null;
+    moderation?: ("auto" | "low") | null;
+    input_fidelity?: ("high" | "low") | null;
+    partial_images?: number | null;
+    style?: ("vivid" | "natural") | null;
+    reference_strength?: number | null;
+    tts_voice?: string | TtsVoiceSpeaker[] | TtsDialogueTurn[] | null;
+    audio_format?: ("mp3" | "wav" | "ogg" | "opus" | "aac" | "flac" | "pcm" | "mulaw" | "alaw") | null;
+    performance_direction?: string | null;
+    speech_speed?: number | null;
+    turn_pause_ms?: number | null;
+    language_code?: string | null;
+    duration_seconds?: number | null;
+    resolution?: ("480p" | "720p" | "1080p" | "4k" | "1K" | "2K" | "4K") | null;
+    fps?: number | null;
+    steps?: number | null;
+    seed?: number | null;
+    guidance_scale?: number | null;
+    encode_quality?: number | null;
+    negative_prompt?: string | null;
+    output_format?: ("jpeg" | "png" | "webp" | "base64" | "url" | "text" | "json_object" | "json_schema") | null;
+    frame_images?: MediaRef[] | null;
+    reference_images?: MediaRef[] | null;
+    image_loras?: ImageLora[] | null;
+    disable_safety_checker?: boolean | null;
+    generate_audio?: boolean | null;
+    enhance_prompt?: boolean | null;
+    camera_control?: {
+        [key: string]: unknown;
+    } | null;
+    image_input?: MediaRef | null;
+    image_inputs?: MediaRef[] | null;
+    mask?: MediaRef | null;
+    last_frame_image?: MediaRef | null;
+    video_input?: MediaRef | null;
+    video_action?: ("generate" | "edit" | "extend") | null;
+    custom_tools?: CustomTool[] | null;
+    mcp_servers?: string[] | null;
+    compaction_settings?: CompactionSettings | null;
+    detected_contexts?: {
+        [key: string]: string;
+    } | null;
+    dictionary?: DictionaryConfig | null;
+    tts_quality?: ("high_quality" | "fast") | null;
+    /** Deprecated input alias for `max_output_tokens`. The server normalizes this name before validation and dispatch; new callers should send `max_output_tokens`. */
+    max_tokens?: number | null;
+    /** Deprecated input alias for `count`. The server normalizes this name before validation and dispatch; new callers should send `count`. */
+    n?: number | null;
+    /** Deprecated input alias for `count`. The server normalizes this name before validation and dispatch; new callers should send `count`. */
+    num_outputs?: number | null;
+    /** Deprecated input alias for `count`. The server normalizes this name before validation and dispatch; new callers should send `count`. */
+    number_of_images?: number | null;
+    /** Deprecated input alias for `render_quality`. The server normalizes this name before validation and dispatch; new callers should send `render_quality`. */
+    quality?: ("low" | "medium" | "high" | "auto") | null;
+    /** Deprecated input alias for `encode_quality`. The server normalizes this name before validation and dispatch; new callers should send `encode_quality`. */
+    output_quality?: number | null;
+    /** Deprecated input alias for `duration_seconds`. The server normalizes this name before validation and dispatch; new callers should send `duration_seconds`. */
+    seconds?: number | null;
+    /** Deprecated input alias for `duration_seconds`. The server normalizes this name before validation and dispatch; new callers should send `duration_seconds`. */
+    duration?: number | null;
+};
+/** ListGroupBookmark */
+type ListGroupBookmark = {
+    type?: "list_group";
+    list_id: string;
+    group_name: string;
+    list_name?: string | null;
+    [key: string]: unknown;
+};
+/** ListInputPart */
+type ListInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "input_list";
+    bookmarks: (FullListBookmark | ListGroupBookmark | ListItemBookmark)[];
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+};
+/** ListItemBookmark */
+type ListItemBookmark = {
+    type?: "list_item";
+    list_id: string;
+    item_id: string;
+    list_name?: string | null;
+    [key: string]: unknown;
+};
+/** A live id-backed reference; snapshots are not meaningful for opaque resources. */
+type LiveResourceRefInput = {
+    id: string;
+    mode?: "reference";
+    [key: string]: unknown;
+};
+/** The Holder a test run / preview uses instead of the resolved one. */
+type MandateTestHolder = {
+    type: "agent" | "workflow";
+    id: string;
+    version_id?: string | null;
+};
+/** Canonical media reference shared across every API that takes media. */
+type MediaRef = {
+    /** cld_files UUID. Preferred form; returned by POST /files/upload. */
+    file_id?: string | null;
+    /** Any URL we issued (share link, /files/{id}/url, /files/{id}/download, raw S3 URL) or a truly external https://. The server recognizes ours and resolves to bytes; external URLs are passed through to pr */
+    url?: string | null;
+    /** Native cloud URI: s3://bucket/key, gs://..., azure://... */
+    file_uri?: string | null;
+    /** Hint from the client. Server REPLACES with the canonical cld_files.mime_type when the reference resolves to one of our files. */
+    mime_type?: string | null;
+    /** Free-form per-API metadata. Opaque to the resolver. */
+    metadata?: {
+        [key: string]: JsonValue;
+    };
+    /** Optional name of a registered vision class (e.g. 'anthropic_opus_hires', 'gemini3_high'). When set, resolution produces a derived variant of the master file using the host-registered encoder for the ' */
+    vision_class?: string | null;
+    /** Inline bytes (base64). Set by resolver when needs_bytes=True. */
+    base64_data?: string | null;
+    /** Fresh presigned URL the resolver minted (provider-fetchable). */
+    resolved_url?: string | null;
+    /** Resolved byte size from the canonical file row or downloaded content. */
+    file_size?: number | null;
+    /** Owner user id loaded from the canonical file row during resolution. */
+    owner_id?: string | null;
+    /** True iff the resolver matched the reference to a cld_files row. */
+    is_ours?: boolean;
+    /** Set when resolution failed; surface to the caller for logging. */
+    resolver_error?: string | null;
+    /** Set to True by the boundary normaliser. Resolvers short-circuit when this is True (idempotency). Internal — clients do not set. */
+    is_resolved?: boolean;
+    [key: string]: unknown;
+};
+/** The canonical cross-provider citation shape — the FE contract. */
+type NormalizedCitation = {
+    kind: "document_char" | "document_page" | "document_block" | "search_result" | "web" | "grounding";
+    provider: "anthropic" | "openai" | "google" | "xai";
+    cited_text?: string | null;
+    title?: string | null;
+    url?: string | null;
+    source_index?: number;
+    file_id?: string | null;
+    page?: number | null;
+    end_page?: number | null;
+    source_start?: number | null;
+    source_end?: number | null;
+    answer_start?: number | null;
+    answer_end?: number | null;
+    raw?: {
+        [key: string]: unknown;
+    };
+};
+/** NotesInputPart */
+type NotesInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "input_notes";
+    note_ids: (string | ResourceRefInput)[];
+    template?: string;
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+};
+/** OpenAI ``json_schema`` inner envelope — matches ``agx_agent.output_schema``. */
+type OutputSchemaEnvelope = {
+    name?: string | null;
+    schema?: JsonSchemaObjectDocument | null;
+    strict?: boolean | null;
+};
+/** Request field ``page_context``: this turn's conversation is the page's own, or its page */
+type PageContext = {
+    mode: "own" | "off";
+    /** The keys this page's own conversation (or a switched-off page) never receives — the page's declared list. Omitted: the default for the mode. */
+    withheld?: string[] | null;
+};
+/** A webpage entry that has already been scraped by the client. */
+type PreFetchedUrl = {
+    url: string;
+    textContent: string;
+    title?: string | null;
+    scrapedAt?: string | null;
+    charCount?: number | null;
+    [key: string]: unknown;
+};
+/** ProjectInputPart */
+type ProjectInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+    template?: ("full" | "compact" | "minimal") | null;
+    type: "input_project";
+    project_ids: string[];
+};
+/** PromptStartRequest */
+type PromptStartRequest = {
+    /** 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;
+    tools?: (RegisteredToolSpec | InlineToolSpec | AgentToolSpec)[];
+    tools_replace?: ((RegisteredToolSpec | InlineToolSpec | AgentToolSpec)[]) | null;
+    client?: ClientContext | null;
+    user?: UserOverrides | null;
+    ide_state?: IdeState | null;
+    context?: {
+        [key: string]: unknown;
+    };
+    /** 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;
+    /** 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;
+};
+/** RegisteredToolSpec */
+type RegisteredToolSpec = {
+    kind?: "registered";
+    /** Registry name. Required. tool_id may also be provided for UUID lookup. */
+    name: string;
+    /** Optional registry UUID. When set, takes precedence over name for lookup. */
+    tool_id?: string | null;
+    /** When True, the executor short-circuits dispatch and emits tool_delegated for the client to execute. When False (default), the server runs the tool via its registry implementation. */
+    delegate?: boolean;
+};
+/** One answered question. ``name``/``type`` reuse the decision_questions */
+type RemarkAnswer = {
+    question: string;
+    answer: string | boolean | number | string[];
+    name?: string | null;
+    type?: ("noul" | "choice" | "score" | "text") | null;
+};
+/** One staged remark. Structured on the wire and in storage; only the */
+type RemarkItem = {
+    kind: "comment" | "choice" | "edit" | "answers" | "interaction";
+    target?: RemarkTarget | null;
+    quote?: string | null;
+    body?: string | null;
+    diff?: string | null;
+    answers?: RemarkAnswer[] | null;
+    title?: string | null;
+    comment_id?: string | null;
+    id?: string | null;
+    handle?: string | null;
+    thread?: RemarkThreadEntry[] | null;
+    block_state_ref?: BlockStateRef | null;
+    metadata?: {
+        [key: string]: unknown;
+    };
+};
+/** What the remark is about. A chat reply (``message_id``) or any other */
+type RemarkTarget = {
+    message_id?: string | null;
+    record_token?: string | null;
+    record_id?: string | null;
+    record_title?: string | null;
+};
+/** One message of an existing comment thread, snapshotted onto a remark */
+type RemarkThreadEntry = {
+    author_name: string;
+    author_kind: "person" | "agent";
+    body: string;
+    created_at?: string | null;
+};
+/** RemarksInputPart */
+type RemarksInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "input_remarks";
+    items: RemarkItem[];
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+};
+/** ResourceContextPolicy */
+type ResourceContextPolicy = {
+    promote?: ResourcePromotion[];
+    exclude?: string[];
+};
+/** ResourcePromotion */
+type ResourcePromotion = {
+    representation: string;
+    max_chars?: number;
+};
+type ResourceRefInput = LiveResourceRefInput | SnapshotContentResourceRefInput | SnapshotTextResourceRefInput | SnapshotBodyResourceRefInput | SnapshotDescriptionResourceRefInput | SnapshotValueResourceRefInput;
+/** ResponseFormatJsonObject */
+type ResponseFormatJsonObject = {
+    type: "json_object";
+};
+/** ResponseFormatJsonSchema */
+type ResponseFormatJsonSchema = {
+    type: "json_schema";
+    json_schema?: OutputSchemaEnvelope | null;
+    name?: string | null;
+    schema?: JsonSchemaObjectDocument | null;
+    strict?: boolean | null;
+};
+/** ResponseFormatText */
+type ResponseFormatText = {
+    type: "text";
+};
+/** RunNowResponse */
+type RunNowResponse = {
+    run_id: string;
+};
+/** SandboxBindingRequest */
+type SandboxBindingRequest = {
+    /** Orchestrator sandbox id (sbx-XXX) */
+    sandbox_id: string;
+    /** Orchestrator URL up to and including /sandboxes/<id> (no trailing slash). */
+    base_url: string;
+    /** X-Sandbox-Access-Token bearer */
+    access_token: string;
+    /** Workspace root inside the sandbox */
+    root_path?: string;
+    /** Semantic filesystem namespace. This is explicit so routing never guesses the target OS or machine kind from path syntax. */
+    target_kind?: "sandbox" | "local_machine";
+};
+/** SnapshotBodyResourceRefInput */
+type SnapshotBodyResourceRefInput = {
+    mode: "snapshot";
+    body: string;
+    [key: string]: unknown;
+};
+/** SnapshotContentResourceRefInput */
+type SnapshotContentResourceRefInput = {
+    mode: "snapshot";
+    content: string;
+    [key: string]: unknown;
+};
+/** SnapshotDescriptionResourceRefInput */
+type SnapshotDescriptionResourceRefInput = {
+    mode: "snapshot";
+    description: string;
+    [key: string]: unknown;
+};
+/** SnapshotTextResourceRefInput */
+type SnapshotTextResourceRefInput = {
+    mode: "snapshot";
+    text: string;
+    [key: string]: unknown;
+};
+/** SnapshotValueResourceRefInput */
+type SnapshotValueResourceRefInput = {
+    mode: "snapshot";
+    value: string;
+    [key: string]: unknown;
+};
+/** SpeechScriptPart */
+type SpeechScriptPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "speech_script";
+    __kind?: "speech_script";
+    turns: SpeechTurn[];
+};
+/** One spoken turn. Not a kind: it has no meaning outside its script. */
+type SpeechTurn = {
+    /** The registered kind this payload is an instance of, when it is one. */
+    __kind?: string;
+    /** The speaker's name. Turns with the same name are the same speaker. For multi-speaker vendors (Gemini) this is the transcript label. */
+    speaker: string;
+    /** The voice this speaker uses: a literal provider voice id from the model's catalog, or a {{variable}}. Empty = bound to the agent's Voice setting (tts_voice). */
+    voice?: string | null;
+    /** What is said. Any {{variable}} is filled at run time. */
+    text: string;
+    /** Free-text performance direction for this turn only (e.g. 'warm, a little amused'). */
+    direction?: string | null;
+    /** Silence after this turn, in milliseconds. */
+    pause_after_ms?: number | null;
+};
+/** Safe result of importing a provider item into canonical Matrx Files. */
+type StorageImportResult = {
+    file_id: string;
+    file_path: string;
+    checksum?: string | null;
+    version_number: number;
+    created: boolean;
+    source: ExternalSourceMetadata;
+};
+/** Per-request delta against the surface's cached/declared manifest. */
+type SurfaceAmendments = {
+    add?: (RegisteredToolSpec | InlineToolSpec | AgentToolSpec)[];
+    remove?: string[];
+};
+/** TableCellBookmark */
+type TableCellBookmark = {
+    type?: "table_cell";
+    table_id: string;
+    row_id: string;
+    column_name: string;
+    table_name?: string | null;
+    [key: string]: unknown;
+};
+/** TableColumnBookmark */
+type TableColumnBookmark = {
+    type?: "table_column";
+    table_id: string;
+    column_name: string;
+    table_name?: string | null;
+    [key: string]: unknown;
+};
+/** TableInputPart */
+type TableInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "input_table";
+    bookmarks: (FullTableBookmark | TableColumnBookmark | TableRowBookmark | TableCellBookmark | TableSchemaBookmark)[];
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+};
+/** TableRowBookmark */
+type TableRowBookmark = {
+    type?: "table_row";
+    table_id: string;
+    row_id: string;
+    table_name?: string | null;
+    [key: string]: unknown;
+};
+/** TableSchemaBookmark */
+type TableSchemaBookmark = {
+    type?: "table_schema";
+    table_id: string;
+    table_name?: string | null;
+    [key: string]: unknown;
+};
+/** TaskInputPart */
+type TaskInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "input_task";
+    task_ids: (string | ResourceRefInput)[];
+    template?: string;
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+};
+/** TextPart */
+type TextPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "text";
+    text?: string;
+    id?: string;
+    citations?: NormalizedCitation[];
+};
+/** ThinkingPart */
+type ThinkingPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "thinking";
+    text?: string;
+    id?: string;
+    provider?: ("openai" | "anthropic" | "google" | "cerebras" | "moonshot" | "together" | "groq" | "xai" | "generic_openai") | null;
+    signature?: string | null;
+    signature_encoding?: "base64" | null;
+    summary?: unknown[];
+};
+/** Where a reply landed in a comment thread — what a client opens (THREADS */
+type ThreadLink = {
+    entity_type: string;
+    entity_id: string;
+    root_id: string;
+    reply_id: string;
+    handle: string;
+};
+/** ToolCallPart */
+type ToolCallPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "tool_call";
+    call_id?: string;
+    name?: string;
+    arguments?: {
+        [key: string]: unknown;
+    };
+};
+/** ToolResultPart */
+type ToolResultPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "tool_result";
+    call_id?: string;
+    tool_use_id?: string;
+    name?: string;
+    is_error?: boolean;
+    output_chars?: number;
+    output_preview?: {
+        [key: string]: unknown;
+    } | null;
+};
+/** TranscriptInputPart */
+type TranscriptInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+    template?: ("full" | "compact" | "minimal") | null;
+    type: "input_transcript";
+    transcript_ids: string[];
+};
+/** TranscriptSessionInputPart */
+type TranscriptSessionInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+    template?: ("full" | "compact" | "minimal") | null;
+    type: "input_transcript_session";
+    transcript_session_ids: string[];
+};
+/** One pre-rendered dialogue turn for ElevenLabs ``text_to_dialogue`` — the */
+type TtsDialogueTurn = {
+    /** Spoken text for this turn. */
+    text: string;
+    /** Provider-native voice id speaking this turn. */
+    voice_id: string;
+};
+/** TtsVoiceSpeaker */
+type TtsVoiceSpeaker = {
+    /** Speaker label in multi-speaker TTS scripts. */
+    name: string;
+    /** Provider-native voice id or name. */
+    voice: string;
+    /** Optional speaker gender ('male' / 'female'). Never sent to a provider — it lets TTSVoiceConfig pair voices with the SCRIPT's speaker labels by gender when the two disagree, instead of positionally (wh */
+    gender?: string;
+};
+/** Round-tripped user preferences row. */
+type UserAnalysisPreferencesResponse = {
+    per_detector_enabled?: {
+        [key: string]: boolean;
+    };
+    default_tier_per_detector?: {
+        [key: string]: string;
+    };
+    custom_patterns?: JsonValue[];
+    default_redaction_mode?: string;
+    per_file_type_overrides?: {
+        [key: string]: JsonValue;
+    };
+    substitute_formats?: {
+        [key: string]: string;
+    };
+    updated_at?: JsonValue | null;
+    [key: string]: unknown;
+};
+/** UserAudioMediaPart */
+type UserAudioMediaPart = {
+    url: string;
+} | {
+    file_id: string;
+} | {
+    base64_data: string;
+};
+/** UserDocumentMediaPart */
+type UserDocumentMediaPart = {
+    url: string;
+} | {
+    file_id: string;
+} | {
+    base64_data: string;
+};
+/** UserImageMediaPart */
+type UserImageMediaPart = {
+    url: string;
+} | {
+    file_id: string;
+} | {
+    base64_data: string;
+};
+/** Per-request user-level inclusion / exclusion overrides. */
+type UserOverrides = {
+    add?: string[];
+    remove?: string[];
+    apply_policy?: ("auto" | "ask" | "off") | null;
+    auto_tools?: boolean | null;
+};
+/** UserVideoMediaPart */
+type UserVideoMediaPart = {
+    url: string;
+} | {
+    file_id: string;
+} | {
+    base64_data: string;
+};
+/** UserYouTubeMediaPart */
+type UserYouTubeMediaPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "media";
+    kind: "youtube";
+    url: string;
+    external_url?: string | null;
+    origin?: "external";
+    mime_type?: string | null;
+};
+/** ValidateCronRequest */
+type ValidateCronRequest = {
+    expression: string;
+    tz?: string;
+    next_n?: number;
+};
+/** ValidateCronResponse */
+type ValidateCronResponse = {
+    valid: boolean;
+    error?: string | null;
+    next_fires_utc?: string[];
+};
+/** WebSearchPart */
+type WebSearchPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "web_search";
+    id?: string;
+    status?: string;
+};
+/** WebpageInputPart */
+type WebpageInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    type: "input_webpage";
+    urls: (string | PreFetchedUrl)[];
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+};
+/** WorkbookInputPart */
+type WorkbookInputPart = {
+    metadata?: {
+        [key: string]: unknown;
+    };
+    convert_to_text?: boolean;
+    optional_context?: boolean;
+    keep_fresh?: boolean;
+    editable?: boolean | null;
+    template?: ("full" | "compact" | "minimal") | null;
+    type: "input_workbook";
+    workbook_ids: (string | LiveResourceRefInput)[];
+};
+
+export type { ActionNeeded, ActionNeededAction, ActionNeededChoice, ActionNeededKind, ActionNeededStatus, AgentAppInputPart, AgentInputPart, AgentStartRequest, AgentToolSpec, Asset, AssetVariant, BlockStateRef, CacheBypass, CalendarCreateResult, CalendarEventAttendee, CalendarLocalRefreshResult, ChatMessageInput, ChatToolCallInput, ClientContext, CodeExecPart, CodeResultPart, CompactionSettings, ComputeNextDueResponse, ContextAnchor, ContextInputPart, CustomTool, CustomToolInputSchema, DataInputPart, DataRefSort, DbFieldRef, DbQueryRef, DbRecordRef, DecisionAnswer, DecisionAnswersPart, DecisionQuestion, DecisionQuestionsPart, DecisionUsage_Input, DictionaryConfig, DictionaryEntry, DirectiveItemApplied, DirectiveItemFailed, DocumentInputPart, ExternalSourceMetadata, FullListBookmark, FullTableBookmark, GlossaryEntry, IdeDiagnostic, IdeFileState, IdeGitState, IdeState, IdeWorkspaceState, ImageLora, InlineToolSpec, JsonSchemaObjectDocument, JsonSchemaProperty, JsonValue, LLMParams, ListGroupBookmark, ListInputPart, ListItemBookmark, LiveResourceRefInput, MandateTestHolder, MediaRef, NormalizedCitation, NotesInputPart, OutputSchemaEnvelope, PageContext, PreFetchedUrl, ProjectInputPart, PromptStartRequest, RegisteredToolSpec, RemarkAnswer, RemarkItem, RemarkTarget, RemarkThreadEntry, RemarksInputPart, ResourceContextPolicy, ResourcePromotion, ResourceRefInput, ResponseFormatJsonObject, ResponseFormatJsonSchema, ResponseFormatText, RunNowResponse, SandboxBindingRequest, SnapshotBodyResourceRefInput, SnapshotContentResourceRefInput, SnapshotDescriptionResourceRefInput, SnapshotTextResourceRefInput, SnapshotValueResourceRefInput, SpeechScriptPart, SpeechTurn, StorageImportResult, SurfaceAmendments, TableCellBookmark, TableColumnBookmark, TableInputPart, TableRowBookmark, TableSchemaBookmark, TaskInputPart, TextPart, ThinkingPart, ThreadLink, ToolCallPart, ToolResultPart, TranscriptInputPart, TranscriptSessionInputPart, TtsDialogueTurn, TtsVoiceSpeaker, UserAnalysisPreferencesResponse, UserAudioMediaPart, UserDocumentMediaPart, UserImageMediaPart, UserOverrides, UserVideoMediaPart, UserYouTubeMediaPart, ValidateCronRequest, ValidateCronResponse, WebSearchPart, WebpageInputPart, WorkbookInputPart };