@arbidocs/sdk 0.3.19 → 0.3.20

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { C as ConfigStore, a as CliConfig, b as CliCredentials, c as ChatSession, A as AuthHeaders, U as UploadBatchResult, d as UploadOptions, e as UploadResult } from './browser-D8aF-wkt.cjs';
-export { f as AgentStepEvent, g as Arbi, h as ArbiApiError, i as ArbiError, j as ArbiOptions, k as ArtifactEvent, l as AuthContext, m as AuthenticatedClient, n as CitationSummary, o as ConnectOptions, D as DocumentWaiter, p as DocumentWaiterOptions, F as FormattedWsMessage, M as MessageLevel, q as MessageMetadataPayload, r as MessageQueuedEvent, O as OutputTokensDetails, Q as QueryOptions, R as ReconnectOptions, s as ReconnectableWsConnection, t as ResolvedCitation, u as ResponseCompletedEvent, v as ResponseContentPartAddedEvent, w as ResponseCreatedEvent, x as ResponseFailedEvent, y as ResponseOutputItemAddedEvent, z as ResponseOutputItemDoneEvent, B as ResponseOutputTextDeltaEvent, E as ResponseOutputTextDoneEvent, G as ResponseUsage, S as SSEEvent, H as SSEStreamCallbacks, I as SSEStreamResult, J as SSEStreamStartData, K as UserInfo, L as UserInputRequestEvent, N as UserMessageEvent, W as WorkspaceContext, P as WsConnection, T as agentconfig, V as assistant, X as authenticatedFetch, Y as buildRetrievalChunkTool, Z as buildRetrievalFullContextTool, _ as buildRetrievalTocTool, $ as connectWebSocket, a0 as connectWithReconnect, a1 as consumeSSEStream, a2 as contacts, a3 as conversations, a4 as countCitations, a5 as createAuthenticatedClient, a6 as createDocumentWaiter, a7 as dm, a8 as doctags, a9 as documents, aa as files, ab as formatAgentStepLabel, ac as formatFileSize, ad as formatStreamSummary, ae as formatUserName, af as formatWorkspaceChoices, ag as formatWsMessage, ah as generateEncryptedWorkspaceKey, ai as getErrorCode, aj as getErrorMessage, ak as health, al as parseSSEEvents, am as performPasswordLogin, an as performSsoDeviceFlowLogin, ao as requireData, ap as requireOk, aq as resolveAuth, ar as resolveCitations, as as resolveWorkspace, at as responses, au as selectWorkspace, av as selectWorkspaceById, aw as settings, ax as streamSSE, ay as stripCitationMarkdown, az as summarizeCitations, aA as tags, aB as workspaces } from './browser-D8aF-wkt.cjs';
-import '@arbidocs/client';
+import { C as ConfigStore, a as CliConfig, b as CliCredentials, c as ChatSession, A as AuthHeaders, U as UploadBatchResult, d as UploadOptions, e as UploadResult, D as DmCryptoContext } from './browser-z9a2abGo.cjs';
+export { f as AgentStepEvent, g as Arbi, h as ArbiApiError, i as ArbiError, j as ArbiOptions, k as ArtifactEvent, l as AuthContext, m as AuthenticatedClient, n as CitationSummary, o as ConnectOptions, p as DocumentWaiter, q as DocumentWaiterOptions, F as FormattedWsMessage, M as MessageLevel, r as MessageMetadataPayload, s as MessageQueuedEvent, O as OutputTokensDetails, Q as QueryOptions, R as ReconnectOptions, t as ReconnectableWsConnection, u as ResolvedCitation, v as ResponseCompletedEvent, w as ResponseContentPartAddedEvent, x as ResponseCreatedEvent, y as ResponseFailedEvent, z as ResponseOutputItemAddedEvent, B as ResponseOutputItemDoneEvent, E as ResponseOutputTextDeltaEvent, G as ResponseOutputTextDoneEvent, H as ResponseUsage, S as SSEEvent, I as SSEStreamCallbacks, J as SSEStreamResult, K as SSEStreamStartData, L as UserInfo, N as UserInputRequestEvent, P as UserMessageEvent, W as WorkspaceContext, T as WsConnection, V as agentconfig, X as assistant, Y as authenticatedFetch, Z as buildRetrievalChunkTool, _ as buildRetrievalFullContextTool, $ as buildRetrievalTocTool, a0 as connectWebSocket, a1 as connectWithReconnect, a2 as consumeSSEStream, a3 as contacts, a4 as conversations, a5 as countCitations, a6 as createAuthenticatedClient, a7 as createDocumentWaiter, a8 as dm, a9 as doctags, aa as documents, ab as files, ac as formatAgentStepLabel, ad as formatFileSize, ae as formatStreamSummary, af as formatUserName, ag as formatWorkspaceChoices, ah as formatWsMessage, ai as generateEncryptedWorkspaceKey, aj as generateNewWorkspaceKey, ak as getErrorCode, al as getErrorMessage, am as health, an as parseSSEEvents, ao as performPasswordLogin, ap as performSsoDeviceFlowLogin, aq as requireData, ar as requireOk, as as resolveAuth, at as resolveCitations, au as resolveWorkspace, av as responses, aw as selectWorkspace, ax as selectWorkspaceById, ay as settings, az as streamSSE, aA as stripCitationMarkdown, aB as summarizeCitations, aC as tags, aD as workspaces } from './browser-z9a2abGo.cjs';
+import { ArbiClient, components } from '@arbidocs/client';
 
 /**
  * Configuration persistence — file-based implementation for Node.js environments.
@@ -150,4 +150,232 @@ declare namespace documentsNode {
   export { documentsNode_uploadDirectory as uploadDirectory, documentsNode_uploadLocalFile as uploadLocalFile, documentsNode_uploadZip as uploadZip };
 }
 
-export { AuthHeaders, ChatSession, CliConfig, CliCredentials, ConfigStore, FileConfigStore, deviceFlow, documentsNode };
+/**
+ * Agent operations — list, delete persistent agents.
+ */
+
+type UserResponse = components['schemas']['UserResponse'];
+declare function listAgents(arbi: ArbiClient): Promise<UserResponse[]>;
+declare function deleteAgents(arbi: ArbiClient, agentExtIds: string[]): Promise<{
+    [x: string]: unknown;
+}>;
+
+declare const agents_deleteAgents: typeof deleteAgents;
+declare const agents_listAgents: typeof listAgents;
+declare namespace agents {
+  export { agents_deleteAgents as deleteAgents, agents_listAgents as listAgents };
+}
+
+/**
+ * Session operations — list active sessions, authorize delegation, claim codes.
+ */
+
+type SessionInfoResponse = components['schemas']['SessionInfoResponse'];
+type AuthorizeResponse = components['schemas']['AuthorizeResponse'];
+type LoginResponse = components['schemas']['LoginResponse'];
+/**
+ * List all active sessions for the current user.
+ * Agents/delegated sessions see only their own session.
+ */
+declare function listSessions(arbi: ArbiClient): Promise<SessionInfoResponse[]>;
+/**
+ * Create a delegated session with pre-populated workspace keys.
+ * Returns a 3-word claim code for the recipient.
+ *
+ * @param workspaces - Map of workspace_ext_id to SealedBox-encrypted workspace key
+ * @param options.activeWorkspace - Which workspace to set active (defaults to first)
+ * @param options.ttl - Session TTL in seconds (60-604800, default 3600)
+ * @param options.persistIdentity - If true, claim creates a persistent Agent identity
+ * @param options.name - Human-readable name for persistent agents
+ */
+declare function authorizeSession(arbi: ArbiClient, workspaces: Record<string, string>, options?: {
+    activeWorkspace?: string;
+    ttl?: number;
+    persistIdentity?: boolean;
+    name?: string;
+}): Promise<AuthorizeResponse>;
+/**
+ * Claim an agent session using a 3-word code.
+ * Returns a JWT token and optionally an agent_ext_id for persistent agents.
+ *
+ * @param claimCode - The 3-word claim code (e.g. "purple-mountain-river")
+ * @param signingKey - Ed25519 public key (required for persistent agents)
+ */
+declare function claimSession(arbi: ArbiClient, claimCode: string, signingKey?: string): Promise<LoginResponse>;
+
+declare const sessions_authorizeSession: typeof authorizeSession;
+declare const sessions_claimSession: typeof claimSession;
+declare const sessions_listSessions: typeof listSessions;
+declare namespace sessions {
+  export { sessions_authorizeSession as authorizeSession, sessions_claimSession as claimSession, sessions_listSessions as listSessions };
+}
+
+/**
+ * Orchestrator interface for `arbi listen`.
+ *
+ * An orchestrator is an external agent that receives prompts and returns responses.
+ * ARBI acts as the transport layer (encrypted DMs); the orchestrator does the thinking.
+ */
+interface Orchestrator {
+    /** Human-readable name (e.g. "claude", "openclaw") */
+    readonly name: string;
+    /**
+     * Send a prompt to the orchestrator and collect the response.
+     *
+     * @param prompt - The decrypted DM content to process
+     * @param context - Optional metadata about the message
+     * @returns The orchestrator's text response
+     */
+    prompt(prompt: string, context?: PromptContext): Promise<string>;
+    /** Clean up resources (kill child processes, close connections, etc.) */
+    close?(): Promise<void>;
+}
+interface PromptContext {
+    /** Sender's external_id */
+    senderExtId?: string;
+    /** Sender's email */
+    senderEmail?: string;
+    /** Workspace context (if any) */
+    workspaceId?: string;
+}
+
+/**
+ * Claude Code integration.
+ *
+ * Spawns `claude -p <prompt> --output-format text` as a child process for each prompt.
+ * The prompt is passed as a CLI argument (not stdin).
+ *
+ * Conversation continuity: first prompt uses --session-id to create a session,
+ * subsequent prompts use --resume to continue it. The session ID is derived
+ * from the agent's ext_id so it's stable across restarts.
+ *
+ * The ARBI SKILL.md is injected via --append-system-prompt so Claude knows
+ * which CLI commands are available.
+ */
+
+interface ClaudeOrchestratorOptions {
+    /** Path to the claude CLI binary (defaults to "claude") */
+    binaryPath?: string;
+    /** ARBI session identifier — used to maintain Claude conversation continuity */
+    sessionId: string;
+    /** Additional CLI flags (e.g. ["--model", "opus"]) */
+    extraArgs?: string[];
+    /** Timeout in ms per prompt (defaults to 300_000 = 5 min) */
+    timeoutMs?: number;
+    /** Override SKILL.md content (defaults to loading from arbi-cli package) */
+    skillPrompt?: string;
+}
+declare class ClaudeOrchestrator implements Orchestrator {
+    readonly name = "claude";
+    private readonly binaryPath;
+    private readonly extraArgs;
+    private readonly timeoutMs;
+    private readonly claudeSessionId;
+    private readonly skillPrompt;
+    private sessionStarted;
+    constructor(options: ClaudeOrchestratorOptions);
+    prompt(prompt: string, _context?: PromptContext): Promise<string>;
+    private spawnClaude;
+    close(): Promise<void>;
+}
+
+/**
+ * OpenClaw integration.
+ *
+ * Spawns `openclaw agent --agent <id> --message <prompt> --json` as a child
+ * process for each prompt. The gateway handles routing, model selection, and
+ * session memory.
+ *
+ * Session isolation: uses `--session-id` to keep conversations separate per
+ * ARBI user. The OpenClaw agent id (e.g. "arbi") is created once during
+ * `arbi connect --agent openclaw` via `openclaw agents add`.
+ *
+ * The ARBI SKILL.md is installed as BOOTSTRAP.md in the agent's workspace
+ * during setup, so the agent always has context about arbi commands.
+ */
+
+interface OpenClawOrchestratorOptions {
+    /** Path to the openclaw CLI binary (defaults to "openclaw") */
+    binaryPath?: string;
+    /** ARBI session identifier — used for OpenClaw session isolation */
+    sessionId: string;
+    /** OpenClaw agent id (defaults to "arbi") */
+    agentId?: string;
+    /** Timeout in ms per prompt (defaults to 300_000 = 5 min) */
+    timeoutMs?: number;
+}
+declare class OpenClawOrchestrator implements Orchestrator {
+    readonly name = "openclaw";
+    private readonly binaryPath;
+    private readonly agentId;
+    private readonly sessionKey;
+    private readonly timeoutMs;
+    constructor(options: OpenClawOrchestratorOptions);
+    prompt(prompt: string, _context?: PromptContext): Promise<string>;
+    close(): Promise<void>;
+    private spawnOpenClaw;
+}
+
+/**
+ * DM Listener Loop.
+ *
+ * Connects to the WebSocket, listens for incoming DMs, decrypts them,
+ * routes to an orchestrator, encrypts the reply, and sends it back.
+ *
+ * Only processes messages from the agent's parent user (owner).
+ */
+
+interface DmListenerOptions {
+    /** Authenticated ArbiClient instance */
+    arbi: ArbiClient;
+    /** Access token for WebSocket auth */
+    accessToken: string;
+    /** Base URL of the ARBI server */
+    baseUrl: string;
+    /** DM crypto context for encrypt/decrypt */
+    crypto: DmCryptoContext;
+    /** Orchestrator to route prompts to */
+    orchestrator: Orchestrator;
+    /** Parent user ext_id — only process messages from this sender */
+    parentExtId: string;
+    /** Called when a log-worthy event happens (verbose output) */
+    onLog?: (message: string) => void;
+    /** Called when an error occurs during processing */
+    onError?: (message: string, error?: unknown) => void;
+}
+interface DmListener {
+    /** Stop listening and clean up */
+    close(): void;
+}
+/**
+ * Start listening for DMs and routing them to the orchestrator.
+ *
+ * Connects via WebSocket with auto-reconnect. For each incoming DM:
+ * 1. Filters to parent user only
+ * 2. Decrypts the message
+ * 3. Sends plaintext to orchestrator.prompt()
+ * 4. Encrypts the response
+ * 5. Sends encrypted reply via DM
+ */
+declare function startDmListener(options: DmListenerOptions): Promise<DmListener>;
+
+/**
+ * Listen module — integration interface, implementations, and DM listener loop.
+ */
+
+type index_ClaudeOrchestrator = ClaudeOrchestrator;
+declare const index_ClaudeOrchestrator: typeof ClaudeOrchestrator;
+type index_ClaudeOrchestratorOptions = ClaudeOrchestratorOptions;
+type index_DmListener = DmListener;
+type index_DmListenerOptions = DmListenerOptions;
+type index_OpenClawOrchestrator = OpenClawOrchestrator;
+declare const index_OpenClawOrchestrator: typeof OpenClawOrchestrator;
+type index_OpenClawOrchestratorOptions = OpenClawOrchestratorOptions;
+type index_Orchestrator = Orchestrator;
+type index_PromptContext = PromptContext;
+declare const index_startDmListener: typeof startDmListener;
+declare namespace index {
+  export { index_ClaudeOrchestrator as ClaudeOrchestrator, type index_ClaudeOrchestratorOptions as ClaudeOrchestratorOptions, type index_DmListener as DmListener, type index_DmListenerOptions as DmListenerOptions, index_OpenClawOrchestrator as OpenClawOrchestrator, type index_OpenClawOrchestratorOptions as OpenClawOrchestratorOptions, type index_Orchestrator as Orchestrator, type index_PromptContext as PromptContext, index_startDmListener as startDmListener };
+}
+
+export { AuthHeaders, ChatSession, ClaudeOrchestrator, type ClaudeOrchestratorOptions, CliConfig, CliCredentials, ConfigStore, DmCryptoContext, type DmListener, type DmListenerOptions, FileConfigStore, OpenClawOrchestrator, type OpenClawOrchestratorOptions, type Orchestrator, type PromptContext, agents, deviceFlow, documentsNode, index as listen, sessions, startDmListener };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { C as ConfigStore, a as CliConfig, b as CliCredentials, c as ChatSession, A as AuthHeaders, U as UploadBatchResult, d as UploadOptions, e as UploadResult } from './browser-D8aF-wkt.js';
-export { f as AgentStepEvent, g as Arbi, h as ArbiApiError, i as ArbiError, j as ArbiOptions, k as ArtifactEvent, l as AuthContext, m as AuthenticatedClient, n as CitationSummary, o as ConnectOptions, D as DocumentWaiter, p as DocumentWaiterOptions, F as FormattedWsMessage, M as MessageLevel, q as MessageMetadataPayload, r as MessageQueuedEvent, O as OutputTokensDetails, Q as QueryOptions, R as ReconnectOptions, s as ReconnectableWsConnection, t as ResolvedCitation, u as ResponseCompletedEvent, v as ResponseContentPartAddedEvent, w as ResponseCreatedEvent, x as ResponseFailedEvent, y as ResponseOutputItemAddedEvent, z as ResponseOutputItemDoneEvent, B as ResponseOutputTextDeltaEvent, E as ResponseOutputTextDoneEvent, G as ResponseUsage, S as SSEEvent, H as SSEStreamCallbacks, I as SSEStreamResult, J as SSEStreamStartData, K as UserInfo, L as UserInputRequestEvent, N as UserMessageEvent, W as WorkspaceContext, P as WsConnection, T as agentconfig, V as assistant, X as authenticatedFetch, Y as buildRetrievalChunkTool, Z as buildRetrievalFullContextTool, _ as buildRetrievalTocTool, $ as connectWebSocket, a0 as connectWithReconnect, a1 as consumeSSEStream, a2 as contacts, a3 as conversations, a4 as countCitations, a5 as createAuthenticatedClient, a6 as createDocumentWaiter, a7 as dm, a8 as doctags, a9 as documents, aa as files, ab as formatAgentStepLabel, ac as formatFileSize, ad as formatStreamSummary, ae as formatUserName, af as formatWorkspaceChoices, ag as formatWsMessage, ah as generateEncryptedWorkspaceKey, ai as getErrorCode, aj as getErrorMessage, ak as health, al as parseSSEEvents, am as performPasswordLogin, an as performSsoDeviceFlowLogin, ao as requireData, ap as requireOk, aq as resolveAuth, ar as resolveCitations, as as resolveWorkspace, at as responses, au as selectWorkspace, av as selectWorkspaceById, aw as settings, ax as streamSSE, ay as stripCitationMarkdown, az as summarizeCitations, aA as tags, aB as workspaces } from './browser-D8aF-wkt.js';
-import '@arbidocs/client';
+import { C as ConfigStore, a as CliConfig, b as CliCredentials, c as ChatSession, A as AuthHeaders, U as UploadBatchResult, d as UploadOptions, e as UploadResult, D as DmCryptoContext } from './browser-z9a2abGo.js';
+export { f as AgentStepEvent, g as Arbi, h as ArbiApiError, i as ArbiError, j as ArbiOptions, k as ArtifactEvent, l as AuthContext, m as AuthenticatedClient, n as CitationSummary, o as ConnectOptions, p as DocumentWaiter, q as DocumentWaiterOptions, F as FormattedWsMessage, M as MessageLevel, r as MessageMetadataPayload, s as MessageQueuedEvent, O as OutputTokensDetails, Q as QueryOptions, R as ReconnectOptions, t as ReconnectableWsConnection, u as ResolvedCitation, v as ResponseCompletedEvent, w as ResponseContentPartAddedEvent, x as ResponseCreatedEvent, y as ResponseFailedEvent, z as ResponseOutputItemAddedEvent, B as ResponseOutputItemDoneEvent, E as ResponseOutputTextDeltaEvent, G as ResponseOutputTextDoneEvent, H as ResponseUsage, S as SSEEvent, I as SSEStreamCallbacks, J as SSEStreamResult, K as SSEStreamStartData, L as UserInfo, N as UserInputRequestEvent, P as UserMessageEvent, W as WorkspaceContext, T as WsConnection, V as agentconfig, X as assistant, Y as authenticatedFetch, Z as buildRetrievalChunkTool, _ as buildRetrievalFullContextTool, $ as buildRetrievalTocTool, a0 as connectWebSocket, a1 as connectWithReconnect, a2 as consumeSSEStream, a3 as contacts, a4 as conversations, a5 as countCitations, a6 as createAuthenticatedClient, a7 as createDocumentWaiter, a8 as dm, a9 as doctags, aa as documents, ab as files, ac as formatAgentStepLabel, ad as formatFileSize, ae as formatStreamSummary, af as formatUserName, ag as formatWorkspaceChoices, ah as formatWsMessage, ai as generateEncryptedWorkspaceKey, aj as generateNewWorkspaceKey, ak as getErrorCode, al as getErrorMessage, am as health, an as parseSSEEvents, ao as performPasswordLogin, ap as performSsoDeviceFlowLogin, aq as requireData, ar as requireOk, as as resolveAuth, at as resolveCitations, au as resolveWorkspace, av as responses, aw as selectWorkspace, ax as selectWorkspaceById, ay as settings, az as streamSSE, aA as stripCitationMarkdown, aB as summarizeCitations, aC as tags, aD as workspaces } from './browser-z9a2abGo.js';
+import { ArbiClient, components } from '@arbidocs/client';
 
 /**
  * Configuration persistence — file-based implementation for Node.js environments.
@@ -150,4 +150,232 @@ declare namespace documentsNode {
   export { documentsNode_uploadDirectory as uploadDirectory, documentsNode_uploadLocalFile as uploadLocalFile, documentsNode_uploadZip as uploadZip };
 }
 
-export { AuthHeaders, ChatSession, CliConfig, CliCredentials, ConfigStore, FileConfigStore, deviceFlow, documentsNode };
+/**
+ * Agent operations — list, delete persistent agents.
+ */
+
+type UserResponse = components['schemas']['UserResponse'];
+declare function listAgents(arbi: ArbiClient): Promise<UserResponse[]>;
+declare function deleteAgents(arbi: ArbiClient, agentExtIds: string[]): Promise<{
+    [x: string]: unknown;
+}>;
+
+declare const agents_deleteAgents: typeof deleteAgents;
+declare const agents_listAgents: typeof listAgents;
+declare namespace agents {
+  export { agents_deleteAgents as deleteAgents, agents_listAgents as listAgents };
+}
+
+/**
+ * Session operations — list active sessions, authorize delegation, claim codes.
+ */
+
+type SessionInfoResponse = components['schemas']['SessionInfoResponse'];
+type AuthorizeResponse = components['schemas']['AuthorizeResponse'];
+type LoginResponse = components['schemas']['LoginResponse'];
+/**
+ * List all active sessions for the current user.
+ * Agents/delegated sessions see only their own session.
+ */
+declare function listSessions(arbi: ArbiClient): Promise<SessionInfoResponse[]>;
+/**
+ * Create a delegated session with pre-populated workspace keys.
+ * Returns a 3-word claim code for the recipient.
+ *
+ * @param workspaces - Map of workspace_ext_id to SealedBox-encrypted workspace key
+ * @param options.activeWorkspace - Which workspace to set active (defaults to first)
+ * @param options.ttl - Session TTL in seconds (60-604800, default 3600)
+ * @param options.persistIdentity - If true, claim creates a persistent Agent identity
+ * @param options.name - Human-readable name for persistent agents
+ */
+declare function authorizeSession(arbi: ArbiClient, workspaces: Record<string, string>, options?: {
+    activeWorkspace?: string;
+    ttl?: number;
+    persistIdentity?: boolean;
+    name?: string;
+}): Promise<AuthorizeResponse>;
+/**
+ * Claim an agent session using a 3-word code.
+ * Returns a JWT token and optionally an agent_ext_id for persistent agents.
+ *
+ * @param claimCode - The 3-word claim code (e.g. "purple-mountain-river")
+ * @param signingKey - Ed25519 public key (required for persistent agents)
+ */
+declare function claimSession(arbi: ArbiClient, claimCode: string, signingKey?: string): Promise<LoginResponse>;
+
+declare const sessions_authorizeSession: typeof authorizeSession;
+declare const sessions_claimSession: typeof claimSession;
+declare const sessions_listSessions: typeof listSessions;
+declare namespace sessions {
+  export { sessions_authorizeSession as authorizeSession, sessions_claimSession as claimSession, sessions_listSessions as listSessions };
+}
+
+/**
+ * Orchestrator interface for `arbi listen`.
+ *
+ * An orchestrator is an external agent that receives prompts and returns responses.
+ * ARBI acts as the transport layer (encrypted DMs); the orchestrator does the thinking.
+ */
+interface Orchestrator {
+    /** Human-readable name (e.g. "claude", "openclaw") */
+    readonly name: string;
+    /**
+     * Send a prompt to the orchestrator and collect the response.
+     *
+     * @param prompt - The decrypted DM content to process
+     * @param context - Optional metadata about the message
+     * @returns The orchestrator's text response
+     */
+    prompt(prompt: string, context?: PromptContext): Promise<string>;
+    /** Clean up resources (kill child processes, close connections, etc.) */
+    close?(): Promise<void>;
+}
+interface PromptContext {
+    /** Sender's external_id */
+    senderExtId?: string;
+    /** Sender's email */
+    senderEmail?: string;
+    /** Workspace context (if any) */
+    workspaceId?: string;
+}
+
+/**
+ * Claude Code integration.
+ *
+ * Spawns `claude -p <prompt> --output-format text` as a child process for each prompt.
+ * The prompt is passed as a CLI argument (not stdin).
+ *
+ * Conversation continuity: first prompt uses --session-id to create a session,
+ * subsequent prompts use --resume to continue it. The session ID is derived
+ * from the agent's ext_id so it's stable across restarts.
+ *
+ * The ARBI SKILL.md is injected via --append-system-prompt so Claude knows
+ * which CLI commands are available.
+ */
+
+interface ClaudeOrchestratorOptions {
+    /** Path to the claude CLI binary (defaults to "claude") */
+    binaryPath?: string;
+    /** ARBI session identifier — used to maintain Claude conversation continuity */
+    sessionId: string;
+    /** Additional CLI flags (e.g. ["--model", "opus"]) */
+    extraArgs?: string[];
+    /** Timeout in ms per prompt (defaults to 300_000 = 5 min) */
+    timeoutMs?: number;
+    /** Override SKILL.md content (defaults to loading from arbi-cli package) */
+    skillPrompt?: string;
+}
+declare class ClaudeOrchestrator implements Orchestrator {
+    readonly name = "claude";
+    private readonly binaryPath;
+    private readonly extraArgs;
+    private readonly timeoutMs;
+    private readonly claudeSessionId;
+    private readonly skillPrompt;
+    private sessionStarted;
+    constructor(options: ClaudeOrchestratorOptions);
+    prompt(prompt: string, _context?: PromptContext): Promise<string>;
+    private spawnClaude;
+    close(): Promise<void>;
+}
+
+/**
+ * OpenClaw integration.
+ *
+ * Spawns `openclaw agent --agent <id> --message <prompt> --json` as a child
+ * process for each prompt. The gateway handles routing, model selection, and
+ * session memory.
+ *
+ * Session isolation: uses `--session-id` to keep conversations separate per
+ * ARBI user. The OpenClaw agent id (e.g. "arbi") is created once during
+ * `arbi connect --agent openclaw` via `openclaw agents add`.
+ *
+ * The ARBI SKILL.md is installed as BOOTSTRAP.md in the agent's workspace
+ * during setup, so the agent always has context about arbi commands.
+ */
+
+interface OpenClawOrchestratorOptions {
+    /** Path to the openclaw CLI binary (defaults to "openclaw") */
+    binaryPath?: string;
+    /** ARBI session identifier — used for OpenClaw session isolation */
+    sessionId: string;
+    /** OpenClaw agent id (defaults to "arbi") */
+    agentId?: string;
+    /** Timeout in ms per prompt (defaults to 300_000 = 5 min) */
+    timeoutMs?: number;
+}
+declare class OpenClawOrchestrator implements Orchestrator {
+    readonly name = "openclaw";
+    private readonly binaryPath;
+    private readonly agentId;
+    private readonly sessionKey;
+    private readonly timeoutMs;
+    constructor(options: OpenClawOrchestratorOptions);
+    prompt(prompt: string, _context?: PromptContext): Promise<string>;
+    close(): Promise<void>;
+    private spawnOpenClaw;
+}
+
+/**
+ * DM Listener Loop.
+ *
+ * Connects to the WebSocket, listens for incoming DMs, decrypts them,
+ * routes to an orchestrator, encrypts the reply, and sends it back.
+ *
+ * Only processes messages from the agent's parent user (owner).
+ */
+
+interface DmListenerOptions {
+    /** Authenticated ArbiClient instance */
+    arbi: ArbiClient;
+    /** Access token for WebSocket auth */
+    accessToken: string;
+    /** Base URL of the ARBI server */
+    baseUrl: string;
+    /** DM crypto context for encrypt/decrypt */
+    crypto: DmCryptoContext;
+    /** Orchestrator to route prompts to */
+    orchestrator: Orchestrator;
+    /** Parent user ext_id — only process messages from this sender */
+    parentExtId: string;
+    /** Called when a log-worthy event happens (verbose output) */
+    onLog?: (message: string) => void;
+    /** Called when an error occurs during processing */
+    onError?: (message: string, error?: unknown) => void;
+}
+interface DmListener {
+    /** Stop listening and clean up */
+    close(): void;
+}
+/**
+ * Start listening for DMs and routing them to the orchestrator.
+ *
+ * Connects via WebSocket with auto-reconnect. For each incoming DM:
+ * 1. Filters to parent user only
+ * 2. Decrypts the message
+ * 3. Sends plaintext to orchestrator.prompt()
+ * 4. Encrypts the response
+ * 5. Sends encrypted reply via DM
+ */
+declare function startDmListener(options: DmListenerOptions): Promise<DmListener>;
+
+/**
+ * Listen module — integration interface, implementations, and DM listener loop.
+ */
+
+type index_ClaudeOrchestrator = ClaudeOrchestrator;
+declare const index_ClaudeOrchestrator: typeof ClaudeOrchestrator;
+type index_ClaudeOrchestratorOptions = ClaudeOrchestratorOptions;
+type index_DmListener = DmListener;
+type index_DmListenerOptions = DmListenerOptions;
+type index_OpenClawOrchestrator = OpenClawOrchestrator;
+declare const index_OpenClawOrchestrator: typeof OpenClawOrchestrator;
+type index_OpenClawOrchestratorOptions = OpenClawOrchestratorOptions;
+type index_Orchestrator = Orchestrator;
+type index_PromptContext = PromptContext;
+declare const index_startDmListener: typeof startDmListener;
+declare namespace index {
+  export { index_ClaudeOrchestrator as ClaudeOrchestrator, type index_ClaudeOrchestratorOptions as ClaudeOrchestratorOptions, type index_DmListener as DmListener, type index_DmListenerOptions as DmListenerOptions, index_OpenClawOrchestrator as OpenClawOrchestrator, type index_OpenClawOrchestratorOptions as OpenClawOrchestratorOptions, type index_Orchestrator as Orchestrator, type index_PromptContext as PromptContext, index_startDmListener as startDmListener };
+}
+
+export { AuthHeaders, ChatSession, ClaudeOrchestrator, type ClaudeOrchestratorOptions, CliConfig, CliCredentials, ConfigStore, DmCryptoContext, type DmListener, type DmListenerOptions, FileConfigStore, OpenClawOrchestrator, type OpenClawOrchestratorOptions, type Orchestrator, type PromptContext, agents, deviceFlow, documentsNode, index as listen, sessions, startDmListener };