@stan-chen/simple-cli 0.2.5 → 0.2.6

package/dist/builtins.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+export declare const cleanupProcesses: () => void;
 export declare const readFiles: {
     name: string;
     description: string;
@@ -255,21 +256,37 @@ export declare const runCommand: {
     inputSchema: z.ZodObject<{
         command: z.ZodString;
         timeout: z.ZodOptional<z.ZodNumber>;
+        background: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         command: string;
+        background: boolean;
         timeout?: number | undefined;
     }, {
         command: string;
         timeout?: number | undefined;
+        background?: boolean | undefined;
     }>;
-    execute: ({ command, timeout }: {
+    execute: ({ command, timeout, background }: {
         command: string;
         timeout?: number;
+        background: boolean;
     }) => Promise<{
+        message: string;
+        pid: number | undefined;
+        success: boolean;
+        stdout?: undefined;
+        stderr?: undefined;
+        exitCode?: undefined;
+        timedOut?: undefined;
+        error?: undefined;
+    } | {
         stdout: string;
         stderr: string;
         exitCode: number;
         timedOut: boolean;
+        message?: undefined;
+        pid?: undefined;
+        success?: undefined;
         error?: undefined;
     } | {
         error: any;
@@ -277,7 +294,24 @@ export declare const runCommand: {
         stderr: any;
         exitCode: any;
         timedOut: any;
+        message?: undefined;
+        pid?: undefined;
+        success?: undefined;
+    }>;
+};
+export declare const stopCommand: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        pid: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        pid: number;
+    }, {
+        pid: number;
     }>;
+    execute: ({ pid }: {
+        pid: number;
+    }) => Promise<string>;
 };
 export declare const deleteFile: {
     name: string;
@@ -617,21 +651,37 @@ export declare const allBuiltins: ({
     inputSchema: z.ZodObject<{
         command: z.ZodString;
         timeout: z.ZodOptional<z.ZodNumber>;
+        background: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         command: string;
+        background: boolean;
         timeout?: number | undefined;
     }, {
         command: string;
         timeout?: number | undefined;
+        background?: boolean | undefined;
     }>;
-    execute: ({ command, timeout }: {
+    execute: ({ command, timeout, background }: {
         command: string;
         timeout?: number;
+        background: boolean;
     }) => Promise<{
+        message: string;
+        pid: number | undefined;
+        success: boolean;
+        stdout?: undefined;
+        stderr?: undefined;
+        exitCode?: undefined;
+        timedOut?: undefined;
+        error?: undefined;
+    } | {
         stdout: string;
         stderr: string;
         exitCode: number;
         timedOut: boolean;
+        message?: undefined;
+        pid?: undefined;
+        success?: undefined;
         error?: undefined;
     } | {
         error: any;
@@ -639,7 +689,23 @@ export declare const allBuiltins: ({
         stderr: any;
         exitCode: any;
         timedOut: any;
+        message?: undefined;
+        pid?: undefined;
+        success?: undefined;
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        pid: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        pid: number;
+    }, {
+        pid: number;
     }>;
+    execute: ({ pid }: {
+        pid: number;
+    }) => Promise<string>;
 } | {
     name: string;
     description: string;

package/dist/builtins.js

@@ -1,11 +1,39 @@
 import { readFile, writeFile, readdir, unlink, mkdir, stat } from 'fs/promises';
 import { existsSync } from 'fs';
 import { join, resolve, relative, extname } from 'path';
-import { exec } from 'child_process';
+import { exec, spawn, execSync } from 'child_process';
 import { promisify } from 'util';
 import { z } from 'zod';
 import glob from 'fast-glob';
 const execAsync = promisify(exec);
+const activeProcesses = [];
+export const cleanupProcesses = () => {
+    for (const proc of activeProcesses) {
+        if (!proc.killed && proc.pid) {
+            if (process.platform === 'win32') {
+                try {
+                    execSync(`taskkill /F /T /PID ${proc.pid}`);
+                }
+                catch {
+                    proc.kill('SIGTERM');
+                }
+            }
+            else {
+                proc.kill('SIGTERM');
+            }
+        }
+    }
+};
+// Handle cleanup on exit
+process.on('exit', cleanupProcesses);
+process.on('SIGINT', () => {
+    cleanupProcesses();
+    process.exit();
+});
+process.on('SIGTERM', () => {
+    cleanupProcesses();
+    process.exit();
+});
 export const readFiles = {
     name: 'read_files',
     description: 'Read contents of one or more files',
@@ -331,9 +359,27 @@ export const listDir = {
 };
 export const runCommand = {
     name: 'run_command',
-    description: 'Run a shell command',
-    inputSchema: z.object({ command: z.string(), timeout: z.number().optional() }),
-    execute: async ({ command, timeout }) => {
+    description: 'Run a shell command. Use background: true for servers or long-running tasks.',
+    inputSchema: z.object({
+        command: z.string(),
+        timeout: z.number().optional(),
+        background: z.boolean().default(false).describe('Run command in background and return immediately')
+    }),
+    execute: async ({ command, timeout, background }) => {
+        if (background) {
+            const child = spawn(command, {
+                shell: true,
+                detached: true,
+                stdio: 'ignore'
+            });
+            child.unref();
+            activeProcesses.push(child);
+            return {
+                message: `Started background process: ${command}`,
+                pid: child.pid,
+                success: true
+            };
+        }
         try {
             const { stdout, stderr } = await execAsync(command, { timeout });
             return { stdout, stderr, exitCode: 0, timedOut: false };
@@ -350,6 +396,31 @@ export const runCommand = {
         }
     }
 };
+export const stopCommand = {
+    name: 'stop_command',
+    description: 'Stop a background process by its PID',
+    inputSchema: z.object({ pid: z.number() }),
+    execute: async ({ pid }) => {
+        if (process.platform === 'win32') {
+            try {
+                await execAsync(`taskkill /F /T /PID ${pid}`);
+                return `Successfully stopped process ${pid}`;
+            }
+            catch (e) {
+                return `Error stopping process ${pid}: ${e.message}`;
+            }
+        }
+        else {
+            try {
+                process.kill(pid, 'SIGTERM');
+                return `Sent SIGTERM to process ${pid}`;
+            }
+            catch (e) {
+                return `Error stopping process ${pid}: ${e.message}`;
+            }
+        }
+    }
+};
 export const deleteFile = {
     name: 'delete_file',
     description: 'Delete a file',
@@ -478,4 +549,4 @@ export const getTrackedFiles = async (cwd) => {
         return [];
     }
 };
-export const allBuiltins = [readFiles, writeFiles, createTool, scrapeUrl, listFiles, searchFiles, listDir, runCommand, deleteFile, gitTool, linter];
+export const allBuiltins = [readFiles, writeFiles, createTool, scrapeUrl, listFiles, searchFiles, listDir, runCommand, stopCommand, deleteFile, gitTool, linter];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stan-chen/simple-cli",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "A lean, lightweight coding agent. Packs a punch with token efficiency.",
   "type": "module",
   "main": "dist/cli.js",