@openacp/cli 0.4.10 → 0.5.0

package/dist/doctor-N2HKKUUQ.js

@@ -0,0 +1,9 @@
+import {
+  DoctorEngine
+} from "./chunk-IRGYTNLP.js";
+import "./chunk-JRF4G4X7.js";
+import "./chunk-ESOPMQAY.js";
+export {
+  DoctorEngine
+};
+//# sourceMappingURL=doctor-N2HKKUUQ.js.map

package/dist/doctor-N2HKKUUQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import pino from 'pino';
 import { z } from 'zod';
+import { EventEmitter } from 'node:events';
 import { Readable, Writable } from 'node:stream';
 import { PromptResponse } from '@agentclientprotocol/sdk';
 
@@ -95,6 +96,82 @@ interface AgentDefinition {
     workingDirectory?: string;
     env?: Record<string, string>;
 }
+type AgentDistribution = "npx" | "uvx" | "binary" | "custom";
+interface InstalledAgent {
+    registryId: string | null;
+    name: string;
+    version: string;
+    distribution: AgentDistribution;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    workingDirectory?: string;
+    installedAt: string;
+    binaryPath: string | null;
+}
+interface RegistryBinaryTarget {
+    archive: string;
+    cmd: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+interface RegistryDistribution {
+    npx?: {
+        package: string;
+        args?: string[];
+        env?: Record<string, string>;
+    };
+    uvx?: {
+        package: string;
+        args?: string[];
+        env?: Record<string, string>;
+    };
+    binary?: Record<string, RegistryBinaryTarget>;
+}
+interface RegistryAgent {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    repository?: string;
+    website?: string;
+    authors?: string[];
+    license?: string;
+    icon?: string;
+    distribution: RegistryDistribution;
+}
+interface AgentListItem {
+    key: string;
+    registryId: string;
+    name: string;
+    version: string;
+    description?: string;
+    distribution: AgentDistribution;
+    installed: boolean;
+    available: boolean;
+    missingDeps?: string[];
+}
+interface AvailabilityResult {
+    available: boolean;
+    reason?: string;
+    missing?: Array<{
+        label: string;
+        installHint: string;
+    }>;
+}
+interface InstallProgress {
+    onStart(agentId: string, agentName: string): void | Promise<void>;
+    onStep(step: string): void | Promise<void>;
+    onDownloadProgress(percent: number): void | Promise<void>;
+    onSuccess(agentName: string): void | Promise<void>;
+    onError(error: string, hint?: string): void | Promise<void>;
+}
+interface InstallResult {
+    ok: boolean;
+    agentKey: string;
+    error?: string;
+    hint?: string;
+}
 type SessionStatus = "initializing" | "active" | "cancelled" | "finished" | "error";
 interface SessionRecord<P = Record<string, unknown>> {
     sessionId: string;
@@ -185,7 +262,7 @@ declare const ConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         adapter: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">>>;
-    agents: z.ZodRecord<z.ZodString, z.ZodObject<{
+    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>;
@@ -200,7 +277,7 @@ declare const ConfigSchema: z.ZodObject<{
         args?: string[] | undefined;
         workingDirectory?: string | undefined;
         env?: Record<string, string> | undefined;
-    }>>;
+    }>>>>;
     defaultAgent: z.ZodString;
     workspace: z.ZodDefault<z.ZodObject<{
         baseDir: z.ZodDefault<z.ZodString>;
@@ -312,6 +389,12 @@ declare const ConfigSchema: z.ZodObject<{
         port: number;
         host: string;
     };
+    agents: Record<string, {
+        command: string;
+        args: string[];
+        env: Record<string, string>;
+        workingDirectory?: string | undefined;
+    }>;
     tunnel: {
         options: Record<string, unknown>;
         enabled: boolean;
@@ -323,12 +406,6 @@ declare const ConfigSchema: z.ZodObject<{
             token?: string | undefined;
         };
     };
-    agents: Record<string, {
-        command: string;
-        args: string[];
-        env: Record<string, string>;
-        workingDirectory?: string | undefined;
-    }>;
     channels: Record<string, z.objectOutputType<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         adapter: z.ZodOptional<z.ZodString>;
@@ -359,12 +436,6 @@ declare const ConfigSchema: z.ZodObject<{
         installedAt?: string | undefined;
     }>;
 }, {
-    agents: Record<string, {
-        command: string;
-        args?: string[] | undefined;
-        workingDirectory?: string | undefined;
-        env?: Record<string, string> | undefined;
-    }>;
     channels: Record<string, z.objectInputType<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         adapter: z.ZodOptional<z.ZodString>;
@@ -374,6 +445,12 @@ declare const ConfigSchema: z.ZodObject<{
         port?: number | undefined;
         host?: string | undefined;
     } | undefined;
+    agents?: Record<string, {
+        command: string;
+        args?: string[] | undefined;
+        workingDirectory?: string | undefined;
+        env?: Record<string, string> | undefined;
+    }> | undefined;
     tunnel?: {
         options?: Record<string, unknown> | undefined;
         enabled?: boolean | undefined;
@@ -412,13 +489,13 @@ declare const ConfigSchema: z.ZodObject<{
 }>;
 type Config = z.infer<typeof ConfigSchema>;
 declare function expandHome(p: string): string;
-declare class ConfigManager {
+declare class ConfigManager extends EventEmitter {
     private config;
     private configPath;
     constructor();
     load(): Promise<void>;
     get(): Config;
-    save(updates: Record<string, unknown>): Promise<void>;
+    save(updates: Record<string, unknown>, changePath?: string): Promise<void>;
     resolveWorkspace(input?: string): string;
     exists(): Promise<boolean>;
     getConfigPath(): string;
@@ -437,6 +514,8 @@ declare const log: {
     child: (bindings: pino.Bindings) => pino.Logger<never, boolean>;
 };
 declare function initLogger(config: LoggingConfig): Logger;
+/** Change log level at runtime. Pino transport targets respect parent level changes automatically. */
+declare function setLogLevel(level: string): void;
 declare function createChildLogger(context: {
     module: string;
     [key: string]: unknown;
@@ -519,9 +598,48 @@ declare class AgentInstance {
     destroy(): Promise<void>;
 }
 
+declare class AgentStore {
+    private data;
+    private filePath;
+    constructor(filePath?: string);
+    load(): void;
+    exists(): boolean;
+    getInstalled(): Record<string, InstalledAgent>;
+    getAgent(key: string): InstalledAgent | undefined;
+    addAgent(key: string, agent: InstalledAgent): void;
+    removeAgent(key: string): void;
+    hasAgent(key: string): boolean;
+    private save;
+}
+
+declare class AgentCatalog {
+    private store;
+    private registryAgents;
+    constructor(store?: AgentStore);
+    load(): void;
+    fetchRegistry(): Promise<void>;
+    refreshRegistryIfStale(): Promise<void>;
+    getRegistryAgents(): RegistryAgent[];
+    getRegistryAgent(registryId: string): RegistryAgent | undefined;
+    findRegistryAgent(keyOrId: string): RegistryAgent | undefined;
+    getInstalled(): InstalledAgent[];
+    getInstalledEntries(): Record<string, InstalledAgent>;
+    getInstalledAgent(key: string): InstalledAgent | undefined;
+    getAvailable(): AgentListItem[];
+    checkAvailability(keyOrId: string): AvailabilityResult;
+    install(keyOrId: string, progress?: InstallProgress, force?: boolean): Promise<InstallResult>;
+    uninstall(key: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    resolve(key: string): AgentDefinition | undefined;
+    private isCacheStale;
+    private loadRegistryFromCacheOrSnapshot;
+}
+
 declare class AgentManager {
-    private config;
-    constructor(config: Config);
+    private catalog;
+    constructor(catalog: AgentCatalog);
     getAvailableAgents(): AgentDefinition[];
     getAgent(name: string): AgentDefinition | undefined;
     spawn(agentName: string, workingDirectory: string): Promise<AgentInstance>;
@@ -571,6 +689,9 @@ declare class PermissionGate {
     private resolveFn?;
     private rejectFn?;
     private settled;
+    private timeoutTimer?;
+    private timeoutMs;
+    constructor(timeoutMs?: number);
     setPending(request: PermissionRequest): Promise<string>;
     resolve(optionId: string): void;
     reject(reason?: string): void;
@@ -578,6 +699,7 @@ declare class PermissionGate {
     get currentRequest(): PermissionRequest | undefined;
     /** The request ID of the current pending request, undefined after settlement */
     get requestId(): string | undefined;
+    private clearTimeout;
     private cleanup;
 }
 
@@ -585,6 +707,8 @@ interface SessionEvents {
     agent_event: (event: AgentEvent) => void;
     permission_request: (request: PermissionRequest) => void;
     session_end: (reason: string) => void;
+    status_change: (from: SessionStatus, to: SessionStatus) => void;
+    named: (name: string) => void;
     error: (error: Error) => void;
 }
 declare class Session extends TypedEmitter<SessionEvents> {
@@ -595,10 +719,9 @@ declare class Session extends TypedEmitter<SessionEvents> {
     workingDirectory: string;
     agentInstance: AgentInstance;
     agentSessionId: string;
-    status: SessionStatus;
+    private _status;
     name?: string;
     createdAt: Date;
-    adapter?: ChannelAdapter;
     dangerousMode: boolean;
     log: Logger;
     readonly permissionGate: PermissionGate;
@@ -610,15 +733,16 @@ declare class Session extends TypedEmitter<SessionEvents> {
         workingDirectory: string;
         agentInstance: AgentInstance;
     });
-    /** @deprecated Use permissionGate directly */
-    get pendingPermission(): {
-        requestId: string;
-        resolve: (optionId: string) => void;
-    } | undefined;
-    set pendingPermission(val: {
-        requestId: string;
-        resolve: (optionId: string) => void;
-    } | undefined);
+    get status(): SessionStatus;
+    /** Transition to active — from initializing, error, or cancelled */
+    activate(): void;
+    /** Transition to error — from initializing or active */
+    fail(reason: string): void;
+    /** Transition to finished — from active only. Emits session_end for backward compat. */
+    finish(reason?: string): void;
+    /** Transition to cancelled — from active only (terminal session cancel) */
+    markCancelled(): void;
+    private transition;
     /** Number of prompts waiting in queue */
     get queueDepth(): number;
     get promptRunning(): boolean;
@@ -628,7 +752,8 @@ declare class Session extends TypedEmitter<SessionEvents> {
     /** Fire-and-forget warm-up: primes model cache while user types their first message */
     warmup(): Promise<void>;
     private runWarmup;
-    cancel(): Promise<void>;
+    /** Cancel the current prompt and clear the queue. Stays in active state. */
+    abortPrompt(): Promise<void>;
     destroy(): Promise<void>;
 }
 
@@ -721,11 +846,7 @@ declare class SessionManager {
     getRecordByAgentSessionId(agentSessionId: string): SessionRecord | undefined;
     getRecordByThread(channelId: string, threadId: string): SessionRecord | undefined;
     registerSession(session: Session): void;
-    updateSessionPlatform(sessionId: string, platform: Record<string, unknown>): Promise<void>;
-    updateSessionActivity(sessionId: string): Promise<void>;
-    updateSessionStatus(sessionId: string, status: SessionStatus): Promise<void>;
-    updateSessionDangerousMode(sessionId: string, dangerousMode: boolean): Promise<void>;
-    updateSessionName(sessionId: string, name: string): Promise<void>;
+    patchRecord(sessionId: string, patch: Partial<SessionRecord>): Promise<void>;
     getSessionRecord(sessionId: string): SessionRecord | undefined;
     cancelSession(sessionId: string): Promise<void>;
     listSessions(channelId?: string): Session[];
@@ -736,8 +857,31 @@ declare class SessionManager {
     destroyAll(): Promise<void>;
 }
 
+interface BridgeDeps {
+    messageTransformer: MessageTransformer;
+    notificationManager: NotificationManager;
+    sessionManager: SessionManager;
+}
+declare class SessionBridge {
+    private session;
+    private adapter;
+    private deps;
+    private connected;
+    private agentEventHandler?;
+    private statusChangeHandler?;
+    private namedHandler?;
+    constructor(session: Session, adapter: ChannelAdapter, deps: BridgeDeps);
+    connect(): void;
+    disconnect(): void;
+    private wireAgentToSession;
+    private wireSessionToAdapter;
+    private wirePermissions;
+    private wireLifecycle;
+}
+
 declare class OpenACPCore {
     configManager: ConfigManager;
+    agentCatalog: AgentCatalog;
     agentManager: AgentManager;
     sessionManager: SessionManager;
     notificationManager: NotificationManager;
@@ -755,6 +899,15 @@ declare class OpenACPCore {
     start(): Promise<void>;
     stop(): Promise<void>;
     handleMessage(message: IncomingMessage): Promise<void>;
+    createSession(params: {
+        channelId: string;
+        agentName: string;
+        workingDirectory: string;
+        resumeAgentSessionId?: string;
+        existingSessionId?: string;
+        createThread?: boolean;
+        initialName?: string;
+    }): Promise<Session>;
     handleNewSession(channelId: string, agentName?: string, workspacePath?: string): Promise<Session>;
     adoptSession(agentName: string, agentSessionId: string, cwd: string): Promise<{
         ok: true;
@@ -768,7 +921,8 @@ declare class OpenACPCore {
     }>;
     handleNewChat(channelId: string, currentThreadId: string): Promise<Session | null>;
     private lazyResume;
-    wireSessionEvents(session: Session, adapter: ChannelAdapter): void;
+    /** Create a SessionBridge for the given session and adapter */
+    createBridge(session: Session, adapter: ChannelAdapter): SessionBridge;
 }
 
 interface AdapterFactory {
@@ -807,7 +961,7 @@ declare function uninstallAutoStart(): {
 };
 declare function isAutoStartInstalled(): boolean;
 
-declare function runConfigEditor(configManager: ConfigManager): Promise<void>;
+declare function runConfigEditor(configManager: ConfigManager, mode?: 'file' | 'api', apiPort?: number): Promise<void>;
 
 interface TopicInfo {
     sessionId: string;
@@ -879,6 +1033,7 @@ declare class ApiServer {
     private handleToggleDangerous;
     private handleHealth;
     private handleVersion;
+    private handleGetEditableConfig;
     private handleGetConfig;
     private handleUpdateConfig;
     private handleListAdapters;
@@ -896,6 +1051,22 @@ declare class ApiServer {
     private readBody;
 }
 
+interface ConfigFieldDef {
+    path: string;
+    displayName: string;
+    group: string;
+    type: 'toggle' | 'select' | 'number' | 'string';
+    options?: string[] | ((config: Config) => string[]);
+    scope: 'safe' | 'sensitive';
+    hotReload: boolean;
+}
+declare const CONFIG_REGISTRY: ConfigFieldDef[];
+declare function getFieldDef(path: string): ConfigFieldDef | undefined;
+declare function getSafeFields(): ConfigFieldDef[];
+declare function isHotReloadable(path: string): boolean;
+declare function resolveOptions(def: ConfigFieldDef, config: Config): string[] | undefined;
+declare function getConfigValue(config: Config, path: string): unknown;
+
 interface TelegramChannelConfig {
     enabled: boolean;
     botToken: string;
@@ -907,16 +1078,15 @@ interface TelegramChannelConfig {
 declare class TelegramAdapter extends ChannelAdapter<OpenACPCore> {
     private bot;
     private telegramConfig;
-    private sessionDrafts;
-    private sessionTextBuffers;
-    private toolCallMessages;
     private permissionHandler;
     private assistantSession;
     private assistantInitializing;
     private notificationTopicId;
     private assistantTopicId;
-    private skillMessages;
     private sendQueue;
+    private toolTracker;
+    private draftManager;
+    private skillManager;
     private sessionTrackers;
     private getOrCreateTracker;
     constructor(core: OpenACPCore, config: TelegramChannelConfig);
@@ -931,7 +1101,6 @@ declare class TelegramAdapter extends ChannelAdapter<OpenACPCore> {
     deleteSessionThread(sessionId: string): Promise<void>;
     sendSkillCommands(sessionId: string, commands: AgentCommand[]): Promise<void>;
     cleanupSkillCommands(sessionId: string): Promise<void>;
-    private finalizeDraft;
 }
 
-export { type AdapterFactory, type AgentCommand, type AgentDefinition, type AgentEvent, AgentInstance, AgentManager, type ApiConfig, ApiServer, ChannelAdapter, type ChannelConfig, type CleanupResult, type Config, ConfigManager, type DeleteTopicResult, type IChannelAdapter, type IncomingMessage, type Logger, type LoggingConfig, MessageTransformer, NotificationManager, type NotificationMessage, OpenACPCore, type OutgoingMessage, PLUGINS_DIR, PermissionGate, type PermissionOption, type PermissionRequest, type PlanEntry, PromptQueue, Session, type SessionEvents, SessionManager, type SessionRecord, type SessionStatus, StderrCapture, TelegramAdapter, type TelegramPlatformData, type TopicInfo, TopicManager, TypedEmitter, cleanupOldSessionLogs, createChildLogger, createSessionLogger, expandHome, getPidPath, getStatus, initLogger, installAutoStart, installPlugin, isAutoStartInstalled, isAutoStartSupported, listPlugins, loadAdapterFactory, log, nodeToWebReadable, nodeToWebWritable, runConfigEditor, shutdownLogger, startDaemon, stopDaemon, uninstallAutoStart, uninstallPlugin };
+export { type AdapterFactory, AgentCatalog, type AgentCommand, type AgentDefinition, type AgentDistribution, type AgentEvent, AgentInstance, type AgentListItem, AgentManager, AgentStore, type ApiConfig, ApiServer, type AvailabilityResult, type BridgeDeps, CONFIG_REGISTRY, ChannelAdapter, type ChannelConfig, type CleanupResult, type Config, type ConfigFieldDef, ConfigManager, type DeleteTopicResult, type IChannelAdapter, type IncomingMessage, type InstallProgress, type InstallResult, type InstalledAgent, type Logger, type LoggingConfig, MessageTransformer, NotificationManager, type NotificationMessage, OpenACPCore, type OutgoingMessage, PLUGINS_DIR, PermissionGate, type PermissionOption, type PermissionRequest, type PlanEntry, PromptQueue, type RegistryAgent, type RegistryBinaryTarget, type RegistryDistribution, Session, SessionBridge, type SessionEvents, SessionManager, type SessionRecord, type SessionStatus, StderrCapture, TelegramAdapter, type TelegramPlatformData, type TopicInfo, TopicManager, TypedEmitter, cleanupOldSessionLogs, createChildLogger, createSessionLogger, expandHome, getConfigValue, getFieldDef, getPidPath, getSafeFields, getStatus, initLogger, installAutoStart, installPlugin, isAutoStartInstalled, isAutoStartSupported, isHotReloadable, listPlugins, loadAdapterFactory, log, nodeToWebReadable, nodeToWebWritable, resolveOptions, runConfigEditor, setLogLevel, shutdownLogger, startDaemon, stopDaemon, uninstallAutoStart, uninstallPlugin };

package/dist/index.js

@@ -9,6 +9,7 @@ import {
   PermissionGate,
   PromptQueue,
   Session,
+  SessionBridge,
   SessionManager,
   StderrCapture,
   TelegramAdapter,
@@ -16,47 +17,68 @@ import {
   TypedEmitter,
   nodeToWebReadable,
   nodeToWebWritable
-} from "./chunk-KPI4HGJC.js";
+} from "./chunk-FWN3UIRT.js";
+import "./chunk-NAMYZIS5.js";
+import "./chunk-UG6X672R.js";
+import {
+  AgentCatalog
+} from "./chunk-S3DRLJPM.js";
+import {
+  AgentStore
+} from "./chunk-5HGXUCMX.js";
 import {
   runConfigEditor
-} from "./chunk-6MJLVZXV.js";
-import "./chunk-UAUTLC4E.js";
-import "./chunk-VA2M52CM.js";
+} from "./chunk-LAFKARV3.js";
+import {
+  installAutoStart,
+  isAutoStartInstalled,
+  isAutoStartSupported,
+  uninstallAutoStart
+} from "./chunk-X6LLG7XN.js";
+import "./chunk-D73LCTPF.js";
+import "./chunk-XJJ7LPXP.js";
+import "./chunk-IRGYTNLP.js";
 import {
   installPlugin,
   listPlugins,
   loadAdapterFactory,
   uninstallPlugin
-} from "./chunk-HZD3CGPK.js";
+} from "./chunk-NDR5JCS7.js";
+import {
+  CONFIG_REGISTRY,
+  getConfigValue,
+  getFieldDef,
+  getSafeFields,
+  isHotReloadable,
+  resolveOptions
+} from "./chunk-Z46LGZ7R.js";
 import {
   getPidPath,
   getStatus,
   startDaemon,
   stopDaemon
-} from "./chunk-C6YIUTGR.js";
+} from "./chunk-VBEWSWVL.js";
 import {
   ConfigManager,
   PLUGINS_DIR,
   expandHome
-} from "./chunk-ZRFBLD3W.js";
-import {
-  installAutoStart,
-  isAutoStartInstalled,
-  isAutoStartSupported,
-  uninstallAutoStart
-} from "./chunk-MRKYJ422.js";
+} from "./chunk-JRF4G4X7.js";
 import {
   cleanupOldSessionLogs,
   createChildLogger,
   createSessionLogger,
   initLogger,
   log,
+  setLogLevel,
   shutdownLogger
-} from "./chunk-LYKCQTH5.js";
+} from "./chunk-ESOPMQAY.js";
 export {
+  AgentCatalog,
   AgentInstance,
   AgentManager,
+  AgentStore,
   ApiServer,
+  CONFIG_REGISTRY,
   ChannelAdapter,
   ConfigManager,
   MessageTransformer,
@@ -66,6 +88,7 @@ export {
   PermissionGate,
   PromptQueue,
   Session,
+  SessionBridge,
   SessionManager,
   StderrCapture,
   TelegramAdapter,
@@ -75,19 +98,25 @@ export {
   createChildLogger,
   createSessionLogger,
   expandHome,
+  getConfigValue,
+  getFieldDef,
   getPidPath,
+  getSafeFields,
   getStatus,
   initLogger,
   installAutoStart,
   installPlugin,
   isAutoStartInstalled,
   isAutoStartSupported,
+  isHotReloadable,
   listPlugins,
   loadAdapterFactory,
   log,
   nodeToWebReadable,
   nodeToWebWritable,
+  resolveOptions,
   runConfigEditor,
+  setLogLevel,
   shutdownLogger,
   startDaemon,
   stopDaemon,

package/dist/install-cloudflared-BTGUD7SW.js

@@ -0,0 +1,8 @@
+import {
+  ensureCloudflared
+} from "./chunk-RF3DUYFO.js";
+import "./chunk-ESOPMQAY.js";
+export {
+  ensureCloudflared
+};
+//# sourceMappingURL=install-cloudflared-BTGUD7SW.js.map

package/dist/install-cloudflared-BTGUD7SW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/log-SPS2S6FO.js

@@ -0,0 +1,19 @@
+import {
+  cleanupOldSessionLogs,
+  createChildLogger,
+  createSessionLogger,
+  initLogger,
+  log,
+  setLogLevel,
+  shutdownLogger
+} from "./chunk-ESOPMQAY.js";
+export {
+  cleanupOldSessionLogs,
+  createChildLogger,
+  createSessionLogger,
+  initLogger,
+  log,
+  setLogLevel,
+  shutdownLogger
+};
+//# sourceMappingURL=log-SPS2S6FO.js.map

package/dist/log-SPS2S6FO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}