@openacp/cli 2026.401.5 → 2026.402.1

package/dist/index.d.ts

@@ -1,476 +1,13 @@
+import { A as AgentEvent, a as AgentCapabilities, P as PermissionRequest, b as AgentDefinition, M as McpServerConfig, S as SetConfigOptionValue, c as Attachment, I as InstalledAgent, R as RegistryAgent, d as AgentListItem, e as AvailabilityResult, f as InstallProgress, g as InstallResult, h as SessionStatus, C as ConfigOption, i as AgentSwitchEntry, j as AgentCommand, k as SessionRecord, O as OutgoingMessage, l as IChannelAdapter, N as NotificationMessage, m as StopReason, U as UsageRecord, 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-DzDoNxa7.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-DzDoNxa7.js';
 import pino from 'pino';
 import * as zod from 'zod';
 import { z, ZodSchema } from 'zod';
 import { EventEmitter } from 'node:events';
-import { SetSessionConfigOptionResponse, ListSessionsResponse, LoadSessionResponse, ForkSessionResponse, PromptResponse as PromptResponse$1 } from '@agentclientprotocol/sdk';
+import { SetSessionConfigOptionResponse, ListSessionsResponse, LoadSessionResponse, ForkSessionResponse, PromptResponse } from '@agentclientprotocol/sdk';
 import { FastifyInstance, FastifyPluginAsync, preHandlerHookHandler, FastifyRequest, FastifyReply } from 'fastify';
 import * as http from 'node:http';
 
-type OutputMode = "low" | "medium" | "high";
-/** @deprecated Use OutputMode instead */
-type DisplayVerbosity = OutputMode;
-declare const STATUS_ICONS: Record<string, string>;
-declare const KIND_ICONS: Record<string, string>;
-interface ViewerLinks {
-    file?: string;
-    diff?: string;
-}
-interface ToolCallMeta {
-    id: string;
-    name: string;
-    kind?: string;
-    status?: string;
-    content?: unknown;
-    rawInput?: unknown;
-    viewerLinks?: ViewerLinks;
-    viewerFilePath?: string;
-    displaySummary?: string;
-    displayTitle?: string;
-    displayKind?: string;
-}
-interface ToolUpdateMeta extends ToolCallMeta {
-    status: string;
-}
-
-interface Attachment {
-    type: 'image' | 'audio' | 'file';
-    filePath: string;
-    fileName: string;
-    mimeType: string;
-    size: number;
-    originalFilePath?: string;
-}
-interface IncomingMessage {
-    channelId: string;
-    threadId: string;
-    userId: string;
-    text: string;
-    attachments?: Attachment[];
-}
-interface OutgoingMessage {
-    type: "text" | "thought" | "tool_call" | "tool_update" | "plan" | "usage" | "session_end" | "error" | "attachment" | "system_message" | "mode_change" | "config_update" | "model_update" | "user_replay" | "resource" | "resource_link";
-    text: string;
-    metadata?: Record<string, unknown>;
-    attachment?: Attachment;
-}
-interface PermissionRequest {
-    id: string;
-    description: string;
-    options: PermissionOption[];
-}
-interface PermissionOption {
-    id: string;
-    label: string;
-    isAllow: boolean;
-}
-interface NotificationMessage {
-    sessionId: string;
-    sessionName?: string;
-    type: "completed" | "error" | "permission" | "input_required" | "budget_warning";
-    summary: string;
-    deepLink?: string;
-}
-interface AgentCommand {
-    name: string;
-    description: string;
-    input?: unknown;
-}
-type AgentEvent = {
-    type: "text";
-    content: string;
-} | {
-    type: "thought";
-    content: string;
-} | {
-    type: "tool_call";
-    id: string;
-    name: string;
-    kind?: string;
-    status: string;
-    content?: unknown;
-    locations?: unknown;
-    rawInput?: unknown;
-    rawOutput?: unknown;
-    meta?: unknown;
-} | {
-    type: "tool_update";
-    id: string;
-    name?: string;
-    kind?: string;
-    status: string;
-    content?: unknown;
-    locations?: unknown;
-    rawInput?: unknown;
-    rawOutput?: unknown;
-    meta?: unknown;
-} | {
-    type: "plan";
-    entries: PlanEntry[];
-} | {
-    type: "usage";
-    tokensUsed?: number;
-    contextSize?: number;
-    cost?: {
-        amount: number;
-        currency: string;
-    };
-} | {
-    type: "commands_update";
-    commands: AgentCommand[];
-} | {
-    type: "image_content";
-    data: string;
-    mimeType: string;
-} | {
-    type: "audio_content";
-    data: string;
-    mimeType: string;
-} | {
-    type: "session_end";
-    reason: string;
-} | {
-    type: "error";
-    message: string;
-} | {
-    type: "system_message";
-    message: string;
-} | {
-    type: "session_info_update";
-    title?: string;
-    updatedAt?: string;
-    _meta?: Record<string, unknown>;
-} | {
-    type: "config_option_update";
-    options: ConfigOption[];
-} | {
-    type: "user_message_chunk";
-    content: string;
-} | {
-    type: "resource_content";
-    uri: string;
-    name: string;
-    text?: string;
-    blob?: string;
-    mimeType?: string;
-} | {
-    type: "resource_link";
-    uri: string;
-    name: string;
-    mimeType?: string;
-    title?: string;
-    description?: string;
-    size?: number;
-} | {
-    type: "tts_strip";
-};
-interface PlanEntry {
-    content: string;
-    status: "pending" | "in_progress" | "completed";
-    priority: "high" | "medium" | "low";
-}
-interface AgentDefinition {
-    name: string;
-    command: string;
-    args: string[];
-    workingDirectory?: string;
-    env?: Record<string, string>;
-}
-type AgentDistribution = "npx" | "uvx" | "binary" | "custom";
-interface InstalledAgent {
-    registryId: string | null;
-    name: string;
-    version: string;
-    distribution: AgentDistribution;
-    command: string;
-    args: string[];
-    env: Record<string, string>;
-    workingDirectory?: string;
-    installedAt: string;
-    binaryPath: string | null;
-}
-interface RegistryBinaryTarget {
-    archive: string;
-    cmd: string;
-    args?: string[];
-    env?: Record<string, string>;
-}
-interface RegistryDistribution {
-    npx?: {
-        package: string;
-        args?: string[];
-        env?: Record<string, string>;
-    };
-    uvx?: {
-        package: string;
-        args?: string[];
-        env?: Record<string, string>;
-    };
-    binary?: Record<string, RegistryBinaryTarget>;
-}
-interface RegistryAgent {
-    id: string;
-    name: string;
-    version: string;
-    description: string;
-    repository?: string;
-    website?: string;
-    authors?: string[];
-    license?: string;
-    icon?: string;
-    distribution: RegistryDistribution;
-}
-interface AgentListItem {
-    key: string;
-    registryId: string;
-    name: string;
-    version: string;
-    description?: string;
-    distribution: AgentDistribution;
-    installed: boolean;
-    available: boolean;
-    missingDeps?: string[];
-}
-interface AvailabilityResult {
-    available: boolean;
-    reason?: string;
-    missing?: Array<{
-        label: string;
-        installHint: string;
-    }>;
-}
-interface InstallProgress {
-    onStart(agentId: string, agentName: string): void | Promise<void>;
-    onStep(step: string): void | Promise<void>;
-    onDownloadProgress(percent: number): void | Promise<void>;
-    onSuccess(agentName: string): void | Promise<void>;
-    onError(error: string, hint?: string): void | Promise<void>;
-}
-interface InstallResult {
-    ok: boolean;
-    agentKey: string;
-    error?: string;
-    hint?: string;
-    setupSteps?: string[];
-}
-type SessionStatus = "initializing" | "active" | "cancelled" | "finished" | "error";
-interface AgentSwitchEntry {
-    agentName: string;
-    agentSessionId: string;
-    switchedAt: string;
-    promptCount: number;
-}
-interface SessionRecord<P = Record<string, unknown>> {
-    sessionId: string;
-    agentSessionId: string;
-    originalAgentSessionId?: string;
-    agentName: string;
-    workingDir: string;
-    channelId: string;
-    status: SessionStatus;
-    createdAt: string;
-    lastActiveAt: string;
-    name?: string;
-    dangerousMode?: boolean;
-    clientOverrides?: {
-        bypassPermissions?: boolean;
-    };
-    outputMode?: OutputMode;
-    platform: P;
-    firstAgent?: string;
-    currentPromptCount?: number;
-    agentSwitchHistory?: AgentSwitchEntry[];
-    acpState?: {
-        configOptions?: ConfigOption[];
-        agentCapabilities?: AgentCapabilities;
-        currentMode?: string;
-        availableModes?: SessionMode[];
-        currentModel?: string;
-        availableModels?: ModelInfo[];
-    };
-}
-interface TelegramPlatformData {
-    topicId: number;
-    skillMsgId?: number;
-    controlMsgId?: number;
-}
-interface UsageRecord {
-    id: string;
-    sessionId: string;
-    agentName: string;
-    tokensUsed: number;
-    contextSize: number;
-    cost?: {
-        amount: number;
-        currency: string;
-    };
-    timestamp: string;
-}
-interface UsageRecordEvent {
-    sessionId: string;
-    agentName: string;
-    timestamp: string;
-    tokensUsed: number;
-    contextSize: number;
-    cost?: {
-        amount: number;
-        currency: string;
-    };
-}
-interface SessionMode {
-    id: string;
-    name: string;
-    description?: string;
-}
-interface SessionModeState {
-    currentModeId: string;
-    availableModes: SessionMode[];
-}
-interface ConfigSelectChoice {
-    value: string;
-    name: string;
-    description?: string;
-}
-interface ConfigSelectGroup {
-    group: string;
-    name: string;
-    options: ConfigSelectChoice[];
-}
-type ConfigOption = {
-    id: string;
-    name: string;
-    description?: string;
-    category?: string;
-    type: "select";
-    currentValue: string;
-    options: (ConfigSelectChoice | ConfigSelectGroup)[];
-    _meta?: Record<string, unknown>;
-} | {
-    id: string;
-    name: string;
-    description?: string;
-    category?: string;
-    type: "boolean";
-    currentValue: boolean;
-    _meta?: Record<string, unknown>;
-};
-type SetConfigOptionValue = {
-    type: "select";
-    value: string;
-} | {
-    type: "boolean";
-    value: boolean;
-};
-interface ModelInfo {
-    id: string;
-    name: string;
-    description?: string;
-}
-interface SessionModelState {
-    currentModelId: string;
-    availableModels: ModelInfo[];
-}
-interface AgentCapabilities {
-    name: string;
-    title?: string;
-    version?: string;
-    loadSession?: boolean;
-    promptCapabilities?: {
-        image?: boolean;
-        audio?: boolean;
-        embeddedContext?: boolean;
-    };
-    sessionCapabilities?: {
-        list?: boolean;
-        fork?: boolean;
-        close?: boolean;
-    };
-    mcp?: {
-        http?: boolean;
-        sse?: boolean;
-    };
-    authMethods?: AuthMethod[];
-}
-interface NewSessionResponse {
-    sessionId: string;
-    modes?: SessionModeState;
-    configOptions?: ConfigOption[];
-    models?: SessionModelState;
-}
-type AuthMethod = {
-    type: "agent";
-} | {
-    type: "env_var";
-    name: string;
-    description?: string;
-} | {
-    type: "terminal";
-};
-interface AuthenticateRequest {
-    methodId: string;
-}
-type StopReason = "end_turn" | "max_tokens" | "max_turn_requests" | "refusal" | "cancelled";
-interface PromptResponse {
-    stopReason: StopReason;
-    _meta?: Record<string, unknown>;
-}
-type ContentBlock = {
-    type: "text";
-    text: string;
-} | {
-    type: "image";
-    data: string;
-    mimeType: string;
-    uri?: string;
-} | {
-    type: "audio";
-    data: string;
-    mimeType: string;
-} | {
-    type: "resource";
-    resource: {
-        uri: string;
-        text?: string;
-        blob?: string;
-        mimeType?: string;
-    };
-} | {
-    type: "resource_link";
-    uri: string;
-    name: string;
-    mimeType?: string;
-    title?: string;
-    description?: string;
-    size?: number;
-};
-interface SessionListItem {
-    sessionId: string;
-    title?: string;
-    createdAt: string;
-    updatedAt?: string;
-    _meta?: Record<string, unknown>;
-}
-interface SessionListResponse {
-    sessions: SessionListItem[];
-    nextCursor?: string;
-}
-type McpServerConfig = {
-    type?: "stdio";
-    name: string;
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-} | {
-    type: "http";
-    name: string;
-    url: string;
-    headers?: Record<string, string>;
-} | {
-    type: "sse";
-    name: string;
-    url: string;
-    headers?: Record<string, string>;
-};
-
 declare const LoggingSchema: z.ZodDefault<z.ZodObject<{
     level: z.ZodDefault<z.ZodEnum<["silent", "debug", "info", "warn", "error", "fatal"]>>;
     logDir: z.ZodDefault<z.ZodString>;
@@ -554,7 +91,7 @@ declare const UsageSchema: z.ZodDefault<z.ZodObject<{
 type UsageConfig = z.infer<typeof UsageSchema>;
 declare const ConfigSchema: z.ZodObject<{
     instanceName: z.ZodOptional<z.ZodString>;
-    channels: z.ZodObject<{}, "strip", z.ZodObject<{
+    channels: z.ZodDefault<z.ZodObject<{}, "strip", z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         adapter: z.ZodOptional<z.ZodString>;
         displayVerbosity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
@@ -599,7 +136,7 @@ declare const ConfigSchema: z.ZodObject<{
         adapter: z.ZodOptional<z.ZodString>;
         displayVerbosity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
         outputMode: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
-    }, z.ZodTypeAny, "passthrough">>, "strip">>;
+    }, z.ZodTypeAny, "passthrough">>, "strip">>>;
     agents: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         command: z.ZodString;
         args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -919,14 +456,6 @@ declare const ConfigSchema: z.ZodObject<{
     instanceName?: string | undefined;
     outputMode?: "low" | "medium" | "high" | undefined;
 }, {
-    channels: {} & {
-        [k: string]: z.objectInputType<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            adapter: z.ZodOptional<z.ZodString>;
-            displayVerbosity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
-            outputMode: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
-        }, z.ZodTypeAny, "passthrough">;
-    };
     defaultAgent: string;
     api?: {
         port?: number | undefined;
@@ -958,6 +487,22 @@ declare const ConfigSchema: z.ZodObject<{
         retentionDays?: number | undefined;
     } | undefined;
     instanceName?: string | undefined;
+    channels?: z.objectInputType<{}, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        adapter: z.ZodOptional<z.ZodString>;
+        displayVerbosity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+        outputMode: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        adapter: z.ZodOptional<z.ZodString>;
+        displayVerbosity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+        outputMode: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        adapter: z.ZodOptional<z.ZodString>;
+        displayVerbosity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+        outputMode: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    }, z.ZodTypeAny, "passthrough">>, "strip"> | undefined;
     outputMode?: "low" | "medium" | "high" | undefined;
     workspace?: {
         baseDir?: string | undefined;
@@ -1012,6 +557,12 @@ declare class ConfigManager$1 extends EventEmitter {
     load(): Promise<void>;
     get(): Config;
     save(updates: Record<string, unknown>, changePath?: string): Promise<void>;
+    /**
+     * Set a single config value by dot-path (e.g. "security.maxConcurrentSessions").
+     * Builds the nested update object, validates, and saves.
+     * Throws if the path contains blocked keys or the value fails Zod validation.
+     */
+    setPath(dotPath: string, value: unknown): Promise<void>;
     resolveWorkspace(input?: string): string;
     exists(): Promise<boolean>;
     getConfigPath(): string;
@@ -1040,62 +591,6 @@ declare function createSessionLogger(sessionId: string, parentLogger: Logger$1):
 declare function shutdownLogger(): Promise<void>;
 declare function cleanupOldSessionLogs(retentionDays: number): Promise<void>;
 
-interface ChannelConfig {
-    enabled: boolean;
-    [key: string]: unknown;
-}
-interface AdapterCapabilities {
-    streaming: boolean;
-    richFormatting: boolean;
-    threads: boolean;
-    reactions: boolean;
-    fileUpload: boolean;
-    voice: boolean;
-}
-interface IChannelAdapter {
-    readonly name: string;
-    readonly capabilities: AdapterCapabilities;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    sendMessage(sessionId: string, content: OutgoingMessage): Promise<void>;
-    sendPermissionRequest(sessionId: string, request: PermissionRequest): Promise<void>;
-    sendNotification(notification: NotificationMessage): Promise<void>;
-    createSessionThread(sessionId: string, name: string): Promise<string>;
-    renameSessionThread(sessionId: string, newName: string): Promise<void>;
-    deleteSessionThread?(sessionId: string): Promise<void>;
-    archiveSessionTopic?(sessionId: string): Promise<void>;
-    stripTTSBlock?(sessionId: string): Promise<void>;
-    sendSkillCommands?(sessionId: string, commands: AgentCommand[]): Promise<void>;
-    cleanupSkillCommands?(sessionId: string): Promise<void>;
-    /** Flush skill commands that were queued before threadId was available */
-    flushPendingSkillCommands?(sessionId: string): Promise<void>;
-    cleanupSessionState?(sessionId: string): Promise<void>;
-}
-/**
- * Base class providing default no-op implementations for optional methods.
- * Adapters can extend this or implement IChannelAdapter directly.
- * @deprecated Use MessagingAdapter or StreamAdapter instead. Kept for backward compat during migration.
- */
-declare abstract class ChannelAdapter<TCore = unknown> implements IChannelAdapter {
-    readonly core: TCore;
-    protected config: ChannelConfig;
-    abstract readonly name: string;
-    readonly capabilities: AdapterCapabilities;
-    constructor(core: TCore, config: ChannelConfig);
-    abstract start(): Promise<void>;
-    abstract stop(): Promise<void>;
-    abstract sendMessage(sessionId: string, content: OutgoingMessage): Promise<void>;
-    abstract sendPermissionRequest(sessionId: string, request: PermissionRequest): Promise<void>;
-    abstract sendNotification(notification: NotificationMessage): Promise<void>;
-    abstract createSessionThread(sessionId: string, name: string): Promise<string>;
-    abstract renameSessionThread(sessionId: string, newName: string): Promise<void>;
-    deleteSessionThread(_sessionId: string): Promise<void>;
-    sendSkillCommands(_sessionId: string, _commands: AgentCommand[]): Promise<void>;
-    cleanupSkillCommands(_sessionId: string): Promise<void>;
-    cleanupSessionState(_sessionId: string): Promise<void>;
-    archiveSessionTopic(_sessionId: string): Promise<void>;
-}
-
 declare function nodeToWebWritable(nodeStream: NodeJS.WritableStream): WritableStream<Uint8Array>;
 declare function nodeToWebReadable(nodeStream: NodeJS.ReadableStream): ReadableStream<Uint8Array>;
 
@@ -1231,7 +726,7 @@ declare class AgentInstance extends TypedEmitter<AgentInstanceEvents> {
     authenticate(methodId: string): Promise<void>;
     forkSession(sessionId: string, cwd: string, mcpServers?: McpServerConfig[]): Promise<ForkSessionResponse>;
     closeSession(sessionId: string): Promise<void>;
-    prompt(text: string, attachments?: Attachment[]): Promise<PromptResponse$1>;
+    prompt(text: string, attachments?: Attachment[]): Promise<PromptResponse>;
     cancel(): Promise<void>;
     destroy(): Promise<void>;
 }
@@ -1418,8 +913,11 @@ declare class Session extends TypedEmitter<SessionEvents> {
     promptCount: number;
     firstAgent: string;
     agentSwitchHistory: AgentSwitchEntry[];
+    isAssistant: boolean;
     log: Logger$1;
     middlewareChain?: MiddlewareChain;
+    /** Latest commands emitted by the agent — buffered before bridge connects so they're not lost */
+    latestCommands: AgentCommand[] | null;
     readonly permissionGate: PermissionGate;
     private readonly queue;
     private speechService?;
@@ -1431,11 +929,12 @@ declare class Session extends TypedEmitter<SessionEvents> {
         workingDirectory: string;
         agentInstance: AgentInstance;
         speechService?: SpeechService;
+        isAssistant?: boolean;
     });
     get status(): SessionStatus;
     /** Transition to active — from initializing, error, or cancelled */
     activate(): void;
-    /** Transition to error — from initializing or active */
+    /** Transition to error — from initializing or active. Idempotent if already in error. */
     fail(reason: string): void;
     /** Transition to finished — from active only. Emits session_end for backward compat. */
     finish(reason?: string): void;
@@ -1459,6 +958,8 @@ declare class Session extends TypedEmitter<SessionEvents> {
     getConfigValue(id: string): string | undefined;
     /** Set session name explicitly and emit 'named' event */
     setName(name: string): void;
+    /** Send a config option change to the agent and update local state from the response. */
+    setConfigOption(configId: string, value: SetConfigOptionValue): Promise<void>;
     updateConfigOptions(options: ConfigOption[]): Promise<void>;
     /** Snapshot of current ACP state for persistence */
     toAcpStateSnapshot(): NonNullable<SessionRecord["acpState"]>;
@@ -1491,6 +992,27 @@ declare class PromptQueue {
     get isProcessing(): boolean;
 }
 
+interface AssistantCommand {
+    command: string;
+    description: string;
+}
+interface AssistantSection {
+    id: string;
+    title: string;
+    priority: number;
+    buildContext: () => string | null;
+    commands?: AssistantCommand[];
+}
+declare class AssistantRegistry {
+    private sections;
+    private _instanceRoot;
+    /** Set the instance root path used in assistant guidelines */
+    setInstanceRoot(root: string): void;
+    register(section: AssistantSection): void;
+    unregister(id: string): void;
+    buildSystemPrompt(channelId?: string): string;
+}
+
 type PluginPermission = 'events:read' | 'events:emit' | 'services:register' | 'services:use' | 'middleware:register' | 'commands:register' | 'storage:read' | 'storage:write' | 'kernel:access';
 interface OpenACPPlugin {
     /** Unique identifier, e.g., '@openacp/security' */
@@ -1621,7 +1143,26 @@ type CommandResponse = {
     message: string;
 } | {
     type: 'silent';
+} | {
+    type: 'delegated';
 };
+interface MenuItem {
+    id: string;
+    label: string;
+    priority: number;
+    group?: string;
+    action: {
+        type: 'command';
+        command: string;
+    } | {
+        type: 'delegate';
+        prompt: string;
+    } | {
+        type: 'callback';
+        callbackData: string;
+    };
+    visible?: () => boolean;
+}
 interface MenuOption {
     label: string;
     command: string;
@@ -1705,6 +1246,14 @@ interface PluginContext {
     getService<T>(name: string): T | undefined;
     /** Register slash command. Requires 'commands:register'. */
     registerCommand(def: CommandDef): void;
+    /** Register a menu item. Requires 'commands:register'. */
+    registerMenuItem(item: MenuItem): void;
+    /** Unregister a menu item by id. Requires 'commands:register'. */
+    unregisterMenuItem(id: string): void;
+    /** Register an assistant section. Requires 'commands:register'. */
+    registerAssistantSection(section: AssistantSection): void;
+    /** Unregister an assistant section by id. Requires 'commands:register'. */
+    unregisterAssistantSection(id: string): void;
     /** Plugin-scoped storage. Requires 'storage:read' and/or 'storage:write'. */
     storage: PluginStorage;
     /** Plugin-scoped logger. Always available (no permission needed). */
@@ -1916,7 +1465,7 @@ interface ViewerStoreInterface {
 }
 interface TunnelServiceInterface {
     getPublicUrl(): string;
-    start(): Promise<string>;
+    start(apiPort: number): Promise<string>;
     stop(): Promise<void>;
     getStore(): ViewerStoreInterface;
     fileUrl(entryId: string): string;
@@ -1942,6 +1491,8 @@ declare class MessageTransformer {
 
 interface SessionStore {
     save(record: SessionRecord): Promise<void>;
+    /** Immediately flush pending writes to disk (no debounce). */
+    flush(): void;
     get(sessionId: string): SessionRecord | undefined;
     findByPlatform(channelId: string, predicate: (platform: Record<string, unknown>) => boolean): SessionRecord | undefined;
     findByAgentSessionId(agentSessionId: string): SessionRecord | undefined;
@@ -2017,6 +1568,11 @@ interface EventBusEvents {
         attachments?: unknown[];
     }) => void;
     "usage:recorded": (data: UsageRecordEvent) => void;
+    "session:threadReady": (data: {
+        sessionId: string;
+        channelId: string;
+        threadId: string;
+    }) => void;
     "session:configChanged": (data: {
         sessionId: string;
     }) => void;
@@ -2046,7 +1602,9 @@ declare class SessionManager {
     getRecordByAgentSessionId(agentSessionId: string): SessionRecord | undefined;
     getRecordByThread(channelId: string, threadId: string): SessionRecord | undefined;
     registerSession(session: Session): void;
-    patchRecord(sessionId: string, patch: Partial<SessionRecord>): Promise<void>;
+    patchRecord(sessionId: string, patch: Partial<SessionRecord>, options?: {
+        immediate?: boolean;
+    }): Promise<void>;
     getSessionRecord(sessionId: string): SessionRecord | undefined;
     cancelSession(sessionId: string): Promise<void>;
     listSessions(channelId?: string): Session[];
@@ -2086,24 +1644,26 @@ declare class SessionBridge {
     private adapter;
     private deps;
     private connected;
-    private agentEventHandler?;
-    private sessionEventHandler?;
-    private statusChangeHandler?;
-    private namedHandler?;
-    private promptCountHandler?;
+    private cleanupFns;
     constructor(session: Session, adapter: IChannelAdapter, deps: BridgeDeps);
     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;
     connect(): void;
     disconnect(): void;
-    private wireAgentToSession;
-    private wireSessionToAdapter;
+    /** Dispatch an agent event through middleware and to the adapter */
+    private dispatchAgentEvent;
     private handleAgentEvent;
     /** Persist current ACP state (configOptions, agentCapabilities) to session store as cache */
     private persistAcpState;
-    private wirePermissions;
-    private wireLifecycle;
+    /** Resolve a permission request through the full pipeline: middleware -> auto-approve -> ask user */
+    private resolvePermission;
+    /** Check if a permission request should be auto-approved (openacp commands or bypass mode) */
+    private checkAutoApprove;
+    /** Emit permission:afterResolve middleware hook (fire-and-forget) */
+    private emitAfterResolve;
 }
 
 interface TunnelEntry {
@@ -2148,12 +1708,11 @@ declare class ViewerStore {
 declare class TunnelService {
     private registry;
     private store;
-    private server;
     private config;
-    private systemPort;
+    private apiPort;
     private startError;
     constructor(config: TunnelConfig, registryPath?: string, binDir?: string);
-    start(): Promise<string>;
+    start(apiPort: number): Promise<string>;
     stop(): Promise<void>;
     addTunnel(port: number, opts?: {
         label?: string;
@@ -2219,10 +1778,127 @@ interface ContextResult {
     };
 }
 
+interface SessionHistory {
+    version: 1;
+    sessionId: string;
+    turns: Turn[];
+}
+interface Turn {
+    index: number;
+    role: "user" | "assistant";
+    timestamp: string;
+    content?: string;
+    attachments?: HistoryAttachment[];
+    steps?: Step[];
+    usage?: HistoryUsage;
+    stopReason?: string;
+}
+interface HistoryAttachment {
+    type: "image" | "audio" | "file";
+    fileName: string;
+    mimeType: string;
+    size: number;
+}
+interface HistoryUsage {
+    tokensUsed?: number;
+    contextSize?: number;
+    cost?: {
+        amount: number;
+        currency: string;
+    };
+}
+type Step = ThinkingStep | TextStep | ToolCallStep | PlanStep | ImageStep | AudioStep | ResourceStep | ResourceLinkStep | ModeChangeStep | ConfigChangeStep;
+interface ThinkingStep {
+    type: "thinking";
+    content: string;
+}
+interface TextStep {
+    type: "text";
+    content: string;
+}
+interface ToolCallStep {
+    type: "tool_call";
+    id: string;
+    name: string;
+    kind?: string;
+    status: string;
+    input?: unknown;
+    output?: unknown;
+    diff?: {
+        path: string;
+        oldText?: string;
+        newText: string;
+    } | null;
+    locations?: {
+        path: string;
+        line?: number;
+    }[];
+    permission?: {
+        requested: boolean;
+        outcome: string;
+    } | null;
+}
+interface PlanStep {
+    type: "plan";
+    entries: {
+        content: string;
+        priority: string;
+        status: string;
+    }[];
+}
+interface ImageStep {
+    type: "image";
+    mimeType: string;
+    filePath: string;
+    size?: number;
+}
+interface AudioStep {
+    type: "audio";
+    mimeType: string;
+    filePath: string;
+    size?: number;
+}
+interface ResourceStep {
+    type: "resource";
+    uri: string;
+    name: string;
+    text?: string;
+}
+interface ResourceLinkStep {
+    type: "resource_link";
+    uri: string;
+    name: string;
+    title?: string;
+    description?: string;
+}
+interface ModeChangeStep {
+    type: "mode_change";
+    modeId: string;
+}
+interface ConfigChangeStep {
+    type: "config_change";
+    configId: string;
+    value: string;
+}
+
+declare class HistoryStore {
+    private readonly dir;
+    constructor(dir: string);
+    write(history: SessionHistory): Promise<void>;
+    read(sessionId: string): Promise<SessionHistory | null>;
+    exists(sessionId: string): Promise<boolean>;
+    list(): Promise<string[]>;
+    delete(sessionId: string): Promise<void>;
+    private filePath;
+}
+
 declare class ContextManager {
     private providers;
     private cache;
+    private historyStore?;
     constructor(cachePath?: string);
+    setHistoryStore(store: HistoryStore): void;
+    getHistory(sessionId: string): Promise<SessionHistory | null>;
     register(provider: ContextProvider): void;
     getProvider(repoPath: string): Promise<ContextProvider | null>;
     listSessions(query: ContextQuery): Promise<SessionListResult | null>;
@@ -2408,6 +2084,45 @@ declare class LifecycleManager {
     shutdown(): Promise<void>;
 }
 
+declare class MenuRegistry {
+    private items;
+    register(item: MenuItem): void;
+    unregister(id: string): void;
+    getItem(id: string): MenuItem | undefined;
+    /** Get all visible items sorted by priority */
+    getItems(): MenuItem[];
+}
+
+interface AssistantManagerCore {
+    createSession(params: {
+        channelId: string;
+        agentName: string;
+        workingDirectory: string;
+        initialName?: string;
+        isAssistant?: boolean;
+    }): Promise<Session>;
+    connectSessionBridge(session: Session): void;
+    configManager: {
+        get(): {
+            defaultAgent: string;
+        };
+        resolveWorkspace(): string;
+    };
+}
+declare class AssistantManager {
+    private core;
+    private registry;
+    private sessions;
+    private readyState;
+    private respawning;
+    constructor(core: AssistantManagerCore, registry: AssistantRegistry);
+    spawn(channelId: string, threadId: string): Promise<Session>;
+    get(channelId: string): Session | null;
+    isAssistant(sessionId: string): boolean;
+    respawn(channelId: string, threadId: string): Promise<Session>;
+    waitReady(channelId: string): Promise<void>;
+}
+
 interface InstanceContext {
     id: string;
     root: string;
@@ -2450,6 +2165,9 @@ declare class OpenACPCore {
     readonly lifecycleManager: LifecycleManager;
     private agentSwitchHandler;
     readonly instanceContext?: InstanceContext;
+    readonly menuRegistry: MenuRegistry;
+    readonly assistantRegistry: AssistantRegistry;
+    assistantManager: AssistantManager;
     private getService;
     get securityGuard(): SecurityGuard;
     get notificationManager(): NotificationManager;
@@ -2508,7 +2226,10 @@ declare class OpenACPCore {
         resumed: boolean;
     }>;
     getOrResumeSession(channelId: string, threadId: string): Promise<Session | null>;
-    /** Create a SessionBridge for the given session and adapter */
+    /** 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;
 }
 
@@ -2697,10 +2418,28 @@ interface CreateTokenOpts {
     expire: string;
     scopes?: string[];
 }
+interface StoredCode {
+    code: string;
+    role: string;
+    scopes?: string[];
+    name: string;
+    expire: string;
+    createdAt: string;
+    expiresAt: string;
+    used: boolean;
+}
+interface CreateCodeOpts {
+    role: string;
+    name: string;
+    expire: string;
+    scopes?: string[];
+    codeTtlMs?: number;
+}
 
 declare class TokenStore {
     private filePath;
     private tokens;
+    private codes;
     private savePromise;
     private savePending;
     constructor(filePath: string);
@@ -2713,9 +2452,14 @@ declare class TokenStore {
     list(): StoredToken[];
     private lastUsedSaveTimer;
     updateLastUsed(id: string): void;
-    /** Wait for any in-flight save to complete */
+    /** Wait for any in-flight and pending saves to complete */
     flush(): Promise<void>;
     destroy(): void;
+    createCode(opts: CreateCodeOpts): StoredCode;
+    getCode(code: string): StoredCode | undefined;
+    exchangeCode(code: string): StoredCode | undefined;
+    listCodes(): StoredCode[];
+    revokeCode(code: string): void;
     cleanup(): void;
 }
 
@@ -3232,8 +2976,6 @@ declare class TelegramAdapter extends MessagingAdapter {
     private telegramConfig;
     private saveTopicIds?;
     private permissionHandler;
-    private assistantSession;
-    private assistantInitializing;
     private notificationTopicId;
     private assistantTopicId;
     private sendQueue;
@@ -3319,4 +3061,4 @@ declare class TelegramAdapter extends MessagingAdapter {
     archiveSessionTopic(sessionId: string): Promise<void>;
 }
 
-export { ActivityTracker, type AdapterCapabilities, type AgentCapabilities, AgentCatalog, type AgentCommand, type AgentDefinition, type AgentDistribution, type AgentEvent, AgentInstance, type AgentListItem, AgentManager, AgentStore, type AgentSwitchEntry, type ApiConfig, type ApiServerInstance, type ApiServerOptions, type ApiServerService, type Attachment, type AuthMethod, type AuthenticateRequest, type AvailabilityResult, BaseRenderer, type BridgeDeps, CONFIG_REGISTRY, ChannelAdapter, type ChannelConfig, type CleanupResult, type CommandArgs, type CommandDef, CommandRegistry, type CommandResponse, type Config, type ConfigFieldDef, ConfigManager$1 as ConfigManager, type ConfigOption, type ConfigSelectChoice, type ConfigSelectGroup, type ContentBlock, ContextManager, type ContextOptions, type ContextProvider, type ContextQuery, type ContextResult, type ContextService, type SessionInfo as ContextSessionInfo, type DeleteTopicResult, DisplaySpecBuilder, type DisplayVerbosity, DoctorEngine, type DoctorReport, DraftManager, EntireProvider, EventBus, type EventBusEvents, FileService, type FileServiceInterface, GroqSTT, type IChannelAdapter, type IRenderer, type IncomingMessage, type InstallContext, type InstallProgress, type InstallResult, type InstalledAgent, KIND_ICONS, type ListItem, type Logger$1 as Logger, type LoggingConfig, type McpServerConfig, type MenuOption, MessageTransformer, MessagingAdapter, type MessagingAdapterConfig, type MigrateContext, type ModelInfo, type NewSessionResponse, NotificationManager, type NotificationMessage, type NotificationService, OpenACPCore, type OpenACPPlugin, type OutgoingMessage, type OutputMode, OutputModeResolver, PRODUCT_GUIDE, type PendingFix, PermissionGate, type PermissionOption, type PermissionRequest, type PlanEntry, type PluginContext, type PluginPermission, type PluginStorage, PromptQueue, type PromptResponse, type RegistryAgent, type RegistryBinaryTarget, type RegistryDistribution, type RenderedMessage, SSEManager, STATUS_ICONS, type STTOptions, type STTProvider$1 as STTProvider, type STTResult, SecurityGuard, type SecurityService, SendQueue, Session, SessionBridge, type SessionCreateParams, type SessionEvents, SessionFactory, type SessionListItem, type SessionListResponse, type SessionListResult, SessionManager, type SessionMode, type SessionModeState, type SessionModelState, type SessionRecord, type SessionStatus, type SetConfigOptionValue, type SettingsAPI, type SideEffectDeps, type SpeechProviderConfig, SpeechService, type SpeechServiceConfig, type SpeechServiceInterface, StaticServer, StderrCapture, type StopReason, StreamAdapter, type TTSOptions, type TTSProvider$1 as TTSProvider, type TTSResult, TelegramAdapter, type TelegramPlatformData, type TerminalIO, ThoughtBuffer, type ThoughtDisplaySpec, type ToolCallMeta, ToolCallTracker, type ToolCardSnapshot, ToolCardState, type ToolCardStateConfig, type ToolDisplaySpec, type ToolEntry, ToolStateMap, type ToolUpdateMeta, type TopicInfo, TopicManager, type TunnelServiceInterface, TypedEmitter, type UsageConfig, type UsageRecord, type UsageRecordEvent, type UsageService, type 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$1 as 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$1 as 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$1 as 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$1 as 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 };