@openacp/cli 2026.403.7 → 2026.404.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as Attachment, O as OutgoingMessage, I as IChannelAdapter, N as NotificationMessage, a as AgentEvent, S as StopReason, P as PermissionRequest, U as UsageRecord, b as AgentCapabilities, c as AgentDefinition, M as McpServerConfig, d as SetConfigOptionValue, e as InstalledAgent, R as RegistryAgent, f as AgentListItem, g as AvailabilityResult, h as InstallProgress, i as InstallResult, j as SessionStatus, C as ConfigOption, k as AgentSwitchEntry, l as AgentCommand, m as SessionRecord, n as UsageRecordEvent, o as IncomingMessage, D as DisplayVerbosity, p as ChannelConfig, q as AdapterCapabilities, T as ToolCallMeta, V as ViewerLinks, r as OutputMode, s as PlanEntry } from './channel-BL33p1ZP.js';
-export { t as AgentDistribution, u as AuthMethod, v as AuthenticateRequest, w as ChannelAdapter, x as ConfigSelectChoice, y as ConfigSelectGroup, z as ContentBlock, K as KIND_ICONS, B as ModelInfo, E as NewSessionResponse, F as PermissionOption, G as PromptResponse, H as RegistryBinaryTarget, J as RegistryDistribution, L as STATUS_ICONS, Q as SessionListItem, W as SessionListResponse, X as SessionMode, Y as SessionModeState, Z as SessionModelState, _ as TelegramPlatformData, $ as ToolUpdateMeta } from './channel-BL33p1ZP.js';
+import { A as Attachment, O as OutgoingMessage, I as IChannelAdapter, N as NotificationMessage, a as AgentEvent, S as StopReason, P as PermissionRequest, U as UsageRecord, b as AgentCapabilities, c as AgentDefinition, M as McpServerConfig, d as SetConfigOptionValue, e as InstalledAgent, R as RegistryAgent, f as AgentListItem, g as AvailabilityResult, h as InstallProgress, i as InstallResult, j as SessionStatus, C as ConfigOption, k as AgentSwitchEntry, l as AgentCommand, T as TurnContext, m as TurnRouting, n as SessionRecord, o as UsageRecordEvent, p as IncomingMessage, D as DisplayVerbosity, q as ChannelConfig, r as AdapterCapabilities, s as ToolCallMeta, V as ViewerLinks, t as OutputMode, u as PlanEntry } from './channel-CmTWKnpK.js';
+export { v as AgentDistribution, w as AuthMethod, x as AuthenticateRequest, y as ChannelAdapter, z as ConfigSelectChoice, B as ConfigSelectGroup, E as ContentBlock, K as KIND_ICONS, F as ModelInfo, G as NewSessionResponse, H as PermissionOption, J as PromptResponse, L as RegistryBinaryTarget, Q as RegistryDistribution, W as STATUS_ICONS, X as SessionListItem, Y as SessionListResponse, Z as SessionMode, _ as SessionModeState, $ as SessionModelState, a0 as TelegramPlatformData, a1 as ToolUpdateMeta, a2 as createTurnContext, a3 as getEffectiveTarget, a4 as isSystemEvent } from './channel-CmTWKnpK.js';
 import pino from 'pino';
 import * as zod from 'zod';
 import { ZodSchema, z } from 'zod';
