@arbidocs/sdk 0.3.101 → 0.3.102

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { n as ConfigStore, l as CliConfig, m as CliCredentials, C as ChatSession, Z as SkippedFile, a2 as UploadResult, i as AuthHeaders, _ as UploadBatchResult, a1 as UploadOptions, $ as UploadDirectOptions, a0 as UploadDirectResult, X as SUPPORTED_EXTENSIONS, p as DmCryptoContext } from './browser-C59SStkH.cjs';
-export { a as AgentStepEvent, b as Arbi, c as ArbiApiError, d as ArbiError, f as ArbiOptions, g as ArtifactEvent, h as AuthContext, j as AuthenticatedClient, k as CitationSummary, o as ConnectOptions, D as DOC_TERMINAL_STATUSES, q as DocNameMap, r as DocumentListFields, s as DocumentListOrder, t as DocumentWaiter, u as DocumentWaiterOptions, F as FormattedWsMessage, L as ListAllOptions, v as ListPaginatedOptions, M as MessageLevel, w as MessageMetadataPayload, x as MessageQueuedEvent, O as OutputTokensDetails, P as ParsedSlashCommand, Q as QueryOptions, R as ReconnectOptions, y as ReconnectableWsConnection, z as ResolvedCitation, B as ResponseCompletedEvent, E as ResponseContentPartAddedEvent, G as ResponseCreatedEvent, H as ResponseFailedEvent, I as ResponseOutputItemAddedEvent, J as ResponseOutputItemDoneEvent, K as ResponseOutputTextDeltaEvent, N as ResponseOutputTextDoneEvent, S as ResponseUsage, T as SSEEvent, U as SSEStreamCallbacks, V as SSEStreamResult, W as SSEStreamStartData, Y as SkillSummary, a3 as UserInfo, a4 as UserInputRequestEvent, a5 as UserMessageEvent, a6 as WebSocketAuthError, a7 as WorkspaceContext, a8 as WsConnection, a9 as agentconfig, aa as assistant, ab as authenticatedFetch, ac as buildRetrievalChunkTool, ad as buildRetrievalFullContextTool, ae as buildRetrievalTocTool, af as connectWebSocket, ag as connectWithReconnect, ah as consumeSSEStream, ai as contacts, aj as conversations, ak as countCitations, al as createAuthenticatedClient, am as createDocumentWaiter, an as dm, ao as doctags, ap as documents, aq as files, ar as filterSkills, as as formatAgentStepLabel, at as formatFileSize, au as formatStreamSummary, av as formatUserName, aw as formatWorkspaceChoices, ax as formatWsMessage, ay as generateEncryptedWorkspaceKey, az as generateNewWorkspaceKey, aA as getErrorCode, aB as getErrorMessage, aC as getRawWorkspaceKey, aD as health, aE as parseSSEEvents, aF as parseSlashCommand, aG as parseSlashTokenInProgress, aH as performPasswordLogin, aI as performSigningKeyLogin, aJ as performSsoDeviceFlowLogin, aK as requireData, aL as requireOk, aM as resolveAuth, aN as resolveCitations, aO as resolveWorkspace, aP as responses, aQ as selectWorkspace, aR as selectWorkspaceById, aS as settings, aT as streamSSE, aU as stripCitationMarkdown, aV as summarizeCitations, aW as tags, aX as workspaces } from './browser-C59SStkH.cjs';
+import { n as ConfigStore, l as CliConfig, m as CliCredentials, C as ChatSession, a2 as SkippedFile, aa as UploadResult, i as AuthHeaders, a6 as UploadBatchResult, a9 as UploadOptions, a7 as UploadDirectOptions, a8 as UploadDirectResult, a0 as SUPPORTED_EXTENSIONS, r as DmCryptoContext } from './browser-NpucdgQ1.cjs';
+export { a as AgentStepEvent, b as Arbi, c as ArbiApiError, d as ArbiError, f as ArbiOptions, g as ArtifactEvent, h as AuthContext, j as AuthenticatedClient, k as CitationSummary, o as ConnectOptions, D as DOC_TERMINAL_STATUSES, s as DocNameMap, t as DocumentListFields, u as DocumentListOrder, v as DocumentWaiter, w as DocumentWaiterOptions, F as FormattedWsMessage, L as ListAllOptions, x as ListPaginatedOptions, B as MessageLevel, E as MessageMetadataPayload, G as MessageQueuedEvent, O as OutputTokensDetails, P as ParsedSlashCommand, Q as QueryOptions, R as ReconnectOptions, H as ReconnectableWsConnection, I as ResolvedCitation, J as ResponseCompletedEvent, K as ResponseContentPartAddedEvent, N as ResponseCreatedEvent, S as ResponseFailedEvent, T as ResponseOutputItemAddedEvent, U as ResponseOutputItemDoneEvent, V as ResponseOutputTextDeltaEvent, W as ResponseOutputTextDoneEvent, X as ResponseUsage, Y as SSEEvent, Z as SSEStreamCallbacks, _ as SSEStreamResult, $ as SSEStreamStartData, a1 as SkillSummary, ab as UserInfo, ac as UserInputRequestEvent, ad as UserMessageEvent, ae as WebSocketAuthError, af as WorkspaceContext, ag as WsConnection, ah as agentconfig, ai as assistant, aj as authenticatedFetch, ak as buildRetrievalChunkTool, al as buildRetrievalFullContextTool, am as buildRetrievalTocTool, an as connectWebSocket, ao as connectWithReconnect, ap as consumeSSEStream, aq as contacts, ar as conversations, as as countCitations, at as createAuthenticatedClient, au as createDocumentWaiter, av as dm, aw as doctags, ax as documents, ay as files, az as filterSkills, aA as formatAgentStepLabel, aB as formatFileSize, aC as formatStreamSummary, aD as formatUserName, aE as formatWorkspaceChoices, aF as formatWsMessage, aG as generateEncryptedWorkspaceKey, aH as generateNewWorkspaceKey, aI as getErrorCode, aJ as getErrorMessage, aK as getRawWorkspaceKey, aL as health, aN as parseSSEEvents, aO as parseSlashCommand, aP as parseSlashTokenInProgress, aQ as performPasswordLogin, aR as performSigningKeyLogin, aS as performSsoDeviceFlowLogin, aT as requireData, aU as requireOk, aV as resolveAuth, aW as resolveCitations, aX as resolveWorkspace, aY as responses, aZ as selectWorkspace, a_ as selectWorkspaceById, a$ as settings, b0 as streamSSE, b1 as stripCitationMarkdown, b2 as summarizeCitations, b3 as tags, b5 as workspaces } from './browser-NpucdgQ1.cjs';
 import { SessionStorageProvider, ArbiClient, components } from '@arbidocs/client';
 
 /**
@@ -372,19 +372,301 @@ declare namespace documentsNode {
 }
 
 /**
- * Agent operations — list, delete persistent agents.
+ * Agent operations — create, list, delete persistent agents, and read an agent's
+ * pinned config / workspace memberships. An agent is a real `agt-` user the server
+ * logs in on behalf of when a DM, email or scheduled task wakes it.
  */
 
 type UserResponse = components['schemas']['UserResponse'];
