@mcpc-tech/core 0.3.38 → 0.3.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpc-tech/core",
-  "version": "0.3.38",
+  "version": "0.3.40",
   "homepage": "https://jsr.io/@mcpc/core",
   "dependencies": {
     "@ai-sdk/provider": "^2.0.0",
@@ -48,6 +48,11 @@
       "import": "./plugins/skills.mjs",
       "require": "./plugins/skills.cjs"
     },
+    "./plugins/bash": {
+      "types": "./types/src/plugins/bash.d.ts",
+      "import": "./plugins/bash.mjs",
+      "require": "./plugins/bash.cjs"
+    },
     "./types/*": "./types/*"
   },
   "repository": {

package/plugins/bash.cjs

@@ -0,0 +1,198 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// __mcpc__core_latest/node_modules/@mcpc/core/src/plugins/bash.ts
+var bash_exports = {};
+__export(bash_exports, {
+  createBashPlugin: () => createBashPlugin,
+  createPlugin: () => createPlugin,
+  default: () => bash_default,
+  executeBash: () => executeBash,
+  truncateOutput: () => truncateOutput
+});
+module.exports = __toCommonJS(bash_exports);
+var import_node_child_process = require("node:child_process");
+var import_node_process = __toESM(require("node:process"), 1);
+var DEFAULT_MAX_BYTES = 1e5;
+var DEFAULT_MAX_LINES = 2e3;
+var DEFAULT_TIMEOUT_MS = 6e4;
+function truncateOutput(stdout, stderr, maxBytes = DEFAULT_MAX_BYTES, maxLines = DEFAULT_MAX_LINES) {
+  const fullOutput = (stderr ? `STDERR:
+${stderr}
+
+STDOUT:
+` : "") + stdout;
+  const lines = fullOutput.split("\n");
+  if (lines.length > maxLines) {
+    const truncatedLines = lines.slice(-maxLines);
+    return {
+      output: `[OUTPUT TRUNCATED] Showing last ${maxLines} lines of ${lines.length} total
+
+` + truncatedLines.join("\n"),
+      truncated: true
+    };
+  }
+  if (fullOutput.length > maxBytes) {
+    const truncatedBytes = fullOutput.slice(-maxBytes);
+    return {
+      output: `[OUTPUT TRUNCATED] Showing last ${maxBytes} bytes of ${fullOutput.length} total
+
+` + truncatedBytes,
+      truncated: true
+    };
+  }
+  return { output: fullOutput, truncated: false };
+}
+function executeBash(command, cwd, timeoutMs) {
+  return new Promise((resolve) => {
+    const stdout = [];
+    const stderr = [];
+    const proc = (0, import_node_child_process.spawn)("bash", ["-c", command], {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    proc.stdout?.on("data", (data) => {
+      stdout.push(data.toString());
+    });
+    proc.stderr?.on("data", (data) => {
+      stderr.push(data.toString());
+    });
+    proc.on("close", (code) => {
+      resolve({
+        stdout: stdout.join(""),
+        stderr: stderr.join(""),
+        exitCode: code
+      });
+    });
+    proc.on("error", (err) => {
+      resolve({
+        stdout: "",
+        stderr: err.message,
+        exitCode: null
+      });
+    });
+    setTimeout(() => {
+      proc.kill("SIGTERM");
+      resolve({
+        stdout: stdout.join(""),
+        stderr: stderr.join("") + "\n\n[TIMEOUT] Command execution timed out",
+        exitCode: null
+      });
+    }, timeoutMs);
+  });
+}
+function createBashPlugin(options = {}) {
+  const { maxBytes, maxLines, timeoutMs } = {
+    maxBytes: DEFAULT_MAX_BYTES,
+    maxLines: DEFAULT_MAX_LINES,
+    timeoutMs: DEFAULT_TIMEOUT_MS,
+    ...options
+  };
+  let serverRef = null;
+  return {
+    name: "plugin-bash",
+    version: "1.0.0",
+    // Store server reference for tool registration
+    configureServer: (server) => {
+      serverRef = server;
+    },
+    // Register bash tool with agent name prefix
+    composeStart: (context) => {
+      if (!serverRef) return;
+      const agentName = context.serverName;
+      const toolName = `${agentName}__bash`;
+      serverRef.tool(
+        toolName,
+        "Execute a bash command and return its output.\n\nUse this for:\n- Running shell commands\n- Executing scripts\n- System operations\n\nNote: Output is truncated if too large.",
+        {
+          type: "object",
+          properties: {
+            command: {
+              type: "string",
+              description: "The bash command to execute"
+            },
+            cwd: {
+              type: "string",
+              description: "Optional: Working directory for the command (defaults to current directory)"
+            }
+          },
+          required: ["command"]
+        },
+        async (args) => {
+          const cwd = args.cwd || import_node_process.default.cwd();
+          const result = await executeBash(args.command, cwd, timeoutMs);
+          const { output, truncated } = truncateOutput(
+            result.stdout,
+            result.stderr,
+            maxBytes,
+            maxLines
+          );
+          let finalOutput = output;
+          if (result.exitCode !== null && result.exitCode !== 0) {
+            finalOutput = `[EXIT CODE: ${result.exitCode}]
+` + finalOutput;
+          }
+          if (truncated) {
+            finalOutput += `
+
+[Note: Output was truncated]`;
+          }
+          return {
+            content: [{ type: "text", text: finalOutput }],
+            isError: result.exitCode !== null && result.exitCode !== 0
+          };
+        },
+        { internal: true }
+      );
+    }
+  };
+}
+function createPlugin(params) {
+  const options = {};
+  if (params.maxBytes) {
+    const parsed = parseInt(params.maxBytes, 10);
+    if (!isNaN(parsed)) options.maxBytes = parsed;
+  }
+  if (params.maxLines) {
+    const parsed = parseInt(params.maxLines, 10);
+    if (!isNaN(parsed)) options.maxLines = parsed;
+  }
+  if (params.timeout) {
+    const parsed = parseInt(params.timeout, 10);
+    if (!isNaN(parsed)) options.timeoutMs = parsed * 1e3;
+  }
+  return createBashPlugin(options);
+}
+var bash_default = createBashPlugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createBashPlugin,
+  createPlugin,
+  executeBash,
+  truncateOutput
+});

package/plugins/bash.mjs

@@ -0,0 +1,164 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+
+// __mcpc__core_latest/node_modules/@mcpc/core/src/plugins/bash.ts
+import { spawn } from "node:child_process";
+import process from "node:process";
+var DEFAULT_MAX_BYTES = 1e5;
+var DEFAULT_MAX_LINES = 2e3;
+var DEFAULT_TIMEOUT_MS = 6e4;
+function truncateOutput(stdout, stderr, maxBytes = DEFAULT_MAX_BYTES, maxLines = DEFAULT_MAX_LINES) {
+  const fullOutput = (stderr ? `STDERR:
+${stderr}
+
+STDOUT:
+` : "") + stdout;
+  const lines = fullOutput.split("\n");
+  if (lines.length > maxLines) {
+    const truncatedLines = lines.slice(-maxLines);
+    return {
+      output: `[OUTPUT TRUNCATED] Showing last ${maxLines} lines of ${lines.length} total
+
+` + truncatedLines.join("\n"),
+      truncated: true
+    };
+  }
+  if (fullOutput.length > maxBytes) {
+    const truncatedBytes = fullOutput.slice(-maxBytes);
+    return {
+      output: `[OUTPUT TRUNCATED] Showing last ${maxBytes} bytes of ${fullOutput.length} total
+
+` + truncatedBytes,
+      truncated: true
+    };
+  }
+  return { output: fullOutput, truncated: false };
+}
+function executeBash(command, cwd, timeoutMs) {
+  return new Promise((resolve) => {
+    const stdout = [];
+    const stderr = [];
+    const proc = spawn("bash", ["-c", command], {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    proc.stdout?.on("data", (data) => {
+      stdout.push(data.toString());
+    });
+    proc.stderr?.on("data", (data) => {
+      stderr.push(data.toString());
+    });
+    proc.on("close", (code) => {
+      resolve({
+        stdout: stdout.join(""),
+        stderr: stderr.join(""),
+        exitCode: code
+      });
+    });
+    proc.on("error", (err) => {
+      resolve({
+        stdout: "",
+        stderr: err.message,
+        exitCode: null
+      });
+    });
+    setTimeout(() => {
+      proc.kill("SIGTERM");
+      resolve({
+        stdout: stdout.join(""),
+        stderr: stderr.join("") + "\n\n[TIMEOUT] Command execution timed out",
+        exitCode: null
+      });
+    }, timeoutMs);
+  });
+}
+function createBashPlugin(options = {}) {
+  const { maxBytes, maxLines, timeoutMs } = {
+    maxBytes: DEFAULT_MAX_BYTES,
+    maxLines: DEFAULT_MAX_LINES,
+    timeoutMs: DEFAULT_TIMEOUT_MS,
+    ...options
+  };
+  let serverRef = null;
+  return {
+    name: "plugin-bash",
+    version: "1.0.0",
+    // Store server reference for tool registration
+    configureServer: (server) => {
+      serverRef = server;
+    },
+    // Register bash tool with agent name prefix
+    composeStart: (context) => {
+      if (!serverRef) return;
+      const agentName = context.serverName;
+      const toolName = `${agentName}__bash`;
+      serverRef.tool(
+        toolName,
+        "Execute a bash command and return its output.\n\nUse this for:\n- Running shell commands\n- Executing scripts\n- System operations\n\nNote: Output is truncated if too large.",
+        {
+          type: "object",
+          properties: {
+            command: {
+              type: "string",
+              description: "The bash command to execute"
+            },
+            cwd: {
+              type: "string",
+              description: "Optional: Working directory for the command (defaults to current directory)"
+            }
+          },
+          required: ["command"]
+        },
+        async (args) => {
+          const cwd = args.cwd || process.cwd();
+          const result = await executeBash(args.command, cwd, timeoutMs);
+          const { output, truncated } = truncateOutput(
+            result.stdout,
+            result.stderr,
+            maxBytes,
+            maxLines
+          );
+          let finalOutput = output;
+          if (result.exitCode !== null && result.exitCode !== 0) {
+            finalOutput = `[EXIT CODE: ${result.exitCode}]
+` + finalOutput;
+          }
+          if (truncated) {
+            finalOutput += `
+
+[Note: Output was truncated]`;
+          }
+          return {
+            content: [{ type: "text", text: finalOutput }],
+            isError: result.exitCode !== null && result.exitCode !== 0
+          };
+        },
+        { internal: true }
+      );
+    }
+  };
+}
+function createPlugin(params) {
+  const options = {};
+  if (params.maxBytes) {
+    const parsed = parseInt(params.maxBytes, 10);
+    if (!isNaN(parsed)) options.maxBytes = parsed;
+  }
+  if (params.maxLines) {
+    const parsed = parseInt(params.maxLines, 10);
+    if (!isNaN(parsed)) options.maxLines = parsed;
+  }
+  if (params.timeout) {
+    const parsed = parseInt(params.timeout, 10);
+    if (!isNaN(parsed)) options.timeoutMs = parsed * 1e3;
+  }
+  return createBashPlugin(options);
+}
+var bash_default = createBashPlugin;
+export {
+  createBashPlugin,
+  createPlugin,
+  bash_default as default,
+  executeBash,
+  truncateOutput
+};

package/plugins/skills.cjs

@@ -105,7 +105,7 @@ Usage:
 - ${toolName}({ skill: "skill-name" }) - Load main SKILL.md content
 - ${toolName}({ skill: "skill-name", ref: "path/to/file" }) - Load reference file
 
-Note: For scripts/ and assets/, use appropriate tools directly.`;
+Note: For scripts/, use the bash tool with the script path to execute.`;
 }
 function createSkillsPlugin(options) {
   const { paths } = options;
@@ -205,7 +205,13 @@ Available skills: ${available.join(", ")}` : "\n\nNo skills available.";
                 "utf-8"
               );
               const body = extractBody(content);
-              return { content: [{ type: "text", text: body }] };
+              const skillPathInfo = `
+---
+Skill path: ${meta.basePath}
+`;
+              return {
+                content: [{ type: "text", text: body + skillPathInfo }]
+              };
             } catch {
               return {
                 content: [

package/plugins/skills.mjs

@@ -83,7 +83,7 @@ Usage:
 - ${toolName}({ skill: "skill-name" }) - Load main SKILL.md content
 - ${toolName}({ skill: "skill-name", ref: "path/to/file" }) - Load reference file
 
-Note: For scripts/ and assets/, use appropriate tools directly.`;
+Note: For scripts/, use the bash tool with the script path to execute.`;
 }
 function createSkillsPlugin(options) {
   const { paths } = options;
@@ -183,7 +183,13 @@ Available skills: ${available.join(", ")}` : "\n\nNo skills available.";
                 "utf-8"
               );
               const body = extractBody(content);
-              return { content: [{ type: "text", text: body }] };
+              const skillPathInfo = `
+---
+Skill path: ${meta.basePath}
+`;
+              return {
+                content: [{ type: "text", text: body + skillPathInfo }]
+              };
             } catch {
               return {
                 content: [

package/plugins.cjs

@@ -29,6 +29,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // __mcpc__core_latest/node_modules/@mcpc/core/plugins.ts
 var plugins_exports = {};
 __export(plugins_exports, {
+  createBashPlugin: () => createBashPlugin,
   createLargeResultPlugin: () => createLargeResultPlugin,
   createSearchPlugin: () => createSearchPlugin,
   createSkillsPlugin: () => createSkillsPlugin,
@@ -447,7 +448,7 @@ Usage:
 - ${toolName}({ skill: "skill-name" }) - Load main SKILL.md content
 - ${toolName}({ skill: "skill-name", ref: "path/to/file" }) - Load reference file
 
-Note: For scripts/ and assets/, use appropriate tools directly.`;
+Note: For scripts/, use the bash tool with the script path to execute.`;
 }
 function createSkillsPlugin(options) {
   const { paths } = options;
@@ -555,11 +556,15 @@ Available skills: ${available.join(", ")}` : "\n\nNo skills available.";
           try {
             const content = await (0, import_promises2.readFile)((0, import_node_path4.join)(meta.basePath, "SKILL.md"), "utf-8");
             const body = extractBody(content);
+            const skillPathInfo = `
+---
+Skill path: ${meta.basePath}
+`;
             return {
               content: [
                 {
                   type: "text",
-                  text: body
+                  text: body + skillPathInfo
                 }
               ]
             };
@@ -585,8 +590,155 @@ Available skills: ${available.join(", ")}` : "\n\nNo skills available.";
     }
   };
 }
+
+// __mcpc__core_latest/node_modules/@mcpc/core/src/plugins/bash.js
+var import_node_child_process = require("node:child_process");
+var import_node_process = __toESM(require("node:process"), 1);
+var DEFAULT_MAX_BYTES = 1e5;
+var DEFAULT_MAX_LINES = 2e3;
+var DEFAULT_TIMEOUT_MS = 6e4;
+function truncateOutput(stdout, stderr, maxBytes = DEFAULT_MAX_BYTES, maxLines = DEFAULT_MAX_LINES) {
+  const fullOutput = (stderr ? `STDERR:
+${stderr}
+
+STDOUT:
+` : "") + stdout;
+  const lines = fullOutput.split("\n");
+  if (lines.length > maxLines) {
+    const truncatedLines = lines.slice(-maxLines);
+    return {
+      output: `[OUTPUT TRUNCATED] Showing last ${maxLines} lines of ${lines.length} total
+
+` + truncatedLines.join("\n"),
+      truncated: true
+    };
+  }
+  if (fullOutput.length > maxBytes) {
+    const truncatedBytes = fullOutput.slice(-maxBytes);
+    return {
+      output: `[OUTPUT TRUNCATED] Showing last ${maxBytes} bytes of ${fullOutput.length} total
+
+` + truncatedBytes,
+      truncated: true
+    };
+  }
+  return {
+    output: fullOutput,
+    truncated: false
+  };
+}
+function executeBash(command, cwd, timeoutMs) {
+  return new Promise((resolve3) => {
+    const stdout = [];
+    const stderr = [];
+    const proc = (0, import_node_child_process.spawn)("bash", [
+      "-c",
+      command
+    ], {
+      cwd,
+      stdio: [
+        "ignore",
+        "pipe",
+        "pipe"
+      ]
+    });
+    proc.stdout?.on("data", (data) => {
+      stdout.push(data.toString());
+    });
+    proc.stderr?.on("data", (data) => {
+      stderr.push(data.toString());
+    });
+    proc.on("close", (code) => {
+      resolve3({
+        stdout: stdout.join(""),
+        stderr: stderr.join(""),
+        exitCode: code
+      });
+    });
+    proc.on("error", (err) => {
+      resolve3({
+        stdout: "",
+        stderr: err.message,
+        exitCode: null
+      });
+    });
+    setTimeout(() => {
+      proc.kill("SIGTERM");
+      resolve3({
+        stdout: stdout.join(""),
+        stderr: stderr.join("") + "\n\n[TIMEOUT] Command execution timed out",
+        exitCode: null
+      });
+    }, timeoutMs);
+  });
+}
+function createBashPlugin(options = {}) {
+  const { maxBytes, maxLines, timeoutMs } = {
+    maxBytes: DEFAULT_MAX_BYTES,
+    maxLines: DEFAULT_MAX_LINES,
+    timeoutMs: DEFAULT_TIMEOUT_MS,
+    ...options
+  };
+  let serverRef = null;
+  return {
+    name: "plugin-bash",
+    version: "1.0.0",
+    // Store server reference for tool registration
+    configureServer: (server) => {
+      serverRef = server;
+    },
+    // Register bash tool with agent name prefix
+    composeStart: (context) => {
+      if (!serverRef) return;
+      const agentName = context.serverName;
+      const toolName = `${agentName}__bash`;
+      serverRef.tool(toolName, "Execute a bash command and return its output.\n\nUse this for:\n- Running shell commands\n- Executing scripts\n- System operations\n\nNote: Output is truncated if too large.", {
+        type: "object",
+        properties: {
+          command: {
+            type: "string",
+            description: "The bash command to execute"
+          },
+          cwd: {
+            type: "string",
+            description: "Optional: Working directory for the command (defaults to current directory)"
+          }
+        },
+        required: [
+          "command"
+        ]
+      }, async (args) => {
+        const cwd = args.cwd || import_node_process.default.cwd();
+        const result = await executeBash(args.command, cwd, timeoutMs);
+        const { output, truncated } = truncateOutput(result.stdout, result.stderr, maxBytes, maxLines);
+        let finalOutput = output;
+        if (result.exitCode !== null && result.exitCode !== 0) {
+          finalOutput = `[EXIT CODE: ${result.exitCode}]
+` + finalOutput;
+        }
+        if (truncated) {
+          finalOutput += `
+
+[Note: Output was truncated]`;
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: finalOutput
+            }
+          ],
+          isError: result.exitCode !== null && result.exitCode !== 0
+        };
+      }, {
+        internal: true
+      });
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createBashPlugin,
   createLargeResultPlugin,
   createSearchPlugin,
   createSkillsPlugin,

package/plugins.mjs

@@ -411,7 +411,7 @@ Usage:
 - ${toolName}({ skill: "skill-name" }) - Load main SKILL.md content
 - ${toolName}({ skill: "skill-name", ref: "path/to/file" }) - Load reference file
 
-Note: For scripts/ and assets/, use appropriate tools directly.`;
+Note: For scripts/, use the bash tool with the script path to execute.`;
 }
 function createSkillsPlugin(options) {
   const { paths } = options;
@@ -519,11 +519,15 @@ Available skills: ${available.join(", ")}` : "\n\nNo skills available.";
           try {
             const content = await readFile(join2(meta.basePath, "SKILL.md"), "utf-8");
             const body = extractBody(content);
+            const skillPathInfo = `
+---
+Skill path: ${meta.basePath}
+`;
             return {
               content: [
                 {
                   type: "text",
-                  text: body
+                  text: body + skillPathInfo
                 }
               ]
             };
@@ -549,7 +553,154 @@ Available skills: ${available.join(", ")}` : "\n\nNo skills available.";
     }
   };
 }
+
+// __mcpc__core_latest/node_modules/@mcpc/core/src/plugins/bash.js
+import { spawn } from "node:child_process";
+import process from "node:process";
+var DEFAULT_MAX_BYTES = 1e5;
+var DEFAULT_MAX_LINES = 2e3;
+var DEFAULT_TIMEOUT_MS = 6e4;
+function truncateOutput(stdout, stderr, maxBytes = DEFAULT_MAX_BYTES, maxLines = DEFAULT_MAX_LINES) {
+  const fullOutput = (stderr ? `STDERR:
+${stderr}
+
+STDOUT:
+` : "") + stdout;
+  const lines = fullOutput.split("\n");
+  if (lines.length > maxLines) {
+    const truncatedLines = lines.slice(-maxLines);
+    return {
+      output: `[OUTPUT TRUNCATED] Showing last ${maxLines} lines of ${lines.length} total
+
+` + truncatedLines.join("\n"),
+      truncated: true
+    };
+  }
+  if (fullOutput.length > maxBytes) {
+    const truncatedBytes = fullOutput.slice(-maxBytes);
+    return {
+      output: `[OUTPUT TRUNCATED] Showing last ${maxBytes} bytes of ${fullOutput.length} total
+
+` + truncatedBytes,
+      truncated: true
+    };
+  }
+  return {
+    output: fullOutput,
+    truncated: false
+  };
+}
+function executeBash(command, cwd, timeoutMs) {
+  return new Promise((resolve3) => {
+    const stdout = [];
+    const stderr = [];
+    const proc = spawn("bash", [
+      "-c",
+      command
+    ], {
+      cwd,
+      stdio: [
+        "ignore",
+        "pipe",
+        "pipe"
+      ]
+    });
+    proc.stdout?.on("data", (data) => {
+      stdout.push(data.toString());
+    });
+    proc.stderr?.on("data", (data) => {
+      stderr.push(data.toString());
+    });
+    proc.on("close", (code) => {
+      resolve3({
+        stdout: stdout.join(""),
+        stderr: stderr.join(""),
+        exitCode: code
+      });
+    });
+    proc.on("error", (err) => {
+      resolve3({
+        stdout: "",
+        stderr: err.message,
+        exitCode: null
+      });
+    });
+    setTimeout(() => {
+      proc.kill("SIGTERM");
+      resolve3({
+        stdout: stdout.join(""),
+        stderr: stderr.join("") + "\n\n[TIMEOUT] Command execution timed out",
+        exitCode: null
+      });
+    }, timeoutMs);
+  });
+}
+function createBashPlugin(options = {}) {
+  const { maxBytes, maxLines, timeoutMs } = {
+    maxBytes: DEFAULT_MAX_BYTES,
+    maxLines: DEFAULT_MAX_LINES,
+    timeoutMs: DEFAULT_TIMEOUT_MS,
+    ...options
+  };
+  let serverRef = null;
+  return {
+    name: "plugin-bash",
+    version: "1.0.0",
+    // Store server reference for tool registration
+    configureServer: (server) => {
+      serverRef = server;
+    },
+    // Register bash tool with agent name prefix
+    composeStart: (context) => {
+      if (!serverRef) return;
+      const agentName = context.serverName;
+      const toolName = `${agentName}__bash`;
+      serverRef.tool(toolName, "Execute a bash command and return its output.\n\nUse this for:\n- Running shell commands\n- Executing scripts\n- System operations\n\nNote: Output is truncated if too large.", {
+        type: "object",
+        properties: {
+          command: {
+            type: "string",
+            description: "The bash command to execute"
+          },
+          cwd: {
+            type: "string",
+            description: "Optional: Working directory for the command (defaults to current directory)"
+          }
+        },
+        required: [
+          "command"
+        ]
+      }, async (args) => {
+        const cwd = args.cwd || process.cwd();
+        const result = await executeBash(args.command, cwd, timeoutMs);
+        const { output, truncated } = truncateOutput(result.stdout, result.stderr, maxBytes, maxLines);
+        let finalOutput = output;
+        if (result.exitCode !== null && result.exitCode !== 0) {
+          finalOutput = `[EXIT CODE: ${result.exitCode}]
+` + finalOutput;
+        }
+        if (truncated) {
+          finalOutput += `
+
+[Note: Output was truncated]`;
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: finalOutput
+            }
+          ],
+          isError: result.exitCode !== null && result.exitCode !== 0
+        };
+      }, {
+        internal: true
+      });
+    }
+  };
+}
 export {
+  createBashPlugin,
   createLargeResultPlugin,
   createSearchPlugin,
   createSkillsPlugin,

package/types/plugins.d.ts

@@ -38,6 +38,7 @@
  */ export { createSearchPlugin } from "./src/plugins/search-tool.js";
 export { createLargeResultPlugin } from "./src/plugins/large-result.js";
 export { createSkillsPlugin } from "./src/plugins/skills.js";
+export { createBashPlugin } from "./src/plugins/bash.js";
 export { default as defaultSearchPlugin } from "./src/plugins/search-tool.js";
 export { default as defaultLargeResultPlugin } from "./src/plugins/large-result.js";
 export type { SearchOptions } from "./src/plugins/search-tool.js";

package/types/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sources":["../plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCC,GAGD,SAAS,kBAAkB,uCAAuC;AAClE,SAAS,uBAAuB,wCAAwC;AACxE,SAAS,kBAAkB,kCAAkC;AAG7D,SAAS,WAAW,mBAAmB,uCAAuC;AAC9E,SAAS,WAAW,wBAAwB,wCAAwC;AAGpF,cAAc,aAAa,uCAAuC"}
+{"version":3,"file":"plugins.d.ts","sources":["../plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCC,GAGD,SAAS,kBAAkB,uCAAuC;AAClE,SAAS,uBAAuB,wCAAwC;AACxE,SAAS,kBAAkB,kCAAkC;AAC7D,SAAS,gBAAgB,gCAAgC;AAGzD,SAAS,WAAW,mBAAmB,uCAAuC;AAC9E,SAAS,WAAW,wBAAwB,wCAAwC;AAGpF,cAAc,aAAa,uCAAuC"}

package/types/src/plugins/bash.d.ts

@@ -0,0 +1,37 @@
+import type { ToolPlugin } from "../plugin-types.js";
+export interface BashPluginOptions {
+  /** Maximum output bytes to return */ maxBytes?: number;
+  /** Maximum output lines to return */ maxLines?: number;
+  /** Command execution timeout in ms */ timeoutMs?: number;
+}
+/**
+ * Truncate output to prevent context pollution
+ */ export declare function truncateOutput(stdout: string, stderr: string, maxBytes?: number, maxLines?: number): {
+  output: string;
+  truncated: boolean;
+};
+/**
+ * Execute a bash command
+ */ export declare function executeBash(command: string, cwd: string, timeoutMs: number): Promise<{
+  stdout: string;
+  stderr: string;
+  exitCode: number | null;
+}>;
+/**
+ * Create a bash plugin that provides command execution capability
+ */ export declare function createBashPlugin(options?: BashPluginOptions): ToolPlugin;
+/**
+ * Factory function for parameterized usage via string path
+ *
+ * Supports query parameters:
+ * - maxBytes: Maximum output bytes (default: 100000)
+ * - maxLines: Maximum output lines (default: 2000)
+ * - timeout: Timeout in seconds (default: 60)
+ *
+ * @example
+ * ```ts
+ * plugins: ["@mcpc/core/plugins/bash?maxBytes=50000&timeout=30"]
+ * ```
+ */ export declare function createPlugin(params: Record<string, string>): ToolPlugin;
+export default createBashPlugin;
+//# sourceMappingURL=bash.d.ts.map

package/types/src/plugins/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sources":["../../../src/plugins/bash.ts"],"names":[],"mappings":"AAWA,cAAmC,UAAU,6BAA6B;AAS1E,iBAAiB;EACf,mCAAmC,GACnC,WAAW,MAAM;EACjB,mCAAmC,GACnC,WAAW,MAAM;EACjB,oCAAoC,GACpC,YAAY,MAAM;;AAGpB;;CAEC,GACD,OAAO,iBAAS,eACd,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,WAAU,MAAM,AAAoB,EACpC,WAAU,MAAM,AAAoB;EACjC,QAAQ,MAAM;EAAE,WAAW,OAAO;;AA6BvC;;CAEC,GACD,OAAO,iBAAS,YACd,SAAS,MAAM,EACf,KAAK,MAAM,EACX,WAAW,MAAM,GAChB;EAAU,QAAQ,MAAM;EAAE,QAAQ,MAAM;EAAE,UAAU,MAAM,GAAG,IAAI;;AA+CpE;;CAEC,GACD,OAAO,iBAAS,iBAAiB,UAAS,iBAAsB,GAAG;AA+EnE;;;;;;;;;;;;CAYC,GACD,OAAO,iBAAS,aAAa,QAAQ,OAAO,MAAM,EAAE,MAAM,CAAC,GAAG;AAqB9D,eAAe,iBAAiB"}

package/types/src/plugins/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sources":["../../../src/plugins/skills.ts"],"names":[],"mappings":"AAOA,cAAmC,UAAU,6BAA6B;UAWhE;EACR,mCAAmC,GACnC,OAAO,MAAM;;AAoGf;;CAEC,GACD,OAAO,iBAAS,mBAAmB,SAAS,mBAAmB,GAAG;AA8IlE;;;;;;;;;;;;;CAaC,GACD,OAAO,iBAAS,aAAa,QAAQ,OAAO,MAAM,EAAE,MAAM,CAAC,GAAG;AAM9D,eAAe,mBAAmB"}
+{"version":3,"file":"skills.d.ts","sources":["../../../src/plugins/skills.ts"],"names":[],"mappings":"AAOA,cAAmC,UAAU,6BAA6B;UAWhE;EACR,mCAAmC,GACnC,OAAO,MAAM;;AAoGf;;CAEC,GACD,OAAO,iBAAS,mBAAmB,SAAS,mBAAmB,GAAG;AAkJlE;;;;;;;;;;;;;CAaC,GACD,OAAO,iBAAS,aAAa,QAAQ,OAAO,MAAM,EAAE,MAAM,CAAC,GAAG;AAM9D,eAAe,mBAAmB"}