@gotza02/smartagent 1.2.0

package/dist/tools/terminal.js

@@ -0,0 +1,363 @@
+/**
+ * Terminal Tool Integration
+ * Secure command execution with validation and sandboxing
+ */
+import { spawn } from "child_process";
+import { logger, logToolExecution } from "../utils/logger.js";
+import { validateCommand, validatePath } from "../security/validation.js";
+// Sensitive environment variables to strip
+const SENSITIVE_ENV_VARS = [
+    "SSH_AUTH_SOCK",
+    "AWS_ACCESS_KEY_ID",
+    "AWS_SECRET_ACCESS_KEY",
+    "AWS_SESSION_TOKEN",
+    "GITHUB_TOKEN",
+    "GITLAB_TOKEN",
+    "NPM_TOKEN",
+    "DOCKER_AUTH_CONFIG",
+    "KUBECONFIG",
+    "GOOGLE_APPLICATION_CREDENTIALS",
+    "AZURE_CLIENT_SECRET",
+];
+// Restricted PATH for sandbox
+const SANDBOX_PATH = "/usr/local/bin:/usr/bin:/bin";
+// Sandbox working directory
+const SANDBOX_DIR = "/tmp/swarm-sandbox";
+/**
+ * Terminal Tool
+ * Secure command execution
+ */
+export class TerminalTool {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            cwd: process.cwd(),
+            env: { ...process.env },
+            timeout: 60000, // 60 seconds
+            maxOutputSize: 1024 * 1024, // 1MB
+            shell: "/bin/bash",
+            securityPolicy: config.securityPolicy || {
+                id: "default",
+                name: "Default",
+                pathValidation: { enabled: true, allowedPaths: [], blockedPaths: [] },
+                commandValidation: { enabled: true, whitelist: [], blacklist: [], dangerousPatterns: [] },
+                rateLimit: { enabled: false, maxRequestsPerMinute: 0, maxRequestsPerHour: 0 },
+            },
+            sandboxEnabled: false,
+            ...config,
+        };
+    }
+    /**
+     * Execute a command
+     */
+    async execute(execution) {
+        const startTime = Date.now();
+        // Validate command
+        const commandValidation = validateCommand(execution.command, this.config.securityPolicy);
+        if (!commandValidation.valid) {
+            logToolExecution("terminal", "unknown", "unknown", 0, false, {
+                command: execution.command,
+                error: commandValidation.error,
+                blocked: true,
+            });
+            return {
+                success: false,
+                error: commandValidation.error,
+                blocked: true,
+            };
+        }
+        const sanitizedCommand = commandValidation.sanitized;
+        // Validate cwd if provided
+        let cwd = execution.cwd || this.config.cwd;
+        if (execution.cwd) {
+            const pathValidation = validatePath(execution.cwd, this.config.securityPolicy);
+            if (!pathValidation.valid) {
+                return {
+                    success: false,
+                    error: `Invalid working directory: ${pathValidation.error}`,
+                    blocked: true,
+                };
+            }
+            cwd = pathValidation.resolvedPath;
+        }
+        // Prepare environment
+        const env = { ...this.config.env, ...execution.env };
+        // Set timeout
+        const timeout = execution.timeout || this.config.timeout;
+        try {
+            const result = await this.runCommand(sanitizedCommand, execution.args || [], cwd, env, timeout);
+            const duration = Date.now() - startTime;
+            logToolExecution("terminal", "unknown", "unknown", duration, result.exitCode === 0, {
+                command: sanitizedCommand,
+                exitCode: result.exitCode,
+                outputSize: result.stdout.length + result.stderr.length,
+            });
+            return {
+                success: result.exitCode === 0,
+                result,
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logToolExecution("terminal", "unknown", "unknown", duration, false, {
+                command: sanitizedCommand,
+                error: errorMessage,
+            });
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Prepare sandboxed environment
+     */
+    prepareSandboxEnv(originalEnv) {
+        // Start with clean environment
+        const sandboxedEnv = {};
+        // Copy only safe environment variables
+        for (const [key, value] of Object.entries(originalEnv)) {
+            if (!SENSITIVE_ENV_VARS.includes(key)) {
+                sandboxedEnv[key] = value;
+            }
+        }
+        // Restrict PATH
+        sandboxedEnv.PATH = SANDBOX_PATH;
+        // Set sandbox directories
+        sandboxedEnv.HOME = SANDBOX_DIR;
+        sandboxedEnv.TMPDIR = SANDBOX_DIR;
+        sandboxedEnv.TMP = SANDBOX_DIR;
+        sandboxedEnv.TEMP = SANDBOX_DIR;
+        return sandboxedEnv;
+    }
+    /**
+     * Validate cwd against allowed paths
+     */
+    validateCwd(cwd) {
+        // Check for path traversal attempts
+        const resolved = cwd;
+        // Block dangerous paths
+        const blockedPaths = ["/", "/bin", "/sbin", "/usr/bin", "/usr/sbin", "/etc", "/var", "/sys", "/proc", "/dev"];
+        for (const blocked of blockedPaths) {
+            if (resolved === blocked || resolved.startsWith(blocked + "/")) {
+                return { valid: false, error: `Access to ${resolved} is not allowed` };
+            }
+        }
+        return { valid: true, resolvedPath: resolved };
+    }
+    /**
+     * Run command with spawn
+     */
+    runCommand(command, args, cwd, env, timeout) {
+        return new Promise((resolve, reject) => {
+            const startTime = Date.now();
+            let stdout = "";
+            let stderr = "";
+            let killed = false;
+            // Validate cwd
+            const cwdValidation = this.validateCwd(cwd);
+            if (!cwdValidation.valid) {
+                reject(new Error(cwdValidation.error));
+                return;
+            }
+            // Prepare environment (sandbox if enabled)
+            let finalEnv = env;
+            if (this.config.sandboxEnabled) {
+                finalEnv = this.prepareSandboxEnv(env);
+                logger.debug("Running in sandbox mode", {
+                    category: "tool",
+                    command,
+                    cwd: cwdValidation.resolvedPath,
+                });
+            }
+            // Prepare spawn options
+            const spawnOptions = {
+                cwd: cwdValidation.resolvedPath,
+                env: finalEnv,
+                shell: this.config.shell,
+                stdio: ["pipe", "pipe", "pipe"],
+                detached: this.config.sandboxEnabled, // Process group isolation in sandbox mode
+            };
+            const child = spawn(command, args, spawnOptions);
+            // Set timeout
+            const timeoutId = setTimeout(() => {
+                killed = true;
+                // Kill entire process group if detached (sandbox mode)
+                if (this.config.sandboxEnabled && child.pid) {
+                    try {
+                        process.kill(-child.pid, "SIGTERM");
+                    }
+                    catch {
+                        // Fallback to single process kill
+                        child.kill("SIGTERM");
+                    }
+                }
+                else {
+                    child.kill("SIGTERM");
+                }
+                // Force kill after 5 seconds
+                setTimeout(() => {
+                    if (!child.killed && child.pid) {
+                        if (this.config.sandboxEnabled) {
+                            try {
+                                process.kill(-child.pid, "SIGKILL");
+                            }
+                            catch {
+                                child.kill("SIGKILL");
+                            }
+                        }
+                        else {
+                            child.kill("SIGKILL");
+                        }
+                    }
+                }, 5000);
+            }, timeout);
+            // Collect stdout
+            child.stdout?.on("data", (data) => {
+                const chunk = data.toString();
+                if (stdout.length + chunk.length > this.config.maxOutputSize) {
+                    stdout += chunk.substring(0, this.config.maxOutputSize - stdout.length);
+                    stdout += "\n[Output truncated: exceeded max size]";
+                    if (!killed) {
+                        killed = true;
+                        child.kill();
+                    }
+                }
+                else {
+                    stdout += chunk;
+                }
+            });
+            // Collect stderr
+            child.stderr?.on("data", (data) => {
+                const chunk = data.toString();
+                if (stderr.length + chunk.length > this.config.maxOutputSize) {
+                    stderr += chunk.substring(0, this.config.maxOutputSize - stderr.length);
+                    stderr += "\n[Error output truncated]";
+                }
+                else {
+                    stderr += chunk;
+                }
+            });
+            // Handle process completion
+            child.on("close", (exitCode) => {
+                clearTimeout(timeoutId);
+                const executionTime = Date.now() - startTime;
+                resolve({
+                    stdout: stdout.trim(),
+                    stderr: stderr.trim(),
+                    exitCode: exitCode ?? -1,
+                    executionTime,
+                });
+            });
+            // Handle errors
+            child.on("error", (error) => {
+                clearTimeout(timeoutId);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Execute a simple command (no args)
+     */
+    async run(command, options = {}) {
+        const result = await this.execute({
+            command,
+            cwd: options.cwd,
+            env: options.env,
+            timeout: options.timeout,
+        });
+        if (result.success && result.result) {
+            return {
+                success: true,
+                output: result.result.stdout || result.result.stderr,
+            };
+        }
+        return {
+            success: false,
+            error: result.error || result.result?.stderr || "Unknown error",
+        };
+    }
+    /**
+     * Check if a command exists
+     */
+    async commandExists(command) {
+        try {
+            const result = await this.run(`which ${command}`, { timeout: 5000 });
+            return result.success && !!result.output;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get system information
+     */
+    async getSystemInfo() {
+        try {
+            return {
+                success: true,
+                info: {
+                    platform: process.platform,
+                    arch: process.arch,
+                    nodeVersion: process.version,
+                    shell: this.config.shell,
+                    cwd: this.config.cwd,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Execute piped commands
+     */
+    async pipe(commands) {
+        if (commands.length === 0) {
+            return { success: false, error: "No commands provided" };
+        }
+        if (commands.length === 1) {
+            const cmd = commands[0];
+            if (!cmd) {
+                return { success: false, error: "Empty command" };
+            }
+            return this.execute({ command: cmd });
+        }
+        // Combine commands with pipes
+        const pipedCommand = commands.join(" | ");
+        return this.execute({ command: pipedCommand });
+    }
+    /**
+     * Execute script from file
+     */
+    async executeScript(scriptPath, args = []) {
+        // Validate script path
+        const pathValidation = validatePath(scriptPath, this.config.securityPolicy);
+        if (!pathValidation.valid || !pathValidation.resolvedPath) {
+            return { success: false, error: pathValidation.error || "Invalid path" };
+        }
+        // Determine interpreter based on extension
+        const ext = scriptPath.split(".").pop()?.toLowerCase() || "";
+        let interpreter = "";
+        switch (ext) {
+            case "sh":
+                interpreter = "bash";
+                break;
+            case "py":
+                interpreter = "python3";
+                break;
+            case "js":
+                interpreter = "node";
+                break;
+            case "ts":
+                interpreter = "ts-node";
+                break;
+            default:
+                interpreter = "bash";
+        }
+        const command = `${interpreter} ${pathValidation.resolvedPath}`;
+        return this.execute({ command, args });
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/tools/terminal.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,306 @@
+/**
+ * Core Types for Swarm MCP Enterprise
+ * Enterprise-Grade Type Definitions
+ */
+import { z } from "zod";
+export declare const AgentTypeSchema: z.ZodEnum<["product_manager", "architect", "engineer", "qa", "reviewer"]>;
+export type AgentType = z.infer<typeof AgentTypeSchema>;
+export declare const AgentModeSchema: z.ZodEnum<["plan", "edit", "ralph"]>;
+export type AgentMode = z.infer<typeof AgentModeSchema>;
+export declare const AgentStatusSchema: z.ZodEnum<["idle", "busy", "completed", "error", "terminated"]>;
+export type AgentStatus = z.infer<typeof AgentStatusSchema>;
+export interface Agent {
+    id: string;
+    type: AgentType;
+    name: string;
+    mode: AgentMode;
+    status: AgentStatus;
+    currentTask?: string;
+    capabilities: string[];
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    lastActiveAt: string;
+    healthCheckAt?: string;
+}
+export interface AgentConfig {
+    type: AgentType;
+    name?: string;
+    mode?: AgentMode;
+    capabilities?: string[];
+    metadata?: Record<string, unknown>;
+}
+export declare const TaskStatusSchema: z.ZodEnum<["pending", "in_progress", "completed", "failed", "cancelled"]>;
+export type TaskStatus = z.infer<typeof TaskStatusSchema>;
+export interface Task {
+    id: string;
+    agentId: string;
+    type: string;
+    description: string;
+    context: Record<string, unknown>;
+    status: TaskStatus;
+    priority: number;
+    result?: unknown;
+    error?: string;
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    timeout: number;
+}
+export interface TaskConfig {
+    agentId: string;
+    type: string;
+    description: string;
+    context?: Record<string, unknown>;
+    priority?: number;
+    timeout?: number;
+}
+export declare const ThoughtStatusSchema: z.ZodEnum<["active", "revised", "branched", "merged", "discarded"]>;
+export type ThoughtStatus = z.infer<typeof ThoughtStatusSchema>;
+export interface Thought {
+    id: string;
+    chainId: string;
+    step: number;
+    content: string;
+    reasoning: string;
+    confidence: number;
+    status: ThoughtStatus;
+    parentThoughtId?: string;
+    branchIds: string[];
+    metadata: {
+        agentId: string;
+        taskId: string;
+        timestamp: string;
+        revisionOf?: string;
+    };
+}
+export interface ThoughtChain {
+    id: string;
+    agentId: string;
+    taskId: string;
+    title: string;
+    thoughts: Thought[];
+    branches: Map<string, Thought[]>;
+    currentStep: number;
+    status: "active" | "completed" | "paused";
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SequentialThinkingConfig {
+    enableBranching: boolean;
+    enableRevision: boolean;
+    maxSteps: number;
+    minConfidence: number;
+    autoSummarize: boolean;
+}
+export interface IntentClassification {
+    intent: string;
+    confidence: number;
+    category: "create" | "modify" | "analyze" | "review" | "execute";
+    complexity: "simple" | "medium" | "complex";
+    requiredCapabilities: string[];
+}
+export interface RoutingDecision {
+    targetAgent: AgentType;
+    confidence: number;
+    reasoning: string;
+    alternativeAgents: Array<{
+        type: AgentType;
+        confidence: number;
+    }>;
+    suggestedMode: AgentMode;
+    estimatedComplexity: number;
+}
+export interface AutoRouterConfig {
+    minConfidence: number;
+    enableFallback: boolean;
+    complexityThreshold: {
+        simple: number;
+        medium: number;
+        complex: number;
+    };
+}
+export declare const ToolTypeSchema: z.ZodEnum<["filesystem", "terminal", "git", "http", "custom"]>;
+export type ToolType = z.infer<typeof ToolTypeSchema>;
+export interface Tool {
+    id: string;
+    type: ToolType;
+    name: string;
+    description: string;
+    capabilities: string[];
+    requiredMode: AgentMode[];
+    config: ToolConfig;
+}
+export interface ToolConfig {
+    timeout: number;
+    allowedPaths?: string[];
+    blockedCommands?: string[];
+    allowedCommands?: string[];
+    maxOutputSize: number;
+    sandboxEnabled: boolean;
+}
+export interface ToolExecution {
+    id: string;
+    toolId: string;
+    agentId: string;
+    taskId: string;
+    command: string;
+    args: unknown[];
+    result?: unknown;
+    error?: string;
+    status: "pending" | "running" | "completed" | "failed" | "blocked";
+    startedAt: string;
+    completedAt?: string;
+    executionTime: number;
+}
+export interface Context {
+    id: string;
+    agentId: string;
+    messages: ContextMessage[];
+    artifacts: Artifact[];
+    checkpoints: Checkpoint[];
+    summary?: string;
+    tokenCount: number;
+    maxTokens: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ContextMessage {
+    id: string;
+    role: "system" | "user" | "assistant" | "tool";
+    content: string;
+    timestamp: string;
+    metadata?: Record<string, unknown>;
+}
+export interface Artifact {
+    id: string;
+    type: "file" | "code" | "document" | "data";
+    name: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+export interface Checkpoint {
+    id: string;
+    contextId: string;
+    sequence: number;
+    messages: ContextMessage[];
+    artifacts: Artifact[];
+    thoughtChainId?: string;
+    createdAt: string;
+}
+export interface HandoffContext {
+    id: string;
+    fromAgentId: string;
+    toAgentId: string;
+    taskId: string;
+    contextSnapshot: {
+        messages: ContextMessage[];
+        artifacts: Artifact[];
+        thoughtChain?: ThoughtChain;
+    };
+    notes?: string;
+    timestamp: string;
+}
+export interface ParallelTask {
+    id: string;
+    taskId: string;
+    agentId: string;
+    status: TaskStatus;
+    result?: unknown;
+    error?: string;
+    startedAt?: string;
+    completedAt?: string;
+}
+export interface ParallelExecution {
+    id: string;
+    batchId: string;
+    tasks: ParallelTask[];
+    maxConcurrency: number;
+    status: "pending" | "running" | "completed" | "partial" | "failed";
+    results: Map<string, unknown>;
+    aggregatedReport?: string;
+    createdAt: string;
+    completedAt?: string;
+}
+export interface SecurityPolicy {
+    id: string;
+    name: string;
+    pathValidation: {
+        enabled: boolean;
+        allowedPaths: string[];
+        blockedPaths: string[];
+    };
+    commandValidation: {
+        enabled: boolean;
+        whitelist: string[];
+        blacklist: string[];
+        dangerousPatterns: RegExp[];
+    };
+    rateLimit: {
+        enabled: boolean;
+        maxRequestsPerMinute: number;
+        maxRequestsPerHour: number;
+    };
+}
+export interface AuditLog {
+    id: string;
+    timestamp: string;
+    level: "info" | "warn" | "error" | "security";
+    category: string;
+    agentId?: string;
+    taskId?: string;
+    action: string;
+    details: Record<string, unknown>;
+    ip?: string;
+    userAgent?: string;
+}
+export interface AuthConfig {
+    enabled: boolean;
+    tokens: string[];
+}
+export interface SystemConfig {
+    maxAgents: number;
+    defaultAgentMode: AgentMode;
+    healthCheckInterval: number;
+    agentTimeout: number;
+    sequentialThinking: SequentialThinkingConfig;
+    autoRouting: AutoRouterConfig;
+    contextMaxTokens: number;
+    contextAutoSummarizeThreshold: number;
+    checkpointInterval: number;
+    maxParallelTasks: number;
+    defaultParallelism: number;
+    toolTimeout: number;
+    maxToolOutputSize: number;
+    securityPolicy: SecurityPolicy;
+    auth: AuthConfig;
+    logLevel: "debug" | "info" | "warn" | "error";
+    logFormat: "json" | "pretty";
+    auditLogRetention: number;
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+    meta?: {
+        timestamp: string;
+        requestId: string;
+        duration: number;
+    };
+}
+export interface PaginatedResponse<T> extends ApiResponse<T> {
+    meta?: {
+        timestamp: string;
+        requestId: string;
+        duration: number;
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+//# sourceMappingURL=index.d.ts.map