windmill-client 1.849.0 → 1.851.0

package/dist/types.gen.d.ts

@@ -1045,7 +1045,7 @@ export type AiAgent = {
          */
         id: string;
         /**
-         * The name the AI agent calls this tool by, not a human label. On a flowmodule tool it must match ^[a-zA-Z0-9_]+$ - letters, numbers and underscores only (e.g. 'search_documentation', not 'Search documentation') - and always be set; on an mcp or websearch tool it is a plain label. Put the human-readable explanation in 'description'.
+         * The name the AI agent calls this tool by, not a human label. On a flowmodule tool it must match ^[a-zA-Z0-9_]+$ - letters, numbers and underscores only (e.g. 'search_documentation', not 'Search documentation') - and always be set; on an mcp, websearch or question tool it is a plain label. Put the human-readable explanation in 'description'.
          */
         summary?: string;
         /**
@@ -1056,6 +1056,10 @@ export type AiAgent = {
          * Scopes the token of this tool's jobs is restricted to, on top of the agent step's own restriction: a tool can only narrow it.
          */
         job_token_scopes?: Array<(string)> | null;
+        /**
+         * Flowmodule and mcp tools only. Each call waits for a person to approve or reject it from the flow's run page or chat, without the agent holding a worker. Calls in the same turn that do not require approval run right away. A rejected call, or one nobody answers within 30 minutes, is reported to the AI as not run.
+         */
+        requires_approval?: boolean;
         /**
          * The implementation of a tool. Can be a flow module (script/flow) or an MCP tool reference
          */
@@ -1077,6 +1081,12 @@ export type AiAgent = {
             exclude_tools?: Array<(string)>;
         } | {
             tool_type: 'websearch';
+        } | {
+            tool_type: 'question';
+            /**
+             * Seconds to wait for an answer before the question is reported to the AI as timed out. Defaults to 1800.
+             */
+            timeout?: number;
         };
     }>;
     type: 'aiagent';
@@ -1230,6 +1240,27 @@ export type FlowStatusModule = {
         };
     } | {
         type: 'web_search';
+    } | {
+        type: 'approval';
+        call_id: string;
+        calls: Array<{
+            function_name: string;
+            arguments: unknown;
+        }>;
+        expires_at: string;
+    } | {
+        type: 'question';
+        call_id: string;
+        question: string;
+        /**
+         * answers the model proposes; a free-text answer is always possible
+         */
+        choices?: Array<(string)>;
+        /**
+         * whether several choices can be picked together
+         */
+        multi_select?: boolean;
+        expires_at: string;
     } | {
         type: 'message';
     })>;
