@arbidocs/client 0.3.182 → 0.3.184

package/dist/index.d.cts

@@ -1988,6 +1988,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/facts/batch': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create Facts Batch Endpoint
+         * @description Create several facts in one transaction — all of them, or none.
+         *
+         *     Prefer this to a loop of single creates for an import: tags are resolved once and the facts are
+         *     embedded in batches after the commit, rather than one request, one tag lookup and one background
+         *     embedding task per fact. Responses come back in request order.
+         */
+        post: operations['create_facts_batch'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/facts/list': {
         parameters: {
             query?: never;
@@ -2003,6 +2027,9 @@ interface paths {
          *     into the timeline: only dated facts, ordered by when they happened. Each
          *     bound is read at its own precision and widened outward, so ``date_to=2019``
          *     runs through 31 December rather than stopping on 1 January.
+         *
+         *     Narrow with ``tag_ext_id`` (repeatable; a fact must carry all of them) and ``doc_ext_id``, and page
+         *     with ``limit``/``offset`` — a large workspace need not be fetched whole.
          */
         get: operations['list_facts'];
         put?: never;
@@ -3401,6 +3428,20 @@ interface components {
          *     follow-up call with this set to true for those specific emails actually sends the
          *     invite and deposits the pending workspace-share grant. Without this gate, sharing
          *     would email and grant future access to a typo'd address with no chance to back out.
+         *
+         *     resource_type + resource_ext_id (optional): set when this call came from sharing a
+         *     specific document or conversation by email rather than the workspace itself (the
+         *     "Share" action on a resource). Every recipient still goes through the normal
+         *     add-user flow above (same role, same confirm_invite gate) — this only attaches a
+         *     breadcrumb so the invite/notification carries a deep link to the resource instead
+         *     of just the workspace, and Contacts.shared_resource_* survives an unregistered
+         *     recipient's registration so their first login redirects straight there.
+         *
+         *     confirm_share (default False): required when the named resource is currently
+         *     private — sharing it externally makes it visible to every workspace member, not
+         *     just the recipients, so this mirrors confirm_invite's explicit-opt-in gate. A call
+         *     naming a private resource without this set does nothing and reports that a
+         *     confirmation is needed; the caller re-calls with it set once the owner confirms.
          */
         AddWorkspaceUsersRequest: {
             /** Emails */
@@ -3415,6 +3456,12 @@ interface components {
             session_pubkey_b64?: string | null;
             /** Confirm Invite */
             confirm_invite?: boolean | null;
+            /** Resource Type */
+            resource_type?: ('document' | 'conversation') | null;
+            /** Resource Ext Id */
+            resource_ext_id?: string | null;
+            /** Confirm Share */
+            confirm_share?: boolean | null;
         };
         /**
          * AgentControlStateEvent
@@ -3565,7 +3612,7 @@ interface components {
             subagent_status?: ('running' | 'done' | 'failed') | null;
             /**
              * Task Message Ext Id
-             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — absent when the delegation type doesn't persist one (deep_research/run_skill/spawn_coding_agent stay ephemeral/inline-only). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
+             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — every delegation persists one (sub_agent, deep_research, run_skill, spawn_coding_agent are all the same underlying mechanism). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
              */
             task_message_ext_id?: string | null;
             /**
@@ -3677,7 +3724,7 @@ interface components {
             RUN_CODE_ENABLED: boolean;
             /**
              * Mcp Tools
-             * @description MCP tool names to enable from LiteLLM (e.g. ['read_wiki_contents', 'ask_question']).
+             * @description MCP tool names to enable from LiteLLM (e.g. ['firecrawl_scrape', 'firecrawl_search']).
              * @default []
              */
             MCP_TOOLS: string[];
@@ -3950,7 +3997,7 @@ interface components {
             RUN_CODE_ENABLED: boolean;
             /**
              * Mcp Tools
-             * @description MCP tool names to enable from LiteLLM (e.g. ['read_wiki_contents', 'ask_question']).
+             * @description MCP tool names to enable from LiteLLM (e.g. ['firecrawl_scrape', 'firecrawl_search']).
              * @default []
              */
             MCP_TOOLS: string[];
@@ -4581,7 +4628,7 @@ interface components {
             subagent_status?: ('running' | 'done' | 'failed') | null;
             /**
              * Task Message Ext Id
-             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — absent when the delegation type doesn't persist one (deep_research/run_skill/spawn_coding_agent stay ephemeral/inline-only). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
+             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — every delegation persists one (sub_agent, deep_research, run_skill, spawn_coding_agent are all the same underlying mechanism). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
              */
             task_message_ext_id?: string | null;
             /**
@@ -5915,6 +5962,14 @@ interface components {
             tag_ext_ids: string[];
             citations?: components['schemas']['CitationSources'] | null;
         };
+        /**
+         * CreateFactsRequest
+         * @description Create several facts in one transaction (all-or-nothing).
+         */
+        CreateFactsRequest: {
+            /** Facts */
+            facts: components['schemas']['CreateFactRequest'][];
+        };
         /**
          * CreatePlanDetail
          * @description Detail for a create_plan tool call.
@@ -6837,6 +6892,12 @@ interface components {
             confirmed: boolean;
             /** Score */
             score: number;
+            citations?: components['schemas']['CitationSources'] | null;
+            /**
+             * Tags
+             * @default []
+             */
+            tags: components['schemas']['FactTagResponse'][];
         };
         /**
          * FactSearchRequest
@@ -7686,6 +7747,8 @@ interface components {
             previous_response_id?: string | null;
             /** Model */
             model?: string | null;
+            /** Active Artifact Ext Id */
+            active_artifact_ext_id?: string | null;
             /**
              * Stream
              * @default false
@@ -10246,6 +10309,8 @@ interface components {
             access: string;
             /** Refresh */
             refresh?: string | null;
+            /** Auto Sync Workspace Ext Id */
+            auto_sync_workspace_ext_id?: string | null;
         };
         /** ShareConversationResponse */
         ShareConversationResponse: {
@@ -14921,6 +14986,39 @@ interface operations {
             };
         };
     };
+    create_facts_batch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateFactsRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['FactResponse'][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     list_facts: {
         parameters: {
             query?: {
@@ -14931,6 +15029,14 @@ interface operations {
                 date_to?: string | null;
                 /** @description Only facts that carry a date — the timeline view */
                 dated_only?: boolean;
+                /** @description Only facts carrying ALL of these tags */
+                tag_ext_id?: string[] | null;
+                /** @description Only facts whose sources include this document */
+                doc_ext_id?: string | null;
+                /** @description Page size; omit for every matching fact */
+                limit?: number | null;
+                /** @description Facts to skip, for paging with limit */
+                offset?: number;
             };
             header?: never;
             path?: never;

package/dist/index.d.ts

@@ -1988,6 +1988,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/facts/batch': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create Facts Batch Endpoint
+         * @description Create several facts in one transaction — all of them, or none.
+         *
+         *     Prefer this to a loop of single creates for an import: tags are resolved once and the facts are
+         *     embedded in batches after the commit, rather than one request, one tag lookup and one background
+         *     embedding task per fact. Responses come back in request order.
+         */
+        post: operations['create_facts_batch'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/facts/list': {
         parameters: {
             query?: never;
@@ -2003,6 +2027,9 @@ interface paths {
          *     into the timeline: only dated facts, ordered by when they happened. Each
          *     bound is read at its own precision and widened outward, so ``date_to=2019``
          *     runs through 31 December rather than stopping on 1 January.
+         *
+         *     Narrow with ``tag_ext_id`` (repeatable; a fact must carry all of them) and ``doc_ext_id``, and page
+         *     with ``limit``/``offset`` — a large workspace need not be fetched whole.
          */
         get: operations['list_facts'];
         put?: never;
@@ -3401,6 +3428,20 @@ interface components {
          *     follow-up call with this set to true for those specific emails actually sends the
          *     invite and deposits the pending workspace-share grant. Without this gate, sharing
          *     would email and grant future access to a typo'd address with no chance to back out.
+         *
+         *     resource_type + resource_ext_id (optional): set when this call came from sharing a
+         *     specific document or conversation by email rather than the workspace itself (the
+         *     "Share" action on a resource). Every recipient still goes through the normal
+         *     add-user flow above (same role, same confirm_invite gate) — this only attaches a
+         *     breadcrumb so the invite/notification carries a deep link to the resource instead
+         *     of just the workspace, and Contacts.shared_resource_* survives an unregistered
+         *     recipient's registration so their first login redirects straight there.
+         *
+         *     confirm_share (default False): required when the named resource is currently
+         *     private — sharing it externally makes it visible to every workspace member, not
+         *     just the recipients, so this mirrors confirm_invite's explicit-opt-in gate. A call
+         *     naming a private resource without this set does nothing and reports that a
+         *     confirmation is needed; the caller re-calls with it set once the owner confirms.
          */
         AddWorkspaceUsersRequest: {
             /** Emails */
@@ -3415,6 +3456,12 @@ interface components {
             session_pubkey_b64?: string | null;
             /** Confirm Invite */
             confirm_invite?: boolean | null;
+            /** Resource Type */
+            resource_type?: ('document' | 'conversation') | null;
+            /** Resource Ext Id */
+            resource_ext_id?: string | null;
+            /** Confirm Share */
+            confirm_share?: boolean | null;
         };
         /**
          * AgentControlStateEvent
@@ -3565,7 +3612,7 @@ interface components {
             subagent_status?: ('running' | 'done' | 'failed') | null;
             /**
              * Task Message Ext Id
-             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — absent when the delegation type doesn't persist one (deep_research/run_skill/spawn_coding_agent stay ephemeral/inline-only). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
+             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — every delegation persists one (sub_agent, deep_research, run_skill, spawn_coding_agent are all the same underlying mechanism). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
              */
             task_message_ext_id?: string | null;
             /**
@@ -3677,7 +3724,7 @@ interface components {
             RUN_CODE_ENABLED: boolean;
             /**
              * Mcp Tools
-             * @description MCP tool names to enable from LiteLLM (e.g. ['read_wiki_contents', 'ask_question']).
+             * @description MCP tool names to enable from LiteLLM (e.g. ['firecrawl_scrape', 'firecrawl_search']).
              * @default []
              */
             MCP_TOOLS: string[];
@@ -3950,7 +3997,7 @@ interface components {
             RUN_CODE_ENABLED: boolean;
             /**
              * Mcp Tools
-             * @description MCP tool names to enable from LiteLLM (e.g. ['read_wiki_contents', 'ask_question']).
+             * @description MCP tool names to enable from LiteLLM (e.g. ['firecrawl_scrape', 'firecrawl_search']).
              * @default []
              */
             MCP_TOOLS: string[];
@@ -4581,7 +4628,7 @@ interface components {
             subagent_status?: ('running' | 'done' | 'failed') | null;
             /**
              * Task Message Ext Id
-             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — absent when the delegation type doesn't persist one (deep_research/run_skill/spawn_coding_agent stay ephemeral/inline-only). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
+             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — every delegation persists one (sub_agent, deep_research, run_skill, spawn_coding_agent are all the same underlying mechanism). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
              */
             task_message_ext_id?: string | null;
             /**
@@ -5915,6 +5962,14 @@ interface components {
             tag_ext_ids: string[];
             citations?: components['schemas']['CitationSources'] | null;
         };
+        /**
+         * CreateFactsRequest
+         * @description Create several facts in one transaction (all-or-nothing).
+         */
+        CreateFactsRequest: {
+            /** Facts */
+            facts: components['schemas']['CreateFactRequest'][];
+        };
         /**
          * CreatePlanDetail
          * @description Detail for a create_plan tool call.
@@ -6837,6 +6892,12 @@ interface components {
             confirmed: boolean;
             /** Score */
             score: number;
+            citations?: components['schemas']['CitationSources'] | null;
+            /**
+             * Tags
+             * @default []
+             */
+            tags: components['schemas']['FactTagResponse'][];
         };
         /**
          * FactSearchRequest
@@ -7686,6 +7747,8 @@ interface components {
             previous_response_id?: string | null;
             /** Model */
             model?: string | null;
+            /** Active Artifact Ext Id */
+            active_artifact_ext_id?: string | null;
             /**
              * Stream
              * @default false
@@ -10246,6 +10309,8 @@ interface components {
             access: string;
             /** Refresh */
             refresh?: string | null;
+            /** Auto Sync Workspace Ext Id */
+            auto_sync_workspace_ext_id?: string | null;
         };
         /** ShareConversationResponse */
         ShareConversationResponse: {
@@ -14921,6 +14986,39 @@ interface operations {
             };
         };
     };
+    create_facts_batch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateFactsRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['FactResponse'][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     list_facts: {
         parameters: {
             query?: {
@@ -14931,6 +15029,14 @@ interface operations {
                 date_to?: string | null;
                 /** @description Only facts that carry a date — the timeline view */
                 dated_only?: boolean;
+                /** @description Only facts carrying ALL of these tags */
+                tag_ext_id?: string[] | null;
+                /** @description Only facts whose sources include this document */
+                doc_ext_id?: string | null;
+                /** @description Page size; omit for every matching fact */
+                limit?: number | null;
+                /** @description Facts to skip, for paging with limit */
+                offset?: number;
             };
             header?: never;
             path?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/client",
-  "version": "0.3.182",
+  "version": "0.3.184",
   "description": "TypeScript SDK for the ARBI API — zero-knowledge auth, E2E encryption, and type-safe REST client",
   "type": "module",
   "main": "dist/index.cjs",