+type CreateAgentResponse = components['schemas']['CreateAgentResponse'];
+type AgentWorkspaceResponse = components['schemas']['AgentWorkspaceResponse'];
 declare function listAgents(arbi: ArbiClient): Promise<UserResponse[]>;
+/**
+ * Create a persistent agent. Only `name` is accepted (alphanumeric, `_`/`-`).
+ * The keypair is server-generated; `signing_private_key` is returned ONCE.
+ * Pin a behaviour by saving a config with this agent's `agent_ext_id`.
+ */
+declare function createAgent(arbi: ArbiClient, name: string): Promise<CreateAgentResponse>;
+/** Read an agent's pinned configuration (its `settings.last_config`). */
+declare function getAgentConfig(arbi: ArbiClient, agentExtId: string): Promise<{
+    Agents: {
+        ENABLED: boolean;
+        HUMAN_IN_THE_LOOP: boolean;
+        WEB_SEARCH_ENABLED: boolean;
+        RUN_CODE_ENABLED: boolean;
+        MCP_TOOLS: string[];
+        PLANNING_ENABLED: boolean;
+        DEEP_RESEARCH_ENABLED: boolean;
+        SUGGESTED_QUERIES: boolean;
+        ARTIFACTS_ENABLED: boolean;
+        VISION_ENABLED: boolean;
+        CONVERSATION_SEARCH_ENABLED: boolean;
+        PERSONAL_AGENT: boolean;
+        MEMORY_ENABLED: boolean;
+        PERSIST_LEARNINGS: boolean;
+        SKILLS_ENABLED: boolean;
+        SKILL_CREATION: boolean;
+        WORKSPACE_TOOLS_ENABLED: boolean;
+        ENABLED_SKILLS?: string[] | null | undefined;
+        MEMORY_CREATION: boolean;
+        GOALS_ENABLED: boolean;
+        GOAL_MAX_OUTER_LOOPS: number;
+        PERSONA: string;
+        AGENT_MODEL_NAME: string;
+        AGENT_API_TYPE: "local" | "remote";
+        LLM_AGENT_TEMPERATURE: number;
+        AGENT_MAX_TOKENS: number;
+        ENABLE_THINKING: boolean;
+        AGENT_STRICT_TOOL_CALLS: boolean;
+        AGENT_MAX_ITERATIONS: number;
+        AGENT_MAX_PARALLEL_TOOL_CALLS: number;
+        AGENT_HISTORY_CHAR_THRESHOLD: number;
+        AGENT_SYSTEM_PROMPT: string;
+    };
+    QueryLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+    };
+    ReviewLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+    };
+    EvaluatorLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+    };
+    TitleLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+    };
+    SummariseLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+        COMPACTION_THRESHOLD_TOKENS: number;
+        COMPACTION_KEEP_RECENT: number;
+    };
+    DoctagLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        MAX_TOKEN_CONTEXT_TO_ANSWER: number;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_CONCURRENT_DOCS: number;
+        AUTO_RENAME: boolean;
+        AUTO_RENAME_INSTRUCTION: string;
+        DEFAULT_METADATA_TAGS?: {
+            name: string;
+            instruction?: string | null | undefined;
+            tag_type?: {
+                type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+                options: string[];
+            } | undefined;
+        }[] | undefined;
+    };
+    MemoryLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_CONTEXT: number;
+        MAX_CONCURRENT: number;
+    };
+    PlanningLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+        APPROVAL_TIMEOUT: number;
+    };
+    FilterPlanLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+    };
+    VisionLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_PAGES_PER_CALL: number;
+        IMAGE_MAX_DIMENSION: number;
+    };
+    CodeAgent: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_ITERATIONS: number;
+    };
+    ModelCitation: {
+        SIM_THREASHOLD: number;
+        MIN_CHAR_SIZE_TO_ANSWER: number;
+        MAX_NUMB_CITATIONS: number;
+        CITATION_INSTRUCTION: string;
+    };
+    WebSearch: {
+        SAVE_SOURCES: boolean;
+    };
+    RunCode: {
+        IMAGE: string;
+        TIMEOUT_SECONDS: number;
+        MEMORY_LIMIT: string;
+        NETWORK: string;
+    };
+    Retriever: {
+        agent?: {
+            MIN_RETRIEVAL_SIM_SCORE: number;
+            KEYWORD_MIN_TERM_OVERLAP_RATIO: number;
+            MAX_DISTINCT_DOCUMENTS: number;
+            MAX_TOTAL_CHUNKS_TO_RETRIEVE: number;
+            GROUP_SIZE: number;
+            SEARCH_MODE: components["schemas"]["SearchMode"];
+            HYBRID_PREFETCH_LIMIT: number;
+            HYBRID_DENSE_WEIGHT: number;
+            HYBRID_SPARSE_WEIGHT: number;
+        } | undefined;
+        smart_search?: {
+            MIN_RETRIEVAL_SIM_SCORE: number;
+            KEYWORD_MIN_TERM_OVERLAP_RATIO: number;
+            MAX_DISTINCT_DOCUMENTS: number;
+            MAX_TOTAL_CHUNKS_TO_RETRIEVE: number;
+            GROUP_SIZE: number;
+            SEARCH_MODE: components["schemas"]["SearchMode"];
+            HYBRID_PREFETCH_LIMIT: number;
+            HYBRID_DENSE_WEIGHT: number;
+            HYBRID_SPARSE_WEIGHT: number;
+        } | undefined;
+    };
+    Reranker: {
+        agent?: {
+            MIN_SCORE: number;
+            MAX_NUMB_OF_CHUNKS: number;
+        } | undefined;
+        smart_search?: {
+            MIN_SCORE: number;
+            MAX_NUMB_OF_CHUNKS: number;
+        } | undefined;
+        MAX_CONCURRENT_REQUESTS: number;
+        MODEL_NAME: string;
+        API_TYPE: "local" | "remote";
+        RETRIEVAL_INSTRUCTION: string;
+    };
+    Parser: {
+        SKIP_DUPLICATES: boolean;
+    };
+    Chunker: {
+        MAX_CHUNK_TOKENS: number;
+        TOKENIZER_NAME: string;
+    };
+    Embedder: {
+        MODEL_NAME: string;
+        API_TYPE: "local" | "remote";
+        BATCH_SIZE: number;
+        MAX_CONCURRENT_REQUESTS: number;
+        DOCUMENT_PREFIX: string;
+        QUERY_PREFIX: string;
+    };
+    KeywordEmbedder: {
+        DIMENSION_SPACE: number;
+        FILTER_STOPWORDS: boolean;
+        BM25_K1: number;
+        BM25_B: number;
+        BM25_AVGDL: number;
+        CJK_NGRAM_SIZE: number;
+        NORMALIZE_TRADITIONAL_TO_SIMPLIFIED: boolean;
+    };
+} | {
+    Agents: {
+        ENABLED: boolean;
+        HUMAN_IN_THE_LOOP: boolean;
+        WEB_SEARCH_ENABLED: boolean;
+        RUN_CODE_ENABLED: boolean;
+        MCP_TOOLS: string[];
+        PLANNING_ENABLED: boolean;
+        DEEP_RESEARCH_ENABLED: boolean;
+        SUGGESTED_QUERIES: boolean;
+        ARTIFACTS_ENABLED: boolean;
+        VISION_ENABLED: boolean;
+        CONVERSATION_SEARCH_ENABLED: boolean;
+        MEMORY_ENABLED: boolean;
+        PERSIST_LEARNINGS: boolean;
+        SKILLS_ENABLED: boolean;
+        WORKSPACE_TOOLS_ENABLED: boolean;
+        ENABLED_SKILLS?: string[] | null | undefined;
+        GOALS_ENABLED: boolean;
+        GOAL_MAX_OUTER_LOOPS: number;
+        PERSONA: string;
+        AGENT_MODEL_NAME: string;
+        ENABLE_THINKING: boolean;
+        AGENT_MAX_ITERATIONS: number;
+    };
+    DoctagLLM: {
+        AUTO_RENAME: boolean;
+        AUTO_RENAME_INSTRUCTION: string;
+        DEFAULT_METADATA_TAGS?: {
+            name: string;
+            instruction?: string | null | undefined;
+            tag_type?: {
+                type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+                options: string[];
+            } | undefined;
+        }[] | undefined;
+    };
+    Parser: {
+        SKIP_DUPLICATES: boolean;
+    };
+}>;
+/** List the workspaces an agent is a member of. */
+declare function listAgentWorkspaces(arbi: ArbiClient, agentExtId: string): Promise<AgentWorkspaceResponse[]>;
 declare function deleteAgents(arbi: ArbiClient, agentExtIds: string[]): Promise<{
     [x: string]: unknown;
 }>;
 