@@ -1428,7 +1428,9 @@ interface SessionEvents {
 declare class Session extends TypedEmitter<SessionEvents> {
     id: string;
     channelId: string;
-    threadId: string;
+    /** @deprecated Use threadIds map directly. Getter returns primary adapter's threadId. */
+    get threadId(): string;
+    set threadId(value: string);
     agentName: string;
     workingDirectory: string;
     agentInstance: AgentInstance;
@@ -1451,6 +1453,12 @@ declare class Session extends TypedEmitter<SessionEvents> {
     middlewareChain?: MiddlewareChain;
     /** Latest commands emitted by the agent — buffered before bridge connects so they're not lost */
     latestCommands: AgentCommand[] | null;
+    /** Adapters currently attached to this session (including primary) */
+    attachedAdapters: string[];
+    /** Per-adapter thread IDs: adapterId → threadId */
+    threadIds: Map<string, string>;
+    /** Active turn context — sealed on prompt dequeue, cleared on turn end */
+    activeTurnContext: TurnContext | null;
     readonly permissionGate: PermissionGate;
     private readonly queue;
     private speechService?;
@@ -1464,6 +1472,10 @@ declare class Session extends TypedEmitter<SessionEvents> {
         speechService?: SpeechService;
         isAssistant?: boolean;
     });
+    /** Wire a listener on the current agentInstance to buffer commands_update events.
+     *  Must be called after every agentInstance replacement (constructor + switchAgent). */
+    private commandsBufferCleanup?;
+    private wireCommandsBuffer;
     get status(): SessionStatus;
     /** Transition to active — from initializing, error, or cancelled */
     activate(): void;
@@ -1479,13 +1491,22 @@ declare class Session extends TypedEmitter<SessionEvents> {
     get promptRunning(): boolean;
     setContext(markdown: string): void;
     setVoiceMode(mode: "off" | "next" | "on"): void;
-    enqueuePrompt(text: string, attachments?: Attachment[]): Promise<void>;
+    enqueuePrompt(text: string, attachments?: Attachment[], routing?: TurnRouting): Promise<void>;
     private processPrompt;
     private maybeTranscribeAudio;
     private processTTSResponse;
     private autoName;
     setInitialConfigOptions(options: ConfigOption[]): void;
     setAgentCapabilities(caps: AgentCapabilities | undefined): void;
+    /**
+     * Hydrate configOptions and agentCapabilities from a spawn response.
+     * Handles both the native configOptions format and legacy modes/models fields.
+     */
+    applySpawnResponse(resp: {
+        modes?: unknown;
+        configOptions?: unknown;
+        models?: unknown;
+    } | undefined, caps: AgentCapabilities | undefined): void;
     getConfigOption(id: string): ConfigOption | undefined;
     getConfigByCategory(category: string): ConfigOption | undefined;
     getConfigValue(id: string): string | undefined;
@@ -1516,8 +1537,8 @@ declare class PromptQueue {
     private queue;
     private processing;
     private abortController;
-    constructor(processor: (text: string, attachments?: Attachment[]) => Promise<void>, onError?: ((err: unknown) => void) | undefined);
-    enqueue(text: string, attachments?: Attachment[]): Promise<void>;
+    constructor(processor: (text: string, attachments?: Attachment[], routing?: TurnRouting) => Promise<void>, onError?: ((err: unknown) => void) | undefined);
+    enqueue(text: string, attachments?: Attachment[], routing?: TurnRouting): Promise<void>;
     private process;
     private drainNext;
     clear(): void;
@@ -1581,6 +1602,8 @@ interface EventBusEvents {
         sessionId: string;
         requestId: string;
         decision: string;
+        optionId?: string;
+        resolvedBy?: string;
     }) => void;
     "kernel:booted": () => void;
     "system:ready": () => void;
@@ -1640,6 +1663,22 @@ interface EventBusEvents {
 declare class EventBus extends TypedEmitter<EventBusEvents> {
 }
 
+interface SessionSummary {
+    id: string;
+    agent: string;
+    status: SessionStatus;
+    name: string | null;
+    workspace: string;
+    channelId: string;
+    createdAt: string;
+    lastActiveAt: string | null;
+    dangerousMode: boolean;
+    queueDepth: number;
+    promptRunning: boolean;
+    configOptions?: ConfigOption[];
+    capabilities: AgentCapabilities | null;
+    isLive: boolean;
+}
 declare class SessionManager {
     private sessions;
     private store;
@@ -1660,6 +1699,7 @@ declare class SessionManager {
     getSessionRecord(sessionId: string): SessionRecord | undefined;
     cancelSession(sessionId: string): Promise<void>;
     listSessions(channelId?: string): Session[];
+    listAllSessions(channelId?: string): SessionSummary[];
     listRecords(filter?: {
         statuses?: string[];
     }): SessionRecord[];
@@ -1672,6 +1712,8 @@ declare class SessionManager {
     /**
      * Forcefully destroy all sessions (kill agent subprocesses).
      * Use only when sessions must be fully torn down (e.g. archive).
+     * Unlike shutdownAll(), this does NOT snapshot live session state (acpState, etc.)
+     * because destroyed sessions are terminal and will not be resumed.
      */
     destroyAll(): Promise<void>;
 }
@@ -1697,12 +1739,15 @@ declare class SessionBridge {
     private deps;
     private connected;
     private cleanupFns;
-    constructor(session: Session, adapter: IChannelAdapter, deps: BridgeDeps);
+    readonly adapterId: string;
+    constructor(session: Session, adapter: IChannelAdapter, deps: BridgeDeps, adapterId?: string);
     private get tracer();
     /** Register a listener and track it for cleanup */
     private listen;
     /** Send message to adapter, optionally running through message:outgoing middleware */
     private sendMessage;
+    /** Determine if this bridge should forward the given event based on turn routing. */
+    shouldForward(event: AgentEvent): boolean;
     connect(): void;
     disconnect(): void;
     /** Dispatch an agent event through middleware and to the adapter */
@@ -2005,6 +2050,7 @@ declare class SessionFactory {
      * Used by adapter command handlers and handleMessage().
      */
     getOrResume(channelId: string, threadId: string): Promise<Session | null>;
+    getOrResumeById(sessionId: string): Promise<Session | null>;
     private lazyResume;
     handleNewSession(channelId: string, agentName?: string, workspacePath?: string, options?: {
         createThread?: boolean;
@@ -2215,7 +2261,7 @@ declare class OpenACPCore {
     sessionManager: SessionManager;
     messageTransformer: MessageTransformer;
     adapters: Map<string, IChannelAdapter>;
-    /** sessionId → SessionBridge — tracks active bridges for disconnect/reconnect during agent switch */
+    /** "adapterId:sessionId" → SessionBridge — tracks active bridges for disconnect/reconnect */
     private bridges;
     /** Set by main.ts — triggers graceful shutdown with restart exit code */
     requestRestart: (() => Promise<void>) | null;
@@ -2290,11 +2336,21 @@ declare class OpenACPCore {
         resumed: boolean;
     }>;
     getOrResumeSession(channelId: string, threadId: string): Promise<Session | null>;
+    getOrResumeSessionById(sessionId: string): Promise<Session | null>;
+    attachAdapter(sessionId: string, adapterId: string): Promise<{
+        threadId: string;
+    }>;
+    detachAdapter(sessionId: string, adapterId: string): Promise<void>;
+    private buildPlatformsFromSession;
+    /** Composite bridge key: "adapterId:sessionId" */
+    private bridgeKey;
+    /** Get all bridge keys for a session (regardless of adapter) */
+    private getSessionBridgeKeys;
     /** Connect a session bridge for the given session (used by AssistantManager) */
     connectSessionBridge(session: Session): void;
     /** Create a SessionBridge for the given session and adapter.
-     *  Disconnects any existing bridge for the same session first. */
-    createBridge(session: Session, adapter: IChannelAdapter): SessionBridge;
+     *  Disconnects any existing bridge for the same adapter+session first. */
+    createBridge(session: Session, adapter: IChannelAdapter, adapterId?: string): SessionBridge;
 }
 
 interface RegisteredCommand extends CommandDef {
@@ -3132,4 +3188,4 @@ declare class TelegramAdapter extends MessagingAdapter {
     archiveSessionTopic(sessionId: string): Promise<void>;
 }
 
-export { ActivityTracker, AdapterCapabilities, AgentCapabilities, AgentCatalog, AgentCommand, AgentDefinition, AgentEvent, AgentInstance, AgentListItem, AgentManager, AgentStore, AgentSwitchEntry, type ApiConfig, type ApiServerInstance, type ApiServerOptions, type ApiServerService, type AssistantCommand, AssistantManager, AssistantRegistry, type AssistantSection, Attachment, AvailabilityResult, BaseRenderer, type BridgeDeps, CONFIG_REGISTRY, ChannelConfig, type CleanupResult, type CommandArgs, type CommandDef, CommandRegistry, type CommandResponse, type Config, type ConfigFieldDef, ConfigManager, ConfigOption, ContextManager, type ContextOptions, type ContextProvider, type ContextQuery, type ContextResult, type ContextService, type SessionInfo as ContextSessionInfo, type DeleteTopicResult, DisplaySpecBuilder, DisplayVerbosity, DoctorEngine, type DoctorReport, DraftManager, EntireProvider, EventBus, type EventBusEvents, FileService, type FileServiceInterface, GroqSTT, IChannelAdapter, type IRenderer, IncomingMessage, type InstallContext, InstallProgress, InstallResult, InstalledAgent, type ListItem, type Logger, type LoggingConfig, McpServerConfig, type MenuItem, type MenuOption, MenuRegistry, MessageTransformer, MessagingAdapter, type MessagingAdapterConfig, type MigrateContext, NotificationManager, NotificationMessage, type NotificationService, OpenACPCore, type OpenACPPlugin, OutgoingMessage, OutputMode, OutputModeResolver, PRODUCT_GUIDE, type PendingFix, PermissionGate, PermissionRequest, PlanEntry, type PluginContext, type PluginPermission, type PluginStorage, PromptQueue, RegistryAgent, type RenderedMessage, SSEManager, type STTOptions, type STTProvider, type STTResult, SecurityGuard, type SecurityService, SendQueue, Session, SessionBridge, type SessionCreateParams, type SessionEvents, SessionFactory, type SessionListResult, SessionManager, SessionRecord, SessionStatus, SetConfigOptionValue, type SettingsAPI, type SideEffectDeps, type SpeechProviderConfig, SpeechService, type SpeechServiceConfig, type SpeechServiceInterface, StaticServer, StderrCapture, StopReason, StreamAdapter, type TTSOptions, type TTSProvider, type TTSResult, TelegramAdapter, type TerminalIO, ThoughtBuffer, type ThoughtDisplaySpec, ToolCallMeta, ToolCallTracker, type ToolCardSnapshot, ToolCardState, type ToolCardStateConfig, type ToolDisplaySpec, type ToolEntry, ToolStateMap, type TopicInfo, TopicManager, type TunnelServiceInterface, TypedEmitter, type UsageConfig, UsageRecord, UsageRecordEvent, type UsageService, ViewerLinks, cleanupOldSessionLogs, createApiServer, createApiServerService, createChildLogger, createSessionLogger, expandHome, extractContentText, formatTokens, formatToolSummary, formatToolTitle, getConfigValue, getFieldDef, getPidPath, getSafeFields, getStatus, initLogger, installAutoStart, isAutoStartInstalled, isAutoStartSupported, isHotReloadable, log, nodeToWebReadable, nodeToWebWritable, progressBar, resolveOptions, resolveToolIcon, runConfigEditor, setLogLevel, shutdownLogger, splitMessage, startDaemon, stopDaemon, stripCodeFences, truncateContent, uninstallAutoStart };
+export { ActivityTracker, AdapterCapabilities, AgentCapabilities, AgentCatalog, AgentCommand, AgentDefinition, AgentEvent, AgentInstance, AgentListItem, AgentManager, AgentStore, AgentSwitchEntry, type ApiConfig, type ApiServerInstance, type ApiServerOptions, type ApiServerService, type AssistantCommand, AssistantManager, AssistantRegistry, type AssistantSection, Attachment, AvailabilityResult, BaseRenderer, type BridgeDeps, CONFIG_REGISTRY, ChannelConfig, type CleanupResult, type CommandArgs, type CommandDef, CommandRegistry, type CommandResponse, type Config, type ConfigFieldDef, ConfigManager, ConfigOption, ContextManager, type ContextOptions, type ContextProvider, type ContextQuery, type ContextResult, type ContextService, type SessionInfo as ContextSessionInfo, type DeleteTopicResult, DisplaySpecBuilder, DisplayVerbosity, DoctorEngine, type DoctorReport, DraftManager, EntireProvider, EventBus, type EventBusEvents, FileService, type FileServiceInterface, GroqSTT, IChannelAdapter, type IRenderer, IncomingMessage, type InstallContext, InstallProgress, InstallResult, InstalledAgent, type ListItem, type Logger, type LoggingConfig, McpServerConfig, type MenuItem, type MenuOption, MenuRegistry, MessageTransformer, MessagingAdapter, type MessagingAdapterConfig, type MigrateContext, NotificationManager, NotificationMessage, type NotificationService, OpenACPCore, type OpenACPPlugin, OutgoingMessage, OutputMode, OutputModeResolver, PRODUCT_GUIDE, type PendingFix, PermissionGate, PermissionRequest, PlanEntry, type PluginContext, type PluginPermission, type PluginStorage, PromptQueue, RegistryAgent, type RenderedMessage, SSEManager, type STTOptions, type STTProvider, type STTResult, SecurityGuard, type SecurityService, SendQueue, Session, SessionBridge, type SessionCreateParams, type SessionEvents, SessionFactory, type SessionListResult, SessionManager, SessionRecord, SessionStatus, type SessionSummary, SetConfigOptionValue, type SettingsAPI, type SideEffectDeps, type SpeechProviderConfig, SpeechService, type SpeechServiceConfig, type SpeechServiceInterface, StaticServer, StderrCapture, StopReason, StreamAdapter, type TTSOptions, type TTSProvider, type TTSResult, TelegramAdapter, type TerminalIO, ThoughtBuffer, type ThoughtDisplaySpec, ToolCallMeta, ToolCallTracker, type ToolCardSnapshot, ToolCardState, type ToolCardStateConfig, type ToolDisplaySpec, type ToolEntry, ToolStateMap, type TopicInfo, TopicManager, type TunnelServiceInterface, TurnContext, TurnRouting, TypedEmitter, type UsageConfig, UsageRecord, UsageRecordEvent, type UsageService, ViewerLinks, cleanupOldSessionLogs, createApiServer, createApiServerService, createChildLogger, createSessionLogger, expandHome, extractContentText, formatTokens, formatToolSummary, formatToolTitle, getConfigValue, getFieldDef, getPidPath, getSafeFields, getStatus, initLogger, installAutoStart, isAutoStartInstalled, isAutoStartSupported, isHotReloadable, log, nodeToWebReadable, nodeToWebWritable, progressBar, resolveOptions, resolveToolIcon, runConfigEditor, setLogLevel, shutdownLogger, splitMessage, startDaemon, stopDaemon, stripCodeFences, truncateContent, uninstallAutoStart };