@axivoy/api 1.31.0 → 1.33.0

package/dist/generated/schema.d.ts

@@ -443,6 +443,94 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/ops/agents.improvements.get": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Suggested agent change
+         * @description One suggestion: what changed against the active version, what each edit did on the runs it was tried on (helped, hurt, no observed effect, unclear), the lesson recorded, replay scores of the suggestion against the active version, credits used and the improver method version.
+         *
+         *     Kind: `read`. Errors use the envelope `{error: {code, reason, message, fields}}`.
+         */
+        post: operations["ops.agents.improvements.get"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/ops/agents.improvements.list": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Suggested agent changes
+         * @description Improvement cycles and their suggestions for one agent, newest first, with status (running, suggested, kept as is, accepted, in trial, promoted, rolled back, rejected).
+         *
+         *     Kind: `read`. Errors use the envelope `{error: {code, reason, message, fields}}`.
+         */
+        post: operations["ops.agents.improvements.list"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/ops/agents.improvements.reject": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Reject a suggested agent change
+         * @description Closes a suggestion without changing the agent. The reason is stored in the agent's lessons library as a person's verdict, so later cycles see it.
+         *
+         *     Kind: `mutate`. Errors use the envelope `{error: {code, reason, message, fields}}`.
+         */
+        post: operations["ops.agents.improvements.reject"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/ops/agents.improvements.start": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Look for improvements to an agent
+         * @description Async. Starts an improvement cycle for one tenant-built agent: the improver studies its recent runs, tries candidate changes by replay and in the sandbox, and leaves a suggestion (or keeps the agent as is) for a person to decide. Consumes AI credits from the sandbox allowance. Returns a task.
+         *
+         *     Kind: `mutate`. Errors use the envelope `{error: {code, reason, message, fields}}`.
+         */
+        post: operations["ops.agents.improvements.start"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/ops/agents.list": {
         parameters: {
             query?: never;
@@ -17055,6 +17143,146 @@ export interface paths {
     };
 }
 export interface webhooks {
+    "agent.improvement.accepted": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Agent change accepted
+         * @description A person accepted a suggested change. It became a new version on trial: a share of new runs use it until the hourly review promotes or rolls it back.
+         *
+         *     Version 1. Delivered at least once; dedupe by `id`.
+         *
+         *     Read the current record with `agents.improvements.get` using `fetch.input`.
+         *
+         *     Subscriptions can filter on: `agent_key` (Agent), `trial_share` (Percent of new runs on the new version).
+         *
+         *     Verify `Axivoy-Signature` before trusting the body; answer 2xx within 10 seconds. Failed tries retry at 1 minute, 10 minutes, 1 hour, 6 hours and 16 hours; replay any delivery from the last 30 days with `webhooks.deliveries.replay`.
+         */
+        post: operations["events.agent.improvement.accepted"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "agent.improvement.rejected": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Agent change rejected
+         * @description A person rejected a suggested change. The agent did not change; the reason went into the agent's lessons so later cycles see it.
+         *
+         *     Version 1. Delivered at least once; dedupe by `id`.
+         *
+         *     Read the current record with `agents.improvements.get` using `fetch.input`.
+         *
+         *     Subscriptions can filter on: `agent_key` (Agent).
+         *
+         *     Verify `Axivoy-Signature` before trusting the body; answer 2xx within 10 seconds. Failed tries retry at 1 minute, 10 minutes, 1 hour, 6 hours and 16 hours; replay any delivery from the last 30 days with `webhooks.deliveries.replay`.
+         */
+        post: operations["events.agent.improvement.rejected"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "agent.improvement.suggested": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Agent change suggested
+         * @description The agent improver finished a cycle and left a suggested change that scored at least as well as the active version on replay. A person accepts or rejects it.
+         *
+         *     Version 1. Delivered at least once; dedupe by `id`.
+         *
+         *     Read the current record with `agents.improvements.get` using `fetch.input`.
+         *
+         *     Subscriptions can filter on: `agent_key` (Agent), `credits_used` (AI credits the cycle used).
+         *
+         *     Verify `Axivoy-Signature` before trusting the body; answer 2xx within 10 seconds. Failed tries retry at 1 minute, 10 minutes, 1 hour, 6 hours and 16 hours; replay any delivery from the last 30 days with `webhooks.deliveries.replay`.
+         */
+        post: operations["events.agent.improvement.suggested"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "agent.version_trial.promoted": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Agent version trial promoted
+         * @description A version on trial did no worse than the active version over its window, so it became the version every run uses.
+         *
+         *     Version 1. Delivered at least once; dedupe by `id`.
+         *
+         *     Read the current record with `agents.improvements.get` using `fetch.input`.
+         *
+         *     Subscriptions can filter on: `agent_key` (Agent), `trial_runs` (Runs on the new version), `active_runs` (Runs on the active version).
+         *
+         *     Verify `Axivoy-Signature` before trusting the body; answer 2xx within 10 seconds. Failed tries retry at 1 minute, 10 minutes, 1 hour, 6 hours and 16 hours; replay any delivery from the last 30 days with `webhooks.deliveries.replay`.
+         */
+        post: operations["events.agent.version_trial.promoted"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "agent.version_trial.rolled_back": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Agent version trial rolled back
+         * @description A version on trial did worse than the active version on at least one signal, or the agent was paused or pinned, so every run went back to the active version.
+         *
+         *     Version 1. Delivered at least once; dedupe by `id`.
+         *
+         *     Read the current record with `agents.improvements.get` using `fetch.input`.
+         *
+         *     Subscriptions can filter on: `agent_key` (Agent), `reason` (Why it rolled back).
+         *
+         *     Verify `Axivoy-Signature` before trusting the body; answer 2xx within 10 seconds. Failed tries retry at 1 minute, 10 minutes, 1 hour, 6 hours and 16 hours; replay any delivery from the last 30 days with `webhooks.deliveries.replay`.
+         */
+        post: operations["events.agent.version_trial.rolled_back"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "bank_connection.link_requested": {
         parameters: {
             query?: never;
@@ -20912,7 +21140,7 @@ export interface operations {
             };
         };
     };
-    "ops.agents.list": {
+    "ops.agents.improvements.get": {
         parameters: {
             query?: never;
             header?: {
@@ -20926,17 +21154,14 @@ export interface operations {
         };
         requestBody?: {
             content: {
-                /** @example {} */
+                /**
+                 * @example {
+                 *       "improvement_id": 1
+                 *     }
+                 */
                 "application/json": {
-                    /** @description Cursor from the previous page's next_cursor. */
-                    cursor?: string | null;
-                    /** @description Rows per page (default 25). */
-                    limit?: number | null;
-                    /**
-                     * Format: date-time
-                     * @description Only rows changed at or after this instant, oldest change first, with deleted rows as tombstones.
-                     */
-                    updated_since?: string | null;
+                    /** @description The improvement, from agents.improvements.list. */
+                    improvement_id: number;
                 };
             };
         };
@@ -20950,109 +21175,99 @@ export interface operations {
                     /**
                      * @example {
                      *       "result": {
-                     *         "items": [
+                     *         "id": 1,
+                     *         "agent_key": "yard_helper",
+                     *         "status": "suggested",
+                     *         "base_version": 1,
+                     *         "diff": [
+                     *           {
+                     *             "part": "instructions",
+                     *             "before": "You keep the yard tidy.",
+                     *             "after": "You keep the yard tidy. Check the gate log before answering."
+                     *           }
+                     *         ],
+                     *         "edits": [
                      *           {
-                     *             "id": 1,
-                     *             "key": "fixture_desk",
-                     *             "name": "Fixture desk",
-                     *             "origin": "axivoy",
-                     *             "owner_name": null,
-                     *             "status": "off",
-                     *             "disabled_at": "2026-10-20T20:56:40Z",
-                     *             "disabled_cause": "person",
-                     *             "disabled_reason": "Too chatty",
-                     *             "disabled_by": "Dayne Huel",
-                     *             "platform_holds": [],
-                     *             "limit_reached": null,
-                     *             "active_version": 1,
-                     *             "max_runs_per_day": null,
-                     *             "max_tool_calls_per_run": null,
-                     *             "monthly_credit_budget": null,
-                     *             "runs_today": 1,
-                     *             "credits_used_this_month": 0,
-                     *             "credits_last_hour": 0,
-                     *             "refusals_last_hour": 0,
-                     *             "open_runs": 1,
-                     *             "rehearsals_running": 0,
-                     *             "last_run_at": "2026-10-20T20:56:40Z",
-                     *             "deleted": null
+                     *             "part": "instructions",
+                     *             "change": "Read the gate log first.",
+                     *             "observed": "Fewer wrong answers.",
+                     *             "verdict": "helped"
                      *           }
                      *         ],
-                     *         "next_cursor": null
+                     *         "situations": [
+                     *           {
+                     *             "situation": "s1",
+                     *             "active_run_id": null,
+                     *             "suggested_run_id": null,
+                     *             "verdict": "confounded",
+                     *             "summary": "Not tried on both versions yet."
+                     *           }
+                     *         ],
+                     *         "lesson": {
+                     *           "cue": "Gate questions",
+                     *           "lesson": "Read the gate log first.",
+                     *           "evidence": "Two runs",
+                     *           "confidence": "medium"
+                     *         },
+                     *         "replay_score_active": 0.7,
+                     *         "replay_score_suggested": 0.8,
+                     *         "credits_used": 0,
+                     *         "method_version": null,
+                     *         "created_at": "2026-10-21T10:05:20Z"
                      *       }
                      *     }
                      */
                     "application/json": {
                         result: {
-                            /** @description One page of rows. */
-                            items: {
-                                /** @description The row's id. */
-                                id: number;
-                                /** @description The agent's key, for example recruiting_desk */
-                                key: string;
-                                /** @description The agent's name */
-                                name: string;
-                                /** @description axivoy (made by Axivoy) or tenant (built in this workspace) */
-                                origin: string;
-                                /** @description Who owns the agent; null for Axivoy's agents */
-                                owner_name?: string | null;
-                                /** @description on, off, auto_paused, paused_by_axivoy or at_limit */
-                                status: string;
-                                /**
-                                 * Format: date-time
-                                 * @description When it was turned off
-                                 */
-                                disabled_at?: string | null;
-                                /** @description person or circuit_breaker */
-                                disabled_cause?: string | null;
-                                /** @description Why it was turned off, in the words of whoever did it */
-                                disabled_reason?: string | null;
-                                /** @description Who turned it off; null when the breaker did */
-                                disabled_by?: string | null;
-                                /** @description Holds Axivoy placed on the agent */
-                                platform_holds: {
-                                    /** @description pause_tenant, pause_definition or pin_version */
-                                    kind: string;
-                                    /** @description The pinned version, for pin_version */
-                                    version?: number | null;
-                                    /**
-                                     * Format: date-time
-                                     * @description When Axivoy placed it
-                                     */
-                                    since?: string | null;
-                                }[];
-                                /** @description max_runs_per_day or monthly_credit_budget when one is used up */
-                                limit_reached?: string | null;
-                                /** @description The live version */
-                                active_version?: number | null;
-                                /** @description Runs per UTC day; null when unlimited */
-                                max_runs_per_day?: number | null;
-                                /** @description Tool calls per run; null when unlimited */
-                                max_tool_calls_per_run?: number | null;
-                                /** @description AI credits per UTC month; null when unlimited */
-                                monthly_credit_budget?: number | null;
-                                /** @description Runs started this UTC day */
-                                runs_today: number;
-                                /** @description AI credits used this UTC month */
-                                credits_used_this_month: number;
-                                /** @description AI credits used in the last hour */
-                                credits_last_hour: number;
-                                /** @description Tool calls that failed or were refused in the last hour */
-                                refusals_last_hour: number;
-                                /** @description Runs not finished yet */
-                                open_runs: number;
-                                /** @description Rehearsals not finished yet */
-                                rehearsals_running: number;
-                                /**
-                                 * Format: date-time
-                                 * @description When the latest run started
-                                 */
-                                last_run_at?: string | null;
-                                /** @description True on a tombstone (the row was deleted or recycled); other fields are absent. */
-                                deleted?: boolean | null;
+                            /** @description The improvement id */
+                            id: number;
+                            /** @description The agent's key */
+                            agent_key: string;
+                            /** @description running, suggested, kept_current, accepted, in_trial, promoted, rolled_back or rejected */
+                            status: string;
+                            /** @description Version number the cycle started from */
+                            base_version?: number | null;
+                            /** @description part, before and after for each changed part */
+                            diff: unknown[];
+                            /** @description Each edit tried and what it did */
+                            edits: {
+                                /** @description The part the edit changed */
+                                part: string;
+                                /** @description What changed */
+                                change: string;
+                                /** @description What it did on the runs it was tried on */
+                                observed: string;
+                                /** @description helped, hurt, no_observed_effect or confounded */
+                                verdict: string;
                             }[];
-                            /** @description Pass as cursor for the next page; null on the last page. */
-                            next_cursor?: string | null;
+                            /** @description Each situation as today's version and the suggested version handled it */
+                            situations: {
+                                /** @description The situation id within this improvement, for example s1 */
+                                situation: string;
+                                /** @description The run of today's version on this situation; open it on the run timeline */
+                                active_run_id?: number | null;
+                                /** @description The run of the suggested version on this situation */
+                                suggested_run_id?: number | null;
+                                /** @description helped, hurt, no_observed_effect or confounded */
+                                verdict: string;
+                                /** @description What the two runs came to, in one sentence */
+                                summary: string;
+                            }[];
+                            /** @description cue, lesson, evidence and confidence */
+                            lesson?: Record<string, never> | null;
+                            /** @description Replay score of the active version on the same runs */
+                            replay_score_active?: number | null;
+                            /** @description Replay score of the suggestion */
+                            replay_score_suggested?: number | null;
+                            /** @description AI credits the cycle used */
+                            credits_used: number;
+                            /** @description Improver prompts version and method commit, prompts@commit */
+                            method_version?: string | null;
+                            /**
+                             * Format: date-time
+                             * @description When the cycle started
+                             */
+                            created_at: string;
                         };
                     };
                 };
@@ -21123,7 +21338,7 @@ export interface operations {
             };
         };
     };
-    "ops.agents.rehearse": {
+    "ops.agents.improvements.list": {
         parameters: {
             query?: never;
             header?: {
@@ -21139,39 +21354,26 @@ export interface operations {
             content: {
                 /**
                  * @example {
-                 *       "agent_key": "fake_desk",
-                 *       "mode": "dry_run",
-                 *       "subject": {
-                 *         "id": 1
-                 *       }
+                 *       "agent_key": "yard_helper"
                  *     }
                  */
                 "application/json": {
                     /** @description The agent's key, for example recruiting_desk. */
                     agent_key: string;
-                    /** @description The version to try; the live version when left out. */
-                    version?: number;
                     /**
-                     * @description dry_run: real records, nothing changed or sent. sandbox: practice data in the workspace's sandbox.
+                     * @description Only cycles in this status; all when left out.
                      * @enum {string}
                      */
-                    mode: "dry_run" | "sandbox";
-                    /** @description The record to try it on. Dry run: the record of the agent's latest run when left out. Sandbox: the newest practice record. */
-                    subject?: {
-                        /** @description The record type the agent works on; checked against the agent. */
-                        type?: string;
-                        /** @description The record id. */
-                        id: number;
-                    };
-                    /** @description Dry run only: a recorded event (its id from events.list) to replay as the trigger; its record becomes the subject. */
-                    event_id?: string;
-                    /** @description Sandbox only: one of the agent's scenario keys. Seeds that scenario's practice record and wakes the agent with its event, so the same situation can be tried on any version. */
-                    scenario?: string;
+                    status?: "running" | "suggested" | "kept_current" | "accepted" | "in_trial" | "promoted" | "rolled_back" | "rejected";
+                    /** @description Cursor from the previous page's next_cursor. */
+                    cursor?: string | null;
+                    /** @description Rows per page (default 25). */
+                    limit?: number | null;
                     /**
-                     * @description live (default): the agent calls its model. scripted: with a scenario that has scripted model turns, those play instead of the model, so two runs of one version give the same steps.
-                     * @enum {string}
+                     * Format: date-time
+                     * @description Only rows changed at or after this instant, oldest change first, with deleted rows as tombstones.
                      */
-                    model?: "live" | "scripted";
+                    updated_since?: string | null;
                 };
             };
         };
@@ -21185,23 +21387,58 @@ export interface operations {
                     /**
                      * @example {
                      *       "result": {
-                     *         "message": "Trying it without changing anything. The result shows here when it stops.",
-                     *         "task_id": "a171294f-f44f-49d9-a87b-6912387bf1e0",
-                     *         "run_id": 1,
-                     *         "status": "running"
+                     *         "items": [
+                     *           {
+                     *             "id": 2,
+                     *             "status": "suggested",
+                     *             "base_version": 1,
+                     *             "suggested_version": 2,
+                     *             "credits_used": 0,
+                     *             "method_version": null,
+                     *             "created_at": "2026-10-21T07:26:58Z",
+                     *             "deleted": null
+                     *           },
+                     *           {
+                     *             "id": 1,
+                     *             "status": "kept_current",
+                     *             "base_version": 1,
+                     *             "suggested_version": null,
+                     *             "credits_used": 0,
+                     *             "method_version": null,
+                     *             "created_at": "2026-10-21T07:26:58Z",
+                     *             "deleted": null
+                     *           }
+                     *         ],
+                     *         "next_cursor": null
                      *       }
                      *     }
                      */
                     "application/json": {
                         result: {
-                            /** @description What happened, in the operator's words */
-                            message: string;
-                            /** @description Poll tasks.get; operation.task.completed fires when the rehearsal stops */
-                            task_id: string;
-                            /** @description The rehearsal run; its timeline shows what the agent would have done */
-                            run_id: number;
-                            /** @description running */
-                            status: string;
+                            /** @description One page of rows. */
+                            items: {
+                                /** @description The row's id. */
+                                id: number;
+                                /** @description running, suggested, kept_current, accepted, in_trial, promoted, rolled_back or rejected */
+                                status: string;
+                                /** @description The version the cycle started from */
+                                base_version?: number | null;
+                                /** @description The suggested version, once there is one */
+                                suggested_version?: number | null;
+                                /** @description AI credits the cycle used */
+                                credits_used: number;
+                                /** @description The improver method and its pinned commit */
+                                method_version?: string | null;
+                                /**
+                                 * Format: date-time
+                                 * @description When the cycle started
+                                 */
+                                created_at: string;
+                                /** @description True on a tombstone (the row was deleted or recycled); other fields are absent. */
+                                deleted?: boolean | null;
+                            }[];
+                            /** @description Pass as cursor for the next page; null on the last page. */
+                            next_cursor?: string | null;
                         };
                     };
                 };
@@ -21272,7 +21509,7 @@ export interface operations {
             };
         };
     };
-    "ops.agents.runs.cancel": {
+    "ops.agents.improvements.reject": {
         parameters: {
             query?: never;
             header?: {
@@ -21288,15 +21525,15 @@ export interface operations {
             content: {
                 /**
                  * @example {
-                 *       "run_id": 1,
-                 *       "reason": "Wrong file"
+                 *       "improvement_id": 2,
+                 *       "reason": "Too wordy for the yard crew."
                  *     }
                  */
                 "application/json": {
-                    /** @description The run to cancel (from agents.runs.list). */
-                    run_id: number;
-                    /** @description Why, for the run timeline and the audit log. */
-                    reason?: string | null;
+                    /** @description The suggestion or change on trial to reject. */
+                    improvement_id: number;
+                    /** @description Why; later improvement cycles read it. */
+                    reason: string;
                 };
             };
         };
@@ -21310,23 +21547,14 @@ export interface operations {
                     /**
                      * @example {
                      *       "result": {
-                     *         "message": "Run cancelled.",
-                     *         "status": "completed",
-                     *         "cancelled": true,
-                     *         "withdrawn_approvals_count": 0
+                     *         "status": "rejected"
                      *       }
                      *     }
                      */
                     "application/json": {
                         result: {
-                            /** @description What happened, in the operator's words */
-                            message: string;
-                            /** @description The run status after the call */
+                            /** @description rejected */
                             status: string;
-                            /** @description False when the run had already ended */
-                            cancelled: boolean;
-                            /** @description Approvals the run was waiting on that were withdrawn */
-                            withdrawn_approvals_count: number;
                         };
                     };
                 };
@@ -21397,7 +21625,7 @@ export interface operations {
             };
         };
     };
-    "ops.agents.runs.list": {
+    "ops.agents.improvements.start": {
         parameters: {
             query?: never;
             header?: {
@@ -21413,26 +21641,22 @@ export interface operations {
             content: {
                 /**
                  * @example {
-                 *       "agent_key": "fixture_desk"
+                 *       "agent_key": "yard_helper",
+                 *       "probes": "replay"
                  *     }
                  */
                 "application/json": {
-                    /** @description The agent's key, for example recruiting_desk. */
+                    /** @description The agent's key. */
                     agent_key: string;
+                    /** @description 1 to 3, default 1: candidates tried per dimension. */
+                    depth?: number;
+                    /** @description Default 10, at most 25. */
+                    max_situations?: number;
                     /**
-                     * @description running, parked (waiting for a person), finished, or cancelled; all when left out.
-                     * @enum {string|null}
-                     */
-                    status?: "running" | "parked" | "finished" | "cancelled" | null;
-                    /** @description Cursor from the previous page's next_cursor. */
-                    cursor?: string | null;
-                    /** @description Rows per page (default 25). */
-                    limit?: number | null;
-                    /**
-                     * Format: date-time
-                     * @description Only rows changed at or after this instant, oldest change first, with deleted rows as tombstones.
+                     * @description Default replay_and_sandbox.
+                     * @enum {string}
                      */
-                    updated_since?: string | null;
+                    probes?: "replay" | "replay_and_sandbox";
                 };
             };
         };
@@ -21446,77 +21670,20 @@ export interface operations {
                     /**
                      * @example {
                      *       "result": {
-                     *         "items": [
-                     *           {
-                     *             "id": 2,
-                     *             "subject": "user:2",
-                     *             "status": "cancelled",
-                     *             "run_status": "completed",
-                     *             "reason": "run_cancelled",
-                     *             "steps": 0,
-                     *             "credits_used": 0,
-                     *             "last_operation_key": null,
-                     *             "started_at": null,
-                     *             "completed_at": null,
-                     *             "delegate": "ai_agent_run:2",
-                     *             "deleted": null
-                     *           },
-                     *           {
-                     *             "id": 1,
-                     *             "subject": "user:1",
-                     *             "status": "running",
-                     *             "run_status": "waiting",
-                     *             "reason": null,
-                     *             "steps": 0,
-                     *             "credits_used": 0,
-                     *             "last_operation_key": null,
-                     *             "started_at": "2026-10-20T19:10:09Z",
-                     *             "completed_at": null,
-                     *             "delegate": "ai_agent_run:1",
-                     *             "deleted": null
-                     *           }
-                     *         ],
-                     *         "next_cursor": null
+                     *         "task_id": "63dafeff-2d0d-4c15-92f9-deea8c649068",
+                     *         "improvement_id": 1,
+                     *         "status": "running"
                      *       }
                      *     }
                      */
                     "application/json": {
                         result: {
-                            /** @description One page of rows. */
-                            items: {
-                                /** @description The row's id. */
-                                id: number;
-                                /** @description What the run is about, as type:id */
-                                subject?: string | null;
-                                /** @description running, parked, finished or cancelled */
-                                status: string;
-                                /** @description The run's own status: pending, active, waiting, paused, completed or failed */
-                                run_status: string;
-                                /** @description Why a parked run waits or how a finished run ended */
-                                reason?: string | null;
-                                /** @description Steps recorded so far */
-                                steps: number;
-                                /** @description AI credits the run used so far */
-                                credits_used: number;
-                                /** @description The operation or tool the run called last */
-                                last_operation_key?: string | null;
-                                /**
-                                 * Format: date-time
-                                 * @description When the run first thought
-                                 */
-                                started_at?: string | null;
-                                /**
-                                 * Format: date-time
-                                 * @description When the run ended
-                                 */
-                                completed_at?: string | null;
-                                /** @description What audit entries for this run record as the delegate */
-                                delegate: string;
-                                /** @description True on a tombstone (the row was deleted or recycled); other fields are absent. */
-                                deleted?: boolean | null;
-                            }[];
-                            /** @description Pass as cursor for the next page; null on the last page. */
-                            next_cursor?: string | null;
+                            /** @description Poll tasks.get; operation.task.completed fires when the cycle ends */
+                            task_id: string;
+                            /** @description The new improvement; open it with agents.improvements.get */
+                            improvement_id: number;
+                            /** @description running */
+                            status: string;
                         };
                     };
                 };
@@ -21587,7 +21754,7 @@ export interface operations {
             };
         };
     };
-    "ops.ai.jobs.list": {
+    "ops.agents.list": {
         parameters: {
             query?: never;
             header?: {
@@ -21603,13 +21770,6 @@ export interface operations {
             content: {
                 /** @example {} */
                 "application/json": {
-                    /**
-                     * @description Only jobs in this status
-                     * @enum {string|null}
-                     */
-                    status?: "pending" | "queued" | "running" | "succeeded" | "failed" | "cancelled" | null;
-                    /** @description Only jobs of this type, for example rate_confirmation_extraction */
-                    job_type?: string | null;
                     /** @description Cursor from the previous page's next_cursor. */
                     cursor?: string | null;
                     /** @description Rows per page (default 25). */
@@ -21635,16 +21795,28 @@ export interface operations {
                      *         "items": [
                      *           {
                      *             "id": 1,
-                     *             "job_type": "stub",
-                     *             "status": "queued",
-                     *             "cancellable": true,
-                     *             "requested_by_user_id": 2,
-                     *             "requested_by_name": "Melisa Will",
-                     *             "attempt_count": 0,
-                     *             "max_attempts": 3,
-                     *             "correlation_id": "3275b72a-1934-4869-af78-d05aeabf6855",
-                     *             "created_at": "2026-10-20T08:18:19Z",
-                     *             "cancelled_at": null,
+                     *             "key": "fixture_desk",
+                     *             "name": "Fixture desk",
+                     *             "origin": "axivoy",
+                     *             "owner_name": null,
+                     *             "status": "off",
+                     *             "disabled_at": "2026-10-20T20:56:40Z",
+                     *             "disabled_cause": "person",
+                     *             "disabled_reason": "Too chatty",
+                     *             "disabled_by": "Dayne Huel",
+                     *             "platform_holds": [],
+                     *             "limit_reached": null,
+                     *             "active_version": 1,
+                     *             "max_runs_per_day": null,
+                     *             "max_tool_calls_per_run": null,
+                     *             "monthly_credit_budget": null,
+                     *             "runs_today": 1,
+                     *             "credits_used_this_month": 0,
+                     *             "credits_last_hour": 0,
+                     *             "refusals_last_hour": 0,
+                     *             "open_runs": 1,
+                     *             "rehearsals_running": 0,
+                     *             "last_run_at": "2026-10-20T20:56:40Z",
                      *             "deleted": null
                      *           }
                      *         ],
@@ -21658,32 +21830,706 @@ export interface operations {
                             items: {
                                 /** @description The row's id. */
                                 id: number;
-                                /** @description What the job does */
-                                job_type: string;
-                                /** @description Lifecycle status */
+                                /** @description The agent's key, for example recruiting_desk */
+                                key: string;
+                                /** @description The agent's name */
+                                name: string;
+                                /** @description axivoy (made by Axivoy) or tenant (built in this workspace) */
+                                origin: string;
+                                /** @description Who owns the agent; null for Axivoy's agents */
+                                owner_name?: string | null;
+                                /** @description on, off, auto_paused, paused_by_axivoy or at_limit */
                                 status: string;
-                                /** @description True while ai.jobs.cancel can still stop it */
-                                cancellable: boolean;
-                                /** @description Who asked for it; null for a system job */
-                                requested_by_user_id?: number | null;
-                                /** @description Their name */
-                                requested_by_name?: string | null;
-                                /** @description Attempts so far */
-                                attempt_count: number;
-                                /** @description Attempts allowed */
-                                max_attempts: number;
-                                /** @description Correlation id shared with the audit log */
-                                correlation_id?: string | null;
                                 /**
                                  * Format: date-time
-                                 * @description When it was queued
+                                 * @description When it was turned off
                                  */
-                                created_at: string;
+                                disabled_at?: string | null;
+                                /** @description person or circuit_breaker */
+                                disabled_cause?: string | null;
+                                /** @description Why it was turned off, in the words of whoever did it */
+                                disabled_reason?: string | null;
+                                /** @description Who turned it off; null when the breaker did */
+                                disabled_by?: string | null;
+                                /** @description Holds Axivoy placed on the agent */
+                                platform_holds: {
+                                    /** @description pause_tenant, pause_definition or pin_version */
+                                    kind: string;
+                                    /** @description The pinned version, for pin_version */
+                                    version?: number | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description When Axivoy placed it
+                                     */
+                                    since?: string | null;
+                                }[];
+                                /** @description max_runs_per_day or monthly_credit_budget when one is used up */
+                                limit_reached?: string | null;
+                                /** @description The live version */
+                                active_version?: number | null;
+                                /** @description Runs per UTC day; null when unlimited */
+                                max_runs_per_day?: number | null;
+                                /** @description Tool calls per run; null when unlimited */
+                                max_tool_calls_per_run?: number | null;
+                                /** @description AI credits per UTC month; null when unlimited */
+                                monthly_credit_budget?: number | null;
+                                /** @description Runs started this UTC day */
+                                runs_today: number;
+                                /** @description AI credits used this UTC month */
+                                credits_used_this_month: number;
+                                /** @description AI credits used in the last hour */
+                                credits_last_hour: number;
+                                /** @description Tool calls that failed or were refused in the last hour */
+                                refusals_last_hour: number;
+                                /** @description Runs not finished yet */
+                                open_runs: number;
+                                /** @description Rehearsals not finished yet */
+                                rehearsals_running: number;
                                 /**
                                  * Format: date-time
-                                 * @description When it was cancelled
+                                 * @description When the latest run started
                                  */
-                                cancelled_at?: string | null;
+                                last_run_at?: string | null;
+                                /** @description True on a tombstone (the row was deleted or recycled); other fields are absent. */
+                                deleted?: boolean | null;
+                            }[];
+                            /** @description Pass as cursor for the next page; null on the last page. */
+                            next_cursor?: string | null;
+                        };
+                    };
+                };
+            };
+            202: components["responses"]["Proposal"];
+            /** @description Refused: credits_exhausted. */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: not_permitted, not_available, authority_off, data_class_blocked. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: not_found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: idempotency_conflict, stale_state. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: operation_retired. */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: invalid_input, domain_rule. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: rate_limited. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+        };
+    };
+    "ops.agents.rehearse": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Replays the first result when the same call is retried. Send one per user intent on writes. */
+                "Idempotency-Key"?: string;
+                /** @description Send `true` to run every check without changing anything. The answer is `{"dry_run": {"outcome": "would_run" | "would_propose", "input": {...}}}`. */
+                "Axivoy-Dry-Run"?: "true" | "false";
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                /**
+                 * @example {
+                 *       "agent_key": "fake_desk",
+                 *       "mode": "dry_run",
+                 *       "subject": {
+                 *         "id": 1
+                 *       }
+                 *     }
+                 */
+                "application/json": {
+                    /** @description The agent's key, for example recruiting_desk. */
+                    agent_key: string;
+                    /** @description The version to try; the live version when left out. */
+                    version?: number;
+                    /**
+                     * @description dry_run: real records, nothing changed or sent. sandbox: practice data in the workspace's sandbox.
+                     * @enum {string}
+                     */
+                    mode: "dry_run" | "sandbox";
+                    /** @description The record to try it on. Dry run: the record of the agent's latest run when left out. Sandbox: the newest practice record. */
+                    subject?: {
+                        /** @description The record type the agent works on; checked against the agent. */
+                        type?: string;
+                        /** @description The record id. */
+                        id: number;
+                    };
+                    /** @description Dry run only: a recorded event (its id from events.list) to replay as the trigger; its record becomes the subject. */
+                    event_id?: string;
+                    /** @description Sandbox only: one of the agent's scenario keys. Seeds that scenario's practice record and wakes the agent with its event, so the same situation can be tried on any version. */
+                    scenario?: string;
+                    /**
+                     * @description live (default): the agent calls its model. scripted: with a scenario that has scripted model turns, those play instead of the model, so two runs of one version give the same steps.
+                     * @enum {string}
+                     */
+                    model?: "live" | "scripted";
+                    /** @description A finished run of this agent to start from, with from_step_seq; its record is the subject. Dry run for a real run, sandbox for a practice run. */
+                    from_run_id?: number;
+                    /** @description With from_run_id: the step number of one of that run's thinks. The try starts from the state just before it, so two versions answer the same moment. */
+                    from_step_seq?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description The operation ran. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "result": {
+                     *         "message": "Trying it without changing anything. The result shows here when it stops.",
+                     *         "task_id": "a171294f-f44f-49d9-a87b-6912387bf1e0",
+                     *         "run_id": 1,
+                     *         "status": "running"
+                     *       }
+                     *     }
+                     */
+                    "application/json": {
+                        result: {
+                            /** @description What happened, in the operator's words */
+                            message: string;
+                            /** @description Poll tasks.get; operation.task.completed fires when the rehearsal stops */
+                            task_id: string;
+                            /** @description The rehearsal run; its timeline shows what the agent would have done */
+                            run_id: number;
+                            /** @description running */
+                            status: string;
+                        };
+                    };
+                };
+            };
+            202: components["responses"]["Proposal"];
+            /** @description Refused: credits_exhausted. */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: not_permitted, not_available, authority_off, data_class_blocked. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: not_found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: idempotency_conflict, stale_state. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: operation_retired. */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: invalid_input, domain_rule. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: rate_limited. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+        };
+    };
+    "ops.agents.runs.cancel": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Replays the first result when the same call is retried. Send one per user intent on writes. */
+                "Idempotency-Key"?: string;
+                /** @description Send `true` to run every check without changing anything. The answer is `{"dry_run": {"outcome": "would_run" | "would_propose", "input": {...}}}`. */
+                "Axivoy-Dry-Run"?: "true" | "false";
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                /**
+                 * @example {
+                 *       "run_id": 1,
+                 *       "reason": "Wrong file"
+                 *     }
+                 */
+                "application/json": {
+                    /** @description The run to cancel (from agents.runs.list). */
+                    run_id: number;
+                    /** @description Why, for the run timeline and the audit log. */
+                    reason?: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description The operation ran. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "result": {
+                     *         "message": "Run cancelled.",
+                     *         "status": "completed",
+                     *         "cancelled": true,
+                     *         "withdrawn_approvals_count": 0
+                     *       }
+                     *     }
+                     */
+                    "application/json": {
+                        result: {
+                            /** @description What happened, in the operator's words */
+                            message: string;
+                            /** @description The run status after the call */
+                            status: string;
+                            /** @description False when the run had already ended */
+                            cancelled: boolean;
+                            /** @description Approvals the run was waiting on that were withdrawn */
+                            withdrawn_approvals_count: number;
+                        };
+                    };
+                };
+            };
+            202: components["responses"]["Proposal"];
+            /** @description Refused: credits_exhausted. */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: not_permitted, not_available, authority_off, data_class_blocked. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: not_found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: idempotency_conflict, stale_state. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: operation_retired. */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: invalid_input, domain_rule. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: rate_limited. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+        };
+    };
+    "ops.agents.runs.list": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Replays the first result when the same call is retried. Send one per user intent on writes. */
+                "Idempotency-Key"?: string;
+                /** @description Send `true` to run every check without changing anything. The answer is `{"dry_run": {"outcome": "would_run" | "would_propose", "input": {...}}}`. */
+                "Axivoy-Dry-Run"?: "true" | "false";
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                /**
+                 * @example {
+                 *       "agent_key": "fixture_desk"
+                 *     }
+                 */
+                "application/json": {
+                    /** @description The agent's key, for example recruiting_desk. */
+                    agent_key: string;
+                    /**
+                     * @description running, parked (waiting for a person), finished, or cancelled; all when left out.
+                     * @enum {string|null}
+                     */
+                    status?: "running" | "parked" | "finished" | "cancelled" | null;
+                    /** @description Cursor from the previous page's next_cursor. */
+                    cursor?: string | null;
+                    /** @description Rows per page (default 25). */
+                    limit?: number | null;
+                    /**
+                     * Format: date-time
+                     * @description Only rows changed at or after this instant, oldest change first, with deleted rows as tombstones.
+                     */
+                    updated_since?: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description The operation ran. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "result": {
+                     *         "items": [
+                     *           {
+                     *             "id": 2,
+                     *             "subject": "user:2",
+                     *             "status": "cancelled",
+                     *             "run_status": "completed",
+                     *             "reason": "run_cancelled",
+                     *             "steps": 0,
+                     *             "credits_used": 0,
+                     *             "last_operation_key": null,
+                     *             "started_at": null,
+                     *             "completed_at": null,
+                     *             "delegate": "ai_agent_run:2",
+                     *             "deleted": null
+                     *           },
+                     *           {
+                     *             "id": 1,
+                     *             "subject": "user:1",
+                     *             "status": "running",
+                     *             "run_status": "waiting",
+                     *             "reason": null,
+                     *             "steps": 0,
+                     *             "credits_used": 0,
+                     *             "last_operation_key": null,
+                     *             "started_at": "2026-10-20T19:10:09Z",
+                     *             "completed_at": null,
+                     *             "delegate": "ai_agent_run:1",
+                     *             "deleted": null
+                     *           }
+                     *         ],
+                     *         "next_cursor": null
+                     *       }
+                     *     }
+                     */
+                    "application/json": {
+                        result: {
+                            /** @description One page of rows. */
+                            items: {
+                                /** @description The row's id. */
+                                id: number;
+                                /** @description What the run is about, as type:id */
+                                subject?: string | null;
+                                /** @description running, parked, finished or cancelled */
+                                status: string;
+                                /** @description The run's own status: pending, active, waiting, paused, completed or failed */
+                                run_status: string;
+                                /** @description Why a parked run waits or how a finished run ended */
+                                reason?: string | null;
+                                /** @description Steps recorded so far */
+                                steps: number;
+                                /** @description AI credits the run used so far */
+                                credits_used: number;
+                                /** @description The operation or tool the run called last */
+                                last_operation_key?: string | null;
+                                /**
+                                 * Format: date-time
+                                 * @description When the run first thought
+                                 */
+                                started_at?: string | null;
+                                /**
+                                 * Format: date-time
+                                 * @description When the run ended
+                                 */
+                                completed_at?: string | null;
+                                /** @description What audit entries for this run record as the delegate */
+                                delegate: string;
+                                /** @description True on a tombstone (the row was deleted or recycled); other fields are absent. */
+                                deleted?: boolean | null;
+                            }[];
+                            /** @description Pass as cursor for the next page; null on the last page. */
+                            next_cursor?: string | null;
+                        };
+                    };
+                };
+            };
+            202: components["responses"]["Proposal"];
+            /** @description Refused: credits_exhausted. */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: not_permitted, not_available, authority_off, data_class_blocked. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: not_found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: idempotency_conflict, stale_state. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: operation_retired. */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: invalid_input, domain_rule. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+            /** @description Refused: rate_limited. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationError"];
+                };
+            };
+        };
+    };
+    "ops.ai.jobs.list": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Replays the first result when the same call is retried. Send one per user intent on writes. */
+                "Idempotency-Key"?: string;
+                /** @description Send `true` to run every check without changing anything. The answer is `{"dry_run": {"outcome": "would_run" | "would_propose", "input": {...}}}`. */
+                "Axivoy-Dry-Run"?: "true" | "false";
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                /** @example {} */
+                "application/json": {
+                    /**
+                     * @description Only jobs in this status
+                     * @enum {string|null}
+                     */
+                    status?: "pending" | "queued" | "running" | "succeeded" | "failed" | "cancelled" | null;
+                    /** @description Only jobs of this type, for example rate_confirmation_extraction */
+                    job_type?: string | null;
+                    /** @description Cursor from the previous page's next_cursor. */
+                    cursor?: string | null;
+                    /** @description Rows per page (default 25). */
+                    limit?: number | null;
+                    /**
+                     * Format: date-time
+                     * @description Only rows changed at or after this instant, oldest change first, with deleted rows as tombstones.
+                     */
+                    updated_since?: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description The operation ran. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "result": {
+                     *         "items": [
+                     *           {
+                     *             "id": 1,
+                     *             "job_type": "stub",
+                     *             "status": "queued",
+                     *             "cancellable": true,
+                     *             "requested_by_user_id": 2,
+                     *             "requested_by_name": "Melisa Will",
+                     *             "attempt_count": 0,
+                     *             "max_attempts": 3,
+                     *             "correlation_id": "3275b72a-1934-4869-af78-d05aeabf6855",
+                     *             "created_at": "2026-10-20T08:18:19Z",
+                     *             "cancelled_at": null,
+                     *             "deleted": null
+                     *           }
+                     *         ],
+                     *         "next_cursor": null
+                     *       }
+                     *     }
+                     */
+                    "application/json": {
+                        result: {
+                            /** @description One page of rows. */
+                            items: {
+                                /** @description The row's id. */
+                                id: number;
+                                /** @description What the job does */
+                                job_type: string;
+                                /** @description Lifecycle status */
+                                status: string;
+                                /** @description True while ai.jobs.cancel can still stop it */
+                                cancellable: boolean;
+                                /** @description Who asked for it; null for a system job */
+                                requested_by_user_id?: number | null;
+                                /** @description Their name */
+                                requested_by_name?: string | null;
+                                /** @description Attempts so far */
+                                attempt_count: number;
+                                /** @description Attempts allowed */
+                                max_attempts: number;
+                                /** @description Correlation id shared with the audit log */
+                                correlation_id?: string | null;
+                                /**
+                                 * Format: date-time
+                                 * @description When it was queued
+                                 */
+                                created_at: string;
+                                /**
+                                 * Format: date-time
+                                 * @description When it was cancelled
+                                 */
+                                cancelled_at?: string | null;
                                 /** @description True on a tombstone (the row was deleted or recycled); other fields are absent. */
                                 deleted?: boolean | null;
                             }[];
@@ -144659,6 +145505,532 @@ export interface operations {
             };
         };
     };
+    "events.agent.improvement.accepted": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description `t=<unix seconds>,v1=<hex>`: HMAC-SHA256 of `{t}.{raw body}` with the endpoint secret. For 24 hours after a secret rotation a second `v1=` signed with the old secret follows. Compare in constant time and reject a `t` older than 300 seconds. */
+                "Axivoy-Signature": string;
+                /** @description Delivery id, the same on every retry of this delivery. */
+                "Axivoy-Webhook-Id": string;
+                /** @description The event `id`; dedupe on it. */
+                "Axivoy-Event-Id": string;
+                /** @description The event key, for example `load.created`. */
+                "Axivoy-Event-Type": string;
+                /** @description `true` on test sends from Settings, which also carry `"test": true` in the body. */
+                "Axivoy-Test"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "id": "0192f3a4-5b6c-7d8e-9f01-23456789abcd",
+                 *       "type": "agent.improvement.accepted",
+                 *       "version": 1,
+                 *       "occurred_at": "2026-10-01T15:04:05Z",
+                 *       "effective_at": "2026-10-01T15:04:05Z",
+                 *       "tenant": 1,
+                 *       "subject": {
+                 *         "type": "agent_improvement",
+                 *         "id": 1
+                 *       },
+                 *       "sequence": 2,
+                 *       "facts": {
+                 *         "agent_key": "yard_helper",
+                 *         "trial_share": 20,
+                 *         "accepted_by_user_id": 1
+                 *       },
+                 *       "causation": {
+                 *         "invocation_id": null,
+                 *         "event_id": null,
+                 *         "subscription_id": null
+                 *       },
+                 *       "chain_depth": 0,
+                 *       "fetch": {
+                 *         "operation": "agents.improvements.get",
+                 *         "input": {
+                 *           "improvement_id": 1
+                 *         }
+                 *       }
+                 *     }
+                 */
+                "application/json": {
+                    /** @description Event id; the same on every delivery of this event. */
+                    id: string;
+                    /** @constant */
+                    type: "agent.improvement.accepted";
+                    /** @constant */
+                    version: 1;
+                    /** Format: date-time */
+                    occurred_at: string;
+                    /**
+                     * Format: date-time
+                     * @description When it counts operationally; differs from `occurred_at` for back-dated facts.
+                     */
+                    effective_at: string;
+                    /** @description Workspace id. */
+                    tenant: number;
+                    subject: {
+                        type: string;
+                        id: number | string;
+                    };
+                    /** @description Increases per subject; apply events for one subject in this order. */
+                    sequence: number;
+                    facts: {
+                        agent_key: string;
+                        trial_share: number;
+                        accepted_by_user_id: number;
+                    };
+                    causation: {
+                        invocation_id?: string | null;
+                        event_id?: string | null;
+                        subscription_id?: number | null;
+                    };
+                    chain_depth: number;
+                    fetch: {
+                        operation?: string;
+                        input?: Record<string, never>;
+                    } | null;
+                    /** @description Present and `true` only on test sends. */
+                    test?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Received. Any other answer, a redirect or no answer within 10 seconds fails the try. */
+            "2XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "events.agent.improvement.rejected": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description `t=<unix seconds>,v1=<hex>`: HMAC-SHA256 of `{t}.{raw body}` with the endpoint secret. For 24 hours after a secret rotation a second `v1=` signed with the old secret follows. Compare in constant time and reject a `t` older than 300 seconds. */
+                "Axivoy-Signature": string;
+                /** @description Delivery id, the same on every retry of this delivery. */
+                "Axivoy-Webhook-Id": string;
+                /** @description The event `id`; dedupe on it. */
+                "Axivoy-Event-Id": string;
+                /** @description The event key, for example `load.created`. */
+                "Axivoy-Event-Type": string;
+                /** @description `true` on test sends from Settings, which also carry `"test": true` in the body. */
+                "Axivoy-Test"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "id": "0192f3a4-5b6c-7d8e-9f01-23456789abcd",
+                 *       "type": "agent.improvement.rejected",
+                 *       "version": 1,
+                 *       "occurred_at": "2026-10-01T15:04:05Z",
+                 *       "effective_at": "2026-10-01T15:04:05Z",
+                 *       "tenant": 1,
+                 *       "subject": {
+                 *         "type": "agent_improvement",
+                 *         "id": 3
+                 *       },
+                 *       "sequence": 2,
+                 *       "facts": {
+                 *         "agent_key": "yard_helper",
+                 *         "rejected_by_user_id": 1
+                 *       },
+                 *       "causation": {
+                 *         "invocation_id": null,
+                 *         "event_id": null,
+                 *         "subscription_id": null
+                 *       },
+                 *       "chain_depth": 0,
+                 *       "fetch": {
+                 *         "operation": "agents.improvements.get",
+                 *         "input": {
+                 *           "improvement_id": 3
+                 *         }
+                 *       }
+                 *     }
+                 */
+                "application/json": {
+                    /** @description Event id; the same on every delivery of this event. */
+                    id: string;
+                    /** @constant */
+                    type: "agent.improvement.rejected";
+                    /** @constant */
+                    version: 1;
+                    /** Format: date-time */
+                    occurred_at: string;
+                    /**
+                     * Format: date-time
+                     * @description When it counts operationally; differs from `occurred_at` for back-dated facts.
+                     */
+                    effective_at: string;
+                    /** @description Workspace id. */
+                    tenant: number;
+                    subject: {
+                        type: string;
+                        id: number | string;
+                    };
+                    /** @description Increases per subject; apply events for one subject in this order. */
+                    sequence: number;
+                    facts: {
+                        agent_key: string;
+                        rejected_by_user_id: number;
+                    };
+                    causation: {
+                        invocation_id?: string | null;
+                        event_id?: string | null;
+                        subscription_id?: number | null;
+                    };
+                    chain_depth: number;
+                    fetch: {
+                        operation?: string;
+                        input?: Record<string, never>;
+                    } | null;
+                    /** @description Present and `true` only on test sends. */
+                    test?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Received. Any other answer, a redirect or no answer within 10 seconds fails the try. */
+            "2XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "events.agent.improvement.suggested": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description `t=<unix seconds>,v1=<hex>`: HMAC-SHA256 of `{t}.{raw body}` with the endpoint secret. For 24 hours after a secret rotation a second `v1=` signed with the old secret follows. Compare in constant time and reject a `t` older than 300 seconds. */
+                "Axivoy-Signature": string;
+                /** @description Delivery id, the same on every retry of this delivery. */
+                "Axivoy-Webhook-Id": string;
+                /** @description The event `id`; dedupe on it. */
+                "Axivoy-Event-Id": string;
+                /** @description The event key, for example `load.created`. */
+                "Axivoy-Event-Type": string;
+                /** @description `true` on test sends from Settings, which also carry `"test": true` in the body. */
+                "Axivoy-Test"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "id": "0192f3a4-5b6c-7d8e-9f01-23456789abcd",
+                 *       "type": "agent.improvement.suggested",
+                 *       "version": 1,
+                 *       "occurred_at": "2026-10-01T15:04:05Z",
+                 *       "effective_at": "2026-10-01T15:04:05Z",
+                 *       "tenant": 1,
+                 *       "subject": {
+                 *         "type": "agent_improvement",
+                 *         "id": 1
+                 *       },
+                 *       "sequence": 1,
+                 *       "facts": {
+                 *         "agent_key": "yard_helper",
+                 *         "base_version": 1,
+                 *         "replay_score_active": 0.7,
+                 *         "replay_score_suggested": 0.8,
+                 *         "credits_used": 0
+                 *       },
+                 *       "causation": {
+                 *         "invocation_id": null,
+                 *         "event_id": null,
+                 *         "subscription_id": null
+                 *       },
+                 *       "chain_depth": 0,
+                 *       "fetch": {
+                 *         "operation": "agents.improvements.get",
+                 *         "input": {
+                 *           "improvement_id": 1
+                 *         }
+                 *       }
+                 *     }
+                 */
+                "application/json": {
+                    /** @description Event id; the same on every delivery of this event. */
+                    id: string;
+                    /** @constant */
+                    type: "agent.improvement.suggested";
+                    /** @constant */
+                    version: 1;
+                    /** Format: date-time */
+                    occurred_at: string;
+                    /**
+                     * Format: date-time
+                     * @description When it counts operationally; differs from `occurred_at` for back-dated facts.
+                     */
+                    effective_at: string;
+                    /** @description Workspace id. */
+                    tenant: number;
+                    subject: {
+                        type: string;
+                        id: number | string;
+                    };
+                    /** @description Increases per subject; apply events for one subject in this order. */
+                    sequence: number;
+                    facts: {
+                        agent_key: string;
+                        base_version?: number | null;
+                        replay_score_active?: number | null;
+                        replay_score_suggested?: number | null;
+                        credits_used: number;
+                    };
+                    causation: {
+                        invocation_id?: string | null;
+                        event_id?: string | null;
+                        subscription_id?: number | null;
+                    };
+                    chain_depth: number;
+                    fetch: {
+                        operation?: string;
+                        input?: Record<string, never>;
+                    } | null;
+                    /** @description Present and `true` only on test sends. */
+                    test?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Received. Any other answer, a redirect or no answer within 10 seconds fails the try. */
+            "2XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "events.agent.version_trial.promoted": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description `t=<unix seconds>,v1=<hex>`: HMAC-SHA256 of `{t}.{raw body}` with the endpoint secret. For 24 hours after a secret rotation a second `v1=` signed with the old secret follows. Compare in constant time and reject a `t` older than 300 seconds. */
+                "Axivoy-Signature": string;
+                /** @description Delivery id, the same on every retry of this delivery. */
+                "Axivoy-Webhook-Id": string;
+                /** @description The event `id`; dedupe on it. */
+                "Axivoy-Event-Id": string;
+                /** @description The event key, for example `load.created`. */
+                "Axivoy-Event-Type": string;
+                /** @description `true` on test sends from Settings, which also carry `"test": true` in the body. */
+                "Axivoy-Test"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "id": "0192f3a4-5b6c-7d8e-9f01-23456789abcd",
+                 *       "type": "agent.version_trial.promoted",
+                 *       "version": 1,
+                 *       "occurred_at": "2026-10-01T15:04:05Z",
+                 *       "effective_at": "2026-10-01T15:04:05Z",
+                 *       "tenant": 1,
+                 *       "subject": {
+                 *         "type": "agent_version_trial",
+                 *         "id": 1
+                 *       },
+                 *       "sequence": 1,
+                 *       "facts": {
+                 *         "agent_key": "yard_helper",
+                 *         "trial_runs": 2,
+                 *         "active_runs": 0,
+                 *         "reason": "No signal worse than the active version over 2 runs."
+                 *       },
+                 *       "causation": {
+                 *         "invocation_id": null,
+                 *         "event_id": null,
+                 *         "subscription_id": null
+                 *       },
+                 *       "chain_depth": 0,
+                 *       "fetch": {
+                 *         "operation": "agents.improvements.get",
+                 *         "input": {
+                 *           "improvement_id": 1
+                 *         }
+                 *       }
+                 *     }
+                 */
+                "application/json": {
+                    /** @description Event id; the same on every delivery of this event. */
+                    id: string;
+                    /** @constant */
+                    type: "agent.version_trial.promoted";
+                    /** @constant */
+                    version: 1;
+                    /** Format: date-time */
+                    occurred_at: string;
+                    /**
+                     * Format: date-time
+                     * @description When it counts operationally; differs from `occurred_at` for back-dated facts.
+                     */
+                    effective_at: string;
+                    /** @description Workspace id. */
+                    tenant: number;
+                    subject: {
+                        type: string;
+                        id: number | string;
+                    };
+                    /** @description Increases per subject; apply events for one subject in this order. */
+                    sequence: number;
+                    facts: {
+                        agent_key: string;
+                        trial_runs: number;
+                        active_runs: number;
+                        reason: string;
+                    };
+                    causation: {
+                        invocation_id?: string | null;
+                        event_id?: string | null;
+                        subscription_id?: number | null;
+                    };
+                    chain_depth: number;
+                    fetch: {
+                        operation?: string;
+                        input?: Record<string, never>;
+                    } | null;
+                    /** @description Present and `true` only on test sends. */
+                    test?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Received. Any other answer, a redirect or no answer within 10 seconds fails the try. */
+            "2XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "events.agent.version_trial.rolled_back": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description `t=<unix seconds>,v1=<hex>`: HMAC-SHA256 of `{t}.{raw body}` with the endpoint secret. For 24 hours after a secret rotation a second `v1=` signed with the old secret follows. Compare in constant time and reject a `t` older than 300 seconds. */
+                "Axivoy-Signature": string;
+                /** @description Delivery id, the same on every retry of this delivery. */
+                "Axivoy-Webhook-Id": string;
+                /** @description The event `id`; dedupe on it. */
+                "Axivoy-Event-Id": string;
+                /** @description The event key, for example `load.created`. */
+                "Axivoy-Event-Type": string;
+                /** @description `true` on test sends from Settings, which also carry `"test": true` in the body. */
+                "Axivoy-Test"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "id": "0192f3a4-5b6c-7d8e-9f01-23456789abcd",
+                 *       "type": "agent.version_trial.rolled_back",
+                 *       "version": 1,
+                 *       "occurred_at": "2026-10-01T15:04:05Z",
+                 *       "effective_at": "2026-10-01T15:04:05Z",
+                 *       "tenant": 1,
+                 *       "subject": {
+                 *         "type": "agent_version_trial",
+                 *         "id": 2
+                 *       },
+                 *       "sequence": 1,
+                 *       "facts": {
+                 *         "agent_key": "yard_helper",
+                 *         "trial_runs": 2,
+                 *         "active_runs": 2,
+                 *         "reason": "Worse than the active version: refused 100.0% vs 0.0%."
+                 *       },
+                 *       "causation": {
+                 *         "invocation_id": null,
+                 *         "event_id": null,
+                 *         "subscription_id": null
+                 *       },
+                 *       "chain_depth": 0,
+                 *       "fetch": {
+                 *         "operation": "agents.improvements.get",
+                 *         "input": {
+                 *           "improvement_id": 2
+                 *         }
+                 *       }
+                 *     }
+                 */
+                "application/json": {
+                    /** @description Event id; the same on every delivery of this event. */
+                    id: string;
+                    /** @constant */
+                    type: "agent.version_trial.rolled_back";
+                    /** @constant */
+                    version: 1;
+                    /** Format: date-time */
+                    occurred_at: string;
+                    /**
+                     * Format: date-time
+                     * @description When it counts operationally; differs from `occurred_at` for back-dated facts.
+                     */
+                    effective_at: string;
+                    /** @description Workspace id. */
+                    tenant: number;
+                    subject: {
+                        type: string;
+                        id: number | string;
+                    };
+                    /** @description Increases per subject; apply events for one subject in this order. */
+                    sequence: number;
+                    facts: {
+                        agent_key: string;
+                        trial_runs: number;
+                        active_runs: number;
+                        reason: string;
+                    };
+                    causation: {
+                        invocation_id?: string | null;
+                        event_id?: string | null;
+                        subscription_id?: number | null;
+                    };
+                    chain_depth: number;
+                    fetch: {
+                        operation?: string;
+                        input?: Record<string, never>;
+                    } | null;
+                    /** @description Present and `true` only on test sends. */
+                    test?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Received. Any other answer, a redirect or no answer within 10 seconds fails the try. */
+            "2XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     "events.bank_connection.link_requested": {
         parameters: {
             query?: never;