linguclaw 0.4.3 → 0.5.1

package/dist/chain-of-thought.js

@@ -0,0 +1,337 @@
+"use strict";
+/**
+ * Chain of Thought - Transparent reasoning and action tracking system
+ *
+ * Core capabilities:
+ * - Thought Logs: See exactly what the agent is "thinking"
+ * - Action Tracking: Real-time visibility into which tools are being used
+ * - Reasoning Chain: Full audit trail of decisions and their outcomes
+ * - Event Streaming: WebSocket-compatible event emission for live UI updates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainOfThought = void 0;
+exports.getChainOfThought = getChainOfThought;
+const events_1 = require("events");
+const logger_1 = require("./logger");
+const logger = (0, logger_1.getLogger)();
+const DEFAULT_CONFIG = {
+    maxThoughtsPerSession: 500,
+    maxActionsPerSession: 200,
+    enableStreaming: true,
+    verboseLogging: false,
+    persistToDisk: false,
+};
+// ==================== Chain of Thought Engine ====================
+class ChainOfThought extends events_1.EventEmitter {
+    config;
+    sessions = new Map();
+    activeSession = null;
+    idCounter = 0;
+    constructor(config) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Start a new reasoning session
+     */
+    startSession(task, sessionId) {
+        const id = sessionId || `session-${Date.now()}-${Math.random().toString(36).substr(2, 6)}`;
+        this.sessions.set(id, {
+            task,
+            startedAt: new Date(),
+            thoughts: [],
+            actions: [],
+            chain: [],
+        });
+        this.activeSession = id;
+        this.emit('session:start', { sessionId: id, task });
+        logger.info(`[CoT] Session started: ${id} — "${task.substring(0, 100)}"`);
+        return id;
+    }
+    /**
+     * End a reasoning session
+     */
+    endSession(sessionId, conclusion) {
+        const sid = sessionId || this.activeSession;
+        if (!sid)
+            return null;
+        const session = this.sessions.get(sid);
+        if (!session)
+            return null;
+        if (conclusion) {
+            this.think(sid, 'conclusion', conclusion);
+        }
+        const summary = {
+            sessionId: sid,
+            task: session.task,
+            startedAt: session.startedAt,
+            endedAt: new Date(),
+            totalThoughts: session.thoughts.length,
+            totalActions: session.actions.length,
+            failedActions: session.actions.filter(a => a.status === 'failed').length,
+            corrections: session.thoughts.filter(t => t.type === 'correction').length,
+            reasoningChain: session.chain,
+            finalConclusion: conclusion,
+        };
+        this.emit('session:end', summary);
+        logger.info(`[CoT] Session ended: ${sid} — ${summary.totalThoughts} thoughts, ${summary.totalActions} actions`);
+        if (this.activeSession === sid) {
+            this.activeSession = null;
+        }
+        return summary;
+    }
+    /**
+     * Record a thought
+     */
+    think(sessionId, type, content, meta) {
+        const sid = sessionId || this.activeSession;
+        const session = sid ? this.sessions.get(sid) : null;
+        const thought = {
+            id: `thought-${++this.idCounter}`,
+            sessionId: sid || 'unknown',
+            timestamp: new Date(),
+            type,
+            content,
+            confidence: meta?.confidence,
+            relatedActionId: meta?.relatedActionId,
+            parentThoughtId: meta?.parentThoughtId,
+            metadata: meta?.metadata,
+        };
+        if (session) {
+            if (session.thoughts.length < this.config.maxThoughtsPerSession) {
+                session.thoughts.push(thought);
+            }
+            session.chain.push({ thought });
+        }
+        if (this.config.enableStreaming) {
+            this.emit('thought', thought);
+        }
+        if (this.config.verboseLogging) {
+            logger.info(`[CoT] 💭 [${type}] ${content.substring(0, 150)}`);
+        }
+        return thought;
+    }
+    /**
+     * Record an action start
+     */
+    startAction(sessionId, tool, operation, input, metadata) {
+        const sid = sessionId || this.activeSession;
+        const session = sid ? this.sessions.get(sid) : null;
+        const action = {
+            id: `action-${++this.idCounter}`,
+            sessionId: sid || 'unknown',
+            timestamp: new Date(),
+            tool,
+            operation,
+            input: input.substring(0, 2000),
+            status: 'started',
+            metadata,
+        };
+        if (session) {
+            if (session.actions.length < this.config.maxActionsPerSession) {
+                session.actions.push(action);
+            }
+            // Attach to last reasoning step or create new one
+            const lastStep = session.chain[session.chain.length - 1];
+            if (lastStep && !lastStep.action) {
+                lastStep.action = action;
+            }
+            else {
+                session.chain.push({
+                    thought: {
+                        id: `thought-${++this.idCounter}`,
+                        sessionId: sid || 'unknown',
+                        timestamp: new Date(),
+                        type: 'observation',
+                        content: `Executing ${tool}.${operation}`,
+                        relatedActionId: action.id,
+                    },
+                    action,
+                });
+            }
+        }
+        if (this.config.enableStreaming) {
+            this.emit('action:start', action);
+        }
+        if (this.config.verboseLogging) {
+            logger.info(`[CoT] 🔧 [${tool}.${operation}] ${input.substring(0, 100)}`);
+        }
+        return action;
+    }
+    /**
+     * Update an action's status
+     */
+    updateAction(actionId, update) {
+        for (const session of this.sessions.values()) {
+            const action = session.actions.find(a => a.id === actionId);
+            if (action) {
+                if (update.status)
+                    action.status = update.status;
+                if (update.output !== undefined)
+                    action.output = update.output.substring(0, 5000);
+                if (update.error !== undefined)
+                    action.error = update.error;
+                if (update.duration !== undefined)
+                    action.duration = update.duration;
+                if (this.config.enableStreaming) {
+                    this.emit('action:update', action);
+                }
+                // Update the chain step result
+                const step = session.chain.find(s => s.action?.id === actionId);
+                if (step) {
+                    step.result = update.output || update.error;
+                }
+                return action;
+            }
+        }
+        return null;
+    }
+    /**
+     * Complete an action
+     */
+    completeAction(actionId, output, startTime) {
+        return this.updateAction(actionId, {
+            status: 'completed',
+            output,
+            duration: startTime ? Date.now() - startTime : undefined,
+        });
+    }
+    /**
+     * Fail an action
+     */
+    failAction(actionId, error, startTime) {
+        return this.updateAction(actionId, {
+            status: 'failed',
+            error,
+            duration: startTime ? Date.now() - startTime : undefined,
+        });
+    }
+    /**
+     * Get the full reasoning chain for a session
+     */
+    getChain(sessionId) {
+        const sid = sessionId || this.activeSession;
+        if (!sid)
+            return [];
+        return this.sessions.get(sid)?.chain || [];
+    }
+    /**
+     * Get all thoughts for a session
+     */
+    getThoughts(sessionId, type) {
+        const sid = sessionId || this.activeSession;
+        if (!sid)
+            return [];
+        const thoughts = this.sessions.get(sid)?.thoughts || [];
+        if (type)
+            return thoughts.filter(t => t.type === type);
+        return thoughts;
+    }
+    /**
+     * Get all actions for a session
+     */
+    getActions(sessionId, tool) {
+        const sid = sessionId || this.activeSession;
+        if (!sid)
+            return [];
+        const actions = this.sessions.get(sid)?.actions || [];
+        if (tool)
+            return actions.filter(a => a.tool === tool);
+        return actions;
+    }
+    /**
+     * Get session summary without ending it
+     */
+    getSessionSummary(sessionId) {
+        const sid = sessionId || this.activeSession;
+        if (!sid)
+            return null;
+        const session = this.sessions.get(sid);
+        if (!session)
+            return null;
+        return {
+            sessionId: sid,
+            task: session.task,
+            startedAt: session.startedAt,
+            totalThoughts: session.thoughts.length,
+            totalActions: session.actions.length,
+            failedActions: session.actions.filter(a => a.status === 'failed').length,
+            corrections: session.thoughts.filter(t => t.type === 'correction').length,
+            reasoningChain: session.chain,
+        };
+    }
+    /**
+     * Get a human-readable reasoning trace
+     */
+    getReadableTrace(sessionId) {
+        const chain = this.getChain(sessionId);
+        if (chain.length === 0)
+            return 'No reasoning trace available.';
+        const lines = [];
+        for (let i = 0; i < chain.length; i++) {
+            const step = chain[i];
+            const idx = i + 1;
+            // Thought
+            const typeEmoji = {
+                reasoning: '🧠',
+                planning: '📋',
+                observation: '👁️',
+                decision: '⚖️',
+                reflection: '🪞',
+                correction: '🔄',
+                hypothesis: '💡',
+                conclusion: '✅',
+            }[step.thought.type] || '💭';
+            lines.push(`${idx}. ${typeEmoji} [${step.thought.type.toUpperCase()}] ${step.thought.content}`);
+            // Action
+            if (step.action) {
+                const statusEmoji = {
+                    started: '⏳',
+                    running: '🔄',
+                    completed: '✅',
+                    failed: '❌',
+                    cancelled: '🚫',
+                }[step.action.status] || '❓';
+                lines.push(`   ${statusEmoji} ${step.action.tool}.${step.action.operation}: ${step.action.input.substring(0, 100)}`);
+                if (step.action.output) {
+                    lines.push(`   → ${step.action.output.substring(0, 200)}`);
+                }
+                if (step.action.error) {
+                    lines.push(`   ✗ ${step.action.error.substring(0, 200)}`);
+                }
+                if (step.action.duration) {
+                    lines.push(`   ⏱ ${step.action.duration}ms`);
+                }
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get active session ID
+     */
+    getActiveSessionId() {
+        return this.activeSession;
+    }
+    /**
+     * Clean up old sessions
+     */
+    cleanup(maxAge = 3600000) {
+        const now = Date.now();
+        for (const [id, session] of this.sessions) {
+            if (now - session.startedAt.getTime() > maxAge && id !== this.activeSession) {
+                this.sessions.delete(id);
+            }
+        }
+    }
+}
+exports.ChainOfThought = ChainOfThought;
+// ==================== Singleton ====================
+let instance = null;
+function getChainOfThought(config) {
+    if (!instance) {
+        instance = new ChainOfThought(config);
+    }
+    return instance;
+}
+//# sourceMappingURL=chain-of-thought.js.map

package/dist/chain-of-thought.js.map

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

package/dist/code-sandbox.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Code Sandbox - Execute Python/JavaScript/TypeScript code safely in Docker
+ *
+ * Core capabilities:
+ * - Execute code in isolated Docker containers
+ * - Support for Python, JavaScript, TypeScript, and Shell
+ * - Memory and CPU limits for safety
+ * - Timeout enforcement
+ * - Output capture (stdout, stderr, files)
+ * - Fallback to local execution with safety checks
+ */
+export type SandboxLanguage = 'python' | 'javascript' | 'typescript' | 'shell';
+export interface CodeExecRequest {
+    language: SandboxLanguage;
+    code: string;
+    timeout?: number;
+    stdin?: string;
+    env?: Record<string, string>;
+    workDir?: string;
+    packages?: string[];
+}
+export interface CodeExecResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    executionTime: number;
+    sandboxed: boolean;
+    language: SandboxLanguage;
+    error?: string;
+    files?: {
+        name: string;
+        content: string;
+    }[];
+}
+export declare class CodeSandbox {
+    private dockerAvailable;
+    private tempDir;
+    constructor();
+    /**
+     * Initialize and check Docker availability
+     */
+    init(): Promise<boolean>;
+    get isDockerAvailable(): boolean;
+    /**
+     * Execute code in sandbox
+     */
+    execute(request: CodeExecRequest): Promise<CodeExecResult>;
+    /**
+     * Execute code in Docker container
+     */
+    private executeInDocker;
+    /**
+     * Execute code locally with safety restrictions (fallback when Docker unavailable)
+     */
+    private executeLocally;
+    /**
+     * Check code for dangerous patterns
+     */
+    private checkCodeSafety;
+    /**
+     * Parse Docker container logs into stdout/stderr
+     */
+    private parseDockerLogs;
+    /**
+     * Get available languages and their status
+     */
+    getAvailableLanguages(): Promise<Record<SandboxLanguage, {
+        available: boolean;
+        runtime: string;
+    }>>;
+    /**
+     * Utility: ensure directory exists
+     */
+    private ensureDir;
+    /**
+     * Utility: safely delete a file
+     */
+    private safeDelete;
+}
+//# sourceMappingURL=code-sandbox.d.ts.map

package/dist/code-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-sandbox.d.ts","sourceRoot":"","sources":["../src/code-sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,OAAO,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C;AAyDD,qBAAa,WAAW;IACtB,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAS;;IAOxB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAe9B,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IA2BhE;;OAEG;YACW,eAAe;IA0F7B;;OAEG;YACW,cAAc;IAuE5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAwBxG;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,OAAO,CAAC,UAAU;CAKnB"}