@leaflow/sdk 0.0.0-dev.358.gbb34078 → 0.0.0-dev.361.gefdc428

package/dist/assistant/v1/generated/models.d.ts

@@ -2,102 +2,26 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Leaflow Assistant API
- * The AI assistant inside the console: conversations, messages, tool calls and their approval, attachments, and connecting the assistant to instant messaging platforms such as WeChat, Feishu and Telegram.
+ * Conversations with agents that operate the Leaflow platform, plus their folders, tasks, files and
+ * chat-app channels.
  *
- * ## A conversation
+ * A conversation is a thread. A person talks to the main thread; the agent in it can start subagents,
+ * which are threads too and run on their own: stopping the main thread does not stop them, and each
+ * subagent tells its parent when it ends. A thread runs in turns; each turn records the model and
+ * reasoning effort it used and its token usage.
  *
- * The path one conversation takes, end to end. It names the operations that path needs, not all of them — the full list is below, and it also covers folders, attachments, memories, skills and the instant messaging side.
+ * Models come from the Canopy catalogue. A new thread uses the model it names, the caller's default
+ * from /api/v1/settings, or the first catalogue model that can run an agent. Reasoning models take one
+ * of three efforts — low, medium or high — which are sent to the model unchanged.
  *
- * 1. `POST /api/v1/threads` creates one;
- * 2. `POST /api/v1/threads/{thread}/messages` sends a message and returns a `turnId` at once; the assistant runs in the background;
- * 3. `GET /api/v1/threads/{thread}` returns the conversation document to render, whose `stream` is where live output arrives;
- * 4. When the assistant needs the user, the document's `wait` says which kind: approving a batch of tool calls (`POST /api/v1/threads/{thread}/approvals/{batch}`), or answering a few questions (`POST /api/v1/threads/{thread}/questions/{item}`). It continues on its own once that is handled.
+ * Read a thread's state with get-thread and its transcript with list-thread-items. Follow both live
+ * over the WebSocket described under /api/v1/realtime/tickets. Slash commands such as /status and
+ * /compact are listed by list-commands and work the same in the console and in chat apps.
  *
- * Sending a file takes two steps: `POST /api/v1/attachments` for an id, then put that id in `attachmentIds` when sending the message. Images, text and arbitrary binaries all go through the same two steps; what differs is how the assistant reads them afterwards, which the upload response's `kind` says.
- *
- * ## Models
- *
- * Canopy owns the model catalogue and capabilities. Model ids in this API, conversation preferences and historical entries are Canopy model ids, with no separate assistant model registration. GET /api/v1/models returns the allowed, usable choices and allowModelSelection. Hide the selector when selection is disabled; the service enforces the same rule.
- *
- * preferredModelId is the user's choice. Null follows the platform default, including later changes. Disabled selection preserves but ignores preferences for new turns. A model removed from the allowlist, retired in Canopy or otherwise unusable falls back to the default without clearing the preference.
- *
- * Users can switch an existing conversation through PATCH /api/v1/threads/{thread} with preferredModelId. This preserves the transcript, starts no turn and makes no inference request. Null returns to following the default. Changes apply from the next turn; a running or waiting turn and messages queued into it retain their captured choices and fallback policy.
- *
- * If the chosen model cannot serve a request, the service may safely fall back to the default without confirmation or an additional switching message. If the default also fails, the turn fails normally; no third model is selected for ordinary answers. Fallback preserves executed tool results and never splices answers from different models. Invalid input, cancellation and a declined tool call do not trigger model fallback. Each entry's model records its actual Canopy author, not the saved preference.
- *
- * Users cannot choose a compaction model. Normal compaction reuses the effective model and reasoning settings for context-cache reuse. Only if that model cannot handle the compaction request or produce a summary fitting the target window may the service automatically use another allowed Canopy model with suitable capabilities. This does not change the preference or ordinary answer model, and is permitted even when user model selection is disabled.
- *
- * After compaction, the full next request, including instructions, tools and retained messages, must fit the target's usable prompt budget with room left for an answer, respecting its output limit. If still too large, further compaction attempts are bounded; exhaustion fails with CANNOT_FOLD instead of sending an oversized request or silently discarding history or images. The same checks apply when switching models or falling back. Each compaction entry records its actual author.
- *
- * An empty allowlist or unavailable default does not prevent reading conversations or saving permitted preference changes. A failed Canopy catalogue read is not evidence that a model was removed: use a valid cached snapshot or return MODEL_CATALOG_UNAVAILABLE, without deleting references or inventing capabilities. Catalogue presence is configuration information, not a live provider health check.
- *
- * ## Live output
- *
- * ```
- * GET /api/v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
- * ```
- *
- * This is a Server-Sent Events stream, which is why it is not in the operation list below and why generated clients have no method for it. Open it with `EventSource`, or any SSE client. It is how live output arrives; polling the document on a timer is not the intended way to follow a conversation.
- *
- * - `path` and `ticket` both come from the conversation document's `stream`. `path` is relative, resolved against the address the document was fetched from;
- * - `cursor` is where to start, from the document's `cursor`. Omit it to start at the beginning of what is still available;
- * - every event is one incremental edit to that same document, so the same rendering logic applies;
- * - the connection has a lifetime and closes cleanly when it ends. With `EventSource` the browser reconnects with `Last-Event-ID` and resumes by itself, so nothing needs handling;
- * - three terminal events: `done` this turn finished (carrying its final status), `paused` the assistant is waiting on the user (fetch the document again and read `wait`), `stalled` execution was interrupted and will not resume — do not reconnect.
- * OpenAPI spec version: 1.0.0
- */
-export type ModelResourceInputModalitiesItem = (typeof ModelResourceInputModalitiesItem)[keyof typeof ModelResourceInputModalitiesItem];
-export declare const ModelResourceInputModalitiesItem: {
-    readonly text: "text";
-    readonly image: "image";
-};
-/**
- * A read-only view of a Canopy model. No model definition is created or edited through Assistant.
+ * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
+ * parts, then complete the upload and send its attachment id in a message.
+ * OpenAPI spec version: 2.0.0
  */
-export interface ModelResource {
-    /**
-     * Canopy model id, used unchanged in settings, conversation preferences and inference. There is no second assistant model id.
-     * @minLength 1
-     * @maxLength 128
-     */
-    id: string;
-    /** The display_name maintained in Canopy */
-    displayName: string;
-    /**
-     * The context_length maintained in Canopy. The assistant reserves room for instructions, tools and an answer rather than using this entire window for history.
-     * @minimum 1
-     */
-    contextWindow: number;
-    /**
-     * The max_output_tokens maintained in Canopy. Answer and summary budgets must respect this limit and the remaining context capacity.
-     * @minimum 1
-     */
-    maxOutputTokens: number;
-    /** Canopy supports_tools. Must be true before the model can be allowed for Assistant. */
-    supportsTools: boolean;
-    /** Canopy supports_reasoning. False requires reasoning_effort to be omitted. */
-    supportsReasoning: boolean;
-    /** Levels reported by Canopy reasoning_tiers. An empty list requires reasoning_effort to be omitted. List order does not imply reasoning strength. */
-    reasoningTiers: string[];
-    /**
-     * Contains text, and also image when Canopy reports supports_vision. Other attachments remain accessible through file tools.
-     * @minItems 1
-     */
-    inputModalities: ModelResourceInputModalitiesItem[];
-}
-export interface ModelListResponseBody {
-    /** Whether users can set a non-null model preference. When false, hide the selector and use the platform default for new turns. */
-    allowModelSelection: boolean;
-    /**
-     * The default Canopy model id, present in models when non-null. Null means no usable default is known from the current allowlist and capability snapshot; it does not report live provider health.
-     * @minLength 1
-     * @maxLength 128
-     * @nullable
-     */
-    defaultModelId: string | null;
-    /** Allowed, usable Canopy choices, or only the default when selection is disabled. Empty is an empty array, never null. */
-    models: ModelResource[];
-}
 /**
  * What a given `code` carries alongside the message. The keys depend on the code,
  * and a client that does not recognise one ignores it.
@@ -116,633 +40,708 @@ export interface Error {
     status: number;
 }
 /**
- * How the assistant will see this file.
- *
- * - `image` — read directly, and only by models that accept image input
- * - `text` — placed inline in the message when small enough, otherwise read on demand
- * - `binary` — never read directly; the assistant downloads it onto a cloud instance to work with it
+ * Tokens reported by Canopy. Cache hit rate is cachedInputTokens / inputTokens.
  */