@@ -6888,6 +6919,10 @@ export type GitRepositorySettings = {
     auto_pull?: AutoPullSettings;
     promotion_open_prs?: boolean;
     fork_open_prs?: boolean;
+    /**
+     * review every pull request against the tracked branch with the workspace's AI
+     */
+    ai_review_prs?: boolean;
     /**
      * server-owned, last failure opening a PR for a deploy branch of this repo
      */
@@ -7190,6 +7225,10 @@ export type RoleCapabilities = {
     apps: AuthorLevel;
     manage_schedules: boolean;
     manage_triggers: boolean;
+    /**
+     * Fork the workspace.
+     */
+    fork: boolean;
     visibility: RoleVisibility;
 };
 /**
@@ -7201,6 +7240,7 @@ export type RoleCapabilitiesPatch = {
     apps?: AuthorLevel;
     manage_schedules?: boolean;
     manage_triggers?: boolean;
+    fork?: boolean;
     visibility?: {
         [key: string]: (boolean);
     };
@@ -7608,6 +7648,13 @@ export type ProtectionRuleset = {
     rules: ProtectionRules;
     bypass_groups: RuleBypasserGroups;
     bypass_users: RuleBypasserUsers;
+    fork_role_mapping?: ForkRoleMapping;
+};
+/**
+ * Role a member of this workspace gets in a fork of it, keyed by the role it holds here. Unmapped roles carry over unchanged; where two rulesets map the same role, the first by name wins. On update, omitting it leaves the stored mapping unchanged.
+ */
+export type ForkRoleMapping = {
+    [key: string]: (string);
 };
 /**
  * Configuration of protection restrictions
@@ -10351,6 +10398,7 @@ export type CreateProtectionRuleData = {
         rules: ProtectionRules;
         bypass_groups: RuleBypasserGroups;
         bypass_users: RuleBypasserUsers;
+        fork_role_mapping?: ForkRoleMapping;
     };
     workspace: string;
 };
@@ -10367,6 +10415,7 @@ export type UpdateProtectionRuleData = {
         rules: ProtectionRules;
         bypass_groups: RuleBypasserGroups;
         bypass_users: RuleBypasserUsers;
+        fork_role_mapping?: ForkRoleMapping;
     };
     /**
      * Name of the protection rule to update
@@ -10605,6 +10654,7 @@ export type GetInstanceUiResponse = {
     instance_banner?: unknown;
     accent_color?: unknown;
     api_base_url?: unknown;
+    api_base_url_applies_to?: unknown;
 };
 export type GetRuffConfigResponse = string;
 export type GetLocalResponse = unknown;
@@ -16288,250 +16338,22 @@ export type UnshareAgentFromSlackChannelData = {
     workspace: string;
 };
 export type UnshareAgentFromSlackChannelResponse = string;
-export type ListEvalDatasetsData = {
-    workspace: string;
-};
-export type ListEvalDatasetsResponse = Array<EvalDataset>;
-export type CreateEvalDatasetData = {
-    /**
-     * new eval dataset
-     */
+export type CompleteAiData = {
     requestBody: {
-        path: string;
-        summary?: string;
-        scorers?: Array<Scorer>;
-        /**
-         * The cases to create the dataset holding, so one can be assembled in a single act rather than created empty and filled in afterwards.
-         */
-        cases?: Array<NewEvalCase>;
-    };
-    workspace: string;
-};
-export type CreateEvalDatasetResponse = string;
-export type GetEvalDatasetData = {
-    path: string;
-    workspace: string;
-};
-export type GetEvalDatasetResponse = EvalDataset;
-export type UpdateEvalDatasetData = {
-    path: string;
-    /**
-     * updated eval dataset
-     */
-    requestBody: {
-        /**
-         * Renames the dataset. Its cases and experiments follow through the foreign keys, so a rename keeps the history it already has.
-         *
-         */
-        path?: string;
-        /**
-         * Left out to keep the stored summary; sent as "" to clear it.
-         */
-        summary?: string;
-        /**
-         * Left out to keep the dataset's columns as they are; sent to replace them wholesale.
-         *
-         */
-        scorers?: Array<Scorer>;
+        system: string;
+        user: string;
         /**
-         * The cases as they should stand afterwards: all of them, each carrying its id if the dataset already has it. Sent with the rest of an edit so that a rename the dataset refuses refuses the case edits with it.
-         *
+         * defaults to the AI config's default model
          */
-        cases?: Array<SaveEvalCase>;
+        model?: AIProviderModel;
+        max_tokens?: number;
     };
     workspace: string;
 };
-export type UpdateEvalDatasetResponse = string;
-export type DeleteEvalDatasetData = {
-    path: string;
-    workspace: string;
-};
-export type DeleteEvalDatasetResponse = string;
-export type ListEvalCasesData = {
-    /**
-     * which page to return (start at 1, default 1)
-     */
-    page?: number;
-    path: string;
-    /**
-     * number of items to return for a given page (default 30, max 100)
-     */
-    perPage?: number;
-    workspace: string;
-};
-export type ListEvalCasesResponse = {
-    cases: Array<EvalCase>;
-};
-export type EvalSubjectStateData = {
-    path: string;
-    workspace: string;
-};
-export type EvalSubjectStateResponse = {
-    version?: number;
-};
-export type EvalRunPayloadData = {
-    /**
-     * The flow job that answered the case.
-     */
-    jobId: string;
-    workspace: string;
-};
-export type EvalRunPayloadResponse = {
-    /**
-     * The case, the answer, and every tool call the agent made.
-     */
-    run: {
-        [key: string]: unknown;
-    };
-    /**
-     * The same run as a judge agent is shown it.
-     */
-    rendered: string;
-};
-export type ScorerDefaultsData = {
-    workspace: string;
-};
-export type ScorerDefaultsResponse = {
-    /**
-     * The system prompt a judge agent is created with.
-     */
-    judge_prompt: string;
-    script_template: string;
-};
-export type RecentScorersData = {
-    /**
-     * only scorers of this kind
-     */
-    kind?: 'script' | 'agent';
-    workspace: string;
-};
-export type RecentScorersResponse = Array<(Scorer & {
-    /**
-     * The dataset it is a column of.
-     */
-    dataset: string;
-})>;
-export type RunExperimentData = {
-    /**
-     * what to run
-     */
-    requestBody: {
-        dataset: string;
-        subject: EvalSubject;
-    };
-    workspace: string;
-};
-export type RunExperimentResponse = string;
-export type CollectExperimentData = {
-    id: string;
-    workspace: string;
-};
-export type CollectExperimentResponse = number;
-export type ListAllExperimentsData = {
-    /**
-     * Restrict to one agent's runs, which is what makes the list a history rather than a log. Runs of what is deployed, of a past version, and of the edits waiting on top are all that agent's, so this does not discriminate by kind.
-     *
-     */
-    subjectPath?: string;
-    workspace: string;
-};
-export type ListAllExperimentsResponse = Array<EvalExperiment>;
-export type ExperimentResultsData = {
-    /**
-     * The experiment every column is compared against. A delta is only computed between two scores of the same scorer id, and a column the baseline was never scored with reports it rather than showing a difference.
-     *
-     */
-    baseline?: string;
-    /**
-     * the experiment to read
-     */
-    id: string;
-    path: string;
-    workspace: string;
-};
-export type ExperimentResultsResponse = {
-    experiment: EvalExperiment;
-    baseline?: EvalExperiment;
-    /**
-     * The columns, which belong to the dataset rather than the experiment.
-     */
-    scorers: Array<Scorer>;
-    rows: Array<ExperimentRow>;
-    means: Array<ScorerMean>;
-    /**
-     * Cells scoring lower than the baseline, across every column.
-     */
-    regressed: number;
-    /**
-     * The version the subject is on now. A row that ran against an earlier one describes an agent that no longer exists.
-     *
-     */
-    subject_current_version?: number;
-    /**
-     * What the agent hashes to as deployed. A run of unsaved edits carrying this hash ran exactly what is deployed now — the edits were saved — so it is a run of that version rather than of edits.
-     *
-     */
-    subject_deployed_hash?: string;
-};
-export type ListPathAutocompletePathsData = {
-    /**
-     * bypass the server-side cache and re-query the DB, refreshing the
-     * cache. Used right after a deploy so the new path appears immediately.
-     *
-     */
-    force?: boolean;
-    workspace: string;
-};
-export type ListPathAutocompletePathsResponse = {
-    paths: Array<(string)>;
-};
-export type ListRawAppsData = {
-    /**
-     * filter by exact matching user creator. Supports comma-separated list (e.g. 'alice,bob') and negation by prefixing all values with '!' (e.g. '!alice,!bob')
-     */
-    createdBy?: string;
-    /**
-     * When true, append per-user draft rows whose path has no
-     * deployed counterpart. Synthesized rows carry `draft_only: true`
-     * so the home page can render a "Draft" badge. Gated to
-     * non-operators + page 0 + no narrowing filters on the backend so
-     * picker callers stay deployed-only and pagination stays clean.
-     *
-     */
-    includeDraftOnly?: boolean;
-    /**
-     * Filter by label
-     */
-    label?: string;
-    /**
-     * order by desc order (default true)
-     */
-    orderDesc?: boolean;
-    /**
-     * which page to return (start at 1, default 1)
-     */
-    page?: number;
-    /**
-     * mask to filter exact matching path
-     */
-    pathExact?: string;
-    /**
-     * mask to filter matching starting path
-     */
-    pathStart?: string;
-    /**
-     * number of items to return for a given page (default 30, max 100)
-     */
-    perPage?: number;
-    /**
-     * (default false)
-     * show only the starred items
-     *
-     */
-    starredOnly?: boolean;
-    workspace: string;
+export type CompleteAiResponse = {
+    text: string;
+    model: AIProviderModel;
 };
-export type ListRawAppsResponse = Array<ListableRawApp>;
 export type RecordAiUsageData = {
     requestBody: {
         events: Array<AITokenUsageEvent>;
@@ -16711,6 +16533,250 @@ export type UnshareAiSessionData = {
     workspace: string;
 };
 export type UnshareAiSessionResponse = string;
+export type ListEvalDatasetsData = {
+    workspace: string;
+};
+export type ListEvalDatasetsResponse = Array<EvalDataset>;
+export type CreateEvalDatasetData = {
+    /**
+     * new eval dataset
+     */
+    requestBody: {
+        path: string;
+        summary?: string;
+        scorers?: Array<Scorer>;
+        /**
+         * The cases to create the dataset holding, so one can be assembled in a single act rather than created empty and filled in afterwards.
+         */
+        cases?: Array<NewEvalCase>;
+    };
+    workspace: string;
+};
+export type CreateEvalDatasetResponse = string;
+export type GetEvalDatasetData = {
+    path: string;
+    workspace: string;
+};
+export type GetEvalDatasetResponse = EvalDataset;
+export type UpdateEvalDatasetData = {
+    path: string;
+    /**
+     * updated eval dataset
+     */
+    requestBody: {
+        /**
+         * Renames the dataset. Its cases and experiments follow through the foreign keys, so a rename keeps the history it already has.
+         *
+         */
+        path?: string;
+        /**
+         * Left out to keep the stored summary; sent as "" to clear it.
+         */
+        summary?: string;
+        /**
+         * Left out to keep the dataset's columns as they are; sent to replace them wholesale.
+         *
+         */
+        scorers?: Array<Scorer>;
+        /**
+         * The cases as they should stand afterwards: all of them, each carrying its id if the dataset already has it. Sent with the rest of an edit so that a rename the dataset refuses refuses the case edits with it.
+         *
+         */
+        cases?: Array<SaveEvalCase>;
+    };
+    workspace: string;
+};
+export type UpdateEvalDatasetResponse = string;
+export type DeleteEvalDatasetData = {
+    path: string;
+    workspace: string;
+};
+export type DeleteEvalDatasetResponse = string;
+export type ListEvalCasesData = {
+    /**
+     * which page to return (start at 1, default 1)
+     */
+    page?: number;
+    path: string;
+    /**
+     * number of items to return for a given page (default 30, max 100)
+     */
+    perPage?: number;
+    workspace: string;
+};
+export type ListEvalCasesResponse = {
+    cases: Array<EvalCase>;
+};
+export type EvalSubjectStateData = {
+    path: string;
+    workspace: string;
+};
+export type EvalSubjectStateResponse = {
+    version?: number;
+};
+export type EvalRunPayloadData = {
+    /**
+     * The flow job that answered the case.
+     */
+    jobId: string;
+    workspace: string;
+};
+export type EvalRunPayloadResponse = {
+    /**
+     * The case, the answer, and every tool call the agent made.
+     */
+    run: {
+        [key: string]: unknown;
+    };
+    /**
+     * The same run as a judge agent is shown it.
+     */
+    rendered: string;
+};
+export type ScorerDefaultsData = {
+    workspace: string;
+};
+export type ScorerDefaultsResponse = {
+    /**
+     * The system prompt a judge agent is created with.
+     */
+    judge_prompt: string;
+    script_template: string;
+};
+export type RecentScorersData = {
+    /**
+     * only scorers of this kind
+     */
+    kind?: 'script' | 'agent';
+    workspace: string;
+};
+export type RecentScorersResponse = Array<(Scorer & {
+    /**
+     * The dataset it is a column of.
+     */
+    dataset: string;
+})>;
+export type RunExperimentData = {
+    /**
+     * what to run
+     */
+    requestBody: {
+        dataset: string;
+        subject: EvalSubject;
+    };
+    workspace: string;
+};
+export type RunExperimentResponse = string;
+export type CollectExperimentData = {
+    id: string;
+    workspace: string;
+};
+export type CollectExperimentResponse = number;
+export type ListAllExperimentsData = {
+    /**
+     * Restrict to one agent's runs, which is what makes the list a history rather than a log. Runs of what is deployed, of a past version, and of the edits waiting on top are all that agent's, so this does not discriminate by kind.
+     *
+     */
+    subjectPath?: string;
+    workspace: string;
+};
+export type ListAllExperimentsResponse = Array<EvalExperiment>;
+export type ExperimentResultsData = {
+    /**
+     * The experiment every column is compared against. A delta is only computed between two scores of the same scorer id, and a column the baseline was never scored with reports it rather than showing a difference.
+     *
+     */
+    baseline?: string;
+    /**
+     * the experiment to read
+     */
+    id: string;
+    path: string;
+    workspace: string;
+};
+export type ExperimentResultsResponse = {
+    experiment: EvalExperiment;
+    baseline?: EvalExperiment;
+    /**
+     * The columns, which belong to the dataset rather than the experiment.
+     */
+    scorers: Array<Scorer>;
+    rows: Array<ExperimentRow>;
+    means: Array<ScorerMean>;
+    /**
+     * Cells scoring lower than the baseline, across every column.
+     */
+    regressed: number;
+    /**
+     * The version the subject is on now. A row that ran against an earlier one describes an agent that no longer exists.
+     *
+     */
+    subject_current_version?: number;
+    /**
+     * What the agent hashes to as deployed. A run of unsaved edits carrying this hash ran exactly what is deployed now — the edits were saved — so it is a run of that version rather than of edits.
+     *
+     */
+    subject_deployed_hash?: string;
+};
+export type ListPathAutocompletePathsData = {
+    /**
+     * bypass the server-side cache and re-query the DB, refreshing the
+     * cache. Used right after a deploy so the new path appears immediately.
+     *
+     */
+    force?: boolean;
+    workspace: string;
+};
+export type ListPathAutocompletePathsResponse = {
+    paths: Array<(string)>;
+};
+export type ListRawAppsData = {
+    /**
+     * filter by exact matching user creator. Supports comma-separated list (e.g. 'alice,bob') and negation by prefixing all values with '!' (e.g. '!alice,!bob')
+     */
+    createdBy?: string;
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
+    /**
+     * Filter by label
+     */
+    label?: string;
+    /**
+     * order by desc order (default true)
+     */
+    orderDesc?: boolean;
+    /**
+     * which page to return (start at 1, default 1)
+     */
+    page?: number;
+    /**
+     * mask to filter exact matching path
+     */
+    pathExact?: string;
+    /**
+     * mask to filter matching starting path
+     */
+    pathStart?: string;
+    /**
+     * number of items to return for a given page (default 30, max 100)
+     */
+    perPage?: number;
+    /**
+     * (default false)
+     * show only the starred items
+     *
+     */
+    starredOnly?: boolean;
+    workspace: string;
+};
+export type ListRawAppsResponse = Array<ListableRawApp>;
 export type ResumeSuspendedTriggerJobsData = {
     /**
      * Optional list of job IDs to reassign
@@ -20011,6 +20077,10 @@ export type GetHubProjectExportData = {
      * hub project slug (3-50 chars, lowercase alphanumeric and hyphens, no leading/trailing hyphen)
      */
     slug: string;
+    /**
+     * id of a reviewed project version to export instead of the current one (see the hub's `/projects/{slug}/versions`)
+     */
+    version?: number;
     workspace: string;
 };
 export type GetHubProjectExportResponse = string;
@@ -24172,6 +24242,7 @@ export type $OpenApiTs = {
                     rules: ProtectionRules;
                     bypass_groups: RuleBypasserGroups;
                     bypass_users: RuleBypasserUsers;
+                    fork_role_mapping?: ForkRoleMapping;
                 };
                 workspace: string;
             };
@@ -24201,6 +24272,7 @@ export type $OpenApiTs = {
                     rules: ProtectionRules;
                     bypass_groups: RuleBypasserGroups;
                     bypass_users: RuleBypasserUsers;
+                    fork_role_mapping?: ForkRoleMapping;
                 };
                 /**
                  * Name of the protection rule to update
@@ -24748,12 +24820,13 @@ export type $OpenApiTs = {
         get: {
             res: {
                 /**
-                 * the instance_banner, accent_color and api_base_url settings
+                 * the instance_banner, accent_color, api_base_url and api_base_url_applies_to settings
                  */
                 200: {
                     instance_banner?: unknown;
                     accent_color?: unknown;
                     api_base_url?: unknown;
+                    api_base_url_applies_to?: unknown;
                 };
             };
         };
@@ -33701,6 +33774,334 @@ export type $OpenApiTs = {
             };
         };
     };
