linguclaw 0.4.0

package/dist/memory.d.ts

@@ -0,0 +1,42 @@
+/**
+ * RAG Memory system backed by SemanticMemory (TF-IDF + SQLite)
+ * No external dependencies like lancedb required.
+ */
+export declare class RAGMemory {
+    projectRoot: string;
+    available: boolean;
+    private semanticMemory;
+    private indexedCount;
+    constructor(projectRoot: string);
+    /**
+     * Initialize memory
+     */
+    init(): Promise<boolean>;
+    /**
+     * Index project codebase
+     */
+    indexProject(force?: boolean): Promise<number>;
+    /**
+     * Parse file into chunks
+     */
+    private parseFile;
+    /**
+     * Extract name from definition line
+     */
+    private extractName;
+    /**
+     * Search codebase with smart context
+     */
+    search(query: string, k?: number): Promise<string>;
+    /**
+     * Get memory stats
+     */
+    getStats(): {
+        count: number;
+    };
+    /**
+     * Get related code for a symbol
+     */
+    getRelated(symbol: string, k?: number): string;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,qBAAa,SAAS;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAa;gBAErB,WAAW,EAAE,MAAM;IAO/B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAiB9B;;OAEG;IACG,YAAY,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAuF3D;;OAEG;IACH,OAAO,CAAC,SAAS;IA+DjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IA6B3D;;OAEG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAc7B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU,GAAG,MAAM;CAwBlD"}

package/dist/memory.js

@@ -0,0 +1,274 @@
+"use strict";
+/**
+ * RAG Memory system backed by SemanticMemory (TF-IDF + SQLite)
+ * No external dependencies like lancedb required.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAGMemory = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const logger_1 = require("./logger");
+const semantic_memory_1 = require("./semantic-memory");
+const code_parser_1 = require("./code-parser");
+const logger = (0, logger_1.getLogger)();
+class RAGMemory {
+    projectRoot;
+    available;
+    semanticMemory;
+    indexedCount = 0;
+    constructor(projectRoot) {
+        this.projectRoot = path_1.default.resolve(projectRoot);
+        const dbPath = path_1.default.join(this.projectRoot, '.linguclaw', 'rag-memory.db');
+        this.semanticMemory = new semantic_memory_1.SemanticMemory(dbPath);
+        this.available = false;
+    }
+    /**
+     * Initialize memory
+     */
+    async init() {
+        try {
+            const ok = this.semanticMemory.init();
+            if (ok) {
+                this.available = true;
+                const stats = this.semanticMemory.getStats();
+                this.indexedCount = stats.totalDocuments;
+                logger.info(`RAG memory initialized (${this.indexedCount} chunks indexed)`);
+            }
+            return ok;
+        }
+        catch (error) {
+            logger.warn(`RAG memory init failed: ${error.message}`);
+            this.available = false;
+            return false;
+        }
+    }
+    /**
+     * Index project codebase
+     */
+    async indexProject(force = false) {
+        if (!this.available) {
+            logger.warn('RAG memory not available');
+            return 0;
+        }
+        const stats = this.getStats();
+        if (stats.count > 0 && !force) {
+            logger.info(`Memory already has ${stats.count} chunks, use force=true to reindex`);
+            return 0;
+        }
+        // Find all code files
+        const extensions = ['.ts', '.tsx', '.js', '.jsx', '.py', '.java', '.go', '.rs', '.cpp', '.c', '.h'];
+        const files = [];
+        const findFiles = (dir, depth = 0) => {
+            if (depth > 15)
+                return; // Prevent excessive recursion
+            try {
+                const entries = fs_1.default.readdirSync(dir);
+                for (const entry of entries) {
+                    const fullPath = path_1.default.join(dir, entry);
+                    const stat = fs_1.default.statSync(fullPath);
+                    if (stat.isDirectory() && !entry.startsWith('.') && entry !== 'node_modules' && entry !== 'dist' && entry !== 'tests' && entry !== '__pycache__') {
+                        findFiles(fullPath, depth + 1);
+                    }
+                    else if (stat.isFile() && extensions.some(ext => entry.endsWith(ext))) {
+                        files.push(fullPath);
+                    }
+                }
+            }
+            catch (err) {
+                logger.debug(`Skipping unreadable directory ${dir}: ${err.message}`);
+            }
+        };
+        findFiles(this.projectRoot);
+        // Parse and index files with AST for TypeScript
+        let indexed = 0;
+        const parsedChunks = [];
+        for (const file of files) {
+            try {
+                const ext = path_1.default.extname(file);
+                if (ext === '.ts' || ext === '.tsx' || ext === '.js' || ext === '.jsx') {
+                    // Use AST-based parsing for TypeScript/JavaScript
+                    const chunks = (0, code_parser_1.parseTypeScriptFile)(file);
+                    parsedChunks.push(...chunks);
+                    indexed += chunks.length;
+                }
+                else {
+                    // Use regex-based parsing for other languages
+                    const content = fs_1.default.readFileSync(file, 'utf-8');
+                    const chunks = (0, code_parser_1.parseGenericFile)(file, content);
+                    parsedChunks.push(...chunks);
+                    indexed += chunks.length;
+                }
+            }
+            catch (error) {
+                logger.warn(`Failed to index ${file}: ${error}`);
+            }
+        }
+        // Store chunks in semantic memory with rich metadata
+        for (const chunk of parsedChunks) {
+            this.semanticMemory.store(chunk.id, chunk.content, 'code', {
+                file_path: chunk.filePath,
+                chunk_type: chunk.chunkType,
+                name: chunk.name,
+                line_start: chunk.lineStart,
+                line_end: chunk.lineEnd,
+                signature: chunk.signature,
+                documentation: chunk.documentation,
+                is_exported: chunk.isExported,
+                dependencies: chunk.dependencies,
+                dependents: chunk.dependents,
+            });
+        }
+        // Rebuild TF-IDF index after batch insert
+        if (parsedChunks.length > 0) {
+            this.semanticMemory.rebuildIndex();
+        }
+        this.indexedCount = parsedChunks.length;
+        logger.info(`Indexed ${indexed} AST chunks from ${files.length} files`);
+        return indexed;
+    }
+    /**
+     * Parse file into chunks
+     */
+    parseFile(filePath, content) {
+        const chunks = [];
+        const lines = content.split('\n');
+        const ext = path_1.default.extname(filePath);
+        const baseName = path_1.default.basename(filePath);
+        // Simple parsing: Split into logical sections
+        // In production, you'd use AST parsing
+        let currentChunk = {
+            id: `${filePath}-chunk-0`,
+            file_path: filePath,
+            content: '',
+            chunk_type: 'other',
+            name: baseName,
+            line_start: 1,
+            line_end: 1,
+        };
+        let chunkIndex = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Detect function/class definitions (simplified)
+            const isFunction = /^(export\s+)?(async\s+)?function\s+\w+/.test(line) ||
+                /^(export\s+)?(async\s+)?\w+\s*\([^)]*\)\s*\{?\s*$/.test(line);
+            const isClass = /^(export\s+)?class\s+\w+/.test(line);
+            if ((isFunction || isClass) && currentChunk.content) {
+                // Save previous chunk
+                chunks.push({
+                    ...currentChunk,
+                    id: `${filePath}-chunk-${chunkIndex++}`,
+                    line_end: i,
+                });
+                // Start new chunk
+                currentChunk = {
+                    id: '',
+                    file_path: filePath,
+                    content: line,
+                    chunk_type: isFunction ? 'function' : 'class',
+                    name: this.extractName(line) || baseName,
+                    line_start: i + 1,
+                    line_end: i + 1,
+                };
+            }
+            else {
+                currentChunk.content += '\n' + line;
+                currentChunk.line_end = i + 1;
+            }
+        }
+        // Add final chunk
+        if (currentChunk.content) {
+            chunks.push({
+                ...currentChunk,
+                id: `${filePath}-chunk-${chunkIndex}`,
+            });
+        }
+        return chunks;
+    }
+    /**
+     * Extract name from definition line
+     */
+    extractName(line) {
+        const match = line.match(/(?:function|class)\s+(\w+)/);
+        return match ? match[1] : null;
+    }
+    /**
+     * Search codebase with smart context
+     */
+    async search(query, k = 5) {
+        if (!this.available) {
+            return '[Memory unavailable]';
+        }
+        try {
+            const results = this.semanticMemory.search(query, k, 'code');
+            if (!results || results.length === 0) {
+                return '[No relevant code found]';
+            }
+            const formatted = results.map((r, i) => {
+                const meta = r.metadata || {};
+                let context = `[${i + 1}] ${meta.chunk_type || 'code'}: ${meta.name || 'unknown'} (${meta.file_path || '?'}:${meta.line_start || '?'})`;
+                if (meta.signature)
+                    context += `\n   Signature: ${meta.signature}`;
+                if (meta.documentation)
+                    context += `\n   Docs: ${meta.documentation.substring(0, 100)}...`;
+                if (meta.dependencies?.length > 0)
+                    context += `\n   Uses: ${meta.dependencies.slice(0, 5).join(', ')}`;
+                context += `\n${r.content.slice(0, 200)}...`;
+                return context;
+            });
+            return formatted.join('\n\n');
+        }
+        catch (error) {
+            logger.error(`Search error: ${error.message}`);
+            return `[Search error: ${error.message}]`;
+        }
+    }
+    /**
+     * Get memory stats
+     */
+    getStats() {
+        if (!this.available) {
+            return { count: 0 };
+        }
+        try {
+            const stats = this.semanticMemory.getStats();
+            return { count: stats.totalDocuments };
+        }
+        catch (err) {
+            logger.debug(`getStats error: ${err.message}`);
+            return { count: 0 };
+        }
+    }
+    /**
+     * Get related code for a symbol
+     */
+    getRelated(symbol, k = 3) {
+        if (!this.available)
+            return '[Memory unavailable]';
+        try {
+            // Find the symbol
+            const all = this.semanticMemory.search(symbol, 50, 'code');
+            const target = all.find(r => r.metadata?.name === symbol);
+            if (!target)
+                return `[Symbol '${symbol}' not found]`;
+            // Get dependencies and dependents
+            const meta = target.metadata || {};
+            const deps = meta.dependencies || [];
+            const dps = meta.dependents || [];
+            let result = `Related to ${symbol}:\n\n`;
+            if (deps.length > 0)
+                result += `Dependencies: ${deps.slice(0, k).join(', ')}\n`;
+            if (dps.length > 0)
+                result += `Used by: ${dps.slice(0, k).join(', ')}\n`;
+            return result;
+        }
+        catch (err) {
+            logger.error(`getRelated error: ${err.message}`);
+            return `[Error: ${err.message}]`;
+        }
+    }
+}
+exports.RAGMemory = RAGMemory;
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/messaging.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Messaging platform integrations - Telegram, Discord, Slack, WhatsApp
+ * Real implementations using HTTP APIs via axios
+ */
+import { MessagingPlatform, ChatMessage, ChatResponse } from './types';
+type MessageHandler = (msg: ChatMessage) => ChatResponse | null | Promise<ChatResponse | null>;
+export declare abstract class BaseMessagingPlatform {
+    platform: MessagingPlatform;
+    messageHandlers: MessageHandler[];
+    running: boolean;
+    constructor(platform: MessagingPlatform);
+    onMessage(handler: MessageHandler): void;
+    protected handleMessage(msg: ChatMessage): Promise<ChatResponse | null>;
+    abstract start(): Promise<void>;
+    abstract stop(): Promise<void>;
+    abstract send(response: ChatResponse): Promise<void>;
+}
+/**
+ * Telegram Bot - Uses Telegram Bot API via HTTP long polling
+ * Requires: TELEGRAM_BOT_TOKEN from @BotFather
+ */
+export declare class TelegramBot extends BaseMessagingPlatform {
+    private token;
+    private allowedChats?;
+    private api;
+    private pollTimer;
+    private lastUpdateId;
+    constructor(token: string);
+    allowChats(chatIds: number[]): void;
+    start(): Promise<void>;
+    private poll;
+    stop(): Promise<void>;
+    send(response: ChatResponse): Promise<void>;
+}
+/**
+ * Discord Bot - Uses Discord Gateway API for receiving, REST for sending
+ * Requires: DISCORD_BOT_TOKEN from Discord Developer Portal
+ */
+export declare class DiscordBot extends BaseMessagingPlatform {
+    private token;
+    private api;
+    private ws;
+    private heartbeatInterval;
+    private lastSequence;
+    private reconnectAttempts;
+    constructor(token: string);
+    start(): Promise<void>;
+    private connectGateway;
+    private handleGatewayEvent;
+    stop(): Promise<void>;
+    send(response: ChatResponse): Promise<void>;
+}
+/**
+ * Slack Bot - Uses Slack Web API + Socket Mode for real-time events
+ * Requires: SLACK_BOT_TOKEN (xoxb-...) and SLACK_APP_TOKEN (xapp-...)
+ */
+export declare class SlackBot extends BaseMessagingPlatform {
+    private botToken;
+    private appToken?;
+    private api;
+    private ws;
+    constructor(botToken: string, appToken?: string);
+    start(): Promise<void>;
+    private connectSocketMode;
+    stop(): Promise<void>;
+    send(response: ChatResponse): Promise<void>;
+}
+/**
+ * WhatsApp Bot - Uses Twilio API for sending/receiving messages
+ * Requires: TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_WHATSAPP_FROM
+ */
+export declare class WhatsAppBot extends BaseMessagingPlatform {
+    private accountSid;
+    private authToken;
+    private fromNumber;
+    private api;
+    constructor(accountSid?: string, authToken?: string, fromNumber?: string);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(response: ChatResponse): Promise<void>;
+    handleWebhook(body: Record<string, string>): ChatMessage | null;
+}
+/**
+ * MessagingHub - Central manager for all messaging platforms
+ */
+export declare class MessagingHub {
+    platforms: Map<MessagingPlatform, BaseMessagingPlatform>;
+    private agentCallback?;
+    constructor();
+    registerAgent(callback: MessageHandler): void;
+    addPlatform(platform: BaseMessagingPlatform): void;
+    startAll(): Promise<void>;
+    stopAll(): Promise<void>;
+    sendToPlatform(platform: MessagingPlatform, response: ChatResponse): Promise<void>;
+    getStatus(): Record<string, boolean>;
+    createPlatformsFromEnv(): BaseMessagingPlatform[];
+}
+export declare function createTelegramBot(token: string, allowedChats?: number[]): TelegramBot;
+export declare function createDiscordBot(token: string): DiscordBot;
+export declare function createSlackBot(botToken: string, appToken?: string): SlackBot;
+export declare function createWhatsAppTwilio(): WhatsAppBot;
+export {};
+//# sourceMappingURL=messaging.d.ts.map

package/dist/messaging.d.ts.map

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