@openacp/cli 2026.327.5 → 2026.330.2

package/dist/index.d.ts

@@ -2,10 +2,35 @@ import pino from 'pino';
 import * as zod from 'zod';
 import { z, ZodSchema } from 'zod';
 import { EventEmitter } from 'node:events';
-import { Readable, Writable } from 'node:stream';
 import { SetSessionConfigOptionResponse, ListSessionsResponse, LoadSessionResponse, ForkSessionResponse, PromptResponse as PromptResponse$1 } from '@agentclientprotocol/sdk';
 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;
@@ -140,6 +165,8 @@ type AgentEvent = {
     title?: string;
     description?: string;
     size?: number;
+} | {
+    type: "tts_strip";
 };
 interface PlanEntry {
     content: string;
@@ -243,6 +270,7 @@ interface SessionRecord<P = Record<string, unknown>> {
     lastActiveAt: string;
     name?: string;
     dangerousMode?: boolean;
+    outputMode?: OutputMode;
     platform: P;
 }
 interface TelegramPlatformData {
@@ -510,147 +538,51 @@ declare const UsageSchema: z.ZodDefault<z.ZodObject<{
 }>>;
 type UsageConfig = z.infer<typeof UsageSchema>;
 declare const ConfigSchema: z.ZodObject<{
-    channels: z.ZodObject<{
-        slack: z.ZodOptional<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            adapter: z.ZodOptional<z.ZodLiteral<"slack">>;
-            botToken: z.ZodOptional<z.ZodString>;
-            appToken: z.ZodOptional<z.ZodString>;
-            signingSecret: z.ZodOptional<z.ZodString>;
-            notificationChannelId: z.ZodOptional<z.ZodString>;
-            allowedUserIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-            channelPrefix: z.ZodDefault<z.ZodString>;
-            autoCreateSession: z.ZodDefault<z.ZodBoolean>;
-            startupChannelId: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            enabled: boolean;
-            allowedUserIds: string[];
-            channelPrefix: string;
-            autoCreateSession: boolean;
-            adapter?: "slack" | undefined;
-            botToken?: string | undefined;
-            appToken?: string | undefined;
-            signingSecret?: string | undefined;
-            notificationChannelId?: string | undefined;
-            startupChannelId?: string | undefined;
-        }, {
-            enabled?: boolean | undefined;
-            adapter?: "slack" | undefined;
-            botToken?: string | undefined;
-            appToken?: string | undefined;
-            signingSecret?: string | undefined;
-            notificationChannelId?: string | undefined;
-            allowedUserIds?: string[] | undefined;
-            channelPrefix?: string | undefined;
-            autoCreateSession?: boolean | undefined;
-            startupChannelId?: string | undefined;
-        }>>;
-    }, "strip", z.ZodObject<{
+    channels: z.ZodObject<{}, "strip", z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         adapter: z.ZodOptional<z.ZodString>;
-        displayVerbosity: z.ZodOptional<z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
+        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.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
+        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.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
-    }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
-        slack: z.ZodOptional<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            adapter: z.ZodOptional<z.ZodLiteral<"slack">>;
-            botToken: z.ZodOptional<z.ZodString>;
-            appToken: z.ZodOptional<z.ZodString>;
-            signingSecret: z.ZodOptional<z.ZodString>;
-            notificationChannelId: z.ZodOptional<z.ZodString>;
-            allowedUserIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-            channelPrefix: z.ZodDefault<z.ZodString>;
-            autoCreateSession: z.ZodDefault<z.ZodBoolean>;
-            startupChannelId: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            enabled: boolean;
-            allowedUserIds: string[];
-            channelPrefix: string;
-            autoCreateSession: boolean;
-            adapter?: "slack" | undefined;
-            botToken?: string | undefined;
-            appToken?: string | undefined;
-            signingSecret?: string | undefined;
-            notificationChannelId?: string | undefined;
-            startupChannelId?: string | undefined;
-        }, {
-            enabled?: boolean | undefined;
-            adapter?: "slack" | undefined;
-            botToken?: string | undefined;
-            appToken?: string | undefined;
-            signingSecret?: string | undefined;
-            notificationChannelId?: string | undefined;
-            allowedUserIds?: string[] | undefined;
-            channelPrefix?: string | undefined;
-            autoCreateSession?: boolean | undefined;
-            startupChannelId?: string | undefined;
-        }>>;
-    }, z.ZodObject<{
+        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.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
+        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.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
+        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.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
-    }, z.ZodTypeAny, "passthrough">>, "strip">, z.objectInputType<{
-        slack: z.ZodOptional<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            adapter: z.ZodOptional<z.ZodLiteral<"slack">>;
-            botToken: z.ZodOptional<z.ZodString>;
-            appToken: z.ZodOptional<z.ZodString>;
-            signingSecret: z.ZodOptional<z.ZodString>;
-            notificationChannelId: z.ZodOptional<z.ZodString>;
-            allowedUserIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-            channelPrefix: z.ZodDefault<z.ZodString>;
-            autoCreateSession: z.ZodDefault<z.ZodBoolean>;
-            startupChannelId: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            enabled: boolean;
-            allowedUserIds: string[];
-            channelPrefix: string;
-            autoCreateSession: boolean;
-            adapter?: "slack" | undefined;
-            botToken?: string | undefined;
-            appToken?: string | undefined;
-            signingSecret?: string | undefined;
-            notificationChannelId?: string | undefined;
-            startupChannelId?: string | undefined;
-        }, {
-            enabled?: boolean | undefined;
-            adapter?: "slack" | undefined;
-            botToken?: string | undefined;
-            appToken?: string | undefined;
-            signingSecret?: string | undefined;
-            notificationChannelId?: string | undefined;
-            allowedUserIds?: string[] | undefined;
-            channelPrefix?: string | undefined;
-            autoCreateSession?: boolean | undefined;
-            startupChannelId?: string | undefined;
-        }>>;
-    }, z.ZodObject<{
+        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.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
+        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.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
+        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.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
+        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;
@@ -878,6 +810,7 @@ declare const ConfigSchema: z.ZodObject<{
             }, z.ZodTypeAny, "passthrough">> | undefined;
         } | undefined;
     }>>>;
