@arbidocs/client 0.4.67 → 0.4.68

package/dist/index.d.cts

@@ -2782,7 +2782,7 @@ interface paths {
         head?: never;
         /**
          * Update Fact Endpoint
-         * @description Patch a note. A content edit replaces it (append + soft-delete); pin/share toggle in place.
+         * @description Patch a note. A content edit replaces it (append + soft-delete); share/verify toggle in place.
          */
         patch: operations['update_fact'];
         trace?: never;
@@ -5069,7 +5069,7 @@ interface components {
             PERSONAL_AGENT: boolean;
             /**
              * Facts Enabled
-             * @description Workspace facts are readable AND writable by the agent: pinned core facts are injected into the prompt, and the agent gets the search_facts (recall) and create_fact (write) tools.
+             * @description Workspace facts are readable AND writable by the agent: the facts the user added to a chat are injected into its prompt, and the agent gets the search_facts (recall) and create_fact (write) tools.
              * @default true
              */
             FACTS_ENABLED: boolean;
@@ -5091,6 +5091,12 @@ interface components {
              * @default false
              */
             SKILL_CREATION: boolean;
+            /**
+             * Workspace Setup
+             * @description Transient flag set by /setup: create_fact records the interview's answers as user-confirmed facts, shared with the workspace unless the user keeps them private.
+             * @default false
+             */
+            WORKSPACE_SETUP: boolean;
             /**
              * Workspace Tools Enabled
              * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
@@ -5330,7 +5336,7 @@ interface components {
             CONVERSATION_SEARCH_ENABLED: boolean;
             /**
              * Facts Enabled
-             * @description Workspace facts are readable AND writable by the agent: pinned core facts are injected into the prompt, and the agent gets the search_facts (recall) and create_fact (write) tools.
+             * @description Workspace facts are readable AND writable by the agent: the facts the user added to a chat are injected into its prompt, and the agent gets the search_facts (recall) and create_fact (write) tools.
              * @default true
              */
             FACTS_ENABLED: boolean;
@@ -5428,6 +5434,7 @@ interface components {
              *       "PERSIST_LEARNINGS": false,
              *       "SKILLS_ENABLED": false,
              *       "SKILL_CREATION": false,
+             *       "WORKSPACE_SETUP": false,
              *       "WORKSPACE_TOOLS_ENABLED": false,
              *       "REMOTE_CONTROL_ENABLED": false,
              *       "GOALS_ENABLED": false,
@@ -7392,11 +7399,6 @@ interface components {
         CreateFactRequest: {
             /** Text */
             text: string;
-            /**
-             * Pinned
-             * @default false
-             */
-            pinned: boolean;
             /**
              * Shared
              * @default false
@@ -8528,8 +8530,6 @@ interface components {
             external_id: string;
             /** Workspace Ext Id */
             workspace_ext_id: string;
-            /** Pinned */
-            pinned: boolean;
             /** Shared */
             shared: boolean;
             /** Confirmed */
@@ -8569,8 +8569,6 @@ interface components {
             external_id: string;
             /** Text */
             text: string;
-            /** Pinned */
-            pinned: boolean;
             /** Confirmed */
             confirmed: boolean;
             /** Score */
@@ -8624,6 +8622,43 @@ interface components {
             /** Name */
             name: string;
         };
+        /**
+         * FactsContextTool
+         * @description The facts the user added to THIS chat, always in the assistant's context for it.
+         *
+         *     Snapshot semantics, exactly like the in-chat documents: the client sends the chat's full
+         *     fact list on every message and the server reads only the current message's list. Ids are
+         *     pointers (plaintext, like ``doc_ext_ids``); the fact text stays encrypted in ``facts``.
+         */
+        FactsContextTool: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            name: 'facts_context';
+            /**
+             * Description
+             * @default facts in this chat's context
+             */
+            description: string;
+            /**
+             * @default {
+             *       "fact_ext_ids": []
+             *     }
+             */
+            tool_args: components['schemas']['FactsContextToolArgs'];
+        };
+        /**
+         * FactsContextToolArgs
+         * @description Typed arguments for the chat's facts — sibling of ``RetrievalChunkToolArgs.doc_ext_ids``.
+         */
+        FactsContextToolArgs: {
+            /**
+             * Fact Ext Ids
+             * @default []
+             */
+            fact_ext_ids: string[];
+        };
         /**
          * FileDeleteResponse
          * @description OpenAI-compatible file deletion response.
@@ -9782,7 +9817,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']['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'];
             };
             /**
              * Workspace Ext Id
@@ -9871,7 +9906,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']['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'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -9981,7 +10016,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']['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'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -13850,14 +13885,12 @@ interface components {
         /**
          * UpdateFactRequest
          * @description Patch a fact. An edit to ``text`` soft-deletes the old row and
-         *     inserts a replacement (append + soft-delete lifecycle); ``pinned``/``shared``/
+         *     inserts a replacement (append + soft-delete lifecycle); ``shared``/
          *     ``tag_ext_ids`` update in place.
          */
         UpdateFactRequest: {
             /** Text */
             text?: string | null;
-            /** Pinned */
-            pinned?: boolean | null;
             /** Shared */
             shared?: boolean | null;
             /** Confirmed */
@@ -14202,7 +14235,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']['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'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -19042,7 +19075,6 @@ interface operations {
     list_facts: {
         parameters: {
             query?: {
-                pinned_only?: boolean;
                 /** @description Range start, any precision ("2019", "2019-10") */
                 date_from?: string | null;
                 /** @description Range end, any precision */

package/dist/index.d.ts

@@ -2782,7 +2782,7 @@ interface paths {
         head?: never;
         /**
          * Update Fact Endpoint
-         * @description Patch a note. A content edit replaces it (append + soft-delete); pin/share toggle in place.
+         * @description Patch a note. A content edit replaces it (append + soft-delete); share/verify toggle in place.
          */
         patch: operations['update_fact'];
         trace?: never;
@@ -5069,7 +5069,7 @@ interface components {
             PERSONAL_AGENT: boolean;
             /**
              * Facts Enabled
-             * @description Workspace facts are readable AND writable by the agent: pinned core facts are injected into the prompt, and the agent gets the search_facts (recall) and create_fact (write) tools.
+             * @description Workspace facts are readable AND writable by the agent: the facts the user added to a chat are injected into its prompt, and the agent gets the search_facts (recall) and create_fact (write) tools.
              * @default true
              */
             FACTS_ENABLED: boolean;
@@ -5091,6 +5091,12 @@ interface components {
              * @default false
              */
             SKILL_CREATION: boolean;
+            /**
+             * Workspace Setup
+             * @description Transient flag set by /setup: create_fact records the interview's answers as user-confirmed facts, shared with the workspace unless the user keeps them private.
+             * @default false
+             */
+            WORKSPACE_SETUP: boolean;
             /**
              * Workspace Tools Enabled
              * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
@@ -5330,7 +5336,7 @@ interface components {
             CONVERSATION_SEARCH_ENABLED: boolean;
             /**
              * Facts Enabled
-             * @description Workspace facts are readable AND writable by the agent: pinned core facts are injected into the prompt, and the agent gets the search_facts (recall) and create_fact (write) tools.
+             * @description Workspace facts are readable AND writable by the agent: the facts the user added to a chat are injected into its prompt, and the agent gets the search_facts (recall) and create_fact (write) tools.
              * @default true
              */
             FACTS_ENABLED: boolean;
@@ -5428,6 +5434,7 @@ interface components {
              *       "PERSIST_LEARNINGS": false,
              *       "SKILLS_ENABLED": false,
              *       "SKILL_CREATION": false,
+             *       "WORKSPACE_SETUP": false,
              *       "WORKSPACE_TOOLS_ENABLED": false,
              *       "REMOTE_CONTROL_ENABLED": false,
              *       "GOALS_ENABLED": false,
@@ -7392,11 +7399,6 @@ interface components {
         CreateFactRequest: {
             /** Text */
             text: string;
-            /**
-             * Pinned
-             * @default false
-             */
-            pinned: boolean;
             /**
              * Shared
              * @default false
@@ -8528,8 +8530,6 @@ interface components {
             external_id: string;
             /** Workspace Ext Id */
             workspace_ext_id: string;
-            /** Pinned */
-            pinned: boolean;
             /** Shared */
             shared: boolean;
             /** Confirmed */
@@ -8569,8 +8569,6 @@ interface components {
             external_id: string;
             /** Text */
             text: string;
-            /** Pinned */
-            pinned: boolean;
             /** Confirmed */
             confirmed: boolean;
             /** Score */
@@ -8624,6 +8622,43 @@ interface components {
             /** Name */
             name: string;
         };
+        /**
+         * FactsContextTool
+         * @description The facts the user added to THIS chat, always in the assistant's context for it.
+         *
+         *     Snapshot semantics, exactly like the in-chat documents: the client sends the chat's full
+         *     fact list on every message and the server reads only the current message's list. Ids are
+         *     pointers (plaintext, like ``doc_ext_ids``); the fact text stays encrypted in ``facts``.
+         */
+        FactsContextTool: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            name: 'facts_context';
+            /**
+             * Description
+             * @default facts in this chat's context
+             */
+            description: string;
+            /**
+             * @default {
+             *       "fact_ext_ids": []
+             *     }
+             */
+            tool_args: components['schemas']['FactsContextToolArgs'];
+        };
+        /**
+         * FactsContextToolArgs
+         * @description Typed arguments for the chat's facts — sibling of ``RetrievalChunkToolArgs.doc_ext_ids``.
+         */
+        FactsContextToolArgs: {
+            /**
+             * Fact Ext Ids
+             * @default []
+             */
+            fact_ext_ids: string[];
+        };
         /**
          * FileDeleteResponse
          * @description OpenAI-compatible file deletion response.
@@ -9782,7 +9817,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']['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'];
             };
             /**
              * Workspace Ext Id
@@ -9871,7 +9906,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']['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'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -9981,7 +10016,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']['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'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -13850,14 +13885,12 @@ interface components {
         /**
          * UpdateFactRequest
          * @description Patch a fact. An edit to ``text`` soft-deletes the old row and
-         *     inserts a replacement (append + soft-delete lifecycle); ``pinned``/``shared``/
+         *     inserts a replacement (append + soft-delete lifecycle); ``shared``/
          *     ``tag_ext_ids`` update in place.
          */
         UpdateFactRequest: {
             /** Text */
             text?: string | null;
-            /** Pinned */
-            pinned?: boolean | null;
             /** Shared */
             shared?: boolean | null;
             /** Confirmed */
@@ -14202,7 +14235,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']['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'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -19042,7 +19075,6 @@ interface operations {
     list_facts: {
         parameters: {
             query?: {
-                pinned_only?: boolean;
                 /** @description Range start, any precision ("2019", "2019-10") */
                 date_from?: string | null;
                 /** @description Range end, any precision */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/client",
-  "version": "0.4.67",
+  "version": "0.4.68",
   "description": "TypeScript SDK for the ARBI API — zero-knowledge auth, E2E encryption, and type-safe REST client",
   "type": "module",
   "sideEffects": false,