boten-gemma 0.1.0

package/dist/channels/web.d.ts

@@ -0,0 +1,149 @@
+import type { Channel, IncomingMessage, ConfirmationResult, ToolCall, SendOptions } from './types.js';
+import type { GemmaConfig } from '../config/schema.js';
+import type { Session, SessionMetadata } from '../core/session.js';
+import type { WSMessage, WSCronAddMessage, WSCronUpdateMessage, WSSessionHistoryEntry, WSSessionSummary, WSLogEntry } from '../shared/ws-types.js';
+import type { CronEvent, CronJob } from '../automation/cron/types.js';
+import type { RegisteredPanel } from '../panels/registry.js';
+/**
+ * Web channel adapter.
+ * - HTTP server serving the built React app from dist/ui/
+ * - WebSocket server at /ws for real-time communication
+ * - Panel file serving at /panels/*
+ * - Telegram webhook at POST /webhook/telegram
+ */
+export declare class WebChannel implements Channel {
+    readonly name = "web";
+    private server;
+    private wss;
+    private clients;
+    private onMessageHandler;
+    private pendingConfirmations;
+    private config;
+    private panels;
+    private panelBridge;
+    private panelStorage;
+    private sdkPath;
+    private uiDir;
+    private telegramWebhookHandler;
+    private logSubscribers;
+    private availableModels;
+    /** Callback invoked when a client sets a model via WebSocket. */
+    onSetModel?: (channelId: string, model: string) => void;
+    /** Callback invoked when a client toggles thinking mode via WebSocket. */
+    onSetThinking?: (channelId: string, enabled: boolean) => void;
+    /** Cron management callbacks wired by gateway. */
+    onCronList?: () => Promise<CronJob[]>;
+    onCronAdd?: (data: WSCronAddMessage['job']) => Promise<CronJob>;
+    onCronUpdate?: (id: string, patch: WSCronUpdateMessage['patch']) => Promise<CronJob>;
+    onCronRemove?: (id: string) => Promise<void>;
+    onCronRun?: (id: string) => Promise<void>;
+    /** Session management callbacks wired by gateway. */
+    onSessionResolve?: (sessionId?: string) => Promise<Session>;
+    onSessionList?: () => Promise<SessionMetadata[]>;
+    onSessionNew?: () => Promise<Session>;
+    onSessionSwitch?: (sessionId: string) => Promise<Session | null>;
+    onSessionDelete?: (sessionId: string) => Promise<void>;
+    onSessionRename?: (sessionId: string, title: string) => Promise<void>;
+    onSessionHistory?: (sessionId: string) => Promise<WSSessionHistoryEntry[]>;
+    /** Config management callbacks wired by gateway. */
+    onConfigGet?: () => Promise<{
+        config: Record<string, unknown>;
+        mcpStatus: Record<string, {
+            connected: boolean;
+            toolCount: number;
+        }>;
+    }>;
+    onConfigUpdate?: (patch: Record<string, unknown>) => Promise<void>;
+    onConfigMCPAdd?: (name: string, server: {
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+        enabled?: boolean;
+    }) => Promise<void>;
+    onConfigMCPUpdate?: (name: string, patch: Record<string, unknown>) => Promise<void>;
+    onConfigMCPRemove?: (name: string) => Promise<void>;
+    /** Cowboy mode toggle callback wired by gateway. */
+    onCowboyModeSet?: (sessionId: string, enabled: boolean) => Promise<void>;
+    /** Callback invoked when a panel sends a chat message. */
+    onPanelChat?: (panelName: string, text: string) => void;
+    /** Callback invoked when a panel sends an RPC request. Wired by gateway to PanelServiceManager. */
+    onPanelRpc?: (panelName: string, method: string, params: unknown) => Promise<unknown>;
+    /** Callback to get log history when a client subscribes. */
+    onLogSubscribe?: () => WSLogEntry[];
+    /** Path to sessions directory, set by gateway for history building. */
+    sessionsDir?: string;
+    constructor(config: GemmaConfig);
+    /** Register panels for serving. Called by gateway during init. */
+    setPanels(panels: Map<string, RegisteredPanel>): void;
+    /** Register a telegram webhook handler. */
+    setTelegramWebhookHandler(handler: (body: unknown) => Promise<void>): void;
+    start(onMessage: (msg: IncomingMessage) => void): Promise<void>;
+    private handleHttp;
+    private handleTelegramWebhook;
+    private serveStaticFile;
+    private handleWsConnection;
+    private handleWsMessage;
+    /**
+     * Handle an incoming chat message. If no session is assigned yet,
+     * auto-create a new web session before routing the message.
+     */
+    private handleChat;
+    private handleSessionResume;
+    private handleSessionList;
+    private handleSessionNew;
+    private handleSessionSwitch;
+    private handleSessionDelete;
+    private handleSessionRename;
+    /**
+     * Build session history from JSONL transcript.
+     */
+    buildSessionHistory(sessionId: string): Promise<WSSessionHistoryEntry[]>;
+    /**
+     * Send a session event to the client that owns a given session.
+     * Used by the gateway to notify about title updates, etc.
+     */
+    sendSessionEvent(sessionId: string, event: 'created' | 'updated' | 'deleted' | 'switched', summary?: WSSessionSummary): void;
+    private sendWs;
+    /** Broadcast a message to all authenticated WebSocket clients. */
+    broadcast(msg: WSMessage): void;
+    /** Broadcast a cron event to all authenticated WebSocket clients. */
+    broadcastCronEvent(event: CronEvent, job?: CronJob): void;
+    /** Broadcast a panels:changed notification to all authenticated clients. */
+    broadcastPanelsChanged(): void;
+    /** Broadcast the full cron job list to all authenticated clients as a fallback sync. */
+    broadcastCronList(jobs: CronJob[]): void;
+    /** Send a message to a specific client by channel ID. */
+    private sendToClient;
+    send(channelId: string, text: string, _options?: SendOptions): Promise<string>;
+    /** Send a thinking/reasoning chunk to a specific client. */
+    sendThinking(channelId: string, content: string, messageId: string, done: boolean): void;
+    presentConfirmation(channelId: string, calls: ToolCall[], timeout: number): Promise<ConfirmationResult>;
+    private assessRisk;
+    sendStreaming(channelId: string, stream: AsyncGenerator<string>): Promise<void>;
+    private handlePanelRead;
+    private handlePanelWrite;
+    private handlePanelChatMsg;
+    private handlePanelRpc;
+    /** Broadcast a panel event to all authenticated clients. */
+    broadcastPanelEvent(panelName: string, event: string, payload?: unknown): void;
+    private handleCronList;
+    private handleCronAdd;
+    private handleCronUpdate;
+    private handleCronRemove;
+    private handleCronRun;
+    private handleConfigGet;
+    private handleConfigUpdate;
+    private handleConfigMCPAdd;
+    private handleConfigMCPUpdate;
+    private handleConfigMCPRemove;
+    /** Broadcast a config event to all authenticated WebSocket clients. */
+    broadcastConfigEvent(event: 'updated' | 'mcp:added' | 'mcp:updated' | 'mcp:removed' | 'mcp:reloaded', detail?: Record<string, unknown>): void;
+    private handleCowboyModeSet;
+    private handleLogSubscribe;
+    /** Find a connected client's channelId for a given session. */
+    getChannelIdForSession(sessionId: string): string | undefined;
+    /** Broadcast a log entry to all subscribed clients. */
+    broadcastLog(entry: WSLogEntry): void;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/channels/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/channels/web.ts"],"names":[],"mappings":"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"}