+    outputMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
 }, "strip", z.ZodTypeAny, {
     api: {
         port: number;
@@ -901,24 +834,12 @@ declare const ConfigSchema: z.ZodObject<{
             token?: string | undefined;
         };
     };
-    channels: {
-        slack?: {
-            enabled: boolean;
-            allowedUserIds: string[];
-            channelPrefix: string;
-            autoCreateSession: boolean;
-            adapter?: "slack" | undefined;
-            botToken?: string | undefined;
-            appToken?: string | undefined;
-            signingSecret?: string | undefined;
-            notificationChannelId?: string | undefined;
-            startupChannelId?: string | undefined;
-        } | undefined;
-    } & {
+    channels: {} & {
         [k: string]: z.objectOutputType<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             adapter: z.ZodOptional<z.ZodString>;
-            displayVerbosity: z.ZodOptional<z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
+            displayVerbosity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+            outputMode: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
         }, z.ZodTypeAny, "passthrough">;
     };
     defaultAgent: string;
@@ -969,25 +890,14 @@ declare const ConfigSchema: z.ZodObject<{
             }, z.ZodTypeAny, "passthrough">>;
         };
     };
+    outputMode?: "low" | "medium" | "high" | undefined;
 }, {
-    channels: {
-        slack?: {
-            enabled?: boolean | undefined;
-            adapter?: "slack" | undefined;
-            botToken?: string | undefined;
-            appToken?: string | undefined;
-            signingSecret?: string | undefined;
-            notificationChannelId?: string | undefined;
-            allowedUserIds?: string[] | undefined;
-            channelPrefix?: string | undefined;
-            autoCreateSession?: boolean | undefined;
-            startupChannelId?: string | undefined;
-        } | undefined;
-    } & {
+    channels: {} & {
         [k: string]: z.objectInputType<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             adapter: z.ZodOptional<z.ZodString>;
-            displayVerbosity: z.ZodOptional<z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>>;
+            displayVerbosity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+            outputMode: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
         }, z.ZodTypeAny, "passthrough">;
     };
     defaultAgent: string;
@@ -1013,6 +923,7 @@ declare const ConfigSchema: z.ZodObject<{
             token?: string | undefined;
         } | undefined;
     } | undefined;
