terminal-commands 0.1.2 → 0.1.3

package/README.md

@@ -18,6 +18,11 @@ approval prompts are enabled.
 
 Command-line programs still execute with your operating-system user permissions. A program can access more than the dedicated filesystem tools, so review every command approval carefully.
 
+The MCP command surface exposes process lifecycle operations separately: `start_process` starts
+an approved executable and returns a session ID, `read_process_output` reads bounded output,
+`list_processes` lists sessions, and `terminate_process` stops a session. This keeps terminal
+workflows available while making each model-callable operation explicit.
+
 ## Run
 
 ```bash

package/dist/agent.js

@@ -35480,7 +35480,11 @@ var import_websocket_server = __toESM(require_websocket_server(), 1);
 var wrapper_default = import_websocket.default;
 
 // src/agent-core.ts
-var destructiveTools = /* @__PURE__ */ new Set(["run_program", "write_text_file"]);
+var destructiveTools = /* @__PURE__ */ new Set([
+  "start_process",
+  "terminate_process",
+  "write_text_file"
+]);
 var requestSchema = external_exports.object({
   type: external_exports.literal("request"),
   requestId: external_exports.string().uuid(),
@@ -35488,7 +35492,10 @@ var requestSchema = external_exports.object({
     "get_system_info",
     "list_directory",
     "read_text_file",
-    "run_program",
+    "start_process",
+    "read_process_output",
+    "terminate_process",
+    "list_processes",
     "write_text_file"
   ]),
   arguments: external_exports.record(external_exports.string(), external_exports.unknown())
@@ -35668,12 +35675,15 @@ function approvalSummary(tool, args) {
     const bytes = Buffer.byteLength(String(args.contents ?? ""));
     return `Write ${bytes} bytes to ${String(args.path ?? "an unknown path")}${args.overwrite ? " (overwrite)" : ""}`;
   }
-  if (tool === "run_program") {
+  if (tool === "start_process") {
     const command = [
       String(args.program ?? ""),
       ...Array.isArray(args.args) ? args.args.map(String) : []
     ];
-    return `Run: ${command.join(" ")}`;
+    return `Start: ${command.join(" ")}`;
+  }
+  if (tool === "terminate_process") {
+    return `Terminate process session ${String(args.sessionId ?? "")}`;
   }
   return `Run destructive tool: ${tool}`;
 }

package/dist/cli.js

@@ -35487,7 +35487,11 @@ var import_websocket_server = __toESM(require_websocket_server(), 1);
 var wrapper_default = import_websocket.default;
 
 // src/agent-core.ts
-var destructiveTools = /* @__PURE__ */ new Set(["run_program", "write_text_file"]);
+var destructiveTools = /* @__PURE__ */ new Set([
+  "start_process",
+  "terminate_process",
+  "write_text_file"
+]);
 var requestSchema = external_exports.object({
   type: external_exports.literal("request"),
   requestId: external_exports.string().uuid(),
@@ -35495,7 +35499,10 @@ var requestSchema = external_exports.object({
     "get_system_info",
     "list_directory",
     "read_text_file",
-    "run_program",
+    "start_process",
+    "read_process_output",
+    "terminate_process",
+    "list_processes",
     "write_text_file"
   ]),
   arguments: external_exports.record(external_exports.string(), external_exports.unknown())
@@ -35691,12 +35698,15 @@ function approvalSummary(tool, args) {
     const bytes = Buffer.byteLength(String(args.contents ?? ""));
     return `Write ${bytes} bytes to ${String(args.path ?? "an unknown path")}${args.overwrite ? " (overwrite)" : ""}`;
   }
-  if (tool === "run_program") {
+  if (tool === "start_process") {
     const command = [
       String(args.program ?? ""),
       ...Array.isArray(args.args) ? args.args.map(String) : []
     ];
-    return `Run: ${command.join(" ")}`;
+    return `Start: ${command.join(" ")}`;
+  }
+  if (tool === "terminate_process") {
+    return `Terminate process session ${String(args.sessionId ?? "")}`;
   }
   return `Run destructive tool: ${tool}`;
 }

package/dist/index.js

@@ -62498,9 +62498,30 @@ var EMPTY_COMPLETION_RESULT = {
   }
 };
 
-// src/runner.ts
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
+// src/file-reader.ts
+import { open as open2 } from "node:fs/promises";
+async function readBoundedTextFile(filename, maxCharacters) {
+  const handle = await open2(filename, "r");
+  try {
+    const stats = await handle.stat();
+    const buffer = Buffer.allocUnsafe(maxCharacters * 4 + 4);
+    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+    const hasUnreadBytes = bytesRead < stats.size;
+    const decoded = new TextDecoder().decode(buffer.subarray(0, bytesRead), {
+      stream: hasUnreadBytes
+    });
+    return {
+      contents: decoded.slice(0, maxCharacters),
+      truncated: hasUnreadBytes || decoded.length > maxCharacters
+    };
+  } finally {
+    await handle.close();
+  }
+}
+
+// src/process-manager.ts
+import { randomUUID } from "node:crypto";
+import { spawn } from "node:child_process";
 
 // src/security.ts
 import { constants as constants2 } from "node:fs";
@@ -62590,59 +62611,144 @@ function assertProgramAllowed(program) {
   }
 }
 
-// src/runner.ts
-var execFileAsync = promisify(execFile);
-async function runProgram(options) {
-  assertProgramAllowed(options.program);
-  try {
-    const { stdout, stderr } = await execFileAsync(
-      options.program,
-      options.args,
-      {
-        cwd: options.cwd,
-        env: safeEnvironment(),
-        encoding: "utf8",
-        maxBuffer: options.maxOutputChars,
-        timeout: options.timeoutMs,
-        windowsHide: true
-      }
-    );
-    return { exitCode: 0, signal: null, stdout, stderr, timedOut: false };
-  } catch (error62) {
-    const failure2 = error62;
-    return {
-      exitCode: typeof failure2.code === "number" ? failure2.code : null,
-      signal: failure2.signal ?? null,
-      stdout: failure2.stdout ?? "",
-      stderr: failure2.stderr ?? failure2.message,
-      timedOut: failure2.killed === true && failure2.signal === "SIGTERM"
-    };
-  }
+// src/process-manager.ts
+function appendBounded(current, value, limit) {
+  if (current.length >= limit) return current;
+  return `${current}${value.toString("utf8")}`.slice(0, limit);
 }
-
-// src/file-reader.ts
-import { open as open2 } from "node:fs/promises";
-async function readBoundedTextFile(filename, maxCharacters) {
-  const handle = await open2(filename, "r");
-  try {
-    const stats = await handle.stat();
-    const buffer = Buffer.allocUnsafe(maxCharacters * 4 + 4);
-    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
-    const hasUnreadBytes = bytesRead < stats.size;
-    const decoded = new TextDecoder().decode(buffer.subarray(0, bytesRead), {
-      stream: hasUnreadBytes
+function snapshot(session) {
+  return {
+    sessionId: session.sessionId,
+    program: session.program,
+    args: session.args,
+    cwd: session.cwd,
+    pid: session.child.pid ?? null,
+    running: session.running,
+    exitCode: session.exitCode,
+    signal: session.signal,
+    stdout: session.stdout,
+    stderr: session.stderr,
+    timedOut: session.timedOut
+  };
+}
+var ProcessManager = class {
+  #sessions = /* @__PURE__ */ new Map();
+  start(options) {
+    assertProgramAllowed(options.program);
+    const child = spawn(options.program, options.args, {
+      cwd: options.cwd,
+      env: safeEnvironment(),
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: true
+    });
+    const session = {
+      sessionId: randomUUID(),
+      program: options.program,
+      args: [...options.args],
+      cwd: options.cwd,
+      child,
+      maxOutputCharacters: options.maxOutputCharacters,
+      stdout: "",
+      stderr: "",
+      running: true,
+      exitCode: null,
+      signal: null,
+      timedOut: false
+    };
+    this.#sessions.set(session.sessionId, session);
+    child.stdout.on("data", (chunk) => {
+      session.stdout = appendBounded(
+        session.stdout,
+        chunk,
+        session.maxOutputCharacters
+      );
+    });
+    child.stderr.on("data", (chunk) => {
+      session.stderr = appendBounded(
+        session.stderr,
+        chunk,
+        session.maxOutputCharacters
+      );
     });
+    child.once("error", (error62) => {
+      session.stderr = appendBounded(
+        session.stderr,
+        error62.message,
+        session.maxOutputCharacters
+      );
+      session.running = false;
+      session.exitCode = null;
+      session.signal = null;
+      if (session.timeout) clearTimeout(session.timeout);
+    });
+    child.once("close", (exitCode, signal) => {
+      session.running = false;
+      session.exitCode = exitCode;
+      session.signal = signal;
+      if (session.timeout) clearTimeout(session.timeout);
+    });
+    session.timeout = setTimeout(() => {
+      if (!session.running) return;
+      session.timedOut = true;
+      child.kill("SIGTERM");
+    }, options.timeoutMs);
+    const result = snapshot(session);
     return {
-      contents: decoded.slice(0, maxCharacters),
-      truncated: hasUnreadBytes || decoded.length > maxCharacters
+      ...result,
+      nextStdoutOffset: result.stdout.length,
+      nextStderrOffset: result.stderr.length
+    };
+  }
+  read(sessionId, stdoutOffset, stderrOffset, maxOutputCharacters) {
+    const session = this.#sessions.get(sessionId);
+    if (!session)
+      throw new Error("The requested process session was not found.");
+    const safeStdoutOffset = Math.max(
+      0,
+      Math.min(stdoutOffset, session.stdout.length)
+    );
+    const safeStderrOffset = Math.max(
+      0,
+      Math.min(stderrOffset, session.stderr.length)
+    );
+    const stdout = session.stdout.slice(
+      safeStdoutOffset,
+      safeStdoutOffset + maxOutputCharacters
+    );
+    const stderr = session.stderr.slice(
+      safeStderrOffset,
+      safeStderrOffset + maxOutputCharacters
+    );
+    return {
+      ...snapshot(session),
+      stdout,
+      stderr,
+      nextStdoutOffset: safeStdoutOffset + stdout.length,
+      nextStderrOffset: safeStderrOffset + stderr.length
     };
-  } finally {
-    await handle.close();
   }
-}
+  terminate(sessionId) {
+    const session = this.#sessions.get(sessionId);
+    if (!session)
+      throw new Error("The requested process session was not found.");
+    if (session.running) session.child.kill("SIGTERM");
+    return snapshot(session);
+  }
+  list() {
+    return [...this.#sessions.values()].map(snapshot);
+  }
+  close() {
+    for (const session of this.#sessions.values()) {
+      if (session.timeout) clearTimeout(session.timeout);
+      if (session.running) session.child.kill("SIGTERM");
+    }
+    this.#sessions.clear();
+  }
+};
 
 // src/server.ts
 var roots = configuredRoots();
+var processManager = new ProcessManager();
 function textResult(value) {
   return {
     content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
@@ -62782,10 +62888,10 @@ function createServer() {
     }
   );
   server.registerTool(
-    "run_program",
+    "start_process",
     {
-      title: "Run a local program",
-      description: "Run one executable without a shell. Shells and privilege-elevation programs are blocked unless explicitly enabled by local configuration.",
+      title: "Start a process",
+      description: "Start one approved executable without a shell on this machine and return a session ID for reading its output.",
       inputSchema: {
         program: external_exports.string().min(1),
         args: external_exports.array(external_exports.string()).max(100).default([]),
@@ -62794,14 +62900,19 @@ function createServer() {
         maxOutputCharacters: external_exports.number().int().min(1e3).max(2e5).default(5e4)
       },
       outputSchema: {
+        sessionId: external_exports.string(),
         program: external_exports.string(),
         args: external_exports.array(external_exports.string()),
         cwd: external_exports.string(),
+        pid: external_exports.number().int().nullable(),
+        running: external_exports.boolean(),
         exitCode: external_exports.number().int().nullable(),
         signal: external_exports.string().nullable(),
         stdout: external_exports.string(),
         stderr: external_exports.string(),
-        timedOut: external_exports.boolean()
+        timedOut: external_exports.boolean(),
+        nextStdoutOffset: external_exports.number().int().nonnegative(),
+        nextStderrOffset: external_exports.number().int().nonnegative()
       },
       annotations: {
         readOnlyHint: false,
@@ -62814,16 +62925,114 @@ function createServer() {
         cwd ?? roots[0],
         roots
       );
-      const result = await runProgram({
-        program,
-        args,
-        cwd: workingDirectory,
-        timeoutMs,
-        maxOutputChars: maxOutputCharacters
-      });
-      return textResult({ program, args, cwd: workingDirectory, ...result });
+      return textResult(
+        processManager.start({
+          program,
+          args,
+          cwd: workingDirectory,
+          timeoutMs,
+          maxOutputCharacters
+        })
+      );
     }
   );
+  server.registerTool(
+    "read_process_output",
+    {
+      title: "Read process output",
+      description: "Read new stdout and stderr from a previously started process session.",
+      inputSchema: {
+        sessionId: external_exports.string().uuid(),
+        stdoutOffset: external_exports.number().int().min(0).default(0),
+        stderrOffset: external_exports.number().int().min(0).default(0),
+        maxOutputCharacters: external_exports.number().int().min(1e3).max(2e5).default(5e4)
+      },
+      outputSchema: {
+        sessionId: external_exports.string(),
+        program: external_exports.string(),
+        args: external_exports.array(external_exports.string()),
+        cwd: external_exports.string(),
+        pid: external_exports.number().int().nullable(),
+        running: external_exports.boolean(),
+        exitCode: external_exports.number().int().nullable(),
+        signal: external_exports.string().nullable(),
+        stdout: external_exports.string(),
+        stderr: external_exports.string(),
+        timedOut: external_exports.boolean(),
+        nextStdoutOffset: external_exports.number().int().nonnegative(),
+        nextStderrOffset: external_exports.number().int().nonnegative()
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      }
+    },
+    async ({ sessionId, stdoutOffset, stderrOffset, maxOutputCharacters }) => textResult(
+      processManager.read(
+        sessionId,
+        stdoutOffset,
+        stderrOffset,
+        maxOutputCharacters
+      )
+    )
+  );
+  server.registerTool(
+    "terminate_process",
+    {
+      title: "Terminate a process",
+      description: "Stop a previously started process session on this machine.",
+      inputSchema: { sessionId: external_exports.string().uuid() },
+      outputSchema: {
+        sessionId: external_exports.string(),
+        program: external_exports.string(),
+        args: external_exports.array(external_exports.string()),
+        cwd: external_exports.string(),
+        pid: external_exports.number().int().nullable(),
+        running: external_exports.boolean(),
+        exitCode: external_exports.number().int().nullable(),
+        signal: external_exports.string().nullable(),
+        stdout: external_exports.string(),
+        stderr: external_exports.string(),
+        timedOut: external_exports.boolean()
+      },
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ sessionId }) => textResult(processManager.terminate(sessionId))
+  );
+  server.registerTool(
+    "list_processes",
+    {
+      title: "List process sessions",
+      description: "List process sessions started through Terminal Commands.",
+      inputSchema: {},
+      outputSchema: {
+        processes: external_exports.array(
+          external_exports.object({
+            sessionId: external_exports.string(),
+            program: external_exports.string(),
+            args: external_exports.array(external_exports.string()),
+            cwd: external_exports.string(),
+            pid: external_exports.number().int().nullable(),
+            running: external_exports.boolean(),
+            exitCode: external_exports.number().int().nullable(),
+            signal: external_exports.string().nullable(),
+            timedOut: external_exports.boolean()
+          })
+        )
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      }
+    },
+    async () => textResult({ processes: processManager.list() })
+  );
   return server;
 }
 
@@ -62884,6 +63093,7 @@ var listener = app.listen(port, host, () => {
 });
 function shutdown(signal) {
   console.log(`Received ${signal}; shutting down.`);
+  processManager.close();
   listener.close((error62) => {
     if (error62) {
       console.error(error62);

package/dist/stdio.js

@@ -36479,9 +36479,30 @@ var EMPTY_COMPLETION_RESULT = {
   }
 };
 
-// src/runner.ts
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
+// src/file-reader.ts
+import { open as open2 } from "node:fs/promises";
+async function readBoundedTextFile(filename, maxCharacters) {
+  const handle = await open2(filename, "r");
+  try {
+    const stats = await handle.stat();
+    const buffer = Buffer.allocUnsafe(maxCharacters * 4 + 4);
+    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+    const hasUnreadBytes = bytesRead < stats.size;
+    const decoded = new TextDecoder().decode(buffer.subarray(0, bytesRead), {
+      stream: hasUnreadBytes
+    });
+    return {
+      contents: decoded.slice(0, maxCharacters),
+      truncated: hasUnreadBytes || decoded.length > maxCharacters
+    };
+  } finally {
+    await handle.close();
+  }
+}
+
+// src/process-manager.ts
+import { randomUUID } from "node:crypto";
+import { spawn } from "node:child_process";
 
 // src/security.ts
 import { constants } from "node:fs";
@@ -36571,59 +36592,144 @@ function assertProgramAllowed(program) {
   }
 }
 
-// src/runner.ts
-var execFileAsync = promisify(execFile);
-async function runProgram(options) {
-  assertProgramAllowed(options.program);
-  try {
-    const { stdout, stderr } = await execFileAsync(
-      options.program,
-      options.args,
-      {
-        cwd: options.cwd,
-        env: safeEnvironment(),
-        encoding: "utf8",
-        maxBuffer: options.maxOutputChars,
-        timeout: options.timeoutMs,
-        windowsHide: true
-      }
-    );
-    return { exitCode: 0, signal: null, stdout, stderr, timedOut: false };
-  } catch (error62) {
-    const failure2 = error62;
+// src/process-manager.ts
+function appendBounded(current, value, limit) {
+  if (current.length >= limit) return current;
+  return `${current}${value.toString("utf8")}`.slice(0, limit);
+}
+function snapshot(session) {
+  return {
+    sessionId: session.sessionId,
+    program: session.program,
+    args: session.args,
+    cwd: session.cwd,
+    pid: session.child.pid ?? null,
+    running: session.running,
+    exitCode: session.exitCode,
+    signal: session.signal,
+    stdout: session.stdout,
+    stderr: session.stderr,
+    timedOut: session.timedOut
+  };
+}
+var ProcessManager = class {
+  #sessions = /* @__PURE__ */ new Map();
+  start(options) {
+    assertProgramAllowed(options.program);
+    const child = spawn(options.program, options.args, {
+      cwd: options.cwd,
+      env: safeEnvironment(),
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: true
+    });
+    const session = {
+      sessionId: randomUUID(),
+      program: options.program,
+      args: [...options.args],
+      cwd: options.cwd,
+      child,
+      maxOutputCharacters: options.maxOutputCharacters,
+      stdout: "",
+      stderr: "",
+      running: true,
+      exitCode: null,
+      signal: null,
+      timedOut: false
+    };
+    this.#sessions.set(session.sessionId, session);
+    child.stdout.on("data", (chunk) => {
+      session.stdout = appendBounded(
+        session.stdout,
+        chunk,
+        session.maxOutputCharacters
+      );
+    });
+    child.stderr.on("data", (chunk) => {
+      session.stderr = appendBounded(
+        session.stderr,
+        chunk,
+        session.maxOutputCharacters
+      );
+    });
+    child.once("error", (error62) => {
+      session.stderr = appendBounded(
+        session.stderr,
+        error62.message,
+        session.maxOutputCharacters
+      );
+      session.running = false;
+      session.exitCode = null;
+      session.signal = null;
+      if (session.timeout) clearTimeout(session.timeout);
+    });
+    child.once("close", (exitCode, signal) => {
+      session.running = false;
+      session.exitCode = exitCode;
+      session.signal = signal;
+      if (session.timeout) clearTimeout(session.timeout);
+    });
+    session.timeout = setTimeout(() => {
+      if (!session.running) return;
+      session.timedOut = true;
+      child.kill("SIGTERM");
+    }, options.timeoutMs);
+    const result = snapshot(session);
     return {
-      exitCode: typeof failure2.code === "number" ? failure2.code : null,
-      signal: failure2.signal ?? null,
-      stdout: failure2.stdout ?? "",
-      stderr: failure2.stderr ?? failure2.message,
-      timedOut: failure2.killed === true && failure2.signal === "SIGTERM"
+      ...result,
+      nextStdoutOffset: result.stdout.length,
+      nextStderrOffset: result.stderr.length
     };
   }
-}
-
-// src/file-reader.ts
-import { open as open2 } from "node:fs/promises";
-async function readBoundedTextFile(filename, maxCharacters) {
-  const handle = await open2(filename, "r");
-  try {
-    const stats = await handle.stat();
-    const buffer = Buffer.allocUnsafe(maxCharacters * 4 + 4);
-    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
-    const hasUnreadBytes = bytesRead < stats.size;
-    const decoded = new TextDecoder().decode(buffer.subarray(0, bytesRead), {
-      stream: hasUnreadBytes
-    });
+  read(sessionId, stdoutOffset, stderrOffset, maxOutputCharacters) {
+    const session = this.#sessions.get(sessionId);
+    if (!session)
+      throw new Error("The requested process session was not found.");
+    const safeStdoutOffset = Math.max(
+      0,
+      Math.min(stdoutOffset, session.stdout.length)
+    );
+    const safeStderrOffset = Math.max(
+      0,
+      Math.min(stderrOffset, session.stderr.length)
+    );
+    const stdout = session.stdout.slice(
+      safeStdoutOffset,
+      safeStdoutOffset + maxOutputCharacters
+    );
+    const stderr = session.stderr.slice(
+      safeStderrOffset,
+      safeStderrOffset + maxOutputCharacters
+    );
     return {
-      contents: decoded.slice(0, maxCharacters),
-      truncated: hasUnreadBytes || decoded.length > maxCharacters
+      ...snapshot(session),
+      stdout,
+      stderr,
+      nextStdoutOffset: safeStdoutOffset + stdout.length,
+      nextStderrOffset: safeStderrOffset + stderr.length
     };
-  } finally {
-    await handle.close();
   }
-}
+  terminate(sessionId) {
+    const session = this.#sessions.get(sessionId);
+    if (!session)
+      throw new Error("The requested process session was not found.");
+    if (session.running) session.child.kill("SIGTERM");
+    return snapshot(session);
+  }
+  list() {
+    return [...this.#sessions.values()].map(snapshot);
+  }
+  close() {
+    for (const session of this.#sessions.values()) {
+      if (session.timeout) clearTimeout(session.timeout);
+      if (session.running) session.child.kill("SIGTERM");
+    }
+    this.#sessions.clear();
+  }
+};
 
 // src/server.ts
 var roots = configuredRoots();
+var processManager = new ProcessManager();
 function textResult(value) {
   return {
     content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
@@ -36763,10 +36869,10 @@ function createServer() {
     }
   );
   server2.registerTool(
-    "run_program",
+    "start_process",
     {
-      title: "Run a local program",
-      description: "Run one executable without a shell. Shells and privilege-elevation programs are blocked unless explicitly enabled by local configuration.",
+      title: "Start a process",
+      description: "Start one approved executable without a shell on this machine and return a session ID for reading its output.",
       inputSchema: {
         program: external_exports.string().min(1),
         args: external_exports.array(external_exports.string()).max(100).default([]),
@@ -36775,14 +36881,19 @@ function createServer() {
         maxOutputCharacters: external_exports.number().int().min(1e3).max(2e5).default(5e4)
       },
       outputSchema: {
+        sessionId: external_exports.string(),
         program: external_exports.string(),
         args: external_exports.array(external_exports.string()),
         cwd: external_exports.string(),
+        pid: external_exports.number().int().nullable(),
+        running: external_exports.boolean(),
         exitCode: external_exports.number().int().nullable(),
         signal: external_exports.string().nullable(),
         stdout: external_exports.string(),
         stderr: external_exports.string(),
-        timedOut: external_exports.boolean()
+        timedOut: external_exports.boolean(),
+        nextStdoutOffset: external_exports.number().int().nonnegative(),
+        nextStderrOffset: external_exports.number().int().nonnegative()
       },
       annotations: {
         readOnlyHint: false,
@@ -36795,16 +36906,114 @@ function createServer() {
         cwd ?? roots[0],
         roots
       );
-      const result = await runProgram({
-        program,
-        args,
-        cwd: workingDirectory,
-        timeoutMs,
-        maxOutputChars: maxOutputCharacters
-      });
-      return textResult({ program, args, cwd: workingDirectory, ...result });
+      return textResult(
+        processManager.start({
+          program,
+          args,
+          cwd: workingDirectory,
+          timeoutMs,
+          maxOutputCharacters
+        })
+      );
     }
   );
+  server2.registerTool(
+    "read_process_output",
+    {
+      title: "Read process output",
+      description: "Read new stdout and stderr from a previously started process session.",
+      inputSchema: {
+        sessionId: external_exports.string().uuid(),
+        stdoutOffset: external_exports.number().int().min(0).default(0),
+        stderrOffset: external_exports.number().int().min(0).default(0),
+        maxOutputCharacters: external_exports.number().int().min(1e3).max(2e5).default(5e4)
+      },
+      outputSchema: {
+        sessionId: external_exports.string(),
+        program: external_exports.string(),
+        args: external_exports.array(external_exports.string()),
+        cwd: external_exports.string(),
+        pid: external_exports.number().int().nullable(),
+        running: external_exports.boolean(),
+        exitCode: external_exports.number().int().nullable(),
+        signal: external_exports.string().nullable(),
+        stdout: external_exports.string(),
+        stderr: external_exports.string(),
+        timedOut: external_exports.boolean(),
+        nextStdoutOffset: external_exports.number().int().nonnegative(),
+        nextStderrOffset: external_exports.number().int().nonnegative()
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      }
+    },
+    async ({ sessionId, stdoutOffset, stderrOffset, maxOutputCharacters }) => textResult(
+      processManager.read(
+        sessionId,
+        stdoutOffset,
+        stderrOffset,
+        maxOutputCharacters
+      )
+    )
+  );
+  server2.registerTool(
+    "terminate_process",
+    {
+      title: "Terminate a process",
+      description: "Stop a previously started process session on this machine.",
+      inputSchema: { sessionId: external_exports.string().uuid() },
+      outputSchema: {
+        sessionId: external_exports.string(),
+        program: external_exports.string(),
+        args: external_exports.array(external_exports.string()),
+        cwd: external_exports.string(),
+        pid: external_exports.number().int().nullable(),
+        running: external_exports.boolean(),
+        exitCode: external_exports.number().int().nullable(),
+        signal: external_exports.string().nullable(),
+        stdout: external_exports.string(),
+        stderr: external_exports.string(),
+        timedOut: external_exports.boolean()
+      },
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ sessionId }) => textResult(processManager.terminate(sessionId))
+  );
+  server2.registerTool(
+    "list_processes",
+    {
+      title: "List process sessions",
+      description: "List process sessions started through Terminal Commands.",
+      inputSchema: {},
+      outputSchema: {
+        processes: external_exports.array(
+          external_exports.object({
+            sessionId: external_exports.string(),
+            program: external_exports.string(),
+            args: external_exports.array(external_exports.string()),
+            cwd: external_exports.string(),
+            pid: external_exports.number().int().nullable(),
+            running: external_exports.boolean(),
+            exitCode: external_exports.number().int().nullable(),
+            signal: external_exports.string().nullable(),
+            timedOut: external_exports.boolean()
+          })
+        )
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      }
+    },
+    async () => textResult({ processes: processManager.list() })
+  );
   return server2;
 }
 
@@ -36813,6 +37022,7 @@ var server = createServer();
 var transport = new StdioServerTransport();
 await server.connect(transport);
 async function shutdown() {
+  processManager.close();
   await server.close();
   process.exit(0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminal-commands",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": false,
   "type": "module",
   "description": "A cross-platform, approval-gated terminal companion for ChatGPT, Claude, Codex, and any MCP-compatible AI client.",
@@ -22,7 +22,7 @@
     "start:agent": "node dist/agent.js",
     "cli": "node dist/cli.js",
     "cli:dev": "tsx src/cli.ts",
-    "test": "tsx --test test/**/*.test.ts",
+    "test": "tsx --test test/*.test.ts",
     "test:smoke": "node test/smoke.mjs",
     "prepack": "npm run build"
   },