@leaflow/sdk 0.0.0-dev.49.g6065fbb → 0.0.0-dev.494.g12e1b53

package/dist/assistant/v1/generated/schemas.zod.d.ts

@@ -0,0 +1,962 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Assistant API
+ * Conversations with agents that operate the Leaflow platform, plus their folders, tasks, files and
+ * chat-app channels.
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * Read a thread's state with get-thread and its transcript with list-thread-items. Follow both live
+ * through EventBus by subscribing to assistant.thread.frame and assistant.resource.updated; after a
+ * reconnection or an assistant.workspace.invalidated message, read them again. list-thread-messages
+ * outlines the person's messages for navigating a long conversation.
+ *
+ * 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.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
+ * OpenAPI spec version: 2.0.0
+ */
+import * as zod from "zod";
+/**
+ * Creates a conversation and, when `message` is given, sends it as the first message in the same
+ * request, so starting a task is one round trip.
+ *
+ * The model is chosen in this order: `modelId` from the request, the caller's default from
+ * /api/v1/settings, then the first model in the Canopy catalogue that can run an agent. Fails with
+ * 422 and code MODEL_UNAVAILABLE when the chosen model cannot run an agent, and with 422 and code
+ * REASONING_UNSUPPORTED when `reasoningEffort` is given for a model without reasoning.
+ *
+ * Without `message`, creating a conversation does not contact a model provider.
+ * @summary Create a conversation
+ */
+export declare const CreateThreadBody: zod.ZodObject<{
+    title: zod.ZodOptional<zod.ZodString>;
+    folderId: zod.ZodOptional<zod.ZodString>;
+    modelId: zod.ZodOptional<zod.ZodString>;
+    reasoningEffort: zod.ZodOptional<zod.ZodEnum<{
+        high: "high";
+        low: "low";
+        medium: "medium";
+    }>>;
+    approvalMode: zod.ZodOptional<zod.ZodEnum<{
+        manual: "manual";
+        guardian: "guardian";
+        yolo: "yolo";
+    }>>;
+    message: zod.ZodOptional<zod.ZodObject<{
+        parts: zod.ZodArray<zod.ZodObject<{
+            type: zod.ZodString;
+            text: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+            attachmentId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+            data: zod.ZodOptional<zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>>;
+        }, zod.z.core.$strict>>;
+        client: zod.ZodOptional<zod.ZodObject<{
+            clientId: zod.ZodString;
+            label: zod.ZodOptional<zod.ZodString>;
+            actions: zod.ZodOptional<zod.ZodNullable<zod.ZodArray<zod.ZodObject<{
+                type: zod.ZodDefault<zod.ZodEnum<{
+                    function: "function";
+                }>>;
+                function: zod.ZodObject<{
+                    name: zod.ZodString;
+                    description: zod.ZodString;
+                    parameters: zod.ZodOptional<zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>>;
+                    inputSchema: zod.ZodOptional<zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>>;
+                }, zod.z.core.$strict>;
+                readOnly: zod.ZodBoolean;
+                timeoutMs: zod.ZodOptional<zod.ZodInt>;
+            }, zod.z.core.$strict>>>>;
+        }, zod.z.core.$strict>>;
+    }, zod.z.core.$strict>>;
+}, zod.z.core.$strict>;
+/**
+ * The conversation's state: model, reasoning effort, approval mode, what it is doing now, its
+ * plan, what it is waiting for, context usage and token usage. The transcript is read separately
+ * from /items.
+ * @summary Get a conversation
+ */
+export declare const getThreadPathThreadMax = 64;
+export declare const GetThreadParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Changes the title, model, reasoning effort, approval mode, or whether the conversation is
+ * archived. Omitted fields stay as they are.
+ *
+ * Model, reasoning and approval changes apply to the next model request; a request already in
+ * flight keeps its settings. A model that cannot run an agent fails with 422 and code
+ * MODEL_UNAVAILABLE. Switching to a model without reasoning clears `reasoningEffort`.
+ *
+ * Archiving makes the conversation read-only and fails with 409 and code THREAD_RUNNING while a
+ * turn is running.
+ * @summary Update a conversation
+ */
+export declare const updateThreadPathThreadMax = 64;
+export declare const UpdateThreadParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const UpdateThreadBody: zod.ZodObject<{
+    title: zod.ZodOptional<zod.ZodString>;
+    modelId: zod.ZodOptional<zod.ZodString>;
+    reasoningEffort: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodEnum<{
+        high: "high";
+        low: "low";
+        medium: "medium";
+    }>, zod.ZodNull]>>;
+    approvalMode: zod.ZodOptional<zod.ZodEnum<{
+        manual: "manual";
+        guardian: "guardian";
+        yolo: "yolo";
+    }>>;
+    archived: zod.ZodOptional<zod.ZodBoolean>;
+}, zod.z.core.$strict>;
+/**
+ * Removes the conversation and its subagents from every list and makes them unreachable by id,
+ * including for the assistant. Deleting cannot be undone; archive instead to keep it readable.
+ *
+ * Fails with 409 and code THREAD_RUNNING while a turn is running. Deleting an already deleted
+ * conversation succeeds.
+ * @summary Delete a conversation
+ */
+export declare const deleteThreadPathThreadMax = 64;
+export declare const DeleteThreadParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Stops this conversation's running turn and discards its queued messages. Subagents keep
+ * running; stop them through their own conversations.
+ *
+ * Succeeds when nothing is running, because pressing stop races with the turn finishing on its
+ * own. Available while the project is suspended or being cleaned up.
+ * @summary Stop the running turn
+ */
+export declare const interruptThreadPathThreadMax = 64;
+export declare const InterruptThreadParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Starts a new turn that continues from where the conversation stopped, for example after it
+ * was interrupted or failed. An optional message is added first.
+ *
+ * Fails with 409 and code THREAD_RUNNING while a turn is running.
+ * @summary Resume a stopped conversation
+ */
+export declare const resumeThreadPathThreadMax = 64;
+export declare const ResumeThreadParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const ResumeThreadBody: zod.ZodObject<{
+    message: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * Starts a compaction turn that summarizes the history before the latest user message, the same
+ * way the service does automatically when the context window fills up. The result appears in the
+ * transcript as a `compaction` item and the turn reports its own token usage.
+ *
+ * Fails with 409 and code THREAD_RUNNING while a turn is running, and with 409 and code
+ * NOTHING_TO_COMPACT when there is no history to summarize.
+ * @summary Compact the conversation now
+ */
+export declare const compactThreadPathThreadMax = 64;
+export declare const CompactThreadParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Reverts the item at `ordinal` and everything after it. Reverted items stay in the transcript
+ * marked `reverted` and are left out of later model requests; ordinals are not renumbered.
+ * Executed tools and external changes are not undone. Returns how many items were reverted.
+ * @summary Revert from a given point
+ */
+export declare const revertThreadPathThreadMax = 64;
+export declare const RevertThreadParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const RevertThreadBody: zod.ZodObject<{
+    ordinal: zod.ZodInt;
+}, zod.z.core.$strict>;
+/**
+ * Clears `unread` until the assistant replies again.
+ * @summary Mark a conversation as read
+ */
+export declare const markThreadReadPathThreadMax = 64;
+export declare const MarkThreadReadParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * A window of the conversation's transcript, oldest first: messages, reasoning, tool calls and
+ * compaction markers. A window holds whole turns, so a turn's messages and tool calls arrive
+ * together; a single turn larger than the size limit is split across windows.
+ *
+ * Without a position the window ends at the latest item. `before` reads the window above an
+ * ordinal and `after` the window below it; pass `startOrdinal` and `endOrdinal` from the response.
+ * `around` opens a window that contains an ordinal, for jumping to a turn from list-thread-turns or
+ * to a search result.
+ *
+ * Long reasoning and tool arguments are cut to a preview and marked `truncated`; read the item for
+ * all of it. Messages are never cut.
+ *
+ * When the window reaches the end, `queued` holds the messages waiting for the assistant and
+ * `streamCursor` is set: subscribe to `thread:{id}` on /api/v1/realtime from it to follow what is
+ * written next.
+ * @summary List transcript items
+ */
+export declare const listThreadItemsPathThreadMax = 64;
+export declare const ListThreadItemsParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const listThreadItemsQueryBeforeMin = 0;
+export declare const listThreadItemsQueryAfterMin = 0;
+export declare const listThreadItemsQueryAroundMin = 0;
+export declare const listThreadItemsQueryTurnsDefault = 10;
+export declare const listThreadItemsQueryTurnsMax = 50;
+export declare const ListThreadItemsQueryParams: zod.ZodObject<{
+    before: zod.ZodOptional<zod.ZodInt>;
+    after: zod.ZodOptional<zod.ZodInt>;
+    around: zod.ZodOptional<zod.ZodInt>;
+    turns: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
+/**
+ * One item in full, including what list-thread-items cut from it.
+ * @summary Get a transcript item
+ */
+export declare const getThreadItemPathThreadMax = 64;
+export declare const getThreadItemPathItemMax = 64;
+export declare const GetThreadItemParams: zod.ZodObject<{
+    thread: zod.ZodString;
+    item: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * An outline of the messages the person sent in this conversation, from the console or a chat
+ * app, oldest first: what a timeline needs to place and preview every message without reading
+ * the transcript. Replies, tool calls and messages from subagents, tasks or other conversations
+ * are not included, nor are reverted messages or messages waiting in the queue.
+ *
+ * `index` is the message's position, from 1, and matches `messageIndex` on the transcript item.
+ * Read the message N with `offset` N-1. Open it in the transcript with list-thread-items
+ * `around` its `ordinal`. `total` equals the thread's `messageCount`.
+ * @summary List the person's messages
+ */
+export declare const listThreadMessagesPathThreadMax = 64;
+export declare const ListThreadMessagesParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const listThreadMessagesQueryOffsetDefault = 0;
+export declare const listThreadMessagesQueryOffsetMin = 0;
+export declare const listThreadMessagesQueryOffsetMax = 10000;
+export declare const listThreadMessagesQueryLimitDefault = 50;
+export declare const listThreadMessagesQueryLimitMax = 200;
+export declare const ListThreadMessagesQueryParams: zod.ZodObject<{
+    offset: zod.ZodDefault<zod.ZodInt>;
+    limit: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
+/**
+ * Starts a turn and returns at once; a turn can run for tens of minutes and its progress arrives
+ * on /api/v1/realtime. Sending while the assistant is working is allowed: the message is queued
+ * and read at the next step of the running turn, and `queued` is true.
+ *
+ * Fails with 409 and code THREAD_ARCHIVED for an archived conversation.
+ * @summary Send a message
+ */
+export declare const sendMessagePathThreadMax = 64;
+export declare const SendMessageParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const SendMessageBody: zod.ZodObject<{
+    parts: zod.ZodArray<zod.ZodObject<{
+        type: zod.ZodString;
+        text: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        attachmentId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        data: zod.ZodOptional<zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>>;
+    }, zod.z.core.$strict>>;
+    client: zod.ZodOptional<zod.ZodObject<{
+        clientId: zod.ZodString;
+        label: zod.ZodOptional<zod.ZodString>;
+        actions: zod.ZodOptional<zod.ZodNullable<zod.ZodArray<zod.ZodObject<{
+            type: zod.ZodDefault<zod.ZodEnum<{
+                function: "function";
+            }>>;
+            function: zod.ZodObject<{
+                name: zod.ZodString;
+                description: zod.ZodString;
+                parameters: zod.ZodOptional<zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>>;
+                inputSchema: zod.ZodOptional<zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>>;
+            }, zod.z.core.$strict>;
+            readOnly: zod.ZodBoolean;
+            timeoutMs: zod.ZodOptional<zod.ZodInt>;
+        }, zod.z.core.$strict>>>>;
+    }, zod.z.core.$strict>>;
+}, zod.z.core.$strict>;
+/**
+ * Decides the tool calls the conversation is waiting on, listed in `pendingAction.itemIds`. One
+ * decision applies to the whole batch, so `itemIds` must name exactly the calls awaiting approval.
+ *
+ * Repeating a decision that is already in effect succeeds. Fails with 409 and code
+ * APPROVAL_MISMATCH when `itemIds` is not the current batch, for example because another tab
+ * decided first and the assistant has moved on.
+ * @summary Approve or decline tool calls
+ */
+export declare const decideToolCallsPathThreadMax = 64;
+export declare const DecideToolCallsParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const DecideToolCallsBody: zod.ZodObject<{
+    itemIds: zod.ZodArray<zod.ZodString>;
+    approved: zod.ZodBoolean;
+    reason: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * Answers an `ask` tool call. Its questions are in the item's `questions`. An item that is already
+ * answered also succeeds: another tab may have answered first, or the auto-answer window may have
+ * passed, and either way the turn has continued.
+ * @summary Answer the assistant's questions
+ */
+export declare const answerQuestionPathThreadMax = 64;
+export declare const answerQuestionPathItemMax = 64;
+export declare const AnswerQuestionParams: zod.ZodObject<{
+    thread: zod.ZodString;
+    item: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const AnswerQuestionBody: zod.ZodObject<{
+    answers: zod.ZodRecord<zod.ZodString, zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * The assistant asks the client to run one of the actions it declared by writing a tool call with
+ * the namespace `client`; the client runs it when the item turns in_progress and reports here.
+ *
+ * The first result counts. A later one fails with 409 and code RESULT_ALREADY_SUBMITTED.
+ * @summary Report what a client tool produced
+ */
+export declare const submitToolResultPathThreadMax = 64;
+export declare const submitToolResultPathItemMax = 64;
+export declare const SubmitToolResultParams: zod.ZodObject<{
+    thread: zod.ZodString;
+    item: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const SubmitToolResultBody: zod.ZodObject<{
+    clientId: zod.ZodString;
+    ok: zod.ZodBoolean;
+    output: zod.ZodOptional<zod.ZodString>;
+    error: zod.ZodOptional<zod.ZodString>;
+    nextCursor: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * The conversation's turns, newest first, each with the model and reasoning effort it ran with,
+ * how long it took and the tokens it used. Cache hit rate is `cachedInputTokens / inputTokens`.
+ *
+ * Each turn names the ordinals it wrote and the message that started it, so a client can draw a
+ * timeline from this list and open a turn with list-thread-items `around`.
+ *
+ * `ids` reads the turns behind a page of transcript items in one request and cannot be combined
+ * with a cursor.
+ * @summary List turns
+ */
+export declare const listThreadTurnsPathThreadMax = 64;
+export declare const ListThreadTurnsParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const listThreadTurnsQueryIdsMax = 200;
+export declare const listThreadTurnsQueryCursorMax = 1024;
+export declare const listThreadTurnsQueryLimitDefault = 50;
+export declare const listThreadTurnsQueryLimitMax = 200;
+export declare const ListThreadTurnsQueryParams: zod.ZodObject<{
+    ids: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
+    cursor: zod.ZodOptional<zod.ZodString>;
+    limit: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
+/**
+ * A folder groups conversations on the board and does nothing else: the assistant is never told
+ * which folder a conversation is in. New folders go after the existing ones.
+ *
+ * Names are unique among the caller's folders in this project; a duplicate fails with 409 and
+ * code FOLDER_EXISTS.
+ * @summary Create a folder
+ */
+export declare const CreateFolderBody: zod.ZodObject<{
+    name: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Its conversations are read with search-threads and `folderId`.
+ * @summary Get a folder
+ */
+export declare const getFolderPathFolderMax = 64;
+export declare const GetFolderParams: zod.ZodObject<{
+    folder: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * The inbox cannot be renamed and fails with 409 and code INBOX_READ_ONLY.
+ * @summary Rename a folder
+ */
+export declare const updateFolderPathFolderMax = 64;
+export declare const UpdateFolderParams: zod.ZodObject<{
+    folder: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const UpdateFolderBody: zod.ZodObject<{
+    name: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * The conversations inside are not deleted; they move to the end of the inbox. The inbox cannot
+ * be deleted and fails with 409 and code INBOX_READ_ONLY. Deleting a folder that is already gone
+ * succeeds.
+ * @summary Delete a folder
+ */
+export declare const deleteFolderPathFolderMax = 64;
+export declare const DeleteFolderParams: zod.ZodObject<{
+    folder: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Places the folder before `beforeFolderId`, or last when it is null. The inbox stays first.
+ * Fails with 409 and code ORDER_CHANGED when `expectedVersion` is stale; read the folders again
+ * and retry.
+ * @summary Reorder a folder
+ */
+export declare const moveFolderPathFolderMax = 64;
+export declare const MoveFolderParams: zod.ZodObject<{
+    folder: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const MoveFolderBody: zod.ZodObject<{
+    beforeFolderId: zod.ZodNullable<zod.ZodString>;
+    expectedVersion: zod.ZodInt;
+}, zod.z.core.$strict>;
+/**
+ * Puts the conversation into this folder at the given position, moving it out of the folder it
+ * was in. Give `beforeThreadId` or `afterThreadId` to place it next to a conversation of this
+ * folder; with neither it goes last. Moving does not change the conversation's activity time.
+ *
+ * Subagents are not filed and fail with 409 and code SUBAGENT_NOT_FILED. Fails with 409 and code
+ * ORDER_CHANGED when `expectedVersion` is stale.
+ * @summary Place a conversation in a folder
+ */
+export declare const placeThreadPathFolderMax = 64;
+export declare const placeThreadPathThreadMax = 64;
+export declare const PlaceThreadParams: zod.ZodObject<{
+    folder: zod.ZodString;
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const PlaceThreadBody: zod.ZodObject<{
+    beforeThreadId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+    afterThreadId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+    expectedVersion: zod.ZodInt;
+}, zod.z.core.$strict>;
+/**
+ * A task does something on a trigger and reports to a conversation. Its action either sends a
+ * prompt to the conversation, which starts a turn there, or runs a command on an instance and
+ * sends the result to the conversation when it ends.
+ *
+ * `trigger.type` `now` runs once immediately; `at` runs once at `runAt`; `interval` repeats every
+ * `intervalSeconds` from `anchorAt`; `cron` repeats on a cron expression in `timezone`. Each
+ * execution is a run, listed under /runs.
+ *
+ * Fails with 404 when the conversation does not exist and with 409 and code THREAD_ARCHIVED when
+ * it is archived.
+ * @summary Create a task
+ */
+export declare const CreateTaskBody: zod.ZodObject<{
+    threadId: zod.ZodString;
+    name: zod.ZodString;
+    trigger: zod.ZodObject<{
+        type: zod.ZodEnum<{
+            at: "at";
+            now: "now";
+            interval: "interval";
+            cron: "cron";
+            event: "event";
+        }>;
+        runAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        intervalSeconds: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+        anchorAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        cron: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        timezone: zod.ZodDefault<zod.ZodString>;
+        overlapPolicy: zod.ZodDefault<zod.ZodEnum<{
+            skip: "skip";
+            buffer_one: "buffer_one";
+        }>>;
+        catchupSeconds: zod.ZodDefault<zod.ZodInt>;
+        event: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventKey: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventCondition: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        maxRuns: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+        expiresAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        cooldownSeconds: zod.ZodDefault<zod.ZodInt>;
+    }, zod.z.core.$strict>;
+    action: zod.ZodObject<{
+        type: zod.ZodEnum<{
+            prompt: "prompt";
+            command: "command";
+        }>;
+        prompt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        instanceId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        command: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        timeoutSeconds: zod.ZodDefault<zod.ZodInt>;
+    }, zod.z.core.$strict>;
+}, zod.z.core.$strict>;
+/**
+ * @summary Get a task
+ */
+export declare const getTaskPathTaskMax = 64;
+export declare const GetTaskParams: zod.ZodObject<{
+    task: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Changes the name, trigger or action. Omitted fields stay as they are; `trigger` and `action`
+ * are replaced as a whole. A run already in progress keeps the settings it started with.
+ * @summary Update a task
+ */
+export declare const updateTaskPathTaskMax = 64;
+export declare const UpdateTaskParams: zod.ZodObject<{
+    task: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const UpdateTaskBody: zod.ZodObject<{
+    name: zod.ZodOptional<zod.ZodString>;
+    trigger: zod.ZodOptional<zod.ZodObject<{
+        type: zod.ZodEnum<{
+            at: "at";
+            now: "now";
+            interval: "interval";
+            cron: "cron";
+            event: "event";
+        }>;
+        runAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        intervalSeconds: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+        anchorAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        cron: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        timezone: zod.ZodDefault<zod.ZodString>;
+        overlapPolicy: zod.ZodDefault<zod.ZodEnum<{
+            skip: "skip";
+            buffer_one: "buffer_one";
+        }>>;
+        catchupSeconds: zod.ZodDefault<zod.ZodInt>;
+        event: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventKey: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventCondition: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        maxRuns: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+        expiresAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        cooldownSeconds: zod.ZodDefault<zod.ZodInt>;
+    }, zod.z.core.$strict>>;
+    action: zod.ZodOptional<zod.ZodObject<{
+        type: zod.ZodEnum<{
+            prompt: "prompt";
+            command: "command";
+        }>;
+        prompt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        instanceId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        command: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        timeoutSeconds: zod.ZodDefault<zod.ZodInt>;
+    }, zod.z.core.$strict>>;
+}, zod.z.core.$strict>;
+/**
+ * Cancels a run in progress and removes the task. Its runs stay readable in the conversation's transcript.
+ * @summary Delete a task
+ */
+export declare const deleteTaskPathTaskMax = 64;
+export declare const DeleteTaskParams: zod.ZodObject<{
+    task: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Starts a run immediately, outside its trigger. Fails with 409 and code TASK_RUNNING when a run
+ * is already in progress and the overlap policy is `skip`.
+ * @summary Run a task now
+ */
+export declare const runTaskPathTaskMax = 64;
+export declare const RunTaskParams: zod.ZodObject<{
+    task: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Stops future runs from its trigger. A run in progress continues. Pausing a paused task succeeds.
+ * @summary Pause a task
+ */
+export declare const pauseTaskPathTaskMax = 64;
+export declare const PauseTaskParams: zod.ZodObject<{
+    task: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Lets its trigger start runs again. Missed runs within `catchupSeconds` are started. Resuming an active task succeeds.
+ * @summary Resume a task
+ */
+export declare const resumeTaskPathTaskMax = 64;
+export declare const ResumeTaskParams: zod.ZodObject<{
+    task: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Stops the run in progress. The conversation is told the run was cancelled. Succeeds when nothing is running.
+ * @summary Cancel the running run
+ */
+export declare const cancelTaskRunPathTaskMax = 64;
+export declare const CancelTaskRunParams: zod.ZodObject<{
+    task: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Newest first, without output; read a run with get-task-run for it.
+ * @summary List a task's runs
+ */
+export declare const listTaskRunsPathTaskMax = 64;
+export declare const ListTaskRunsParams: zod.ZodObject<{
+    task: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const listTaskRunsQueryCursorMax = 1024;
+export declare const listTaskRunsQueryLimitDefault = 50;
+export declare const listTaskRunsQueryLimitMax = 200;
+export declare const ListTaskRunsQueryParams: zod.ZodObject<{
+    cursor: zod.ZodOptional<zod.ZodString>;
+    limit: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
+/**
+ * One run with the end of its output.
+ * @summary Get a task run
+ */
+export declare const getTaskRunPathTaskMax = 64;
+export declare const getTaskRunPathRunMax = 128;
+export declare const GetTaskRunParams: zod.ZodObject<{
+    task: zod.ZodString;
+    run: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Omitted fields stay as they are; null clears a choice so the catalogue default applies again.
+ * Existing conversations keep their models.
+ *
+ * Fails with 422 and code MODEL_UNAVAILABLE when the model cannot run an agent, and with 422 and
+ * code REASONING_UNSUPPORTED when a reasoning effort is set for a model without reasoning.
+ * @summary Update settings
+ */
+export declare const UpdateSettingsBody: zod.ZodObject<{
+    defaultModelId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+    defaultReasoningEffort: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodEnum<{
+        high: "high";
+        low: "low";
+        medium: "medium";
+    }>, zod.ZodNull]>>;
+}, zod.z.core.$strict>;
+/**
+ * The body is the file bytes themselves, not multipart, one file per request. The type is determined from the content, not from Content-Type or from the name. Put the returned id in attachmentIds when sending a message.
+ *
+ * An upload that no message ever references is a draft, and drafts are collected — `draftExpiresAt` in the response says when this one goes. Sending a message with the id makes it permanent.
+ *
+ * The returned `type` says how the assistant will see it. An `image` is read directly, and only by models that accept image input. A small `text` file is placed inline in the message. A large `text` file, and anything `binary`, arrives as a reference the assistant reads on demand — for a binary that usually means downloading it onto one of the project's cloud instances.
+ * @summary Upload a file
+ */
+export declare const uploadAttachmentQueryFilenameMax = 255;
+export declare const UploadAttachmentQueryParams: zod.ZodObject<{
+    filename: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * Metadata for one attachment. The bytes are at /api/v1/attachments/{attachment}:download.
+ *
+ * Returns 404 when the attachment does not exist, does not belong to the current user, or was
+ * removed from the library. Removed files stay readable through their conversations but are no
+ * longer described here.
+ * @summary Get a file
+ */
+export declare const GetAttachmentParams: zod.ZodObject<{
+    attachment: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Changes the name shown in the library and given to the assistant. The bytes and the attachment
+ * id do not change; conversations that already use it see the new name from their next request
+ * on.
+ * @summary Rename a file
+ */
+export declare const UpdateAttachmentParams: zod.ZodObject<{
+    attachment: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const UpdateAttachmentBody: zod.ZodObject<{
+    filename: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Hides the file from the library. Conversations that already use it keep it: the attachment
+ * stays readable by id and keeps rendering in their history. Its bytes are released when the
+ * project is deleted. A draft is cleared for good when its expiry passes. Idempotent.
+ * @summary Remove a file from the library
+ */
+export declare const DeleteAttachmentParams: zod.ZodObject<{
+    attachment: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Returns the original bytes for an attachment id, including one removed from the library. The response carries long-lived cache headers because the content never changes. Returns 404 when the attachment does not exist or does not belong to the current user.
+ *
+ * Only an attachment whose `type` is `image` comes back with its own image type and is usable as the address of an `<img>`. Everything else is served as `application/octet-stream` with `Content-Disposition: attachment`, deliberately: an uploaded file is arbitrary bytes under a name its uploader chose, and serving it back inline would run it on this origin.
+ * @summary Download a file
+ */
+export declare const DownloadAttachmentParams: zod.ZodObject<{
+    attachment: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * @summary Create upload
+ */
+export declare const CreateUploadBody: zod.ZodObject<{
+    requestId: zod.ZodString;
+    filename: zod.ZodString;
+    byteSize: zod.ZodInt;
+    policyId: zod.ZodString;
+    maxFileBytes: zod.ZodInt;
+    partSizeBytes: zod.ZodInt;
+}, zod.z.core.$strict>;
+/**
+ * @summary Get upload
+ */
+export declare const GetUploadParams: zod.ZodObject<{
+    upload: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * @summary Update upload
+ */
+export declare const UpdateUploadParams: zod.ZodObject<{
+    upload: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const UpdateUploadBody: zod.ZodObject<{
+    filename: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * @summary Delete upload
+ */
+export declare const DeleteUploadParams: zod.ZodObject<{
+    upload: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * @summary Cancel upload
+ */
+export declare const CancelUploadParams: zod.ZodObject<{
+    upload: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * @summary Complete upload
+ */
+export declare const CompleteUploadParams: zod.ZodObject<{
+    upload: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const CompleteUploadBody: zod.ZodObject<{
+    policyId: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * @summary Put upload part
+ */
+export declare const putUploadPartPathPartMax = 10000;
+export declare const PutUploadPartParams: zod.ZodObject<{
+    upload: zod.ZodString;
+    part: zod.ZodInt;
+}, zod.z.core.$strict>;
+export declare const PutUploadPartQueryParams: zod.ZodObject<{
+    policyId: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const PutUploadPartHeader: zod.ZodObject<{
+    "X-Part-Size": zod.ZodInt;
+}, zod.z.core.$strict>;
+/**
+ * The assistant stops remembering this. It takes effect at once, so the next conversation will not carry it. The assistant may well learn the same thing again.
+ * @summary Delete one memory
+ */
+export declare const DeleteMemoryParams: zod.ZodObject<{
+    memory: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Creates it, or replaces the project's skill of that name. The whole package goes in each
+ * time: files left out of a write are removed, so the stored skill is what was sent and not
+ * what accumulated.
+ *
+ * A project skill takes precedence over a built-in one of the same name for this project only.
+ * The built-in is untouched and reappears if the project's is deleted.
+ * @summary Write a skill for this project
+ */
+export declare const PutSkillBody: zod.ZodObject<{
+    description: zod.ZodString;
+    enabled: zod.ZodDefault<zod.ZodBoolean>;
+    files: zod.ZodRecord<zod.ZodString, zod.ZodString>;
+    name: zod.ZodString;
+    shortDescription: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * Works for built-in skills too; they simply cannot be written.
+ * @summary Read one skill, with its files
+ */
+export declare const GetSkillParams: zod.ZodObject<{
+    skill: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Separate from writing it, because this is the frequent one: a skill that is off costs
+ * nothing and stays where it is.
+ *
+ * Only skills belonging to the project can be switched. To keep a built-in one out of the
+ * way, write a project skill of the same name and turn that off.
+ * @summary Turn a skill on or off
+ */
+export declare const SetSkillEnabledParams: zod.ZodObject<{
+    skill: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const SetSkillEnabledBody: zod.ZodObject<{
+    enabled: zod.ZodBoolean;
+}, zod.z.core.$strict>;
+/**
+ * A built-in skill of the same name, if there was one, becomes visible again.
+ * @summary Delete this project's skill
+ */
+export declare const DeleteSkillParams: zod.ZodObject<{
+    skill: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Filter by channelId to show, per channel, who is bound to it.
+ * @summary List bindings
+ */
+export declare const listBindingsQueryLimitDefault = 50;
+export declare const listBindingsQueryLimitMax = 200;
+export declare const listBindingsQueryOffsetDefault = 0;
+export declare const listBindingsQueryOffsetMin = 0;
+export declare const listBindingsQueryOffsetMax = 10000;
+export declare const ListBindingsQueryParams: zod.ZodObject<{
+    limit: zod.ZodDefault<zod.ZodInt>;
+    offset: zod.ZodDefault<zod.ZodInt>;
+    platform: zod.ZodOptional<zod.ZodString>;
+    channelId: zod.ZodOptional<zod.ZodUUID>;
+    active: zod.ZodOptional<zod.ZodBoolean>;
+}, zod.z.core.$strict>;
+/**
+ * @summary Get a binding
+ */
+export declare const GetBindingParams: zod.ZodObject<{
+    binding: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * @summary Remove a binding
+ */
+export declare const DeleteBindingParams: zod.ZodObject<{
+    binding: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * @summary List channels
+ */
+export declare const listChannelsQueryLimitDefault = 50;
+export declare const listChannelsQueryLimitMax = 200;
+export declare const listChannelsQueryOffsetDefault = 0;
+export declare const listChannelsQueryOffsetMin = 0;
+export declare const listChannelsQueryOffsetMax = 10000;
+export declare const ListChannelsQueryParams: zod.ZodObject<{
+    limit: zod.ZodDefault<zod.ZodInt>;
+    offset: zod.ZodDefault<zod.ZodInt>;
+    platform: zod.ZodOptional<zod.ZodString>;
+    active: zod.ZodOptional<zod.ZodBoolean>;
+}, zod.z.core.$strict>;
+/**
+ * Which side owns the webhook secret is decided by the platform; see secretSource on list-platforms. For a `generated` platform, do not send webhookSecret — the one we generate is returned exactly once in this response and cannot be retrieved again; miss it and the only way forward is rotating to a new one. For a `supplied` platform you must pass the secret from that platform's own console, and webhookSecret in the response is null.
+ * @summary Create a channel
+ */
+export declare const CreateChannelBody: zod.ZodObject<{
+    allowFrom: zod.ZodOptional<zod.ZodNullable<zod.ZodArray<zod.ZodString>>>;
+    credentials: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
+    name: zod.ZodString;
+    platform: zod.ZodString;
+    senderPolicy: zod.ZodOptional<zod.ZodEnum<{
+        bound_only: "bound_only";
+        open: "open";
+    }>>;
+    webhookSecret: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * @summary Get a channel
+ */
+export declare const GetChannelParams: zod.ZodObject<{
+    channel: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * Only the fields present are changed. senderPolicy and allowFrom go together, and senderPolicy decides whether they are replaced. For platforms held open by a long-lived connection the change applies once that connection is rebuilt; for webhook platforms it applies at once.
+ * @summary Update a channel
+ */
+export declare const UpdateChannelParams: zod.ZodObject<{
+    channel: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export declare const UpdateChannelBody: zod.ZodObject<{
+    allowFrom: zod.ZodOptional<zod.ZodNullable<zod.ZodArray<zod.ZodString>>>;
+    credentials: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
+    enabled: zod.ZodOptional<zod.ZodBoolean>;
+    name: zod.ZodOptional<zod.ZodString>;
+    senderPolicy: zod.ZodOptional<zod.ZodEnum<{
+        bound_only: "bound_only";
+        open: "open";
+    }>>;
+}, zod.z.core.$strict>;
+/**
+ * The channel stops accepting inbound messages and every binding on it stops working. This operation remains available while the project is suspended or being cleaned up.
+ * @summary Delete a channel
+ */
+export declare const DeleteChannelParams: zod.ZodObject<{
+    channel: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * Produces a single-use code to hand to the person being bound. They send that code to the assistant from their own account on that platform, which completes the binding. A binding can only be established this way, by the person themselves — a platform account cannot be named directly. Codes expire and have to be reissued.
+ * @summary Issue a binding code
+ */
+export declare const CreateBindingCodeParams: zod.ZodObject<{
+    channel: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * For diagnosing "I sent a message and the assistant never answered". Returns the inbound messages this channel rejected most recently, newest first, each with its reason. The most common reason is that the sender is not bound yet.
+ * @summary List recently rejected inbound messages
+ */
+export declare const ListChannelRejectionsParams: zod.ZodObject<{
+    channel: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export declare const listChannelRejectionsQueryLimitDefault = 50;
+export declare const listChannelRejectionsQueryLimitMin = 0;
+export declare const listChannelRejectionsQueryLimitMax = 100;
+export declare const ListChannelRejectionsQueryParams: zod.ZodObject<{
+    limit: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
+/**
+ * Replaces the webhook secret. The old one stops working immediately and the channel drops back to awaiting confirmation from the platform. Which side owns the secret is decided by the platform; see secretSource on list-platforms. For a `generated` platform, send no body — the new secret is returned in this response only and cannot be retrieved again. For a `supplied` platform you must pass the new secret from that platform's own console.
+ * @summary Rotate the webhook secret
+ */
+export declare const RotateChannelSecretParams: zod.ZodObject<{
+    channel: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export declare const RotateChannelSecretBody: zod.ZodObject<{
+    webhookSecret: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * For checking a sender policy after changing it. Sends nothing and changes nothing: it runs exactly the same decision a real inbound message goes through, and says which rule produced the answer. The binding-code rule cannot be tested this way — whether something is a binding code depends on what the sender actually wrote.
+ * @summary Test whether a sender would be let through
+ */
+export declare const CheckSenderParams: zod.ZodObject<{
+    channel: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export declare const CheckSenderQueryParams: zod.ZodObject<{
+    peerId: zod.ZodString;
+    username: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * A personal WeChat channel can only send and receive once its owner has signed in by scanning a QR code. This returns that code; poll `GET /v1/weixin-logins/{login}` for progress, and when the status asks for a verification code, submit it with `POST /v1/weixin-logins/{login}/verify-code`.
+ * @summary Begin a WeChat QR login
+ */
+export declare const BeginWeixinLoginParams: zod.ZodObject<{
+    channel: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * Poll this until the status is success or failure. When the status asks for a verification code, submit it with the verification-code operation.
+ * @summary Get the state of a QR login
+ */
+export declare const GetWeixinLoginParams: zod.ZodObject<{
+    login: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * For when WeChat asks for an SMS or device code after the scan. The person who started the login gets that code on their own phone.
+ * @summary Submit a login verification code
+ */
+export declare const SubmitWeixinVerifyCodeParams: zod.ZodObject<{
+    login: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export declare const SubmitWeixinVerifyCodeBody: zod.ZodObject<{
+    code: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * Renews an already announced browser client while the thread is open. It does not create or replace the client catalogue.
+ * @summary Renew client presence
+ */
+export declare const renewThreadPresencePathThreadMax = 64;
+export declare const RenewThreadPresenceParams: zod.ZodObject<{
+    thread: zod.ZodString;
+}, zod.z.core.$strict>;