@foxden-app/foxclaw 0.7.2 → 0.10.0

package/dist/core/orchestrator.d.ts

@@ -0,0 +1,101 @@
+import type { AppConfig } from '../config.js';
+import type { BridgeStore } from '../store/database.js';
+import type { Logger } from '../logger.js';
+import type { AppLocale } from '../types.js';
+import type { TelegramGateway, TelegramTextEvent, TelegramCallbackEvent } from '../telegram/gateway.js';
+import type { TelegramMessagingPort, InlineKeyboard } from '../channels/telegram/telegram_messaging_port.js';
+import { TurnQueueManager } from './turn_queue.js';
+import type { IEngineAdapter, EngineTurnExecution, BackendDescriptor } from './engine_spi.js';
+export declare const STREAM_THROTTLE_MS = 700;
+export declare const TYPING_INTERVAL_MS = 4000;
+export interface UnifiedActiveTurn {
+    scopeId: string;
+    messageId: number;
+    threadId: string | null;
+    execution: EngineTurnExecution;
+    accumulatedText: string;
+    toolLines: string[];
+    flushTimer: NodeJS.Timeout | null;
+    lastFlushTime: number;
+    typingTimer: NodeJS.Timeout | null;
+    stepIndex?: number;
+    toolCount: number;
+    currentTool?: string | null;
+    startTime: number;
+}
+export interface EngineCustomUiHook {
+    renderCustomStatus?(scopeId: string, locale: AppLocale): Promise<string | null>;
+    renderCustomSetupRows?(scopeId: string, locale: AppLocale): Promise<InlineKeyboard>;
+    handleCustomCallback?(scopeId: string, data: string, locale: AppLocale, messageId?: number, event?: TelegramCallbackEvent): Promise<boolean>;
+    handleCustomCommand?(scopeId: string, command: string, args: string, locale: AppLocale, event?: TelegramTextEvent): Promise<boolean>;
+    handleCustomInbound?(event: TelegramTextEvent, locale: AppLocale): Promise<boolean>;
+}
+export declare class UnifiedChannelOrchestrator {
+    readonly config: AppConfig;
+    readonly store: BridgeStore;
+    readonly logger: Logger;
+    readonly bot: TelegramGateway;
+    readonly messaging: TelegramMessagingPort;
+    readonly queueManager: TurnQueueManager;
+    readonly customUi?: EngineCustomUiHook | undefined;
+    private readonly backends;
+    private readonly defaultBackendId;
+    private readonly activeTurns;
+    private readonly stalePanelDeleteTimers;
+    private readonly backendProvider?;
+    get adapter(): IEngineAdapter;
+    constructor(options: {
+        config: AppConfig;
+        store: BridgeStore;
+        logger: Logger;
+        bot: TelegramGateway;
+        adapter?: IEngineAdapter;
+        adapters?: Map<string, IEngineAdapter> | IEngineAdapter[];
+        backends?: BackendDescriptor[];
+        backendProvider?: (() => Promise<BackendDescriptor[]> | BackendDescriptor[]) | undefined;
+        defaultBackendId?: string;
+        messaging: TelegramMessagingPort;
+        customUi?: EngineCustomUiHook | undefined;
+    });
+    getAdapterForScope(scopeId: string): IEngineAdapter;
+    getBackendDescriptorForScope(scopeId: string): BackendDescriptor;
+    getAdapterForBackend(backendId: string): IEngineAdapter;
+    registerBackend(desc: BackendDescriptor): void;
+    listBackends(): Promise<BackendDescriptor[]>;
+    resolveBackendDescriptor(backendId: string): Promise<BackendDescriptor | null>;
+    syncCurrentBackendSettings(scopeId: string): void;
+    scheduleStalePanelDeletion(scopeId: string, messageId: number): void;
+    switchBackend(scopeId: string, targetBackendId: string, locale: AppLocale): Promise<{
+        previousBackendId: string;
+        newBackendId: string;
+        restoredThreadId: string | null;
+        cwd: string | null;
+    }>;
+    registerInboundHandlers(): void;
+    dispatchInboundLikeTelegramText(event: TelegramTextEvent): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getActiveTurnsCount(): number;
+    hasActiveTurn(scopeId: string): boolean;
+    sendMessage(scopeId: string, text: string, keyboard?: InlineKeyboard): Promise<number>;
+    editMessage(scopeId: string, messageId: number, text: string, keyboard?: InlineKeyboard): Promise<void>;
+    handleText(event: TelegramTextEvent): Promise<void>;
+    handleCallback(event: TelegramCallbackEvent): Promise<void>;
+    startPromptTurn(event: TelegramTextEvent, prompt: string, locale: AppLocale): Promise<void>;
+    private enqueuePromptTurn;
+    private drainNextQueuedTurn;
+    private executeTurn;
+    private handleEffortCommand;
+    private handleBoostCommand;
+    private handleActiveCommand;
+    private handleQueueCommand;
+    private handleSteerCommand;
+    handleInterrupt(scopeId: string, locale: AppLocale): Promise<void>;
+    handleNewSession(scopeId: string, locale: AppLocale, targetCwdInput?: string): Promise<void>;
+    sendStatus(scopeId: string, locale: AppLocale): Promise<void>;
+    sendSetupMenu(scopeId: string, locale: AppLocale, editMessageId?: number): Promise<void>;
+    sendModelsMenu(scopeId: string, locale: AppLocale, editMessageId?: number): Promise<void>;
+    sendHelp(scopeId: string, locale: AppLocale): Promise<void>;
+    sendBackendMenu(scopeId: string, locale: AppLocale, editMessageId?: number): Promise<void>;
+    handleBackendCommand(scopeId: string, argsString: string, locale: AppLocale): Promise<void>;
+}