terminal-commands 0.2.0 → 0.2.1

package/dist/agent.js

@@ -35857,19 +35857,33 @@ function assertActive(signal) {
     );
   }
 }
-async function authorizeToolCall(tool, args, allowDestructive, approve, signal) {
+async function authorizeToolCall(tool, args, allowDestructive, approve, signal, progress) {
+  const notify = (phase) => {
+    try {
+      progress?.(phase);
+    } catch {
+    }
+  };
   assertActive(signal);
   if (!destructiveTools.has(tool)) return;
   if (!allowDestructive) {
+    notify("denied");
     throw new Error(
       "This action requires local approval. Commands and writes are disabled unless explicitly enabled."
     );
   }
-  if (!approve || !await approve(tool, args, signal)) {
+  if (!approve) {
+    notify("denied");
+    throw new Error("The action was not approved on the connected machine.");
+  }
+  notify("awaiting_approval");
+  if (!await approve(tool, args, signal)) {
     assertActive(signal);
+    notify("denied");
     throw new Error("The action was not approved on the connected machine.");
   }
   assertActive(signal);
+  notify("approved");
 }
 async function connectOnce(options, acknowledged) {
   const { config: config3, signal } = options;
@@ -35880,7 +35894,7 @@ async function connectOnce(options, acknowledged) {
   }
   const client = new Client({
     name: "terminal-commands-cli",
-    version: "0.2.0"
+    version: "0.2.1"
   });
   let disposeSocket;
   try {
@@ -35902,6 +35916,7 @@ async function connectOnce(options, acknowledged) {
     });
     disposeSocket = () => socket.terminate();
     const pending = /* @__PURE__ */ new Map();
+    let requestProgressEnabled = false;
     const forwarder = new ProcessEventForwarder(
       async (name, args) => client.callTool({ name, arguments: args }),
       (message) => {
@@ -35952,6 +35967,7 @@ async function connectOnce(options, acknowledged) {
           return;
         }
         if (message && typeof message === "object" && "type" in message && message.type === "ready") {
+          requestProgressEnabled = message.requestProgressVersion === 1;
           void forwarder.recover().catch(
             (error62) => options.log?.(
               "Could not recover local process streams: " + (error62 instanceof Error ? error62.message : "unknown error")
@@ -35963,7 +35979,15 @@ async function connectOnce(options, acknowledged) {
         options.log?.("Ignoring a malformed gateway message.");
         return;
       }
-      void handleMessage(options, client, socket, raw, pending, forwarder);
+      void handleMessage(
+        options,
+        client,
+        socket,
+        raw,
+        pending,
+        forwarder,
+        requestProgressEnabled
+      );
     });
     socket.on("close", () => {
       forwarder.close();
@@ -35978,7 +36002,7 @@ async function connectOnce(options, acknowledged) {
     await client.close().catch(() => void 0);
   }
 }
-async function handleMessage(options, client, socket, raw, pending, forwarder) {
+async function handleMessage(options, client, socket, raw, pending, forwarder, requestProgressEnabled) {
   let requestId;
   let controller2;
   let deadlineTimer;
@@ -36015,12 +36039,37 @@ async function handleMessage(options, client, socket, raw, pending, forwarder) {
       () => controller2?.abort(),
       Math.max(0, deadlineAt - Date.now())
     );
+    let progressSequence = 0;
+    const progress = (phase) => {
+      if (!requestProgressEnabled || parsed.data.tool !== "start_process" || socket.readyState !== wrapper_default.OPEN)
+        return;
+      if (socket.bufferedAmount > 512e3) {
+        socket.close(1013, "Request progress backpressure");
+        return;
+      }
+      try {
+        socket.send(
+          JSON.stringify({
+            type: "request_progress",
+            requestId,
+            sequence: ++progressSequence,
+            phase,
+            ...phase === "approved" ? {
+              approvalMode: options.config.MACHINE_TERMINAL_AUTO_APPROVE === "1" ? "automatic" : "manual"
+            } : {}
+          })
+        );
+      } catch {
+      }
+    };
+    progress("received");
     await authorizeToolCall(
       parsed.data.tool,
       parsed.data.arguments,
       options.config.MACHINE_TERMINAL_AGENT_ALLOW_DESTRUCTIVE === "1",
       options.approve,
-      controller2.signal
+      controller2.signal,
+      progress
     );
     assertActive(controller2.signal);
     const result = await client.callTool({

package/dist/cli.js

@@ -35866,19 +35866,33 @@ function assertActive(signal) {
     );
   }
 }
-async function authorizeToolCall(tool, args, allowDestructive, approve, signal) {
+async function authorizeToolCall(tool, args, allowDestructive, approve, signal, progress) {
+  const notify = (phase) => {
+    try {
+      progress?.(phase);
+    } catch {
+    }
+  };
   assertActive(signal);
   if (!destructiveTools.has(tool)) return;
   if (!allowDestructive) {
+    notify("denied");
     throw new Error(
       "This action requires local approval. Commands and writes are disabled unless explicitly enabled."
     );
   }
-  if (!approve || !await approve(tool, args, signal)) {
+  if (!approve) {
+    notify("denied");
+    throw new Error("The action was not approved on the connected machine.");
+  }
+  notify("awaiting_approval");
+  if (!await approve(tool, args, signal)) {
     assertActive(signal);
+    notify("denied");
     throw new Error("The action was not approved on the connected machine.");
   }
   assertActive(signal);
+  notify("approved");
 }
 async function connectOnce(options, acknowledged) {
   const { config: config2, signal } = options;
@@ -35889,7 +35903,7 @@ async function connectOnce(options, acknowledged) {
   }
   const client = new Client({
     name: "terminal-commands-cli",
-    version: "0.2.0"
+    version: "0.2.1"
   });
   let disposeSocket;
   try {
@@ -35911,6 +35925,7 @@ async function connectOnce(options, acknowledged) {
     });
     disposeSocket = () => socket.terminate();
     const pending = /* @__PURE__ */ new Map();
+    let requestProgressEnabled = false;
     const forwarder = new ProcessEventForwarder(
       async (name, args) => client.callTool({ name, arguments: args }),
       (message) => {
@@ -35961,6 +35976,7 @@ async function connectOnce(options, acknowledged) {
           return;
         }
         if (message && typeof message === "object" && "type" in message && message.type === "ready") {
+          requestProgressEnabled = message.requestProgressVersion === 1;
           void forwarder.recover().catch(
             (error62) => options.log?.(
               "Could not recover local process streams: " + (error62 instanceof Error ? error62.message : "unknown error")
@@ -35972,7 +35988,15 @@ async function connectOnce(options, acknowledged) {
         options.log?.("Ignoring a malformed gateway message.");
         return;
       }
-      void handleMessage(options, client, socket, raw, pending, forwarder);
+      void handleMessage(
+        options,
+        client,
+        socket,
+        raw,
+        pending,
+        forwarder,
+        requestProgressEnabled
+      );
     });
     socket.on("close", () => {
       forwarder.close();
@@ -35987,7 +36011,7 @@ async function connectOnce(options, acknowledged) {
     await client.close().catch(() => void 0);
   }
 }
-async function handleMessage(options, client, socket, raw, pending, forwarder) {
+async function handleMessage(options, client, socket, raw, pending, forwarder, requestProgressEnabled) {
   let requestId;
   let controller;
   let deadlineTimer;
@@ -36024,12 +36048,37 @@ async function handleMessage(options, client, socket, raw, pending, forwarder) {
       () => controller?.abort(),
       Math.max(0, deadlineAt - Date.now())
     );
+    let progressSequence = 0;
+    const progress = (phase) => {
+      if (!requestProgressEnabled || parsed.data.tool !== "start_process" || socket.readyState !== wrapper_default.OPEN)
+        return;
+      if (socket.bufferedAmount > 512e3) {
+        socket.close(1013, "Request progress backpressure");
+        return;
+      }
+      try {
+        socket.send(
+          JSON.stringify({
+            type: "request_progress",
+            requestId,
+            sequence: ++progressSequence,
+            phase,
+            ...phase === "approved" ? {
+              approvalMode: options.config.MACHINE_TERMINAL_AUTO_APPROVE === "1" ? "automatic" : "manual"
+            } : {}
+          })
+        );
+      } catch {
+      }
+    };
+    progress("received");
     await authorizeToolCall(
       parsed.data.tool,
       parsed.data.arguments,
       options.config.MACHINE_TERMINAL_AGENT_ALLOW_DESTRUCTIVE === "1",
       options.approve,
-      controller.signal
+      controller.signal,
+      progress
     );
     assertActive(controller.signal);
     const result = await client.callTool({

package/dist/index.js

@@ -63373,7 +63373,7 @@ function createServer(options = {}) {
     }
   };
   const server = new McpServer(
-    { name: "terminal-commands", version: "0.2.0" },
+    { name: "terminal-commands", version: "0.2.1" },
     {
       instructions: "This server controls the user's machine. Prefer dedicated file tools over commands. Every command and write can modify or expose local data and must receive user approval. Never request secrets or bypass configured roots and safety controls."
     }
@@ -63749,7 +63749,7 @@ app.get("/health", (request, response) => {
   response.status(available ? 200 : 503).json({
     status: available ? "ok" : "filesystem_unavailable",
     server: "terminal-commands",
-    version: "0.2.0",
+    version: "0.2.1",
     ...proof ? { agentProof: proof } : {}
   });
 });

package/dist/stdio.js

@@ -37280,7 +37280,7 @@ function createServer(options = {}) {
     }
   };
   const server2 = new McpServer(
-    { name: "terminal-commands", version: "0.2.0" },
+    { name: "terminal-commands", version: "0.2.1" },
     {
       instructions: "This server controls the user's machine. Prefer dedicated file tools over commands. Every command and write can modify or expose local data and must receive user approval. Never request secrets or bypass configured roots and safety controls."
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminal-commands",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": false,
   "type": "module",
   "description": "A cross-platform, approval-gated terminal companion for ChatGPT, Claude, Codex, and any MCP-compatible AI client.",