+declare const agents_createAgent: typeof createAgent;
 declare const agents_deleteAgents: typeof deleteAgents;
+declare const agents_getAgentConfig: typeof getAgentConfig;
+declare const agents_listAgentWorkspaces: typeof listAgentWorkspaces;
 declare const agents_listAgents: typeof listAgents;
 declare namespace agents {
-  export { agents_deleteAgents as deleteAgents, agents_listAgents as listAgents };
+  export { agents_createAgent as createAgent, agents_deleteAgents as deleteAgents, agents_getAgentConfig as getAgentConfig, agents_listAgentWorkspaces as listAgentWorkspaces, agents_listAgents as listAgents };
 }
 
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { n as ConfigStore, l as CliConfig, m as CliCredentials, C as ChatSession, Z as SkippedFile, a2 as UploadResult, i as AuthHeaders, _ as UploadBatchResult, a1 as UploadOptions, $ as UploadDirectOptions, a0 as UploadDirectResult, X as SUPPORTED_EXTENSIONS, p as DmCryptoContext } from './browser-C59SStkH.js';
-export { a as AgentStepEvent, b as Arbi, c as ArbiApiError, d as ArbiError, f as ArbiOptions, g as ArtifactEvent, h as AuthContext, j as AuthenticatedClient, k as CitationSummary, o as ConnectOptions, D as DOC_TERMINAL_STATUSES, q as DocNameMap, r as DocumentListFields, s as DocumentListOrder, t as DocumentWaiter, u as DocumentWaiterOptions, F as FormattedWsMessage, L as ListAllOptions, v as ListPaginatedOptions, M as MessageLevel, w as MessageMetadataPayload, x as MessageQueuedEvent, O as OutputTokensDetails, P as ParsedSlashCommand, Q as QueryOptions, R as ReconnectOptions, y as ReconnectableWsConnection, z as ResolvedCitation, B as ResponseCompletedEvent, E as ResponseContentPartAddedEvent, G as ResponseCreatedEvent, H as ResponseFailedEvent, I as ResponseOutputItemAddedEvent, J as ResponseOutputItemDoneEvent, K as ResponseOutputTextDeltaEvent, N as ResponseOutputTextDoneEvent, S as ResponseUsage, T as SSEEvent, U as SSEStreamCallbacks, V as SSEStreamResult, W as SSEStreamStartData, Y as SkillSummary, a3 as UserInfo, a4 as UserInputRequestEvent, a5 as UserMessageEvent, a6 as WebSocketAuthError, a7 as WorkspaceContext, a8 as WsConnection, a9 as agentconfig, aa as assistant, ab as authenticatedFetch, ac as buildRetrievalChunkTool, ad as buildRetrievalFullContextTool, ae as buildRetrievalTocTool, af as connectWebSocket, ag as connectWithReconnect, ah as consumeSSEStream, ai as contacts, aj as conversations, ak as countCitations, al as createAuthenticatedClient, am as createDocumentWaiter, an as dm, ao as doctags, ap as documents, aq as files, ar as filterSkills, as as formatAgentStepLabel, at as formatFileSize, au as formatStreamSummary, av as formatUserName, aw as formatWorkspaceChoices, ax as formatWsMessage, ay as generateEncryptedWorkspaceKey, az as generateNewWorkspaceKey, aA as getErrorCode, aB as getErrorMessage, aC as getRawWorkspaceKey, aD as health, aE as parseSSEEvents, aF as parseSlashCommand, aG as parseSlashTokenInProgress, aH as performPasswordLogin, aI as performSigningKeyLogin, aJ as performSsoDeviceFlowLogin, aK as requireData, aL as requireOk, aM as resolveAuth, aN as resolveCitations, aO as resolveWorkspace, aP as responses, aQ as selectWorkspace, aR as selectWorkspaceById, aS as settings, aT as streamSSE, aU as stripCitationMarkdown, aV as summarizeCitations, aW as tags, aX as workspaces } from './browser-C59SStkH.js';
+import { n as ConfigStore, l as CliConfig, m as CliCredentials, C as ChatSession, a2 as SkippedFile, aa as UploadResult, i as AuthHeaders, a6 as UploadBatchResult, a9 as UploadOptions, a7 as UploadDirectOptions, a8 as UploadDirectResult, a0 as SUPPORTED_EXTENSIONS, r as DmCryptoContext } from './browser-NpucdgQ1.js';
+export { a as AgentStepEvent, b as Arbi, c as ArbiApiError, d as ArbiError, f as ArbiOptions, g as ArtifactEvent, h as AuthContext, j as AuthenticatedClient, k as CitationSummary, o as ConnectOptions, D as DOC_TERMINAL_STATUSES, s as DocNameMap, t as DocumentListFields, u as DocumentListOrder, v as DocumentWaiter, w as DocumentWaiterOptions, F as FormattedWsMessage, L as ListAllOptions, x as ListPaginatedOptions, B as MessageLevel, E as MessageMetadataPayload, G as MessageQueuedEvent, O as OutputTokensDetails, P as ParsedSlashCommand, Q as QueryOptions, R as ReconnectOptions, H as ReconnectableWsConnection, I as ResolvedCitation, J as ResponseCompletedEvent, K as ResponseContentPartAddedEvent, N as ResponseCreatedEvent, S as ResponseFailedEvent, T as ResponseOutputItemAddedEvent, U as ResponseOutputItemDoneEvent, V as ResponseOutputTextDeltaEvent, W as ResponseOutputTextDoneEvent, X as ResponseUsage, Y as SSEEvent, Z as SSEStreamCallbacks, _ as SSEStreamResult, $ as SSEStreamStartData, a1 as SkillSummary, ab as UserInfo, ac as UserInputRequestEvent, ad as UserMessageEvent, ae as WebSocketAuthError, af as WorkspaceContext, ag as WsConnection, ah as agentconfig, ai as assistant, aj as authenticatedFetch, ak as buildRetrievalChunkTool, al as buildRetrievalFullContextTool, am as buildRetrievalTocTool, an as connectWebSocket, ao as connectWithReconnect, ap as consumeSSEStream, aq as contacts, ar as conversations, as as countCitations, at as createAuthenticatedClient, au as createDocumentWaiter, av as dm, aw as doctags, ax as documents, ay as files, az as filterSkills, aA as formatAgentStepLabel, aB as formatFileSize, aC as formatStreamSummary, aD as formatUserName, aE as formatWorkspaceChoices, aF as formatWsMessage, aG as generateEncryptedWorkspaceKey, aH as generateNewWorkspaceKey, aI as getErrorCode, aJ as getErrorMessage, aK as getRawWorkspaceKey, aL as health, aN as parseSSEEvents, aO as parseSlashCommand, aP as parseSlashTokenInProgress, aQ as performPasswordLogin, aR as performSigningKeyLogin, aS as performSsoDeviceFlowLogin, aT as requireData, aU as requireOk, aV as resolveAuth, aW as resolveCitations, aX as resolveWorkspace, aY as responses, aZ as selectWorkspace, a_ as selectWorkspaceById, a$ as settings, b0 as streamSSE, b1 as stripCitationMarkdown, b2 as summarizeCitations, b3 as tags, b5 as workspaces } from './browser-NpucdgQ1.js';
 import { SessionStorageProvider, ArbiClient, components } from '@arbidocs/client';
 
 /**
@@ -372,19 +372,301 @@ declare namespace documentsNode {
 }
 
 /**
- * Agent operations — list, delete persistent agents.
+ * Agent operations — create, list, delete persistent agents, and read an agent's
+ * pinned config / workspace memberships. An agent is a real `agt-` user the server
+ * logs in on behalf of when a DM, email or scheduled task wakes it.
  */
 
 type UserResponse = components['schemas']['UserResponse'];
