@arbidocs/client 0.4.75 → 0.4.76

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): 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.
+         *     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).
+         *
+         *     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' | '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
@@ -11740,6 +11916,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 +13314,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 +13403,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 +13513,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 +13833,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 +14699,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 +14748,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 +14821,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 +14973,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 +14995,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 +15040,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 */
@@ -16923,7 +17262,10 @@ interface components {
          * @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.
+         *     approval: whoever completes it is recorded, with what it approved). 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.
          */
         StepActionRequest: {
             /** Step */
@@ -16932,11 +17274,118 @@ interface components {
              * Action
              * @enum {string}
              */
-            action: 'complete' | 'skip';
+            action: 'complete' | 'skip' | 'send_back';
             /** Inputs */
             inputs?: {
                 [key: string]: unknown;
             } | null;
+            /** To */
+            to?: string | null;
+            /** Note */
+            note?: string | null;
+        };
+        /**
+         * 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).
+         */
+        StepAssignee: {
+            /** User */
+            user?: string | null;
+            /** Run Owner */
+            run_owner?: true | null;
+            /** Input */
+            input?: string | null;
+            /** Project Lead */
+            project_lead?: true | 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
@@ -17201,6 +17650,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 +17691,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 +17781,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 */
@@ -17388,6 +17930,13 @@ 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;
         };
         /**
          * TaskUpdateMessage
@@ -18032,6 +18581,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 +18874,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 +19540,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 +19862,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 +19883,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 +20022,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 +20263,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 +23534,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 +24371,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;