+    outputMode?: "low" | "medium" | "high" | undefined;
     workspace?: {
         baseDir?: string | undefined;
     } | undefined;
@@ -1121,7 +1032,8 @@ interface IChannelAdapter {
     createSessionThread(sessionId: string, name: string): Promise<string>;
     renameSessionThread(sessionId: string, newName: string): Promise<void>;
     deleteSessionThread?(sessionId: string): Promise<void>;
-    archiveSessionTopic?(sessionId: string): Promise<void>;
+    archiveSessionTopic?(sessionId: string): Promise<string>;
+    stripTTSBlock?(sessionId: string): Promise<void>;
     sendSkillCommands?(sessionId: string, commands: AgentCommand[]): Promise<void>;
     cleanupSkillCommands?(sessionId: string): Promise<void>;
 }
@@ -1146,11 +1058,11 @@ declare abstract class ChannelAdapter<TCore = unknown> implements IChannelAdapte
     deleteSessionThread(_sessionId: string): Promise<void>;
     sendSkillCommands(_sessionId: string, _commands: AgentCommand[]): Promise<void>;
     cleanupSkillCommands(_sessionId: string): Promise<void>;
-    archiveSessionTopic(_sessionId: string): Promise<void>;
+    archiveSessionTopic(_sessionId: string): Promise<string>;
 }
 
