@arbidocs/client 0.4.75 → 0.4.77

package/dist/index.d.ts

@@ -14,7 +14,7 @@ interface paths {
         };
         /**
          * List Projects
-         * @description List all projects visible to the caller.
+         * @description List all projects visible to the caller, optionally only those at ``stage`` and/or led by ``lead_user``.
          *
          *     Agents are allowed (read-only): ``projects_select_policy`` grants owner-group
          *     visibility, so an agent sees its parent's projects and uses one as its own —
@@ -63,11 +63,34 @@ interface paths {
         head?: never;
         /**
          * Update Project
-         * @description Update project name.
+         * @description Update a project (owner only): name, daily cap and host-defined fields, with PATCH semantics.
+         *
+         *     A field left out is unchanged and an explicit null clears it; ``fields`` merges key by key (null removes a
+         *     key). Stage and budget changes are recorded as project events.
          */
         patch: operations['update_project'];
         trace?: never;
     };
+    '/v1/user/projects/{project_ext_id}/events': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Project Events
+         * @description A project's stage and budget changes, newest first (anyone who can see the project).
+         */
+        get: operations['list_project_events'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/user/projects/quote': {
         parameters: {
             query?: never;
@@ -201,6 +224,29 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/user/projects/{project_ext_id}/usage/conversations': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Project Conversation Usage Endpoint
+         * @description AI usage of a project's billing period by conversation (thread / work item), in credits.
+         *
+         *     Each model call is tagged with the conversation it serves; spend that served none is ``unattributed``.
+         *     Per-step detail of one conversation: ``GET /v1/conversation/{conversation_ext_id}/usage``.
+         */
+        get: operations['get_project_conversation_usage'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/user/projects/{project_ext_id}/invoices': {
         parameters: {
             query?: never;
@@ -2377,6 +2423,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/conversation/{conversation_ext_id}/usage': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Conversation Usage Endpoint
+         * @description AI usage of a conversation since it was created: total, by workflow step, run, model and agent.
+         *
+         *     In credits, like project usage. Every model call is tagged with the conversation it serves and, for a
+         *     work run, the run and workflow step (a stage is a set of steps: sum ``by_step``). Read from the spend
+         *     logs of the project the conversation's workspace bills to; anyone who can read the conversation may.
+         */
+        get: operations['get_conversation_usage'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/conversation/search': {
         parameters: {
             query?: never;
@@ -2578,12 +2648,20 @@ interface paths {
         /**
          * Act On Step
          * @description A person finishes a step of a workflow run: fills in a form (its ``inputs`` join the run's inputs), adds
-         *     the files, approves a review, or skips a step. The run then goes on to its next agent step, under the
-         *     caller's session (they are present: no access question).
+         *     the files, approves a review, skips a step, or sends the work back to an earlier step. The run then goes on to
+         *     its next agent step, under the caller's session (they are present: no access question), and the person steps
+         *     that are now ready tell their assignees.
+         *
+         *     Any unfinished step can be skipped at any time (ahead of the plan too), by any editor: the plan guides the
+         *     thread, it does not hold it. Completing needs the step to be ready; a step that declares ``fields`` checks its
+         *     ``inputs`` against them (422 with ``{field: problem}``); a review records what it approved (the answers and
+         *     document versions of the steps it waits for). ``send_back`` reopens ``to`` (default: the step this one waits
+         *     for) and every step after it; an agent step runs again with the ``note``. A step assigned to a user is
+         *     completed or sent back only by them, the run's owner or a workspace owner (403).
          *
-         *     Any unfinished step can be skipped at any time (ahead of the plan too): the plan guides the thread, it
-         *     does not hold it. Completing needs the step to be ready. 400 when the step is not this run's, or a step
-         *     completed out of order or an agent step completed by hand; 409 while the step's own turn is running.
+         *     400 when the step is not this run's, a step completed out of order, an agent step completed by hand, or a
+         *     send-back to a step this one does not wait for; 409 while the step's own turn (or, for a send-back, any turn)
+         *     is running (a step whose run died is failed first, so it can be skipped or retried).
          */
         post: operations['act_on_step'];
         delete?: never;
@@ -3043,6 +3121,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/tag/matrix': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Tag Matrix
+         * @description A set of tags with their fields and values, plus the documents and facts linked to each.
+         *
+         *     Select the rows with ``parent_ext_id`` (its children; the parent comes back too, its fields being the
+         *     shared columns) or with ``tag_ext_id``. Each row lists up to ``links_limit`` documents (with the doctag's
+         *     note and how many passages it cites) and facts, newest first; ``doc_count``/``fact_count`` are the totals.
+         */
+        get: operations['get_tag_matrix'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/tag/': {
         parameters: {
             query?: never;
@@ -6234,7 +6336,7 @@ interface components {
          * @description What happened to a task, in the order a person reads its history.
          * @enum {string}
          */
-        ActivityKind: 'created' | 'run_started' | 'awaiting_access' | 'access_granted' | 'done' | 'reopened' | 'failed' | 'participant_joined' | 'assistant_responded' | 'assistant_stopped' | 'artifact_created' | 'artifact_edited' | 'document_added' | 'document_removed' | 'notified' | 'step_started' | 'step_done' | 'step_skipped' | 'step_failed';
+        ActivityKind: 'created' | 'run_started' | 'awaiting_access' | 'access_granted' | 'done' | 'reopened' | 'failed' | 'participant_joined' | 'assistant_responded' | 'assistant_stopped' | 'artifact_created' | 'artifact_edited' | 'document_added' | 'document_removed' | 'notified' | 'step_started' | 'step_done' | 'step_skipped' | 'step_failed' | 'step_signal' | 'step_ready' | 'step_reminded' | 'step_sent_back' | 'step_waiting' | 'step_progress' | 'linked_run';
         /**
          * ActivityResponse
          * @description One entry of ``GET /v1/conversation/{id}/activity``.
@@ -9996,6 +10098,74 @@ interface components {
             /** Parent Ext Id */
             parent_ext_id?: string | null;
         };
+        /**
+         * ConversationUsageResponse
+         * @description AI usage of one conversation (a thread, or a work item / matter), in credits like project usage.
+         *
+         *     Read from the project's LiteLLM spend logs: every model call is tagged with the conversation it
+         *     serves and, for a work run, the run and the workflow step. A breakdown holds only the calls that
+         *     carry its key (a chat turn has no step), so each one sums to at most the total.
+         */
+        ConversationUsageResponse: {
+            /** Conversation Ext Id */
+            conversation_ext_id: string;
+            /** Project Ext Id */
+            project_ext_id: string;
+            /** Period Start */
+            period_start: string;
+            /** Period End */
+            period_end: string;
+            /**
+             * Total Spend
+             * @default 0
+             */
+            total_spend: number;
+            /**
+             * Total Tokens
+             * @default 0
+             */
+            total_tokens: number;
+            /**
+             * Total Requests
+             * @default 0
+             */
+            total_requests: number;
+            /**
+             * By Step
+             * @default {}
+             */
+            by_step: {
+                [key: string]: components['schemas']['TagBreakdown'];
+            };
+            /**
+             * By Run
+             * @default {}
+             */
+            by_run: {
+                [key: string]: components['schemas']['TagBreakdown'];
+            };
+            /**
+             * By Model
+             * @default {}
+             */
+            by_model: {
+                [key: string]: components['schemas']['TagBreakdown'];
+            };
+            /**
+             * By Agent
+             * @default {}
+             */
+            by_agent: {
+                [key: string]: components['schemas']['TagBreakdown'];
+            };
+            /**
+             * By Feature
+             * @default {}
+             */
+            by_feature: {
+                [key: string]: components['schemas']['TagBreakdown'];
+            };
+        };
         /**
          * CopyDocumentResult
          * @description Outcome of copying ONE selected item.
@@ -10268,6 +10438,12 @@ interface components {
             shared?: boolean | null;
             /** Parent Ext Id */
             parent_ext_id?: string | null;
+            /** Fields */
+            fields?: components['schemas']['FieldDefinitionWrite'][] | null;
+            /** Field Values */
+            field_values?: {
+                [key: string]: unknown;
+            } | null;
         };
         /**
          * CreateWorkRequest
@@ -11193,6 +11369,36 @@ interface components {
              */
             skipped: components['schemas']['DriveSyncSkippedFile'][];
         };
+        /**
+         * EmailDraftAction
+         * @description Prepare a draft in native mail, in the mailbox of the step's assignee (else the run's owner). It is never
+         *     sent automatically: the person sends it, and the step is done when they say so or when the draft is sent.
+         *     ``to``, ``cc``, ``subject`` and ``body_template`` are templates over the run's inputs and earlier steps'
+         *     outputs (``{{field}}``, ``{{step_id.key}}``, ``{{step_id.answer}}``).
+         */
+        EmailDraftAction: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: 'email_draft';
+            /** To */
+            to?: string[];
+            /** Cc */
+            cc?: string[];
+            /**
+             * Subject
+             * @default
+             */
+            subject: string;
+            /**
+             * Body Template
+             * @default
+             */
+            body_template: string;
+            /** Attachments */
+            attachments?: (string | components['schemas']['StepDocumentRef'])[];
+        };
         /**
          * EmailNotificationSettings
          * @description Per-category email notification preferences. All default on; a master
@@ -11740,6 +11946,42 @@ interface components {
              */
             label: string;
         };
+        /**
+         * FieldDefinitionWrite
+         * @description A field in a write. Give ``id`` to keep an existing field (its type cannot change); omit it to add one.
+         */
+        FieldDefinitionWrite: {
+            /** Id */
+            id?: string | null;
+            /** Name */
+            name: string;
+            /**
+             * Type
+             * @default text
+             * @enum {string}
+             */
+            type: 'text' | 'number' | 'date' | 'checkbox' | 'select' | 'person';
+            /** Options */
+            options?: string[] | null;
+        };
+        /**
+         * FieldSchemaEntry
+         * @description One field of a host-defined schema (a project's ``field_schema``), keyed by a host-chosen ``key``.
+         */
+        FieldSchemaEntry: {
+            /** Key */
+            key: string;
+            /** Label */
+            label?: string | null;
+            /**
+             * Type
+             * @default text
+             * @enum {string}
+             */
+            type: 'text' | 'number' | 'date' | 'checkbox' | 'select' | 'person';
+            /** Options */
+            options?: string[] | null;
+        };
         /**
          * FileDeleteResponse
          * @description OpenAI-compatible file deletion response.
@@ -13102,7 +13344,7 @@ interface components {
             input: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['FactsContextTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['FactsContextTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'] | components['schemas']['WorkflowStepTool'];
             };
             /**
              * Workspace Ext Id
@@ -13191,7 +13433,7 @@ interface components {
             content: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['FactsContextTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['FactsContextTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'] | components['schemas']['WorkflowStepTool'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -13301,7 +13543,7 @@ interface components {
             content: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['FactsContextTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['FactsContextTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'] | components['schemas']['WorkflowStepTool'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -13621,7 +13863,7 @@ interface components {
          *     Type is self-descriptive, no need to parse content field.
          * @enum {string}
          */
-        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'signup_reward' | 'referral_reward' | 'native_mail_received' | 'mail_draft_ready' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100' | 'doc_shared' | 'docx_mention' | 'workspace_access_request' | 'conversation_ready' | 'conversation_done' | 'conversation_notified' | 'workflow_failed' | 'agent_input_requested' | 'workflow_completed' | 'task_started' | 'task_completed' | 'mailbox_sync_complete' | 'drive_sync_complete' | 'activity' | 'mention' | 'call_missed' | 'calendar_invite' | 'calendar_update' | 'calendar_cancel' | 'calendar_reply' | 'calendar_counter' | 'calendar_reminder' | 'calendar_share';
+        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'signup_reward' | 'referral_reward' | 'native_mail_received' | 'mail_draft_ready' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100' | 'doc_shared' | 'docx_mention' | 'workspace_access_request' | 'conversation_ready' | 'conversation_done' | 'conversation_notified' | 'workflow_failed' | 'agent_input_requested' | 'workflow_completed' | 'workflow_signal' | 'step_ready' | 'task_started' | 'task_completed' | 'mailbox_sync_complete' | 'drive_sync_complete' | 'activity' | 'mention' | 'call_missed' | 'calendar_invite' | 'calendar_update' | 'calendar_cancel' | 'calendar_reply' | 'calendar_counter' | 'calendar_reminder' | 'calendar_share';
         /**
          * NotificationUpdate
          * @description Single notification update for bulk PATCH.
@@ -14487,6 +14729,19 @@ interface components {
             upsell?: components['schemas']['ProPlusUpsell'] | null;
             payment?: components['schemas']['AddonPaymentState'] | null;
         };
+        /**
+         * ProjectBudget
+         * @description An amount in minor units (pence, cents) of an ISO 4217 currency.
+         */
+        ProjectBudget: {
+            /** Amount */
+            amount: number;
+            /**
+             * Currency
+             * @description ISO 4217 code, e.g. GBP
+             */
+            currency: string;
+        };
         /**
          * ProjectCheckoutRequest
          * @description Create a Stripe checkout session for this project's Pro plan (Pro = 1 pack, Pro Plus = 10).
@@ -14523,11 +14778,68 @@ interface components {
             /** Client Secret */
             client_secret: string;
         };
+        /**
+         * ProjectConversationUsageResponse
+         * @description A project's AI usage by conversation for a billing period, in credits like project usage.
+         */
+        ProjectConversationUsageResponse: {
+            /** Project Ext Id */
+            project_ext_id: string;
+            /** Period Start */
+            period_start: string;
+            /** Period End */
+            period_end: string;
+            /**
+             * Total Spend
+             * @default 0
+             */
+            total_spend: number;
+            /**
+             * Total Tokens
+             * @default 0
+             */
+            total_tokens: number;
+            /**
+             * Total Requests
+             * @default 0
+             */
+            total_requests: number;
+            /**
+             * By Conversation
+             * @default {}
+             */
+            by_conversation: {
+                [key: string]: components['schemas']['TagBreakdown'];
+            };
+            /**
+             * @default {
+             *       "spend": 0,
+             *       "total_tokens": 0,
+             *       "requests": 0
+             *     }
+             */
+            unattributed: components['schemas']['TagBreakdown'];
+        };
         /**
          * ProjectCreateRequest
-         * @description Create a new project.
+         * @description Create a new project, optionally with its host-defined fields.
          */
         ProjectCreateRequest: {
+            budget?: components['schemas']['ProjectBudget'] | null;
+            /** Client */
+            client?: string | null;
+            /** Client Ref */
+            client_ref?: string | null;
+            /** Stage */
+            stage?: string | null;
+            /** Lead User */
+            lead_user?: string | null;
+            /** Fields */
+            fields?: {
+                [key: string]: unknown;
+            } | null;
+            /** Field Schema */
+            field_schema?: components['schemas']['FieldSchemaEntry'][] | null;
             /** Name */
             name: string;
             /**
@@ -14539,6 +14851,30 @@ interface components {
             /** Daily Cap Per User */
             daily_cap_per_user?: number | null;
         };
+        /**
+         * ProjectEventResponse
+         * @description One entry of ``GET /v1/project/{id}/events``: ``detail`` is ``{"from": …, "to": …}`` (null = unset).
+         */
+        ProjectEventResponse: {
+            /** External Id */
+            external_id: string;
+            /**
+             * Kind
+             * @enum {string}
+             */
+            kind: 'stage_changed' | 'budget_changed';
+            /** Actor */
+            actor?: string | null;
+            /** Detail */
+            detail: {
+                [key: string]: unknown;
+            };
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+        };
         /**
          * ProjectInvoice
          * @description Single Stripe invoice/receipt for a project: the plan, prorations and add-on charges.
@@ -14667,9 +15003,10 @@ interface components {
          *     Listed for both project owners and workspace members of the project. For
          *     non-owner viewers, ``subscription``, ``plan_interval``, ``addons``, ``quotas`` and the
          *     Stripe billing fields are blanked out (zeros / "none" / null) — only
-         *     ``name``, ``external_id``, ``created_by``, and ``daily_cap_per_user`` are
-         *     meaningful. Frontend distinguishes the two modes by comparing
-         *     ``created_by`` against the current user's external_id.
+         *     ``name``, ``external_id``, ``created_by``, ``daily_cap_per_user`` and the
+         *     host-defined fields (``budget`` … ``field_schema``) are meaningful. Frontend
+         *     distinguishes the two modes by comparing ``created_by`` against the current
+         *     user's external_id.
          */
         ProjectResponse: {
             /** External Id */
@@ -14688,6 +15025,23 @@ interface components {
             quotas: components['schemas']['ProjectQuotas'];
             /** Daily Cap Per User */
             daily_cap_per_user?: number | null;
+            budget?: components['schemas']['ProjectBudget'] | null;
+            /** Client */
+            client?: string | null;
+            /** Client Ref */
+            client_ref?: string | null;
+            /** Stage */
+            stage?: string | null;
+            /** Stage Changed At */
+            stage_changed_at?: string | null;
+            /** Lead User */
+            lead_user?: string | null;
+            /** Fields */
+            fields?: {
+                [key: string]: unknown;
+            };
+            /** Field Schema */
+            field_schema?: components['schemas']['FieldSchemaEntry'][] | null;
             /** Plan Interval */
             plan_interval?: ('month' | 'year') | null;
             /**
@@ -14716,9 +15070,24 @@ interface components {
         };
         /**
          * ProjectUpdateRequest
-         * @description Update project name and/or daily per-user cap.
+         * @description Update a project (PATCH): omitted fields are unchanged, null clears; ``fields`` merges key by key.
          */
         ProjectUpdateRequest: {
+            budget?: components['schemas']['ProjectBudget'] | null;
+            /** Client */
+            client?: string | null;
+            /** Client Ref */
+            client_ref?: string | null;
+            /** Stage */
+            stage?: string | null;
+            /** Lead User */
+            lead_user?: string | null;
+            /** Fields */
+            fields?: {
+                [key: string]: unknown;
+            } | null;
+            /** Field Schema */
+            field_schema?: components['schemas']['FieldSchemaEntry'][] | null;
             /** Name */
             name?: string | null;
             /** Daily Cap Per User */
@@ -16609,6 +16978,27 @@ interface components {
              */
             role: 'delegate' | 'write' | 'read' | 'read_basic' | 'freebusy';
         };
+        /**
+         * SignAction
+         * @description Ask people to e-sign a document (``src/core/esign.py``). The step waits until every signer has signed (each
+         *     signs the document's latest version, so later signers counter-sign), then it is done with the signed version.
+         *     A signer who declines, or ``expires_after_hours`` passing, fails the step.
+         */
+        SignAction: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: 'sign';
+            /** Document */
+            document: string | components['schemas']['StepDocumentRef'];
+            /** Signers */
+            signers: components['schemas']['StepAssignee'][];
+            /** Message */
+            message?: string | null;
+            /** Expires After Hours */
+            expires_after_hours?: number | null;
+        };
         /** SignDocumentRequest */
         SignDocumentRequest: {
             signer: components['schemas']['SignerDetails'];
@@ -16922,8 +17312,13 @@ interface components {
          * StepActionRequest
          * @description A person finishes a step of a workflow run (``POST /v1/conversation/{id}/step``).
          *
-         *     ``complete`` finishes a form (``inputs`` merge into the run's inputs), an upload, or a review (the
-         *     approval: whoever completes it is recorded). ``skip`` passes over a step so what waits for it can go on.
+         *     ``complete`` finishes a form (``inputs`` merge into the run's inputs), an upload (``documents``: the files
+         *     added; without them, the files the person added while the step waited), a review (the approval: whoever
+         *     completes it is recorded, with what it approved), or an email draft step (the email was sent). A step that
+         *     declares ``fields`` checks ``inputs`` against them. ``skip`` passes over a step so what waits for it can go on.
+         *     ``send_back`` returns the work to an earlier step (``to``, default the one this step waits for) with an
+         *     optional ``note``: that step and everything after it are open again, and an agent step runs again with the
+         *     note. ``decline`` is a signer refusing a signature step (with an optional ``note``): the step fails.
          */
         StepActionRequest: {
             /** Step */
@@ -16932,22 +17327,147 @@ interface components {
              * Action
              * @enum {string}
              */
-            action: 'complete' | 'skip';
+            action: 'complete' | 'skip' | 'send_back' | 'decline';
             /** Inputs */
             inputs?: {
                 [key: string]: unknown;
             } | null;
+            /** To */
+            to?: string | null;
+            /** Note */
+            note?: string | null;
+            /** Documents */
+            documents?: string[] | null;
         };
         /**
-         * StepUsage
-         * @description Per-step token usage from a single LLM call.
+         * StepAssignee
+         * @description Who a step is for: told when it is ready (and when it is sent back), and the only person besides the run's
+         *     owner and a workspace owner who may complete it or send it back. Exactly one shape is set:
+         *
+         *     - ``user``: a person (``usr-``) or an agent (``agt-``), by external id;
+         *     - ``run_owner``: the run's owner (the conversation's creator);
+         *     - ``input``: the person named by one of the run's inputs (a form's person field), read when the step is ready;
+         *     - ``project_lead``: the lead (``lead_user``) of the project the run's workspace belongs to, read when the step
+         *       is ready. A project without a lead names no one.
+         *
+         *     No assignee means the run's owner hears of it, and any editor may act on it (as before).
          */
-        StepUsage: {
-            /**
-             * Input Tokens
-             * @description Prompt tokens for this step
-             */
-            input_tokens: number;
+        StepAssignee: {
+            /** User */
+            user?: string | null;
+            /** Run Owner */
+            run_owner?: true | null;
+            /** Input */
+            input?: string | null;
+            /** Project Lead */
+            project_lead?: true | null;
+        };
+        /**
+         * StepDocumentRef
+         * @description A document a step works on, named by where it comes from. Exactly one shape is set:
+         *
+         *     - ``step``: the document(s) an earlier step produced or was given (an upload step's files, an agent step's
+         *       drafts, a signature step's signed copy, a document edit step's new version);
+         *     - ``input``: the document(s) one of the run's inputs names (a document pick, or a ``doc-`` id).
+         *
+         *     A plain ``doc-`` id (optionally ``@v{n}``) names one document directly.
+         */
+        StepDocumentRef: {
+            /** Step */
+            step?: string | null;
+            /** Input */
+            input?: string | null;
+        };
+        /**
+         * StepField
+         * @description One field a step asks for (the shape of a form step's fields): what ``complete`` checks its ``inputs``
+         *     against. Keys a client only shows (``description``, ``placeholder``, ``trueText``, ...) pass through.
+         *     A ``person`` field holds a person's external id (``usr-``/``agt-``), which an ``{input: name}`` assignee reads.
+         */
+        StepField: {
+            /** Name */
+            name: string;
+            /**
+             * Type
+             * @default text
+             * @enum {string}
+             */
+            type: 'text' | 'longtext' | 'boolean' | 'select' | 'number' | 'date' | 'scope' | 'documents' | 'person';
+            /** Label */
+            label?: string | null;
+            /**
+             * Required
+             * @default false
+             */
+            required: boolean;
+            /** Options */
+            options?: components['schemas']['StepFieldOption'][] | null;
+            /** Min */
+            min?: number | null;
+            /** Max */
+            max?: number | null;
+        } & {
+            [key: string]: unknown;
+        };
+        /**
+         * StepFieldOption
+         * @description One choice of a ``select`` field. Other keys a client shows (``description``, ``icon``, ...) pass through.
+         */
+        StepFieldOption: {
+            /** Value */
+            value: string;
+            /** Label */
+            label?: string | null;
+        } & {
+            [key: string]: unknown;
+        };
+        /**
+         * StepSignal
+         * @description A named signal a step raises when it is done and its condition holds (``src/core/workflow_signals.py``).
+         *
+         *     Raising it records a ``step_signal`` event on the thread and sends the run's owner a ``workflow_signal``
+         *     notification, which an event workflow (``event_kind="workflow_signal"``, ``event_filter={"signal": name}``)
+         *     starts on: the "then" of an if/then lives in that link, not in the workflow.
+         */
+        StepSignal: {
+            /** Name */
+            name: string;
+            when?: components['schemas']['StepSignalWhen'] | null;
+        };
+        /**
+         * StepSignalWhen
+         * @description The condition a step's outcome must meet for its signal to be raised. Exactly one shape is set:
+         *
+         *     - a **form** (or upload) step: ``field`` equals ``equals`` (case-insensitive text; a list field
+         *       contains it);
+         *     - an **agent** step: its answer ``contains`` a phrase (case-insensitive), or ``matches`` a regex;
+         *     - a **review** step: ``approved`` (completed, not skipped).
+         *
+         *     No condition at all (``when`` omitted) raises the signal whenever the step is done. This is plaintext
+         *     configuration like the step's ``prompt``; the answer it is tested against is never stored.
+         */
+        StepSignalWhen: {
+            /** Field */
+            field?: string | null;
+            /** Equals */
+            equals?: string | number | boolean | null;
+            /** Contains */
+            contains?: string | null;
+            /** Matches */
+            matches?: string | null;
+            /** Approved */
+            approved?: boolean | null;
+        };
+        /**
+         * StepUsage
+         * @description Per-step token usage from a single LLM call.
+         */
+        StepUsage: {
+            /**
+             * Input Tokens
+             * @description Prompt tokens for this step
+             */
+            input_tokens: number;
             /**
              * Output Tokens
              * @description Completion tokens for this step
@@ -17180,6 +17700,32 @@ interface components {
             /** Row Height */
             row_height?: number | null;
         };
+        /**
+         * TabularReviewAction
+         * @description Run AI review columns (tags with instructions) over documents: the annotation job of a Tabular Review. The
+         *     step is done when the job has finished; its output names the tags and documents, so a client opens the grid.
+         *     ``documents`` is a list of references, ``run_uploads`` (every file the run's upload steps took) or
+         *     ``workspace`` (every processed document in the workspace).
+         */
+        TabularReviewAction: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: 'tabular_review';
+            /** Tags */
+            tags: string[];
+            /**
+             * Documents
+             * @default run_uploads
+             */
+            documents: (string | components['schemas']['StepDocumentRef'])[] | ('run_uploads' | 'workspace');
+            /**
+             * Overwrite
+             * @default false
+             */
+            overwrite: boolean;
+        };
         /**
          * TagBreakdown
          * @description Spend/token breakdown keyed by tag value (e.g. wrk-xxx, usr-xxx).
@@ -17201,6 +17747,25 @@ interface components {
              */
             requests: number;
         };
+        /**
+         * TagField
+         * @description A field a tag has — its own, or inherited from an ancestor (``tag_ext_id`` says which tag defines it).
+         */
+        TagField: {
+            /** Id */
+            id: string;
+            /** Name */
+            name: string;
+            /**
+             * Type
+             * @enum {string}
+             */
+            type: 'text' | 'number' | 'date' | 'checkbox' | 'select' | 'person';
+            /** Options */
+            options?: string[] | null;
+            /** Tag Ext Id */
+            tag_ext_id: string;
+        };
         /**
          * TagFormat
          * @description Tag format configuration stored as JSONB.
@@ -17223,6 +17788,74 @@ interface components {
              */
             options: string[];
         };
+        /**
+         * TagMatrixDocLink
+         * @description A document a matrix tag is applied to: the doctag's note is the link's value.
+         */
+        TagMatrixDocLink: {
+            /** Doc Ext Id */
+            doc_ext_id: string;
+            /** File Name */
+            file_name: string;
+            /** Note */
+            note?: string | null;
+            /**
+             * Citations Count
+             * @default 0
+             */
+            citations_count: number;
+            /**
+             * Updated At
+             * Format: date-time
+             */
+            updated_at: string;
+        };
+        /**
+         * TagMatrixFactLink
+         * @description A fact carrying a matrix tag. A plain link: the fact is relevant to the tag's category.
+         */
+        TagMatrixFactLink: {
+            /** Fact Ext Id */
+            fact_ext_id: string;
+            /** Text */
+            text: string;
+            /** Confirmed */
+            confirmed: boolean;
+            /**
+             * Updated At
+             * Format: date-time
+             */
+            updated_at: string;
+        };
+        /** TagMatrixResponse */
+        TagMatrixResponse: {
+            /** Rows */
+            rows?: components['schemas']['TagMatrixRow'][];
+            parent?: components['schemas']['TagResponse'] | null;
+            /** Links Limit */
+            links_limit: number;
+        };
+        /**
+         * TagMatrixRow
+         * @description One tag of the matrix with its evidence. ``docs``/``facts`` are capped; the counts are the totals.
+         */
+        TagMatrixRow: {
+            tag: components['schemas']['TagResponse'];
+            /** Docs */
+            docs?: components['schemas']['TagMatrixDocLink'][];
+            /** Facts */
+            facts?: components['schemas']['TagMatrixFactLink'][];
+            /**
+             * Doc Count
+             * @default 0
+             */
+            doc_count: number;
+            /**
+             * Fact Count
+             * @default 0
+             */
+            fact_count: number;
+        };
         /** TagResponse */
         TagResponse: {
             /** External Id */
@@ -17245,6 +17878,12 @@ interface components {
              * @default 0
              */
             facttag_count: number;
+            /** Fields */
+            fields?: components['schemas']['TagField'][];
+            /** Field Values */
+            field_values?: {
+                [key: string]: unknown;
+            };
             /** Created By Ext Id */
             created_by_ext_id: string;
             /** Updated By Ext Id */
@@ -17351,6 +17990,9 @@ interface components {
          *     ``form`` / ``upload`` / ``review`` steps wait for a person; an ``agent`` step is a turn the assistant
          *     takes in the thread, running a ``skill`` (with ``inputs`` templated from the run's inputs) or a
          *     ``prompt`` template. A ``branch`` agent step runs off the main line and delivers only its result to it.
+         *     An agent step with ``edit_document`` edits that DOCX with tracked changes and saves it as a new version.
+         *     An ``action`` step uses a platform feature (``action``: e-signing, a mail draft, a tabular review): see
+         *     ``src/core/workflow_actions.py``.
          *     The structure is plaintext (the scheduler reads it to start each step, like ``Convos.prompt``); the
          *     ``title`` is encrypted on the conversation. ``ui`` carries what a client shows (form fields, icon).
          */
@@ -17363,7 +18005,7 @@ interface components {
              * Kind
              * @enum {string}
              */
-            kind: 'form' | 'upload' | 'agent' | 'review';
+            kind: 'form' | 'upload' | 'agent' | 'review' | 'action';
             /** After */
             after?: string[] | null;
             /** Skill */
@@ -17388,6 +18030,17 @@ interface components {
             ui?: {
                 [key: string]: unknown;
             } | null;
+            /** Signals */
+            signals?: components['schemas']['StepSignal'][];
+            assignee?: components['schemas']['StepAssignee'] | null;
+            /** Remind After Hours */
+            remind_after_hours?: number | null;
+            /** Fields */
+            fields?: components['schemas']['StepField'][] | null;
+            /** Action */
+            action?: (components['schemas']['SignAction'] | components['schemas']['EmailDraftAction'] | components['schemas']['TabularReviewAction']) | null;
+            /** Edit Document */
+            edit_document?: string | components['schemas']['StepDocumentRef'] | null;
         };
         /**
          * TaskUpdateMessage
@@ -18032,6 +18685,18 @@ interface components {
              * @description Parent tag external ID. Send null to un-nest the tag; omit to leave the parent unchanged.
              */
             parent_ext_id?: string | null;
+            /**
+             * Fields
+             * @description The tag's own fields, in full: give a field's id to keep it (its type cannot change), omit the id to add one; fields left out are dropped. Inherited fields are changed on the tag that defines them.
+             */
+            fields?: components['schemas']['FieldDefinitionWrite'][] | null;
+            /**
+             * Field Values
+             * @description Merged into the current values, keyed by field id or name; null clears a field.
+             */
+            field_values?: {
+                [key: string]: unknown;
+            } | null;
         };
         /**
          * UpdateWorkflowRequest
@@ -18313,7 +18978,7 @@ interface components {
             content: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['FactsContextTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['FactsContextTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'] | components['schemas']['WorkflowStepTool'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -18979,6 +19644,26 @@ interface components {
             /** Error */
             error?: string | null;
         };
+        /**
+         * WorkflowStepTool
+         * @description Marks the user message the server sends to start a workflow's agent step (its wake instruction) with the
+         *     step it belongs to, so a client can show it as that step rather than as the raw instruction. Plaintext: the step
+         *     id only (the step's title stays encrypted in the conversation's plan).
+         */
+        WorkflowStepTool: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            name: 'workflow_step';
+            /**
+             * Description
+             * @default workflow step
+             */
+            description: string;
+            /** Workflow Step */
+            workflow_step: string;
+        };
         /**
          * WorkingHours
          * @description Working hours for one weekday (0 = Monday). Times are local ``HH:MM`` in the settings time zone.
@@ -19281,7 +19966,12 @@ type $defs = Record<string, never>;
 interface operations {
     list_projects: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Only projects at this stage */
+                stage?: string | null;
+                /** @description Only projects led by this member */
+                lead_user?: string | null;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -19297,6 +19987,15 @@ interface operations {
                     'application/json': components['schemas']['ProjectResponse'][];
                 };
             };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
         };
     };
     create_project: {
@@ -19427,6 +20126,40 @@ interface operations {
             };
         };
     };
+    list_project_events: {
+        parameters: {
+            query?: {
+                kind?: ('stage_changed' | 'budget_changed') | null;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectEventResponse'][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     quote_project_plan: {
         parameters: {
             query?: never;
@@ -19634,6 +20367,40 @@ interface operations {
             };
         };
     };
+    get_project_conversation_usage: {
+        parameters: {
+            query?: {
+                /** @description 0 = current billing period, 1 = previous month, etc. */
+                months_back?: number;
+            };
+            header?: never;
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectConversationUsageResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     get_project_invoices: {
         parameters: {
             query?: never;
@@ -22871,6 +23638,37 @@ interface operations {
             };
         };
     };
+    get_conversation_usage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                conversation_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ConversationUsageResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     search_conversations: {
         parameters: {
             query?: never;
@@ -23677,6 +24475,42 @@ interface operations {
             };
         };
     };
+    get_tag_matrix: {
+        parameters: {
+            query?: {
+                /** @description Rows are this tag's children, oldest first */
+                parent_ext_id?: string | null;
+                /** @description Rows are these tags, in this order (repeatable) */
+                tag_ext_id?: string[] | null;
+                /** @description Most documents and facts per row */
+                links_limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['TagMatrixResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     create_tag: {
         parameters: {
             query?: never;