agentgram 2.0.0 → 2.0.4

package/dist/index.d.ts

@@ -44,12 +44,12 @@ interface ServiceStatus {
     installed: boolean;
     running: boolean;
     system: string;
-    path?: string;
+    path?: string | undefined;
 }
 interface InlineKeyboardButton {
     text: string;
-    callback_data?: string;
-    url?: string;
+    callback_data?: string | undefined;
+    url?: string | undefined;
 }
 interface InlineKeyboardMarkup {
     inline_keyboard: InlineKeyboardButton[][];
@@ -110,7 +110,7 @@ interface OpenCodeRun {
     model: string;
     mode: ExecutionMode;
     startedAt: number;
-    userMsgId?: number;
+    userMsgId?: number | undefined;
     userMessages: Set<string>;
     text: Record<string, string>;
     textOrder: string[];
@@ -121,7 +121,7 @@ interface OpenCodeRun {
     cmds: number;
     busy: boolean;
     done: boolean;
-    error?: string | null;
+    error?: string | null | undefined;
 }
 interface OpenCodePermissionRequest {
     id: string;
@@ -210,6 +210,7 @@ declare class ConfigManager {
     saveGlobal(): void;
     saveProject(): void;
     addWorkspace(newWorkspace: string): boolean;
+    removeWorkspace(workspace: string): boolean;
     validate(): string[];
 }
 
@@ -220,17 +221,17 @@ declare class ConfigManager {
  */
 interface ChannelButton {
     text: string;
-    callbackData?: string;
-    url?: string;
+    callbackData?: string | undefined;
+    url?: string | undefined;
 }
 interface ChannelKeyboard {
     rows: ChannelButton[][];
 }
 interface ChannelSendOptions {
-    replyMarkup?: ChannelKeyboard;
-    replyToMessageId?: string | number;
-    parseMode?: 'HTML' | 'Markdown' | 'None';
-    disableWebPagePreview?: boolean;
+    replyMarkup?: ChannelKeyboard | undefined;
+    replyToMessageId?: string | number | undefined;
+    parseMode?: 'HTML' | 'Markdown' | 'None' | undefined;
+    disableWebPagePreview?: boolean | undefined;
 }
 interface ChannelMessageResult {
     messageId: string | number;
@@ -243,7 +244,7 @@ interface IncomingChannelMessage {
     chatId: string;
     text: string;
     timestamp: number;
-    replyToMessageId?: string | number;
+    replyToMessageId?: string | number | undefined;
     raw?: unknown;
 }
 interface IncomingChannelAction {
@@ -251,7 +252,7 @@ interface IncomingChannelAction {
     senderId: string;
     chatId: string;
     actionData: string;
-    messageId?: string | number;
+    messageId?: string | number | undefined;
     raw?: unknown;
 }
 interface ChannelUpdateHandler {
@@ -285,9 +286,9 @@ interface IChannelAdapter {
 }
 
 interface SendMessageOptions {
-    replyMarkup?: InlineKeyboardMarkup;
-    replyToMessageId?: number;
-    disableWebPagePreview?: boolean;
+    replyMarkup?: InlineKeyboardMarkup | undefined;
+    replyToMessageId?: number | undefined;
+    disableWebPagePreview?: boolean | undefined;
 }
 declare function escapeHtml(text: string): string;
 declare class TelegramClient {
@@ -344,7 +345,7 @@ declare class ConsoleChannelAdapter implements IChannelAdapter {
     startListening(handler: ChannelUpdateHandler): Promise<void>;
     stopListening(): void;
     sendMessage(recipientId: string, text: string, options?: ChannelSendOptions): Promise<ChannelMessageResult>;
-    editMessage(recipientId: string, messageId: string | number, text: string, options?: ChannelSendOptions): Promise<void>;
+    editMessage(_recipientId: string, messageId: string | number, text: string, options?: ChannelSendOptions): Promise<void>;
     answerAction(_actionId: string, text?: string): Promise<void>;
     private renderKeyboard;
 }
@@ -372,13 +373,13 @@ declare class ChannelRegistry {
 interface AgentSession {
     id: string;
     workspaceDir: string;
-    title?: string;
+    title?: string | undefined;
 }
 interface AgentSessionOptions {
-    workspaceDir?: string;
-    title?: string;
-    agent?: string;
-    model?: string;
+    workspaceDir?: string | undefined;
+    title?: string | undefined;
+    agent?: string | undefined;
+    model?: string | undefined;
 }
 interface AgentEngineToolCall {
     id: string;
@@ -429,6 +430,20 @@ interface IAgentEngine extends EventEmitter {
      * Switch the active working directory / workspace.
      */
     setWorkspace(directory: string): Promise<void> | void;
+    /**
+     * List available models from the engine.
+     */
+    listModels?(): Promise<Array<{
+        id: string;
+        name?: string;
+    }>>;
+    /**
+     * List available agents from the engine.
+     */
+    listAgents?(): Promise<Array<{
+        name: string;
+        description?: string;
+    }>>;
 }
 
 declare function getFreePort(): Promise<number>;
@@ -471,6 +486,7 @@ declare class OpenCodeClient extends EventEmitter {
     }>>;
     createSession(title?: string): Promise<{
         id: string;
+        title?: string;
     }>;
     /**
      * Spawns an OpenCode server process locally on loopback.
@@ -504,6 +520,14 @@ declare class OpenCodeAdapter extends EventEmitter implements IAgentEngine {
     replyPermission(permissionId: string, decision: 'allow' | 'reject'): Promise<void>;
     getDiff(): Promise<string>;
     setWorkspace(directory: string): void;
+    listModels(): Promise<Array<{
+        id: string;
+        name?: string;
+    }>>;
+    listAgents(): Promise<Array<{
+        name: string;
+        description?: string;
+    }>>;
 }
 
 interface ShellEngineOptions {
@@ -519,7 +543,7 @@ declare class ShellEngineAdapter extends EventEmitter implements IAgentEngine {
     private readonly cliCommand;
     private readonly defaultArgs;
     private activeProcess?;
-    private activeSessionId?;
+    activeSessionId?: string | undefined;
     constructor(options?: ShellEngineOptions);
     connect(): Promise<void>;
     disconnect(): void;
@@ -576,7 +600,8 @@ declare class ControlRoom {
     private alwaysAllowedPerms;
     private missionCardMsgId;
     private updateTimer;
-    private isListening;
+    private activeSkill;
+    isListening: boolean;
     constructor(options: ControlRoomOptions);
     constructor(tg: TelegramClient, oc: OpenCodeClient, cfgManager: ConfigManager);
     get tg(): TelegramClient;
@@ -592,8 +617,21 @@ declare class ControlRoom {
     private startMissionCardTicker;
     private renderMissionCardText;
     private updateMissionCard;
+    /**
+     * The complete, feature-rich 5-row interactive home keyboard with all 14 buttons.
+     */
     getMainKeyboard(): ChannelKeyboard & InlineKeyboardMarkup;
+    private wrapKeyboard;
+    private sendAgentsMenu;
+    sendModelsMenu(page?: number): Promise<void>;
     private sendModeMenu;
+    private sendSessionsMenu;
+    private sendStatusReport;
+    private getAllAvailableSkills;
+    sendSkillsMenu(page?: number): Promise<void>;
+    private sendUsageReport;
+    private sendLanguageMenu;
+    private sendHandoffReport;
     private sendWorkspaceMenu;
     switchWorkspace(newPath: string): Promise<void>;
     sendDiff(): Promise<void>;
@@ -635,6 +673,10 @@ declare const TRANSLATIONS: {
         readonly btn_handoff: "🔁 Handoff";
         readonly btn_help: "❓ Help";
         readonly btn_language: "🌐 Language";
+        readonly btn_back: "⬅️ Back";
+        readonly btn_all_models: "➡️ All Models";
+        readonly btn_favorites: "⭐ Favorites";
+        readonly btn_next: "➡️ Next";
         readonly perm_allow_once: "✅ Allow Once";
         readonly perm_always_allow: "♾️ Always Allow";
         readonly perm_reject: "⛔ Reject";
@@ -676,6 +718,10 @@ declare const TRANSLATIONS: {
         readonly btn_handoff: "🔁 تسليم";
         readonly btn_help: "❓ مساعدة";
         readonly btn_language: "🌐 اللغة";
+        readonly btn_back: "⬅️ رجوع";
+        readonly btn_all_models: "➡️ المزيد";
+        readonly btn_favorites: "⭐ المفضلة";
+        readonly btn_next: "➡️ التالي";
         readonly perm_allow_once: "✅ مرة واحدة";
         readonly perm_always_allow: "♾️ سماح دائماً";
         readonly perm_reject: "⛔ رفض";
@@ -707,11 +753,10 @@ type Language = 'en' | 'ar';
 type TranslationKey = keyof typeof TRANSLATIONS.en;
 declare function t(key: TranslationKey, lang?: Language, params?: Record<string, string | number>): string;
 
-declare const VERSION = "2.0.0";
+declare const VERSION = "2.0.4";
 /**
  * Main entry point for CLI execution.
  */
 declare function runCli(argv?: string[]): Promise<void>;
 
-export { AGENTGRAM_CONFIG_DIR, ChannelRegistry, ConfigManager, ConsoleChannelAdapter, ControlRoom, DEFAULT_DENY_PATTERNS, EngineRegistry, LEGACY_CONFIG_DIR, LINUX_SERVICE_NAME, MACOS_PLIST_NAME, OpenCodeAdapter, OpenCodeClient, PromptInjectionGuard, SYSTEM_HEADER, SecurityPolicy, ServiceManager, ShellEngineAdapter, TRANSLATIONS, TelegramChannelAdapter, TelegramClient, VERSION, computeWorkspaceId, decidePermission, ensureConfigDirs, escapeHtml, fromTelegramMarkup, getEntryPoint, getFreePort, getGlobalConfigDir, parseCallback, permissionKeyboard, runCli, t, toTelegramMarkup, TRANSLATIONS as translations };
-export type { AgentEngineEvent, AgentEngineToolCall, AgentSession, AgentSessionOptions, AgentgramConfig, CallbackQuery, ChannelButton, ChannelFactory, ChannelKeyboard, ChannelMessageResult, ChannelSendOptions, ChannelUpdateHandler, EngineFactory, ExecutionMode, IAgentEngine, IChannelAdapter, IncomingChannelAction, IncomingChannelMessage, InlineKeyboardButton, InlineKeyboardMarkup, Language, OpenCodeEvent, OpenCodePermissionRequest, OpenCodeQuestionOption, OpenCodeQuestionRequest, OpenCodeRun, OpenCodeToolCall, PathCheckResult, PermissionDecision, PromptCategory, PromptDetectionResult, QuarantineResult, ServiceStatus, ShellEngineOptions, TelegramChat, TelegramMessage, TelegramPhotoSize, TelegramUpdate, TelegramUser, TranslationKey };
+export { AGENTGRAM_CONFIG_DIR, type AgentEngineEvent, type AgentEngineToolCall, type AgentSession, type AgentSessionOptions, type AgentgramConfig, type CallbackQuery, type ChannelButton, type ChannelFactory, type ChannelKeyboard, type ChannelMessageResult, ChannelRegistry, type ChannelSendOptions, type ChannelUpdateHandler, ConfigManager, ConsoleChannelAdapter, ControlRoom, DEFAULT_DENY_PATTERNS, type EngineFactory, EngineRegistry, type ExecutionMode, type IAgentEngine, type IChannelAdapter, type IncomingChannelAction, type IncomingChannelMessage, type InlineKeyboardButton, type InlineKeyboardMarkup, LEGACY_CONFIG_DIR, LINUX_SERVICE_NAME, type Language, MACOS_PLIST_NAME, OpenCodeAdapter, OpenCodeClient, type OpenCodeEvent, type OpenCodePermissionRequest, type OpenCodeQuestionOption, type OpenCodeQuestionRequest, type OpenCodeRun, type OpenCodeToolCall, type PathCheckResult, type PermissionDecision, type PromptCategory, type PromptDetectionResult, PromptInjectionGuard, type QuarantineResult, SYSTEM_HEADER, SecurityPolicy, ServiceManager, type ServiceStatus, ShellEngineAdapter, type ShellEngineOptions, TRANSLATIONS, TelegramChannelAdapter, type TelegramChat, TelegramClient, type TelegramMessage, type TelegramPhotoSize, type TelegramUpdate, type TelegramUser, type TranslationKey, VERSION, computeWorkspaceId, decidePermission, ensureConfigDirs, escapeHtml, fromTelegramMarkup, getEntryPoint, getFreePort, getGlobalConfigDir, parseCallback, permissionKeyboard, runCli, t, toTelegramMarkup, TRANSLATIONS as translations };