windmill-client 1.812.0 → 1.814.0

package/dist/types.gen.d.ts

@@ -639,10 +639,16 @@ export type ProviderConfig = {
     reasoning_effort?: string;
 };
 /**
- * Conversation memory configuration
+ * Managed memory, stored by Windmill and replayed with each request. The memory is named by a memory id, see `memory_id`. While it is off, a step can supply its history in `previous_messages`.
  */
 export type MemoryConfig = {
     kind: 'off';
+} | {
+    kind: 'window';
+    /**
+     * Number of most recent messages to load and store. 0 turns memory off.
+     */
+    context_length: number;
 } | {
     kind: 'auto';
     /**
@@ -903,9 +909,12 @@ export type AiAgent = {
          */
         output_type?: InputTransform;
         /**
-         * The user's prompt/message to the AI agent. Supports variable interpolation with flow.input syntax.
+         * The user's prompt/message to the AI agent. Supports variable interpolation with
+         * flow.input syntax. Required unless memory is off and `previous_messages` supplies
+         * the prompt; image output always needs it.
+         *
          */
-        user_message: InputTransform;
+        user_message?: InputTransform;
         /**
          * System instructions that guide the AI's behavior, persona, and response style. Optional.
          */
@@ -923,6 +932,24 @@ export type AiAgent = {
             value: MemoryConfig;
             type: 'static';
         } | JavascriptTransform | AiTransform;
+        /**
+         * String. Names the memory this step reads and writes, overriding the memory id the run
+         * was started with (the chat conversation, an app chat session or the `memory_id` run
+         * parameter). Leave unset to use the run's memory id. A fixed value shares one memory
+         * across every run; an expression such as `flow_input.customer_id` keeps one memory per
+         * key. When it evaluates to an empty value the agent runs without memory. Read only
+         * while `memory` is `window`: it is ignored when memory is off, and an older `auto` or
+         * `manual` memory reads neither history input.
+         *
+         */
+        memory_id?: InputTransform;
+        /**
+         * Array of MemoryMessage. History supplied by the flow, sent between the system prompt
+         * and the user message. Read only while `memory` is off or absent: managed memory
+         * ignores it, and an older `auto` or `manual` memory reads neither history input.
+         *
+         */
+        previous_messages?: InputTransform;
         /**
          * JSON Schema object defining structured output format. Used when you need the AI to return data in a specific shape.
          * Supports standard JSON Schema properties: type, properties, required, items, enum, pattern, minLength, maxLength, minimum, maximum, etc.
@@ -1023,7 +1050,7 @@ export type AiAgent = {
      * Path of a reusable `ai_agent` resource (hybrid linking). When set, the agent brain
      * config (provider/model/system prompt/etc.) and tool set are resolved at runtime from
      * that resource; the module's input_transforms then only carry the flow-local inputs
-     * (user_message/user_attachments/enabled_tools).
+     * (user_message, user_attachments, enabled_tools and the history inputs memory_id and previous_messages).
      *
      */
     agent?: string;
@@ -1796,6 +1823,10 @@ export type FlowConversation = {
      * Username who created the conversation
      */
     created_by: string;
+    /**
+     * Started from the flow editor's test panel rather than a deployed run
+     */
+    is_test: boolean;
 };
 export type FlowConversationMessage = {
     /**
@@ -1834,6 +1865,36 @@ export type FlowConversationMessage = {
      * Whether the message is a success
      */
     success?: boolean;
+    /**
+     * On a tool row, the arguments the model wrote for the call. For a script, flow or AI agent tool these exclude the inputs its step wires in, which only the tool's job holds. Null for a provider-native web search, whose query the provider does not return.
+     */
+    tool_arguments?: string | null;
+    /**
+     * On a tool row, the text the model got back from the call, or what the call failed with — the row's own text names the tool rather than the reason. For a provider-native web search, its citations.
+     */
+    tool_result?: string | null;
+    /**
+     * On an answer, the thinking that produced it; on a tool row, the thinking that led to the call. Each round's thinking is on one row. The agent job's result keeps the turn's thinking as a single string.
+     */
+    reasoning?: string | null;
+    /**
+     * The files a user message carried, as object-storage references: every flow input other than user_message that held one or a list of them, at most 20. Never file bytes or a presigned URL.
+     */
+    attachments?: Array<{
+        /**
+         * The flow input that held the file
+         */
+        input: string;
+        /**
+         * The file's key in object storage
+         */
+        s3: string;
+        /**
+         * The secondary storage holding the file, absent for the primary one
+         */
+        storage?: string;
+        filename?: string;
+    }> | null;
 };
 export type EndpointTool = {
     /**
@@ -1907,6 +1968,97 @@ export type AIConfig = {
      * Hides the Windmill AI assistant (chat, sessions, code generation, completion, fixes) from the workspace UI. Read from the workspace's own settings even when the providers served fall back to the instance config. AI agent steps and the AI sandbox in flows are unaffected.
      */
     copilot_disabled?: boolean;
+    /**
+     * Stops browsers from backing their AI sessions up to the workspace's object storage. Read from the workspace's own settings like `copilot_disabled`.
+     */
+    sessions_storage_disabled?: boolean;
+    /**
+     * The server deletes the backup of a session no push has reached for this many days. Unset keeps backups until the user deletes the session. Read from the workspace's own settings like `copilot_disabled`.
+     */
+    sessions_retention_days?: number;
+};
+export type AISessionBackupListing = {
+    id: string;
+    updated_at: string;
+    /**
+     * the session's move count when this copy was pushed; of a session two workspaces list, the copy with the higher one is the later
+     */
+    epoch: number;
+};
+export type AISessionBackupImage = {
+    chat_id: string;
+    id: string;
+    data_url: string;
+};
+export type AISessionBackupChat = {
+    id: string;
+    record: {
+        [key: string]: unknown;
+    };
+};
+export type AISessionBackup = {
+    id: string;
+    head: {
+        [key: string]: unknown;
+    };
+    chats: Array<AISessionBackupChat>;
+    images: Array<AISessionBackupImage>;
+    artifacts?: {
+        [key: string]: unknown;
+    };
+    next?: AISessionBackupCursor;
+    /**
+     * a fingerprint of the session's listing; pages of one session whose fingerprints differ do not belong together
+     */
+    listing: string;
+    /**
+     * the backup kept changing while this page was read, so it may mix two versions; the browser starts the session over
+     */
+    moved?: boolean;
+};
+/**
+ * where a pull of a session that did not fit one answer whole picks up; the rest of the session follows a pull naming that session alone with this as `resume`
+ */
+export type AISessionBackupCursor = {
+    id: string;
+    images: boolean;
+    after: string;
+};
+export type AISessionBackupPush = {
+    id: string;
+    head?: {
+        [key: string]: unknown;
+    };
+    chats?: Array<AISessionBackupChat>;
+    images?: Array<AISessionBackupImage>;
+    artifacts?: {
+        [key: string]: unknown;
+    };
+    delete_chats?: Array<(string)>;
+    delete_images?: Array<{
+        chat_id: string;
+        id: string;
+    }>;
+    /**
+     * more parts of this session follow, in this push or a later one; the session is not listed on this one. Such a part names its push (`push`), or it is refused
+     */
+    partial?: boolean;
+    /**
+     * a part of a push of the session whole; the head is on the part that opens it, which replaces whatever the storage holds of the session, and every piece the browser has is on one of them. An incremental part instead rides on a session the storage lists and is refused with needs_whole when it lists none
+     */
+    whole?: boolean;
+    /**
+     * a push split over several parts names itself on each with a token the browser draws; the part that opens it unlists the session and the last part lists it again, and a later part is written only while that token is the one there (refused with needs_whole otherwise)
+     */
+    push?: string;
+    /**
+     * this part opens the push named by `push`
+     */
+    opens?: boolean;
+    /**
+     * the session's move count (its record's `moves`), kept with the marker that lists the session; an incremental part rides on the marker of the same count
+     */
+    epoch?: number;
 };
 /**
  * Read-only. Present when the workspace has no AI provider of its own and is running on Windmill's free tier. Ignored on write.
@@ -2041,6 +2193,10 @@ export type RunnableItem = {
     auto_kind?: string;
     use_codebase?: boolean;
     has_deploy_errors?: boolean;
+    /**
+     * flow-only. `chat_input_enabled` of the flow's value, projected so the list can mark flows that open as a chat. Omitted when the value has no such field.
+     */
+    chat_input_enabled?: boolean;
     raw_app?: boolean;
     execution_mode?: string;
     id?: number;
@@ -8111,6 +8267,14 @@ export type GetSessionWorkspaceStatusData = {
 export type GetSessionWorkspaceStatusResponse = {
     [key: string]: ('active' | 'archived' | 'deleted');
 };
+export type GetSessionWorkspaceRetentionData = {
+    requestBody: {
+        workspace_ids: Array<(string)>;
+    };
+};
+export type GetSessionWorkspaceRetentionResponse = {
+    [key: string]: (number);
+};
 export type GetWorkspaceAsSuperAdminData = {
     workspace: string;
 };
@@ -10659,6 +10823,14 @@ export type ListFlowsData = {
 };
 export type ListFlowsResponse = Array<(Flow & {
     draft_only?: boolean;
+    /**
+     * `chat_input_enabled` of the flow's value,
+     * projected so the list can mark flows that open
+     * as a chat. Omitted when the value has no such
+     * field.
+     *
+     */
+    chat_input_enabled?: boolean;
     /**
      * True when the authed user has a draft for this
      * flow — either no deployed row exists at this
@@ -10708,6 +10880,11 @@ export type ListFlowPathsFromWorkspaceRunnableData = {
     workspace: string;
 };
 export type ListFlowPathsFromWorkspaceRunnableResponse = Array<(string)>;
+export type ListFlowPathsLinkingAgentData = {
+    path: string;
+    workspace: string;
+};
+export type ListFlowPathsLinkingAgentResponse = Array<(string)>;
 export type GetFlowVersionData = {
     version: number;
     workspace: string;
@@ -12376,7 +12553,7 @@ export type RunWaitResultFlowByPathData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     path: string;
@@ -12408,7 +12585,7 @@ export type RunWaitResultFlowByVersionData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     /**
@@ -12443,7 +12620,7 @@ export type RunWaitResultFlowByVersionGetData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     /**
@@ -12480,7 +12657,7 @@ export type RunAndStreamFlowByPathData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     path: string;
@@ -12516,7 +12693,7 @@ export type RunAndStreamFlowByPathGetData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     path: string;
@@ -12554,7 +12731,7 @@ export type RunAndStreamFlowByVersionData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     /**
@@ -12593,7 +12770,7 @@ export type RunAndStreamFlowByVersionGetData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     /**
@@ -12834,7 +13011,7 @@ export type RunFlowByPathData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     /**
@@ -12881,7 +13058,7 @@ export type RunFlowByVersionData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     /**
@@ -13176,7 +13353,7 @@ export type RunFlowPreviewData = {
      */
     jobId?: string;
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     /**
@@ -13188,7 +13365,7 @@ export type RunFlowPreviewData = {
 export type RunFlowPreviewResponse = string;
 export type RunFlowPreviewAndWaitResultData = {
     /**
-     * memory ID for chat-enabled flows
+     * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
      */
     memoryId?: string;
     /**
@@ -14668,6 +14845,10 @@ export type ListFlowConversationsData = {
      * filter conversations by flow path
      */
     flowPath?: string;
+    /**
+     * which conversations to list - the flow editor's test chats, the deployed flow's own (the default), or both
+     */
+    kind?: 'test' | 'deployed' | 'all';
     /**
      * which page to return (start at 1, default 1)
      */
@@ -14679,6 +14860,20 @@ export type ListFlowConversationsData = {
     workspace: string;
 };
 export type ListFlowConversationsResponse = Array<FlowConversation>;
+export type UpdateFlowConversationData = {
+    /**
+     * conversation id
+     */
+    conversationId: string;
+    requestBody: {
+        /**
+         * the chat's name
+         */
+        title: string;
+    };
+    workspace: string;
+};
+export type UpdateFlowConversationResponse = string;
 export type DeleteFlowConversationData = {
     /**
      * conversation id
@@ -14974,6 +15169,72 @@ export type ListAiUsageResponse = {
      */
     truncated: boolean;
 };
+export type ListAiSessionBackupsData = {
+    workspace: string;
+};
+export type ListAiSessionBackupsResponse = {
+    enabled: boolean;
+    /**
+     * names the storage answered from; sync state recorded against another one is void
+     */
+    storage_id?: string;
+    /**
+     * bumped by every workspace key rotation; sync state recorded under another one is void
+     */
+    backup_generation?: number;
+    /**
+     * the storage answered from is the instance object store, standing in for a workspace without storage of its own; a removal owed to it is retired by any answer from the workspace's own storage
+     */
+    fallback?: boolean;
+    /**
+     * the newest 500 at most
+     */
+    sessions: Array<AISessionBackupListing>;
+    /**
+     * the user has more sessions than the answer names
+     */
+    truncated?: boolean;
+};
+export type PullAiSessionBackupsData = {
+    requestBody: {
+        ids: Array<(string)>;
+        resume?: AISessionBackupCursor;
+    };
+    workspace: string;
+};
+export type PullAiSessionBackupsResponse = {
+    enabled: boolean;
+    storage_id?: string;
+    backup_generation?: number;
+    fallback?: boolean;
+    sessions: Array<AISessionBackup>;
+    deferred: Array<(string)>;
+};
+export type PushAiSessionBackupsData = {
+    requestBody: {
+        /**
+         * the email the push was prepared for; refused with a 409 when it is not the caller's
+         */
+        owner: string;
+        sessions?: Array<AISessionBackupPush>;
+        removed?: Array<(string)>;
+    };
+    workspace: string;
+};
+export type PushAiSessionBackupsResponse = {
+    enabled: boolean;
+    storage_id?: string;
+    backup_generation?: number;
+    fallback?: boolean;
+    results: Array<{
+        id: string;
+        error?: string;
+        /**
+         * nothing was written and the session must be pushed whole again; an incremental part found no listed session to ride on (the backup was removed, or a push split over parts is in progress or was abandoned), or a later part of a push split over parts found another push had superseded it
+         */
+        needs_whole?: boolean;
+    }>;
+};
 export type ShareAiArtifactData = {
     requestBody: {
         /**
@@ -19923,6 +20184,23 @@ export type $OpenApiTs = {
             };
         };
     };
+    '/workspaces/session_workspace_retention': {
+        post: {
+            req: {
+                requestBody: {
+                    workspace_ids: Array<(string)>;
+                };
+            };
+            res: {
+                /**
+                 * map of workspace id to its `ai_config.sessions_retention_days`; a workspace without a retention, or one the caller cannot be authenticated into, is absent
+                 */
+                200: {
+                    [key: string]: (number);
+                };
+            };
+        };
+    };
     '/w/{workspace}/workspaces/get_as_superadmin': {
         get: {
             req: {
@@ -24722,6 +25000,14 @@ export type $OpenApiTs = {
                  */
                 200: Array<(Flow & {
                     draft_only?: boolean;
+                    /**
+                     * `chat_input_enabled` of the flow's value,
+                     * projected so the list can mark flows that open
+                     * as a chat. Omitted when the value has no such
+                     * field.
+                     *
+                     */
+                    chat_input_enabled?: boolean;
                     /**
                      * True when the authed user has a draft for this
                      * flow — either no deployed row exists at this
@@ -24801,6 +25087,20 @@ export type $OpenApiTs = {
             };
         };
     };
+    '/w/{workspace}/flows/list_paths_linking_agent/{path}': {
+        get: {
+            req: {
+                path: string;
+                workspace: string;
+            };
+            res: {
+                /**
+                 * paths of the flows linking the `ai_agent` resource, as of their last deploy
+                 */
+                200: Array<(string)>;
+            };
+        };
+    };
     '/w/{workspace}/flows/get/v/{version}': {
         get: {
             req: {
@@ -27535,7 +27835,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 path: string;
@@ -27576,7 +27876,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 /**
@@ -27618,7 +27918,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 /**
@@ -27664,7 +27964,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 path: string;
@@ -27707,7 +28007,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 path: string;
@@ -27754,7 +28054,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 /**
@@ -27800,7 +28100,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 /**
@@ -28109,7 +28409,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 /**
@@ -28165,7 +28465,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 /**
@@ -28577,7 +28877,7 @@ export type $OpenApiTs = {
                  */
                 jobId?: string;
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 /**
@@ -28598,7 +28898,7 @@ export type $OpenApiTs = {
         post: {
             req: {
                 /**
-                 * memory ID for chat-enabled flows
+                 * Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.
                  */
                 memoryId?: string;
                 /**
@@ -30684,6 +30984,10 @@ export type $OpenApiTs = {
                  * filter conversations by flow path
                  */
                 flowPath?: string;
+                /**
+                 * which conversations to list - the flow editor's test chats, the deployed flow's own (the default), or both
+                 */
+                kind?: 'test' | 'deployed' | 'all';
                 /**
                  * which page to return (start at 1, default 1)
                  */
@@ -30702,6 +31006,29 @@ export type $OpenApiTs = {
             };
         };
     };
+    '/w/{workspace}/flow_conversations/update/{conversation_id}': {
+        post: {
+            req: {
+                /**
+                 * conversation id
+                 */
+                conversationId: string;
+                requestBody: {
+                    /**
+                     * the chat's name
+                     */
+                    title: string;
+                };
+                workspace: string;
+            };
+            res: {
+                /**
+                 * flow conversation updated
+                 */
+                200: string;
+            };
+        };
+    };
     '/w/{workspace}/flow_conversations/delete/{conversation_id}': {
         delete: {
             req: {
@@ -31176,6 +31503,99 @@ export type $OpenApiTs = {
             };
         };
     };
+    '/w/{workspace}/ai/sessions/list': {
+        get: {
+            req: {
+                workspace: string;
+            };
+            res: {
+                /**
+                 * backups, newest first; `enabled` is false when the workspace has no storage for them
+                 */
+                200: {
+                    enabled: boolean;
+                    /**
+                     * names the storage answered from; sync state recorded against another one is void
+                     */
+                    storage_id?: string;
+                    /**
+                     * bumped by every workspace key rotation; sync state recorded under another one is void
+                     */
+                    backup_generation?: number;
+                    /**
+                     * the storage answered from is the instance object store, standing in for a workspace without storage of its own; a removal owed to it is retired by any answer from the workspace's own storage
+                     */
+                    fallback?: boolean;
+                    /**
+                     * the newest 500 at most
+                     */
+                    sessions: Array<AISessionBackupListing>;
+                    /**
+                     * the user has more sessions than the answer names
+                     */
+                    truncated?: boolean;
+                };
+            };
+        };
+    };
+    '/w/{workspace}/ai/sessions/pull': {
+        post: {
+            req: {
+                requestBody: {
+                    ids: Array<(string)>;
+                    resume?: AISessionBackupCursor;
+                };
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the backups found; `deferred` lists ids that did not fit the response budget
+                 */
+                200: {
+                    enabled: boolean;
+                    storage_id?: string;
+                    backup_generation?: number;
+                    fallback?: boolean;
+                    sessions: Array<AISessionBackup>;
+                    deferred: Array<(string)>;
+                };
+            };
+        };
+    };
+    '/w/{workspace}/ai/sessions/push': {
+        post: {
+            req: {
+                requestBody: {
+                    /**
+                     * the email the push was prepared for; refused with a 409 when it is not the caller's
+                     */
+                    owner: string;
+                    sessions?: Array<AISessionBackupPush>;
+                    removed?: Array<(string)>;
+                };
+                workspace: string;
+            };
+            res: {
+                /**
+                 * one result per session written or removed, in request order
+                 */
+                200: {
+                    enabled: boolean;
+                    storage_id?: string;
+                    backup_generation?: number;
+                    fallback?: boolean;
+                    results: Array<{
+                        id: string;
+                        error?: string;
+                        /**
+                         * nothing was written and the session must be pushed whole again; an incremental part found no listed session to ride on (the backup was removed, or a push split over parts is in progress or was abandoned), or a later part of a push split over parts found another push had superseded it
+                         */
+                        needs_whole?: boolean;
+                    }>;
+                };
+            };
+        };
+    };
     '/w/{workspace}/ai/shared_artifacts/share': {
         post: {
             req: {