-declare function nodeToWebWritable(nodeStream: Writable): WritableStream<Uint8Array>;
-declare function nodeToWebReadable(nodeStream: Readable): ReadableStream<Uint8Array>;
+declare function nodeToWebWritable(nodeStream: NodeJS.WritableStream): WritableStream<Uint8Array>;
+declare function nodeToWebReadable(nodeStream: NodeJS.ReadableStream): ReadableStream<Uint8Array>;
 
 declare class StderrCapture {
     private maxLines;
@@ -1226,6 +1138,26 @@ declare class MiddlewareChain {
     setErrorTracker(tracker: ErrorTracker): void;
 }
 
+type TraceLayer = "acp" | "core" | "telegram";
+/**
+ * Per-session debug trace logger. Writes JSONL files to <workingDirectory>/.log/.
+ * Only active when OPENACP_DEBUG=true. Zero overhead when disabled.
+ *
+ * Note: Uses appendFileSync for simplicity. This blocks the event loop briefly per write,
+ * which is acceptable for a debug-only tool. The DEBUG_ENABLED guard ensures zero overhead
+ * in production.
+ */
+declare class DebugTracer {
+    private sessionId;
+    private workingDirectory;
+    private dirCreated;
+    private logDir;
+    constructor(sessionId: string, workingDirectory: string);
+    log(layer: TraceLayer, data: Record<string, unknown>): void;
+    /** No-op cleanup — establishes the pattern for future async implementations */
+    destroy(): void;
+}
+
 interface AgentInstanceEvents {
     agent_event: (event: AgentEvent) => void;
 }
@@ -1235,6 +1167,7 @@ declare class AgentInstance extends TypedEmitter<AgentInstanceEvents> {
     private stderrCapture;
     private terminalManager;
     private static mcpManager;
+    private _destroying;
     sessionId: string;
     agentName: string;
     promptCapabilities?: {
@@ -1242,6 +1175,7 @@ declare class AgentInstance extends TypedEmitter<AgentInstanceEvents> {
         audio?: boolean;
     };
     middlewareChain?: MiddlewareChain;
+    debugTracer: DebugTracer | null;
     onPermissionRequest: (request: PermissionRequest) => Promise<string>;
     private constructor();
     private static spawnSubprocess;
@@ -1394,12 +1328,13 @@ declare class SpeechService {
     setProviderFactory(factory: ProviderFactory): void;
     registerSTTProvider(name: string, provider: STTProvider$1): void;
     registerTTSProvider(name: string, provider: TTSProvider$1): void;
+    unregisterTTSProvider(name: string): void;
     isSTTAvailable(): boolean;
     isTTSAvailable(): boolean;
     transcribe(audioBuffer: Buffer, mimeType: string, options?: STTOptions): Promise<STTResult>;
     synthesize(text: string, options?: TTSOptions): Promise<TTSResult>;
     updateConfig(config: SpeechServiceConfig): void;
-    /** Re-create all providers from current config using the registered factory */
+    /** Re-create factory-managed providers from config. Preserves externally-registered providers (e.g. from plugins). */
     refreshProviders(newConfig: SpeechServiceConfig): void;
 }
 
@@ -1922,6 +1857,7 @@ interface ContextService {
 interface ViewerStoreInterface {
     storeFile(sessionId: string, filePath: string, content: string, workingDirectory: string): string | null;
     storeDiff(sessionId: string, filePath: string, oldContent: string, newContent: string, workingDirectory: string): string | null;
+    storeOutput(sessionId: string, label: string, output: string): string | null;
 }
 interface TunnelServiceInterface {
     getPublicUrl(): string;
@@ -1930,15 +1866,22 @@ interface TunnelServiceInterface {
     getStore(): ViewerStoreInterface;
     fileUrl(entryId: string): string;
     diffUrl(entryId: string): string;
+    outputUrl(entryId: string): string;
 }
 
 declare class MessageTransformer {
-    private tunnelService?;
-    constructor(tunnelService?: TunnelServiceInterface | undefined);
+    tunnelService?: TunnelServiceInterface;
+    /** Cache rawInput from tool_call so it's available in tool_update (which often lacks it) */
+    private toolRawInputCache;
+    /** Cache viewer links generated from intermediate updates so completion events carry them */
+    private toolViewerCache;
+    constructor(tunnelService?: TunnelServiceInterface);
     transform(event: AgentEvent, sessionContext?: {
         id: string;
         workingDirectory: string;
     }): OutgoingMessage;
+    /** Check if rawInput is a non-empty object (not null, not {}) */
+    private isNonEmptyInput;
     private enrichWithViewerLinks;
 }
 
@@ -2043,6 +1986,15 @@ declare class SessionManager {
         statuses?: string[];
     }): SessionRecord[];
     removeRecord(sessionId: string): Promise<void>;
+    /**
+     * Graceful shutdown: persist session state without killing agent subprocesses.
+     * Agent processes will exit naturally when the parent process terminates.
+     */
+    shutdownAll(): Promise<void>;
+    /**
+     * Forcefully destroy all sessions (kill agent subprocesses).
+     * Use only when sessions must be fully torn down (e.g. archive).
+     */
     destroyAll(): Promise<void>;
 }
 
@@ -2071,6 +2023,7 @@ declare class SessionBridge {
     private statusChangeHandler?;
     private namedHandler?;
     constructor(session: Session, adapter: IChannelAdapter, deps: BridgeDeps);
+    private get tracer();
     /** Send message to adapter, optionally running through message:outgoing middleware */
     private sendMessage;
     connect(): void;
@@ -2095,7 +2048,7 @@ interface TunnelEntry {
 
 interface ViewerEntry {
     id: string;
-    type: 'file' | 'diff';
+    type: 'file' | 'diff' | 'output';
     filePath?: string;
     content: string;
     oldContent?: string;
@@ -2112,6 +2065,7 @@ declare class ViewerStore {
     constructor(ttlMinutes?: number);
     storeFile(sessionId: string, filePath: string, content: string, workingDirectory: string): string | null;
     storeDiff(sessionId: string, filePath: string, oldContent: string, newContent: string, workingDirectory: string): string | null;
+    storeOutput(sessionId: string, label: string, output: string): string | null;
     get(id: string): ViewerEntry | undefined;
     private cleanup;
     private isPathAllowed;
@@ -2125,6 +2079,7 @@ declare class TunnelService {
     private server;
     private config;
     private systemPort;
+    private startError;
     constructor(config: TunnelConfig);
     start(): Promise<string>;
     stop(): Promise<void>;
@@ -2138,9 +2093,11 @@ declare class TunnelService {
     listTunnels(): TunnelEntry[];
     getTunnel(port: number): TunnelEntry | null;
     getPublicUrl(): string;
+    getStartError(): string | undefined;
     getStore(): ViewerStore;
     fileUrl(entryId: string): string;
     diffUrl(entryId: string): string;
+    outputUrl(entryId: string): string;
 }
 
 interface SessionCreateParams {
@@ -2271,6 +2228,7 @@ declare class LifecycleManager {
     private _failed;
     get loadedPlugins(): string[];
     get failedPlugins(): string[];
+    get registry(): PluginRegistry | undefined;
     constructor(opts?: LifecycleManagerOpts);
     private getPluginLogger;
     boot(plugins: OpenACPPlugin[]): Promise<void>;
@@ -2348,6 +2306,7 @@ declare class OpenACPCore {
     eventBus: EventBus;
     sessionFactory: SessionFactory;
     readonly lifecycleManager: LifecycleManager;
+    private getService;
     get securityGuard(): SecurityGuard;
     get notificationManager(): NotificationManager;
     get fileService(): FileServiceInterface;
@@ -2361,6 +2320,7 @@ declare class OpenACPCore {
     stop(): Promise<void>;
     archiveSession(sessionId: string): Promise<{
         ok: true;
+        newThreadId: string;
     } | {
         ok: false;
         error: string;
@@ -2374,6 +2334,7 @@ declare class OpenACPCore {
         existingSessionId?: string;
         createThread?: boolean;
         initialName?: string;
+        threadId?: string;
     }): Promise<Session>;
     handleNewSession(channelId: string, agentName?: string, workspacePath?: string, options?: {
         createThread?: boolean;
@@ -2421,7 +2382,7 @@ interface RegisteredCommand extends CommandDef {
  * - System commands always own the short name.
  * - Among plugins, the first to register wins the short name.
  * - Every plugin command also gets a qualified name: `scope:name`.
- * - Adapter plugins (@openacp/telegram, @openacp/discord, @openacp/slack)
+ * - Adapter plugins (@openacp/telegram, @openacp/discord)
  *   registering a command that already exists → stored as an override
  *   keyed by `channelId:commandName`, used when channelId matches.
  */
@@ -2439,7 +2400,7 @@ declare class CommandRegistry {
     register(def: CommandDef, pluginName?: string): void;
     /** Retrieve a command by name (short or qualified). */
     get(name: string): RegisteredCommand | undefined;
-    /** Remove a command by short name. Also removes its qualified name entry. */
+    /** Remove a command by name (short or qualified). Also removes its qualified name entry. */
     unregister(name: string): void;
     /** Remove all commands registered by a given plugin. */
     unregisterByPlugin(pluginName: string): void;
@@ -2546,6 +2507,11 @@ declare function isAutoStartInstalled(): boolean;
 declare class FileService {
     private baseDir;
     constructor(baseDir: string);
+    /**
+     * Remove session file directories older than maxAgeDays.
+     * Called on startup to prevent unbounded disk growth.
+     */
+    cleanupOldFiles(maxAgeDays: number): Promise<number>;
     saveFile(sessionId: string, fileName: string, data: Buffer, mimeType: string): Promise<Attachment>;
     resolveFile(filePath: string): Promise<Attachment | null>;
     /**
@@ -2679,30 +2645,6 @@ declare class EntireProvider implements ContextProvider {
     private buildTitle;
 }
 
-type DisplayVerbosity = "low" | "medium" | "high";
-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 RenderedMessage<TComponents = unknown> {
     body: string;
     format: "html" | "markdown" | "plain" | "structured";
@@ -2970,6 +2912,7 @@ declare class TelegramAdapter extends MessagingAdapter {
     private assistantTopicId;
     private sendQueue;
     private _sessionThreadIds;
+    private outputModeResolver;
     private draftManager;
     private skillManager;
     private fileService;
@@ -2985,12 +2928,22 @@ declare class TelegramAdapter extends MessagingAdapter {
     private toCallbackData;
     private fromCallbackData;
     private setupRoutes;
+    /**
+     * Per-session serial dispatch queues.
+     * SessionBridge fires sendMessage() as fire-and-forget, so multiple events
+     * (tool_call, tool_update, text) can arrive concurrently. Without serialization,
+     * fast handlers (tool_update) overtake slow ones (tool_call with draftManager.finalize),
+     * causing out-of-order processing where a tool's completion update is processed before
+     * its creation event. This queue ensures events are processed in the order they arrive.
+     */
+    private _dispatchQueues;
+    private getTracer;
     sendMessage(sessionId: string, content: OutgoingMessage): Promise<void>;
-    protected handleThought(sessionId: string, _content: OutgoingMessage, _verbosity: DisplayVerbosity): Promise<void>;
+    protected handleThought(sessionId: string, content: OutgoingMessage, _verbosity: DisplayVerbosity): Promise<void>;
     protected handleText(sessionId: string, content: OutgoingMessage): Promise<void>;
-    protected handleToolCall(sessionId: string, content: OutgoingMessage, verbosity: DisplayVerbosity): Promise<void>;
-    protected handleToolUpdate(sessionId: string, content: OutgoingMessage, verbosity: DisplayVerbosity): Promise<void>;
-    protected handlePlan(sessionId: string, content: OutgoingMessage, verbosity: DisplayVerbosity): Promise<void>;
+    protected handleToolCall(sessionId: string, content: OutgoingMessage, _verbosity: DisplayVerbosity): Promise<void>;
+    protected handleToolUpdate(sessionId: string, content: OutgoingMessage, _verbosity: DisplayVerbosity): Promise<void>;
+    protected handlePlan(sessionId: string, content: OutgoingMessage, _verbosity: DisplayVerbosity): Promise<void>;
     protected handleUsage(sessionId: string, content: OutgoingMessage, verbosity: DisplayVerbosity): Promise<void>;
     protected handleAttachment(sessionId: string, content: OutgoingMessage): Promise<void>;
     protected handleSessionEnd(sessionId: string, _content: OutgoingMessage): Promise<void>;
@@ -3006,7 +2959,8 @@ declare class TelegramAdapter extends MessagingAdapter {
     private downloadTelegramFile;
     private handleIncomingMedia;
     cleanupSkillCommands(sessionId: string): Promise<void>;
-    archiveSessionTopic(sessionId: string): Promise<void>;
+    stripTTSBlock(sessionId: string): Promise<void>;
+    archiveSessionTopic(sessionId: string): Promise<string>;
 }
 
 export { ActivityTracker, type AdapterCapabilities, type AgentCapabilities, AgentCatalog, type AgentCommand, type AgentDefinition, type AgentDistribution, type AgentEvent, AgentInstance, type AgentListItem, AgentManager, AgentStore, type ApiConfig, ApiServer, 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, 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, PLUGINS_DIR, 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, type ToolCallMeta, ToolCallTracker, type ToolUpdateMeta, type TopicInfo, TopicManager, type TunnelServiceInterface, TypedEmitter, type UsageConfig, type UsageRecord, type UsageRecordEvent, type UsageService, type ViewerLinks, cleanupOldSessionLogs, 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 };