-export type UploadedResourceKind = (typeof UploadedResourceKind)[keyof typeof UploadedResourceKind];
-export declare const UploadedResourceKind: {
-    readonly image: "image";
-    readonly text: "text";
-    readonly binary: "binary";
-};
-export interface UploadedResource {
-    /** Size of what was stored. For an image that has been resized, this is the resized size, not what was uploaded. */
-    byteSize: number;
+export interface Usage {
     /**
-     * When this upload gets cleared if no message ever references it. Sending a message with this id makes it permanent and this stops applying — a file that belongs to a conversation is kept as long as the conversation is.
-     *
-     * It is here so the editor can say so before it happens. An attachment chip that quietly stops working a week later reads as a bug, and the person who hits it has no way to tell that what they are seeing is a draft being collected.
+     * Prompt tokens, including cached ones.
+     * @minimum 0
      */
-    draftExpiresAt: string;
-    filename: string;
+    inputTokens: number;
     /**
-     * Null unless kind is image.
-     * @nullable
+     * Prompt tokens read from the provider's cache.
+     * @minimum 0
      */
-    height: number | null;
-    id: string;
+    cachedInputTokens: number;
     /**
-     * How the assistant will see this file.
-     *
-     * - `image` — read directly, and only by models that accept image input
-     * - `text` — placed inline in the message when small enough, otherwise read on demand
-     * - `binary` — never read directly; the assistant downloads it onto a cloud instance to work with it
+     * Prompt tokens written to the provider's cache. Zero for providers that do not report it.
+     * @minimum 0
      */
-    kind: UploadedResourceKind;
+    cacheWriteTokens: number;
     /**
-     * Null unless kind is image.
-     * @nullable
+     * Output tokens, including reasoning.
+     * @minimum 0
      */
-    width: number | null;
+    outputTokens: number;
+    /**
+     * Output tokens spent on reasoning.
+     * @minimum 0
+     */
+    reasoningTokens: number;
+    /** @minimum 0 */
+    totalTokens: number;
+    /**
+     * Model requests made.
+     * @minimum 0
+     */
+    requests: number;
+    /** False while a request has not reported its usage yet, so the numbers may still grow. */
+    complete: boolean;
 }
-export type BindingResourceConnState = (typeof BindingResourceConnState)[keyof typeof BindingResourceConnState];
-export declare const BindingResourceConnState: {
-    readonly logged_out: "logged_out";
-    readonly qr_pending: "qr_pending";
-    readonly online: "online";
-    readonly expired: "expired";
+/**
+ * How much the model reasons before answering. Sent to the model unchanged.
+ */
+export type ReasoningEffort = (typeof ReasoningEffort)[keyof typeof ReasoningEffort];
+export declare const ReasoningEffort: {
+    readonly low: "low";
+    readonly medium: "medium";
+    readonly high: "high";
 };
-export type BindingResourceStatus = (typeof BindingResourceStatus)[keyof typeof BindingResourceStatus];
-export declare const BindingResourceStatus: {
-    readonly pending: "pending";
-    readonly active: "active";
-    readonly revoked: "revoked";
+/**
+ * `manual` asks a person before tools that change something, `guardian` lets an automatic reviewer decide, `yolo` runs them without asking.
+ */
+export type ApprovalMode = (typeof ApprovalMode)[keyof typeof ApprovalMode];
+export declare const ApprovalMode: {
+    readonly manual: "manual";
+    readonly guardian: "guardian";
+    readonly yolo: "yolo";
 };
-export interface BindingResource {
-    channelId: string;
-    connState: BindingResourceConnState;
-    createdAt: string;
-    id: string;
-    peerName: string;
-    platform: string;
-    status: BindingResourceStatus;
-    /** @nullable */
-    verifiedAt: string | null;
-}
-export interface LengthAwarePageBindingResource {
-    /** The entries on this page */
-    items: BindingResource[];
-    /** The page size, echoing what was requested */
-    limit: number;
-    /** How many were skipped, echoing what was requested */
-    offset: number;
-    /** How many match in total, not just on this page */
-    total: number;
-}
 /**
- * How far this channel is from working. Only `online` receives messages and can issue binding codes
+ * What the thread is doing. `waiting` is waiting for subagents or tasks it started; `awaiting_approval` and `awaiting_input` wait for a person.
  */
-export type ChannelResourceConnState = (typeof ChannelResourceConnState)[keyof typeof ChannelResourceConnState];
-export declare const ChannelResourceConnState: {
-    readonly logged_out: "logged_out";
-    readonly qr_pending: "qr_pending";
-    readonly online: "online";
-    readonly expired: "expired";
+export type ThreadStatus = (typeof ThreadStatus)[keyof typeof ThreadStatus];
+export declare const ThreadStatus: {
+    readonly idle: "idle";
+    readonly starting: "starting";
+    readonly running: "running";
+    readonly waiting: "waiting";
+    readonly awaiting_approval: "awaiting_approval";
+    readonly awaiting_input: "awaiting_input";
 };
 /**
- * The state of the long-lived connection right now. Always `stopped` for webhook platforms
+ * `declined` ended because a person declined a tool call; `cancelled` was stopped.
  */
-export type ChannelResourceRuntimeState = (typeof ChannelResourceRuntimeState)[keyof typeof ChannelResourceRuntimeState];
-export declare const ChannelResourceRuntimeState: {
-    readonly stopped: "stopped";
+export type TurnStatus = (typeof TurnStatus)[keyof typeof TurnStatus];
+export declare const TurnStatus: {
     readonly running: "running";
+    readonly completed: "completed";
+    readonly failed: "failed";
+    readonly declined: "declined";
+    readonly cancelled: "cancelled";
 };
-export type ChannelResourceSenderPolicy = (typeof ChannelResourceSenderPolicy)[keyof typeof ChannelResourceSenderPolicy];
-export declare const ChannelResourceSenderPolicy: {
-    readonly bound_only: "bound_only";
-    readonly open: "open";
+/**
+ * `main` for a conversation with a person, `subagent` for one started by another agent.
+ */
+export type ThreadResourceRole = (typeof ThreadResourceRole)[keyof typeof ThreadResourceRole];
+export declare const ThreadResourceRole: {
+    readonly main: "main";
+    readonly subagent: "subagent";
 };
-export type ChannelResourceStatus = (typeof ChannelResourceStatus)[keyof typeof ChannelResourceStatus];
-export declare const ChannelResourceStatus: {
-    readonly active: "active";
-    readonly suspended: "suspended";
-    readonly disabled: "disabled";
+/**
+ * Where this step stands. At most one step is in_progress at any time.
+ */
+export type TodoResourceStatus = (typeof TodoResourceStatus)[keyof typeof TodoResourceStatus];
+export declare const TodoResourceStatus: {
+    readonly pending: "pending";
+    readonly in_progress: "in_progress";
+    readonly completed: "completed";
 };
-export interface ChannelResource {
-    /** @nullable */
-    allowFrom: string[] | null;
-    /** How far this channel is from working. Only `online` receives messages and can issue binding codes */
-    connState: ChannelResourceConnState;
-    createdAt: string;
-    id: string;
-    name: string;
-    platform: string;
-    /** The state of the long-lived connection right now. Always `stopped` for webhook platforms */
-    runtimeState: ChannelResourceRuntimeState;
-    senderPolicy: ChannelResourceSenderPolicy;
-    status: ChannelResourceStatus;
-    updatedAt: string;
-    /** The webhook path, for gateway configuration and for diagnosis */
-    webhookPath: string;
+export interface TodoResource {
+    /** The step as an instruction — "Install nginx". */
+    content: string;
+    /** The same step phrased as happening now — "Installing nginx". Show this one while the step is in progress. */
+    activeForm: string;
+    /** Where this step stands. At most one step is in_progress at any time. */
+    status: TodoResourceStatus;
+}
+export type PendingActionResourceType = (typeof PendingActionResourceType)[keyof typeof PendingActionResourceType];
+export declare const PendingActionResourceType: {
+    readonly approval: "approval";
+    readonly question: "question";
+};
+/**
+ * A tool call that cannot continue until a person approves it or answers it.
+ */
+export interface PendingActionResource {
+    /** The conversation the tool call belongs to; a subagent's id when the subagent is the one waiting. */
+    threadId: string;
     /**
-     * The webhook address to paste into that platform's console. Null when the deployment declares no public entry point
-     * @nullable
+     * The waiting tool calls. Approvals come in batches; a question is a single item.
+     * @minItems 1
      */
-    webhookUrl: string | null;
+    itemIds: string[];
+    type: PendingActionResourceType;
 }
-export interface LengthAwarePageChannelResource {
-    /** The entries on this page */
-    items: ChannelResource[];
-    /** The page size, echoing what was requested */
-    limit: number;
-    /** How many were skipped, echoing what was requested */
-    offset: number;
-    /** How many match in total, not just on this page */
+export interface SubagentCountResource {
+    /** @minimum 0 */
     total: number;
+    /** @minimum 0 */
+    running: number;
 }
 /**
- * Credentials for that platform. Write-only: they cannot be read back after creation
+ * `message` answers messages; `compaction` summarizes the history to free the context window.
  */
-export type CreateChannelRequestBodyCredentials = {
-    [key: string]: string;
-};
-export type CreateChannelRequestBodySenderPolicy = (typeof CreateChannelRequestBodySenderPolicy)[keyof typeof CreateChannelRequestBodySenderPolicy];
-export declare const CreateChannelRequestBodySenderPolicy: {
-    readonly bound_only: "bound_only";
-    readonly open: "open";
+export type TurnType = (typeof TurnType)[keyof typeof TurnType];
+export declare const TurnType: {
+    readonly message: "message";
+    readonly compaction: "compaction";
 };
-export interface CreateChannelRequestBody {
-    /** @nullable */
-    allowFrom?: string[] | null;
-    /** Credentials for that platform. Write-only: they cannot be read back after creation */
-    credentials?: CreateChannelRequestBodyCredentials;
+export interface LastTurnResource {
+    id: string;
+    type: TurnType;
+    status: TurnStatus;
     /**
-     * @minLength 1
-     * @maxLength 128
+     * Why the turn failed. Null unless status is failed.
+     * @nullable
      */
-    name: string;
-    /** @minLength 1 */
-    platform: string;
-    senderPolicy?: CreateChannelRequestBodySenderPolicy;
-    /** Required for platforms that generate the secret themselves (secretSource=supplied). Must be absent for `generated` ones, where the secret we make is returned once in webhookSecret on this response */
-    webhookSecret?: string;
+    failureCode: string | null;
+    /** @nullable */
+    completedAt: string | null;
 }
 /**
- * How far this channel is from working. Only `online` receives messages and can issue binding codes
- */
-export type ChannelWithSecretResponseBodyConnState = (typeof ChannelWithSecretResponseBodyConnState)[keyof typeof ChannelWithSecretResponseBodyConnState];
-export declare const ChannelWithSecretResponseBodyConnState: {
-    readonly logged_out: "logged_out";
-    readonly qr_pending: "qr_pending";
-    readonly online: "online";
-    readonly expired: "expired";
-};
-/**
- * The state of the long-lived connection right now. Always `stopped` for webhook platforms
+ * How much of the model's context window the conversation occupies.
  */
-export type ChannelWithSecretResponseBodyRuntimeState = (typeof ChannelWithSecretResponseBodyRuntimeState)[keyof typeof ChannelWithSecretResponseBodyRuntimeState];
-export declare const ChannelWithSecretResponseBodyRuntimeState: {
-    readonly stopped: "stopped";
-    readonly running: "running";
-};
-export type ChannelWithSecretResponseBodySenderPolicy = (typeof ChannelWithSecretResponseBodySenderPolicy)[keyof typeof ChannelWithSecretResponseBodySenderPolicy];
-export declare const ChannelWithSecretResponseBodySenderPolicy: {
-    readonly bound_only: "bound_only";
-    readonly open: "open";
-};
-export type ChannelWithSecretResponseBodyStatus = (typeof ChannelWithSecretResponseBodyStatus)[keyof typeof ChannelWithSecretResponseBodyStatus];
-export declare const ChannelWithSecretResponseBodyStatus: {
-    readonly active: "active";
-    readonly suspended: "suspended";
-    readonly disabled: "disabled";
-};
-export interface ChannelWithSecretResponseBody {
-    /** @nullable */
-    allowFrom: string[] | null;
-    /** How far this channel is from working. Only `online` receives messages and can issue binding codes */
-    connState: ChannelWithSecretResponseBodyConnState;
-    createdAt: string;
-    id: string;
-    name: string;
-    platform: string;
-    /** The state of the long-lived connection right now. Always `stopped` for webhook platforms */
-    runtimeState: ChannelWithSecretResponseBodyRuntimeState;
-    senderPolicy: ChannelWithSecretResponseBodySenderPolicy;
-    status: ChannelWithSecretResponseBodyStatus;
-    updatedAt: string;
-    /** The webhook path, for gateway configuration and for diagnosis */
-    webhookPath: string;
+export interface ContextUsageResource {
     /**
-     * The webhook secret we generated, to paste into that platform's console. **It cannot be retrieved again** — the only way forward is rotating to a new one. Null when the platform generates the secret (secretSource=supplied) or does not use webhooks at all
+     * Prompt tokens of the latest model request. Null before the first request.
      * @nullable
      */
-    webhookSecret: string | null;
+    usedTokens: number | null;
     /**
-     * The webhook address to paste into that platform's console. Null when the deployment declares no public entry point
+     * The context window of the conversation's model. Null when the model is not in the catalogue.
      * @nullable
      */
-    webhookUrl: string | null;
+    windowTokens: number | null;
 }
 /**
- * Replaced wholesale rather than merged key by key. Absent means unchanged
- */
-export type UpdateChannelRequestBodyCredentials = {
-    [key: string]: string;
-};
-/**
- * Only when this is sent is allowFrom replaced along with it
+ * A conversation with an agent. The main conversation and its subagents have the same shape;
+ * `role` tells them apart.
  */
-export type UpdateChannelRequestBodySenderPolicy = (typeof UpdateChannelRequestBodySenderPolicy)[keyof typeof UpdateChannelRequestBodySenderPolicy];
-export declare const UpdateChannelRequestBodySenderPolicy: {
-    readonly bound_only: "bound_only";
-    readonly open: "open";
-};
-export interface UpdateChannelRequestBody {
+export interface ThreadResource {
+    id: string;
+    /** `main` for a conversation with a person, `subagent` for one started by another agent. */
+    role: ThreadResourceRole;
     /**
-     * The allow list. Only applied when senderPolicy is sent as well
+     * The conversation that started this subagent. Null for main conversations.
      * @nullable
      */
-    allowFrom?: string[] | null;
-    /** Replaced wholesale rather than merged key by key. Absent means unchanged */
-    credentials?: UpdateChannelRequestBodyCredentials;
-    enabled?: boolean;
-    /** @maxLength 128 */
-    name?: string;
-    /** Only when this is sent is allowFrom replaced along with it */
-    senderPolicy?: UpdateChannelRequestBodySenderPolicy;
-}
-export interface BindingCodeResponseBody {
-    code: string;
-    expiresAt: string;
-}
-export type PartResourceType = (typeof PartResourceType)[keyof typeof PartResourceType];
-export declare const PartResourceType: {
-    readonly text: "text";
-    readonly file: "file";
-};
-export interface PartResource {
+    parentId: string | null;
     /**
-     * For `file` parts. Points at one of this entry's `attachments`.
+     * The subagent's name, unique among the subagents of its parent. Null for main conversations.
      * @nullable
      */
-    attachmentId?: string | null;
+    agentName: string | null;
     /**
-     * Addresses this part in the live stream — text arrives as `append` frames pointing at
-     * `/items/{item}/parts/{id}/text`.
-     *
-     * Not an array index. It looks like one today because parts are only ever appended, and a
-     * client that treats it as one keeps working right up until that stops being true.
+     * Null until the conversation has a name.
+     * @nullable
      */
-    id: string;
+    title: string | null;
     /**
-     * For `text` parts. Grows as the answer is written.
+     * The folder that holds this conversation. Null for subagents, which are not filed.
      * @nullable
      */
-    text?: string | null;
-    type: PartResourceType;
-}
-export interface RejectionResource {
-    at: string;
-    peerId: string;
-    peerName: string;
-    peerUsername: string;
-    platform: string;
-    textLength: number;
-    verdict: string;
-}
-export interface RejectionListResponseBody {
-    /** @nullable */
-    rejections: RejectionResource[] | null;
-}
-export interface RotateSecretRequestBody {
-    /** Required for platforms that generate the secret themselves (secretSource=supplied). Must be absent for `generated` ones */
-    webhookSecret?: string;
-}
-export interface WebhookSecretResponseBody {
-    webhookSecret: string;
-}
-export type SenderCheckResourceVerdict = (typeof SenderCheckResourceVerdict)[keyof typeof SenderCheckResourceVerdict];
-export declare const SenderCheckResourceVerdict: {
-    readonly ALLOWED_BY_BINDING: "ALLOWED_BY_BINDING";
-    readonly ALLOWED_BY_ALLOW_FROM: "ALLOWED_BY_ALLOW_FROM";
-    readonly ALLOWED_BY_POLICY: "ALLOWED_BY_POLICY";
-    readonly REJECTED_NOT_ALLOWED: "REJECTED_NOT_ALLOWED";
-};
-export interface SenderCheckResource {
-    /** @nullable */
-    allowFrom: string[] | null;
-    allowed: boolean;
-    /** @nullable */
-    bindingId: string | null;
-    senderPolicy: string;
-    verdict: SenderCheckResourceVerdict;
-}
-export type LoginResourceStatus = (typeof LoginResourceStatus)[keyof typeof LoginResourceStatus];
-export declare const LoginResourceStatus: {
-    readonly wait: "wait";
-    readonly scanned: "scanned";
-    readonly confirmed: "confirmed";
-    readonly expired: "expired";
-    readonly error: "error";
-    readonly need_verify_code: "need_verify_code";
-};
-export interface LoginResource {
-    /** When this login flow expires. Past that, stop polling and start a new one */
-    expiresAt: string;
-    id: string;
-    /** The text to encode and render as a QR code by the client — not an image address and not a data URI. When a code expires this flow issues another and keeps waiting, so each poll may return a new string */
-    qrcodeData: string;
-    /** Why it failed. Present only when status is error or expired */
-    reason: string;
-    status: LoginResourceStatus;
-}
-export interface CredentialFieldResource {
-    help: string;
-    key: string;
-    label: string;
-    required: boolean;
-    secret: boolean;
+    folderId: string | null;
+    /**
+     * The version of this conversation's place in its folder. Pass it as `expectedVersion` when moving it.
+     * @minimum 0
+     */
+    orderVersion: number;
+    /** The Canopy model the next model request uses. */
+    modelId: string;
+    /** Null when the model does not reason. */
+    reasoningEffort: ReasoningEffort | null;
+    approvalMode: ApprovalMode;
+    status: ThreadStatus;
+    /**
+     * What the assistant is doing right now, for example "Reading nginx.conf". Null when idle.
+     * @nullable
+     */
+    activity: string | null;
+    /**
+     * The beginning of the assistant's latest message.
+     * @nullable
+     */
+    recentMessage: string | null;
+    /** The assistant's current plan, in order. Empty when it has none. */
+    todos: TodoResource[];
+    /** What this conversation is waiting for from a person. It may belong to one of its subagents. */
+    pendingAction: PendingActionResource | null;
+    subagents: SubagentCountResource;
+    /** The most recent turn. Null before the first message. */
+    lastTurn: LastTurnResource | null;
+    context: ContextUsageResource;
+    /** Token usage over the whole conversation. For a main conversation this includes its subagents. */
+    usage: Usage;
+    /** The assistant replied after the conversation was last marked read. */
+    unread: boolean;
+    archived: boolean;
+    createdAt: string;
+    /** The last activity. Renaming or moving the conversation does not change it. */
+    updatedAt: string;
 }
-export type PlatformResourceSecretSource = (typeof PlatformResourceSecretSource)[keyof typeof PlatformResourceSecretSource];
-export declare const PlatformResourceSecretSource: {
-    readonly generated: "generated";
-    readonly supplied: "supplied";
-    readonly none: "none";
-};
-export type PlatformResourceSetupChallenge = (typeof PlatformResourceSetupChallenge)[keyof typeof PlatformResourceSetupChallenge];
-export declare const PlatformResourceSetupChallenge: {
-    readonly none: "none";
-    readonly webhook: "webhook";
-    readonly scan: "scan";
-};
-export type PlatformResourceSetupMethod = (typeof PlatformResourceSetupMethod)[keyof typeof PlatformResourceSetupMethod];
-export declare const PlatformResourceSetupMethod: {
-    readonly credentials: "credentials";
-    readonly scan: "scan";
-};
-export interface PlatformResource {
+/**
+ * @nullable
+ */
+export type MessagePartData = {
+    [key: string]: unknown;
+} | null;
+/**
+ * One piece of a message. `type` says which field carries it:
+ *
+ * - `text` — the words, in `text`
+ * - `file` — an attachment uploaded earlier, by id in `attachmentId`
+ * - `data-<name>` — context from the client, in `data`. The name is shown to the assistant so it
+ *   can tell one block from another.
+ */
+export interface MessagePart {
+    /**
+     * @minLength 1
+     * @maxLength 64
+     */
+    type: string;
     /** @nullable */
-    credentialFields: CredentialFieldResource[] | null;
-    name: string;
-    resident: boolean;
-    secretSource: PlatformResourceSecretSource;
-    setupChallenge: PlatformResourceSetupChallenge;
-    setupMethod: PlatformResourceSetupMethod;
-    /** The webhook path template; {channel} is replaced with the channel id */
-    webhookPath: string;
+    text?: string | null;
     /**
-     * The full webhook address template. Null when the deployment declares no public entry point
+     * The attachment must have been uploaded and not yet sent with another message.
      * @nullable
      */
-    webhookUrlTemplate: string | null;
-}
-export interface PlatformListResponseBody {
+    attachmentId?: string | null;
     /** @nullable */
-    platforms: PlatformResource[] | null;
-}
-export interface VerifyCodeRequestBody {
-    /** @minLength 1 */
-    code: string;
+    data?: MessagePartData;
 }
+export type ClientActionRequestType = (typeof ClientActionRequestType)[keyof typeof ClientActionRequestType];
+export declare const ClientActionRequestType: {
+    readonly function: "function";
+};
 /**
- * Path to contents, `SKILL.md` among them. Only returned by `get-skill`; the list leaves it out.
+ * JSON Schema for the arguments. Omit for an action without arguments.
  * @nullable
  */
-export type SkillResourceFiles = {
-    [key: string]: string;
+export type ClientFunctionRequestParameters = {
+    [key: string]: unknown;
 } | null;
 /**
- * `builtin` — provided by the platform and read-only here.
- * `project` — written for this project and editable by anyone in it.
+ * The MCP and Anthropic name for `parameters`. Give one or the other.
+ * @nullable
  */
-export type SkillResourceOrigin = (typeof SkillResourceOrigin)[keyof typeof SkillResourceOrigin];
-export declare const SkillResourceOrigin: {
-    readonly builtin: "builtin";
-    readonly project: "project";
-};
-export interface SkillResource {
+export type ClientFunctionRequestInputSchema = {
+    [key: string]: unknown;
+} | null;
+export interface ClientFunctionRequest {
     /**
-     * True when the assistant wrote this skill during a conversation rather than a person
-     * writing it here.
-     *
-     * Which conversation is deliberately not returned: skills are shared across the project
-     * while conversations belong to one person, so naming one would tell everybody in the
-     * project that a particular colleague had it.
+     * @minLength 1
+     * @maxLength 64
      */
-    authoredByAssistant: boolean;
-    /** Why the assistant would open this skill. It sits in every request, so it is the one field worth writing carefully. */
-    description: string;
-    enabled: boolean;
+    name: string;
     /**
-     * Path to contents, `SKILL.md` among them. Only returned by `get-skill`; the list leaves it out.
-     * @nullable
+     * What the action does, written for the model. OpenAI's limit on tool descriptions is 1024 characters.
+     * @minLength 1
+     * @maxLength 1024
      */
-    files?: SkillResourceFiles;
-    name: string;
+    description: string;
     /**
-     * `builtin` — provided by the platform and read-only here.
-     * `project` — written for this project and editable by anyone in it.
+     * JSON Schema for the arguments. Omit for an action without arguments.
+     * @nullable
      */
-    origin: SkillResourceOrigin;
-    /** @nullable */
-    shortDescription: string | null;
+    parameters?: ClientFunctionRequestParameters;
     /**
-     * Null for built-in skills, which have no edit history here.
+     * The MCP and Anthropic name for `parameters`. Give one or the other.
      * @nullable
      */
-    updatedAt: string | null;
+    inputSchema?: ClientFunctionRequestInputSchema;
 }
-export interface SkillListResponseBody {
-    skills: SkillResource[];
+/**
+ * A tool in the OpenAI Chat Completions format, plus `readOnly` and `timeoutMs`.
+ */
+export interface ClientActionRequest {
+    type?: ClientActionRequestType;
+    function: ClientFunctionRequest;
+    /** True when the action changes nothing outside the client. Other actions go through approval before they run. */
+    readOnly: boolean;
+    /**
+     * How long the assistant waits for this action. Longer values are capped.
+     * @minimum 0
+     */
+    timeoutMs?: number;
 }
 /**
- * Path to contents. `SKILL.md` is required; anything else it references goes alongside it.
- *
- * Paths are relative to the skill and cannot leave it. At most 32 files, 256 KiB each and
- * 1 MiB in total.
+ * Which client this is and which actions it offers, so the assistant can ask it to run them while
+ * it answers. Send `actions` only when they changed since the last message; omitting them keeps
+ * what was declared before.
  */
-export type SkillRequestBodyFiles = {
-    [key: string]: string;
-};
-export interface SkillRequestBody {
+export interface ClientContextRequest {
     /**
-     * Why the assistant would open this skill. It sits in every request; write it as the answer to "when do I need this", not "what does it contain".
+     * Identifies this client while it stays open; one per tab or process.
      * @minLength 1
-     * @maxLength 1024
+     * @maxLength 128
      */
-    description: string;
-    enabled?: boolean;
+    clientId: string;
     /**
-     * Path to contents. `SKILL.md` is required; anything else it references goes alongside it.
-     *
-     * Paths are relative to the skill and cannot leave it. At most 32 files, 256 KiB each and
-     * 1 MiB in total.
+     * How the client names itself, for example "Leaflow console (web)".
+     * @maxLength 64
      */
-    files: SkillRequestBodyFiles;
+    label?: string;
     /**
-     * Also how the assistant refers to it, so renaming is deleting and writing again.
-     * @minLength 1
-     * @maxLength 64
+     * The actions on offer now. `[]` withdraws all of them; null keeps the previous declaration.
+     * @maxItems 32
+     * @nullable
      */
-    name: string;
-    /** @maxLength 1024 */
-    shortDescription?: string;
+    actions?: ClientActionRequest[] | null;
 }
-export interface SkillEnabledRequestBody {
-    enabled: boolean;
+export interface SendMessageRequestBody {
+    /**
+     * The message, in the order it was written. A message with nothing but text is a single text
+     * part.
+     * @minItems 1
+     */
+    parts: MessagePart[];
+    client?: ClientContextRequest;
 }
-export type ThreadSummaryResourceApprovalMode = (typeof ThreadSummaryResourceApprovalMode)[keyof typeof ThreadSummaryResourceApprovalMode];
-export declare const ThreadSummaryResourceApprovalMode: {
-    readonly guardian: "guardian";
-    readonly manual: "manual";
-    readonly yolo: "yolo";
-};
-export interface ThreadSummaryResource {
-    approvalMode: ThreadSummaryResourceApprovalMode;
-    archived: boolean;
-    createdAt: string;
+export interface CreateThreadRequestBody {
     /**
-     * The folder this conversation is filed under, or null when it is in none
-     * @nullable
+     * @minLength 1
+     * @maxLength 255
      */
-    folderId: string | null;
-    id: string;
+    title?: string;
     /**
-     * The actual Canopy model id for the running turn, or the first candidate for the next turn when idle. Null when no model can be selected. This can differ from preferredModelId after fallback or while selection is disabled.
-     * @nullable
+     * The folder to file it in. Omit for the inbox.
+     * @maxLength 64
      */
-    model: string | null;
+    folderId?: string;
     /**
-     * The saved preferred Canopy model id, independent of the model actually used. Null follows the platform default. Kept when selection is disabled, the model is removed, or a request falls back.
+     * Omit to use the caller's default model.
      * @minLength 1
      * @maxLength 128
-     * @nullable
      */
-    preferredModelId: string | null;
-    /** @nullable */
-    title: string | null;
-    unread: boolean;
-    updatedAt: string;
+    modelId?: string;
+    /** Omit to use the caller's default effort, or medium. */
+    reasoningEffort?: ReasoningEffort;
+    approvalMode?: ApprovalMode;
+    message?: SendMessageRequestBody;
 }
-export interface ThreadListResponseBody {
+export interface CreateThreadResponseBody {
+    thread: ThreadResource;
     /**
-     * Pass this back as `cursor` for the next page. Null means this was the last one — it is only set when there is genuinely more, so an empty final page never happens.
+     * The turn started by `message`. Null when no message was sent.
      * @nullable
      */
-    nextCursor: string | null;
-    /** @nullable */
-    threads: ThreadSummaryResource[] | null;
+    turnId: string | null;
 }
 /**
- * Absent uses the platform's default approval mode
+ * Defaults to main unless parentId is given.
  */
-export type CreateThreadRequestBodyApprovalMode = (typeof CreateThreadRequestBodyApprovalMode)[keyof typeof CreateThreadRequestBodyApprovalMode];
-export declare const CreateThreadRequestBodyApprovalMode: {
-    readonly guardian: "guardian";
+export type SearchThreadsRequestBodyRole = (typeof SearchThreadsRequestBodyRole)[keyof typeof SearchThreadsRequestBodyRole];
+export declare const SearchThreadsRequestBodyRole: {
+    readonly main: "main";
+    readonly subagent: "subagent";
+};
+/**
+ * `needs_action` is waiting for a person or ended with a failure, `running` is working,
+ * and `done` is everything else.
+ */
+export type SearchThreadsRequestBodyState = (typeof SearchThreadsRequestBodyState)[keyof typeof SearchThreadsRequestBodyState];
+export declare const SearchThreadsRequestBodyState: {
+    readonly needs_action: "needs_action";
+    readonly running: "running";
+    readonly done: "done";
+};
+/**
+ * `attention` puts conversations that need action first, then running ones, then the most
+ * recent. `recent` orders by last activity. `manual` is the order inside a folder and requires
+ * folderId.
+ */
+export type SearchThreadsRequestBodySort = (typeof SearchThreadsRequestBodySort)[keyof typeof SearchThreadsRequestBodySort];
+export declare const SearchThreadsRequestBodySort: {
+    readonly attention: "attention";
+    readonly recent: "recent";
     readonly manual: "manual";
-    readonly yolo: "yolo";
 };
-export interface CreateThreadRequestBody {
-    /** Absent uses the platform's default approval mode */
-    approvalMode?: CreateThreadRequestBodyApprovalMode;
+export type SearchThreadsRequestBodyIncludeItem = (typeof SearchThreadsRequestBodyIncludeItem)[keyof typeof SearchThreadsRequestBodyIncludeItem];
+export declare const SearchThreadsRequestBodyIncludeItem: {
+    readonly counts: "counts";
+};
+export interface SearchThreadsRequestBody {
+    /**
+     * Read these conversations, including subagents and archived ones. Cannot be combined with cursor.
+     * @minItems 1
+     * @maxItems 200
+     */
+    ids?: string[];
+    /**
+     * Only conversations in this folder.
+     * @maxLength 64
+     */
+    folderId?: string;
+    /**
+     * Only the subagents of this conversation.
+     * @maxLength 64
+     */
+    parentId?: string;
+    /** Defaults to main unless parentId is given. */
+    role?: SearchThreadsRequestBodyRole;
+    /**
+     * `needs_action` is waiting for a person or ended with a failure, `running` is working,
+     * and `done` is everything else.
+     */
+    state?: SearchThreadsRequestBodyState;
+    /** True for archived conversations only; otherwise unarchived only. */
+    archived?: boolean;
+    /**
+     * Matches titles, case-insensitively.
+     * @maxLength 100
+     */
+    q?: string;
+    /**
+     * `attention` puts conversations that need action first, then running ones, then the most
+     * recent. `recent` orders by last activity. `manual` is the order inside a folder and requires
+     * folderId.
+     */
+    sort?: SearchThreadsRequestBodySort;
+    /** @maxLength 1024 */
+    cursor?: string;
+    /**
+     * @minimum 1
+     * @maximum 200
+     */
+    limit?: number;
+    /** Optional parts of the response. `counts` adds `counts`. */
+    include?: SearchThreadsRequestBodyIncludeItem[];
+}
+/**
+ * Counts over everything the criteria match, not only this page. `state`, `q` and the cursor are ignored.
+ */
+export interface ThreadCountsResource {
+    /** @minimum 0 */
+    total: number;
+    /** @minimum 0 */
+    needsAction: number;
+    /** @minimum 0 */
+    running: number;
+    /** @minimum 0 */
+    unread: number;
+}
+export interface ThreadListResponseBody {
+    threads: ThreadResource[];
+    /**
+     * Null on the last page.
+     * @nullable
+     */
+    nextCursor: string | null;
+    /** Null unless `include` asked for it. */
+    counts: ThreadCountsResource | null;
+}
+export interface UpdateThreadRequestBody {
+    /**
+     * @minLength 1
+     * @maxLength 255
+     */
+    title?: string;
     /**
-     * A Canopy model id to prefer. Omit or pass null to follow the platform default. Non-null requires allowModelSelection; a disallowed, retired or removed id falls back to the default without clearing the preference.
      * @minLength 1
      * @maxLength 128
-     * @nullable
      */
-    preferredModelId?: string | null;
+    modelId?: string;
+    reasoningEffort?: ReasoningEffort | null;
+    approvalMode?: ApprovalMode;
+    archived?: boolean;
 }
-export interface ContextResource {
-    /** @nullable */
-    compactAt: number | null;
+export interface ResumeThreadRequestBody {
     /**
-     * What kinds of input the model behind this conversation accepts, as modality names: text, image.
-     *
-     * This governs images and nothing else. Text and binary attachments reach every model: a small text file is placed inline, a large one is read on demand, and a binary is downloaded onto a cloud instance — none of which asks the model to see a picture. So this decides whether pasting a screenshot does anything, not whether the attach control exists. Hiding file upload on a text-only model takes away something that would have worked.
-     *
-     * This describes the effective model, including a replacement chosen through fallback, rather than the saved preference. An empty list means no effective model is available to describe; it is not a claim that every model rejects files.
+     * Added to the conversation before the turn starts.
+     * @maxLength 20000
      */
-    inputModalities: string[];
+    message?: string;
+}
+export interface TurnStartedResponseBody {
+    turnId: string;
+}
+export interface RevertRequestBody {
     /**
-     * The effective Canopy model id, matching the conversation summary's model. Null when no model can be selected; window and compactAt are then null and inputModalities is empty.
-     * @nullable
+     * The first item to revert; it and everything after it are reverted.
+     * @minimum 0
      */
-    model: string | null;
-    /** @nullable */
-    used: number | null;
-    warnAt: number;
-    /** @nullable */
-    window: number | null;
+    ordinal: number;
 }
-export interface EarlierResource {
-    before: number;
-    foldedAbove: boolean;
+export interface RevertedCountResponseBody {
+    /** @minimum 0 */
+    reverted: number;
 }
 /**
- * What this attachment is. A client renders an image in place and everything else as a file to download.
+ * Pagination metadata for stable numbered pages. total_count is returned only when the operation can determine it without an unbounded scan.
  */
-export type AttachmentResourceKind = (typeof AttachmentResourceKind)[keyof typeof AttachmentResourceKind];
-export declare const AttachmentResourceKind: {
-    readonly image: "image";
-    readonly text: "text";
-    readonly binary: "binary";
-};
-export interface AttachmentResource {
-    byteSize: number;
-    filename: string;
+export interface OffsetPagination {
+    /** @minimum 1 */
+    page: number;
+    /** @minimum 1 */
+    page_size: number;
+    /** @minimum 0 */
+    total_count?: number;
+}
+/**
+ * Pagination metadata for keyset traversal. Pass next_cursor as cursor to read the following page; null means there is no following page.
+ */
+export interface CursorPagination {
+    /** @minimum 1 */
+    page_size: number;
+    /** @nullable */
+    next_cursor?: string | null;
+}
+/**
+ * One run of the agent, from the message that started it until it stopped.
+ */
+export interface ThreadTurnResource {
+    id: string;
+    threadId: string;
+    type: TurnType;
+    status: TurnStatus;
     /**
-     * Null unless kind is image. Width and height are here so a client can hold the space before the image itself has loaded.
+     * The first item the turn wrote. Null before it has written one.
      * @nullable
      */
-    height: number | null;
-    id: string;
-    /** What this attachment is. A client renders an image in place and everything else as a file to download. */
-    kind: AttachmentResourceKind;
+    firstOrdinal: number | null;
     /**
-     * Null unless kind is image.
+     * The last item the turn wrote so far.
      * @nullable
      */
-    width: number | null;
+    lastOrdinal: number | null;
+    /**
+     * The beginning of the message that started the turn. Null for compaction turns and turns started by the assistant itself.
+     * @nullable
+     */
+    preview: string | null;
+    modelId: string;
+    reasoningEffort: ReasoningEffort | null;
+    approvalMode: ApprovalMode;
+    /**
+     * Why the turn failed. Null unless status is failed.
+     * @nullable
+     */
+    failureCode: string | null;
+    /**
+     * How many tools the turn called.
+     * @minimum 0
+     */
+    toolCalls: number;
+    /** Tokens used by every model request of this turn, including title generation, review and compaction. */
+    usage: Usage;
+    startedAt: string;
+    /**
+     * When the first output token arrived. Null until then.
+     * @nullable
+     */
+    firstTokenAt: string | null;
+    /**
+     * Null while the turn is running.
+     * @nullable
+     */
+    completedAt: string | null;
 }
+export interface ThreadTurnListResponseBody {
+    /** Newest first. */
+    turns: ThreadTurnResource[];
+    /** @nullable */
+    nextCursor: string | null;
+}
+export type ThreadItemResourceType = (typeof ThreadItemResourceType)[keyof typeof ThreadItemResourceType];
+export declare const ThreadItemResourceType: {
+    readonly user_message: "user_message";
+    readonly external_message: "external_message";
+    readonly agent_message: "agent_message";
+    readonly reasoning: "reasoning";
+    readonly tool_call: "tool_call";
+    readonly compaction: "compaction";
+    readonly token_budget_reminder: "token_budget_reminder";
+    readonly turn_failure: "turn_failure";
+};
 /**
- * @nullable
+ * `queued` is a message sent while the assistant was busy that it has not read yet.
  */
-export type ItemResourceApproval = (typeof ItemResourceApproval)[keyof typeof ItemResourceApproval] | null;
-export declare const ItemResourceApproval: {
-    readonly approved: "approved";
-    readonly declined: "declined";
-    readonly auto_approved: "auto_approved";
-    readonly unreviewed: "unreviewed";
-};
-export type ItemResourceStatus = (typeof ItemResourceStatus)[keyof typeof ItemResourceStatus];
-export declare const ItemResourceStatus: {
+export type ThreadItemResourceStatus = (typeof ThreadItemResourceStatus)[keyof typeof ThreadItemResourceStatus];
+export declare const ThreadItemResourceStatus: {
+    readonly queued: "queued";
     readonly pending: "pending";
     readonly in_progress: "in_progress";
     readonly completed: "completed";
     readonly failed: "failed";
     readonly declined: "declined";
-    readonly interrupted: "interrupted";
+    readonly cancelled: "cancelled";
 };
 /**
- * Determines which fields this entry carries
+ * `subagent` for a subagent reporting to its parent, `thread` for another of the person's
+ * conversations, `task` for a task, `channel` for a chat app.
  */
-export type ItemResourceType = (typeof ItemResourceType)[keyof typeof ItemResourceType];
-export declare const ItemResourceType: {
-    readonly user_message: "user_message";
-    readonly agent_message: "agent_message";
-    readonly reasoning: "reasoning";
-    readonly dynamic_tool_call: "dynamic_tool_call";
-    readonly context_compaction: "context_compaction";
-    readonly token_budget_reminder: "token_budget_reminder";
-    readonly turn_failure: "turn_failure";
+export type ItemSourceResourceType = (typeof ItemSourceResourceType)[keyof typeof ItemSourceResourceType];
+export declare const ItemSourceResourceType: {
+    readonly subagent: "subagent";
+    readonly thread: "thread";
+    readonly task: "task";
+    readonly channel: "channel";
+};
+export interface ItemSourceResource {
+    /**
+     * `subagent` for a subagent reporting to its parent, `thread` for another of the person's
+     * conversations, `task` for a task, `channel` for a chat app.
+     */
+    type: ItemSourceResourceType;
+    /** The conversation, task or channel the message came from. */
+    id: string;
+}
+export type PartResourceType = (typeof PartResourceType)[keyof typeof PartResourceType];
+export declare const PartResourceType: {
+    readonly text: "text";
+    readonly file: "file";
+};
+export interface PartResource {
+    /**
+     * Addresses this part in the realtime stream: text arrives as `append` frames pointing at
+     * `/items/{item}/parts/{id}/text`. Not an array index.
+     */
+    id: string;
+    type: PartResourceType;
+    /**
+     * For `text` parts. Grows as the answer is written.
+     * @nullable
+     */
+    text: string | null;
+    /**
+     * For `file` parts. Points at one of the item's `attachments`.
+     * @nullable
+     */
+    attachmentId: string | null;
+}
+/**
+ * A client renders an image in place and everything else as a file to download.
+ */
+export type AttachmentResourceType = (typeof AttachmentResourceType)[keyof typeof AttachmentResourceType];
+export declare const AttachmentResourceType: {
+    readonly image: "image";
+    readonly text: "text";
+    readonly binary: "binary";
 };
+export interface AttachmentResource {
+    id: string;
+    /** A client renders an image in place and everything else as a file to download. */
+    type: AttachmentResourceType;
+    filename: string;
+    byteSize: number;
+    /**
+     * Null unless type is image. Lets a client hold the space before the image loads.
+     * @nullable
+     */
+    width: number | null;
+    /**
+     * Null unless type is image.
+     * @nullable
+     */
+    height: number | null;
+}
 export type ClientContextPartData = {
     [key: string]: unknown;
 };
 /**
- * A `data-*` part as it was sent.
+ * A `data-*` part as the client sent it.
  */
 export interface ClientContextPart {
-    data: ClientContextPartData;
     type: string;
+    data: ClientContextPartData;
 }
 /**
- * What the call did to the file
+ * Determines which of the remaining fields is populated.
  */
+export type PresentationResourceType = (typeof PresentationResourceType)[keyof typeof PresentationResourceType];
+export declare const PresentationResourceType: {
+    readonly file_diff: "file_diff";
+};
 export type FileDiffResourceStatus = (typeof FileDiffResourceStatus)[keyof typeof FileDiffResourceStatus];
 export declare const FileDiffResourceStatus: {
     readonly added: "added";
@@ -750,466 +749,1291 @@ export declare const FileDiffResourceStatus: {
     readonly deleted: "deleted";
 };
 /**
- * The change a tool call applied to a single file.
- *
- * Populated once the call has completed successfully. It is absent while the call is pending
- * or awaiting approval, as the file's prior contents are read during execution. To preview an
- * edit awaiting approval, derive it from the call's `old_string` and `new_string` arguments.
+ * The change a tool call applied to a single file. Present once the call has completed; while it
+ * awaits approval, derive a preview from its `old_string` and `new_string` arguments.
  */
 export interface FileDiffResource {
-    /** Lines added. Complete even when `unified` is null */
-    added: number;
-    /** Absolute path of the file on the instance */
+    /** Absolute path of the file on the instance. */
     path: string;
-    /** Lines removed. Complete even when `unified` is null */
-    removed: number;
-    /** What the call did to the file */
     status: FileDiffResourceStatus;
+    /** Lines added. Complete even when `unified` is null. */
+    added: number;
+    /** Lines removed. Complete even when `unified` is null. */
+    removed: number;
     /**
-     * The change as a unified diff with three lines of context. A file created by the call is
-     * diffed against `/dev/null`.
-     *
-     * Null when the change exceeds the service's size limit. The diff is omitted in full
-     * rather than truncated; `added` and `removed` remain complete.
+     * The change as a unified diff with three lines of context. Null when it exceeds the size limit.
      * @nullable
      */
-    unified?: string | null;
+    unified: string | null;
 }
 /**
- * Determines which of the remaining fields is populated
+ * Structured detail produced by a tool call, in addition to the one-line `detail`.
  */
-export type PresentationResourceKind = (typeof PresentationResourceKind)[keyof typeof PresentationResourceKind];
-export declare const PresentationResourceKind: {
-    readonly file_diff: "file_diff";
-};
+export interface PresentationResource {
+    /** Determines which of the remaining fields is populated. */
+    type: PresentationResourceType;
+    fileDiff: FileDiffResource | null;
+}
 /**
- * Structured detail produced by a tool call, in addition to the single-line `detail`. Null
- * when the call produced none.
- *
- * `kind` determines which of the remaining fields is populated.
+ * Whether the call needed a decision before it ran. Null for calls that need none.
+ * `auto_approved` was approved by the automatic reviewer.
+ * @nullable
  */
-export interface PresentationResource {
-    fileDiff?: FileDiffResource | null;
-    /** Determines which of the remaining fields is populated */
-    kind: PresentationResourceKind;
+export type ToolCallResourceApprovalStatus = (typeof ToolCallResourceApprovalStatus)[keyof typeof ToolCallResourceApprovalStatus] | null;
+export declare const ToolCallResourceApprovalStatus: {
+    readonly pending: "pending";
+    readonly reviewing: "reviewing";
+    readonly approved: "approved";
+    readonly auto_approved: "auto_approved";
+    readonly declined: "declined";
+    readonly unreviewed: "unreviewed";
+};
+export interface ChoiceResource {
+    label: string;
+    description: string;
 }
-export interface ItemResource {
-    /** @nullable */
-    approval?: ItemResourceApproval;
-    /** @nullable */
-    approvalReason?: string | null;
-    arguments?: string;
-    /** @nullable */
-    attachments?: AttachmentResource[] | null;
+export interface QuestionResource {
+    id: string;
+    /** A short label for the question. */
+    header: string;
+    question: string;
+    /** Suggested answers. A free-form answer is accepted as well. */
+    choices: ChoiceResource[];
+}
+/**
+ * The answers given so far, by question id. Null for other calls.
+ * @nullable
+ */
+export type ToolCallResourceAnswers = {
+    [key: string]: string;
+} | null;
+export interface ToolCallResource {
+    /** The tool's group, for example `instance`, `leaflow`, `agent` or `client`. Empty for tools without one. */
+    namespace: string;
+    tool: string;
+    /** The arguments as JSON text. Cut in lists when long; then it is no longer valid JSON. */
+    arguments: string;
+    /**
+     * What the call acts on, for display, such as a file path or an instance name.
+     * @nullable
+     */
+    target: string | null;
     /**
-     * The context blocks the client attached to this message.
-     *
-     * **Not part of what the operator wrote** — `text` is. Render the message from `text` and
-     * leave these out of the bubble; they are here so a client that did not send them, or one
-     * that reloaded, can still read what the assistant was given.
-     *
-     * The actions declared alongside them are not returned: they are re-declared as they
-     * change and would make every fetch of the conversation carry them again.
+     * A one-line description of what the call did.
      * @nullable
      */
-    clientContext?: ClientContextPart[] | null;
-    createdAt: string;
-    /** @nullable */
-    detail?: string | null;
-    presentation?: PresentationResource | null;
+    detail: string | null;
+    presentation: PresentationResource | null;
+    /**
+     * Whether the call needed a decision before it ran. Null for calls that need none.
+     * `auto_approved` was approved by the automatic reviewer.
+     * @nullable
+     */
+    approvalStatus: ToolCallResourceApprovalStatus;
     /** @nullable */
-    durationMs?: number | null;
+    approvalReason: string | null;
+    /**
+     * When a person or the reviewer decided the call or answered its questions.
+     * @nullable
+     */
+    decidedAt: string | null;
+    /**
+     * The questions of an `ask` call. Null for other calls.
+     * @nullable
+     */
+    questions: QuestionResource[] | null;
+    /**
+     * The answers given so far, by question id. Null for other calls.
+     * @nullable
+     */
+    answers: ToolCallResourceAnswers;
+    /**
+     * How long an `ask` call waits before it continues with its default answers. Null when it waits indefinitely.
+     * @nullable
+     */
+    autoAnswerMs: number | null;
+}
+/**
+ * One entry of the transcript. `type` determines which fields it carries.
+ */
+export interface ThreadItemResource {
     id: string;
     /**
-     * The Canopy model id that actually produced this entry, including after fallback. Never replaced by the conversation's preference or rewritten when the model is retired or removed from the allowlist. Null for messages the user sent.
+     * The position in the transcript. Never renumbered. Null for a message waiting in the queue.
      * @nullable
      */
-    model: string | null;
-    /** @nullable */
-    namespace?: string | null;
-    ordinal: number;
+    ordinal: number | null;
+    /**
+     * The turn that wrote this item. Null for messages waiting in the queue.
+     * @nullable
+     */
+    turnId: string | null;
+    type: ThreadItemResourceType;
+    /** `queued` is a message sent while the assistant was busy that it has not read yet. */
+    status: ThreadItemResourceStatus;
+    /** Left out of model requests since a revert. Shown, but marked. */
     reverted: boolean;
-    status: ItemResourceStatus;
-    /** @nullable */
-    target?: string | null;
+    /** Long reasoning or tool arguments were cut from this list; read the item for all of it. */
+    truncated: boolean;
+    /** Who wrote an `external_message`. Null for other items. */
+    source: ItemSourceResource | null;
     /**
-     * The content of this entry, in the order it was written. A message that is only text is a
-     * single part, which is most of them.
-     *
-     * An attachment belongs where it was written, so render these in order rather than putting
-     * them all at the end.
+     * The Canopy model that produced this item. Null for messages a person or another source sent.
      * @nullable
      */
-    parts?: PartResource[] | null;
-    /** @nullable */
-    tool?: string | null;
-    /** Determines which fields this entry carries */
-    type: ItemResourceType;
+    modelId: string | null;
+    /**
+     * How long the reasoning or the tool call took. Null while it runs and for other items.
+     * @nullable
+     */
+    durationMs: number | null;
+    /**
+     * The content, in the order it was written. Text arrives as `append` frames on the realtime
+     * stream. An attachment belongs where it was written, so render parts in order. Empty for
+     * tool calls; their outcome is in `toolCall.detail` and `toolCall.presentation`.
+     */
+    parts: PartResource[];
+    attachments: AttachmentResource[];
+    /**
+     * The `data-*` blocks the client attached to a user message. They are not part of what the
+     * person wrote; render the message from `parts` and leave these out of the bubble.
+     */
+    clientContext: ClientContextPart[];
+    /** The call, for a `tool_call` item. Null for other items. */
+    toolCall: ToolCallResource | null;
+    createdAt: string;
 }
-export interface StreamResource {
-    path: string;
-    ticket: string;
+export interface ThreadItemListResponseBody {
+    /** Oldest first. */
+    items: ThreadItemResource[];
+    /**
+     * The first ordinal of the window; pass as `before` to read the window above. Null when the window is empty.
+     * @nullable
+     */
+    startOrdinal: number | null;
+    /**
+     * The last ordinal of the window; pass as `after` to read the window below. Null when the window is empty.
+     * @nullable
+     */
+    endOrdinal: number | null;
+    hasEarlier: boolean;
+    hasLater: boolean;
+    /** Messages waiting for the assistant, in the order they were sent. Empty unless the window reaches the end. */
+    queued: ThreadItemResource[];
+    /**
+     * Subscribe to the conversation on /api/v1/realtime from this cursor to receive what is
+     * written after this window. Null unless the window reaches the end.
+     * @nullable
+     */
+    streamCursor: string | null;
 }
-export type TurnResourceApprovalMode = (typeof TurnResourceApprovalMode)[keyof typeof TurnResourceApprovalMode];
-export declare const TurnResourceApprovalMode: {
-    readonly guardian: "guardian";
-    readonly manual: "manual";
-    readonly yolo: "yolo";
+export interface SendMessageResponseBody {
+    /**
+     * The turn this message started. Null when it was queued behind a running turn.
+     * @nullable
+     */
+    turnId: string | null;
+    queued: boolean;
+    /**
+     * How many messages were waiting ahead of this one when it was queued.
+     * @minimum 0
+     */
+    queuedAhead: number;
+}
+export interface DecideToolCallsRequestBody {
+    /**
+     * The tool calls awaiting approval, from `pendingAction.itemIds`.
+     * @minItems 1
+     */
+    itemIds: string[];
+    approved: boolean;
+    /**
+     * Passed to the assistant with a decline, so it can change course.
+     * @maxLength 2000
+     */
+    reason?: string;
+}
+/**
+ * A map from question id to the answer.
+ */
+export type AnswerQuestionRequestBodyAnswers = {
+    [key: string]: string;
 };
-export interface TurnResource {
-    approvalMode: TurnResourceApprovalMode;
+export interface AnswerQuestionRequestBody {
+    /** A map from question id to the answer. */
+    answers: AnswerQuestionRequestBodyAnswers;
+}
+export interface ToolResultRequestBody {
+    /**
+     * The client that declared the action. A result from another client is refused.
+     * @minLength 1
+     */
+    clientId: string;
+    ok: boolean;
+    /** What the action produced. At most 64 KiB; use `nextCursor` for more. */
+    output?: string;
+    /**
+     * Why it failed, when `ok` is false. Written for the assistant, which cannot see the screen.
+     * @maxLength 2000
+     */
+    error?: string;
+    /**
+     * Pass when there is more to read; the assistant calls again with it.
+     * @maxLength 500
+     */
+    nextCursor?: string;
 }
-export interface Choice {
+export interface CommandResource {
+    /** The command without the slash, for example `status`. */
+    name: string;
+    /** Other names that run the same command. */
+    aliases: string[];
     description: string;
-    label: string;
+    /** How to write the arguments, for example `<model id>`. Empty when the command takes none. */
+    argumentHint: string;
 }
-export interface Question {
-    /** @nullable */
-    choices: Choice[] | null;
-    header: string;
-    id: string;
-    question: string;
+export interface CommandListResponseBody {
+    commands: CommandResource[];
+}
+export interface RunCommandRequestBody {
+    /**
+     * The command or one of its aliases, without the slash.
+     * @minLength 1
+     * @maxLength 32
+     */
+    name: string;
+    /**
+     * Everything typed after the command name.
+     * @maxLength 2000
+     */
+    arguments?: string;
+}
+/**
+ * The conversation's configuration and resource use, as shown by /status.
+ */
+export interface StatusReportResource {
+    threadId: string;
+    modelId: string;
+    /** The model's display name in the Canopy catalogue. Falls back to modelId. */
+    modelName: string;
+    reasoningEffort: ReasoningEffort | null;
+    approvalMode: ApprovalMode;
+    status: ThreadStatus;
+    context: ContextUsageResource;
+    /** Token usage over the whole conversation. */
+    usage: Usage;
+    /** The most recent turn with its own usage. Null before the first message. */
+    lastTurn: ThreadTurnResource | null;
+}
+export interface CommandResultResource {
+    /** The command that ran, after resolving aliases. */
+    name: string;
+    /** The result as plain text. */
+    message: string;
+    /** The conversation after the command. */
+    thread: ThreadResource | null;
+    /**
+     * The turn the command started, for example the compaction turn of /compact.
+     * @nullable
+     */
+    turnId: string | null;
+    /** Set by /status. */
+    status: StatusReportResource | null;
 }
-export type WaitResourceKind = (typeof WaitResourceKind)[keyof typeof WaitResourceKind];
-export declare const WaitResourceKind: {
-    readonly tool_approval: "tool_approval";
-    readonly user_input: "user_input";
+/**
+ * `inbox` holds the conversations nobody filed. Each caller has one per project.
+ */
+export type FolderResourceType = (typeof FolderResourceType)[keyof typeof FolderResourceType];
+export declare const FolderResourceType: {
+    readonly inbox: "inbox";
+    readonly custom: "custom";
 };
-export interface WaitResource {
-    autoResolutionMs?: number;
-    batchId?: string;
-    itemId?: string;
+/**
+ * Unarchived conversations in the folder.
+ */
+export interface FolderCountsResource {
+    /** @minimum 0 */
+    total: number;
+    /** @minimum 0 */
+    needsAction: number;
+    /** @minimum 0 */
+    running: number;
+}
+export interface FolderResource {
+    id: string;
+    /** `inbox` holds the conversations nobody filed. Each caller has one per project. */
+    type: FolderResourceType;
+    name: string;
+    counts: FolderCountsResource;
+    /** @minimum 0 */
+    orderVersion: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface FolderListResponseBody {
+    folders: FolderResource[];
+}
+export interface CreateFolderRequestBody {
+    /**
+     * @minLength 1
+     * @maxLength 64
+     */
+    name: string;
+}
+export interface UpdateFolderRequestBody {
+    /**
+     * @minLength 1
+     * @maxLength 64
+     */
+    name: string;
+}
+export interface MoveFolderRequestBody {
+    /** @nullable */
+    beforeFolderId: string | null;
+    /** @minimum 0 */
+    expectedVersion: number;
+}
+export interface PlaceThreadRequestBody {
     /** @nullable */
-    itemIds?: string[] | null;
-    kind: WaitResourceKind;
+    beforeThreadId?: string | null;
     /** @nullable */
-    questions?: Question[] | null;
-    turnId: string;
+    afterThreadId?: string | null;
+    /**
+     * The conversation's `orderVersion`.
+     * @minimum 0
+     */
+    expectedVersion: number;
 }
 /**
- * Where this step stands. At most one item is in_progress at any time.
+ * `completed` is a one-time task whose run has ended.
  */
-export type TodoResourceStatus = (typeof TodoResourceStatus)[keyof typeof TodoResourceStatus];
-export declare const TodoResourceStatus: {
-    readonly pending: "pending";
-    readonly in_progress: "in_progress";
+export type TaskResourceStatus = (typeof TaskResourceStatus)[keyof typeof TaskResourceStatus];
+export declare const TaskResourceStatus: {
+    readonly active: "active";
+    readonly paused: "paused";
     readonly completed: "completed";
+    readonly cancelled: "cancelled";
 };
-export interface TodoResource {
-    /** The same step phrased as happening now — "Installing nginx". Show this one while the item is in progress. */
-    activeForm: string;
-    /** The step as an instruction — "Install nginx". */
-    content: string;
-    /** Where this step stands. At most one item is in_progress at any time. */
-    status: TodoResourceStatus;
+export type TaskTriggerType = (typeof TaskTriggerType)[keyof typeof TaskTriggerType];
+export declare const TaskTriggerType: {
+    readonly now: "now";
+    readonly at: "at";
+    readonly interval: "interval";
+    readonly cron: "cron";
+};
+/**
+ * What happens when a run is due while the previous one is still going.
+ */
+export type TaskTriggerOverlapPolicy = (typeof TaskTriggerOverlapPolicy)[keyof typeof TaskTriggerOverlapPolicy];
+export declare const TaskTriggerOverlapPolicy: {
+    readonly skip: "skip";
+    readonly buffer_one: "buffer_one";
+};
+/**
+ * When the task runs. `type` determines which fields apply.
+ */
+export interface TaskTrigger {
+    type: TaskTriggerType;
+    /**
+     * For `at`.
+     * @nullable
+     */
+    runAt?: string | null;
+    /**
+     * For `interval`.
+     * @minimum 10
+     * @nullable
+     */
+    intervalSeconds?: number | null;
+    /**
+     * For `interval`. Runs fall on anchorAt plus whole intervals. Defaults to the creation time.
+     * @nullable
+     */
+    anchorAt?: string | null;
+    /**
+     * For `cron`. A cron expression evaluated in `timezone`, for example `0 9 * * 1-5`.
+     * @maxLength 128
+     * @nullable
+     */
+    cron?: string | null;
+    /** An IANA time zone for `cron`. */
+    timezone?: string;
+    /** What happens when a run is due while the previous one is still going. */
+    overlapPolicy?: TaskTriggerOverlapPolicy;
+    /**
+     * How late a missed run may still start, for example after a pause or an outage.
+     * @minimum 10
+     */
+    catchupSeconds?: number;
 }
-export interface DocumentResource {
-    context: ContextResource;
-    /** @nullable */
-    cursor: string | null;
-    earlier: EarlierResource | null;
+export type TaskActionType = (typeof TaskActionType)[keyof typeof TaskActionType];
+export declare const TaskActionType: {
+    readonly prompt: "prompt";
+    readonly command: "command";
+};
+/**
+ * What a run does. `type` determines which fields apply.
+ */
+export interface TaskAction {
+    type: TaskActionType;
+    /**
+     * For `prompt`. Sent to the conversation as a message from the task.
+     * @maxLength 20000
+     * @nullable
+     */
+    prompt?: string | null;
+    /**
+     * For `command`. The instance that runs it.
+     * @nullable
+     */
+    instanceId?: string | null;
+    /**
+     * For `command`. A shell command.
+     * @maxLength 20000
+     * @nullable
+     */
+    command?: string | null;
+    /**
+     * For `command`. The run fails with status timed_out after this long.
+     * @minimum 1
+     * @maximum 3600
+     */
+    timeoutSeconds?: number;
+}
+export type TaskRunResourceStatus = (typeof TaskRunResourceStatus)[keyof typeof TaskRunResourceStatus];
+export declare const TaskRunResourceStatus: {
+    readonly queued: "queued";
+    readonly running: "running";
+    readonly completed: "completed";
+    readonly failed: "failed";
+    readonly cancelled: "cancelled";
+    readonly timed_out: "timed_out";
+};
+export interface TaskRunResource {
+    id: string;
+    taskId: string;
+    status: TaskRunResourceStatus;
     /** @nullable */
-    items: ItemResource[] | null;
-    status: string;
-    stream: StreamResource | null;
-    turn: TurnResource | null;
-    /** The assistant's checklist for the work in this conversation, in the order it intends to do it. Empty when it has not written one — short tasks do not get a list. It is rewritten in full each time, so what is here is the current state. */
-    todos?: TodoResource[];
+    startedAt: string | null;
     /** @nullable */
-    turnId: string | null;
-    wait: WaitResource | null;
+    finishedAt: string | null;
+    /**
+     * For commands. Null until the command exits.
+     * @nullable
+     */
+    exitCode: number | null;
+    /**
+     * The last 16 KiB of a command's output. Empty for prompts; null in lists, read the run for it.
+     * @nullable
+     */
+    output: string | null;
+    /**
+     * Why the run failed. Null unless status is failed.
+     * @nullable
+     */
+    errorCode: string | null;
 }
-export type UpdateThreadRequestBodyApprovalMode = (typeof UpdateThreadRequestBodyApprovalMode)[keyof typeof UpdateThreadRequestBodyApprovalMode];
-export declare const UpdateThreadRequestBodyApprovalMode: {
-    readonly guardian: "guardian";
-    readonly manual: "manual";
-    readonly yolo: "yolo";
-};
-export interface UpdateThreadRequestBody {
-    approvalMode?: UpdateThreadRequestBodyApprovalMode;
-    archived?: boolean;
+export interface TaskResource {
+    id: string;
+    /** The conversation the task reports to. */
+    threadId: string;
+    name: string;
+    /** `completed` is a one-time task whose run has ended. */
+    status: TaskResourceStatus;
+    trigger: TaskTrigger;
+    action: TaskAction;
     /**
-     * Switch this existing conversation's model. Omit to keep the preference; null clears it and follows the platform default; a string sets it for the next turn. The transcript is preserved and saving the preference does not start a turn.
-     *
-     * Non-null requires allowModelSelection. A disallowed, retired or removed Canopy id is retained and uses the default when needed. The preference can be changed while a turn is running or waiting, but that turn and messages queued into it keep their captured model choices.
-     * @minLength 1
-     * @maxLength 128
+     * When the trigger starts the next run. Null when it will not.
      * @nullable
      */
-    preferredModelId?: string | null;
+    nextRunAt: string | null;
+    lastRun: TaskRunResource | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateTaskRequestBody {
     /**
-     * File this conversation into a folder, or `null` to take it out of the one it is in. Omit the field to leave it where it is.
-     *
-     * Filing does not move the conversation in the list. The order answers "which conversation has something new in it", and putting one away is not that.
+     * @minLength 1
      * @maxLength 64
-     * @nullable
      */
-    folderId?: string | null;
+    threadId: string;
     /**
-     * Rename this conversation.
-     *
-     * A conversation names itself: the first message gives it a working title, and the assistant replaces that with a better one once it has answered. Setting this stops both — a name somebody chose is never overwritten by one that was generated.
-     *
-     * Renaming does not move the conversation in the list. The order answers "which conversation has something new in it", and editing a title is not that.
      * @minLength 1
-     * @maxLength 255
+     * @maxLength 128
      */
-    title?: string;
+    name: string;
+    trigger: TaskTrigger;
+    action: TaskAction;
 }
-export interface DecideRequestBody {
-    approved: boolean;
-    reason?: string;
+export interface UpdateTaskRequestBody {
+    /**
+     * @minLength 1
+     * @maxLength 128
+     */
+    name?: string;
+    trigger?: TaskTrigger;
+    action?: TaskAction;
+}
+export type SearchTasksRequestBodyStatus = (typeof SearchTasksRequestBodyStatus)[keyof typeof SearchTasksRequestBodyStatus];
+export declare const SearchTasksRequestBodyStatus: {
+    readonly active: "active";
+    readonly paused: "paused";
+    readonly completed: "completed";
+    readonly cancelled: "cancelled";
+};
+export type SearchTasksRequestBodyTriggerType = (typeof SearchTasksRequestBodyTriggerType)[keyof typeof SearchTasksRequestBodyTriggerType];
+export declare const SearchTasksRequestBodyTriggerType: {
+    readonly now: "now";
+    readonly at: "at";
+    readonly interval: "interval";
+    readonly cron: "cron";
+};
+export type SearchTasksRequestBodyActionType = (typeof SearchTasksRequestBodyActionType)[keyof typeof SearchTasksRequestBodyActionType];
+export declare const SearchTasksRequestBodyActionType: {
+    readonly prompt: "prompt";
+    readonly command: "command";
+};
+export interface SearchTasksRequestBody {
+    /**
+     * Only the tasks that report to this conversation.
+     * @maxLength 64
+     */
+    threadId?: string;
+    status?: SearchTasksRequestBodyStatus;
+    triggerType?: SearchTasksRequestBodyTriggerType;
+    actionType?: SearchTasksRequestBodyActionType;
+    /** @maxLength 1024 */
+    cursor?: string;
+    /**
+     * @minimum 1
+     * @maximum 200
+     */
+    limit?: number;
+}
+export interface TaskListResponseBody {
+    tasks: TaskResource[];
+    /** @nullable */
+    nextCursor: string | null;
+}
+export interface TaskRunListResponseBody {
+    runs: TaskRunResource[];
+    /** @nullable */
+    nextCursor: string | null;
+}
+/**
+ * `user` when it is the caller's choice, `catalog` when it comes from the Canopy catalogue.
+ */
+export type DefaultModelResourceSource = (typeof DefaultModelResourceSource)[keyof typeof DefaultModelResourceSource];
+export declare const DefaultModelResourceSource: {
+    readonly user: "user";
+    readonly catalog: "catalog";
+};
+/**
+ * The model and effort a new conversation gets when it names none.
+ */
+export interface DefaultModelResource {
+    /**
+     * Null when the catalogue has no model that can run an agent.
+     * @nullable
+     */
+    modelId: string | null;
+    reasoningEffort: ReasoningEffort | null;
+    /** `user` when it is the caller's choice, `catalog` when it comes from the Canopy catalogue. */
+    source: DefaultModelResourceSource;
+}
+export interface SettingsResource {
+    /**
+     * The caller's choice. Null when none is set.
+     * @nullable
+     */
+    defaultModelId: string | null;
+    /** The caller's choice. Null when none is set. */
+    defaultReasoningEffort: ReasoningEffort | null;
+    defaultModel: DefaultModelResource;
+}
+export interface UpdateSettingsRequestBody {
+    /**
+     * @minLength 1
+     * @maxLength 128
+     * @nullable
+     */
+    defaultModelId?: string | null;
+    defaultReasoningEffort?: ReasoningEffort | null;
+}
+export interface RealtimeTicketResource {
+    /** The WebSocket address, absolute or relative to the API origin. */
+    url: string;
+    ticket: string;
+    expiresAt: string;
+}
+export type RealtimeClientMessageType = (typeof RealtimeClientMessageType)[keyof typeof RealtimeClientMessageType];
+export declare const RealtimeClientMessageType: {
+    readonly subscribe: "subscribe";
+    readonly unsubscribe: "unsubscribe";
+    readonly ping: "ping";
+};
+/**
+ * A message from the client. `type` determines which fields apply.
+ */
+export interface RealtimeClientMessage {
+    type: RealtimeClientMessageType;
+    /**
+     * `workspace` or `thread:{id}`. For subscribe and unsubscribe.
+     * @maxLength 128
+     */
+    topic?: string;
+    /**
+     * For a `thread:{id}` subscription, the `streamCursor` to replay from.
+     * @maxLength 128
+     */
+    cursor?: string;
+}
+export type RealtimeServerMessageType = (typeof RealtimeServerMessageType)[keyof typeof RealtimeServerMessageType];
+export declare const RealtimeServerMessageType: {
+    readonly subscribed: "subscribed";
+    readonly unsubscribed: "unsubscribed";
+    readonly threadupdated: "thread.updated";
+    readonly threaddeleted: "thread.deleted";
+    readonly turnupdated: "turn.updated";
+    readonly folderupdated: "folder.updated";
+    readonly folderdeleted: "folder.deleted";
+    readonly taskupdated: "task.updated";
+    readonly taskdeleted: "task.deleted";
+    readonly itemframe: "item.frame";
+    readonly resync: "resync";
+    readonly error: "error";
+    readonly pong: "pong";
+};
+export type ItemFrameOp = (typeof ItemFrameOp)[keyof typeof ItemFrameOp];
+export declare const ItemFrameOp: {
+    readonly add: "add";
+    readonly set: "set";
+    readonly append: "append";
+};
+/**
+ * An edit to the transcript as returned by list-thread-items. `path` is a JSON Pointer under
+ * `/items`: `add` appends `value` to `/items` or replaces the item with the same id, `set`
+ * replaces the value at `path`, and `append` concatenates the string `value` to the string at
+ * `path`, which is how answer text streams in.
+ */
+export interface ItemFrame {
+    path: string;
+    op: ItemFrameOp;
+    value: unknown;
+}
+/**
+ * A message from the server. `type` determines which fields apply:
+ *
+ * - `subscribed` / `unsubscribed` — `topic`
+ * - `thread.updated` — `thread`; `thread.deleted` — `threadId`
+ * - `turn.updated` — `turn`, sent while a turn runs so its usage can be shown live
+ * - `folder.updated` — `folder`; `folder.deleted` — `folderId`
+ * - `task.updated` — `task`; `task.deleted` — `taskId`
+ * - `item.frame` — `threadId`, `cursor` and `frame`, an edit to the transcript
+ * - `resync` — `topic`; the client lost events and reads the current state again
+ * - `error` — `code` and `message`
+ * - `pong`
+ */
+export interface RealtimeServerMessage {
+    type: RealtimeServerMessageType;
+    topic?: string;
+    thread?: ThreadResource;
+    threadId?: string;
+    turn?: ThreadTurnResource;
+    folder?: FolderResource;
+    folderId?: string;
+    task?: TaskResource;
+    taskId?: string;
+    /** For `item.frame`. Resubscribe from this cursor to continue after a reconnect. */
+    cursor?: string;
+    frame?: ItemFrame;
+    code?: string;
+    message?: string;
+}
+/**
+ * Both directions of the WebSocket protocol, for code generation.
+ */
+export interface RealtimeExchange {
+    client: RealtimeClientMessage;
+    server: RealtimeServerMessage;
+}
+/**
+ * How the assistant will see this file.
+ *
+ * - `image` — read directly, and only by models that accept image input
+ * - `text` — placed inline in the message when small enough, otherwise read on demand
+ * - `binary` — never read directly; the assistant downloads it onto a cloud instance to work with it
+ */
+export type UploadedResourceType = (typeof UploadedResourceType)[keyof typeof UploadedResourceType];
+export declare const UploadedResourceType: {
+    readonly image: "image";
+    readonly text: "text";
+    readonly binary: "binary";
+};
+export interface UploadedResource {
+    /** Size of what was stored. For an image that has been resized, this is the resized size, not what was uploaded. */
+    byteSize: number;
+    /**
+     * When this upload gets cleared if no message ever references it. Sending a message with this id makes it permanent and this stops applying — a file that belongs to a conversation is kept as long as the conversation is.
+     *
+     * It is here so the editor can say so before it happens. An attachment chip that quietly stops working a week later reads as a bug, and the person who hits it has no way to tell that what they are seeing is a draft being collected.
+     */
+    draftExpiresAt: string;
+    filename: string;
+    /**
+     * Null unless type is image.
+     * @nullable
+     */
+    height: number | null;
+    id: string;
+    /**
+     * How the assistant will see this file.
+     *
+     * - `image` — read directly, and only by models that accept image input
+     * - `text` — placed inline in the message when small enough, otherwise read on demand
+     * - `binary` — never read directly; the assistant downloads it onto a cloud instance to work with it
+     */
+    type: UploadedResourceType;
+    /**
+     * Null unless type is image.
+     * @nullable
+     */
+    width: number | null;
+}
+export interface UploadConfigurationResource {
+    enabled: boolean;
+    policyId: string;
+    maxFileBytes: number;
+    maxImageBytes: number;
+    partSizeBytes: number;
+    expirySeconds: number;
+}
+export interface UploadPartResource {
+    number: number;
+    byteSize: number;
+    etag: string;
+}
+export interface UploadResource {
+    id: string;
+    filename: string;
+    byteSize: number;
+    partSizeBytes: number;
+    policyId: string;
+    expiresAt: string;
+    status: string;
+    /** @nullable */
+    attachmentId: string | null;
+    parts: UploadPartResource[];
+}
+export interface UploadListResponseBody {
+    uploads: UploadResource[];
+}
+export interface CreateUploadRequestBody {
+    /**
+     * @minLength 1
+     * @maxLength 64
+     */
+    requestId: string;
+    /**
+     * @minLength 1
+     * @maxLength 255
+     */
+    filename: string;
+    byteSize: number;
+    policyId: string;
+    maxFileBytes: number;
+    partSizeBytes: number;
+}
+export interface UpdateUploadRequestBody {
+    /**
+     * @minLength 1
+     * @maxLength 255
+     */
+    filename: string;
+}
+export interface CompleteUploadRequestBody {
+    policyId: string;
+}
+export interface MemoryResource {
+    /** The fact itself */
+    body: string;
+    createdAt: string;
+    id: string;
+    /** The name the assistant gave this fact; it overwrites or deletes its own entries by that name */
+    name: string;
+    /** Which conversation the assistant learned it in. That conversation may since have been deleted */
+    sourceThreadId?: string;
+    updatedAt: string;
+}
+export interface MemoryListResponseBody {
+    items: MemoryResource[];
+}
+/**
+ * Path to contents, `SKILL.md` among them. Only returned by `get-skill`; the list leaves it out.
+ * @nullable
+ */
+export type SkillResourceFiles = {
+    [key: string]: string;
+} | null;
+/**
+ * `builtin` — provided by the platform and read-only here.
+ * `project` — written for this project and editable by anyone in it.
+ */
+export type SkillResourceOrigin = (typeof SkillResourceOrigin)[keyof typeof SkillResourceOrigin];
+export declare const SkillResourceOrigin: {
+    readonly builtin: "builtin";
+    readonly project: "project";
+};
+export interface SkillResource {
+    /**
+     * True when the assistant wrote this skill during a conversation rather than a person
+     * writing it here.
+     *
+     * Which conversation is deliberately not returned: skills are shared across the project
+     * while conversations belong to one person, so naming one would tell everybody in the
+     * project that a particular colleague had it.
+     */
+    authoredByAssistant: boolean;
+    /** Why the assistant would open this skill. It sits in every request, so it is the one field worth writing carefully. */
+    description: string;
+    enabled: boolean;
+    /**
+     * Path to contents, `SKILL.md` among them. Only returned by `get-skill`; the list leaves it out.
+     * @nullable
+     */
+    files?: SkillResourceFiles;
+    name: string;
+    /**
+     * `builtin` — provided by the platform and read-only here.
+     * `project` — written for this project and editable by anyone in it.
+     */
+    origin: SkillResourceOrigin;
+    /** @nullable */
+    shortDescription: string | null;
+    /**
+     * Null for built-in skills, which have no edit history here.
+     * @nullable
+     */
+    updatedAt: string | null;
+}
+export interface SkillListResponseBody {
+    skills: SkillResource[];
+}
+/**
+ * Path to contents. `SKILL.md` is required; anything else it references goes alongside it.
+ *
+ * Paths are relative to the skill and cannot leave it. At most 32 files, 256 KiB each and
+ * 1 MiB in total.
+ */
+export type SkillRequestBodyFiles = {
+    [key: string]: string;
+};
+export interface SkillRequestBody {
+    /**
+     * Why the assistant would open this skill. It sits in every request; write it as the answer to "when do I need this", not "what does it contain".
+     * @minLength 1
+     * @maxLength 1024
+     */
+    description: string;
+    enabled?: boolean;
+    /**
+     * Path to contents. `SKILL.md` is required; anything else it references goes alongside it.
+     *
+     * Paths are relative to the skill and cannot leave it. At most 32 files, 256 KiB each and
+     * 1 MiB in total.
+     */
+    files: SkillRequestBodyFiles;
+    /**
+     * Also how the assistant refers to it, so renaming is deleting and writing again.
+     * @minLength 1
+     * @maxLength 64
+     */
+    name: string;
+    /** @maxLength 1024 */
+    shortDescription?: string;
+}
+export interface SkillEnabledRequestBody {
+    enabled: boolean;
+}
+export type BindingResourceConnectionStatus = (typeof BindingResourceConnectionStatus)[keyof typeof BindingResourceConnectionStatus];
+export declare const BindingResourceConnectionStatus: {
+    readonly logged_out: "logged_out";
+    readonly qr_pending: "qr_pending";
+    readonly online: "online";
+    readonly expired: "expired";
+};
+export type BindingResourceStatus = (typeof BindingResourceStatus)[keyof typeof BindingResourceStatus];
+export declare const BindingResourceStatus: {
+    readonly pending: "pending";
+    readonly active: "active";
+    readonly revoked: "revoked";
+};
+export interface BindingResource {
+    channelId: string;
+    connectionStatus: BindingResourceConnectionStatus;
+    createdAt: string;
+    id: string;
+    peerName: string;
+    platform: string;
+    status: BindingResourceStatus;
+    /** @nullable */
+    verifiedAt: string | null;
+}
+export interface LengthAwarePageBindingResource {
+    /** The entries on this page */
+    items: BindingResource[];
+    /** The page size, echoing what was requested */
+    limit: number;
+    /** How many were skipped, echoing what was requested */
+    offset: number;
+    /** How many match in total, not just on this page */
+    total: number;
+}
+/**
+ * How far this channel is from working. Only `online` receives messages and can issue binding codes
+ */
+export type ChannelResourceConnectionStatus = (typeof ChannelResourceConnectionStatus)[keyof typeof ChannelResourceConnectionStatus];
+export declare const ChannelResourceConnectionStatus: {
+    readonly logged_out: "logged_out";
+    readonly qr_pending: "qr_pending";
+    readonly online: "online";
+    readonly expired: "expired";
+};
+/**
+ * The state of the long-lived connection right now. Always `stopped` for webhook platforms
+ */
+export type ChannelResourceRuntimeStatus = (typeof ChannelResourceRuntimeStatus)[keyof typeof ChannelResourceRuntimeStatus];
+export declare const ChannelResourceRuntimeStatus: {
+    readonly stopped: "stopped";
+    readonly running: "running";
+};
+export type ChannelResourceSenderPolicy = (typeof ChannelResourceSenderPolicy)[keyof typeof ChannelResourceSenderPolicy];
+export declare const ChannelResourceSenderPolicy: {
+    readonly bound_only: "bound_only";
+    readonly open: "open";
+};
+export type ChannelResourceStatus = (typeof ChannelResourceStatus)[keyof typeof ChannelResourceStatus];
+export declare const ChannelResourceStatus: {
+    readonly active: "active";
+    readonly suspended: "suspended";
+    readonly disabled: "disabled";
+};
+export interface ChannelResource {
+    /** @nullable */
+    allowFrom: string[] | null;
+    /** How far this channel is from working. Only `online` receives messages and can issue binding codes */
+    connectionStatus: ChannelResourceConnectionStatus;
+    createdAt: string;
+    id: string;
+    name: string;
+    platform: string;
+    /** The state of the long-lived connection right now. Always `stopped` for webhook platforms */
+    runtimeStatus: ChannelResourceRuntimeStatus;
+    senderPolicy: ChannelResourceSenderPolicy;
+    status: ChannelResourceStatus;
+    updatedAt: string;
+    /** The webhook path, for gateway configuration and for diagnosis */
+    webhookPath: string;
+    /**
+     * The webhook address to paste into that platform's console. Null when the deployment declares no public entry point
+     * @nullable
+     */
+    webhookUrl: string | null;
+}
+export interface LengthAwarePageChannelResource {
+    /** The entries on this page */
+    items: ChannelResource[];
+    /** The page size, echoing what was requested */
+    limit: number;
+    /** How many were skipped, echoing what was requested */
+    offset: number;
+    /** How many match in total, not just on this page */
+    total: number;
+}
+/**
+ * Credentials for that platform. Write-only: they cannot be read back after creation
+ */
+export type CreateChannelRequestBodyCredentials = {
+    [key: string]: string;
+};
+export type CreateChannelRequestBodySenderPolicy = (typeof CreateChannelRequestBodySenderPolicy)[keyof typeof CreateChannelRequestBodySenderPolicy];
+export declare const CreateChannelRequestBodySenderPolicy: {
+    readonly bound_only: "bound_only";
+    readonly open: "open";
+};
+export interface CreateChannelRequestBody {
+    /** @nullable */
+    allowFrom?: string[] | null;
+    /** Credentials for that platform. Write-only: they cannot be read back after creation */
+    credentials?: CreateChannelRequestBodyCredentials;
+    /**
+     * @minLength 1
+     * @maxLength 128
+     */
+    name: string;
+    /** @minLength 1 */
+    platform: string;
+    senderPolicy?: CreateChannelRequestBodySenderPolicy;
+    /** Required for platforms that generate the secret themselves (secretSource=supplied). Must be absent for `generated` ones, where the secret we make is returned once in webhookSecret on this response */
+    webhookSecret?: string;
+}
+/**
+ * How far this channel is from working. Only `online` receives messages and can issue binding codes
+ */
+export type ChannelWithSecretResponseBodyConnectionStatus = (typeof ChannelWithSecretResponseBodyConnectionStatus)[keyof typeof ChannelWithSecretResponseBodyConnectionStatus];
+export declare const ChannelWithSecretResponseBodyConnectionStatus: {
+    readonly logged_out: "logged_out";
+    readonly qr_pending: "qr_pending";
+    readonly online: "online";
+    readonly expired: "expired";
+};
+/**
+ * The state of the long-lived connection right now. Always `stopped` for webhook platforms
+ */
+export type ChannelWithSecretResponseBodyRuntimeStatus = (typeof ChannelWithSecretResponseBodyRuntimeStatus)[keyof typeof ChannelWithSecretResponseBodyRuntimeStatus];
+export declare const ChannelWithSecretResponseBodyRuntimeStatus: {
+    readonly stopped: "stopped";
+    readonly running: "running";
+};
+export type ChannelWithSecretResponseBodySenderPolicy = (typeof ChannelWithSecretResponseBodySenderPolicy)[keyof typeof ChannelWithSecretResponseBodySenderPolicy];
+export declare const ChannelWithSecretResponseBodySenderPolicy: {
+    readonly bound_only: "bound_only";
+    readonly open: "open";
+};
+export type ChannelWithSecretResponseBodyStatus = (typeof ChannelWithSecretResponseBodyStatus)[keyof typeof ChannelWithSecretResponseBodyStatus];
+export declare const ChannelWithSecretResponseBodyStatus: {
+    readonly active: "active";
+    readonly suspended: "suspended";
+    readonly disabled: "disabled";
+};
+export interface ChannelWithSecretResponseBody {
+    /** @nullable */
+    allowFrom: string[] | null;
+    /** How far this channel is from working. Only `online` receives messages and can issue binding codes */
+    connectionStatus: ChannelWithSecretResponseBodyConnectionStatus;
+    createdAt: string;
+    id: string;
+    name: string;
+    platform: string;
+    /** The state of the long-lived connection right now. Always `stopped` for webhook platforms */
+    runtimeStatus: ChannelWithSecretResponseBodyRuntimeStatus;
+    senderPolicy: ChannelWithSecretResponseBodySenderPolicy;
+    status: ChannelWithSecretResponseBodyStatus;
+    updatedAt: string;
+    /** The webhook path, for gateway configuration and for diagnosis */
+    webhookPath: string;
+    /**
+     * The webhook secret we generated, to paste into that platform's console. **It cannot be retrieved again** — the only way forward is rotating to a new one. Null when the platform generates the secret (secretSource=supplied) or does not use webhooks at all
+     * @nullable
+     */
+    webhookSecret: string | null;
+    /**
+     * The webhook address to paste into that platform's console. Null when the deployment declares no public entry point
+     * @nullable
+     */
+    webhookUrl: string | null;
+}
+/**
+ * Replaced wholesale rather than merged key by key. Absent means unchanged
+ */
+export type UpdateChannelRequestBodyCredentials = {
+    [key: string]: string;
+};
+/**
+ * Only when this is sent is allowFrom replaced along with it
+ */
+export type UpdateChannelRequestBodySenderPolicy = (typeof UpdateChannelRequestBodySenderPolicy)[keyof typeof UpdateChannelRequestBodySenderPolicy];
+export declare const UpdateChannelRequestBodySenderPolicy: {
+    readonly bound_only: "bound_only";
+    readonly open: "open";
+};
+export interface UpdateChannelRequestBody {
+    /**
+     * The allow list. Only applied when senderPolicy is sent as well
+     * @nullable
+     */
+    allowFrom?: string[] | null;
+    /** Replaced wholesale rather than merged key by key. Absent means unchanged */
+    credentials?: UpdateChannelRequestBodyCredentials;
+    enabled?: boolean;
+    /** @maxLength 128 */
+    name?: string;
+    /** Only when this is sent is allowFrom replaced along with it */
+    senderPolicy?: UpdateChannelRequestBodySenderPolicy;
+}
+export interface BindingCodeResponseBody {
+    code: string;
+    expiresAt: string;
+}
+export interface RejectionResource {
+    at: string;
+    peerId: string;
+    peerName: string;
+    peerUsername: string;
+    platform: string;
+    textLength: number;
+    verdict: string;
+}
+export interface RejectionListResponseBody {
+    /** @nullable */
+    rejections: RejectionResource[] | null;
+}
+export interface RotateSecretRequestBody {
+    /** Required for platforms that generate the secret themselves (secretSource=supplied). Must be absent for `generated` ones */
+    webhookSecret?: string;
+}
+export interface WebhookSecretResponseBody {
+    webhookSecret: string;
+}
+export type SenderCheckResourceVerdict = (typeof SenderCheckResourceVerdict)[keyof typeof SenderCheckResourceVerdict];
+export declare const SenderCheckResourceVerdict: {
+    readonly ALLOWED_BY_BINDING: "ALLOWED_BY_BINDING";
+    readonly ALLOWED_BY_ALLOW_FROM: "ALLOWED_BY_ALLOW_FROM";
+    readonly ALLOWED_BY_POLICY: "ALLOWED_BY_POLICY";
+    readonly REJECTED_NOT_ALLOWED: "REJECTED_NOT_ALLOWED";
+};
+export interface SenderCheckResource {
+    /** @nullable */
+    allowFrom: string[] | null;
+    allowed: boolean;
+    /** @nullable */
+    bindingId: string | null;
+    senderPolicy: string;
+    verdict: SenderCheckResourceVerdict;
+}
+export type LoginResourceStatus = (typeof LoginResourceStatus)[keyof typeof LoginResourceStatus];
+export declare const LoginResourceStatus: {
+    readonly wait: "wait";
+    readonly scanned: "scanned";
+    readonly confirmed: "confirmed";
+    readonly expired: "expired";
+    readonly error: "error";
+    readonly need_verify_code: "need_verify_code";
+};
+export interface LoginResource {
+    /** When this login flow expires. Past that, stop polling and start a new one */
+    expiresAt: string;
+    id: string;
+    /** The text to encode and render as a QR code by the client — not an image address and not a data URI. When a code expires this flow issues another and keeps waiting, so each poll may return a new string */
+    qrcodeData: string;
+    /** Why it failed. Present only when status is error or expired */
+    reason: string;
+    status: LoginResourceStatus;
+}
+export interface CredentialFieldResource {
+    help: string;
+    key: string;
+    label: string;
+    required: boolean;
+    secret: boolean;
 }
-export interface EarlierResponseBody {
-    earlier: EarlierResource;
+export type PlatformResourceSecretSource = (typeof PlatformResourceSecretSource)[keyof typeof PlatformResourceSecretSource];
+export declare const PlatformResourceSecretSource: {
+    readonly generated: "generated";
+    readonly supplied: "supplied";
+    readonly none: "none";
+};
+export type PlatformResourceSetupChallenge = (typeof PlatformResourceSetupChallenge)[keyof typeof PlatformResourceSetupChallenge];
+export declare const PlatformResourceSetupChallenge: {
+    readonly none: "none";
+    readonly webhook: "webhook";
+    readonly scan: "scan";
+};
+export type PlatformResourceSetupMethod = (typeof PlatformResourceSetupMethod)[keyof typeof PlatformResourceSetupMethod];
+export declare const PlatformResourceSetupMethod: {
+    readonly credentials: "credentials";
+    readonly scan: "scan";
+};
+export interface PlatformResource {
     /** @nullable */
-    items: ItemResource[] | null;
-}
-/**
- * The MCP and Anthropic spelling of `parameters`. Give one or the other, not both.
- * @nullable
- */
-export type ClientFunctionRequestInputSchema = {
-    [key: string]: unknown;
-} | null;
-/**
- * JSON Schema for the arguments. Omit for an action that takes none.
- * @nullable
- */
-export type ClientFunctionRequestParameters = {
-    [key: string]: unknown;
-} | null;
-/**
- * The function object from the OpenAI tools format.
- */
-export interface ClientFunctionRequest {
-    /**
-     * What the action does, written for the model. An action without one can only be guessed at from its name. The 1024 ceiling is OpenAI's own limit on `tools[].function.description`, not a number chosen here: over it the upstream call fails with `string_above_max_length`, and refusing at submission is the clearer of the two places to refuse. It was 500, which ran out at about six enumerated entries — an action that must list what it accepts had nowhere to put the list.
-     * @minLength 1
-     * @maxLength 1024
-     */
-    description: string;
-    /**
-     * The MCP and Anthropic spelling of `parameters`. Give one or the other, not both.
-     * @nullable
-     */
-    inputSchema?: ClientFunctionRequestInputSchema;
-    /**
-     * @minLength 1
-     * @maxLength 64
-     */
+    credentialFields: CredentialFieldResource[] | null;
     name: string;
+    resident: boolean;
+    secretSource: PlatformResourceSecretSource;
+    setupChallenge: PlatformResourceSetupChallenge;
+    setupMethod: PlatformResourceSetupMethod;
+    /** The webhook path template; {channel} is replaced with the channel id */
+    webhookPath: string;
     /**
-     * JSON Schema for the arguments. Omit for an action that takes none.
+     * The full webhook address template. Null when the deployment declares no public entry point
      * @nullable
      */
-    parameters?: ClientFunctionRequestParameters;
+    webhookUrlTemplate: string | null;
 }
-/**
- * Only functions are supported.
- */
-export type ClientActionRequestType = (typeof ClientActionRequestType)[keyof typeof ClientActionRequestType];
-export declare const ClientActionRequestType: {
-    readonly function: "function";
-};
-/**
- * The shape of a tool in the OpenAI Chat Completions API, plus `readOnly` and `timeoutMs`.
- */
-export interface ClientActionRequest {
-    function: ClientFunctionRequest;
-    /** True when the action changes nothing outside the client. Anything else goes through this conversation's approval before it runs. */
-    readOnly: boolean;
-    /**
-     * How long the assistant should wait for this action. Omit for the default; longer values are capped.
-     * @minimum 0
-     */
-    timeoutMs?: number;
-    /** Only functions are supported. */
-    type?: ClientActionRequestType;
+export interface PlatformListResponseBody {
+    /** @nullable */
+    platforms: PlatformResource[] | null;
 }
-/**
- * Which client this is and what it can do, so the assistant can ask it to do those things
- * while it answers. What the operator is looking at travels as `data-*` parts on the message.
- *
- * Send `actions` only when they differ from the last message on this conversation. Sending the
- * block without `actions` keeps whatever was declared before.
- */
-export interface ClientContextRequest {
-    /**
-     * The actions on offer right now.
-     *
-     * Omit it when nothing changed since the last message. Send `[]` to say there is nothing
-     * on offer — those are different: a client that moves off the page it was attached to has
-     * to be able to say so, or the assistant keeps calling actions that no longer make sense.
-     * @maxItems 32
-     * @nullable
-     */
-    actions?: ClientActionRequest[] | null;
-    /**
-     * Identifies this client while it stays open. Any stable string; one per tab or process.
-     * @minLength 1
-     * @maxLength 128
-     */
-    clientId: string;
-    /**
-     * How the client calls itself, for example "Leaflow console (web)".
-     * @maxLength 64
-     */
-    label?: string;
+export interface VerifyCodeRequestBody {
+    /** @minLength 1 */
+    code: string;
 }
 /**
- * For `data-*` parts. Any object; its keys reach the assistant as they are.
- * @nullable
- */
-export type MessagePartData = {
-    [key: string]: unknown;
-} | null;
-/**
- * One piece of a message. `type` says which of the fields below carries it:
- *
- * - `text` — the words, in `text`
- * - `file` — an attachment uploaded earlier, by id in `attachmentId`
- * - `data-<something>` — context from the client, in `data`. The name after `data-` is yours;
- *   it is shown to the assistant so it can tell one kind of block from another.
- *
- * Order matters: an attachment belongs where it was written, not at the end.
+ * Error
  */
-export interface MessagePart {
+export type ErrorResponse = Error;
+export type ListThreadItemsParams = {
     /**
-     * For `file` parts. The attachment must have been uploaded and not yet bound to another message.
-     * @nullable
+     * Return the window ending just above this ordinal.
+     * @minimum 0
      */
-    attachmentId?: string | null;
+    before?: number;
     /**
-     * For `data-*` parts. Any object; its keys reach the assistant as they are.
-     * @nullable
+     * Return the window starting just below this ordinal.
+     * @minimum 0
      */
-    data?: MessagePartData;
+    after?: number;
     /**
-     * For `text` parts.
-     * @nullable
+     * Return a window containing this ordinal. Only one of before, after and around may be given.
+     * @minimum 0
      */
-    text?: string | null;
+    around?: number;
     /**
-     * @minLength 1
-     * @maxLength 64
+     * How many turns a window holds at most.
+     * @minimum 1
+     * @maximum 50
      */
-    type: string;
-}
-export interface SendMessageRequestBody {
-    client?: ClientContextRequest;
+    turns?: number;
+};
+export type ListThreadTurnsParams = {
     /**
-     * The message, in the order it was written. A message with nothing but text is a single
-     * text part; that is the ordinary case and nothing else is required.
      * @minItems 1
+     * @maxItems 200
      */
-    parts: MessagePart[];
-}
-export interface MemoryResource {
-    /** The fact itself */
-    body: string;
-    createdAt: string;
-    id: string;
-    /** The name the assistant gave this fact; it overwrites or deletes its own entries by that name */
-    name: string;
-    /** Which conversation the assistant learned it in. That conversation may since have been deleted */
-    sourceThreadId?: string;
-    updatedAt: string;
-}
-export interface MemoryListResponseBody {
-    items: MemoryResource[];
-}
-export interface DynamicCallResultRequestBody {
+    ids?: string[];
     /**
-     * The same value sent with the message. A result from a different client is refused.
+     * The next_cursor returned by the previous page. Omit it for the first page.
      * @minLength 1
+     * @maxLength 1024
      */
-    clientId: string;
-    /**
-     * Why it failed, when `ok` is false. It reaches the assistant, so write it for a reader who cannot see the screen.
-     * @maxLength 2000
-     */
-    error?: string;
+    cursor?: string;
     /**
-     * Pass back when there is more to read. The assistant will call again with it.
-     * @maxLength 500
+     * Items returned in this page. Defaults to 50; at most 200.
+     * @minimum 1
+     * @maximum 200
      */
-    nextCursor?: string;
-    ok: boolean;
-    /** What the action produced. At most 64 KiB; use `nextCursor` for anything larger. */
-    output?: string;
-}
-export interface TurnIDResponseBody {
-    /** True when the assistant was already busy and this message was put in line instead of starting a turn. It is read at the next step of the turn already running, so there is nothing further to do — and turnId is empty in this case. */
-    queued: boolean;
-    /** How many messages were already waiting ahead of this one. Only meaningful when queued is true. */
-    queuedAhead?: number;
-    /** The turn this message started. Empty when the message was queued instead. */
-    turnId: string;
-}
-/**
- * A map from question id to the answer chosen
- */
-export type AnswerRequestBodyAnswers = {
-    [key: string]: string;
+    limit?: number;
 };
-export interface AnswerRequestBody {
-    /** A map from question id to the answer chosen */
-    answers: AnswerRequestBodyAnswers;
-}
-export interface RevertRequestBody {
-    /** The starting ordinal; that entry and everything after it is reverted */
-    ordinal: number;
-}
-export interface RevertedCountResponseBody {
-    reverted: number;
-}
-export interface FolderResource {
-    createdAt: string;
-    id: string;
-    name: string;
-    /** How many conversations are filed here and would show up in the default list. Archived and deleted ones are not counted, so this is exactly what `GET /api/v1/threads?folder=<id>` returns. */
-    threadCount: number;
-    updatedAt: string;
-}
-export interface FolderListResponseBody {
-    /** @nullable */
-    folders: FolderResource[] | null;
-}
-export interface CreateFolderRequestBody {
+export type ListTaskRunsParams = {
     /**
+     * The next_cursor returned by the previous page. Omit it for the first page.
      * @minLength 1
-     * @maxLength 64
+     * @maxLength 1024
      */
-    name: string;
-}
-export interface UpdateFolderRequestBody {
+    cursor?: string;
     /**
-     * @minLength 1
-     * @maxLength 64
+     * Items returned in this page. Defaults to 50; at most 200.
+     * @minimum 1
+     * @maximum 200
      */
-    name: string;
-}
-/**
- * Pagination metadata for stable numbered pages. total_count is returned only when the operation can determine it without an unbounded scan.
- */
-export interface OffsetPagination {
-    /** @minimum 1 */
-    page: number;
-    /** @minimum 1 */
-    page_size: number;
-    /** @minimum 0 */
-    total_count?: number;
-}
-/**
- * Pagination metadata for keyset traversal. Pass next_cursor as cursor to read the following page; null means there is no following page.
- */
-export interface CursorPagination {
-    /** @minimum 1 */
-    page_size: number;
-    /** @nullable */
-    next_cursor?: string | null;
-}
+    limit?: number;
+};
+export type OpenRealtimeParams = {
+    /**
+     * @maxLength 4096
+     */
+    ticket: string;
+};
 export type UploadAttachmentParams = {
     /**
      * The name to show and to give the assistant. Images do not need one; anything else does, because the name is most of what says what the file is. Falls back to a generated name.
@@ -1217,6 +2041,15 @@ export type UploadAttachmentParams = {
      */
     filename?: string;
 };
+export type PutUploadPartParams = {
+    policyId: string;
+};
+export type PutUploadPartHeaders = {
+    /**
+     * @minimum 1
+     */
+    "X-Part-Size": number;
+};
 export type ListBindingsParams = {
     /**
      * Items returned in this page. Defaults to 50; at most 200.
@@ -1273,38 +2106,3 @@ export type CheckSenderParams = {
      */
     username?: string;
 };
-export type ListThreadsParams = {
-    /**
-     * Search titles, case-insensitively. Empty returns the most recent conversations
-     * @maxLength 100
-     */
-    q?: string;
-    /**
-     * When true, returns **only** archived conversations; otherwise only unarchived ones
-     */
-    archived?: boolean;
-    /**
-     * A folder id, or empty for the conversations in no folder
-     * @maxLength 64
-     */
-    folder?: string;
-    /**
-     * The next_cursor returned by the previous page. Omit it for the first page.
-     * @minLength 1
-     * @maxLength 1024
-     */
-    cursor?: string;
-    /**
-     * Items returned in this page. Defaults to 50; at most 200.
-     * @minimum 1
-     * @maximum 200
-     */
-    limit?: number;
-};
-export type ListEarlierItemsParams = {
-    /**
-     * From the document's earlier.before; returns entries before this ordinal
-     * @minimum 0
-     */
-    before: number;
-};