concevent-ai-agent-sdk 2.2.0 → 2.3.0

package/dist/tools/utils/shell.js

@@ -0,0 +1,232 @@
+import { spawn } from 'child_process';
+import * as os from 'os';
+/**
+ * Default dangerous command patterns that should be blocked
+ */
+export const DEFAULT_BLOCKED_COMMANDS = [
+    /rm\s+(-rf?|--recursive)\s+[/\\]/i, // rm -rf /
+    /rm\s+(-rf?|--recursive)\s+\*/i, // rm -rf *
+    /mkfs\./i, // mkfs commands
+    /dd\s+if=/i, // dd commands
+    /:\s*\(\s*\)\s*\{/i, // Fork bombs
+    />\s*\/dev\/sd[a-z]/i, // Writing to block devices
+    /chmod\s+(-R\s+)?777\s+\//i, // chmod 777 /
+    /chown\s+(-R\s+)?root/i, // chown root
+];
+/**
+ * Gets the appropriate shell command for the current platform
+ */
+export function getShellCommand() {
+    const platform = os.platform();
+    if (platform === 'win32') {
+        // Use cmd.exe on Windows
+        return {
+            shell: process.env.COMSPEC || 'cmd.exe',
+            args: ['/c'],
+        };
+    }
+    // Use bash on Unix-like systems, fallback to sh
+    const shell = process.env.SHELL || '/bin/bash';
+    // Check if the shell exists, fallback to sh
+    return {
+        shell: shell.includes('bash') ? shell : '/bin/sh',
+        args: ['-c'],
+    };
+}
+/**
+ * Checks if a command matches any blocked patterns
+ */
+export function isCommandBlocked(command, blockedPatterns) {
+    const patterns = blockedPatterns || DEFAULT_BLOCKED_COMMANDS;
+    for (const pattern of patterns) {
+        if (pattern.test(command)) {
+            return `Command blocked by security policy: matches pattern ${pattern.toString()}`;
+        }
+    }
+    return null;
+}
+/**
+ * Executes a shell command and returns the result
+ */
+export async function executeCommand(command, options = {}) {
+    const { cwd, timeout = 30000, env, abortSignal } = options;
+    const { shell, args } = getShellCommand();
+    return new Promise((resolve, reject) => {
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        let settled = false;
+        const child = spawn(shell, [...args, command], {
+            cwd,
+            env: { ...process.env, ...env },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Set up timeout
+        const timeoutId = timeout > 0
+            ? setTimeout(() => {
+                if (!settled) {
+                    timedOut = true;
+                    child.kill('SIGTERM');
+                    // Give it a moment to terminate gracefully, then force kill
+                    setTimeout(() => {
+                        if (!settled) {
+                            child.kill('SIGKILL');
+                        }
+                    }, 1000);
+                }
+            }, timeout)
+            : null;
+        // Handle abort signal
+        const abortHandler = () => {
+            if (!settled) {
+                child.kill('SIGTERM');
+            }
+        };
+        if (abortSignal) {
+            abortSignal.addEventListener('abort', abortHandler, { once: true });
+        }
+        child.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('close', (code) => {
+            settled = true;
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (abortSignal) {
+                abortSignal.removeEventListener('abort', abortHandler);
+            }
+            resolve({
+                stdout: stdout.trim(),
+                stderr: stderr.trim(),
+                exitCode: code ?? (timedOut ? 124 : 1),
+                timedOut,
+            });
+        });
+        child.on('error', (error) => {
+            settled = true;
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (abortSignal) {
+                abortSignal.removeEventListener('abort', abortHandler);
+            }
+            reject(error);
+        });
+    });
+}
+/**
+ * Creates a ProcessManager for managing background processes
+ */
+export function createProcessManager() {
+    const processes = new Map();
+    return {
+        get(id) {
+            const entry = processes.get(id);
+            return entry?.info;
+        },
+        getAll() {
+            return Array.from(processes.values()).map((entry) => entry.info);
+        },
+        async kill(id) {
+            const entry = processes.get(id);
+            if (!entry) {
+                return false;
+            }
+            if (entry.info.running) {
+                entry.process.kill('SIGTERM');
+                // Wait a moment for graceful shutdown
+                await new Promise((resolve) => setTimeout(resolve, 100));
+                if (entry.info.running) {
+                    entry.process.kill('SIGKILL');
+                }
+            }
+            processes.delete(id);
+            return true;
+        },
+        async cleanup() {
+            const ids = Array.from(processes.keys());
+            await Promise.all(ids.map((id) => this.kill(id)));
+        },
+    };
+}
+/**
+ * Spawns a background process and registers it with the ProcessManager
+ */
+export function spawnBackgroundProcess(command, processManager, options = {}) {
+    const { cwd, env } = options;
+    const { shell, args } = getShellCommand();
+    // Generate a unique ID
+    const id = `bg_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    const info = {
+        id,
+        command,
+        startTime: new Date(),
+        stdout: '',
+        stderr: '',
+        exitCode: null,
+        running: true,
+    };
+    const child = spawn(shell, [...args, command], {
+        cwd,
+        env: { ...process.env, ...env },
+        stdio: ['pipe', 'pipe', 'pipe'],
+        detached: false,
+    });
+    child.stdout?.on('data', (data) => {
+        info.stdout += data.toString();
+    });
+    child.stderr?.on('data', (data) => {
+        info.stderr += data.toString();
+    });
+    child.on('close', (code) => {
+        info.exitCode = code;
+        info.running = false;
+    });
+    child.on('error', () => {
+        info.running = false;
+        info.exitCode = 1;
+    });
+    // Register with the process manager (internal method)
+    // We need to access the internal map through a workaround
+    // The ProcessManager returned by createProcessManager has closure access
+    processManager._processes?.set(id, { process: child, info });
+    return info;
+}
+/**
+ * Creates a ProcessManager with internal registration capability
+ */
+export function createProcessManagerWithInternal() {
+    const processes = new Map();
+    return {
+        _processes: processes,
+        get(id) {
+            const entry = processes.get(id);
+            return entry?.info;
+        },
+        getAll() {
+            return Array.from(processes.values()).map((entry) => entry.info);
+        },
+        async kill(id) {
+            const entry = processes.get(id);
+            if (!entry) {
+                return false;
+            }
+            if (entry.info.running) {
+                entry.process.kill('SIGTERM');
+                await new Promise((resolve) => setTimeout(resolve, 100));
+                if (entry.info.running) {
+                    entry.process.kill('SIGKILL');
+                }
+            }
+            processes.delete(id);
+            return true;
+        },
+        async cleanup() {
+            const ids = Array.from(processes.keys());
+            await Promise.all(ids.map((id) => this.kill(id)));
+        },
+    };
+}
+//# sourceMappingURL=shell.js.map

package/dist/tools/utils/shell.js.map

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

package/dist/tools/write.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types/index.js';
+import type { ToolConfig } from './types.js';
+/**
+ * Schema for the Write tool parameters
+ */
+export declare const writeSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    file_path: string;
+}, {
+    content: string;
+    file_path: string;
+}>;
+export type WriteParams = z.infer<typeof writeSchema>;
+/**
+ * Creates the Write tool for creating or overwriting files
+ */
+export declare function createWriteTool(config?: ToolConfig): ToolDefinition;
+//# sourceMappingURL=write.d.ts.map

package/dist/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;EAOtB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,UAAe,GAAG,cAAc,CAwDvE"}

package/dist/tools/write.js

@@ -0,0 +1,70 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { resolvePath, isPathAllowed, isPathSafe, ensureDirectory } from './utils/path.js';
+/**
+ * Schema for the Write tool parameters
+ */
+export const writeSchema = z.object({
+    file_path: z
+        .string()
+        .describe('The path to the file to write. Can be absolute or relative to working directory.'),
+    content: z
+        .string()
+        .describe('The content to write to the file. This will overwrite any existing content.'),
+});
+/**
+ * Creates the Write tool for creating or overwriting files
+ */
+export function createWriteTool(config = {}) {
+    const workingDirectory = config.workingDirectory || process.cwd();
+    return {
+        declaration: {
+            name: 'Write',
+            description: `Creates a new file or overwrites an existing file with the specified content.
+Parent directories are created automatically if they don't exist.
+WARNING: This will completely overwrite existing file contents.`,
+            parametersJsonSchema: zodToJsonSchema(writeSchema),
+        },
+        executor: async (args) => {
+            const params = writeSchema.parse(args);
+            const resolvedPath = resolvePath(params.file_path, workingDirectory);
+            // Security checks
+            if (!isPathSafe(params.file_path, workingDirectory)) {
+                throw new Error(`Path traversal detected: ${params.file_path}`);
+            }
+            if (!isPathAllowed(resolvedPath, config.allowedPaths)) {
+                throw new Error(`Access denied: ${params.file_path} is outside allowed paths`);
+            }
+            // Check if it's a directory
+            try {
+                const stat = await fs.stat(resolvedPath);
+                if (stat.isDirectory()) {
+                    throw new Error(`Cannot write to a directory: ${params.file_path}`);
+                }
+            }
+            catch (error) {
+                // File doesn't exist yet, that's fine
+                if (error.code !== 'ENOENT') {
+                    throw error;
+                }
+            }
+            // Ensure parent directory exists
+            const parentDir = path.dirname(resolvedPath);
+            await ensureDirectory(parentDir);
+            // Write the file
+            await fs.writeFile(resolvedPath, params.content, 'utf-8');
+            // Get file stats for confirmation
+            const stat = await fs.stat(resolvedPath);
+            return {
+                success: true,
+                file_path: params.file_path,
+                bytes_written: stat.size,
+                message: `Successfully wrote ${stat.size} bytes to ${params.file_path}`,
+            };
+        },
+        parallel: false, // Writing should be sequential to avoid conflicts
+    };
+}
+//# sourceMappingURL=write.js.map

package/dist/tools/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE1F;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,kFAAkF,CAAC;IAC/F,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,6EAA6E,CAAC;CAC3F,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAqB,EAAE;IACrD,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAElE,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,OAAO;YACb,WAAW,EAAE;;gEAE6C;YAC1D,oBAAoB,EAAE,eAAe,CAAC,WAAW,CAAC;SACnD;QACD,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YAErE,kBAAkB;YAClB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAClE,CAAC;YAED,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,SAAS,2BAA2B,CAAC,CAAC;YACjF,CAAC;YAED,4BAA4B;YAC5B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACzC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,sCAAsC;gBACtC,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACnD,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YAED,iCAAiC;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAC7C,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;YAEjC,iBAAiB;YACjB,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE1D,kCAAkC;YAClC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAEzC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,aAAa,EAAE,IAAI,CAAC,IAAI;gBACxB,OAAO,EAAE,sBAAsB,IAAI,CAAC,IAAI,aAAa,MAAM,CAAC,SAAS,EAAE;aACxE,CAAC;QACJ,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,kDAAkD;KACpE,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "concevent-ai-agent-sdk",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Framework-agnostic AI Agent SDK with tool calling, conversation management, and automatic summarization",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,7 +24,7 @@
     "typecheck": "tsc --noEmit",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "prepublishOnly": "npm install && npm run build && npm run test"
+    "prepublishOnly": "npm install && npm run build && npm run test && npm run format:check"
   },
   "keywords": [
     "ai",