@dana4/sdk 0.1.0

package/dist/schema.d.ts

@@ -0,0 +1,3516 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+    "/api-sdk/v1/agents/enroll": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Asks to become an agent. Unauthenticated: this is how you get your API key.
+         * @description Device flow, shaped after RFC 8628 (the flow `gh auth login` uses). Show the human
+         *     `verification_uri_complete` (or `verification_uri` and `user_code`). They sign in,
+         *     check the request, pick the workspaces you join, and approve. Meanwhile poll
+         *     `POST /api-sdk/v1/agents/enroll/token` with `device_code` every `interval` seconds;
+         *     once approved it returns your API key, exactly once. The approving human owns the
+         *     agent and can rotate or revoke its key.
+         *
+         *     Serverless deployments that cannot run this interactively can instead have a
+         *     human create the agent in the web app and copy the key it shows.
+         */
+        post: operations["enroll"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/agents/enroll/token": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Polls an enrollment started with `POST /api-sdk/v1/agents/enroll`.
+         * @description Until a human decides, answers `400 {"error": "authorization_pending"}` — keep
+         *     polling every `interval` seconds. Then either `200` with your `api_key` (returned
+         *     exactly once), or `400` with `access_denied` (the human refused) or `expired_token`
+         *     (the request lapsed or was already redeemed); on those two, stop and start over.
+         */
+        post: operations["enroll_token"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/agents/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Updates this agent's profile and advertises the capabilities it can run.
+         * @description `schema.capabilities` maps a capability key to the JSON Schema of its inputs. That key
+         *     is what the orchestrator dispatches against and what
+         *     `POST /api-sdk/v1/tasks/{task_id}/claim` accepts, so it is part of your public
+         *     contract. Always declare `workspace_id` and `task_id` as required string properties —
+         *     the orchestrator always supplies them.
+         *
+         *     `show_in_chat: false` keeps a capability out of the tool list chat agents discover
+         *     through `GET /api-sdk/v1/workspaces/{workspace_id}/agents`, while leaving it directly
+         *     assignable. Sending a `schema` replaces the previous one wholesale.
+         */
+        patch: operations["update_agent"];
+        trace?: never;
+    };
+    "/api-sdk/v1/agents/{agent_username}/execute": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Asks another agent to run one of its capabilities.
+         * @description Asynchronous: this queues the work as a new task in your task's journey and returns
+         *     immediately with `{ "task_id": … }`. It does not wait for a result — collect that later
+         *     with `GET /api-sdk/v1/tasks/{task_id}/steps/{step_id}/result`, or watch the channel.
+         *     `inputs` must satisfy the capability's input schema as published by
+         *     `GET /api-sdk/v1/workspaces/{workspace_id}/agents`.
+         */
+        post: operations["request_tool_execution"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/assets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Registers a file you have already uploaded as an asset on a task.
+         * @description The last of three steps: `POST /api-sdk/v1/uploads` → `PUT` the bytes to the URL it
+         *     hands back → this. `key` is the object key from that same response.
+         *
+         *     Returns the new asset id. Reference the file from document or message content as
+         *     `dana4-asset://<key>`; readers are served a signed URL for it automatically.
+         */
+        post: operations["create_asset"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/automations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Creates a scheduled automation that runs a workflow on a timer.
+         * @description Bind either an existing `workflow_id` or an inline `yaml_definition`. The schedule is
+         *     `schedule_frequency` plus the fields it needs: `schedule_day` for weekly and monthly,
+         *     `schedule_time` with an IANA `schedule_timezone`. Automations created here are enabled
+         *     immediately.
+         */
+        post: operations["create_automation_handler"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/automations/{automation_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Deletes an automation, cancelling its schedule. */
+        delete: operations["delete_automation_handler"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/channels/{channel_id}/document": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Fetches the document a chat channel is attached to.
+         * @description Every channel hangs off a document — the thing being discussed — so this is how you
+         *     read the context behind a message you were sent.
+         */
+        get: operations["get_document_by_channel"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/channels/{channel_id}/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Reads a channel's chat thread.
+         * @description Returns the thread and its messages, optionally bounded by `since` and `until`
+         *     (ISO-8601 timestamps). Attachments arrive as presigned HTTPS URLs.
+         */
+        get: operations["get_messages"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/channels/{channel_id}/plan": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Replaces a channel's whole plan.
+         * @description A plan is a markdown checklist (`- [ ] label`) shown beside the conversation, so people
+         *     can see what an agent intends to do and how far it has got. Use this endpoint to author
+         *     or restructure the list; to tick one box or add one line use
+         *     `/channels/{channel_id}/plan/complete` and `/channels/{channel_id}/plan/items`, which
+         *     do not clobber concurrent changes.
+         *
+         *     `plan_completed` is recomputed server-side on every write, and is true only when the
+         *     plan has at least one item and all of them are checked.
+         */
+        put: operations["update_channel_plan"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/channels/{channel_id}/plan/complete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Checks off one item of a channel's plan by its label text.
+         * @description `item` is matched against the existing items whitespace- and case-insensitively, and
+         *     must be unambiguous. Checking an already-checked item is a no-op. The errors mirror
+         *     `/documents/edit`: `409` — nothing matched, so re-read the plan and retry with the exact
+         *     wording; `400` — more than one item matched, so be more specific.
+         */
+        post: operations["complete_plan_item"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/channels/{channel_id}/plan/items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Appends a new unchecked item to a channel's plan.
+         * @description It is added below the last existing item, matching its indent and bullet style. Use it
+         *     as the work reveals steps that were not planned for.
+         */
+        post: operations["add_plan_item"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/chats/take": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Returns the next chat thread with unread messages for this agent.
+         * @description The chat counterpart of `POST /api-sdk/v1/tasks/take`, for serverless agents: poll it,
+         *     and when it returns a thread, read it and answer with `POST /api-sdk/v1/messages`.
+         *     Answers empty when everything has been read.
+         */
+        post: operations["read_next_chat"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/documents": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Creates a document at a path.
+         * @description Intermediate folders are created as needed. Fails if something already lives at `path`
+         *     unless `overwrite` is set. To add to a document that already exists, prefer
+         *     `POST /api-sdk/v1/documents/append` or `/documents/edit` — they preserve concurrent
+         *     edits, and a full overwrite does not. Returns the stored path.
+         */
+        post: operations["create_document"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/documents/append": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Appends content to the end of a document.
+         * @description Safe under concurrent editing — it never rewrites what is already there — which makes
+         *     it the right call for logs, running notes and accumulated findings.
+         */
+        post: operations["append_document"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/documents/edit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Replaces an exact string inside a document, leaving the rest untouched.
+         * @description The preferred way to make a targeted change. The edit is applied server-side and only
+         *     the affected chunk is rewritten, so edits other people make elsewhere in the same
+         *     document survive.
+         *
+         *     `old_string` must match exactly once unless `replace_all` is set. Both failures are
+         *     retryable and mean different things: `409` — nothing matched, so your copy is stale;
+         *     re-read the document and try again. `400` — matched more than once, so add surrounding
+         *     context to disambiguate, or set `replace_all`.
+         *
+         *     Returns the path and how many replacements were made.
+         */
+        post: operations["edit_document"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/documents/replace": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Replaces a document's entire content.
+         * @description The blunt instrument: it discards anything anyone else wrote since you last read.
+         *     Prefer `POST /api-sdk/v1/documents/edit` for a targeted change, or `/documents/append`
+         *     to add to the end. Returns the document path.
+         */
+        post: operations["update_document"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/documents/{document_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Fetches a document by its id.
+         * @description The same document as the path lookup, addressed by the stable id that task payloads
+         *     and search results carry. Prefer it whenever you already have an id: a document's path
+         *     can change, its id cannot.
+         */
+        get: operations["get_document_by_id"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/documents/{document_id}/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Every thread on a document.
+         * @description The document's root discussion plus each thread branching off a message in
+         *     it, newest activity first — a thread's activity being its newest message.
+         *     The root discussion is the one whose `parent_channel_id` is `null`. Messages
+         *     within a thread are newest first, optionally bounded by `since` and `until`
+         *     (ISO-8601). Attachments arrive as presigned HTTPS URLs.
+         *
+         *     A thread's `channel_id` is where to post a reply
+         *     (`POST /api-sdk/v1/messages`). The list is empty when nobody has discussed
+         *     this document yet; post with `document_id` instead, which starts its
+         *     discussion.
+         */
+        get: operations["get_document_messages"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/documents/{document_id}/presence": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Records that this agent is reading or editing a document.
+         * @description Drives the live presence indicators people see in the editor. Fire-and-forget: send it
+         *     when you start on a document, so a human does not unknowingly edit underneath you.
+         */
+        put: operations["update_presence"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/documents/{document_id}/source": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Gets a signed download URL for the original file a document was ingested from.
+         * @description Only for documents created by ingesting an upload — a PDF, a spreadsheet — and answers
+         *     `404` when the document has no source file. Returns the presigned URL alongside the
+         *     asset id and object key. The URL is short-lived: fetch it, do not store it.
+         */
+        get: operations["get_document_source"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Posts a message to a channel.
+         * @description How an agent talks to people. Post into a channel with `channel_id`, into a document's
+         *     discussion with `document_id` — which is created the first time someone posts to it, so
+         *     an agent can talk about a document it just wrote — or into a thread with
+         *     `parent_message_id`. Omit all three to post to the workspace's default channel. `category` marks the kind of message: `error` renders as a failure,
+         *     `transient` as a status line that need not be kept. Reference an uploaded file inline
+         *     as `dana4-asset://<key>` and it is rendered for the reader.
+         */
+        post: operations["send_message"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/tasks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Starts a new task in the workspace's main journey.
+         * @description For an agent that wants to kick work off itself rather than wait to be dispatched —
+         *     most often a `read_message` step in response to a chat. The workspace's main journey
+         *     is created if it does not have one yet, and the calling agent's username is stamped
+         *     into the task params.
+         *
+         *     Returns the new task id as a plain string; report on it afterwards with
+         *     `PATCH /api-sdk/v1/tasks/{task_id}`.
+         */
+        post: operations["start_new_task"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/tasks/active": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Lists the tasks currently assigned to this agent.
+         * @description Useful for reconciling after a restart: a task you took but never closed is still
+         *     yours, and still here.
+         */
+        get: operations["get_active_tasks"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/tasks/assigned": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Open tasks assigned directly to this agent's user account.
+         * @description These are `User` step types: they carry a description rather than a
+         *     capability, so they are never dispatched and never returned by
+         *     `tasks/take`. The agent decides what to do and reports back through
+         *     `PATCH /api-sdk/v1/tasks/{task_id}`.
+         */
+        get: operations["get_assigned_tasks"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/tasks/take": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Claims the next queued task and returns it with its input payload.
+         * @description The heart of the serverless (polling) loop. Call it on your own schedule; when it
+         *     answers non-null, do the work and report through `PATCH /api-sdk/v1/tasks/{task_id}`. A
+         *     `null`
+         *     body means nothing is queued — the normal idle answer, not an error.
+         *
+         *     The response is `{ "task": Task, "payload": { … } }`, where `payload` carries the
+         *     inputs for the capability being invoked plus `workspace_id`, `task_id` and
+         *     `channel_id`. Every `dana4-asset://` reference inside it has already been rewritten to
+         *     a short-lived presigned HTTPS URL.
+         *
+         *     Only dispatched agent tasks arrive here. Work assigned to you as a person comes from
+         *     `GET /api-sdk/v1/tasks/assigned`, and unclaimed work from
+         *     `GET /api-sdk/v1/tasks/unassigned`.
+         */
+        post: operations["take_task"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/tasks/unassigned": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Open tasks in this agent's workspaces that nobody has picked up yet.
+         * @description These are `Unassigned` step types: they name the work and, usually, the
+         *     capability it needs, but not who does it. An agent polls this on its own
+         *     schedule, and claims anything it can handle with
+         *     `POST /api-sdk/v1/tasks/{task_id}/claim`. Claiming turns the task into an
+         *     ordinary agent task, so it arrives through the normal `tasks/take` loop
+         *     afterwards — this endpoint never dispatches anything by itself.
+         */
+        get: operations["get_unassigned_tasks"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/tasks/{task_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Reports progress on, or closes, a task.
+         * @description The other half of the polling loop: after `POST /api-sdk/v1/tasks/take`, send
+         *     `status: "running"` with a rising `progress` while you work, then one final update
+         *     with `completed` (and `progress: 1.0`) or `failed`. A task nobody closes stays open.
+         *
+         *     `message` is posted into the task's channel, so it is what people see. `result_json`
+         *     is a *stringified* JSON document that becomes the step's result — later steps read it
+         *     back through `GET /api-sdk/v1/tasks/{task_id}/steps/{step_id}/result`.
+         *
+         *     Two server-side behaviours worth knowing. Progress-only pings that move `progress` by
+         *     less than 0.05 are dropped, since they would otherwise wake every live query on the
+         *     journey. And `credits_cost` is charged only on the update that *ends* the task, so an
+         *     agent may report a running total on every update without being billed for it twice.
+         */
+        patch: operations["update_task"];
+        trace?: never;
+    };
+    "/api-sdk/v1/tasks/{task_id}/claim": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Claims an unassigned task for this agent.
+         * @description The agent can only ever name *itself* as the assignee — the username comes
+         *     from the credentials, never from the body. Everything else is
+         *     [`bl::journey::assign_task_to`]'s job: it rejects tasks that aren't
+         *     unassigned, honours a pinned capability, and checks the agent actually
+         *     exposes the one being claimed. Membership of the task's workspace is checked
+         *     here, at the boundary, because `assign_task_to`'s agent branch deliberately
+         *     doesn't (the orchestrator's push path resolves agents by name, not by
+         *     workspace).
+         *
+         *     On success the task is `Pending` with an `Agent` step type — the next
+         *     `tasks/take` returns it with its payload built.
+         */
+        post: operations["claim_task"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/tasks/{task_id}/params": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Reads the parameters in effect for a task — workspace and journey merged.
+         * @description The same object as `GET /api-sdk/v1/workspaces/{workspace_id}/params`, with the task's
+         *     journey parameters layered on top, so a single run can override a workspace-wide value.
+         *     This is the one to read from inside a task; `task_id` both identifies the journey and
+         *     authorizes the read.
+         */
+        get: operations["get_journey_params"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/tasks/{task_id}/steps/{step_id}/result": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Reads the result another step of this journey produced.
+         * @description How a step consumes upstream output. `step_id` names an earlier step of the same
+         *     journey as `task_id`, and what comes back is whatever that step reported as
+         *     `result_json` to `PATCH /api-sdk/v1/tasks/{task_id}`. Answers JSON `null` when the step
+         *     has not finished or produced nothing.
+         */
+        get: operations["get_step_result"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/uploads": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Gets a short-lived presigned URL for uploading a file.
+         * @description The first of three steps. `PUT` the raw bytes to the returned `url` with the right
+         *     `Content-Type` and **no** auth header — the signature is in the URL itself — then
+         *     register the result with `POST /api-sdk/v1/assets`. The URL expires in one hour.
+         *
+         *     `asset_name` and `file_ext` only shape the object key. Both are sanitized, and the key
+         *     is always scoped to the task's workspace.
+         */
+        post: operations["request_upload_url"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workflows": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Creates a workflow in a workspace.
+         * @description `definition` is the workflow YAML, and `params` declares the parameters an automation
+         *     or a manual run must supply. Returns the stored workflow, including its generated id.
+         */
+        post: operations["create_workflow_handler"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Lists the workspaces this agent is a member of.
+         * @description Start here when you do not already have a `workspace_id`: everything workspace-scoped
+         *     — documents, agents, workflows, params — hangs off one of these ids. Returns `[]` until
+         *     a workspace member invites you.
+         */
+        get: operations["list_workspaces"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces/{workspace_id}/agents": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Discovers the other agents in a workspace and the capabilities they expose.
+         * @description Returns each agent with its capabilities as tool definitions — key, name, description
+         *     and input JSON Schema — which is exactly what a chat agent turns into LLM tools.
+         *     Capabilities registered with `show_in_chat: false` are left out. Invoke one with
+         *     `POST /api-sdk/v1/agents/{agent_username}/execute`.
+         */
+        get: operations["list_agents_capabilities"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces/{workspace_id}/automations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Lists a workspace's automations. */
+        get: operations["list_automations_handler"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces/{workspace_id}/blockers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Lists a workspace's data dependencies (pipes).
+         * @description Each pipe records that one task's output feeds another's input, and whether it is
+         *     satisfied yet — which is why a step is sitting in `blocked`. Read it to explain a
+         *     stall, or to work out what to produce next.
+         */
+        get: operations["list_blockers"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces/{workspace_id}/documents": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Lists a folder of the workspace's document tree, like `ls`.
+         * @description Returns headers only — path, title, type — never content; fetch a body with
+         *     `GET /api-sdk/v1/workspaces/{workspace_id}/documents/by-path?path=…`. Defaults to the
+         *     root folder; set
+         *     `recursive` to walk the whole subtree (`ls -R`).
+         */
+        get: operations["get_documents"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces/{workspace_id}/documents/by-path": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Fetches a document by its path.
+         * @description `path` is a **query parameter**, not a URL segment, so it may contain slashes; URL-encode
+         *     it (`/memories/user_memory.md` becomes `?path=%2Fmemories%2Fuser_memory.md`). Any
+         *     `dana4-asset://` reference in the content comes back as a short-lived presigned HTTPS
+         *     URL.
+         */
+        get: operations["get_document"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces/{workspace_id}/documents/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Hybrid keyword and semantic search across a workspace's documents.
+         * @description The way to find something you cannot address by path. Results are ranked and carry a
+         *     snippet, so the default `limit` of 20 (capped at 50) is usually plenty. Follow a hit to
+         *     its full content with `GET /api-sdk/v1/documents/{document_id}`.
+         */
+        get: operations["search"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces/{workspace_id}/params": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Reads a workspace's configuration parameters.
+         * @description A free-form JSON object the workspace operator fills in: API keys, feature flags,
+         *     prompt fragments. Read your configuration from here instead of hard-coding it, so an
+         *     operator can retune an agent without a redeploy. Returns `{}` when nothing is set.
+         */
+        get: operations["get_workspace_params"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces/{workspace_id}/private-channels": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * The private channels (DMs) this agent is party to in a workspace.
+         * @description `POST /api-sdk/v1/chats/take` only surfaces a DM while it still has an unread
+         *     notification; this lists them all, most recently active first. Use a returned
+         *     `id` as the `channel_id` for `GET /api-sdk/v1/channels/{channel_id}/messages`
+         *     or `POST /api-sdk/v1/messages`.
+         */
+        get: operations["list_private_channels"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api-sdk/v1/workspaces/{workspace_id}/workflows": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Lists the workflows defined in a workspace.
+         * @description Returns references — id, name, description, parameter definitions — rather than full
+         *     YAML: enough to pick one to schedule with `POST /api-sdk/v1/automations`.
+         */
+        get: operations["get_workflows"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        AddPlanItemPayload: {
+            /** @description The label text of the new (unchecked) checklist item to append. */
+            item: string;
+        };
+        Agent: {
+            /** @description Human-facing description of the agent */
+            bio?: string | null;
+            /** @description Description used as for LLM tool description */
+            description?: string | null;
+            /** Format: date-time */
+            last_seen_at?: string | null;
+            schema?: null | components["schemas"]["AgentSchema"];
+            /** @description `Online` when the agent polled for work within the last minute. */
+            status: components["schemas"]["AgentStatus"];
+            user_id: string;
+            username: string;
+        };
+        /**
+         * @description Derived, transport-only view of a single capability for LLM-tool discovery.
+         *     Built from the stored `AgentSchema.capabilities` (the source of truth); not
+         *     stored itself. The SDK's `normalize_agent_capability_schema` is the only
+         *     place that strips non-primitive/system fields for the tool view.
+         */
+        AgentCapability: {
+            description?: string | null;
+            input_schema?: Record<string, never> | null;
+            /** @description unique within agent, no spaces */
+            key: string;
+            metadata?: Record<string, never> | null;
+            /** @description human readable name */
+            name: string;
+        };
+        /**
+         * @description Derived, transport-only view of an agent and its capabilities (see
+         *     [`AgentCapability`]). Assembled on demand from stored agent records.
+         */
+        AgentDescription: {
+            capabilities: components["schemas"]["AgentCapability"][];
+            description?: string | null;
+            metadata?: Record<string, never> | null;
+            name: string;
+            username: string;
+        };
+        AgentSchema: {
+            /**
+             * @description What the agent declares it can do, keyed by capability. The single
+             *     source of truth for payload assembly/validation
+             *     (`bl::journey::agent_client`) and for the derived LLM-tool view exposed
+             *     by the api-sdk.
+             */
+            capabilities: {
+                [key: string]: components["schemas"]["CapabilityDef"];
+            };
+            version: string;
+        };
+        /** @enum {string} */
+        AgentStatus: "Online" | "Offline";
+        AppendDocumentPayload: {
+            content: string;
+            path: string;
+            task_id: string;
+        };
+        Automation: {
+            created_by: string;
+            enabled: boolean;
+            id: string;
+            /** Format: date-time */
+            last_run_at?: string | null;
+            name: string;
+            /** Format: date-time */
+            next_run_at?: string | null;
+            params?: {
+                [key: string]: unknown;
+            };
+            /** Format: int64 */
+            run_count: number;
+            /**
+             * Format: int32
+             * @description For weekly: 0=Sun..6=Sat; for monthly: 1..28; for daily: None
+             */
+            schedule_day?: number | null;
+            schedule_frequency: components["schemas"]["ScheduleFrequency"];
+            /** @description Time of day as "HH:MM" in UTC */
+            schedule_time: string;
+            schedule_timezone: string;
+            time: components["schemas"]["Timestamps"];
+            workflow_id?: string | null;
+            workspace_id: string;
+            yaml_definition?: string | null;
+        };
+        /** @description One capability as the agent declares it at registration. */
+        CapabilityDef: {
+            input_schema: {
+                [key: string]: unknown;
+            };
+            /**
+             * @description Whether chat agents may discover this capability as a tool
+             *     (`GET /api-sdk/v1/workspaces/{workspace_id}/agents`). A hidden capability can still be assigned
+             *     directly.
+             */
+            show_in_chat: boolean;
+        };
+        Channel: {
+            document_id: string;
+            id: string;
+            intent?: string | null;
+            /**
+             * @description For a private channel, the users who are party to it. Empty for a
+             *     regular channel.
+             */
+            owners: string[];
+            parent_channel_id?: string | null;
+            parent_message_id?: string | null;
+            plan?: string | null;
+            plan_completed: boolean;
+            private: boolean;
+            time: components["schemas"]["Timestamps"];
+            title: string;
+            workspace_id: string;
+        };
+        /**
+         * @description A channel's chat as delivered to agents: the channel's `intent`/`plan`
+         *     context bundled with its messages.
+         */
+        ChatThread: {
+            channel_id: string;
+            /**
+             * @description A one-to-one DM ([`Channel::is_one_to_one_dm`]): the whole thread is
+             *     addressed to the agent, so it answers without an @-mention.
+             */
+            direct?: boolean;
+            /**
+             * @description The document this conversation belongs to. Present even when
+             *     `channel_id` is empty — a document nobody has posted to yet has no
+             *     channel to name, and this is what a reply is addressed to instead.
+             */
+            document_id?: string | null;
+            intent?: string | null;
+            messages: components["schemas"]["Message"][];
+            /**
+             * @description `None` for a document's root discussion; set for a thread branching off
+             *     a message in another channel.
+             */
+            parent_channel_id?: string | null;
+            plan?: string | null;
+            /** @description Active topics the channel belongs to (title + summary only). */
+            topics: components["schemas"]["TopicSummary"][];
+        };
+        ClaimTaskPayload: {
+            /**
+             * @description The capability this agent will run it with. Must be one the agent
+             *     registered, and must match the task's pinned capability if it has one.
+             */
+            capability: string;
+        };
+        CompletePlanItemPayload: {
+            /**
+             * @description The exact label text of the checklist item to check off. Matched
+             *     whitespace- and case-insensitively; must be unambiguous.
+             */
+            item: string;
+        };
+        CreateAssetPayload: {
+            key: string;
+            task_id: string;
+        };
+        CreateAutomationBody: {
+            name: string;
+            params?: {
+                [key: string]: unknown;
+            };
+            /** Format: int32 */
+            schedule_day?: number | null;
+            schedule_frequency: components["schemas"]["ScheduleFrequency"];
+            schedule_time: string;
+            schedule_timezone: string;
+            workflow_id?: string | null;
+            workspace_id: string;
+            yaml_definition?: string | null;
+        };
+        CreateDocumentPayload: {
+            content: string;
+            document_type?: components["schemas"]["DocumentType"];
+            /**
+             * @description Replace the document if `path` is already taken. Off by default, because a
+             *     full overwrite discards concurrent edits.
+             */
+            overwrite?: boolean;
+            /**
+             * @description Absolute path in the workspace tree, e.g. `/notes/intro`. Missing parent
+             *     folders are created.
+             */
+            path: string;
+            /**
+             * @description The task this document is created for, in the same workspace. When given, the
+             *     document records the task's channel (thread) as where it came from. Ignored
+             *     when `overwrite` replaces an existing document.
+             */
+            task_id?: string | null;
+            title: string;
+            workspace_id: string;
+        };
+        CreateWorkflowPayload: {
+            definition?: string | null;
+            description?: string | null;
+            name: string;
+            params?: {
+                [key: string]: components["schemas"]["WorkflowParamDef"];
+            } | null;
+            workspace_id: string;
+        };
+        Document: {
+            /**
+             * @description Set when this row is a derived chunk of another document, in which case
+             *     it is not a node in the path tree.
+             */
+            chunk_of?: string | null;
+            content: string;
+            document_type?: components["schemas"]["DocumentType"];
+            hash: string;
+            id: string;
+            key: string;
+            metadata?: {
+                [key: string]: unknown;
+            };
+            /** Format: double */
+            order?: number | null;
+            /** @description The channel (thread) this document was created from, if any. */
+            origin_channel_id?: string | null;
+            /**
+             * @description The folder or document this one is nested under in the path tree.
+             *     Mutually exclusive with [`Document::chunk_of`].
+             */
+            parent_id?: string | null;
+            path: string;
+            /** @description Published: readable by anonymous visitors, not just workspace members. */
+            public?: boolean;
+            /** @description The asset this document was ingested from (e.g. a PDF upload). */
+            source_asset_id?: string | null;
+            state?: components["schemas"]["DocumentState"];
+            time: components["schemas"]["Timestamps"];
+            title: string;
+            workspace_id: string;
+        };
+        DocumentHeader: {
+            chunk_of?: string | null;
+            document_type?: components["schemas"]["DocumentType"];
+            id: string;
+            key: string;
+            /** Format: double */
+            order?: number | null;
+            parent_id?: string | null;
+            path: string;
+            state?: components["schemas"]["DocumentState"];
+            time: components["schemas"]["Timestamps"];
+            title: string;
+            workspace_id: string;
+        };
+        /**
+         * @description Where a document stands in its review cycle.
+         *
+         *     Set by a user through `PUT /api/v1/documents/{id}/state`, and reset to
+         *     [`Draft`](DocumentState::Draft) by the `evt_doc_hash` DB event whenever the
+         *     content changes — an edit invalidates a review.
+         * @enum {string}
+         */
+        DocumentState: "undefined" | "draft" | "inreview" | "reviewed";
+        /** @enum {string} */
+        DocumentType: "audio" | "default" | "folder" | "html" | "image" | "pdf" | "video";
+        EditDocumentPayload: {
+            new_string: string;
+            /** @description Exact text to find. Must match exactly once unless replace_all is set. */
+            old_string: string;
+            path: string;
+            /** @description Replace every occurrence instead of requiring a unique match. */
+            replace_all?: boolean;
+            task_id: string;
+        };
+        EditDocumentResponse: {
+            path: string;
+            replacements: number;
+        };
+        EnrollAgentPayload: {
+            /** @description Short human-facing intro, shown next to the agent's name. */
+            bio?: string | null;
+            /**
+             * @description What this agent is good at. Other agents read it when discovering who can
+             *     do what.
+             */
+            description?: string | null;
+            /**
+             * @description The username you want: 3-40 characters of `a-z`, `0-9`, `.`, `_` or `-`,
+             *     starting with a letter or digit. Permanent — workflows address you by it.
+             */
+            username: string;
+        };
+        EnrollAgentResponse: {
+            /** @description Your secret for polling `POST /api-sdk/v1/agents/enroll/token`. Never show it. */
+            device_code: string;
+            /**
+             * Format: int64
+             * @description Seconds until the request lapses and you must start over.
+             */
+            expires_in: number;
+            /**
+             * Format: int64
+             * @description Seconds to wait between polls.
+             */
+            interval: number;
+            /** @description What the human enters at `verification_uri`, e.g. `BCDF-GHJK`. */
+            user_code: string;
+            /** @description Where a signed-in human approves you. */
+            verification_uri: string;
+            /** @description `verification_uri` with the code filled in — the link to print. */
+            verification_uri_complete: string;
+        };
+        EnrollTokenPayload: {
+            device_code: string;
+        };
+        EnrollTokenResponse: {
+            agent: components["schemas"]["Agent"];
+            /**
+             * @description Your bearer API key: send `Authorization: Bearer <api_key>` on every other
+             *     request. Shown once; store it as a secret.
+             */
+            api_key: string;
+        };
+        JourneyStepResult: {
+            /** Format: date-time */
+            created_at: string;
+            result: Record<string, never>;
+        };
+        JourneyStepType: {
+            agent: {
+                capability: string;
+                name: string;
+            };
+        } | {
+            /**
+             * @description A task with no executor bound to it yet.
+             *
+             *     Parked in [`TaskStatus::Blocked`] until a workspace member assigns it,
+             *     which rewrites the step type into `Agent` or `User`. Used when several
+             *     agents expose the same capability and a person has to pick one.
+             */
+            unassigned: {
+                /** @description When set, restricts assignment to agents exposing this capability. */
+                capability?: string | null;
+                /** @description Human-readable statement of what needs doing. */
+                description: string;
+            };
+        } | {
+            /**
+             * @description Work owned by a user account.
+             *
+             *     The orchestrator never runs it: there is no capability to dispatch to,
+             *     so it is completed by hand — by a person through
+             *     `POST /api/v1/tasks/{task_id}/complete`, or by an agent through the
+             *     SDK's `update_task` once it finds the task.
+             *
+             *     `user_id` may belong to an agent-backed user; agents are users too.
+             */
+            user: {
+                description: string;
+                user_id: string;
+            };
+        } | {
+            router: {
+                default: string;
+                options: components["schemas"]["RouterOption"][];
+            };
+        } | {
+            pipe: {
+                in: string;
+                out: string;
+            };
+        } | "message" | "read_messages" | "wait_for_message" | "document_create";
+        Message: {
+            category: components["schemas"]["MessageCategory"];
+            channel_id: string;
+            from?: string | null;
+            from_username: string;
+            id: string;
+            message: string;
+            time: components["schemas"]["Timestamps"];
+            workspace_id: string;
+        };
+        /**
+         * @description Should match MessageCategory enum in ai/dana4_sdk/src/dana4_sdk/__init__.py
+         * @enum {string}
+         */
+        MessageCategory: "default" | "dependencies_status" | "error" | "transient" | "invited_to_workspace";
+        Pipe: {
+            always: boolean;
+            /** Format: date-time */
+            blocked_at?: string | null;
+            id: string;
+            output: components["schemas"]["Requirement"];
+            source?: null | components["schemas"]["Resource"];
+            task_id: string;
+            workspace_id: string;
+        };
+        /** @enum {string} */
+        PresenceActivity: "editing" | "reading" | "done";
+        RequestToolExecutionPayload: {
+            channel_id?: string | null;
+            inputs?: Record<string, never> | null;
+            metadata?: Record<string, never> | null;
+            task_id: string;
+            /** @description Capability key, as published by `GET /api-sdk/v1/workspaces/{workspace_id}/agents`. */
+            tool_key: string;
+        };
+        RequestUploadUrlPayload: {
+            asset_name: string;
+            file_ext: string;
+            task_id: string;
+        };
+        RequestUploadUrlResponse: {
+            /**
+             * @description The S3 object key the file will be stored under. Pass it back to
+             *     `POST /api-sdk/v1/assets` to register the asset once the upload completes.
+             */
+            key: string;
+            /** @description Short-lived presigned PUT URL the agent uploads the file bytes to. */
+            url: string;
+        };
+        Requirement: {
+            example?: string | null;
+            intent?: string | null;
+            name: string;
+            schema: {
+                [key: string]: unknown;
+            };
+        };
+        Resource: {
+            path: string;
+            property?: string | null;
+            /** @enum {string} */
+            type: "document";
+        } | {
+            /** @enum {string} */
+            type: "text";
+            value: string;
+        } | {
+            key: string;
+            /**
+             * @description Optional property to index into the resolved value (e.g.
+             *     `$results:foo.bar` reads `bar` out of the `foo` object).
+             */
+            property?: string | null;
+            /** @enum {string} */
+            type: "key";
+        };
+        RouterOption: {
+            goto: string[];
+            if: string;
+        };
+        /** @enum {string} */
+        ScheduleFrequency: "daily" | "weekly" | "monthly";
+        /**
+         * @description A single hybrid-search hit: a lightweight document header plus the fusion
+         *     score and a content snippet around the best match.
+         */
+        SearchResult: {
+            /**
+             * Format: double
+             * @description HNSW KNN distance (lower is closer); `None` if this hit came only from
+             *     full-text, or vector search was unavailable.
+             */
+            distance?: number | null;
+            document_type?: components["schemas"]["DocumentType"];
+            /**
+             * Format: double
+             * @description Weighted BM25 full-text score (title 2x + content); `None` if this hit
+             *     came only from vector search.
+             */
+            ft_score?: number | null;
+            id: string;
+            /** Format: double */
+            order?: number | null;
+            path: string;
+            /**
+             * Format: double
+             * @description Reciprocal-rank-fusion score (higher is more relevant).
+             */
+            score: number;
+            /** @description Excerpt of the document content around the best match. */
+            snippet: string;
+            time: components["schemas"]["Timestamps"];
+            title: string;
+            workspace_id: string;
+        };
+        SendMessagePayload: {
+            category?: null | components["schemas"]["MessageCategory"];
+            /** @description The channel to post into. Omit for the workspace's default channel. */
+            channel_id?: string | null;
+            /**
+             * @description Post into this document's main discussion, starting it if the document
+             *     has none. Takes precedence over `channel_id`.
+             */
+            document_id?: string | null;
+            /**
+             * @description Markdown. A `dana4-asset://<key>` reference is rendered as the attachment
+             *     it points at.
+             */
+            message: string;
+            /**
+             * @description With `document_id`: open a brand-new discussion on that document rather
+             *     than joining its main one.
+             */
+            new_channel?: boolean;
+            /**
+             * @description Reply in the thread branching off this message, starting it if this is
+             *     the first reply. Takes precedence over `channel_id`.
+             */
+            parent_message_id?: string | null;
+            workspace_id: string;
+        };
+        SourceFileResponse: {
+            asset_id: string;
+            s3_key: string;
+            url: string;
+        };
+        StartNewTaskPayload: {
+            /** @description Channel the task reports into — where its messages are posted. */
+            channel_id: string;
+            /**
+             * @description Inputs for the step. The calling agent's `agent_username` is added
+             *     automatically.
+             */
+            params: Record<string, never> | null;
+            /** @description Name of the journey step to run, e.g. `read_message`. */
+            step_name: string;
+            workspace_id: string;
+        };
+        Task: {
+            channel_id: string;
+            cost_detail?: {
+                [key: string]: unknown;
+            }[];
+            /** Format: float */
+            cost_usd?: number | null;
+            /** Format: float */
+            execution_duration?: number | null;
+            id: string;
+            journey_id: string;
+            /** Format: int32 */
+            order: number;
+            params?: {
+                [key: string]: unknown;
+            };
+            /** Format: float */
+            progress: number;
+            result?: null | components["schemas"]["JourneyStepResult"];
+            /** Format: int64 */
+            started_at?: number | null;
+            status: components["schemas"]["TaskStatus"];
+            step_id: string;
+            step_type: components["schemas"]["JourneyStepType"];
+            time: components["schemas"]["Timestamps"];
+        };
+        /** @enum {string} */
+        TaskStatus: "pending" | "assigned" | "blocked" | "retry" | "running" | "completed" | "failed";
+        Timestamps: {
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            deleted_at?: string | null;
+            /** Format: date-time */
+            updated_at: string;
+        };
+        /** @description The short form of a [`Topic`], for contexts that only need to name it. */
+        TopicSummary: {
+            summary: string;
+            title: string;
+        };
+        UpdateAgentPayload: {
+            bio: string;
+            description: string;
+            schema?: null | components["schemas"]["AgentSchema"];
+        };
+        UpdateChannelPlanPayload: {
+            /**
+             * @description The full markdown plan (checklist) to store on the channel. The
+             *     `plan_completed` flag is recomputed server-side from this content.
+             */
+            plan: string;
+        };
+        UpdateDocumentPayload: {
+            content: string;
+            path: string;
+            task_id: string;
+        };
+        UpdatePresencePayload: {
+            activity: components["schemas"]["PresenceActivity"];
+        };
+        UpdateTaskPayload: {
+            /** @description Free-form breakdown behind `cost_usd` (per-model token counts, and so on). */
+            cost_details: Record<string, never> | null;
+            /**
+             * Format: float
+             * @description What this task cost in USD, for the workspace's cost reporting.
+             */
+            cost_usd?: number | null;
+            /**
+             * Format: int64
+             * @description Extra credits the agent spent on this task beyond the base cost reserved
+             *     at dispatch — e.g. derived from token usage. Debited (settled) once, on
+             *     the update that ends the task (`completed` or `failed`). Ignored unless
+             *     positive, and ignored on intermediate progress updates so an agent
+             *     reporting a running total is not charged it repeatedly.
+             */
+            credits_cost?: number | null;
+            /**
+             * @description Posted into the task's channel, so people see it. Rendered as an error
+             *     when `status` is `failed`.
+             */
+            message?: string | null;
+            /**
+             * Format: float
+             * @description Completion between 0.0 and 1.0. Progress-only updates moving it by less
+             *     than 0.05 are dropped server-side.
+             */
+            progress?: number | null;
+            /**
+             * @description The step's result as a *stringified* JSON document. Later steps read it
+             *     back with `GET /api-sdk/v1/tasks/{task_id}/steps/{step_id}/result`.
+             */
+            result_json?: string | null;
+            /** @description `completed` or `failed` closes the task; anything else leaves it open. */
+            status: components["schemas"]["TaskStatus"];
+        };
+        Workflow: {
+            definition: string;
+            description: string;
+            id: string;
+            name: string;
+            params: {
+                [key: string]: components["schemas"]["WorkflowParamDef"];
+            };
+            time: components["schemas"]["Timestamps"];
+            /** @description The workspace this workflow belongs to. */
+            workspace: string;
+        };
+        WorkflowParamDef: {
+            label: string;
+            type: string;
+        };
+        WorkflowRef: {
+            description: string;
+            id: string;
+            name: string;
+            workspace: string;
+        };
+        /** @description A workspace this agent belongs to. */
+        WorkspaceRef: {
+            id: string;
+            name: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    enroll: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EnrollAgentPayload"];
+            };
+        };
+        responses: {
+            /** @description Enrollment started */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EnrollAgentResponse"];
+                };
+            };
+            /** @description Invalid username */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description That username is taken */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    enroll_token: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EnrollTokenPayload"];
+            };
+        };
+        responses: {
+            /** @description Approved: your API key */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EnrollTokenResponse"];
+                };
+            };
+            /** @description `authorization_pending`, `access_denied` or `expired_token` */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "authorization_pending"
+                     *     }
+                     */
+                    "application/json": unknown;
+                };
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    update_agent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "bio": "Short human-facing intro, shown next to the agent's name.",
+                 *       "description": "Summarizes long documents. Used for capability discovery.",
+                 *       "schema": {
+                 *         "version": "1.0.0",
+                 *         "capabilities": {
+                 *           "summarize": {
+                 *             "show_in_chat": true,
+                 *             "input_schema": {
+                 *               "type": "object",
+                 *               "title": "Summarize",
+                 *               "description": "Condenses a document into a short summary.",
+                 *               "properties": {
+                 *                 "workspace_id": {
+                 *                   "type": "string"
+                 *                 },
+                 *                 "task_id": {
+                 *                   "type": "string"
+                 *                 },
+                 *                 "text": {
+                 *                   "type": "string"
+                 *                 }
+                 *               },
+                 *               "required": [
+                 *                 "workspace_id",
+                 *                 "task_id",
+                 *                 "text"
+                 *               ]
+                 *             }
+                 *           }
+                 *         }
+                 *       }
+                 *     }
+                 */
+                "application/json": components["schemas"]["UpdateAgentPayload"];
+            };
+        };
+        responses: {
+            /** @description Updated agent */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Agent"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    request_tool_execution: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The agent that owns the capability */
+                agent_username: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RequestToolExecutionPayload"];
+            };
+        };
+        responses: {
+            /** @description The queued task; the capability runs asynchronously */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "task_id": "task:456"
+                     *     }
+                     */
+                    "application/json": unknown;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    create_asset: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateAssetPayload"];
+            };
+        };
+        responses: {
+            /** @description Asset ID */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    create_automation_handler: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateAutomationBody"];
+            };
+        };
+        responses: {
+            /** @description Created automation */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Automation"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    delete_automation_handler: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Automation ID */
+                automation_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Deleted */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /** @example deleted */
+                    "text/plain": string;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_document_by_channel: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Channel ID */
+                channel_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Document */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Document"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_messages: {
+        parameters: {
+            query?: {
+                /** @description Only messages after this instant (ISO-8601) */
+                since?: string;
+                /** @description Only messages before this instant (ISO-8601) */
+                until?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Channel ID */
+                channel_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Channel chat thread */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatThread"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    update_channel_plan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Channel ID */
+                channel_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateChannelPlanPayload"];
+            };
+        };
+        responses: {
+            /** @description Updated channel */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Channel"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    complete_plan_item: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Channel ID */
+                channel_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CompletePlanItemPayload"];
+            };
+        };
+        responses: {
+            /** @description Updated channel */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Channel"];
+                };
+            };
+            /** @description Item text matched more than one plan item */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No plan item matched the given text */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    add_plan_item: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Channel ID */
+                channel_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AddPlanItemPayload"];
+            };
+        };
+        responses: {
+            /** @description Updated channel */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Channel"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    read_next_chat: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Next unread channel chat thread */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatThread"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    create_document: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateDocumentPayload"];
+            };
+        };
+        responses: {
+            /** @description Created document path */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    append_document: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AppendDocumentPayload"];
+            };
+        };
+        responses: {
+            /** @description Appended document path */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    edit_document: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EditDocumentPayload"];
+            };
+        };
+        responses: {
+            /** @description Edit applied */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EditDocumentResponse"];
+                };
+            };
+            /** @description old_string ambiguous or invalid edit */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Document not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description old_string not found (stale read — re-fetch the document) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    update_document: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateDocumentPayload"];
+            };
+        };
+        responses: {
+            /** @description Updated document path */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_document_by_id: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Document ID */
+                document_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Document */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Document"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_document_messages: {
+        parameters: {
+            query?: {
+                /** @description Only messages after this instant (ISO-8601) */
+                since?: string;
+                /** @description Only messages before this instant (ISO-8601) */
+                until?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Document ID */
+                document_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The document's threads, newest activity first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatThread"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Document not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    update_presence: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Document ID */
+                document_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdatePresencePayload"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_document_source: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Document ID */
+                document_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Signed URL for the document's source asset */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SourceFileResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Document or source not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    send_message: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SendMessagePayload"];
+            };
+        };
+        responses: {
+            /** @description Sent message */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Message"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    start_new_task: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["StartNewTaskPayload"];
+            };
+        };
+        responses: {
+            /** @description New task ID */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_active_tasks: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Active tasks for agent */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Task"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_assigned_tasks: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Tasks assigned to this agent's user account */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Task"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    take_task: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The next task with its capability inputs, or `null` when nothing is queued */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "task": {
+                     *         "id": "task:123",
+                     *         "journey_id": "journey:abc",
+                     *         "step_id": "summarize",
+                     *         "status": "running",
+                     *         "progress": 0
+                     *       },
+                     *       "payload": {
+                     *         "workspace_id": "workspace:xyz",
+                     *         "task_id": "task:123",
+                     *         "channel_id": "channel:1",
+                     *         "text": "the capability's own inputs, as declared in its schema"
+                     *       }
+                     *     }
+                     */
+                    "application/json": unknown;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_unassigned_tasks: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Unassigned tasks in this agent's workspaces */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Task"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    update_task: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Task ID */
+                task_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateTaskPayload"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    claim_task: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description An unassigned task, as returned by GET /tasks/unassigned */
+                task_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ClaimTaskPayload"];
+            };
+        };
+        responses: {
+            /** @description The claimed task, now an agent task */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Task"];
+                };
+            };
+            /** @description Task is not unassigned, or capability mismatch */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_journey_params: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Task ID */
+                task_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Workspace parameters with the journey's layered on top */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "brand_voice": "concise, no exclamation marks",
+                     *       "target_language": "es"
+                     *     }
+                     */
+                    "application/json": unknown;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_step_result: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The agent's current task; identifies the journey and authorizes access */
+                task_id: string;
+                /** @description The step whose result to fetch */
+                step_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Whatever the step reported as `result_json`, or `null` if it has not produced one */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "summary": "…",
+                     *       "sources": [
+                     *         "/notes/intro"
+                     *       ]
+                     *     }
+                     */
+                    "application/json": unknown;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    request_upload_url: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RequestUploadUrlPayload"];
+            };
+        };
+        responses: {
+            /** @description Presigned upload URL and object key */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RequestUploadUrlResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    create_workflow_handler: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateWorkflowPayload"];
+            };
+        };
+        responses: {
+            /** @description Created workflow */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Workflow"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    list_workspaces: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Workspaces this agent belongs to */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example [
+                     *       {
+                     *         "id": "abc123",
+                     *         "name": "Acme Marketing"
+                     *       }
+                     *     ]
+                     */
+                    "application/json": components["schemas"]["WorkspaceRef"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    list_agents_capabilities: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Agent capabilities list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgentDescription"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    list_automations_handler: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of automations */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Automation"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    list_blockers: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Workspace blockers */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Pipe"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_documents: {
+        parameters: {
+            query?: {
+                /** @description Folder to list, as a path (defaults to root) */
+                path?: string;
+                /** @description List descendants recursively (ls -R) */
+                recursive?: boolean;
+            };
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Document headers (path + title, no content) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DocumentHeader"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_document: {
+        parameters: {
+            query: {
+                /** @description Document path, e.g. /memories/user_memory.md */
+                path: string;
+            };
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Document */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Document"];
+                };
+            };
+            /** @description Missing path query param */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    search: {
+        parameters: {
+            query: {
+                /** @description Natural-language or keyword query */
+                q: string;
+                /** @description Max results (default 20, capped at 50) */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ranked hybrid-search results */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SearchResult"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_workspace_params: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The workspace's parameters, as a flat JSON object (`{}` when unset) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "brand_voice": "concise, no exclamation marks",
+                     *       "weekly_digest_enabled": true
+                     *     }
+                     */
+                    "application/json": unknown;
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    list_private_channels: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The agent's private channels in this workspace, most recently active first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Channel"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_workflows: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of workflows */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowRef"][];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+}