linguclaw 0.4.0

package/dist/tools.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Containerized tools with Docker sandboxing
+ * TypeScript equivalent of Python tools.py
+ */
+import { DockerSandbox } from './sandbox';
+import { SafetyMiddleware, FallbackSafetyMode } from './safety';
+import { CommandResult, FileResult } from './types';
+export declare class ShellTool {
+    projectRoot: string;
+    safety: SafetyMiddleware;
+    sandbox: DockerSandbox | null;
+    fallback: FallbackSafetyMode | null;
+    private usingDocker;
+    constructor(projectRoot: string, useDocker?: boolean, safety?: SafetyMiddleware, fallbackConfirmed?: boolean);
+    /**
+     * Initialize Docker sandbox
+     */
+    init(): Promise<boolean>;
+    private initFallback;
+    /**
+     * Check if running in sandbox
+     */
+    get isSandboxed(): boolean;
+    /**
+     * Execute command in sandbox or fallback
+     */
+    run(command: string, timeout?: number): Promise<CommandResult>;
+    /**
+     * Cleanup sandbox resources
+     */
+    stop(): Promise<void>;
+}
+/**
+ * RAG-based semantic search over codebase memory
+ */
+export declare class SearchMemoryTool {
+    private memory;
+    constructor(memory: any);
+    searchCodebase(query: string, k?: number): string;
+    getStats(): Record<string, any>;
+}
+/**
+ * Sandboxed filesystem operations
+ */
+export declare class FileSystemTool {
+    root: string;
+    constructor(root: string);
+    /**
+     * Validate path is within root (prevents path traversal)
+     */
+    private validate;
+    private static readonly MAX_FILE_SIZE;
+    private static readonly MAX_DIR_ENTRIES;
+    /**
+     * Read file contents
+     */
+    read(filePath: string, limit?: number): FileResult;
+    /**
+     * Write file contents
+     */
+    write(filePath: string, content: string): FileResult;
+    /**
+     * List directory contents
+     */
+    listDir(dirPath?: string): FileResult;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAC;AAMnE,qBAAa,SAAS;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,WAAW,CAAU;gBAG3B,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,OAAc,EACzB,MAAM,CAAC,EAAE,gBAAgB,EACzB,iBAAiB,GAAE,OAAe;IAyBpC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB9B,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAmExE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAK5B;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAM;gBAER,MAAM,EAAE,GAAG;IAIvB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU,GAAG,MAAM;IAOpD,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGhC;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,IAAI,EAAE,MAAM,CAAC;gBAED,IAAI,EAAE,MAAM;IAOxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IA6BhB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAoB;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;IAE/C;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;IA2BlD;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU;IAiBpD;;OAEG;IACH,OAAO,CAAC,OAAO,GAAE,MAAY,GAAG,UAAU;CA4B3C"}

package/dist/tools.js

@@ -0,0 +1,303 @@
+"use strict";
+/**
+ * Containerized tools with Docker sandboxing
+ * TypeScript equivalent of Python tools.py
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemTool = exports.SearchMemoryTool = exports.ShellTool = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const util_1 = require("util");
+const child_process_1 = require("child_process");
+const sandbox_1 = require("./sandbox");
+const safety_1 = require("./safety");
+const logger_1 = require("./logger");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+const logger = (0, logger_1.getLogger)();
+class ShellTool {
+    projectRoot;
+    safety;
+    sandbox;
+    fallback;
+    usingDocker;
+    constructor(projectRoot, useDocker = true, safety, fallbackConfirmed = false) {
+        this.projectRoot = path_1.default.resolve(projectRoot);
+        this.safety = safety || new safety_1.SafetyMiddleware();
+        this.sandbox = null;
+        this.fallback = null;
+        this.usingDocker = false;
+        // Ensure project directory exists
+        if (!fs_1.default.existsSync(this.projectRoot)) {
+            fs_1.default.mkdirSync(this.projectRoot, { recursive: true });
+        }
+        if (useDocker) {
+            this.sandbox = new sandbox_1.DockerSandbox({
+                image: 'alpine:latest',
+                memory_limit: '512m',
+                cpu_limit: 0.5,
+                auto_remove: true,
+            });
+        }
+        else {
+            this.initFallback(fallbackConfirmed);
+        }
+    }
+    /**
+     * Initialize Docker sandbox
+     */
+    async init() {
+        if (this.sandbox) {
+            const available = await this.sandbox.checkAvailability();
+            if (available) {
+                const started = await this.sandbox.start(this.projectRoot);
+                if (started) {
+                    this.usingDocker = true;
+                    logger.info('Using Docker sandbox');
+                    return true;
+                }
+            }
+            logger.warn('Docker available but sandbox start failed');
+        }
+        this.initFallback(false);
+        return false;
+    }
+    initFallback(confirmed) {
+        this.fallback = new safety_1.FallbackSafetyMode(this.safety, confirmed);
+        logger.warn('Docker unavailable - using strict safety fallback');
+    }
+    /**
+     * Check if running in sandbox
+     */
+    get isSandboxed() {
+        return this.usingDocker && this.sandbox !== null;
+    }
+    /**
+     * Execute command in sandbox or fallback
+     */
+    async run(command, timeout = 60) {
+        if (this.isSandboxed && this.sandbox) {
+            // Docker sandboxed execution
+            try {
+                const result = await this.sandbox.exec(command);
+                return {
+                    stdout: result.stdout,
+                    stderr: result.stderr,
+                    returncode: result.exit_code,
+                    sandboxed: true,
+                };
+            }
+            catch (error) {
+                return {
+                    stdout: '',
+                    stderr: `Sandbox error: ${error.message}`,
+                    returncode: -1,
+                    sandboxed: true,
+                };
+            }
+        }
+        else if (this.fallback) {
+            // Strict safety fallback
+            const allowed = this.fallback.check(command);
+            if (!allowed.allowed) {
+                // Try to get explicit confirmation
+                if (this.fallback.promptConfirmation(command)) {
+                    // Proceed with execution
+                }
+                else {
+                    return {
+                        stdout: '',
+                        stderr: `STRICT SAFETY BLOCKED: ${allowed.reason}`,
+                        returncode: -1,
+                        sandboxed: false,
+                    };
+                }
+            }
+            // Execute with basic subprocess
+            try {
+                const { stdout, stderr } = await execAsync(command, {
+                    cwd: this.projectRoot,
+                    timeout: timeout * 1000,
+                });
+                return {
+                    stdout: stdout || '',
+                    stderr: stderr || '',
+                    returncode: 0,
+                    sandboxed: false,
+                };
+            }
+            catch (error) {
+                return {
+                    stdout: '',
+                    stderr: error.stderr || error.message,
+                    returncode: error.code || -1,
+                    sandboxed: false,
+                };
+            }
+        }
+        return {
+            stdout: '',
+            stderr: 'No execution method available',
+            returncode: -1,
+            sandboxed: false,
+        };
+    }
+    /**
+     * Cleanup sandbox resources
+     */
+    async stop() {
+        if (this.sandbox) {
+            await this.sandbox.stop();
+        }
+    }
+}
+exports.ShellTool = ShellTool;
+/**
+ * RAG-based semantic search over codebase memory
+ */
+class SearchMemoryTool {
+    memory; // RAGMemory type would be imported
+    constructor(memory) {
+        this.memory = memory;
+    }
+    searchCodebase(query, k = 5) {
+        if (!this.memory.available) {
+            return '[Memory unavailable - RAG system offline]';
+        }
+        return this.memory.search(query, k);
+    }
+    getStats() {
+        return this.memory.getStats();
+    }
+}
+exports.SearchMemoryTool = SearchMemoryTool;
+/**
+ * Sandboxed filesystem operations
+ */
+class FileSystemTool {
+    root;
+    constructor(root) {
+        this.root = path_1.default.resolve(root);
+        if (!fs_1.default.existsSync(this.root)) {
+            fs_1.default.mkdirSync(this.root, { recursive: true });
+        }
+    }
+    /**
+     * Validate path is within root (prevents path traversal)
+     */
+    validate(targetPath) {
+        const target = path_1.default.resolve(this.root, targetPath);
+        const realRoot = fs_1.default.realpathSync(this.root);
+        // Resolve symlinks to prevent traversal via symlinks
+        let realTarget;
+        try {
+            realTarget = fs_1.default.realpathSync(target);
+        }
+        catch {
+            // File may not exist yet (for write), check parent
+            const parent = path_1.default.dirname(target);
+            try {
+                const realParent = fs_1.default.realpathSync(parent);
+                if (!realParent.startsWith(realRoot)) {
+                    throw new Error(`Access denied: ${targetPath} outside project root`);
+                }
+            }
+            catch {
+                // Parent doesn't exist either, just check resolved path
+                if (!target.startsWith(realRoot)) {
+                    throw new Error(`Access denied: ${targetPath} outside project root`);
+                }
+            }
+            return target;
+        }
+        if (!realTarget.startsWith(realRoot)) {
+            throw new Error(`Access denied: ${targetPath} outside project root`);
+        }
+        return realTarget;
+    }
+    static MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB
+    static MAX_DIR_ENTRIES = 5000;
+    /**
+     * Read file contents
+     */
+    read(filePath, limit) {
+        try {
+            const target = this.validate(filePath);
+            if (!fs_1.default.existsSync(target)) {
+                return { success: false, error: `Not found: ${filePath}` };
+            }
+            const stat = fs_1.default.statSync(target);
+            if (!stat.isFile()) {
+                return { success: false, error: `Not a file: ${filePath}` };
+            }
+            if (stat.size > FileSystemTool.MAX_FILE_SIZE) {
+                return { success: false, error: `File too large (${Math.round(stat.size / 1024 / 1024)}MB > 10MB limit)` };
+            }
+            let content = fs_1.default.readFileSync(target, 'utf-8');
+            if (limit && content.length > limit) {
+                content = content.slice(0, limit) + `\n... (${content.length - limit} more)`;
+            }
+            return { success: true, content };
+        }
+        catch (error) {
+            if (error.message.includes('Access denied')) {
+                return { success: false, error: error.message };
+            }
+            return { success: false, error: `Read error: ${error.message}` };
+        }
+    }
+    /**
+     * Write file contents
+     */
+    write(filePath, content) {
+        try {
+            const target = this.validate(filePath);
+            const dir = path_1.default.dirname(target);
+            if (!fs_1.default.existsSync(dir)) {
+                fs_1.default.mkdirSync(dir, { recursive: true });
+            }
+            fs_1.default.writeFileSync(target, content, 'utf-8');
+            return { success: true };
+        }
+        catch (error) {
+            if (error.message.includes('Access denied')) {
+                return { success: false, error: error.message };
+            }
+            return { success: false, error: `Write error: ${error.message}` };
+        }
+    }
+    /**
+     * List directory contents
+     */
+    listDir(dirPath = '.') {
+        try {
+            const target = this.validate(dirPath);
+            if (!fs_1.default.existsSync(target)) {
+                return { success: false, error: `Not found: ${dirPath}` };
+            }
+            if (!fs_1.default.statSync(target).isDirectory()) {
+                return { success: false, error: `Not a directory: ${dirPath}` };
+            }
+            const entries = fs_1.default.readdirSync(target);
+            if (entries.length > FileSystemTool.MAX_DIR_ENTRIES) {
+                return { success: false, error: `Directory has ${entries.length} entries (limit: ${FileSystemTool.MAX_DIR_ENTRIES})` };
+            }
+            const formatted = entries.map(e => {
+                const fullPath = path_1.default.join(target, e);
+                const isDir = fs_1.default.statSync(fullPath).isDirectory();
+                return `${isDir ? '[dir]' : '[file]'} ${e}`;
+            });
+            return { success: true, content: formatted.sort().join('\n') };
+        }
+        catch (error) {
+            if (error.message.includes('Access denied')) {
+                return { success: false, error: error.message };
+            }
+            return { success: false, error: `List error: ${error.message}` };
+        }
+    }
+}
+exports.FileSystemTool = FileSystemTool;
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,295 @@
+/**
+ * Core types and interfaces for LinguClaw
+ * Equivalent to Python dataclasses and type definitions
+ */
+export interface Message {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LLMResponse {
+    content: string;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+    model: string;
+    finish_reason?: string | null;
+    error?: string | null;
+}
+export interface TokenBudget {
+    max_total: number;
+    used: number;
+    reserved: number;
+    threshold: number;
+}
+export declare enum ProviderType {
+    OPENROUTER = "openrouter",
+    OPENAI = "openai",
+    ANTHROPIC = "anthropic",
+    OLLAMA = "ollama",
+    LMSTUDIO = "lmstudio",
+    CUSTOM = "custom"
+}
+export declare enum AgentRole {
+    PLANNER = "planner",
+    EXECUTOR = "executor",
+    REVIEWER = "reviewer"
+}
+export declare enum StepStatus {
+    PENDING = "pending",
+    IN_PROGRESS = "in_progress",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    RETRYING = "retrying"
+}
+export interface PlanStep {
+    id: string;
+    description: string;
+    agent: AgentRole;
+    status: StepStatus;
+    dependencies: string[];
+    result?: any;
+    error?: string | null;
+    retry_count: number;
+    max_retries: number;
+}
+export interface SharedState {
+    task: string;
+    plan: PlanStep[];
+    current_step_idx: number;
+    execution_log: ExecutionRecord[];
+    files_modified: string[];
+    context: Map<string, any>;
+    iteration: number;
+    max_iterations: number;
+    aborted: boolean;
+}
+export interface ExecutionRecord {
+    iteration: number;
+    timestamp: Date;
+    role: AgentRole;
+    content: string;
+    action: string;
+    result: string;
+    status: 'success' | 'error' | 'blocked';
+}
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    returncode: number;
+    sandboxed: boolean;
+}
+export interface FileResult {
+    success: boolean;
+    content?: string | null;
+    error?: string | null;
+}
+export interface SafetyResult {
+    allowed: boolean;
+    risk_score: number;
+    reason: string;
+}
+export declare enum RiskLevel {
+    CRITICAL = 100,
+    HIGH = 90,
+    ELEVATED = 70,
+    MODERATE = 50,
+    LOW = 35,
+    MINIMAL = 10
+}
+export interface MemoryEntry {
+    key: string;
+    value: any;
+    category: string;
+    timestamp: Date;
+    access_count: number;
+    last_accessed: Date;
+    tags: string[];
+    expires_at?: Date | null;
+}
+export interface CodeChunk {
+    id: string;
+    file_path: string;
+    chunk_type: 'function' | 'class' | 'module' | 'other';
+    name: string;
+    content: string;
+    embedding?: number[];
+    line_start: number;
+    line_end: number;
+}
+export interface PluginConfig {
+    enabled: boolean;
+    settings: Record<string, any>;
+}
+export interface PluginContext {
+    config: PluginConfig;
+    logger: Logger;
+    memory_dir: string;
+}
+export interface PluginInfo {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    dependencies: string[];
+}
+export declare enum MessagingPlatform {
+    WHATSAPP = "whatsapp",
+    TELEGRAM = "telegram",
+    DISCORD = "discord",
+    SLACK = "slack"
+}
+export interface ChatMessage {
+    platform: MessagingPlatform;
+    user_id: string;
+    username: string;
+    content: string;
+    timestamp: Date;
+    chat_id?: string;
+    reply_to?: string | null;
+    metadata: Record<string, any>;
+}
+export interface ChatResponse {
+    content: string;
+    platform: MessagingPlatform;
+    chat_id: string;
+    user_id?: string | null;
+    thread_id?: string | null;
+    actions: Record<string, any>[];
+}
+export declare enum SkillType {
+    PYTHON = "python",
+    JAVASCRIPT = "javascript",
+    SHELL = "shell",
+    API = "api"
+}
+export interface SkillResult {
+    success: boolean;
+    output?: any;
+    error?: string | null;
+    metadata?: Record<string, any>;
+}
+export interface SkillSchema {
+    name: string;
+    description: string;
+    version: string;
+    type: SkillType;
+    parameters: Record<string, any>;
+}
+export declare enum TriggerType {
+    TIME = "time",
+    INTERVAL = "interval",
+    EVENT = "event",
+    CONDITION = "condition"
+}
+export declare enum ActionType {
+    REMINDER = "reminder",
+    ALERT = "alert",
+    BRIEFING = "briefing",
+    TASK = "task",
+    NOTIFICATION = "notification",
+    MESSAGE = "message"
+}
+export interface ProactiveTask {
+    id: string;
+    name: string;
+    description: string;
+    trigger_type: TriggerType;
+    trigger_config: Record<string, any>;
+    action_type: ActionType;
+    action_config: Record<string, any>;
+    enabled: boolean;
+    last_run?: Date | null;
+    run_count: number;
+    created_at: Date;
+    tags: string[];
+}
+export declare enum DataRetention {
+    FOREVER = "forever",
+    THIRTY_DAYS = "30d",
+    SEVEN_DAYS = "7d",
+    SESSION = "session",
+    NONE = "none"
+}
+export declare enum LogLevel {
+    NONE = "none",
+    ERRORS_ONLY = "errors",
+    MINIMAL = "minimal",
+    FULL = "full"
+}
+export interface PrivacySettings {
+    conversation_retention: DataRetention;
+    memory_retention: DataRetention;
+    log_retention: DataRetention;
+    log_level: LogLevel;
+    log_to_cloud: boolean;
+    share_analytics: boolean;
+    share_crashes: boolean;
+    allow_remote_commands: boolean;
+    prefer_local_models: boolean;
+    offline_mode: boolean;
+    encrypt_memory: boolean;
+    encrypt_logs: boolean;
+    secure_delete: boolean;
+    require_auth: boolean;
+    allowed_users: string[];
+    admin_users: string[];
+    data_dir: string;
+}
+export interface Logger {
+    debug: (message: string, ...meta: any[]) => void;
+    info: (message: string, ...meta: any[]) => void;
+    warn: (message: string, ...meta: any[]) => void;
+    error: (message: string, ...meta: any[]) => void;
+}
+export interface SandboxConfig {
+    image: string;
+    memory_limit: string;
+    cpu_limit: number;
+    auto_remove: boolean;
+    network_disabled?: boolean;
+}
+export interface SandboxExecResult {
+    exit_code: number;
+    stdout: string;
+    stderr: string;
+}
+export interface FacetResult {
+    output: string;
+    confidence: number;
+    next_facet?: string | null;
+    complete: boolean;
+}
+export interface Branch {
+    id: string;
+    name: string;
+    strategy: 'conservative' | 'experimental' | 'custom';
+    risk_threshold: number;
+    result?: any;
+    fitness: number;
+}
+export interface DaemonStatus {
+    running: boolean;
+    started_at?: Date | null;
+    uptime_seconds: number;
+    tasks_processed: number;
+    errors_count: number;
+    active_services: string[];
+}
+export interface DashboardState {
+    current_task: string;
+    steps: PlanStep[];
+    logs: ExecutionRecord[];
+    stats: {
+        tokens_used: number;
+        commands_run: number;
+        iterations: number;
+    };
+}
+export interface WebSocketMessage {
+    type: 'state_update' | 'log' | 'thought' | 'error' | 'complete';
+    payload: any;
+    timestamp: Date;
+}
+//# sourceMappingURL=types.d.ts.map