agentgram 0.0.0-stage → 2.0.4

package/dist/index.d.ts

@@ -0,0 +1,762 @@
+import { EventEmitter } from 'node:events';
+import * as child_process from 'node:child_process';
+
+/**
+ * AgentGram Domain Types & Data Contracts
+ * Strict types for configuration, security, Telegram Bot API, and OpenCode events.
+ */
+type ExecutionMode = 'read' | 'build' | 'auto';
+type PermissionDecision = 'allow' | 'reject' | 'ask';
+interface AgentgramConfig {
+    botToken: string;
+    allowedChatId: string;
+    targetDir: string;
+    defaultAgent: string;
+    defaultModel: string;
+    favoriteModels: string[];
+    dailyLimit: number;
+    runTimeout: number;
+    language: 'en' | 'ar';
+    denyPatterns: string[];
+    allowedPaths: string[];
+    channel?: string;
+    engine?: string;
+    workspaces: string[];
+    extra: Record<string, unknown>;
+}
+type PromptCategory = 'role_hijack' | 'boundary_escape' | 'exfiltration' | 'obfuscation' | 'clean';
+interface PromptDetectionResult {
+    blocked: boolean;
+    reason: string;
+    confidence: number;
+    category?: PromptCategory;
+}
+interface QuarantineResult {
+    envelope: string;
+    block: string;
+    nonce: string;
+}
+interface PathCheckResult {
+    ok: boolean;
+    reason: string;
+}
+interface ServiceStatus {
+    installed: boolean;
+    running: boolean;
+    system: string;
+    path?: string | undefined;
+}
+interface InlineKeyboardButton {
+    text: string;
+    callback_data?: string | undefined;
+    url?: string | undefined;
+}
+interface InlineKeyboardMarkup {
+    inline_keyboard: InlineKeyboardButton[][];
+}
+interface TelegramUser {
+    id: number;
+    is_bot: boolean;
+    first_name: string;
+    last_name?: string;
+    username?: string;
+}
+interface TelegramChat {
+    id: number;
+    type: string;
+    title?: string;
+    username?: string;
+}
+interface TelegramPhotoSize {
+    file_id: string;
+    file_unique_id: string;
+    width: number;
+    height: number;
+    file_size?: number;
+}
+interface TelegramMessage {
+    message_id: number;
+    from?: TelegramUser;
+    chat: TelegramChat;
+    date: number;
+    text?: string;
+    caption?: string;
+    photo?: TelegramPhotoSize[];
+    reply_to_message?: TelegramMessage;
+}
+interface CallbackQuery {
+    id: string;
+    from: TelegramUser;
+    message?: TelegramMessage;
+    data?: string;
+}
+interface TelegramUpdate {
+    update_id: number;
+    message?: TelegramMessage;
+    callback_query?: CallbackQuery;
+}
+interface OpenCodeToolCall {
+    id: string;
+    tool: string;
+    call_id?: string;
+    status: 'running' | 'done' | 'error';
+    args?: Record<string, unknown>;
+    output?: string;
+    title?: string;
+}
+interface OpenCodeRun {
+    sessionId: string;
+    agent: string;
+    model: string;
+    mode: ExecutionMode;
+    startedAt: number;
+    userMsgId?: number | undefined;
+    userMessages: Set<string>;
+    text: Record<string, string>;
+    textOrder: string[];
+    msgOfPart: Record<string, number>;
+    tools: Record<string, OpenCodeToolCall>;
+    toolOrder: string[];
+    files: Set<string>;
+    cmds: number;
+    busy: boolean;
+    done: boolean;
+    error?: string | null | undefined;
+}
+interface OpenCodePermissionRequest {
+    id: string;
+    permission: string;
+    patterns?: string[];
+    metadata?: {
+        command?: string;
+        filepath?: string;
+        [key: string]: unknown;
+    };
+}
+interface OpenCodeQuestionOption {
+    label: string;
+    description?: string;
+}
+interface OpenCodeQuestionRequest {
+    id: string;
+    question: string;
+    header?: string;
+    options: OpenCodeQuestionOption[];
+    multiple?: boolean;
+    custom?: boolean;
+}
+
+declare class PromptInjectionGuard {
+    /**
+     * Count hidden zero-width and BiDi characters in text.
+     */
+    countHiddenChars(text: string): number;
+    /**
+     * Normalize Unicode (NFKC) and strip zero-width and BiDi override evasion characters.
+     */
+    sanitizeText(text: string): string;
+    /**
+     * Neutralize boundary and system delimiter tags so they cannot be escaped.
+     */
+    neutralizeDelimiters(text: string): string;
+    /**
+     * Check text for prompt injection, jailbreaks, and delimiter escapes.
+     */
+    detect(rawText: string): PromptDetectionResult;
+    /**
+     * Isolate untrusted reports, logs, and external texts inside a cryptographically signed quarantine block.
+     */
+    quarantine(text: string, limit?: number): QuarantineResult;
+}
+
+declare const DEFAULT_DENY_PATTERNS: RegExp[];
+declare class SecurityPolicy {
+    readonly targetDir: string;
+    readonly allowedPaths: string[];
+    readonly denyPatterns: RegExp[];
+    readonly promptGuard: PromptInjectionGuard;
+    constructor(targetDir: string, customPatterns?: string[], allowedPaths?: string[]);
+    /**
+     * Check if a command matches any forbidden patterns. Returns list of matched regex sources.
+     */
+    checkCommand(commandStr: string): string[];
+    /**
+     * Verify file operations remain within the project scope or allowed path boundaries.
+     */
+    checkFilePath(filePath: string): PathCheckResult;
+    checkPrompt(text: string): PromptDetectionResult;
+    sanitizePrompt(text: string): string;
+    quarantineUntrustedData(text: string, limit?: number): QuarantineResult;
+}
+
+declare const LEGACY_CONFIG_DIR: string;
+declare const AGENTGRAM_CONFIG_DIR: string;
+declare function getGlobalConfigDir(): string;
+declare function ensureConfigDirs(): void;
+declare function computeWorkspaceId(directory: string): string;
+declare class ConfigManager {
+    config: AgentgramConfig;
+    readonly workspaceId: string;
+    readonly globalConfigPath: string;
+    readonly projectConfigPath: string;
+    readonly legacyProjectConfigPath: string;
+    readonly stateDir: string;
+    readonly roomStatePath: string;
+    readonly gatePath: string;
+    readonly auditPath: string;
+    constructor(targetDir?: string, customConfigPath?: string);
+    load(): void;
+    merge(data: Record<string, unknown>): void;
+    saveGlobal(): void;
+    saveProject(): void;
+    addWorkspace(newWorkspace: string): boolean;
+    removeWorkspace(workspace: string): boolean;
+    validate(): string[];
+}
+
+/**
+ * AgentGram Pluggable Communication Channel Contract
+ * Hexagonal architecture port for messaging and interaction channels (Telegram, Console, Slack, Discord, Webhook, etc.)
+ * Pure Node.js with zero runtime dependencies.
+ */
+interface ChannelButton {
+    text: string;
+    callbackData?: string | undefined;
+    url?: string | undefined;
+}
+interface ChannelKeyboard {
+    rows: ChannelButton[][];
+}
+interface ChannelSendOptions {
+    replyMarkup?: ChannelKeyboard | undefined;
+    replyToMessageId?: string | number | undefined;
+    parseMode?: 'HTML' | 'Markdown' | 'None' | undefined;
+    disableWebPagePreview?: boolean | undefined;
+}
+interface ChannelMessageResult {
+    messageId: string | number;
+    chatId: string;
+    timestamp: number;
+}
+interface IncomingChannelMessage {
+    id: string | number;
+    senderId: string;
+    chatId: string;
+    text: string;
+    timestamp: number;
+    replyToMessageId?: string | number | undefined;
+    raw?: unknown;
+}
+interface IncomingChannelAction {
+    id: string;
+    senderId: string;
+    chatId: string;
+    actionData: string;
+    messageId?: string | number | undefined;
+    raw?: unknown;
+}
+interface ChannelUpdateHandler {
+    onMessage(msg: IncomingChannelMessage): Promise<void>;
+    onAction(action: IncomingChannelAction): Promise<void>;
+    onError?(err: Error): void;
+}
+interface IChannelAdapter {
+    readonly id: string;
+    readonly name: string;
+    /**
+     * Start listening for incoming user messages and interactive actions.
+     */
+    startListening(handler: ChannelUpdateHandler): Promise<void>;
+    /**
+     * Stop listening / close active polling or connection.
+     */
+    stopListening(): Promise<void> | void;
+    /**
+     * Send a message to the target recipient/channel.
+     */
+    sendMessage(recipientId: string, text: string, options?: ChannelSendOptions): Promise<ChannelMessageResult>;
+    /**
+     * Edit an existing message in-place.
+     */
+    editMessage(recipientId: string, messageId: string | number, text: string, options?: ChannelSendOptions): Promise<void>;
+    /**
+     * Acknowledge or answer an interactive action / callback.
+     */
+    answerAction(actionId: string, text?: string): Promise<void>;
+}
+
+interface SendMessageOptions {
+    replyMarkup?: InlineKeyboardMarkup | undefined;
+    replyToMessageId?: number | undefined;
+    disableWebPagePreview?: boolean | undefined;
+}
+declare function escapeHtml(text: string): string;
+declare class TelegramClient {
+    private readonly token;
+    private readonly agent;
+    private readonly baseUri;
+    constructor(token: string);
+    callApi<T = unknown>(method: string, payload?: Record<string, unknown>, retries?: number): Promise<T>;
+    private postJson;
+    sendMessage(chatId: string | number, text: string, options?: SendMessageOptions): Promise<TelegramMessage>;
+    editMessageText(chatId: string | number, messageId: number, text: string, options?: SendMessageOptions): Promise<TelegramMessage | boolean>;
+    answerCallbackQuery(callbackQueryId: string, text?: string, showAlert?: boolean): Promise<boolean>;
+    getUpdates(offset?: number, timeout?: number): Promise<TelegramUpdate[]>;
+    getMe(): Promise<{
+        id: number;
+        username?: string;
+        first_name: string;
+    }>;
+}
+
+/**
+ * Telegram Channel Adapter for AgentGram
+ * Production-ready default communication channel wrapping Telegram Bot API.
+ * Pure Node.js with zero runtime dependencies.
+ */
+
+declare function toTelegramMarkup(keyboard?: ChannelKeyboard): InlineKeyboardMarkup | undefined;
+declare function fromTelegramMarkup(markup?: InlineKeyboardMarkup): ChannelKeyboard | undefined;
+declare class TelegramChannelAdapter implements IChannelAdapter {
+    readonly id = "telegram";
+    readonly name = "Telegram Bot";
+    readonly client: TelegramClient;
+    private isListening;
+    private pollOffset;
+    constructor(clientOrToken: TelegramClient | string);
+    startListening(handler: ChannelUpdateHandler): Promise<void>;
+    stopListening(): void;
+    private processUpdate;
+    sendMessage(recipientId: string, text: string, options?: ChannelSendOptions): Promise<ChannelMessageResult>;
+    editMessage(recipientId: string, messageId: string | number, text: string, options?: ChannelSendOptions): Promise<void>;
+    answerAction(actionId: string, text?: string): Promise<void>;
+}
+
+declare class ConsoleChannelAdapter implements IChannelAdapter {
+    private readonly input;
+    private readonly output;
+    readonly id = "console";
+    readonly name = "Terminal Console";
+    private rl?;
+    private isListening;
+    private messageCounter;
+    private activeKeyboard;
+    constructor(input?: NodeJS.ReadableStream, output?: NodeJS.WritableStream);
+    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>;
+    answerAction(_actionId: string, text?: string): Promise<void>;
+    private renderKeyboard;
+}
+
+/**
+ * Pluggable Channel Adapter Registry
+ * Pure Node.js with zero runtime dependencies.
+ */
+
+type ChannelFactory = (config: AgentgramConfig) => IChannelAdapter;
+declare class ChannelRegistry {
+    private static factories;
+    static register(id: string, factory: ChannelFactory): void;
+    static get(id: string, config: AgentgramConfig): IChannelAdapter;
+    static has(id: string): boolean;
+    static list(): string[];
+}
+
+/**
+ * AgentGram Pluggable AI Coding Agent Engine Contract
+ * Hexagonal architecture port for AI coding engines & agent CLIs (OpenCode, Claude Code, Aider, Shell, etc.)
+ * Pure Node.js with zero runtime dependencies.
+ */
+
+interface AgentSession {
+    id: string;
+    workspaceDir: string;
+    title?: string | undefined;
+}
+interface AgentSessionOptions {
+    workspaceDir?: string | undefined;
+    title?: string | undefined;
+    agent?: string | undefined;
+    model?: string | undefined;
+}
+interface AgentEngineToolCall {
+    id: string;
+    tool: string;
+    status: 'running' | 'done' | 'error';
+    args?: Record<string, unknown>;
+    output?: string;
+    title?: string;
+}
+interface AgentEngineEvent {
+    type: string;
+    properties?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface IAgentEngine extends EventEmitter {
+    readonly id: string;
+    readonly name: string;
+    workspaceDir: string;
+    /**
+     * Connect to or start the underlying agent engine server / runtime.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect or stop the agent engine server / processes.
+     */
+    disconnect(): Promise<void> | void;
+    /**
+     * Create or initialize a conversation session.
+     */
+    createSession(options?: AgentSessionOptions): Promise<AgentSession>;
+    /**
+     * Submit a coding task / prompt to the engine.
+     */
+    submitPrompt(sessionId: string, prompt: string, agent?: string, model?: string): Promise<void>;
+    /**
+     * Abort or cancel an ongoing run.
+     */
+    abortSession(sessionId: string): Promise<void>;
+    /**
+     * Respond to an interactive tool execution permission request.
+     */
+    replyPermission(permissionId: string, decision: 'allow' | 'reject'): Promise<void>;
+    /**
+     * Get working directory git diff / changes.
+     */
+    getDiff(): Promise<string>;
+    /**
+     * 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>;
+interface OpenCodeEvent {
+    type: string;
+    properties?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+declare class OpenCodeClient extends EventEmitter {
+    readonly baseUrl: string;
+    private readonly password?;
+    readonly directory: string;
+    private serverProcess?;
+    private sseReq?;
+    private isConnected;
+    constructor(baseUrl: string, password?: string, directory?: string);
+    getHeaders(): Record<string, string>;
+    request<T = unknown>(method: string, endpoint: string, body?: Record<string, unknown>): Promise<T>;
+    /**
+     * Start consuming Server-Sent Events (SSE) from the OpenCode server.
+     */
+    connectEventStream(): void;
+    disconnectEventStream(): void;
+    submitPrompt(sessionId: string, prompt: string, agent?: string, model?: string): Promise<unknown>;
+    replyPermission(permissionId: string, decision: 'allow' | 'reject'): Promise<unknown>;
+    replyQuestion(questionId: string, answers: string[]): Promise<unknown>;
+    abortSession(sessionId: string): Promise<unknown>;
+    getDiff(): Promise<string>;
+    listAgents(): Promise<Array<{
+        name: string;
+        description?: string;
+    }>>;
+    listModels(): Promise<Array<{
+        id: string;
+        name?: string;
+    }>>;
+    listSessions(): Promise<Array<{
+        id: string;
+        title?: string;
+    }>>;
+    createSession(title?: string): Promise<{
+        id: string;
+        title?: string;
+    }>;
+    /**
+     * Spawns an OpenCode server process locally on loopback.
+     */
+    static spawnServer(targetDir: string, port?: number): Promise<{
+        client: OpenCodeClient;
+        proc: child_process.ChildProcess;
+        port: number;
+    }>;
+    killServer(): void;
+}
+
+/**
+ * OpenCode Engine Adapter for AgentGram
+ * Default production coding agent engine wrapping local loopback OpenCode server.
+ * Pure Node.js with zero runtime dependencies.
+ */
+
+declare class OpenCodeAdapter extends EventEmitter implements IAgentEngine {
+    readonly id = "opencode";
+    readonly name = "OpenCode Agent";
+    workspaceDir: string;
+    client: OpenCodeClient;
+    private readonly boundEventHandler;
+    constructor(clientOrUrl: OpenCodeClient | string, workspaceDir?: string);
+    connect(): Promise<void>;
+    disconnect(): void;
+    createSession(options?: AgentSessionOptions): Promise<AgentSession>;
+    submitPrompt(sessionId: string, prompt: string, agent?: string, model?: string): Promise<void>;
+    abortSession(sessionId: string): Promise<void>;
+    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 {
+    workspaceDir?: string;
+    cliCommand?: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+declare class ShellEngineAdapter extends EventEmitter implements IAgentEngine {
+    readonly id = "shell";
+    readonly name: string;
+    workspaceDir: string;
+    private readonly cliCommand;
+    private readonly defaultArgs;
+    private activeProcess?;
+    activeSessionId?: string | undefined;
+    constructor(options?: ShellEngineOptions);
+    connect(): Promise<void>;
+    disconnect(): void;
+    createSession(options?: AgentSessionOptions): Promise<AgentSession>;
+    submitPrompt(sessionId: string, prompt: string, _agent?: string, _model?: string): Promise<void>;
+    abortSession(_sessionId: string): Promise<void>;
+    replyPermission(_permissionId: string, _decision: 'allow' | 'reject'): Promise<void>;
+    getDiff(): Promise<string>;
+    setWorkspace(directory: string): void;
+}
+
+/**
+ * Pluggable AI Coding Agent Engine Registry
+ * Pure Node.js with zero runtime dependencies.
+ */
+
+type EngineFactory = (config: AgentgramConfig) => IAgentEngine;
+declare class EngineRegistry {
+    private static factories;
+    static register(id: string, factory: EngineFactory): void;
+    static get(id: string, config: AgentgramConfig): IAgentEngine;
+    static has(id: string): boolean;
+    static list(): string[];
+}
+
+declare const SYSTEM_HEADER: (targetDir: string) => string;
+declare function parseCallback(data: string): [string, string | null];
+declare function decidePermission(props: {
+    permission?: string;
+    metadata?: Record<string, unknown>;
+    patterns?: string[];
+}, mode?: ExecutionMode, policy?: SecurityPolicy): {
+    decision: 'ask' | 'allow' | 'reject';
+    reason?: string;
+};
+declare function permissionKeyboard(permId: string, lang?: 'en' | 'ar'): ChannelKeyboard & InlineKeyboardMarkup;
+interface ControlRoomOptions {
+    channel: IChannelAdapter;
+    engine: IAgentEngine;
+    configManager: ConfigManager;
+}
+declare class ControlRoom {
+    readonly channel: IChannelAdapter;
+    engine: IAgentEngine;
+    readonly cfgManager: ConfigManager;
+    policy: SecurityPolicy;
+    readonly allowedChatId: string;
+    targetDir: string;
+    currentMode: ExecutionMode;
+    currentAgent: string;
+    currentModel: string;
+    language: 'en' | 'ar';
+    private activeRun;
+    private alwaysAllowedPerms;
+    private missionCardMsgId;
+    private updateTimer;
+    private activeSkill;
+    isListening: boolean;
+    constructor(options: ControlRoomOptions);
+    constructor(tg: TelegramClient, oc: OpenCodeClient, cfgManager: ConfigManager);
+    get tg(): TelegramClient;
+    get oc(): OpenCodeClient;
+    set oc(client: OpenCodeClient);
+    private setupEngineEvents;
+    start(): Promise<void>;
+    stop(): void;
+    private handleUserMessage;
+    guardedSubmit(promptText: string, replyToMsgId?: string | number): Promise<void>;
+    private handleCallback;
+    private handleEngineEvent;
+    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>;
+    abortCurrentRun(): Promise<void>;
+}
+
+declare const MACOS_PLIST_NAME = "com.agentgram.plist";
+declare const LINUX_SERVICE_NAME = "agentgram.service";
+declare function getEntryPoint(): string;
+declare class ServiceManager {
+    static install(targetDir?: string): {
+        success: boolean;
+        message: string;
+    };
+    static uninstall(): {
+        success: boolean;
+        message: string;
+    };
+    static status(): ServiceStatus;
+}
+
+/**
+ * Type-Safe Internationalization (i18n) Module
+ * Supports English (default) and Arabic out of the box.
+ */
+declare const TRANSLATIONS: {
+    readonly en: {
+        readonly btn_stop: "⏹ Stop";
+        readonly btn_diff: "📤 Diff";
+        readonly btn_status: "📊 Status";
+        readonly btn_agents: "🧠 Agents";
+        readonly btn_models: "🤖 Models";
+        readonly btn_mode: "🔒 Mode";
+        readonly btn_sessions: "📂 Sessions";
+        readonly btn_new: "✨ New";
+        readonly btn_usage: "📈 Usage";
+        readonly btn_skills: "🧰 Skills";
+        readonly btn_workspaces: "📁 Projects";
+        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";
+        readonly perm_stop_session: "🛑 Stop Session";
+        readonly btn_done_submit: "✅ Done (Submit)";
+        readonly btn_cancel: "❌ Cancel";
+        readonly welcome: "⚡ <b>AgentGram Mission Control</b>\nWorkspace: <code>{target}</code>\nConnected to OpenCode. Send your prompt or tap a command below:";
+        readonly room_busy: "⚠️ <b>Agent is busy</b> — wait for it to finish or tap ⏹ Stop.";
+        readonly room_stopped: "🛑 Agent run stopped.";
+        readonly permission_prompt: "🔒 <b>Permission Required</b>\nTool: <code>{tool}</code>\nPattern: <code>{pattern}</code>\n{details}";
+        readonly permission_allowed_once: "✅ Allowed once: <code>{tool}</code>";
+        readonly permission_always_allowed: "♾️ Allowed always for this session: <code>{tool}</code>";
+        readonly permission_rejected: "⛔ Rejected: <code>{tool}</code>";
+        readonly prompt_injection_blocked: "🛡️ <b>Prompt Blocked by Security Shield</b>\nReason: <code>{reason}</code>\nConfidence: <b>{confidence}%</b>";
+        readonly policy_denied: "⛔ <b>Blocked by Security Policy</b>\nDeny rule matched: <code>{hits}</code>";
+        readonly select_agent: "🧠 <b>Select AI Agent</b> (Current: <b>{agent}</b>)";
+        readonly select_model: "🤖 <b>Select LLM Model</b> (Current: <b>{model}</b>)";
+        readonly select_mode: "🔒 <b>Execution Mode</b> (Current: <b>{mode}</b>)\nread: Refuses modifications · build: Interactive buttons · auto: Auto-approves safe commands.";
+        readonly select_workspace: "📁 <b>Projects & Workspaces</b> (Current: <b>{ws}</b>)\nSelect a project to switch or type <code>/cd &lt;path_or_name&gt;</code>:";
+        readonly ws_changed: "📁 Switched workspace to <b>{name}</b>!\nPath: <code>{ws}</code>\n🌿 Branch: <code>{branch}</code> · Modified: <code>{dirty}</code>";
+        readonly ws_not_found: "❌ Workspace path not found: <code>{path}</code>";
+        readonly ws_busy: "⚠️ A task is currently running in <code>{ws}</code>. Stop it with /stop before switching.";
+        readonly select_language: "🌐 <b>Select Language</b> (Current: <b>English</b>)";
+        readonly lang_changed: "🌐 Language switched to <b>English</b>.";
+        readonly help_title: "⚡ <b>AgentGram Commands & Shortcuts</b>";
+    };
+    readonly ar: {
+        readonly btn_stop: "⏹ إيقاف";
+        readonly btn_diff: "📤 الفروقات";
+        readonly btn_status: "📊 الحالة";
+        readonly btn_agents: "🧠 الوكلاء";
+        readonly btn_models: "🤖 الموديلات";
+        readonly btn_mode: "🔒 الوضع";
+        readonly btn_sessions: "📂 الجلسات";
+        readonly btn_new: "✨ جديد";
+        readonly btn_usage: "📈 الاستهلاك";
+        readonly btn_skills: "🧰 المهارات";
+        readonly btn_workspaces: "📁 المشاريع";
+        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: "⛔ رفض";
+        readonly perm_stop_session: "🛑 إنهاء الجلسة";
+        readonly btn_done_submit: "✅ تم (إرسال الإجابة)";
+        readonly btn_cancel: "❌ إلغاء";
+        readonly welcome: "⚡ <b>كابينة تحكم AgentGram</b>\nمساحة العمل: <code>{target}</code>\nمتصل بـ OpenCode. أرسل مهمتك أو اختر من القائمة:";
+        readonly room_busy: "⚠️ <b>الوكيل يعمل حالياً</b> — انتظر انتهاء المهمة أو اضغط ⏹ إيقاف.";
+        readonly room_stopped: "🛑 تم إيقاف عمل الوكيل.";
+        readonly permission_prompt: "🔒 <b>طلب إذن تشغيل</b>\nالأداة: <code>{tool}</code>\nالنمط: <code>{pattern}</code>\n{details}";
+        readonly permission_allowed_once: "✅ تم السماح لمرة واحدة: <code>{tool}</code>";
+        readonly permission_always_allowed: "♾️ تم السماح دائماً لهذه الجلسة: <code>{tool}</code>";
+        readonly permission_rejected: "⛔ تم الرفض: <code>{tool}</code>";
+        readonly prompt_injection_blocked: "🛡️ <b>تم حظر الرسالة بدرع الحماية</b>\nالسبب: <code>{reason}</code>\nمستوى الثقة: <b>{confidence}%</b>";
+        readonly policy_denied: "⛔ <b>مرفوض بسياسة الأمان</b>\nتطابق مع قاعدة الحظر: <code>{hits}</code>";
+        readonly select_agent: "🧠 <b>اختر الوكيل الذكي</b> (الحالي: <b>{agent}</b>)";
+        readonly select_model: "🤖 <b>اختر موديل الذكاء الاصطناعي</b> (الحالي: <b>{model}</b>)";
+        readonly select_mode: "🔒 <b>وضع التشغيل</b> (الحالي: <b>{mode}</b>)\nread: قراءة فقط · build: أزرار موافقة تفاعلية · auto: تشغيل تلقائي آمن.";
+        readonly select_workspace: "📁 <b>المشاريع ومساحات العمل</b> (الحالي: <b>{ws}</b>)\nاضغط للتبديل لأي مشروع فوراً أو اكتب <code>/cd &lt;مسار_أو_اسم&gt;</code>:";
+        readonly ws_changed: "📁 تم تغيير مساحة العمل إلى <b>{name}</b> بنجاح!\nالمسار: <code>{ws}</code>\n🌿 الفرع: <code>{branch}</code> · الملفات المعدلة: <code>{dirty}</code>";
+        readonly ws_not_found: "❌ مسار المشروع غير موجود: <code>{path}</code>";
+        readonly ws_busy: "⚠️ يوجد مهمة تعمل حالياً في <code>{ws}</code>. يرجى إيقافها أولاً بـ /stop قبل التبديل.";
+        readonly select_language: "🌐 <b>اختر اللغة / Select Language</b> (الحالية: <b>العربية</b>)";
+        readonly lang_changed: "🌐 تم تحويل لغة الواجهة إلى <b>العربية</b>.";
+        readonly help_title: "⚡ <b>أوامر وتحكم AgentGram</b>";
+    };
+};
+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.4";
+/**
+ * Main entry point for CLI execution.
+ */
+declare function runCli(argv?: string[]): Promise<void>;
+
+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 };