codai-sdk 0.64.0 → 0.66.0

package/dist/index.d.ts

@@ -2549,7 +2549,7 @@ type paths$1 = {
     };
     /**
      * List pending prompts
-     * @description Your prompts, soonest `not_before` first (prompts without one lead), then newest. `status=due` returns open prompts whose `not_before` is empty or already passed; `all` returns every status.
+     * @description Your prompts, soonest `not_before` first (prompts without one lead), then newest. `status=due` returns open prompts whose `not_before` is empty or already passed; `all` returns every status. Optional filters, combined with AND, are `tag`, `priority_min`, `q` and `templates` (templates are hidden by default); `sort` + `order` change the order.
      */
     readonly get: operations$1['listPrompts'];
     readonly put?: never;
@@ -2592,6 +2592,49 @@ type paths$1 = {
     readonly patch: operations$1['updatePrompt'];
     readonly trace?: never;
   };
+  readonly '/v1/prompts/{id}/events': {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: never;
+      readonly path?: never;
+      readonly cookie?: never;
+    };
+    /**
+     * Prompt history
+     * @description What happened to the prompt, newest first (at most 200 events): created, edited (with the changed keys),
+     *     status changes, launches, recurrences, chain steps and verifications.
+     */
+    readonly get: operations$1['listPromptEvents'];
+    readonly put?: never;
+    readonly post?: never;
+    readonly delete?: never;
+    readonly options?: never;
+    readonly head?: never;
+    readonly patch?: never;
+    readonly trace?: never;
+  };
+  readonly '/v1/prompts/{id}/instantiate': {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: never;
+      readonly path?: never;
+      readonly cookie?: never;
+    };
+    readonly get?: never;
+    readonly put?: never;
+    /**
+     * Create a prompt from a template
+     * @description Creates a new `open` copy of the prompt (usually a template, `is_template: true`) with the same text, tags,
+     *     priority, recurrence, chain and launch preset; the copy is never a template and records the source in
+     *     `origin.template_id`. Works on any of your prompts.
+     */
+    readonly post: operations$1['instantiatePrompt'];
+    readonly delete?: never;
+    readonly options?: never;
+    readonly head?: never;
+    readonly patch?: never;
+    readonly trace?: never;
+  };
   readonly '/v1/prompts/{id}/launch': {
     readonly parameters: {
       readonly query?: never;
@@ -2657,6 +2700,53 @@ type paths$1 = {
     readonly patch?: never;
     readonly trace?: never;
   };
+  readonly '/v1/prompts/bulk': {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: never;
+      readonly path?: never;
+      readonly cookie?: never;
+    };
+    readonly get?: never;
+    readonly put?: never;
+    /**
+     * Apply one action to many prompts
+     * @description Applies `action` to up to 200 of your prompts: `done` / `dismiss` close them (stamping `done_at`),
+     *     `delete` removes them, `snooze` sets `not_before` and re-arms the due reminder, `tag` / `untag` add or
+     *     remove `tags`, `priority` sets `priority`. Ids that are not yours are ignored. `done` also advances each
+     *     prompt's `next_prompt_id` chain. Every change is published on the prompt stream and logged in the history.
+     */
+    readonly post: operations$1['bulkPrompts'];
+    readonly delete?: never;
+    readonly options?: never;
+    readonly head?: never;
+    readonly patch?: never;
+    readonly trace?: never;
+  };
+  readonly '/v1/prompts/export': {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: never;
+      readonly path?: never;
+      readonly cookie?: never;
+    };
+    /**
+     * Export prompts as CSV or Markdown
+     * @description Downloads your prompts with the same filters as `GET /v1/prompts` (but `status` defaults to `all`, up to
+     *     5 000 rows). `format=csv` is RFC 4180 CSV (CRLF line breaks) with the columns `title, status, priority, tags,
+     *     source, repo, created_at, not_before, prompt` (tags space-separated); `format=md` is one Markdown section per
+     *     prompt with its metadata and the prompt text in a code fence. Sent as an attachment
+     *     (`prompts-YYYY-MM-DD.csv` / `.md`).
+     */
+    readonly get: operations$1['exportPrompts'];
+    readonly put?: never;
+    readonly post?: never;
+    readonly delete?: never;
+    readonly options?: never;
+    readonly head?: never;
+    readonly patch?: never;
+    readonly trace?: never;
+  };
   readonly '/v1/prompts/stream': {
     readonly parameters: {
       readonly query?: never;
@@ -3725,6 +3815,8 @@ type paths$1 = {
      *     only knows the server id, opens the session. Set `e2e: true` when payloads are
      *     end-to-end encrypted client-side (`payload: { hide: base64 }`); the server never
      *     inspects payloads either way.
+     *     With `stub: true` the session is a title-only mirror (listed, but no events yet) until the executor
+     *     appends its first events; viewers ask for the transcript with a `hydrate` control.
      */
     readonly post: operations$1['createSession'];
     readonly delete?: never;
@@ -3795,6 +3887,7 @@ type paths$1 = {
      *     (`payload: { control: {...}, applied: false }`, `client_event_id: control:<id>`) and
      *     pushed to subscribers as a `control` frame, then answered `202`. This endpoint has
      *     no device target — use `POST …/dispatch` to aim a `send` at one device and wake it.
+     *     `send`, `hydrate`, `answer`, `approve` and `deny` are accepted only from the session owner.
      */
     readonly post: operations$1['submitSessionControl'];
     readonly delete?: never;
@@ -12952,6 +13045,10 @@ type components$1 = {
       readonly head_sha: string | null;
       /** Format: uuid */
       readonly id: string;
+      /** @description Template prompts are hidden from the default list and never notified or auto-run. */
+      readonly is_template: boolean;
+      /** @description Launch preset, or `null`. */
+      readonly launch: components$1['schemas']['PromptLaunchConfig'] | null;
       /** Format: date-time */
       readonly launched_at: string | null;
       /** @description Session id or key the prompt was sent in. */
@@ -12960,6 +13057,11 @@ type components$1 = {
       readonly match_score: number | null;
       /** @description Turn id of that chat turn. */
       readonly match_turn_id: string | null;
+      /**
+       * Format: uuid
+       * @description Prompt opened when this one becomes `done`.
+       */
+      readonly next_prompt_id: string | null;
       /**
        * Format: date-time
        * @description The prompt is due from this moment on.
@@ -12973,7 +13075,11 @@ type components$1 = {
       readonly origin: {
         readonly [key: string]: unknown;
       };
+      /** @description 0 none, 1 low, 2 normal, 3 high. */
+      readonly priority: number;
       readonly prompt: string;
+      /** @description Repeat rule, or `null`. */
+      readonly recurrence: components$1['schemas']['PromptRecurrence'] | null;
       readonly repo: string | null;
       /** @description Last verification report, or `null`. */
       readonly report: components$1['schemas']['PromptReport'] | null;
@@ -12991,6 +13097,8 @@ type components$1 = {
       readonly sent_at: string | null;
       readonly source: components$1['schemas']['PromptSource'];
       readonly status: components$1['schemas']['PromptStatus'];
+      /** @description Lowercased, deduplicated tags (max 20). */
+      readonly tags: readonly string[];
       /** Format: uuid */
       readonly target_device_id: string | null;
       /** @description Defaults to the first line of the prompt (max 120 chars). */
@@ -13004,6 +13112,17 @@ type components$1 = {
        */
       readonly verified_at: string | null;
     };
+    readonly PromptBulkRequest: {
+      /** @enum {string} */
+      readonly action: 'done' | 'dismiss' | 'delete' | 'snooze' | 'tag' | 'untag' | 'priority';
+      readonly ids: readonly string[];
+      /** @description Required for `snooze`: ISO datetime with offset, or `YYYY-MM-DD` (07:00 UTC). */
+      readonly not_before?: string;
+      /** @description Required for `priority`. */
+      readonly priority?: number;
+      /** @description Required (non-empty) for `tag` / `untag`. */
+      readonly tags?: readonly string[];
+    };
     readonly PromptCreate: {
       /**
        * @description Launch automatically when due.
@@ -13012,15 +13131,30 @@ type components$1 = {
       readonly auto_run?: boolean;
       /** @description Stable key of the goal; a new prompt supersedes older open ones with the same key. */
       readonly goal_key?: string;
+      /** @description A template is hidden from the default list, never notified or auto-run; use `POST /v1/prompts/{id}/instantiate`. */
+      readonly is_template?: boolean;
+      /** @description Launch preset, or `null`. */
+      readonly launch?: components$1['schemas']['PromptLaunchConfig'] | null;
+      /**
+       * Format: uuid
+       * @description One of your prompts to open when this one becomes `done` (a template is instantiated instead). Cannot be the prompt itself.
+       */
+      readonly next_prompt_id?: string | null;
       /** @description ISO datetime with offset, or `YYYY-MM-DD` (07:00 UTC). `null` = due immediately. */
       readonly not_before?: string | null;
       /** @description Free-form capture metadata (session, transcript, host). */
       readonly origin?: {
         readonly [key: string]: unknown;
       };
+      /** @description 0 none, 1 low, 2 normal, 3 high. */
+      readonly priority?: number;
       readonly prompt: string;
+      /** @description Repeat rule, or `null` for none. */
+      readonly recurrence?: components$1['schemas']['PromptRecurrence'] | null;
       readonly repo?: string;
       readonly source?: components$1['schemas']['PromptSource'];
+      /** @description Tags; trimmed, lowercased and deduplicated. */
+      readonly tags?: readonly string[];
       /** Format: uuid */
       readonly target_device_id?: string | null;
       readonly title?: string;
@@ -13032,17 +13166,66 @@ type components$1 = {
       /** @description Older open prompts with the same `goal_key` now `superseded`. */
       readonly superseded: number;
     };
+    /** @description One history entry of a prompt. */
+    readonly PromptEvent: {
+      /** Format: date-time */
+      readonly created_at: string;
+      /** @description Kind-specific details (e.g. `from` / `to` for status, `keys` for edits). */
+      readonly detail: {
+        readonly [key: string]: unknown;
+      };
+      /** @enum {string} */
+      readonly kind: 'created' | 'edited' | 'status' | 'launched' | 'recurred' | 'chained' | 'verified';
+    };
+    /** @description Preset used when the prompt is launched. */
+    readonly PromptLaunchConfig: {
+      /** @description Agent to run it with. */
+      readonly agent?: string;
+      /** @description Working folder. */
+      readonly folder?: string;
+      /** @description Model to use. */
+      readonly model?: string;
+    };
     readonly PromptPatch: {
       readonly auto_run?: boolean;
+      /** @description A template is hidden from the default list, never notified or auto-run; use `POST /v1/prompts/{id}/instantiate`. */
+      readonly is_template?: boolean;
+      /** @description Launch preset, or `null`. */
+      readonly launch?: components$1['schemas']['PromptLaunchConfig'] | null;
+      /**
+       * Format: uuid
+       * @description One of your prompts to open when this one becomes `done` (a template is instantiated instead). Cannot be the prompt itself.
+       */
+      readonly next_prompt_id?: string | null;
       /** @description ISO datetime with offset, or `YYYY-MM-DD` (07:00 UTC). `null` = due immediately. */
       readonly not_before?: string | null;
+      /** @description 0 none, 1 low, 2 normal, 3 high. */
+      readonly priority?: number;
       readonly prompt?: string;
+      /** @description Repeat rule, or `null` for none. */
+      readonly recurrence?: components$1['schemas']['PromptRecurrence'] | null;
       readonly status?: components$1['schemas']['PromptStatus'];
+      /** @description Tags; trimmed, lowercased and deduplicated. */
+      readonly tags?: readonly string[];
       /** Format: uuid */
       readonly target_device_id?: string | null;
       readonly title?: string;
       readonly tracker?: string | null;
     };
+    /**
+     * @description `{ every: day | week | month, at?: HH:MM }` (UTC): once the prompt left `open`, its next occurrence is created
+     *     as a new `open` prompt due at the next slot (months keep the day, clamped to the month end).
+     *     `{ on: session_end }`: the prompt is reopened when the session it ran in (or was captured from) ends a turn.
+     */
+    readonly PromptRecurrence: {
+      /** @description Time of day, HH:MM UTC. */
+      readonly at?: string;
+      /** @enum {string} */
+      readonly every: 'day' | 'week' | 'month';
+    } | {
+      /** @enum {string} */
+      readonly on: 'session_end';
+    };
     /** @description LLM verification report of a prompt. */
     readonly PromptReport: {
       /** Format: date-time */
@@ -13921,6 +14104,8 @@ type components$1 = {
        * @example desktop-2026-09-23-main
        */
       readonly session_key: string;
+      /** @description Title-only mirror without events yet; cleared by the first appended event batch. */
+      readonly stub: boolean;
       readonly title: string | null;
     };
     /** SessionControl */
@@ -13957,10 +14142,10 @@ type components$1 = {
       readonly seq: number | null;
     };
     /**
-     * @description Kind of control a non-executor can send to the executor.
+     * @description Kind of control a non-executor can send to the executor. `hydrate` asks the executor to upload the transcript of a stub session (session owner only, like `send`).
      * @enum {string}
      */
-    readonly SessionControlKind: 'send' | 'answer' | 'approve' | 'deny' | 'cancel' | 'steer' | 'inject' | 'pause' | 'resume';
+    readonly SessionControlKind: 'send' | 'answer' | 'approve' | 'deny' | 'cancel' | 'steer' | 'inject' | 'pause' | 'resume' | 'hydrate';
     readonly SessionControlRequest: {
       /** @description Id of the question being answered / approved / denied. */
       readonly ask_id?: string;
@@ -13985,6 +14170,11 @@ type components$1 = {
        * @example desktop-2026-09-23-main
        */
       readonly session_key?: string;
+      /**
+       * @description Create a title-only stub (no events yet); viewers request the transcript with a `hydrate` control.
+       * @default false
+       */
+      readonly stub?: boolean;
       readonly title?: string;
     };
     readonly SessionDetail: components$1['schemas']['Session'] & {
@@ -22518,8 +22708,20 @@ interface operations$1 {
       readonly query?: {
         /** @description Maximum rows (1–200). */
         readonly limit?: number;
+        /** @description Sort direction. Default `desc`, except `asc` for `sort=not_before` (empty dates last). */
+        readonly order?: 'asc' | 'desc';
+        /** @description Only prompts with `priority` at least this value (0–3). */
+        readonly priority_min?: number;
+        /** @description Case-insensitive text search in the title, the prompt text and `origin.session_title`. */
+        readonly q?: string;
+        /** @description Sort key. Without it: soonest `not_before` first (prompts without one lead), then newest. */
+        readonly sort?: 'created' | 'updated' | 'priority' | 'not_before';
         /** @description Filter: a prompt status, `active` (open, launched, sent or answered), `due` or `all`. */
         readonly status?: 'open' | 'due' | 'all' | 'launched' | 'done' | 'dismissed' | 'superseded' | 'active' | 'sent' | 'answered' | 'verified';
+        /** @description Tag filter, repeatable or a comma list; every tag must be present (AND). Matched lowercased. */
+        readonly tag?: readonly string[];
+        /** @description `exclude` (default) hides templates, `only` returns just templates. */
+        readonly templates?: 'only' | 'exclude';
       };
       readonly header?: {
         /** @description Client correlation id; echoed back as `x-codai-trace-id` and persisted on the usage row. */
@@ -22678,6 +22880,66 @@ interface operations$1 {
       readonly 404: components$1['responses']['NotFound'];
     };
   };
+  readonly listPromptEvents: {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: {
+        /** @description Client correlation id; echoed back as `x-codai-trace-id` and persisted on the usage row. */
+        readonly 'x-request-id'?: components$1['parameters']['RequestId'];
+      };
+      readonly path: {
+        /** @description Pending prompt id (uuid). A foreign or malformed id is 404. */
+        readonly id: string;
+      };
+      readonly cookie?: never;
+    };
+    readonly requestBody?: never;
+    readonly responses: {
+      /** @description The history events. */
+      readonly 200: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': {
+            readonly events: readonly components$1['schemas']['PromptEvent'][];
+          };
+        };
+      };
+      readonly 401: components$1['responses']['Unauthorized'];
+      readonly 402: components$1['responses']['PaymentRequired'];
+      readonly 404: components$1['responses']['NotFound'];
+    };
+  };
+  readonly instantiatePrompt: {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: {
+        /** @description Client correlation id; echoed back as `x-codai-trace-id` and persisted on the usage row. */
+        readonly 'x-request-id'?: components$1['parameters']['RequestId'];
+      };
+      readonly path: {
+        /** @description Pending prompt id (uuid). A foreign or malformed id is 404. */
+        readonly id: string;
+      };
+      readonly cookie?: never;
+    };
+    readonly requestBody?: never;
+    readonly responses: {
+      /** @description The new prompt. */
+      readonly 201: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['Prompt'];
+        };
+      };
+      readonly 401: components$1['responses']['Unauthorized'];
+      readonly 402: components$1['responses']['PaymentRequired'];
+      readonly 404: components$1['responses']['NotFound'];
+    };
+  };
   readonly launchPrompt: {
     readonly parameters: {
       readonly query?: never;
@@ -22834,6 +23096,84 @@ interface operations$1 {
       };
     };
   };
+  readonly bulkPrompts: {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: {
+        /** @description Client correlation id; echoed back as `x-codai-trace-id` and persisted on the usage row. */
+        readonly 'x-request-id'?: components$1['parameters']['RequestId'];
+      };
+      readonly path?: never;
+      readonly cookie?: never;
+    };
+    readonly requestBody: {
+      readonly content: {
+        readonly 'application/json': components$1['schemas']['PromptBulkRequest'];
+      };
+    };
+    readonly responses: {
+      /** @description How many prompts were changed (or deleted). */
+      readonly 200: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': {
+            readonly updated: number;
+          };
+        };
+      };
+      readonly 400: components$1['responses']['BadRequest'];
+      readonly 401: components$1['responses']['Unauthorized'];
+      readonly 402: components$1['responses']['PaymentRequired'];
+    };
+  };
+  readonly exportPrompts: {
+    readonly parameters: {
+      readonly query?: {
+        /** @description Output format. */
+        readonly format?: 'csv' | 'md';
+        /** @description Maximum rows (1–5000). */
+        readonly limit?: number;
+        /** @description Sort direction. Default `desc`, except `asc` for `sort=not_before` (empty dates last). */
+        readonly order?: 'asc' | 'desc';
+        /** @description Only prompts with `priority` at least this value (0–3). */
+        readonly priority_min?: number;
+        /** @description Case-insensitive text search in the title, the prompt text and `origin.session_title`. */
+        readonly q?: string;
+        /** @description Sort key. Without it: soonest `not_before` first (prompts without one lead), then newest. */
+        readonly sort?: 'created' | 'updated' | 'priority' | 'not_before';
+        /** @description Same values as for the list; default `all`. */
+        readonly status?: 'open' | 'due' | 'all' | 'launched' | 'done' | 'dismissed' | 'superseded' | 'active' | 'sent' | 'answered' | 'verified';
+        /** @description Tag filter, repeatable or a comma list; every tag must be present (AND). Matched lowercased. */
+        readonly tag?: readonly string[];
+        /** @description `exclude` (default) hides templates, `only` returns just templates. */
+        readonly templates?: 'only' | 'exclude';
+      };
+      readonly header?: {
+        /** @description Client correlation id; echoed back as `x-codai-trace-id` and persisted on the usage row. */
+        readonly 'x-request-id'?: components$1['parameters']['RequestId'];
+      };
+      readonly path?: never;
+      readonly cookie?: never;
+    };
+    readonly requestBody?: never;
+    readonly responses: {
+      /** @description The export file. */
+      readonly 200: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'text/csv': string;
+          readonly 'text/markdown': string;
+        };
+      };
+      readonly 400: components$1['responses']['BadRequest'];
+      readonly 401: components$1['responses']['Unauthorized'];
+      readonly 402: components$1['responses']['PaymentRequired'];
+    };
+  };
   readonly streamPrompts: {
     readonly parameters: {
       readonly query?: never;
@@ -36857,11 +37197,21 @@ export declare class Notifications {
 }
 //#endregion
 //#region src/resources/prompts.d.ts
+/** PR-07 recurrence: repeat every day/week/month (at HH:MM UTC), or reopen when the run session ends. */
+export type PromptRecurrence = Mutable<Schema<'PromptRecurrence'>>;
+/** PR-07 launch preset applied when the prompt is started. */
+export type PromptLaunchConfig = Mutable<Schema<'PromptLaunchConfig'>>;
 export type Prompt = Schema<'Prompt'>;
+/** PR-04 / PR-07 organise fields (present on every prompt row). */
+export type PromptOrganizeFields = Pick<Prompt, 'tags' | 'priority' | 'recurrence' | 'next_prompt_id' | 'launch' | 'is_template'>;
 export type PromptStatus = Schema<'PromptStatus'>;
 export type PromptSource = Schema<'PromptSource'>;
 export type PromptList = Reply<'listPrompts'>;
-export type PromptListQuery = Mutable<QueryOf<'listPrompts'>>;
+/** PR-04 list / export filters; `tag` also accepts one string (a single tag or a comma list). AND semantics. */
+export type PromptListFilters = Omit<Mutable<QueryOf<'listPrompts'>>, 'tag' | 'status' | 'limit'> & {
+  tag?: string | string[];
+};
+export type PromptListQuery = Omit<Mutable<QueryOf<'listPrompts'>>, 'tag'> & PromptListFilters;
 export type PromptCreateRequest = Mutable<Body<'createPrompt'>>;
 export type PromptCreated = Reply<'createPrompt'>;
 export type PromptPatch = Mutable<Body<'updatePrompt'>>;
@@ -36874,6 +37224,13 @@ export type PromptVerifyRequest = Mutable<Body<'verifyPrompt'>>;
 export type PromptVerified = Reply<'verifyPrompt'>;
 export type PromptVerifyManyRequest = Mutable<Body<'verifyPrompts'>>;
 export type PromptVerifyManyResult = Reply<'verifyPrompts'>;
+/** PR-05 `POST /v1/prompts/bulk`. */
+export type PromptBulkRequest = Mutable<Body<'bulkPrompts'>>;
+export type PromptBulkResult = Reply<'bulkPrompts'>;
+export type PromptHistoryEvent = Schema<'PromptEvent'>;
+export type PromptEventKind = PromptHistoryEvent['kind'];
+export type PromptEventList = Reply<'listPromptEvents'>;
+export type PromptExportQuery = Omit<Mutable<QueryOf<'exportPrompts'>>, 'tag'> & PromptListFilters;
 /** One `event: prompt` frame of `GET /v1/prompts/stream`. */
 export interface PromptStreamEvent {
   op: 'upsert' | 'delete';
@@ -36889,7 +37246,10 @@ type CallOpts$10 = {
 export declare class Prompts {
   private readonly http;
   constructor(http: HttpClient);
-  /** `GET /v1/prompts?status=&limit=` — default `open`; `due` = open and `not_before` empty or passed. */
+  /**
+   * `GET /v1/prompts?status=&limit=&tag=&priority_min=&q=&templates=&sort=&order=` — default `open`, templates
+   * excluded; `due` = open and `not_before` empty or passed; several tags = AND.
+   */
   list(query?: PromptListQuery, opts?: CallOpts$10): Promise<PromptList>;
   /** `POST /v1/prompts` — idempotent on the text (`created: false` for a duplicate); `goal_key` supersedes older open ones. */
   create(body: PromptCreateRequest, opts?: CallOpts$10): Promise<PromptCreated>;
@@ -36910,6 +37270,14 @@ export declare class Prompts {
   verify(id: string, body?: PromptVerifyRequest, opts?: CallOpts$10): Promise<PromptVerified>;
   /** `POST /v1/prompts/verify` — transcript-only verification of up to 20 prompts, sequentially. */
   verifyMany(body: PromptVerifyManyRequest, opts?: CallOpts$10): Promise<PromptVerifyManyResult>;
+  /** `POST /v1/prompts/bulk` — one action over up to 200 of your prompts → `{ updated }`. */
+  bulk(body: PromptBulkRequest, opts?: CallOpts$10): Promise<PromptBulkResult>;
+  /** `GET /v1/prompts/{id}/events` — history, newest first (max 200). */
+  events(id: string, opts?: CallOpts$10): Promise<PromptEventList>;
+  /** `POST /v1/prompts/{id}/instantiate` — open copy of a template (201). */
+  instantiate(id: string, opts?: CallOpts$10): Promise<Prompt>;
+  /** `GET /v1/prompts/export?format=csv|md` — list filters apply (status defaults to `all`); returns the document text. */
+  exportPrompts(query?: PromptExportQuery, opts?: CallOpts$10): Promise<string>;
   /** `GET /v1/prompts/stream` — live `prompt` events (keepalive comments are skipped). Closed by the server after 6 h. */
   stream(opts?: CallOpts$10): AsyncGenerator<PromptStreamEvent, void, undefined>;
 }
@@ -37193,9 +37561,12 @@ export declare class Sandboxes {
   readonly files: SandboxFiles;
   constructor(http: HttpClient);
   /**
-   * `POST /v1/sandboxes` — start a sandbox (`ttl_seconds` 60–86400, default 3600; `egress` none by default).
-   * `backend: 'v2'` (closed canary) starts a long-lived pod with memory snapshots and accepts `template`
-   * `codai-base` | `brivio-acte` | `desktop`; its reply may carry `restored`.
+   * `POST /v1/sandboxes` — start a sandbox (`ttl_seconds` default 3600, max 86400 on v1 / 604800 on v2;
+   * `egress` none by default, or a `pypi`/`npm` preset / allowlist on both backends).
+   * `backend` defaults to `'v2'`: a long-lived pod with memory snapshots, Node 24 + npm, `template`
+   * `codai-base` | `brivio-acte` | `desktop`; its reply may carry `restored`. When `backend` is omitted and v2
+   * is unavailable for the key the gateway falls back to `'v1'` (check `backend` on the reply).
+   * Errors: 429 `sandbox_concurrency_limit` (3 per key, 5 running v2 per user), 503 `sandbox_capacity` (retry).
    */
   create(input?: SandboxCreateInput, opts?: CallOpts$6): Promise<Sandbox>;
   /** `GET /v1/sandboxes` — your sandboxes, newest first, optionally one `status`. */
@@ -37216,7 +37587,7 @@ export declare class Sandboxes {
   execStream(id: string, input: SandboxExecInput, opts?: IdemOpts): AsyncGenerator<SandboxExecEvent, void, undefined>;
   /** `GET /v1/sandboxes/{id}/artifacts` — collect `/workspace/out` (scanned, signed 1 h links). */
   artifacts(id: string, opts?: CallOpts$6): Promise<SandboxArtifactList>;
-  /** `POST /v1/sandboxes/{id}/snapshot` — store a compressed copy of the workspace. */
+  /** `POST /v1/sandboxes/{id}/snapshot` (v1 only; v2 answers 409 `not_supported_on_v2`) — store a compressed copy of the workspace. */
   snapshot(id: string, input?: SandboxSnapshotInput, opts?: CallOpts$6): Promise<SandboxSnapshot>;
   /**
    * `POST /v1/sandboxes/{id}/run_code` (v2) — run Python in the persistent kernel; globals survive between
@@ -37225,7 +37596,10 @@ export declare class Sandboxes {
   runCode(id: string, input: SandboxRunCodeInput, opts?: CallOpts$6): Promise<SandboxRunCodeResult>;
   /** `POST /v1/sandboxes/{id}/kernel/reset` (v2) — restart the kernel; globals are lost, files kept. */
   resetKernel(id: string, opts?: CallOpts$6): Promise<void>;
-  /** `POST /v1/sandboxes/{id}/pause` (v2) — memory snapshot, then stop the pod (status `paused`). */
+  /**
+   * `POST /v1/sandboxes/{id}/pause` (v2) — memory snapshot, then stop the pod (status `paused`).
+   * At most 10 paused v2 sandboxes per user (429 `sandbox_paused_limit`).
+   */
   pause(id: string, opts?: CallOpts$6): Promise<Sandbox>;
   /** `POST /v1/sandboxes/{id}/resume` (v2) — restore a paused sandbox; `restored: false` = cold start. */
   resume(id: string, opts?: CallOpts$6): Promise<SandboxResumed>;
@@ -38003,7 +38377,7 @@ export declare class Codai {
   readonly orgs: Orgs;
   readonly projects: Projects;
   readonly environments: Environments;
-  /** Agent sandboxes (beta) — isolated gVisor workspaces: `sandboxes.create/exec/execStream/files/artifacts/run`. */
+  /** Agent sandboxes (backend v2 by default) — isolated gVisor workspaces: `sandboxes.create/exec/execStream/files/artifacts/run`. */
   readonly sandboxes: Sandboxes;
   /** EXPERIMENTAL (HIDE, unaudited): verify signed agent outputs. Provenance only. */
   readonly verify: Verify;