@openacp/cli 2026.404.2 → 2026.405.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, T as TurnContext, C as ConfigOption, k as AgentSwitchEntry, l as AgentCommand, 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-DQWwxUKX.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-DQWwxUKX.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, T as TurnContext, C as ConfigOption, k as AgentSwitchEntry, l as AgentCommand, 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-DstweC6V.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-DstweC6V.js';
 import pino from 'pino';
 import * as zod from 'zod';
 import { ZodSchema, z } from 'zod';
@@ -76,6 +76,20 @@ interface SettingsAPI {
     clear(): Promise<void>;
     has(key: string): Promise<boolean>;
 }
+/** Describes a settings field that a plugin exposes as editable via API/UI */
+interface FieldDef {
+    /** Settings key (matches the key in plugin settings.json) */
+    key: string;
+    /** Human-readable label for UI display */
+    displayName: string;
+    type: "toggle" | "select" | "number" | "string";
+    /** safe = readable via API; sensitive = write-only (e.g., tokens) */
+    scope: "safe" | "sensitive";
+    /** Whether the change takes effect without restart. Default: false */
+    hotReload?: boolean;
+    /** Valid values for "select" type */
+    options?: string[];
+}
 interface TerminalIO {
     text(opts: {
         message: string;
@@ -127,7 +141,6 @@ interface InstallContext {
     pluginName: string;
     terminal: TerminalIO;
     settings: SettingsAPI;
-    legacyConfig?: Record<string, unknown>;
     dataDir: string;
     log: Logger$1;
     /** Root of the OpenACP instance directory (e.g. ~/.openacp) */
@@ -270,6 +283,12 @@ interface PluginContext {
     registerAssistantSection(section: AssistantSection): void;
     /** Unregister an assistant section by id. Requires 'commands:register'. */
     unregisterAssistantSection(id: string): void;
+    /**
+     * Declare this plugin's settings fields as editable via API/UI.
+     * Call in setup() after registering services.
+     * Requires 'commands:register'.
+     */
+    registerEditableFields(fields: FieldDef[]): void;
     /** Plugin-scoped storage. Requires 'storage:read' and/or 'storage:write'. */
     storage: PluginStorage;
     /** Plugin-scoped logger. Always available (no permission needed). */
@@ -525,131 +544,8 @@ declare const LoggingSchema: z.ZodDefault<z.ZodObject<{
     sessionLogRetentionDays?: number | undefined;
 }>>;
 type LoggingConfig = z.infer<typeof LoggingSchema>;
-declare const TunnelSchema: z.ZodDefault<z.ZodObject<{
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    port: z.ZodDefault<z.ZodNumber>;
-    provider: z.ZodDefault<z.ZodEnum<["openacp", "cloudflare", "ngrok", "bore", "tailscale"]>>;
-    options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    maxUserTunnels: z.ZodDefault<z.ZodNumber>;
-    storeTtlMinutes: z.ZodDefault<z.ZodNumber>;
-    auth: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        token: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        enabled: boolean;
-        token?: string | undefined;
-    }, {
-        enabled?: boolean | undefined;
-        token?: string | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    provider: "openacp" | "cloudflare" | "ngrok" | "bore" | "tailscale";
-    enabled: boolean;
-    options: Record<string, unknown>;
-    port: number;
-    maxUserTunnels: number;
-    storeTtlMinutes: number;
-    auth: {
-        enabled: boolean;
-        token?: string | undefined;
-    };
-}, {
-    provider?: "openacp" | "cloudflare" | "ngrok" | "bore" | "tailscale" | undefined;
-    enabled?: boolean | undefined;
-    options?: Record<string, unknown> | undefined;
-    port?: number | undefined;
-    maxUserTunnels?: number | undefined;
-    storeTtlMinutes?: number | undefined;
-    auth?: {
-        enabled?: boolean | undefined;
-        token?: string | undefined;
-    } | undefined;
-}>>;
-type TunnelConfig = z.infer<typeof TunnelSchema>;
-declare const UsageSchema: z.ZodDefault<z.ZodObject<{
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    monthlyBudget: z.ZodOptional<z.ZodNumber>;
-    warningThreshold: z.ZodDefault<z.ZodNumber>;
-    currency: z.ZodDefault<z.ZodString>;
-    retentionDays: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    enabled: boolean;
-    warningThreshold: number;
-    currency: string;
-    retentionDays: number;
-    monthlyBudget?: number | undefined;
-}, {
-    enabled?: boolean | undefined;
-    monthlyBudget?: number | undefined;
-    warningThreshold?: number | undefined;
-    currency?: string | undefined;
-    retentionDays?: number | undefined;
-}>>;
-type UsageConfig = z.infer<typeof UsageSchema>;
 declare const ConfigSchema: z.ZodObject<{
     instanceName: z.ZodOptional<z.ZodString>;
-    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"]>>;
-        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">>, z.objectOutputType<{}, 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">, 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">>>;
-    agents: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        command: z.ZodString;
-        args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-        workingDirectory: z.ZodOptional<z.ZodString>;
-        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        command: string;
-        args: string[];
-        env: Record<string, string>;
-        workingDirectory?: string | undefined;
-    }, {
-        command: string;
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-        workingDirectory?: string | undefined;
-    }>>>>;
     defaultAgent: z.ZodString;
     workspace: z.ZodDefault<z.ZodObject<{
         baseDir: z.ZodDefault<z.ZodString>;
@@ -676,19 +572,6 @@ declare const ConfigSchema: z.ZodObject<{
             envWhitelist?: string[] | undefined;
         } | undefined;
     }>>;
-    security: z.ZodDefault<z.ZodObject<{
-        allowedUserIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-        maxConcurrentSessions: z.ZodDefault<z.ZodNumber>;
-        sessionTimeoutMinutes: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        allowedUserIds: string[];
-        maxConcurrentSessions: number;
-        sessionTimeoutMinutes: number;
-    }, {
-        allowedUserIds?: string[] | undefined;
-        maxConcurrentSessions?: number | undefined;
-        sessionTimeoutMinutes?: number | undefined;
-    }>>;
     logging: z.ZodDefault<z.ZodObject<{
         level: z.ZodDefault<z.ZodEnum<["silent", "debug", "info", "warn", "error", "fatal"]>>;
         logDir: z.ZodDefault<z.ZodString>;
@@ -710,16 +593,6 @@ declare const ConfigSchema: z.ZodObject<{
     }>>;
     runMode: z.ZodDefault<z.ZodEnum<["foreground", "daemon"]>>;
     autoStart: z.ZodDefault<z.ZodBoolean>;
-    api: z.ZodDefault<z.ZodObject<{
-        port: z.ZodDefault<z.ZodNumber>;
-        host: z.ZodDefault<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        port: number;
-        host: string;
-    }, {
-        port?: number | undefined;
-        host?: string | undefined;
-    }>>;
     sessionStore: z.ZodDefault<z.ZodObject<{
         ttlDays: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
@@ -727,65 +600,6 @@ declare const ConfigSchema: z.ZodObject<{
     }, {
         ttlDays?: number | undefined;
     }>>;
-    tunnel: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        port: z.ZodDefault<z.ZodNumber>;
-        provider: z.ZodDefault<z.ZodEnum<["openacp", "cloudflare", "ngrok", "bore", "tailscale"]>>;
-        options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        maxUserTunnels: z.ZodDefault<z.ZodNumber>;
-        storeTtlMinutes: z.ZodDefault<z.ZodNumber>;
-        auth: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            token: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            enabled: boolean;
-            token?: string | undefined;
-        }, {
-            enabled?: boolean | undefined;
-            token?: string | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        provider: "openacp" | "cloudflare" | "ngrok" | "bore" | "tailscale";
-        enabled: boolean;
-        options: Record<string, unknown>;
-        port: number;
-        maxUserTunnels: number;
-        storeTtlMinutes: number;
-        auth: {
-            enabled: boolean;
-            token?: string | undefined;
-        };
-    }, {
-        provider?: "openacp" | "cloudflare" | "ngrok" | "bore" | "tailscale" | undefined;
-        enabled?: boolean | undefined;
-        options?: Record<string, unknown> | undefined;
-        port?: number | undefined;
-        maxUserTunnels?: number | undefined;
-        storeTtlMinutes?: number | undefined;
-        auth?: {
-            enabled?: boolean | undefined;
-            token?: string | undefined;
-        } | undefined;
-    }>>;
-    usage: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        monthlyBudget: z.ZodOptional<z.ZodNumber>;
-        warningThreshold: z.ZodDefault<z.ZodNumber>;
-        currency: z.ZodDefault<z.ZodString>;
-        retentionDays: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        enabled: boolean;
-        warningThreshold: number;
-        currency: string;
-        retentionDays: number;
-        monthlyBudget?: number | undefined;
-    }, {
-        enabled?: boolean | undefined;
-        monthlyBudget?: number | undefined;
-        warningThreshold?: number | undefined;
-        currency?: string | undefined;
-        retentionDays?: number | undefined;
-    }>>;
     integrations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         installed: z.ZodBoolean;
         installedAt: z.ZodOptional<z.ZodString>;
@@ -796,88 +610,6 @@ declare const ConfigSchema: z.ZodObject<{
         installed: boolean;
         installedAt?: string | undefined;
     }>>>;
-    speech: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        stt: z.ZodDefault<z.ZodObject<{
-            provider: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-            providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, "strip", z.ZodTypeAny, {
-            provider: string | null;
-            providers: Record<string, z.objectOutputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">>;
-        }, {
-            provider?: string | null | undefined;
-            providers?: Record<string, z.objectInputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">> | undefined;
-        }>>;
-        tts: z.ZodDefault<z.ZodObject<{
-            provider: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-            providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, "strip", z.ZodTypeAny, {
-            provider: string | null;
-            providers: Record<string, z.objectOutputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">>;
-        }, {
-            provider?: string | null | undefined;
-            providers?: Record<string, z.objectInputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">> | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        stt: {
-            provider: string | null;
-            providers: Record<string, z.objectOutputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">>;
-        };
-        tts: {
-            provider: string | null;
-            providers: Record<string, z.objectOutputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">>;
-        };
-    }, {
-        stt?: {
-            provider?: string | null | undefined;
-            providers?: Record<string, z.objectInputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">> | undefined;
-        } | undefined;
-        tts?: {
-            provider?: string | null | undefined;
-            providers?: Record<string, z.objectInputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">> | undefined;
-        } | undefined;
-    }>>>;
     outputMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
     agentSwitch: z.ZodDefault<z.ZodObject<{
         labelHistory: z.ZodDefault<z.ZodBoolean>;
@@ -887,49 +619,7 @@ declare const ConfigSchema: z.ZodObject<{
         labelHistory?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    api: {
-        port: number;
-        host: string;
-    };
-    agents: Record<string, {
-        command: string;
-        args: string[];
-        env: Record<string, string>;
-        workingDirectory?: string | undefined;
-    }>;
-    tunnel: {
-        provider: "openacp" | "cloudflare" | "ngrok" | "bore" | "tailscale";
-        enabled: boolean;
-        options: Record<string, unknown>;
-        port: number;
-        maxUserTunnels: number;
-        storeTtlMinutes: number;
-        auth: {
-            enabled: boolean;
-            token?: string | undefined;
-        };
-    };
-    channels: {} & {
-        [k: string]: 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">;
-    };
-    usage: {
-        enabled: boolean;
-        warningThreshold: number;
-        currency: string;
-        retentionDays: number;
-        monthlyBudget?: number | undefined;
-    };
     defaultAgent: string;
-    security: {
-        allowedUserIds: string[];
-        maxConcurrentSessions: number;
-        sessionTimeoutMinutes: number;
-    };
     workspace: {
         baseDir: string;
         security: {
@@ -953,22 +643,6 @@ declare const ConfigSchema: z.ZodObject<{
         installed: boolean;
         installedAt?: string | undefined;
     }>;
-    speech: {
-        stt: {
-            provider: string | null;
-            providers: Record<string, z.objectOutputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">>;
-        };
-        tts: {
-            provider: string | null;
-            providers: Record<string, z.objectOutputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">>;
-        };
-    };
     agentSwitch: {
         labelHistory: boolean;
     };
@@ -976,58 +650,7 @@ declare const ConfigSchema: z.ZodObject<{
     outputMode?: "low" | "medium" | "high" | undefined;
 }, {
     defaultAgent: string;
-    api?: {
-        port?: number | undefined;
-        host?: string | undefined;
-    } | undefined;
-    agents?: Record<string, {
-        command: string;
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-        workingDirectory?: string | undefined;
-    }> | undefined;
-    tunnel?: {
-        provider?: "openacp" | "cloudflare" | "ngrok" | "bore" | "tailscale" | undefined;
-        enabled?: boolean | undefined;
-        options?: Record<string, unknown> | undefined;
-        port?: number | undefined;
-        maxUserTunnels?: number | undefined;
-        storeTtlMinutes?: number | undefined;
-        auth?: {
-            enabled?: boolean | undefined;
-            token?: string | undefined;
-        } | 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;
-    usage?: {
-        enabled?: boolean | undefined;
-        monthlyBudget?: number | undefined;
-        warningThreshold?: number | undefined;
-        currency?: string | undefined;
-        retentionDays?: number | undefined;
-    } | undefined;
-    security?: {
-        allowedUserIds?: string[] | undefined;
-        maxConcurrentSessions?: number | undefined;
-        sessionTimeoutMinutes?: number | undefined;
-    } | undefined;
     workspace?: {
         baseDir?: string | undefined;
         security?: {
@@ -1051,22 +674,7 @@ declare const ConfigSchema: z.ZodObject<{
         installed: boolean;
         installedAt?: string | undefined;
     }> | undefined;
-    speech?: {
-        stt?: {
-            provider?: string | null | undefined;
-            providers?: Record<string, z.objectInputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">> | undefined;
-        } | undefined;
-        tts?: {
-            provider?: string | null | undefined;
-            providers?: Record<string, z.objectInputType<{
-                apiKey: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">> | undefined;
-        } | undefined;
-    } | undefined;
+    outputMode?: "low" | "medium" | "high" | undefined;
     agentSwitch?: {
         labelHistory?: boolean | undefined;
     } | undefined;
@@ -1081,7 +689,7 @@ declare class ConfigManager extends EventEmitter {
     get(): Config;
     save(updates: Record<string, unknown>, changePath?: string): Promise<void>;
     /**
-     * Set a single config value by dot-path (e.g. "security.maxConcurrentSessions").
+     * Set a single config value by dot-path (e.g. "logging.level").
      * Builds the nested update object, validates, and saves.
      * Throws if the path contains blocked keys or the value fails Zod validation.
      */
@@ -1139,6 +747,7 @@ declare class StderrCapture {
  *   emitter.emit('data', 'hello')
  */
 declare class TypedEmitter<T extends Record<string & keyof T, (...args: any[]) => void>> {
+    private static readonly MAX_BUFFER_SIZE;
     private listeners;
     private paused;
     private buffer;
@@ -1460,6 +1069,9 @@ declare class Session extends TypedEmitter<SessionEvents> {
     threadIds: Map<string, string>;
     /** Active turn context — sealed on prompt dequeue, cleared on turn end */
     activeTurnContext: TurnContext | null;
+    /** The agentInstance for which the agent→session event relay is wired (prevents duplicate relays from multiple bridges).
+     *  When the agent is swapped, the relay must be re-wired to the new instance. */
+    agentRelaySource: AgentInstance | null;
     readonly permissionGate: PermissionGate;
     private readonly queue;
     private speechService?;
@@ -1538,6 +1150,8 @@ declare class PromptQueue {
     private queue;
     private processing;
     private abortController;
+    /** Set when abort is triggered; drainNext waits for the current processor to settle before starting the next item. */
+    private processorSettled;
     constructor(processor: (text: string, attachments?: Attachment[], routing?: TurnRouting, turnId?: string) => Promise<void>, onError?: ((err: unknown) => void) | undefined);
     enqueue(text: string, attachments?: Attachment[], routing?: TurnRouting, turnId?: string): Promise<void>;
     private process;
@@ -1558,6 +1172,10 @@ declare class MessageTransformer {
         id: string;
         workingDirectory: string;
     }): OutgoingMessage;
+    /** Clear cached entries whose key starts with the given prefix. */
+    clearSessionCaches(prefix: string): void;
+    /** Clear all caches. */
+    clearCaches(): void;
     /** Check if rawInput is a non-empty object (not null, not {}) */
     private isNonEmptyInput;
     private enrichWithViewerLinks;
@@ -1818,6 +1436,19 @@ declare class ViewerStore {
     destroy(): void;
 }
 
+interface TunnelConfig {
+    enabled: boolean;
+    port: number;
+    provider: string;
+    options: Record<string, unknown>;
+    storeTtlMinutes: number;
+    maxUserTunnels?: number;
+    auth: {
+        enabled: boolean;
+        token?: string;
+    };
+}
+
 declare class TunnelService {
     private registry;
     private store;
@@ -1860,6 +1491,8 @@ interface ContextOptions {
     limit?: number;
     /** When true, insert `## [agentName]` headers at agent boundaries in merged history */
     labelAgent?: boolean;
+    /** When true, skip the context cache (use for live switches where history just changed) */
+    noCache?: boolean;
 }
 interface SessionInfo {
     checkpointId: string;
@@ -2009,8 +1642,17 @@ declare class ContextManager {
     private providers;
     private cache;
     private historyStore?;
+    private sessionFlusher?;
     constructor(cachePath?: string);
     setHistoryStore(store: HistoryStore): void;
+    /** Register a callback that flushes in-memory recorder state for a session to disk. */
+    registerFlusher(fn: (sessionId: string) => Promise<void>): void;
+    /**
+     * Flush the recorder state for a session to disk before reading its context.
+     * Call this before buildContext() when switching agents to avoid a race
+     * where the last turn hasn't been persisted yet.
+     */
+    flushSession(sessionId: string): Promise<void>;
     getHistory(sessionId: string): Promise<SessionHistory | null>;
     register(provider: ContextProvider): void;
     getProvider(repoPath: string): Promise<ContextProvider | null>;
@@ -2467,11 +2109,6 @@ interface ConfigFieldDef {
     options?: string[] | ((config: Config) => string[]);
     scope: "safe" | "sensitive";
     hotReload: boolean;
-    /** If set, this field lives in plugin settings rather than config.json */
-    plugin?: {
-        name: string;
-        key: string;
-    };
 }
 declare const CONFIG_REGISTRY: ConfigFieldDef[];
 declare function getFieldDef(path: string): ConfigFieldDef | undefined;
@@ -3013,6 +2650,9 @@ interface ToolDisplaySpec {
     viewerLinks?: ViewerLinks;
     outputViewerLink?: string;
     outputFallbackContent?: string;
+    /** Working directory of the session that produced this tool call.
+     *  Adapters can use this to display relative paths instead of absolute ones. */
+    workingDirectory?: string;
     status: string;
     isNoise: boolean;
     isHidden: boolean;
@@ -3099,7 +2739,7 @@ declare class OutputModeResolver {
  * OpenACP Product Guide — comprehensive reference for the AI assistant.
  * The assistant reads this at runtime to answer user questions about features.
  */
-declare const PRODUCT_GUIDE = "\n# OpenACP \u2014 Product Guide\n\nOpenACP lets you chat with AI coding agents (like Claude Code) through messaging platforms (Telegram, Discord).\nYou type messages in your chat platform, the agent reads/writes/runs code in your project folder, and results stream back in real time.\n\n---\n\n## Quick Start\n\n1. Start OpenACP: `openacp` (or `openacp start` for background daemon)\n2. Open your messaging platform (Telegram group or Discord server) \u2014 you'll see the Assistant topic/thread\n3. Tap/click \uD83C\uDD95 New Session or type /new\n4. Pick an agent and a project folder\n5. Chat in the session topic/thread \u2014 the agent works on your code\n\n---\n\n## Core Concepts\n\n### Sessions\nA session = one conversation with one AI agent working in one project folder.\nEach session gets its own topic (Telegram) or forum thread (Discord). Chat there to give instructions to the agent.\n\n### Agents\nAn agent is an AI coding tool (e.g., Claude Code, Gemini, Cursor, Codex, etc.).\nOpenACP supports 28+ agents from the official ACP Registry (agentclientprotocol.com).\nYou can install multiple agents and choose which one to use per session.\nThe default agent is used when you don't specify one.\n\n### Agent Management\n- Browse agents: `/agents` in your chat platform or `openacp agents` in CLI\n- Install: tap the install button in /agents, or `openacp agents install <name>`\n- Uninstall: `openacp agents uninstall <name>`\n- Setup/login: `openacp agents run <name> -- <args>` (e.g., `openacp agents run gemini -- auth login`)\n- Details: `openacp agents info <name>` shows version, dependencies, and setup steps\n\nSome agents need additional setup before they can be used:\n- Claude: requires `claude login`\n- Gemini: requires `openacp agents run gemini -- auth login`\n- Codex: requires setting `OPENAI_API_KEY` environment variable\n- GitHub Copilot: requires `openacp agents run copilot -- auth login`\n\nAgents are installed in three ways depending on the agent:\n- **npx** \u2014 Node.js agents, downloaded automatically on first use\n- **uvx** \u2014 Python agents, downloaded automatically on first use\n- **binary** \u2014 Platform-specific binaries, downloaded to `~/.openacp/agents/`\n\n### Project Folder (Workspace)\nThe directory where the agent reads, writes, and runs code.\nWhen creating a session, you choose which folder the agent works in.\nYou can type a full path like `~/code/my-project` or just a name like `my-project` (it becomes `<base-dir>/my-project`).\n\n### System Topics\n- **Assistant** \u2014 Always-on helper that can answer questions, create sessions, check status, troubleshoot\n- **Notifications** \u2014 System alerts (permission requests, session errors, completions)\n\n---\n\n## Creating Sessions\n\n### From menu\nTap \uD83C\uDD95 New Session \u2192 choose agent (if multiple) \u2192 choose project folder \u2192 confirm\n\n### From command\n- `/new` \u2014 Interactive flow (asks agent + folder)\n- `/new claude ~/code/my-project` \u2014 Create directly with specific agent and folder\n\n### From Assistant topic\nJust ask: \"Create a session for my-project with claude\" \u2014 the assistant handles it\n\n### Quick new chat\n`/newchat` in a session topic \u2014 creates new session with same agent and folder as current one\n\n---\n\n## Working with Sessions\n\n### Chat\nType messages in the session topic. The agent responds with code changes, explanations, tool outputs.\n\n### What you see while the agent works\n- **\uD83D\uDCAD Thinking indicator** \u2014 Shows when the agent is reasoning, with elapsed time\n- **Text responses** \u2014 Streamed in real time, updated every few seconds\n- **Tool calls** \u2014 When the agent runs commands or edits files, you see tool name, input, status, and output\n- **\uD83D\uDCCB Plan card** \u2014 Visual task progress with completed/in-progress/pending items and progress bar\n- **\"View File\" / \"View Diff\" buttons** \u2014 Opens in browser with Monaco editor (requires tunnel)\n\n### Session lifecycle\n1. **Creating** \u2014 Topic created, agent spawning\n2. **Warming up** \u2014 Agent primes its cache (happens automatically, invisible to you)\n3. **Active** \u2014 Ready for your messages\n4. **Auto-naming** \u2014 After your first message, the session gets a descriptive name (agent summarizes in ~5 words). The topic title updates automatically.\n5. **Finished/Error** \u2014 Session completed or hit an error\n\n### Agent skills\nSome agents provide slash commands (e.g., /compact, /review). Available skills are pinned in the session topic.\n\n### Permission requests\nWhen the agent wants to run a command, it asks for permission.\nYou see buttons: \u2705 Allow, \u274C Reject (and sometimes \"Always Allow\").\nA notification also appears in the Notifications topic with a link to the request.\n\n### Bypass permissions\nAuto-approves ALL permission requests \u2014 the agent runs any command without asking.\n- Toggle: `/bypass_permissions on` or tap the \u2620\uFE0F button in the session\n- Disable: `/bypass_permissions off` or tap the \uD83D\uDD10 button\n- \u26A0\uFE0F Use with caution \u2014 the agent can execute anything\n\n### Session timeout\nIdle sessions are automatically cancelled after a configurable timeout (default: 60 minutes).\nConfigure via `security.sessionTimeoutMinutes` in config.\n\n---\n\n## Session Transfer (Handoff)\n\n### Chat \u2192 Terminal\n1. Type `/handoff` in a session topic/thread\n2. You get a command like `claude --resume <SESSION_ID>`\n3. Copy and run it in your terminal \u2014 the session continues there with full conversation history\n\n### Terminal \u2192 Chat\n1. First time: run `openacp integrate claude` to install the handoff skill (one-time setup)\n2. In Claude Code, use the /openacp:handoff slash command\n3. The session appears as a new topic/thread and you can continue chatting there\n\n### How it works\n- The agent session ID is shared between platforms\n- Conversation history is preserved \u2014 pick up where you left off\n- The agent that supports resume (e.g., Claude with `--resume`) handles the actual transfer\n\n---\n\n## Managing Sessions\n\n### Status\n- `/status` \u2014 Shows active sessions count and details\n- Ask the Assistant: \"What sessions are running?\"\n\n### List all sessions\n- `/sessions` \u2014 Shows all sessions with status (active, finished, error)\n\n### Cancel\n- `/cancel` in a session topic \u2014 cancels that session\n- Ask the Assistant: \"Cancel the stuck session\"\n\n### Cleanup\n- From `/sessions` \u2192 tap cleanup buttons (finished, errors, all)\n- Ask the Assistant: \"Clean up old sessions\"\n\n---\n\n## Assistant Topic\n\nThe Assistant is an always-on AI helper in its own topic. It can:\n- Answer questions about OpenACP\n- Create sessions for you\n- Check status and health\n- Cancel sessions\n- Clean up old sessions\n- Troubleshoot issues\n- Manage configuration\n\nJust chat naturally: \"How do I create a session?\", \"What's the status?\", \"Something is stuck\"\n\n### Clear history\n`/clear` in the Assistant topic \u2014 resets the conversation\n\n---\n\n## System Commands\n\n| Command | Where | What it does |\n|---------|-------|-------------|\n| `/new [agent] [path]` | Anywhere | Create new session |\n| `/newchat` | Session topic | New session, same agent + folder |\n| `/cancel` | Session topic | Cancel current session |\n| `/status` | Anywhere | Show status |\n| `/sessions` | Anywhere | List all sessions |\n| `/agents` | Anywhere | Browse & install agents from ACP Registry |\n| `/install <name>` | Anywhere | Install an agent |\n| `/bypass_permissions` | Session topic | Toggle bypass permissions (on/off) |\n| `/handoff` | Session topic | Transfer session to terminal |\n| `/clear` | Assistant topic | Clear assistant history |\n| `/menu` | Anywhere | Show action menu |\n| `/help` | Anywhere | Show help |\n| `/restart` | Anywhere | Restart OpenACP |\n| `/update` | Anywhere | Update to latest version |\n| `/integrate` | Anywhere | Manage agent integrations |\n\n---\n\n## Menu Buttons\n\n| Button | Action |\n|--------|--------|\n| \uD83C\uDD95 New Session | Create new session (interactive) |\n| \uD83D\uDCCB Sessions | List all sessions with cleanup options |\n| \uD83D\uDCCA Status | Show active/total session count |\n| \uD83E\uDD16 Agents | List available agents |\n| \uD83D\uDD17 Integrate | Manage agent integrations |\n| \u2753 Help | Show help text |\n| \uD83D\uDD04 Restart | Restart OpenACP |\n| \u2B06\uFE0F Update | Check and install updates |\n\n---\n\n## CLI Commands\n\n### Server\n- `openacp` \u2014 Start (uses configured mode: foreground or daemon)\n- `openacp start` \u2014 Start as background daemon\n- `openacp stop` \u2014 Stop daemon\n- `openacp status` \u2014 Show daemon status\n- `openacp logs` \u2014 Tail daemon logs\n- `openacp --foreground` \u2014 Force foreground mode (useful for debugging or containers)\n\n### Auto-start (run on boot)\n- macOS: installs a LaunchAgent in `~/Library/LaunchAgents/`\n- Linux: installs a systemd user service in `~/.config/systemd/user/`\n- Enabled automatically when you start the daemon. Remove with `openacp stop`.\n\n### Configuration\n- `openacp config` \u2014 Interactive config editor\n- `openacp reset` \u2014 Delete all data and start fresh\n\n### Agent Management (CLI)\n- `openacp agents` \u2014 List all agents (installed + available from ACP Registry)\n- `openacp agents install <name>` \u2014 Install an agent\n- `openacp agents uninstall <name>` \u2014 Remove an agent\n- `openacp agents info <name>` \u2014 Show details, dependencies, and setup guide\n- `openacp agents run <name> [-- args]` \u2014 Run agent CLI directly (for login, config, etc.)\n- `openacp agents refresh` \u2014 Force-refresh registry cache\n\n### Plugins\n- `openacp install <package>` \u2014 Install adapter plugin\n- `openacp uninstall <package>` \u2014 Remove adapter plugin\n- `openacp plugins` \u2014 List installed plugins\n\n### Integration\n- `openacp integrate <agent>` \u2014 Install agent integration (e.g., Claude handoff skill)\n- `openacp integrate <agent> --uninstall` \u2014 Remove integration\n\n### API (requires running daemon)\n`openacp api <command>` \u2014 Interact with running daemon:\n\n| Command | Description |\n|---------|-------------|\n| `status` | List active sessions |\n| `session <id>` | Session details |\n| `new <agent> <path>` | Create session |\n| `send <id> \"text\"` | Send prompt |\n| `cancel <id>` | Cancel session |\n| `bypass <id> on/off` | Toggle bypass permissions |\n| `topics [--status x,y]` | List topics |\n| `delete-topic <id> [--force]` | Delete topic |\n| `cleanup [--status x,y]` | Cleanup old topics |\n| `agents` | List agents |\n| `health` | System health |\n| `config` | Show config |\n| `config set <key> <value>` | Update config |\n| `adapters` | List adapters |\n| `tunnel` | Tunnel status |\n| `notify \"message\"` | Send notification |\n| `version` | Daemon version |\n| `restart` | Restart daemon |\n\n---\n\n## File Viewer (Tunnel)\n\nWhen tunnel is enabled, file edits and diffs get \"View\" buttons that open in your browser:\n- **Monaco Editor** \u2014 Full VS Code editor with syntax highlighting\n- **Diff viewer** \u2014 Side-by-side or inline comparison\n- **Line highlighting** \u2014 Click lines to highlight\n- Dark/light theme toggle\n\n### Setup\nEnable in config: set `tunnel.enabled` to `true`.\nProviders: Cloudflare (default, free), ngrok, bore, Tailscale Funnel.\n\n### Port Tunneling\n\nExpose any local port (dev servers, APIs, etc.) to the internet:\n\n**CLI commands** (agent can call these directly):\n- `openacp tunnel add <port> --label <name>` \u2014 Create tunnel to a local port\n- `openacp tunnel list` \u2014 List active tunnels\n- `openacp tunnel stop <port>` \u2014 Stop a tunnel\n- `openacp tunnel stop-all` \u2014 Stop all user tunnels\n\n**Telegram commands**:\n- `/tunnel <port> [label]` \u2014 Create tunnel\n- `/tunnels` \u2014 List active tunnels\n- `/tunnel stop <port>` \u2014 Stop tunnel\n\nExample: after starting a dev server on port 3000, run `openacp tunnel add 3000 --label my-app` to get a public URL.\n\n---\n\n## Configuration\n\nConfig file: `~/.openacp/config.json`\n\n### Channels\n- **channels.telegram.botToken** \u2014 Your Telegram bot token\n- **channels.telegram.chatId** \u2014 Your Telegram supergroup ID\n- **channels.discord.botToken** \u2014 Your Discord bot token\n- **channels.discord.guildId** \u2014 Your Discord server (guild) ID\n\n### Agents\n- **defaultAgent** \u2014 Which agent to use by default\n- Agents are managed via `/agents` (Telegram) or `openacp agents` (CLI)\n- Installed agents are stored in `~/.openacp/agents.json`\n- Agent list is fetched from the ACP Registry CDN and cached locally (24h)\n\n### Workspace\n- **workspace.baseDir** \u2014 Base directory for project folders (default: `~/openacp-workspace`)\n\n### Security\n- **security.allowedUserIds** \u2014 Restrict who can use the bot (empty = everyone)\n- **security.maxConcurrentSessions** \u2014 Max parallel sessions (default: 5)\n- **security.sessionTimeoutMinutes** \u2014 Auto-cancel idle sessions (default: 60)\n\n### Tunnel / File Viewer\n- **tunnel.enabled** \u2014 Enable file viewer tunnel\n- **tunnel.provider** \u2014 Tunnel provider: cloudflare (default, free), ngrok, bore, tailscale\n- **tunnel.port** \u2014 Local port for tunnel server (default: 3100)\n- **tunnel.auth.enabled** \u2014 Enable authentication for tunnel URLs\n- **tunnel.auth.token** \u2014 Auth token for tunnel access\n- **tunnel.storeTtlMinutes** \u2014 How long viewer links stay cached (default: 60)\n\n### Logging\n- **logging.level** \u2014 Log level: silent, debug, info, warn, error, fatal (default: info)\n- **logging.logDir** \u2014 Log directory (default: `~/.openacp/logs`)\n- **logging.maxFileSize** \u2014 Max log file size before rotation\n- **logging.maxFiles** \u2014 Max number of rotated log files\n- **logging.sessionLogRetentionDays** \u2014 Auto-delete old session logs (default: 30)\n\n### Data Retention\n- **sessionStore.ttlDays** \u2014 How long session records persist (default: 30). Old records are cleaned up automatically.\n\n### Environment variables\nOverride config with env vars:\n- `OPENACP_TELEGRAM_BOT_TOKEN`\n- `OPENACP_TELEGRAM_CHAT_ID`\n- `OPENACP_DISCORD_BOT_TOKEN`\n- `OPENACP_DISCORD_GUILD_ID`\n- `OPENACP_DEFAULT_AGENT`\n- `OPENACP_RUN_MODE` \u2014 foreground or daemon\n- `OPENACP_API_PORT` \u2014 API server port (default: 21420)\n- `OPENACP_TUNNEL_ENABLED`\n- `OPENACP_TUNNEL_PORT`\n- `OPENACP_TUNNEL_PROVIDER`\n- `OPENACP_LOG_LEVEL`\n- `OPENACP_LOG_DIR`\n- `OPENACP_DEBUG` \u2014 Sets log level to debug\n\n---\n\n## Troubleshooting\n\n### Session stuck / not responding\n- Check status: ask Assistant \"Is anything stuck?\"\n- Cancel and create new: `/cancel` then `/new`\n- Check system health: Assistant can run health check\n\n### Agent not found\n- Check available agents: `/agents` or `openacp agents`\n- Install missing agent: `openacp agents install <name>`\n- Some agents need login first: `openacp agents info <name>` to see setup steps\n- Run agent CLI for setup: `openacp agents run <name> -- <args>`\n\n### Permission request not showing\n- Check Notifications topic for the alert\n- Try `/bypass_permissions on` to auto-approve (if you trust the agent)\n\n### Session disappeared after restart\n- Sessions persist across restarts\n- Send a message in the old topic \u2014 it auto-resumes\n- If topic was deleted, the session record may still exist in status\n\n### Bot not responding at all\n- Check daemon: `openacp status`\n- Check logs: `openacp logs`\n- Restart: `openacp start` or `/restart`\n\n### Messages going to wrong topic\n- Each session is bound to a specific topic/thread\n- If you see messages appearing in the Assistant topic instead of the session topic, try creating a new session\n\n### Viewing logs\n- Session-specific logs: `~/.openacp/logs/sessions/`\n- System logs: `openacp logs` to tail live\n- Set `OPENACP_DEBUG=true` for verbose output\n\n---\n\n## Data & Storage\n\nAll data is stored in `~/.openacp/`:\n- `config.json` \u2014 Configuration\n- `agents.json` \u2014 Installed agents (managed by AgentCatalog)\n- `registry-cache.json` \u2014 Cached ACP Registry data (refreshes every 24h)\n- `agents/` \u2014 Downloaded binary agents\n- `sessions/` \u2014 Session records and state\n- `topics/` \u2014 Topic-to-session mappings\n- `logs/` \u2014 System and session logs\n- `plugins/` \u2014 Installed adapter plugins\n- `openacp.pid` \u2014 Daemon PID file\n\nSession records auto-cleanup: 30 days (configurable via `sessionStore.ttlDays`).\nSession logs auto-cleanup: 30 days (configurable via `logging.sessionLogRetentionDays`).\n";
+declare const PRODUCT_GUIDE = "\n# OpenACP \u2014 Product Guide\n\nOpenACP lets you chat with AI coding agents (like Claude Code) through messaging platforms (Telegram, Discord).\nYou type messages in your chat platform, the agent reads/writes/runs code in your project folder, and results stream back in real time.\n\n---\n\n## Quick Start\n\n1. Start OpenACP: `openacp` (or `openacp start` for background daemon)\n2. Open your messaging platform (Telegram group or Discord server) \u2014 you'll see the Assistant topic/thread\n3. Tap/click \uD83C\uDD95 New Session or type /new\n4. Pick an agent and a project folder\n5. Chat in the session topic/thread \u2014 the agent works on your code\n\n---\n\n## Core Concepts\n\n### Sessions\nA session = one conversation with one AI agent working in one project folder.\nEach session gets its own topic (Telegram) or forum thread (Discord). Chat there to give instructions to the agent.\n\n### Agents\nAn agent is an AI coding tool (e.g., Claude Code, Gemini, Cursor, Codex, etc.).\nOpenACP supports 28+ agents from the official ACP Registry (agentclientprotocol.com).\nYou can install multiple agents and choose which one to use per session.\nThe default agent is used when you don't specify one.\n\n### Agent Management\n- Browse agents: `/agents` in your chat platform or `openacp agents` in CLI\n- Install: tap the install button in /agents, or `openacp agents install <name>`\n- Uninstall: `openacp agents uninstall <name>`\n- Setup/login: `openacp agents run <name> -- <args>` (e.g., `openacp agents run gemini -- auth login`)\n- Details: `openacp agents info <name>` shows version, dependencies, and setup steps\n\nSome agents need additional setup before they can be used:\n- Claude: requires `claude login`\n- Gemini: requires `openacp agents run gemini -- auth login`\n- Codex: requires setting `OPENAI_API_KEY` environment variable\n- GitHub Copilot: requires `openacp agents run copilot -- auth login`\n\nAgents are installed in three ways depending on the agent:\n- **npx** \u2014 Node.js agents, downloaded automatically on first use\n- **uvx** \u2014 Python agents, downloaded automatically on first use\n- **binary** \u2014 Platform-specific binaries, downloaded to `~/.openacp/agents/`\n\n### Project Folder (Workspace)\nThe directory where the agent reads, writes, and runs code.\nWhen creating a session, you choose which folder the agent works in.\nYou can type a full path like `~/code/my-project` or just a name like `my-project` (it becomes `<base-dir>/my-project`).\n\n### System Topics\n- **Assistant** \u2014 Always-on helper that can answer questions, create sessions, check status, troubleshoot\n- **Notifications** \u2014 System alerts (permission requests, session errors, completions)\n\n---\n\n## Creating Sessions\n\n### From menu\nTap \uD83C\uDD95 New Session \u2192 choose agent (if multiple) \u2192 choose project folder \u2192 confirm\n\n### From command\n- `/new` \u2014 Interactive flow (asks agent + folder)\n- `/new claude ~/code/my-project` \u2014 Create directly with specific agent and folder\n\n### From Assistant topic\nJust ask: \"Create a session for my-project with claude\" \u2014 the assistant handles it\n\n### Quick new chat\n`/newchat` in a session topic \u2014 creates new session with same agent and folder as current one\n\n---\n\n## Working with Sessions\n\n### Chat\nType messages in the session topic. The agent responds with code changes, explanations, tool outputs.\n\n### What you see while the agent works\n- **\uD83D\uDCAD Thinking indicator** \u2014 Shows when the agent is reasoning, with elapsed time\n- **Text responses** \u2014 Streamed in real time, updated every few seconds\n- **Tool calls** \u2014 When the agent runs commands or edits files, you see tool name, input, status, and output\n- **\uD83D\uDCCB Plan card** \u2014 Visual task progress with completed/in-progress/pending items and progress bar\n- **\"View File\" / \"View Diff\" buttons** \u2014 Opens in browser with Monaco editor (requires tunnel)\n\n### Session lifecycle\n1. **Creating** \u2014 Topic created, agent spawning\n2. **Warming up** \u2014 Agent primes its cache (happens automatically, invisible to you)\n3. **Active** \u2014 Ready for your messages\n4. **Auto-naming** \u2014 After your first message, the session gets a descriptive name (agent summarizes in ~5 words). The topic title updates automatically.\n5. **Finished/Error** \u2014 Session completed or hit an error\n\n### Agent skills\nSome agents provide slash commands (e.g., /compact, /review). Available skills are pinned in the session topic.\n\n### Permission requests\nWhen the agent wants to run a command, it asks for permission.\nYou see buttons: \u2705 Allow, \u274C Reject (and sometimes \"Always Allow\").\nA notification also appears in the Notifications topic with a link to the request.\n\n### Bypass permissions\nAuto-approves ALL permission requests \u2014 the agent runs any command without asking.\n- Toggle: `/bypass_permissions on` or tap the \u2620\uFE0F button in the session\n- Disable: `/bypass_permissions off` or tap the \uD83D\uDD10 button\n- \u26A0\uFE0F Use with caution \u2014 the agent can execute anything\n\n### Session timeout\nIdle sessions are automatically cancelled after a configurable timeout (default: 60 minutes).\nConfigure via `security.sessionTimeoutMinutes` in config.\n\n---\n\n## Session Transfer (Handoff)\n\n### Chat \u2192 Terminal\n1. Type `/handoff` in a session topic/thread\n2. You get a command like `claude --resume <SESSION_ID>`\n3. Copy and run it in your terminal \u2014 the session continues there with full conversation history\n\n### Terminal \u2192 Chat\n1. First time: run `openacp integrate <agent>` to install handoff integration (one-time setup)\n2. In supported agents (for example Claude Code or OpenCode), use /openacp:handoff\n3. The session appears as a new topic/thread and you can continue chatting there\n\n### How it works\n- The agent session ID is shared between platforms\n- Conversation history is preserved \u2014 pick up where you left off\n- The agent that supports resume (e.g., Claude with `--resume`) handles the actual transfer\n\n---\n\n## Managing Sessions\n\n### Status\n- `/status` \u2014 Shows active sessions count and details\n- Ask the Assistant: \"What sessions are running?\"\n\n### List all sessions\n- `/sessions` \u2014 Shows all sessions with status (active, finished, error)\n\n### Cancel\n- `/cancel` in a session topic \u2014 cancels that session\n- Ask the Assistant: \"Cancel the stuck session\"\n\n### Cleanup\n- From `/sessions` \u2192 tap cleanup buttons (finished, errors, all)\n- Ask the Assistant: \"Clean up old sessions\"\n\n---\n\n## Assistant Topic\n\nThe Assistant is an always-on AI helper in its own topic. It can:\n- Answer questions about OpenACP\n- Create sessions for you\n- Check status and health\n- Cancel sessions\n- Clean up old sessions\n- Troubleshoot issues\n- Manage configuration\n\nJust chat naturally: \"How do I create a session?\", \"What's the status?\", \"Something is stuck\"\n\n### Clear history\n`/clear` in the Assistant topic \u2014 resets the conversation\n\n---\n\n## System Commands\n\n| Command | Where | What it does |\n|---------|-------|-------------|\n| `/new [agent] [path]` | Anywhere | Create new session |\n| `/newchat` | Session topic | New session, same agent + folder |\n| `/cancel` | Session topic | Cancel current session |\n| `/status` | Anywhere | Show status |\n| `/sessions` | Anywhere | List all sessions |\n| `/agents` | Anywhere | Browse & install agents from ACP Registry |\n| `/install <name>` | Anywhere | Install an agent |\n| `/bypass_permissions` | Session topic | Toggle bypass permissions (on/off) |\n| `/handoff` | Session topic | Transfer session to terminal |\n| `/clear` | Assistant topic | Clear assistant history |\n| `/menu` | Anywhere | Show action menu |\n| `/help` | Anywhere | Show help |\n| `/restart` | Anywhere | Restart OpenACP |\n| `/update` | Anywhere | Update to latest version |\n| `/integrate` | Anywhere | Manage agent integrations |\n\n---\n\n## Menu Buttons\n\n| Button | Action |\n|--------|--------|\n| \uD83C\uDD95 New Session | Create new session (interactive) |\n| \uD83D\uDCCB Sessions | List all sessions with cleanup options |\n| \uD83D\uDCCA Status | Show active/total session count |\n| \uD83E\uDD16 Agents | List available agents |\n| \uD83D\uDD17 Integrate | Manage agent integrations |\n| \u2753 Help | Show help text |\n| \uD83D\uDD04 Restart | Restart OpenACP |\n| \u2B06\uFE0F Update | Check and install updates |\n\n---\n\n## CLI Commands\n\n### Server\n- `openacp` \u2014 Start (uses configured mode: foreground or daemon)\n- `openacp start` \u2014 Start as background daemon\n- `openacp stop` \u2014 Stop daemon\n- `openacp status` \u2014 Show daemon status\n- `openacp logs` \u2014 Tail daemon logs\n- `openacp --foreground` \u2014 Force foreground mode (useful for debugging or containers)\n\n### Auto-start (run on boot)\n- macOS: installs a LaunchAgent in `~/Library/LaunchAgents/`\n- Linux: installs a systemd user service in `~/.config/systemd/user/`\n- Enabled automatically when you start the daemon. Remove with `openacp stop`.\n\n### Configuration\n- `openacp config` \u2014 Interactive config editor\n- `openacp reset` \u2014 Delete all data and start fresh\n\n### Agent Management (CLI)\n- `openacp agents` \u2014 List all agents (installed + available from ACP Registry)\n- `openacp agents install <name>` \u2014 Install an agent\n- `openacp agents uninstall <name>` \u2014 Remove an agent\n- `openacp agents info <name>` \u2014 Show details, dependencies, and setup guide\n- `openacp agents run <name> [-- args]` \u2014 Run agent CLI directly (for login, config, etc.)\n- `openacp agents refresh` \u2014 Force-refresh registry cache\n\n### Plugins\n- `openacp install <package>` \u2014 Install adapter plugin\n- `openacp uninstall <package>` \u2014 Remove adapter plugin\n- `openacp plugins` \u2014 List installed plugins\n\n### Integration\n- `openacp integrate <agent>` \u2014 Install agent integration (e.g., Claude handoff skill)\n- `openacp integrate <agent> --uninstall` \u2014 Remove integration\n\n### API (requires running daemon)\n`openacp api <command>` \u2014 Interact with running daemon:\n\n| Command | Description |\n|---------|-------------|\n| `status` | List active sessions |\n| `session <id>` | Session details |\n| `new <agent> <path>` | Create session |\n| `send <id> \"text\"` | Send prompt |\n| `cancel <id>` | Cancel session |\n| `bypass <id> on/off` | Toggle bypass permissions |\n| `topics [--status x,y]` | List topics |\n| `delete-topic <id> [--force]` | Delete topic |\n| `cleanup [--status x,y]` | Cleanup old topics |\n| `agents` | List agents |\n| `health` | System health |\n| `config` | Show config |\n| `config set <key> <value>` | Update config |\n| `adapters` | List adapters |\n| `tunnel` | Tunnel status |\n| `notify \"message\"` | Send notification |\n| `version` | Daemon version |\n| `restart` | Restart daemon |\n\n---\n\n## File Viewer (Tunnel)\n\nWhen tunnel is enabled, file edits and diffs get \"View\" buttons that open in your browser:\n- **Monaco Editor** \u2014 Full VS Code editor with syntax highlighting\n- **Diff viewer** \u2014 Side-by-side or inline comparison\n- **Line highlighting** \u2014 Click lines to highlight\n- Dark/light theme toggle\n\n### Setup\nEnable in config: set `tunnel.enabled` to `true`.\nProviders: Cloudflare (default, free), ngrok, bore, Tailscale Funnel.\n\n### Port Tunneling\n\nExpose any local port (dev servers, APIs, etc.) to the internet:\n\n**CLI commands** (agent can call these directly):\n- `openacp tunnel add <port> --label <name>` \u2014 Create tunnel to a local port\n- `openacp tunnel list` \u2014 List active tunnels\n- `openacp tunnel stop <port>` \u2014 Stop a tunnel\n- `openacp tunnel stop-all` \u2014 Stop all user tunnels\n\n**Telegram commands**:\n- `/tunnel <port> [label]` \u2014 Create tunnel\n- `/tunnels` \u2014 List active tunnels\n- `/tunnel stop <port>` \u2014 Stop tunnel\n\nExample: after starting a dev server on port 3000, run `openacp tunnel add 3000 --label my-app` to get a public URL.\n\n---\n\n## Configuration\n\nConfig file: `~/.openacp/config.json`\n\n### Channels\n- **channels.telegram.botToken** \u2014 Your Telegram bot token\n- **channels.telegram.chatId** \u2014 Your Telegram supergroup ID\n- **channels.discord.botToken** \u2014 Your Discord bot token\n- **channels.discord.guildId** \u2014 Your Discord server (guild) ID\n\n### Agents\n- **defaultAgent** \u2014 Which agent to use by default\n- Agents are managed via `/agents` (Telegram) or `openacp agents` (CLI)\n- Installed agents are stored in `~/.openacp/agents.json`\n- Agent list is fetched from the ACP Registry CDN and cached locally (24h)\n\n### Workspace\n- **workspace.baseDir** \u2014 Base directory for project folders (default: `~/openacp-workspace`)\n\n### Security\n- **security.allowedUserIds** \u2014 Restrict who can use the bot (empty = everyone)\n- **security.maxConcurrentSessions** \u2014 Max parallel sessions (default: 5)\n- **security.sessionTimeoutMinutes** \u2014 Auto-cancel idle sessions (default: 60)\n\n### Tunnel / File Viewer\n- **tunnel.enabled** \u2014 Enable file viewer tunnel\n- **tunnel.provider** \u2014 Tunnel provider: cloudflare (default, free), ngrok, bore, tailscale\n- **tunnel.port** \u2014 Local port for tunnel server (default: 3100)\n- **tunnel.auth.enabled** \u2014 Enable authentication for tunnel URLs\n- **tunnel.auth.token** \u2014 Auth token for tunnel access\n- **tunnel.storeTtlMinutes** \u2014 How long viewer links stay cached (default: 60)\n\n### Logging\n- **logging.level** \u2014 Log level: silent, debug, info, warn, error, fatal (default: info)\n- **logging.logDir** \u2014 Log directory (default: `~/.openacp/logs`)\n- **logging.maxFileSize** \u2014 Max log file size before rotation\n- **logging.maxFiles** \u2014 Max number of rotated log files\n- **logging.sessionLogRetentionDays** \u2014 Auto-delete old session logs (default: 30)\n\n### Data Retention\n- **sessionStore.ttlDays** \u2014 How long session records persist (default: 30). Old records are cleaned up automatically.\n\n### Environment variables\nOverride config with env vars:\n- `OPENACP_TELEGRAM_BOT_TOKEN`\n- `OPENACP_TELEGRAM_CHAT_ID`\n- `OPENACP_DISCORD_BOT_TOKEN`\n- `OPENACP_DISCORD_GUILD_ID`\n- `OPENACP_DEFAULT_AGENT`\n- `OPENACP_RUN_MODE` \u2014 foreground or daemon\n- `OPENACP_API_PORT` \u2014 API server port (default: 21420)\n- `OPENACP_TUNNEL_ENABLED`\n- `OPENACP_TUNNEL_PORT`\n- `OPENACP_TUNNEL_PROVIDER`\n- `OPENACP_LOG_LEVEL`\n- `OPENACP_LOG_DIR`\n- `OPENACP_DEBUG` \u2014 Sets log level to debug\n\n---\n\n## Troubleshooting\n\n### Session stuck / not responding\n- Check status: ask Assistant \"Is anything stuck?\"\n- Cancel and create new: `/cancel` then `/new`\n- Check system health: Assistant can run health check\n\n### Agent not found\n- Check available agents: `/agents` or `openacp agents`\n- Install missing agent: `openacp agents install <name>`\n- Some agents need login first: `openacp agents info <name>` to see setup steps\n- Run agent CLI for setup: `openacp agents run <name> -- <args>`\n\n### Permission request not showing\n- Check Notifications topic for the alert\n- Try `/bypass_permissions on` to auto-approve (if you trust the agent)\n\n### Session disappeared after restart\n- Sessions persist across restarts\n- Send a message in the old topic \u2014 it auto-resumes\n- If topic was deleted, the session record may still exist in status\n\n### Bot not responding at all\n- Check daemon: `openacp status`\n- Check logs: `openacp logs`\n- Restart: `openacp start` or `/restart`\n\n### Messages going to wrong topic\n- Each session is bound to a specific topic/thread\n- If you see messages appearing in the Assistant topic instead of the session topic, try creating a new session\n\n### Viewing logs\n- Session-specific logs: `~/.openacp/logs/sessions/`\n- System logs: `openacp logs` to tail live\n- Set `OPENACP_DEBUG=true` for verbose output\n\n---\n\n## Data & Storage\n\nAll data is stored in `~/.openacp/`:\n- `config.json` \u2014 Configuration\n- `agents.json` \u2014 Installed agents (managed by AgentCatalog)\n- `registry-cache.json` \u2014 Cached ACP Registry data (refreshes every 24h)\n- `agents/` \u2014 Downloaded binary agents\n- `sessions/` \u2014 Session records and state\n- `topics/` \u2014 Topic-to-session mappings\n- `logs/` \u2014 System and session logs\n- `plugins/` \u2014 Installed adapter plugins\n- `openacp.pid` \u2014 Daemon PID file\n\nSession records auto-cleanup: 30 days (configurable via `sessionStore.ttlDays`).\nSession logs auto-cleanup: 30 days (configurable via `logging.sessionLogRetentionDays`).\n";
 
 interface TelegramChannelConfig extends ChannelConfig {
     botToken: string;
@@ -3134,6 +2774,10 @@ declare class TelegramAdapter extends MessagingAdapter {
     private controlMsgIds;
     private _threadReadyHandler?;
     private _configChangedHandler?;
+    /** True once topics are initialized and Phase 2 is complete */
+    private _topicsInitialized;
+    /** Background watcher timer — cancelled on stop() or when topics succeed */
+    private _prerequisiteWatcher;
     /** Store control message ID in memory + persist to session record */
     private storeControlMsgId;
     /** Get control message ID (from Map, with fallback to session record) */
@@ -3155,6 +2799,8 @@ declare class TelegramAdapter extends MessagingAdapter {
      * Non-critical — bot works fine without autocomplete commands.
      */
     private registerCommandsWithRetry;
+    private initTopicDependentFeatures;
+    private startPrerequisiteWatcher;
     stop(): Promise<void>;
     private renderCommandResponse;
     private toCallbackData;
@@ -3204,4 +2850,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, 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 };
+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, type FieldDef, 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, 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 };