+type CreateAgentResponse = components['schemas']['CreateAgentResponse'];
+type AgentWorkspaceResponse = components['schemas']['AgentWorkspaceResponse'];
 declare function listAgents(arbi: ArbiClient): Promise<UserResponse[]>;
+/**
+ * Create a persistent agent. Only `name` is accepted (alphanumeric, `_`/`-`).
+ * The keypair is server-generated; `signing_private_key` is returned ONCE.
+ * Pin a behaviour by saving a config with this agent's `agent_ext_id`.
+ */
+declare function createAgent(arbi: ArbiClient, name: string): Promise<CreateAgentResponse>;
+/** Read an agent's pinned configuration (its `settings.last_config`). */
+declare function getAgentConfig(arbi: ArbiClient, agentExtId: string): Promise<{
+    Agents: {
+        ENABLED: boolean;
+        HUMAN_IN_THE_LOOP: boolean;
+        WEB_SEARCH_ENABLED: boolean;
+        RUN_CODE_ENABLED: boolean;
+        MCP_TOOLS: string[];
+        PLANNING_ENABLED: boolean;
+        DEEP_RESEARCH_ENABLED: boolean;
+        SUGGESTED_QUERIES: boolean;
+        ARTIFACTS_ENABLED: boolean;
+        VISION_ENABLED: boolean;
+        CONVERSATION_SEARCH_ENABLED: boolean;
+        PERSONAL_AGENT: boolean;
+        MEMORY_ENABLED: boolean;
+        PERSIST_LEARNINGS: boolean;
+        SKILLS_ENABLED: boolean;
+        SKILL_CREATION: boolean;
+        WORKSPACE_TOOLS_ENABLED: boolean;
+        ENABLED_SKILLS?: string[] | null | undefined;
+        MEMORY_CREATION: boolean;
+        GOALS_ENABLED: boolean;
+        GOAL_MAX_OUTER_LOOPS: number;
+        PERSONA: string;
+        AGENT_MODEL_NAME: string;
+        AGENT_API_TYPE: "local" | "remote";
+        LLM_AGENT_TEMPERATURE: number;
+        AGENT_MAX_TOKENS: number;
+        ENABLE_THINKING: boolean;
+        AGENT_STRICT_TOOL_CALLS: boolean;
+        AGENT_MAX_ITERATIONS: number;
+        AGENT_MAX_PARALLEL_TOOL_CALLS: number;
+        AGENT_HISTORY_CHAR_THRESHOLD: number;
+        AGENT_SYSTEM_PROMPT: string;
+    };
+    QueryLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+    };
+    ReviewLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+    };
+    EvaluatorLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+    };
+    TitleLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+    };
+    SummariseLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+        COMPACTION_THRESHOLD_TOKENS: number;
+        COMPACTION_KEEP_RECENT: number;
+    };
+    DoctagLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        MAX_TOKEN_CONTEXT_TO_ANSWER: number;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_CONCURRENT_DOCS: number;
+        AUTO_RENAME: boolean;
+        AUTO_RENAME_INSTRUCTION: string;
+        DEFAULT_METADATA_TAGS?: {
+            name: string;
+            instruction?: string | null | undefined;
+            tag_type?: {
+                type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+                options: string[];
+            } | undefined;
+        }[] | undefined;
+    };
+    MemoryLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_CONTEXT: number;
+        MAX_CONCURRENT: number;
+    };
+    PlanningLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_TOKEN_SIZE_TO_ANSWER: number;
+        APPROVAL_TIMEOUT: number;
+    };
+    FilterPlanLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+    };
+    VisionLLM: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_PAGES_PER_CALL: number;
+        IMAGE_MAX_DIMENSION: number;
+    };
+    CodeAgent: {
+        API_TYPE: "local" | "remote";
+        ENABLE_THINKING: boolean;
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_ITERATIONS: number;
+    };
+    ModelCitation: {
+        SIM_THREASHOLD: number;
+        MIN_CHAR_SIZE_TO_ANSWER: number;
+        MAX_NUMB_CITATIONS: number;
+        CITATION_INSTRUCTION: string;
+    };
+    WebSearch: {
+        SAVE_SOURCES: boolean;
+    };
+    RunCode: {
+        IMAGE: string;
+        TIMEOUT_SECONDS: number;
+        MEMORY_LIMIT: string;
+        NETWORK: string;
+    };
+    Retriever: {
+        agent?: {
+            MIN_RETRIEVAL_SIM_SCORE: number;
+            KEYWORD_MIN_TERM_OVERLAP_RATIO: number;
+            MAX_DISTINCT_DOCUMENTS: number;
+            MAX_TOTAL_CHUNKS_TO_RETRIEVE: number;
+            GROUP_SIZE: number;
+            SEARCH_MODE: components["schemas"]["SearchMode"];
+            HYBRID_PREFETCH_LIMIT: number;
+            HYBRID_DENSE_WEIGHT: number;
+            HYBRID_SPARSE_WEIGHT: number;
+        } | undefined;
+        smart_search?: {
+            MIN_RETRIEVAL_SIM_SCORE: number;
+            KEYWORD_MIN_TERM_OVERLAP_RATIO: number;
+            MAX_DISTINCT_DOCUMENTS: number;
+            MAX_TOTAL_CHUNKS_TO_RETRIEVE: number;
+            GROUP_SIZE: number;
+            SEARCH_MODE: components["schemas"]["SearchMode"];
+            HYBRID_PREFETCH_LIMIT: number;
+            HYBRID_DENSE_WEIGHT: number;
+            HYBRID_SPARSE_WEIGHT: number;
+        } | undefined;
+    };
+    Reranker: {
+        agent?: {
+            MIN_SCORE: number;
+            MAX_NUMB_OF_CHUNKS: number;
+        } | undefined;
+        smart_search?: {
+            MIN_SCORE: number;
+            MAX_NUMB_OF_CHUNKS: number;
+        } | undefined;
+        MAX_CONCURRENT_REQUESTS: number;
+        MODEL_NAME: string;
+        API_TYPE: "local" | "remote";
+        RETRIEVAL_INSTRUCTION: string;
+    };
+    Parser: {
+        SKIP_DUPLICATES: boolean;
+    };
+    Chunker: {
+        MAX_CHUNK_TOKENS: number;
+        TOKENIZER_NAME: string;
+    };
+    Embedder: {
+        MODEL_NAME: string;
+        API_TYPE: "local" | "remote";
+        BATCH_SIZE: number;
+        MAX_CONCURRENT_REQUESTS: number;
+        DOCUMENT_PREFIX: string;
+        QUERY_PREFIX: string;
+    };
+    KeywordEmbedder: {
+        DIMENSION_SPACE: number;
+        FILTER_STOPWORDS: boolean;
+        BM25_K1: number;
+        BM25_B: number;
+        BM25_AVGDL: number;
+        CJK_NGRAM_SIZE: number;
+        NORMALIZE_TRADITIONAL_TO_SIMPLIFIED: boolean;
+    };
+} | {
+    Agents: {
+        ENABLED: boolean;
+        HUMAN_IN_THE_LOOP: boolean;
+        WEB_SEARCH_ENABLED: boolean;
+        RUN_CODE_ENABLED: boolean;
+        MCP_TOOLS: string[];
+        PLANNING_ENABLED: boolean;
+        DEEP_RESEARCH_ENABLED: boolean;
+        SUGGESTED_QUERIES: boolean;
+        ARTIFACTS_ENABLED: boolean;
+        VISION_ENABLED: boolean;
+        CONVERSATION_SEARCH_ENABLED: boolean;
+        MEMORY_ENABLED: boolean;
+        PERSIST_LEARNINGS: boolean;
+        SKILLS_ENABLED: boolean;
+        WORKSPACE_TOOLS_ENABLED: boolean;
+        ENABLED_SKILLS?: string[] | null | undefined;
+        GOALS_ENABLED: boolean;
+        GOAL_MAX_OUTER_LOOPS: number;
+        PERSONA: string;
+        AGENT_MODEL_NAME: string;
+        ENABLE_THINKING: boolean;
+        AGENT_MAX_ITERATIONS: number;
+    };
+    DoctagLLM: {
+        AUTO_RENAME: boolean;
+        AUTO_RENAME_INSTRUCTION: string;
+        DEFAULT_METADATA_TAGS?: {
+            name: string;
+            instruction?: string | null | undefined;
+            tag_type?: {
+                type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+                options: string[];
+            } | undefined;
+        }[] | undefined;
+    };
+    Parser: {
+        SKIP_DUPLICATES: boolean;
+    };
+}>;
+/** List the workspaces an agent is a member of. */
+declare function listAgentWorkspaces(arbi: ArbiClient, agentExtId: string): Promise<AgentWorkspaceResponse[]>;
 declare function deleteAgents(arbi: ArbiClient, agentExtIds: string[]): Promise<{
     [x: string]: unknown;
 }>;
 
+declare const agents_createAgent: typeof createAgent;
 declare const agents_deleteAgents: typeof deleteAgents;
+declare const agents_getAgentConfig: typeof getAgentConfig;
+declare const agents_listAgentWorkspaces: typeof listAgentWorkspaces;
 declare const agents_listAgents: typeof listAgents;
 declare namespace agents {
-  export { agents_deleteAgents as deleteAgents, agents_listAgents as listAgents };
+  export { agents_createAgent as createAgent, agents_deleteAgents as deleteAgents, agents_getAgentConfig as getAgentConfig, agents_listAgentWorkspaces as listAgentWorkspaces, agents_listAgents as listAgents };
 }
 
 /**