@fonz/tgcc 0.0.1 → 0.3.0

package/dist/mcp-bridge.js

@@ -0,0 +1,182 @@
+import { createServer, createConnection } from 'node:net';
+import { existsSync, unlinkSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { EventEmitter } from 'node:events';
+// ── Bridge-side Unix socket server ──
+export class McpBridgeServer extends EventEmitter {
+    servers = new Map();
+    handler;
+    logger;
+    constructor(handler, logger) {
+        super();
+        this.handler = handler;
+        this.logger = logger;
+    }
+    /** Start listening on a socket path for a specific agent-user pair */
+    listen(socketPath) {
+        // Clean up stale socket
+        if (existsSync(socketPath)) {
+            unlinkSync(socketPath);
+        }
+        const dir = dirname(socketPath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const server = createServer((socket) => this.handleConnection(socket, socketPath));
+        server.on('error', (err) => {
+            this.logger.error({ err, socketPath }, 'MCP bridge socket error');
+        });
+        server.listen(socketPath, () => {
+            this.logger.info({ socketPath }, 'MCP bridge listening');
+        });
+        this.servers.set(socketPath, server);
+    }
+    handleConnection(socket, socketPath) {
+        this.logger.debug({ socketPath }, 'MCP server connected');
+        let buffer = '';
+        socket.on('data', (data) => {
+            buffer += data.toString();
+            // Process complete lines
+            let newlineIdx;
+            while ((newlineIdx = buffer.indexOf('\n')) !== -1) {
+                const line = buffer.slice(0, newlineIdx);
+                buffer = buffer.slice(newlineIdx + 1);
+                this.processLine(line, socket);
+            }
+        });
+        socket.on('error', (err) => {
+            this.logger.debug({ err, socketPath }, 'MCP connection error');
+        });
+    }
+    async processLine(line, socket) {
+        try {
+            const request = JSON.parse(line);
+            const response = await this.handler(request);
+            socket.write(JSON.stringify(response) + '\n');
+        }
+        catch (err) {
+            this.logger.error({ err, line }, 'Failed to process MCP request');
+            const errorResponse = {
+                id: 'unknown',
+                success: false,
+                error: err instanceof Error ? err.message : 'Unknown error',
+            };
+            socket.write(JSON.stringify(errorResponse) + '\n');
+        }
+    }
+    /** Stop listening on a specific socket */
+    close(socketPath) {
+        const server = this.servers.get(socketPath);
+        if (server) {
+            server.close();
+            this.servers.delete(socketPath);
+            if (existsSync(socketPath)) {
+                try {
+                    unlinkSync(socketPath);
+                }
+                catch { }
+            }
+        }
+    }
+    /** Stop all sockets */
+    closeAll() {
+        for (const [socketPath, server] of this.servers) {
+            server.close();
+            if (existsSync(socketPath)) {
+                try {
+                    unlinkSync(socketPath);
+                }
+                catch { }
+            }
+        }
+        this.servers.clear();
+    }
+}
+// ── MCP server-side client (used by mcp-server.ts) ──
+export class McpBridgeClient {
+    socketPath;
+    socket = null;
+    pendingRequests = new Map();
+    buffer = '';
+    connected = false;
+    constructor(socketPath) {
+        this.socketPath = socketPath;
+    }
+    async connect() {
+        return new Promise((resolve, reject) => {
+            this.socket = createConnection(this.socketPath);
+            this.socket.on('connect', () => {
+                this.connected = true;
+                resolve();
+            });
+            this.socket.on('data', (data) => {
+                this.buffer += data.toString();
+                let idx;
+                while ((idx = this.buffer.indexOf('\n')) !== -1) {
+                    const line = this.buffer.slice(0, idx);
+                    this.buffer = this.buffer.slice(idx + 1);
+                    this.handleResponse(line);
+                }
+            });
+            this.socket.on('error', (err) => {
+                this.connected = false;
+                reject(err);
+                // Reject all pending requests
+                for (const [, pending] of this.pendingRequests) {
+                    pending.reject(err);
+                }
+                this.pendingRequests.clear();
+            });
+            this.socket.on('close', () => {
+                this.connected = false;
+            });
+        });
+    }
+    handleResponse(line) {
+        try {
+            const response = JSON.parse(line);
+            const pending = this.pendingRequests.get(response.id);
+            if (pending) {
+                this.pendingRequests.delete(response.id);
+                pending.resolve(response);
+            }
+        }
+        catch { }
+    }
+    async sendRequest(request, timeoutMs = 30000) {
+        if (!this.connected || !this.socket) {
+            // Try to reconnect
+            await this.reconnect();
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(request.id);
+                reject(new Error(`MCP request timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pendingRequests.set(request.id, {
+                resolve: (r) => { clearTimeout(timer); resolve(r); },
+                reject: (e) => { clearTimeout(timer); reject(e); },
+            });
+            this.socket.write(JSON.stringify(request) + '\n');
+        });
+    }
+    async reconnect(retries = 5, intervalMs = 2000) {
+        for (let i = 0; i < retries; i++) {
+            try {
+                await this.connect();
+                return;
+            }
+            catch {
+                if (i < retries - 1) {
+                    await new Promise(r => setTimeout(r, intervalMs));
+                }
+            }
+        }
+        throw new Error(`Failed to connect to bridge socket at ${this.socketPath} after ${retries} retries`);
+    }
+    close() {
+        this.socket?.destroy();
+        this.socket = null;
+        this.connected = false;
+    }
+}
+//# sourceMappingURL=mcp-bridge.js.map

package/dist/mcp-bridge.js.map

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

package/dist/mcp-server.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mcp-server.js

@@ -0,0 +1,109 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { v4 as uuidv4 } from 'uuid';
+import { McpBridgeClient } from './mcp-bridge.js';
+// ── MCP Server ──
+// Spawned as a child of CC. Communicates with the bridge via Unix socket.
+const AGENT_ID = process.env.TGCC_AGENT_ID ?? 'unknown';
+const USER_ID = process.env.TGCC_USER_ID ?? 'unknown';
+const SOCKET_PATH = process.env.TGCC_SOCKET ?? '/tmp/tgcc/sockets/default.sock';
+async function main() {
+    const client = new McpBridgeClient(SOCKET_PATH);
+    try {
+        await client.connect();
+    }
+    catch (err) {
+        // Bridge might not be ready yet — tools will retry on each call
+    }
+    const server = new McpServer({
+        name: 'tgcc',
+        version: '0.1.0',
+    });
+    // ── send_file tool ──
+    server.tool('send_file', 'Send a file to the user on Telegram. Use this when you want to deliver a file (image, PDF, code, etc.) to the user.', {
+        path: z.string().describe('Absolute path to the file to send'),
+        caption: z.string().optional().describe('Optional caption for the file'),
+    }, async ({ path, caption }) => {
+        const request = {
+            id: uuidv4(),
+            tool: 'send_file',
+            agentId: AGENT_ID,
+            userId: USER_ID,
+            params: { path, caption },
+        };
+        try {
+            const response = await client.sendRequest(request);
+            if (response.success) {
+                return { content: [{ type: 'text', text: `File sent to user: ${path}` }] };
+            }
+            return { content: [{ type: 'text', text: `Failed to send file: ${response.error}` }], isError: true };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Bridge unavailable: ${err instanceof Error ? err.message : 'unknown error'}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── send_image tool ──
+    server.tool('send_image', 'Send an image to the user on Telegram with a nice preview. Use for generated charts, screenshots, diagrams.', {
+        path: z.string().describe('Absolute path to the image file'),
+        caption: z.string().optional().describe('Optional caption'),
+    }, async ({ path, caption }) => {
+        const request = {
+            id: uuidv4(),
+            tool: 'send_image',
+            agentId: AGENT_ID,
+            userId: USER_ID,
+            params: { path, caption },
+        };
+        try {
+            const response = await client.sendRequest(request);
+            if (response.success) {
+                return { content: [{ type: 'text', text: `Image sent to user: ${path}` }] };
+            }
+            return { content: [{ type: 'text', text: `Failed to send image: ${response.error}` }], isError: true };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Bridge unavailable: ${err instanceof Error ? err.message : 'unknown error'}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── send_voice tool ──
+    server.tool('send_voice', 'Send a voice message to the user on Telegram.', {
+        path: z.string().describe('Path to .ogg opus audio file'),
+        caption: z.string().optional().describe('Optional caption'),
+    }, async ({ path, caption }) => {
+        const request = {
+            id: uuidv4(),
+            tool: 'send_voice',
+            agentId: AGENT_ID,
+            userId: USER_ID,
+            params: { path, caption },
+        };
+        try {
+            const response = await client.sendRequest(request);
+            if (response.success) {
+                return { content: [{ type: 'text', text: `Voice message sent to user: ${path}` }] };
+            }
+            return { content: [{ type: 'text', text: `Failed to send voice: ${response.error}` }], isError: true };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Bridge unavailable: ${err instanceof Error ? err.message : 'unknown error'}` }],
+                isError: true,
+            };
+        }
+    });
+    // Start the MCP server on stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`MCP server error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/service.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/service.js

@@ -0,0 +1,84 @@
+import pino from 'pino';
+import { loadConfig, ensureDirectories, ConfigWatcher, CONFIG_PATH } from './config.js';
+import { Bridge } from './bridge.js';
+async function main() {
+    // ── Load config ──
+    const configPath = process.env.TGCC_CONFIG ?? CONFIG_PATH;
+    let config;
+    try {
+        config = loadConfig(configPath);
+    }
+    catch (err) {
+        console.error(`Failed to load config from ${configPath}:`);
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+    // ── Setup logger ──
+    const logger = pino({
+        level: config.global.logLevel,
+        transport: process.env.NODE_ENV !== 'production'
+            ? { target: 'pino/file', options: { destination: 1 } }
+            : undefined,
+    });
+    // ── Ensure directories ──
+    ensureDirectories(config);
+    // ── Startup self-test ──
+    logger.info({ configPath, agents: Object.keys(config.agents) }, 'TGCC starting');
+    // ── Create bridge ──
+    const bridge = new Bridge(config, logger);
+    // ── Config watcher (hot reload) ──
+    const watcher = new ConfigWatcher(config, configPath, logger);
+    watcher.on('change', async (newConfig, diff) => {
+        try {
+            await bridge.handleConfigChange(newConfig, diff);
+        }
+        catch (err) {
+            logger.error({ err }, 'Failed to apply config change');
+        }
+    });
+    watcher.on('error', (err) => {
+        logger.error({ err }, 'Config watcher error');
+    });
+    // ── SIGHUP → manual reload ──
+    process.on('SIGHUP', () => {
+        logger.info('SIGHUP received — reloading config');
+        watcher.reload();
+    });
+    // ── Graceful shutdown ──
+    let shuttingDown = false;
+    async function shutdown(signal) {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        logger.info({ signal }, 'Shutdown signal received');
+        // Stop watching config
+        watcher.stop();
+        // Stop bridge (stops all bots, kills all CC processes, closes MCP sockets)
+        try {
+            await bridge.stop();
+        }
+        catch (err) {
+            logger.error({ err }, 'Error during bridge shutdown');
+        }
+        logger.info('Shutdown complete');
+        process.exit(0);
+    }
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    // Uncaught exceptions — log and continue (don't crash on TG errors)
+    process.on('uncaughtException', (err) => {
+        logger.error({ err }, 'Uncaught exception');
+    });
+    process.on('unhandledRejection', (reason) => {
+        logger.error({ reason }, 'Unhandled rejection');
+    });
+    // ── Start ──
+    await bridge.start();
+    watcher.start();
+    logger.info('TGCC is running');
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,71 @@
+import type pino from 'pino';
+export interface SessionInfo {
+    id: string;
+    title?: string;
+    startedAt: string;
+    lastActivity: string;
+    messageCount: number;
+    totalCostUsd: number;
+}
+export interface JsonlTracking {
+    size: number;
+    mtimeMs: number;
+}
+export interface UserState {
+    currentSessionId: string | null;
+    lastActivity: string;
+    model: string;
+    repo: string;
+    permissionMode: string;
+    sessions: SessionInfo[];
+    knownSessionIds: string[];
+    jsonlTracking?: JsonlTracking;
+}
+export interface AgentState {
+    users: Record<string, UserState>;
+}
+export interface StateStore {
+    agents: Record<string, AgentState>;
+}
+export declare class SessionStore {
+    private state;
+    private filePath;
+    private logger;
+    constructor(filePath: string, logger: pino.Logger);
+    private load;
+    private save;
+    private ensureUser;
+    getUser(agentId: string, userId: string): UserState;
+    setCurrentSession(agentId: string, userId: string, sessionId: string): void;
+    updateSessionActivity(agentId: string, userId: string, cost?: number): void;
+    setModel(agentId: string, userId: string, model: string): void;
+    setRepo(agentId: string, userId: string, repo: string): void;
+    setPermissionMode(agentId: string, userId: string, mode: string): void;
+    setSessionTitle(agentId: string, userId: string, sessionId: string, title: string): void;
+    updateJsonlTracking(agentId: string, userId: string, size: number, mtimeMs: number): void;
+    getJsonlTracking(agentId: string, userId: string): JsonlTracking | undefined;
+    clearJsonlTracking(agentId: string, userId: string): void;
+    clearSession(agentId: string, userId: string): void;
+    deleteSession(agentId: string, userId: string, sessionId: string): boolean;
+    getRecentSessions(agentId: string, userId: string, limit?: number): SessionInfo[];
+    getFullState(): StateStore;
+}
+/**
+ * Get the path to a CC session's JSONL file.
+ * CC stores sessions at ~/.claude/projects/<repo-slug>/<sessionId>.jsonl
+ */
+export declare function getSessionJsonlPath(sessionId: string, repo: string): string;
+/**
+ * Read new JSONL entries from a byte offset and summarize the turns.
+ * Returns a formatted catch-up message or null if nothing meaningful was found.
+ */
+export declare function summarizeJsonlDelta(jsonlPath: string, fromByteOffset: number, maxChars?: number): string | null;
+export interface MissedSession {
+    id: string;
+    mtime: Date;
+    files: string[];
+}
+export declare function computeProjectSlug(repoPath: string): string;
+export declare function findMissedSessions(repo: string, knownSessionIds: string[], lastActivity: Date): MissedSession[];
+export declare function parseSessionSummary(sessionDir: string): string;
+export declare function formatCatchupMessage(repo: string, missed: MissedSession[]): string;