+    '/w/{workspace}/ai/complete': {
+        post: {
+            req: {
+                requestBody: {
+                    system: string;
+                    user: string;
+                    /**
+                     * defaults to the AI config's default model
+                     */
+                    model?: AIProviderModel;
+                    max_tokens?: number;
+                };
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the answer, and the model that wrote it
+                 */
+                200: {
+                    text: string;
+                    model: AIProviderModel;
+                };
+            };
+        };
+    };
+    '/w/{workspace}/ai/usage': {
+        post: {
+            req: {
+                requestBody: {
+                    events: Array<AITokenUsageEvent>;
+                };
+                workspace: string;
+            };
+            res: {
+                /**
+                 * usage recorded
+                 */
+                204: void;
+            };
+        };
+        get: {
+            req: {
+                days?: number;
+                groupBy?: 'day' | 'user' | 'model';
+                /**
+                 * workspace-wide usage (admin only) or the calling user's own
+                 */
+                scope?: 'workspace' | 'self';
+                workspace: string;
+            };
+            res: {
+                /**
+                 * usage buckets
+                 */
+                200: {
+                    buckets: Array<AITokenUsageBucket>;
+                    /**
+                     * more buckets matched than were returned, so summing them under-reports
+                     */
+                    truncated: boolean;
+                };
+            };
+        };
+    };
+    '/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: {
+                requestBody: {
+                    /**
+                     * the artifact's id in the author's session
+                     */
+                    artifact_id: string;
+                    name: string;
+                    kind: 'md' | 'html';
+                    version: number;
+                    content: string;
+                };
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the shared copy
+                 */
+                200: SharedAiArtifactInfo;
+            };
+        };
+    };
+    '/w/{workspace}/ai/shared_artifacts/status': {
+        get: {
+            req: {
+                artifactId: string;
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the live share, if any, and how long shares last
+                 */
+                200: {
+                    retention_secs: number;
+                    share?: SharedAiArtifactInfo;
+                };
+            };
+        };
+    };
+    '/w/{workspace}/ai/shared_artifacts/get/{id}': {
+        get: {
+            req: {
+                id: string;
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the shared artifact
+                 */
+                200: SharedAiArtifactInfo & {
+                    content: string;
+                    /**
+                     * whether the caller authored the share or is a workspace admin
+                     */
+                    can_unshare: boolean;
+                };
+            };
+        };
+    };
+    '/w/{workspace}/ai/shared_artifacts/delete/{id}': {
+        delete: {
+            req: {
+                id: string;
+                workspace: string;
+            };
+            res: {
+                /**
+                 * share deleted
+                 */
+                200: string;
+            };
+        };
+    };
+    '/w/{workspace}/ai/shared_sessions/share': {
+        post: {
+            req: {
+                requestBody: {
+                    /**
+                     * the session's id in the author's browser
+                     */
+                    session_id: string;
+                    name: string;
+                    /**
+                     * left as it is on an existing share when absent; a new share starts private
+                     */
+                    is_public?: boolean;
+                    message_count: number;
+                    snapshot: {
+                        [key: string]: unknown;
+                    };
+                };
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the shared snapshot
+                 */
+                200: SharedAiSessionInfo;
+            };
+        };
+    };
+    '/w/{workspace}/ai/shared_sessions/status': {
+        get: {
+            req: {
+                sessionId: string;
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the share, if any
+                 */
+                200: {
+                    share?: SharedAiSessionInfo;
+                };
+            };
+        };
+    };
+    '/w/{workspace}/ai/shared_sessions/set_public/{id}': {
+        post: {
+            req: {
+                id: string;
+                requestBody: {
+                    is_public: boolean;
+                };
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the updated share
+                 */
+                200: SharedAiSessionInfo;
+            };
+        };
+    };
+    '/w/{workspace}/ai_u/shared_sessions/get/{id}': {
+        get: {
+            req: {
+                id: string;
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the shared session
+                 */
+                200: SharedAiSessionInfo & {
+                    snapshot: {
+                        [key: string]: unknown;
+                    };
+                    /**
+                     * whether the caller authored the share or is a workspace admin
+                     */
+                    can_unshare: boolean;
+                };
+            };
+        };
+    };
+    '/w/{workspace}/ai/shared_sessions/delete/{id}': {
+        delete: {
+            req: {
+                id: string;
+                workspace: string;
+            };
+            res: {
+                /**
+                 * share deleted
+                 */
+                200: string;
+            };
+        };
+    };
     '/w/{workspace}/ai_evals/datasets/list': {
         get: {
             req: {
@@ -34090,309 +34491,6 @@ export type $OpenApiTs = {
             };
         };
     };
-    '/w/{workspace}/ai/usage': {
-        post: {
-            req: {
-                requestBody: {
-                    events: Array<AITokenUsageEvent>;
-                };
-                workspace: string;
-            };
-            res: {
-                /**
-                 * usage recorded
-                 */
-                204: void;
-            };
-        };
-        get: {
-            req: {
-                days?: number;
-                groupBy?: 'day' | 'user' | 'model';
-                /**
-                 * workspace-wide usage (admin only) or the calling user's own
-                 */
-                scope?: 'workspace' | 'self';
-                workspace: string;
-            };
-            res: {
-                /**
-                 * usage buckets
-                 */
-                200: {
-                    buckets: Array<AITokenUsageBucket>;
-                    /**
-                     * more buckets matched than were returned, so summing them under-reports
-                     */
-                    truncated: boolean;
-                };
-            };
-        };
-    };
-    '/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: {
-                requestBody: {
-                    /**
-                     * the artifact's id in the author's session
-                     */
-                    artifact_id: string;
-                    name: string;
-                    kind: 'md' | 'html';
-                    version: number;
-                    content: string;
-                };
-                workspace: string;
-            };
-            res: {
-                /**
-                 * the shared copy
-                 */
-                200: SharedAiArtifactInfo;
-            };
-        };
-    };
-    '/w/{workspace}/ai/shared_artifacts/status': {
-        get: {
-            req: {
-                artifactId: string;
-                workspace: string;
-            };
-            res: {
-                /**
-                 * the live share, if any, and how long shares last
-                 */
-                200: {
-                    retention_secs: number;
-                    share?: SharedAiArtifactInfo;
-                };
-            };
-        };
-    };
-    '/w/{workspace}/ai/shared_artifacts/get/{id}': {
-        get: {
-            req: {
-                id: string;
-                workspace: string;
-            };
-            res: {
-                /**
-                 * the shared artifact
-                 */
-                200: SharedAiArtifactInfo & {
-                    content: string;
-                    /**
-                     * whether the caller authored the share or is a workspace admin
-                     */
-                    can_unshare: boolean;
-                };
-            };
-        };
-    };
-    '/w/{workspace}/ai/shared_artifacts/delete/{id}': {
-        delete: {
-            req: {
-                id: string;
-                workspace: string;
-            };
-            res: {
-                /**
-                 * share deleted
-                 */
-                200: string;
-            };
-        };
-    };
-    '/w/{workspace}/ai/shared_sessions/share': {
-        post: {
-            req: {
-                requestBody: {
-                    /**
-                     * the session's id in the author's browser
-                     */
-                    session_id: string;
-                    name: string;
-                    /**
-                     * left as it is on an existing share when absent; a new share starts private
-                     */
-                    is_public?: boolean;
-                    message_count: number;
-                    snapshot: {
-                        [key: string]: unknown;
-                    };
-                };
-                workspace: string;
-            };
-            res: {
-                /**
-                 * the shared snapshot
-                 */
-                200: SharedAiSessionInfo;
-            };
-        };
-    };
-    '/w/{workspace}/ai/shared_sessions/status': {
-        get: {
-            req: {
-                sessionId: string;
-                workspace: string;
-            };
-            res: {
-                /**
-                 * the share, if any
-                 */
-                200: {
-                    share?: SharedAiSessionInfo;
-                };
-            };
-        };
-    };
-    '/w/{workspace}/ai/shared_sessions/set_public/{id}': {
-        post: {
-            req: {
-                id: string;
-                requestBody: {
-                    is_public: boolean;
-                };
-                workspace: string;
-            };
-            res: {
-                /**
-                 * the updated share
-                 */
-                200: SharedAiSessionInfo;
-            };
-        };
-    };
-    '/w/{workspace}/ai_u/shared_sessions/get/{id}': {
-        get: {
-            req: {
-                id: string;
-                workspace: string;
-            };
-            res: {
-                /**
-                 * the shared session
-                 */
-                200: SharedAiSessionInfo & {
-                    snapshot: {
-                        [key: string]: unknown;
-                    };
-                    /**
-                     * whether the caller authored the share or is a workspace admin
-                     */
-                    can_unshare: boolean;
-                };
-            };
-        };
-    };
-    '/w/{workspace}/ai/shared_sessions/delete/{id}': {
-        delete: {
-            req: {
-                id: string;
-                workspace: string;
-            };
-            res: {
-                /**
-                 * share deleted
-                 */
-                200: string;
-            };
-        };
-    };
     '/w/{workspace}/trigger/{trigger_kind}/resume_suspended_trigger_jobs/{trigger_path}': {
         post: {
             req: {
@@ -40290,6 +40388,10 @@ export type $OpenApiTs = {
                  * hub project slug (3-50 chars, lowercase alphanumeric and hyphens, no leading/trailing hyphen)
                  */
                 slug: string;
+                /**
+                 * id of a reviewed project version to export instead of the current one (see the hub's `/projects/{slug}/versions`)
+                 */
+                version?: number;
                 workspace: string;
             };
             res: {