@elizaos/plugin-shell 2.0.0-alpha.6 → 2.0.0-alpha.7

package/dist/index.js

@@ -18,7 +18,7 @@ var __toESM = (mod, isNodeMode, target) => {
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// node_modules/@lydell/node-pty/eventEmitter2.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/eventEmitter2.js
 var require_eventEmitter2 = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   var EventEmitter2 = function() {
@@ -63,7 +63,7 @@ var require_eventEmitter2 = __commonJS((exports) => {
   exports.EventEmitter2 = EventEmitter2;
 });
 
-// node_modules/@lydell/node-pty/terminal.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/terminal.js
 var require_terminal = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   var events_1 = __require("events");
@@ -251,7 +251,7 @@ var require_terminal = __commonJS((exports) => {
   exports.Terminal = Terminal;
 });
 
-// node_modules/@lydell/node-pty/shared/conout.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/shared/conout.js
 var require_conout = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   function getWorkerPipeName(conoutPipeName) {
@@ -260,9 +260,9 @@ var require_conout = __commonJS((exports) => {
   exports.getWorkerPipeName = getWorkerPipeName;
 });
 
-// node_modules/@lydell/node-pty/windowsConoutConnection.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/windowsConoutConnection.js
 var require_windowsConoutConnection = __commonJS((exports) => {
-  var __dirname = "/Users/shawwalters/eliza-workspace/plugins/plugin-shell/typescript/node_modules/@lydell/node-pty";
+  var __dirname = "/Users/shawwalters/eliza-workspace/milady/node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty";
   var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
     function adopt(value) {
       return value instanceof P ? value : new P(function(resolve) {
@@ -435,7 +435,7 @@ var require_windowsConoutConnection = __commonJS((exports) => {
   exports.ConoutConnection = ConoutConnection;
 });
 
-// node_modules/@lydell/node-pty/package.json
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/package.json
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@lydell/node-pty",
@@ -470,7 +470,7 @@ var require_package = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/@lydell/node-pty/requireBinary.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/requireBinary.js
 var require_requireBinary = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   var PACKAGE_NAME = "@lydell/node-pty-" + process.platform + "-" + process.arch;
@@ -511,9 +511,9 @@ Your platform (` + process.platform + "-" + process.arch + ") might not be suppo
   }
 });
 
-// node_modules/@lydell/node-pty/windowsPtyAgent.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/windowsPtyAgent.js
 var require_windowsPtyAgent = __commonJS((exports) => {
-  var __dirname = "/Users/shawwalters/eliza-workspace/plugins/plugin-shell/typescript/node_modules/@lydell/node-pty";
+  var __dirname = "/Users/shawwalters/eliza-workspace/milady/node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty";
   Object.defineProperty(exports, "__esModule", { value: true });
   var fs5 = __require("fs");
   var path6 = __require("path");
@@ -729,7 +729,7 @@ var require_windowsPtyAgent = __commonJS((exports) => {
   }
 });
 
-// node_modules/@lydell/node-pty/utils.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/utils.js
 var require_utils = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   function assign(target) {
@@ -747,7 +747,7 @@ var require_utils = __commonJS((exports) => {
   exports.assign = assign;
 });
 
-// node_modules/@lydell/node-pty/windowsTerminal.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/windowsTerminal.js
 var require_windowsTerminal = __commonJS((exports) => {
   var __extends = exports && exports.__extends || function() {
     var extendStatics = function(d, b) {
@@ -925,7 +925,7 @@ var require_windowsTerminal = __commonJS((exports) => {
   exports.WindowsTerminal = WindowsTerminal;
 });
 
-// node_modules/@lydell/node-pty/unixTerminal.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/unixTerminal.js
 var require_unixTerminal = __commonJS((exports) => {
   var __extends = exports && exports.__extends || function() {
     var extendStatics = function(d, b) {
@@ -1171,7 +1171,7 @@ var require_unixTerminal = __commonJS((exports) => {
   exports.UnixTerminal = UnixTerminal;
 });
 
-// node_modules/@lydell/node-pty/index.js
+// ../../../node_modules/.pnpm/@lydell+node-pty@1.1.0/node_modules/@lydell/node-pty/index.js
 var require_node_pty = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   var terminalCtor;
@@ -1217,26 +1217,6 @@ var coreActionsSpec = {
         "RESET_HISTORY"
       ],
       parameters: []
-    },
-    {
-      name: "EXECUTE_COMMAND",
-      description: "Execute shell commands including brew install, npm install, apt-get, system commands, file operations, directory navigation, and scripts.",
-      similes: [
-        "RUN_COMMAND",
-        "SHELL_COMMAND",
-        "TERMINAL_COMMAND",
-        "EXEC",
-        "RUN",
-        "EXECUTE",
-        "CREATE_FILE",
-        "WRITE_FILE",
-        "MAKE_FILE",
-        "INSTALL",
-        "BREW_INSTALL",
-        "NPM_INSTALL",
-        "APT_INSTALL"
-      ],
-      parameters: []
     }
   ]
 };
@@ -1253,26 +1233,6 @@ var allActionsSpec = {
         "RESET_HISTORY"
       ],
       parameters: []
-    },
-    {
-      name: "EXECUTE_COMMAND",
-      description: "Execute shell commands including brew install, npm install, apt-get, system commands, file operations, directory navigation, and scripts.",
-      similes: [
-        "RUN_COMMAND",
-        "SHELL_COMMAND",
-        "TERMINAL_COMMAND",
-        "EXEC",
-        "RUN",
-        "EXECUTE",
-        "CREATE_FILE",
-        "WRITE_FILE",
-        "MAKE_FILE",
-        "INSTALL",
-        "BREW_INSTALL",
-        "NPM_INSTALL",
-        "APT_INSTALL"
-      ],
-      parameters: []
     }
   ]
 };
@@ -1345,17 +1305,38 @@ var clearHistory = {
   name: spec.name,
   similes: spec.similes ? [...spec.similes] : [],
   description: spec.description,
-  validate: async (runtime, message, _state) => {
-    const shellService = runtime.getService("shell");
-    if (!shellService) {
+  validate: async (runtime, message, state, options) => {
+    const __avTextRaw = typeof message?.content?.text === "string" ? message.content.text : "";
+    const __avText = __avTextRaw.toLowerCase();
+    const __avKeywords = ["clear", "shell", "history"];
+    const __avKeywordOk = __avKeywords.length > 0 && __avKeywords.some((kw) => kw.length > 0 && __avText.includes(kw));
+    const __avRegex = new RegExp("\\b(?:clear|shell|history)\\b", "i");
+    const __avRegexOk = __avRegex.test(__avText);
+    const __avSource = String(message?.content?.source ?? message?.source ?? "");
+    const __avExpectedSource = "";
+    const __avSourceOk = __avExpectedSource ? __avSource === __avExpectedSource : Boolean(__avSource || state || runtime?.agentId || runtime?.getService);
+    const __avOptions = options && typeof options === "object" ? options : {};
+    const __avInputOk = __avText.trim().length > 0 || Object.keys(__avOptions).length > 0 || Boolean(message?.content && typeof message.content === "object");
+    if (!(__avKeywordOk && __avRegexOk && __avSourceOk && __avInputOk)) {
+      return false;
+    }
+    const __avLegacyValidate = async (runtime2, message2, _state) => {
+      const shellService = runtime2.getService("shell");
+      if (!shellService) {
+        return false;
+      }
+      const text = message2.content.text?.toLowerCase() || "";
+      const clearKeywords = ["clear", "reset", "delete", "remove", "clean"];
+      const historyKeywords = ["history", "terminal", "shell", "command"];
+      const hasClearKeyword = clearKeywords.some((keyword) => text.includes(keyword));
+      const hasHistoryKeyword = historyKeywords.some((keyword) => text.includes(keyword));
+      return hasClearKeyword && hasHistoryKeyword;
+    };
+    try {
+      return Boolean(await __avLegacyValidate(runtime, message, state, options));
+    } catch {
       return false;
     }
-    const text = message.content.text?.toLowerCase() || "";
-    const clearKeywords = ["clear", "reset", "delete", "remove", "clean"];
-    const historyKeywords = ["history", "terminal", "shell", "command"];
-    const hasClearKeyword = clearKeywords.some((keyword) => text.includes(keyword));
-    const hasHistoryKeyword = historyKeywords.some((keyword) => text.includes(keyword));
-    return hasClearKeyword && hasHistoryKeyword;
   },
   handler: async (runtime, message, _state, _options, callback) => {
     const shellService = runtime.getService("shell");
@@ -1392,397 +1373,12 @@ var clearHistory = {
   },
   examples: spec.examples ?? []
 };
-// actions/executeCommand.ts
-import {
-  composePromptFromState,
-  logger as logger2,
-  ModelType,
-  parseJSONObjectFromText
-} from "@elizaos/core";
-var commandExtractionTemplate = `# Extracting shell command from request
-{{recentMessages}}
-
-# Instructions: {{senderName}} wants to execute a shell command. Extract the COMPLETE shell command they want to run.
-
-IMPORTANT:
-1. Always return the FULL executable shell command, not just the content or partial command.
-2. If the user mentions installing something, create the appropriate brew/npm/apt command.
-3. If the user directly provides a command (like "brew install X"), use it exactly as provided.
-4. ALWAYS extract a command if the user is asking for ANY kind of system operation.
-
-Execution Options:
-- background: Set to true if the user asks to run it in the background or completely asynchronously.
-- pty: Set to true if the command is interactive (like "top", "vim", "python" shell) or requires a TTY. Defaults to TRUE for almost all commands to enable interaction.
-- wait: Timeout in seconds (default 30).
-- yield: Time in milliseconds to wait before yielding to background (default 1000). Set to 1000 (1 second) to allow quick interaction.
-
-Your response must be formatted as a JSON block:
-\`\`\`json
-{
-  "command": "<complete shell command to execute>",
-  "background": false,
-  "pty": true,
-  "wait": 30,
-  "yield": 1000
-}
-\`\`\``;
-var extractCommand = async (runtime, _message, state) => {
-  const prompt = composePromptFromState({
-    state,
-    template: commandExtractionTemplate
-  });
-  for (let i = 0;i < 3; i++) {
-    const response = await runtime.useModel(ModelType.TEXT_SMALL, {
-      prompt
-    });
-    const parsedResponse = parseJSONObjectFromText(response);
-    if (parsedResponse?.command) {
-      return {
-        command: parsedResponse.command,
-        background: parsedResponse.background === true || String(parsedResponse.background) === "true",
-        pty: parsedResponse.pty !== false && String(parsedResponse.pty) !== "false",
-        wait: parsedResponse.wait ? Number(parsedResponse.wait) : undefined,
-        yield: parsedResponse.yield ? Number(parsedResponse.yield) : 1000
-      };
-    }
-  }
-  return null;
-};
-var spec2 = requireActionSpec("EXECUTE_COMMAND");
-var executeCommand = {
-  name: spec2.name,
-  similes: spec2.similes ? [...spec2.similes] : [],
-  description: spec2.description,
-  validate: async (runtime, message, _state) => {
-    const shellService = runtime.getService("shell");
-    if (!shellService) {
-      return false;
-    }
-    const text = message.content.text?.toLowerCase() || "";
-    const commandKeywords = [
-      "run",
-      "execute",
-      "command",
-      "shell",
-      "install",
-      "brew",
-      "npm",
-      "create",
-      "file",
-      "directory",
-      "folder",
-      "list",
-      "show",
-      "system",
-      "info",
-      "check",
-      "status",
-      "cd",
-      "ls",
-      "mkdir",
-      "echo",
-      "cat",
-      "touch",
-      "git",
-      "build",
-      "test"
-    ];
-    const hasCommandKeyword = commandKeywords.some((keyword) => text.includes(keyword));
-    const hasDirectCommand = /^(brew|npm|apt|git|ls|cd|echo|cat|touch|mkdir|rm|mv|cp)\s/i.test(message.content.text || "");
-    return hasCommandKeyword || hasDirectCommand;
-  },
-  handler: async (runtime, message, state, _options, callback) => {
-    const shellService = runtime.getService("shell");
-    if (!shellService) {
-      if (callback) {
-        await callback({
-          text: "Shell service is not available.",
-          source: message.content.source
-        });
-      }
-      return { success: false, error: "Shell service is not available." };
-    }
-    const commandInfo = await extractCommand(runtime, message, state);
-    if (!commandInfo?.command) {
-      logger2.error("Failed to extract command from message:", message.content.text);
-      if (callback) {
-        await callback({
-          text: "Could not determine which command to execute. Please specify a shell command.",
-          source: message.content.source
-        });
-      }
-      return { success: false, error: "Could not extract command." };
-    }
-    logger2.info(`Extracted command: "${commandInfo.command}"`);
-    try {
-      const conversationId = message.roomId || message.agentId;
-      const result = await shellService.exec(commandInfo.command, {
-        conversationId,
-        background: commandInfo.background,
-        pty: commandInfo.pty,
-        timeout: commandInfo.wait,
-        yieldMs: commandInfo.yield
-      });
-      let responseText = "";
-      if (result.status === "running") {
-        responseText = `Started background process (Session ID: ${result.sessionId})
-`;
-        responseText += `PID: ${result.pid}
-`;
-        if (result.tail) {
-          responseText += `
-Output limit reached/yielded. Current tail:
-\`\`\`
-${result.tail}
-\`\`\``;
-        }
-        responseText += `
-Use 'check process <sessionId>' to monitor status.`;
-        callback?.({
-          text: responseText,
-          source: message.content.source,
-          action: "MANAGE_PROCESS"
-        });
-        return { success: true, text: responseText, data: result };
-      }
-      if (result.status === "completed") {
-        responseText = `Command executed successfully (Duration: ${result.durationMs}ms)
-
-`;
-        if (result.aggregated) {
-          responseText += `Output:
-\`\`\`
-${result.aggregated}
-\`\`\``;
-        } else {
-          responseText += "Command completed with no output.";
-        }
-        callback?.({
-          text: responseText,
-          source: message.content.source
-        });
-        return { success: true, text: responseText, data: result };
-      }
-      responseText = `Command failed (Exit Code: ${result.exitCode})
-`;
-      if (result.reason) {
-        responseText += `Reason: ${result.reason}
-`;
-      }
-      if (result.aggregated) {
-        responseText += `
-Output:
-\`\`\`
-${result.aggregated}
-\`\`\``;
-      }
-      callback?.({
-        text: responseText,
-        source: message.content.source
-      });
-      return { success: false, error: responseText, data: result };
-    } catch (error) {
-      logger2.error("Error executing command:", error);
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      if (callback) {
-        await callback({
-          text: `Failed to execute command: ${errorMessage}`,
-          source: message.content.source
-        });
-      }
-      return { success: false, error: errorMessage };
-    }
-  },
-  examples: spec2.examples ?? []
-};
-// actions/processAction.ts
-import { composePromptFromState as composePromptFromState2, logger as logger3, ModelType as ModelType2 } from "@elizaos/core";
-var processActionTemplate = `You are helping extract process management parameters from user messages.
-
-Recent conversation:
-{{recentMessages}}
-
-Based on the conversation, extract the process action parameters:
-- action: The action to perform (list, poll, log, write, send-keys, submit, paste, kill, clear, remove)
-- sessionId: The session ID (required for all actions except "list")
-- data: Data to write (for "write" action)
-- keys: Array of key tokens (for "send-keys" action)
-- literal: Literal string to send (for "send-keys" action)
-- text: Text to paste (for "paste" action)
-- eof: Whether to close stdin after write (for "write" action)
-- offset: Log offset (for "log" action)
-- limit: Log limit (for "log" action)
-
-Respond with a JSON object containing the extracted parameters:
-\`\`\`json
-{
-  "action": "list|poll|log|write|send-keys|submit|paste|kill|clear|remove",
-  "sessionId": "optional-session-id",
-  "data": "optional-data",
-  "keys": ["optional", "key", "tokens"],
-  "literal": "optional-literal",
-  "text": "optional-paste-text",
-  "eof": false,
-  "offset": 0,
-  "limit": 100
-}
-\`\`\``;
-function extractJsonFromResponse(response) {
-  const jsonMatch = response.match(/```json\s*([\s\S]*?)\s*```/);
-  if (jsonMatch?.[1]) {
-    try {
-      return JSON.parse(jsonMatch[1]);
-    } catch {}
-  }
-  try {
-    const trimmed = response.trim();
-    if (trimmed.startsWith("{") && trimmed.endsWith("}")) {
-      return JSON.parse(trimmed);
-    }
-  } catch {}
-  return null;
-}
-var processAction = {
-  name: "MANAGE_PROCESS",
-  similes: [
-    "PROCESS_LIST",
-    "PROCESS_POLL",
-    "PROCESS_LOG",
-    "PROCESS_WRITE",
-    "PROCESS_KILL",
-    "LIST_SESSIONS",
-    "POLL_SESSION",
-    "KILL_SESSION",
-    "CHECK_PROCESS",
-    "SEND_KEYS"
-  ],
-  description: "Manage running shell/exec sessions: list, poll, log, write, send-keys, submit, paste, kill, clear, remove",
-  validate: async (_runtime, message) => {
-    const text = message.content.text?.toLowerCase() || "";
-    const processKeywords = [
-      "process",
-      "session",
-      "sessions",
-      "list",
-      "poll",
-      "log",
-      "write",
-      "send-keys",
-      "send keys",
-      "submit",
-      "paste",
-      "kill",
-      "clear",
-      "remove",
-      "running",
-      "background"
-    ];
-    const actionKeywords = [
-      "check",
-      "show",
-      "get",
-      "view",
-      "manage",
-      "stop",
-      "terminate",
-      "status"
-    ];
-    const hasProcessKeyword = processKeywords.some((kw) => text.includes(kw));
-    const hasActionKeyword = actionKeywords.some((kw) => text.includes(kw));
-    return hasProcessKeyword || hasActionKeyword && text.includes("session");
-  },
-  handler: async (runtime, message, state) => {
-    const shellService = runtime.getService("shell");
-    if (!shellService) {
-      return {
-        success: false,
-        text: "Shell service is not available.",
-        error: "Shell service not found"
-      };
-    }
-    const composedState = state ?? await runtime.composeState(message);
-    const prompt = composePromptFromState2({
-      state: composedState,
-      template: processActionTemplate
-    });
-    let params = null;
-    const text = message.content.text?.toLowerCase() || "";
-    if (text.includes("list") && (text.includes("session") || text.includes("process"))) {
-      params = { action: "list" };
-    } else {
-      try {
-        const response = await runtime.useModel(ModelType2.TEXT_SMALL, {
-          prompt
-        });
-        params = extractJsonFromResponse(String(response));
-      } catch (error) {
-        logger3.error("Failed to extract process parameters:", error);
-      }
-    }
-    if (!params) {
-      params = { action: "list" };
-    }
-    const result = await shellService.processAction(params);
-    return {
-      success: result.success,
-      text: result.message
-    };
-  },
-  examples: [
-    [
-      {
-        name: "{{user1}}",
-        content: { text: "List all running processes" }
-      },
-      {
-        name: "{{agentName}}",
-        content: {
-          text: `Here are the running sessions:
-calm-harbor running 5m30s :: npm install
-brisk-reef completed 2m15s :: git status`,
-          action: "MANAGE_PROCESS"
-        }
-      }
-    ],
-    [
-      {
-        name: "{{user1}}",
-        content: { text: "Check the status of session calm-harbor" }
-      },
-      {
-        name: "{{agentName}}",
-        content: {
-          text: `Session calm-harbor is still running.
-
-Output:
-npm WARN deprecated...
-
-Process still running.`,
-          action: "MANAGE_PROCESS"
-        }
-      }
-    ],
-    [
-      {
-        name: "{{user1}}",
-        content: { text: "Kill the session brisk-reef" }
-      },
-      {
-        name: "{{agentName}}",
-        content: {
-          text: "Killed session brisk-reef.",
-          action: "MANAGE_PROCESS"
-        }
-      }
-    ]
-  ]
-};
 // approvals/allowlist.ts
 import crypto2 from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { logger as logger4 } from "@elizaos/core";
+import { logger as logger2 } from "@elizaos/core";
 
 // approvals/types.ts
 var DEFAULT_SAFE_BINS = [
@@ -1920,12 +1516,12 @@ function readApprovalsSnapshot() {
   try {
     parsed = JSON.parse(raw);
   } catch (parseError) {
-    logger4.warn({ src: "exec-approval", parseError, filePath }, "Failed to parse approval config snapshot - file may be corrupted");
+    logger2.warn({ src: "exec-approval", parseError, filePath }, "Failed to parse approval config snapshot - file may be corrupted");
     parsed = null;
   }
   const file = parsed?.version === 1 ? normalizeApprovals(parsed) : normalizeApprovals({ version: 1, agents: {} });
   if (parsed && parsed.version !== 1) {
-    logger4.warn({ src: "exec-approval", version: parsed.version, filePath }, "Approval config snapshot has unexpected version");
+    logger2.warn({ src: "exec-approval", version: parsed.version, filePath }, "Approval config snapshot has unexpected version");
   }
   return {
     path: filePath,
@@ -1939,7 +1535,7 @@ function loadApprovals() {
   const filePath = getApprovalFilePath();
   try {
     if (!fs.existsSync(filePath)) {
-      logger4.debug({ src: "exec-approval", filePath }, "Approval config file does not exist, using defaults");
+      logger2.debug({ src: "exec-approval", filePath }, "Approval config file does not exist, using defaults");
       return normalizeApprovals({ version: 1, agents: {} });
     }
     const raw = fs.readFileSync(filePath, "utf8");
@@ -1947,16 +1543,16 @@ function loadApprovals() {
     try {
       parsed = JSON.parse(raw);
     } catch (parseError) {
-      logger4.error({ src: "exec-approval", parseError, filePath }, "Failed to parse approval config JSON - file may be corrupted. Using defaults.");
+      logger2.error({ src: "exec-approval", parseError, filePath }, "Failed to parse approval config JSON - file may be corrupted. Using defaults.");
       return normalizeApprovals({ version: 1, agents: {} });
     }
     if (parsed?.version !== 1) {
-      logger4.warn({ src: "exec-approval", version: parsed?.version, filePath }, "Approval config has unexpected version, using defaults");
+      logger2.warn({ src: "exec-approval", version: parsed?.version, filePath }, "Approval config has unexpected version, using defaults");
       return normalizeApprovals({ version: 1, agents: {} });
     }
     return normalizeApprovals(parsed);
   } catch (error) {
-    logger4.error({ src: "exec-approval", error, filePath }, "Failed to load approval config - using defaults. This may indicate a permissions issue.");
+    logger2.error({ src: "exec-approval", error, filePath }, "Failed to load approval config - using defaults. This may indicate a permissions issue.");
     return normalizeApprovals({ version: 1, agents: {} });
   }
 }
@@ -1972,7 +1568,7 @@ function saveApprovals(file) {
       fs.chmodSync(filePath, 384);
     } catch {}
   } catch (error) {
-    logger4.error({ src: "exec-approval", error, filePath }, "Failed to save approval configuration");
+    logger2.error({ src: "exec-approval", error, filePath }, "Failed to save approval configuration");
     throw new Error(`Failed to save approval configuration to ${filePath}: ${error}`);
   }
 }
@@ -1991,7 +1587,7 @@ function ensureApprovals() {
   try {
     saveApprovals(updated);
   } catch (error) {
-    logger4.warn({ src: "exec-approval", error }, "Failed to save approval config during ensureApprovals - " + "returning in-memory config. Changes will not persist.");
+    logger2.warn({ src: "exec-approval", error }, "Failed to save approval config during ensureApprovals - " + "returning in-memory config. Changes will not persist.");
     throw error;
   }
   return updated;
@@ -2013,7 +1609,7 @@ function resolveApprovals(agentId, overrides) {
   try {
     file = ensureApprovals();
   } catch (error) {
-    logger4.warn({ src: "exec-approval", error }, "Could not ensure approval config exists - using read-only config");
+    logger2.warn({ src: "exec-approval", error }, "Could not ensure approval config exists - using read-only config");
     file = loadApprovals();
   }
   return resolveApprovalsFromFile({
@@ -2155,7 +1751,7 @@ function recordAllowlistUse(approvals, agentId, entry, command, resolvedPath) {
     saveApprovals(approvals);
     return true;
   } catch (error) {
-    logger4.warn({ src: "exec-approval", error, pattern: entry.pattern }, "Failed to record allowlist usage - continuing without update");
+    logger2.warn({ src: "exec-approval", error, pattern: entry.pattern }, "Failed to record allowlist usage - continuing without update");
     return false;
   }
 }
@@ -2166,11 +1762,11 @@ function addAllowlistEntry(approvals, agentId, pattern) {
   const allowlist = Array.isArray(existing.allowlist) ? existing.allowlist : [];
   const trimmed = pattern.trim();
   if (!trimmed) {
-    logger4.warn({ src: "exec-approval" }, "Attempted to add empty pattern to allowlist");
+    logger2.warn({ src: "exec-approval" }, "Attempted to add empty pattern to allowlist");
     return false;
   }
   if (allowlist.some((entry) => entry.pattern === trimmed)) {
-    logger4.debug({ src: "exec-approval", pattern: trimmed }, "Pattern already in allowlist");
+    logger2.debug({ src: "exec-approval", pattern: trimmed }, "Pattern already in allowlist");
     return false;
   }
   allowlist.push({
@@ -2182,10 +1778,10 @@ function addAllowlistEntry(approvals, agentId, pattern) {
   approvals.agents = agents;
   try {
     saveApprovals(approvals);
-    logger4.info({ src: "exec-approval", pattern: trimmed, agentId: target }, "Added pattern to allowlist");
+    logger2.info({ src: "exec-approval", pattern: trimmed, agentId: target }, "Added pattern to allowlist");
     return true;
   } catch (error) {
-    logger4.error({ src: "exec-approval", error, pattern: trimmed }, "Failed to save allowlist after adding entry");
+    logger2.error({ src: "exec-approval", error, pattern: trimmed }, "Failed to save allowlist after adding entry");
     return false;
   }
 }
@@ -2902,7 +2498,7 @@ function requiresExecApproval(params) {
   return params.ask === "always" || params.ask === "on-miss" && params.security === "allowlist" && (!params.analysisOk || !params.allowlistSatisfied);
 }
 // approvals/service.ts
-import { logger as logger5, Service } from "@elizaos/core";
+import { logger as logger3, Service } from "@elizaos/core";
 var EXEC_APPROVAL_OPTIONS = [
   { name: "allow-once", description: "Allow this one time" },
   { name: "allow-always", description: "Always allow this" },
@@ -2925,7 +2521,7 @@ class ExecApprovalService extends Service {
     try {
       service.approvalConfig = resolveApprovals(runtime.agentId);
     } catch (error) {
-      logger5.error({ src: "service:exec_approval", error, agentId: runtime.agentId }, "Failed to load approval config during startup - using in-memory defaults. " + "Approvals may not persist. Check file permissions for ~/.eliza/exec-approvals.json");
+      logger3.error({ src: "service:exec_approval", error, agentId: runtime.agentId }, "Failed to load approval config during startup - using in-memory defaults. " + "Approvals may not persist. Check file permissions for ~/.eliza/exec-approvals.json");
       service.approvalConfig = {
         path: "",
         socketPath: "",
@@ -2946,11 +2542,11 @@ class ExecApprovalService extends Service {
         file: { version: 1, agents: {} }
       };
     }
-    logger5.info({ src: "service:exec_approval", agentId: runtime.agentId }, "ExecApprovalService started");
+    logger3.info({ src: "service:exec_approval", agentId: runtime.agentId }, "ExecApprovalService started");
     return service;
   }
   async stop() {
-    logger5.debug({ src: "service:exec_approval" }, "ExecApprovalService stopped");
+    logger3.debug({ src: "service:exec_approval" }, "ExecApprovalService stopped");
   }
   loadConfig(agentId) {
     this.approvalConfig = resolveApprovals(agentId ?? this.runtime?.agentId);
@@ -3022,7 +2618,7 @@ class ExecApprovalService extends Service {
         }
       }
       if (recordingFailed) {
-        logger5.debug({ src: "service:exec_approval", command: params.command }, "Some allowlist usage records failed to save - command will still proceed");
+        logger3.debug({ src: "service:exec_approval", command: params.command }, "Some allowlist usage records failed to save - command will still proceed");
       }
       return {
         allowed: true,
@@ -3078,7 +2674,7 @@ class ExecApprovalService extends Service {
   async requestApproval(request) {
     const approvalService = this.runtime?.getService("approval");
     if (!approvalService) {
-      logger5.warn({ src: "service:exec_approval" }, "ApprovalService not available, denying by default");
+      logger3.warn({ src: "service:exec_approval" }, "ApprovalService not available, denying by default");
       return {
         decision: "deny",
         timedOut: false
@@ -3130,7 +2726,7 @@ class ExecApprovalService extends Service {
   async requestApprovalAsync(request, callbacks) {
     const approvalService = this.runtime?.getService("approval");
     if (!approvalService) {
-      logger5.warn({ src: "service:exec_approval" }, "ApprovalService not available");
+      logger3.warn({ src: "service:exec_approval" }, "ApprovalService not available");
       if (callbacks?.onDenied) {
         await callbacks.onDenied();
       }
@@ -3205,7 +2801,7 @@ class ExecApprovalService extends Service {
   }
   async getPendingApprovals(roomId) {
     if (!this.runtime) {
-      logger5.warn({ src: "service:exec_approval" }, "Cannot get pending approvals - runtime not available");
+      logger3.warn({ src: "service:exec_approval" }, "Cannot get pending approvals - runtime not available");
       return [];
     }
     try {
@@ -3229,7 +2825,7 @@ class ExecApprovalService extends Service {
         };
       });
     } catch (error) {
-      logger5.error({ src: "service:exec_approval", error, roomId }, "Failed to get pending approvals");
+      logger3.error({ src: "service:exec_approval", error, roomId }, "Failed to get pending approvals");
       return [];
     }
   }
@@ -3247,19 +2843,20 @@ function mapOptionToDecision(option) {
 // providers/shellHistoryProvider.ts
 import {
   addHeader,
-  logger as logger6
+  logger as logger4
 } from "@elizaos/core";
 var MAX_OUTPUT_LENGTH = 8000;
 var TRUNCATE_SEGMENT_LENGTH = 4000;
-var spec3 = requireProviderSpec("SHELL_HISTORY");
+var spec2 = requireProviderSpec("SHELL_HISTORY");
 var shellHistoryProvider = {
-  name: spec3.name,
+  name: spec2.name,
   description: "Provides recent shell command history, current working directory, and file operations within the restricted environment",
   position: 99,
+  dynamic: true,
   get: async (runtime, message, _state) => {
     const shellService = runtime.getService("shell");
     if (!shellService) {
-      logger6.warn("[shellHistoryProvider] Shell service not found");
+      logger4.warn("[shellHistoryProvider] Shell service not found");
       return {
         values: {
           shellHistory: "Shell service is not available",
@@ -3359,15 +2956,62 @@ ${addHeader("# Shell History (Last 10)", historyText)}${fileOpsText}`;
     };
   }
 };
+// providers/terminalUsage.ts
+import { validateActionKeywords, validateActionRegex } from "@elizaos/core";
+var terminalUsageProvider = {
+  name: "terminalUsage",
+  description: "Terminal usage instructions",
+  dynamic: true,
+  relevanceKeywords: [
+    "terminalusage",
+    "terminalusageprovider",
+    "plugin",
+    "shell",
+    "status",
+    "state",
+    "context",
+    "info",
+    "details",
+    "chat",
+    "conversation",
+    "agent",
+    "room",
+    "channel"
+  ],
+  get: async (_runtime, _message, _state) => {
+    const __providerKeywords = ["terminalusage", "terminalusageprovider", "plugin", "shell", "status", "state", "context", "info", "details", "chat", "conversation", "agent", "room", "channel"];
+    const __providerRegex = new RegExp(`\\b(${__providerKeywords.join("|")})\\b`, "i");
+    const __recentMessages = _state?.recentMessagesData || [];
+    const __isRelevant = validateActionKeywords(_message, __recentMessages, __providerKeywords) || validateActionRegex(_message, __recentMessages, __providerRegex);
+    if (!__isRelevant) {
+      return { text: "" };
+    }
+    const settings = _runtime.character?.settings;
+    if (settings?.DISABLE_TERMINAL) {
+      return { text: "" };
+    }
+    return {
+      text: [
+        "## Terminal",
+        "",
+        "You can run shell commands in the user's embedded terminal using the RUN_IN_TERMINAL action.",
+        "Use this when the user asks you to run a command, execute a script, install packages, etc.",
+        "The terminal auto-opens and shows the command output in real time."
+      ].join(`
+`)
+    };
+  }
+};
+
 // services/shellService.ts
 import path6 from "node:path";
-import { logger as logger9, Service as Service2 } from "@elizaos/core";
+import { logger as logger7, Service as Service2 } from "@elizaos/core";
 import spawn2 from "cross-spawn";
 
 // utils/config.ts
 import fs3 from "node:fs";
 import path3 from "node:path";
-import { logger as logger7 } from "@elizaos/core";
+import { logger as logger5 } from "@elizaos/core";
 import { z } from "zod";
 var configSchema = z.object({
   enabled: z.boolean(),
@@ -3438,7 +3082,7 @@ function loadShellConfig() {
       throw new Error(`SHELL_ALLOWED_DIRECTORY is not a directory: ${allowedDirectory}`);
     }
     config.allowedDirectory = path3.resolve(allowedDirectory);
-    logger7.info(`Shell plugin enabled with allowed directory: ${config.allowedDirectory}, ` + `background: ${allowBackground}, timeout: ${timeout}ms`);
+    logger5.info(`Shell plugin enabled with allowed directory: ${config.allowedDirectory}, ` + `background: ${allowBackground}, timeout: ${timeout}ms`);
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
       throw new Error(`SHELL_ALLOWED_DIRECTORY does not exist: ${allowedDirectory}`);
@@ -3449,13 +3093,13 @@ function loadShellConfig() {
 }
 // utils/pathUtils.ts
 import path4 from "node:path";
-import { logger as logger8 } from "@elizaos/core";
+import { logger as logger6 } from "@elizaos/core";
 function validatePath(commandPath, allowedDir, currentDir) {
   const resolvedPath = path4.resolve(currentDir, commandPath);
   const normalizedPath = path4.normalize(resolvedPath);
   const normalizedAllowed = path4.normalize(allowedDir);
   if (!normalizedPath.startsWith(normalizedAllowed)) {
-    logger8.warn(`Path validation failed: ${normalizedPath} is outside allowed directory ${normalizedAllowed}`);
+    logger6.warn(`Path validation failed: ${normalizedPath} is outside allowed directory ${normalizedAllowed}`);
     return null;
   }
   return normalizedPath;
@@ -3472,19 +3116,19 @@ function isSafeCommand(command) {
   ];
   for (const pattern of pathTraversalPatterns) {
     if (pattern.test(command)) {
-      logger8.warn(`Path traversal detected in command: ${command}`);
+      logger6.warn(`Path traversal detected in command: ${command}`);
       return false;
     }
   }
   for (const pattern of dangerousPatterns) {
     if (pattern.test(command)) {
-      logger8.warn(`Dangerous pattern detected in command: ${command}`);
+      logger6.warn(`Dangerous pattern detected in command: ${command}`);
       return false;
     }
   }
   const pipeCount = (command.match(/\|/g) || []).length;
   if (pipeCount > 1) {
-    logger8.warn(`Multiple pipes detected in command: ${command}`);
+    logger6.warn(`Multiple pipes detected in command: ${command}`);
     return false;
   }
   return true;
@@ -4440,7 +4084,7 @@ class ShellService extends Service2 {
   }
   static async start(runtime) {
     const instance = new ShellService(runtime);
-    logger9.info("Shell service initialized with PTY, background execution, and history tracking");
+    logger7.info("Shell service initialized with PTY, background execution, and history tracking");
     return instance;
   }
   async stop() {
@@ -4448,13 +4092,13 @@ class ShellService extends Service2 {
     for (const session of runningSessions2) {
       try {
         killSession(session);
-        logger9.debug(`Killed shell session: ${session.id}`);
+        logger7.debug(`Killed shell session: ${session.id}`);
       } catch (err) {
-        logger9.warn(`Failed to kill shell session ${session.id}: ${err}`);
+        logger7.warn(`Failed to kill shell session ${session.id}: ${err}`);
       }
     }
     this.commandHistory.clear();
-    logger9.info(`Shell service stopped, cleaned up ${runningSessions2.length} running sessions`);
+    logger7.info(`Shell service stopped, cleaned up ${runningSessions2.length} running sessions`);
   }
   get capabilityDescription() {
     return "Execute shell commands with PTY support, background execution, and session management";
@@ -4476,7 +4120,7 @@ class ShellService extends Service2 {
     if (this.runtime && this.runtime.sandboxMode) {
       const hostApiUrl = this.runtime.getSetting("SANDBOX_HOST_API_URL") ?? "http://localhost:2138";
       const runtimeFetch = this.runtime.fetch ?? globalThis.fetch;
-      logger9.info(`[shell:sandbox] routing exec to ${hostApiUrl}: ${command.substring(0, 100)}`);
+      logger7.info(`[shell:sandbox] routing exec to ${hostApiUrl}: ${command.substring(0, 100)}`);
       try {
         const response = await runtimeFetch(`${hostApiUrl}/api/sandbox/exec`, {
           method: "POST",
@@ -4488,7 +4132,7 @@ class ShellService extends Service2 {
           })
         });
         const result2 = await response.json();
-        logger9.info(`[shell:sandbox] exec completed: exit=${result2.exitCode} duration=${result2.durationMs}ms`);
+        logger7.info(`[shell:sandbox] exec completed: exit=${result2.exitCode} duration=${result2.durationMs}ms`);
         return {
           success: result2.exitCode === 0,
           stdout: result2.stdout,
@@ -4498,7 +4142,7 @@ class ShellService extends Service2 {
         };
       } catch (err) {
         const errMsg = err instanceof Error ? err.message : String(err);
-        logger9.error(`[shell:sandbox] exec failed: ${errMsg}`);
+        logger7.error(`[shell:sandbox] exec failed: ${errMsg}`);
         return {
           success: false,
           stdout: "",
@@ -5110,7 +4754,7 @@ Warnings:
   }
   clearCommandHistory(conversationId) {
     this.commandHistory.delete(conversationId);
-    logger9.info(`Cleared command history for conversation: ${conversationId}`);
+    logger7.info(`Cleared command history for conversation: ${conversationId}`);
   }
   getCurrentDirectory(_conversationId) {
     return this.currentDirectory;
@@ -5170,12 +4814,12 @@ Warnings:
       if (useShell) {
         cmd = "sh";
         args = ["-c", command];
-        logger9.info(`Executing shell command: sh -c "${command}" in ${this.currentDirectory}`);
+        logger7.info(`Executing shell command: sh -c "${command}" in ${this.currentDirectory}`);
       } else {
         const parts = command.split(/\s+/);
         cmd = parts[0];
         args = parts.slice(1);
-        logger9.info(`Executing command: ${cmd} ${args.join(" ")} in ${this.currentDirectory}`);
+        logger7.info(`Executing command: ${cmd} ${args.join(" ")} in ${this.currentDirectory}`);
       }
       let stdout = "";
       let stderr = "";
@@ -5280,7 +4924,7 @@ Command timed out`,
       } catch (err) {
         const errText = String(err);
         const warning = `Warning: PTY spawn failed (${errText}); retrying without PTY.`;
-        logger9.warn(`exec: PTY spawn failed (${errText}); retrying without PTY.`);
+        logger7.warn(`exec: PTY spawn failed (${errText}); retrying without PTY.`);
         opts.warnings.push(warning);
       }
     }
@@ -5569,16 +5213,17 @@ ${String(err)}` : String(err);
 // index.ts
 var shellPlugin = {
   name: "shell",
-  description: "Execute shell commands with PTY support, background execution, session management, and approval workflows",
+  description: "Shell observability and history management providers",
   services: [ShellService, ExecApprovalService],
-  actions: [executeCommand, clearHistory, processAction],
-  providers: [shellHistoryProvider]
+  actions: [clearHistory],
+  providers: [shellHistoryProvider, terminalUsageProvider]
 };
 var typescript_default = shellPlugin;
 export {
   validatePath,
   truncateMiddle,
   trimWithCap,
+  terminalUsageProvider,
   tail,
   stripDsrRequests,
   spawnWithFallback,
@@ -5600,7 +5245,6 @@ export {
   recordAllowlistUse,
   readEnvInt,
   readApprovalsSnapshot,
-  processAction,
   pad,
   normalizeSafeBins,
   normalizeApprovals,
@@ -5626,7 +5270,6 @@ export {
   formatSpawnError,
   formatDuration,
   extractBaseCommand,
-  executeCommand,
   evaluateShellAllowlist,
   evaluateExecAllowlist,
   ensureApprovals,
@@ -5656,4 +5299,4 @@ export {
   BRACKETED_PASTE_END
 };
 
-//# debugId=6BFC18D74F82D0A464756E2164756E21
+//# debugId=EB43D3D65D87A50A64756E2164756E21