@adyingdeath/meatproxy 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 adyingdeath
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# MeatProxy
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> A meat proxy is a person who acts as an unthinking relay for AI-generated text, code, or other outputs by copying and pasting them to others without reading, validating, or adding personal insight.
+
+MeatProxy helps you be a better meat proxy.
+
+It is a small bridge between your clipboard and chatbots: paste the prompt into the chat, ask for a change, copy the reply, then run `mtp` in the terminal. The code runs against your project, and everything it prints is copied back to the clipboard, ready for the next round.
+
+## Requirements
+
+- Node.js 22.12 or newer
+- PowerShell (`pwsh` or Windows PowerShell) if you use the `pwsh` tool
+
+## Install
+
+```sh
+npm install -g meatproxy
+```
+
+This provides the `mtp` command (also available as `meatproxy`).
+
+## Usage
+
+```sh
+# 1. copy the agent prompt to the clipboard
+mtp init
+
+# 2. paste it into a web chatbot and say what you want
+
+# 3. copy the chatbot's reply, then run
+mtp
+```
+
+`mtp init` copies the prompt and prints what to do next. `mtp` reads the clipboard, extracts the snippet, runs it, prints the output, and copies that output back to the clipboard.
+
+The snippet runs with the same access as your terminal, so only paste replies you trust.
+
+## Tools
+
+The snippet gets a `tools` object with four methods: `read`, `write`, `edit` and `pwsh`, enough to inspect files, change them, and run PowerShell commands.
+
+## Development
+
+```sh
+npm install
+npm run build # bundles to dist/
+npm run dev # runs src/index.ts directly
+```

package/dist/index.js

@@ -0,0 +1,330 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/core.ts
+import clipboard from "clipboardy";
+
+// src/console.ts
+import { format } from "util";
+var OutputConsole = class {
+  /** Everything written so far, one entry per console call. */
+  lines = [];
+  log(...args) {
+    console.log(...args);
+    this.lines.push(format(...args));
+  }
+  info(...args) {
+    console.info(...args);
+    this.lines.push(format(...args));
+  }
+  warn(...args) {
+    console.warn(...args);
+    this.lines.push(format(...args));
+  }
+  error(...args) {
+    console.error(...args);
+    this.lines.push(format(...args));
+  }
+  debug(...args) {
+    console.debug(...args);
+    this.lines.push(format(...args));
+  }
+};
+
+// src/tools.ts
+import { spawnSync } from "child_process";
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import path from "path";
+var DEFAULT_PWSH_TIMEOUT = 12e4;
+var MAX_PWSH_OUTPUT_BYTES = 16 * 1024 * 1024;
+var PWSH_PRELUDE = [
+  "$ProgressPreference = 'SilentlyContinue'",
+  "try { [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false) } catch {}"
+].join("\n");
+var CLIXML_ERROR_PATTERN = /<S S="Error">([\s\S]*?)<\/S>/g;
+function unescapeClixml(text) {
+  return text.replace(/_x([0-9a-f]{4})_/gi, (_match, code) => String.fromCharCode(Number.parseInt(code, 16))).replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
+}
+function decodePowerShellStderr(stderr) {
+  if (!stderr.startsWith("#< CLIXML")) {
+    return stderr;
+  }
+  const messages = Array.from(
+    stderr.matchAll(CLIXML_ERROR_PATTERN),
+    (match) => unescapeClixml(match[1] ?? "")
+  );
+  return messages.length > 0 ? messages.join("") : stderr;
+}
+function shellCandidates() {
+  return process.platform === "win32" ? ["pwsh", "powershell.exe"] : ["pwsh"];
+}
+function describeError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function requirePath(value, method) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(`${method} failed: file_path must be a non-empty string.`);
+  }
+  return value;
+}
+function requireText(value, method, field) {
+  if (typeof value !== "string") {
+    throw new TypeError(`${method} failed: ${field} must be a string.`);
+  }
+  return value;
+}
+function countOccurrences(text, search) {
+  let count = 0;
+  let index = text.indexOf(search);
+  while (index !== -1) {
+    count += 1;
+    index = text.indexOf(search, index + search.length);
+  }
+  return count;
+}
+function replaceFirst(text, search, replacement) {
+  const index = text.indexOf(search);
+  if (index === -1) {
+    return text;
+  }
+  return text.slice(0, index) + replacement + text.slice(index + search.length);
+}
+var Tools = class {
+  root;
+  constructor(root = process.cwd()) {
+    this.root = path.resolve(root);
+  }
+  /** Read a UTF-8 text file and return its full contents. */
+  read(request) {
+    const filePath = requirePath(request?.file_path, "read");
+    const target = this.resolve(filePath);
+    try {
+      return readFileSync(target, "utf8");
+    } catch (error) {
+      throw new Error(`Read failed for ${filePath}: ${describeError(error)}`);
+    }
+  }
+  /** Create or fully overwrite a UTF-8 text file, creating parent directories. */
+  write(request) {
+    const filePath = requirePath(request?.file_path, "write");
+    const content = requireText(request?.content, "write", "content");
+    const target = this.resolve(filePath);
+    try {
+      mkdirSync(path.dirname(target), { recursive: true });
+      writeFileSync(target, content, "utf8");
+    } catch (error) {
+      throw new Error(`Write failed for ${filePath}: ${describeError(error)}`);
+    }
+  }
+  /**
+   * Replace literal text in a file.
+   *
+   * `old_string` has to be unique unless `replace_all` is true, and an empty
+   * `old_string` is rejected because it would match everywhere.
+   */
+  edit(request) {
+    const filePath = requirePath(request?.file_path, "edit");
+    const oldText = requireText(request?.old_string, "edit", "old_string");
+    const newText = requireText(request?.new_string, "edit", "new_string");
+    if (oldText.length === 0) {
+      throw new Error("Edit failed: old_string must not be empty.");
+    }
+    const original = this.read({ file_path: filePath });
+    const occurrences = countOccurrences(original, oldText);
+    if (occurrences === 0) {
+      throw new Error(`Edit failed for ${filePath}: old_string was not found.`);
+    }
+    if (occurrences > 1 && !request.replace_all) {
+      throw new Error(
+        `Edit failed for ${filePath}: old_string appears ${occurrences} times. Make it unique or pass replace_all = true.`
+      );
+    }
+    const updated = request.replace_all ? original.split(oldText).join(newText) : replaceFirst(original, oldText, newText);
+    this.write({ file_path: filePath, content: updated });
+  }
+  /**
+   * Run a PowerShell command synchronously and return its output.
+   *
+   * A non-zero `exitCode` is returned instead of thrown, so the code can inspect
+   * `stdout` and `stderr` itself. The command runs with `pwsh` when it is
+   * available and falls back to `powershell.exe` on Windows.
+   */
+  pwsh(request) {
+    const command = requireText(request?.command, "pwsh", "command");
+    const timeout = request.timeoutMs ?? DEFAULT_PWSH_TIMEOUT;
+    const cwd = request.cwd ? this.resolve(request.cwd) : this.root;
+    const encoded = Buffer.from(`${PWSH_PRELUDE}
+${command}`, "utf16le").toString("base64");
+    for (const shell of shellCandidates()) {
+      const result = spawnSync(
+        shell,
+        ["-NoProfile", "-NonInteractive", "-EncodedCommand", encoded],
+        {
+          cwd,
+          encoding: "utf8",
+          maxBuffer: MAX_PWSH_OUTPUT_BYTES,
+          timeout,
+          windowsHide: true
+        }
+      );
+      if (result.error) {
+        const code = result.error.code;
+        if (code === "ENOENT") {
+          continue;
+        }
+        if (code === "ETIMEDOUT") {
+          throw new Error(`Pwsh timed out after ${timeout} ms.`);
+        }
+        throw new Error(`Pwsh failed: ${result.error.message}`);
+      }
+      return {
+        stdout: result.stdout,
+        stderr: decodePowerShellStderr(result.stderr),
+        exitCode: result.status
+      };
+    }
+    throw new Error("Pwsh failed: PowerShell is not available on this machine.");
+  }
+  resolve(filePath) {
+    return path.resolve(this.root, filePath);
+  }
+};
+
+// src/core.ts
+var HEAD_MARKER = "<<<<<<< MEATPROXY";
+var TAIL_MARKER = ">>>>>>> MEATPROXY";
+var INVALID_MARKER_MESSAGE = `Error: Invalid format.
+Expected format:
+${HEAD_MARKER}
+...code...
+${TAIL_MARKER}`;
+function extractCodeBlock(text) {
+  const lines = text.split(/\r?\n/);
+  const heads = [];
+  const tails = [];
+  lines.forEach((line, index) => {
+    const trimmed = line.trim();
+    if (trimmed === HEAD_MARKER) {
+      heads.push(index);
+    } else if (trimmed === TAIL_MARKER) {
+      tails.push(index);
+    }
+  });
+  if (heads.length === 0 && tails.length === 0) {
+    console.log(INVALID_MARKER_MESSAGE);
+    return "";
+  }
+  if (heads.length > 1 || tails.length > 1) {
+    console.log("Error: Found more than one pair of MEATPROXY markers.");
+    return "";
+  }
+  const head = heads[0];
+  const tail = tails[0];
+  if (head === void 0) {
+    console.log(INVALID_MARKER_MESSAGE);
+    return "";
+  }
+  if (tail === void 0) {
+    console.log(INVALID_MARKER_MESSAGE);
+    return "";
+  }
+  if (tail < head) {
+    console.log(INVALID_MARKER_MESSAGE);
+    return "";
+  }
+  const code = lines.slice(head + 1, tail).join("\n").trim();
+  if (code.length === 0) {
+    console.log("No code. Nothing happens.");
+    return "";
+  }
+  return code;
+}
+var AsyncFunction = Object.getPrototypeOf(async function() {
+}).constructor;
+async function run() {
+  let text;
+  try {
+    text = await clipboard.read();
+  } catch (error) {
+    console.log("could not read the clipboard");
+    return;
+  }
+  const code = extractCodeBlock(text);
+  if (code.length === 0) {
+    return;
+  }
+  const captured = new OutputConsole();
+  try {
+    const func = new AsyncFunction("tools", "console", code);
+    await func(new Tools(), captured);
+  } catch (error) {
+    captured.log(error);
+  }
+  if (captured.lines.length === 0) {
+    console.log("No output to copy.");
+    return;
+  }
+  try {
+    await clipboard.write(captured.lines.join("\n"));
+  } catch (error) {
+    console.log("could not write to the clipboard");
+    return;
+  }
+  console.log("Output copied to the clipboard. Paste it back to the agent.");
+}
+
+// src/commands/init.ts
+import clipboard2 from "clipboardy";
+
+// src/prompt.ts
+var INIT_PROMPT = [
+  "You help through MeatProxy: the user pastes your replies into a terminal, which runs the JavaScript you send locally.",
+  "",
+  "To inspect or edit files, reply with one snippet shaped like this:",
+  "",
+  "```js",
+  "<<<<<<< MEATPROXY",
+  "// your JavaScript here",
+  ">>>>>>> MEATPROXY",
+  "```",
+  "",
+  "Keep the marker lines exactly as shown, each on its own line, inside the code block. The terminal reads everything between them and ignores the rest of your reply.",
+  "",
+  "Guidelines:",
+  "- Use relative paths; the working directory is the project root.",
+  "- Do one step per snippet: the user runs it, then pastes the output back to you.",
+  "- Use console.log for results and progress; everything printed is copied to the clipboard automatically.",
+  "- Keep explanations outside the code block.",
+  "",
+  "The snippet runs in Node with a `tools` object:",
+  "tools.read({ file_path }) -> string",
+  "tools.write({ file_path, content })",
+  "tools.edit({ file_path, old_string, new_string, replace_all? })",
+  "tools.pwsh({ command, cwd?, timeoutMs? }) -> { stdout, stderr, exitCode }",
+  "",
+  ""
+].join("\n");
+
+// src/commands/init.ts
+function registerInit(program2) {
+  program2.command("init").description("Copy the agent prompt to the clipboard").action(async () => {
+    try {
+      await clipboard2.write(INIT_PROMPT);
+    } catch (error) {
+      console.log("could not write to the clipboard");
+      return;
+    }
+    console.log("Prompt copied to the clipboard.");
+    console.log("Paste it into a web chatbot, add what you want it to do, and send.");
+    console.log("Then copy the chatbot's reply back here and run `mtp`.");
+  });
+}
+
+// src/index.ts
+var program = new Command();
+program.name("mp").description("MeatProxy CLI").version("1.0.0").action(run);
+registerInit(program);
+await program.parseAsync();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/core.ts","../src/console.ts","../src/tools.ts","../src/commands/init.ts","../src/prompt.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport { run } from \"./core.js\";\nimport { registerInit } from \"./commands/init.js\";\n\nconst program = new Command();\n\nprogram\n    .name(\"mp\")\n    .description(\"MeatProxy CLI\")\n    .version(\"1.0.0\")\n    .action(run);\n\nregisterInit(program);\n\nawait program.parseAsync();\n","import clipboard from \"clipboardy\";\r\nimport { OutputConsole } from \"./console.js\";\r\nimport { Tools } from \"./tools.js\";\r\n\r\nexport const HEAD_MARKER = \"<<<<<<< MEATPROXY\";\r\nexport const TAIL_MARKER = \">>>>>>> MEATPROXY\";\r\n\r\nconst INVALID_MARKER_MESSAGE = `Error: Invalid format.\r\nExpected format:\r\n${HEAD_MARKER}\r\n...code...\r\n${TAIL_MARKER}`\r\n\r\n/**\r\n * Extract the code between the MEATPROXY markers.\r\n *\r\n * Exactly one head marker and one tail marker are expected, with the tail after\r\n * the head.\r\n */\r\nexport function extractCodeBlock(text: string): string {\r\n    const lines = text.split(/\\r?\\n/);\r\n    const heads: number[] = [];\r\n    const tails: number[] = [];\r\n\r\n    lines.forEach((line, index) => {\r\n        const trimmed = line.trim();\r\n        if (trimmed === HEAD_MARKER) {\r\n            heads.push(index);\r\n        } else if (trimmed === TAIL_MARKER) {\r\n            tails.push(index);\r\n        }\r\n    });\r\n\r\n    if (heads.length === 0 && tails.length === 0) {\r\n        console.log(INVALID_MARKER_MESSAGE);\r\n        return \"\";\r\n    }\r\n\r\n    if (heads.length > 1 || tails.length > 1) {\r\n        console.log(\"Error: Found more than one pair of MEATPROXY markers.\");\r\n        return \"\";\r\n    }\r\n\r\n    const head = heads[0];\r\n    const tail = tails[0];\r\n\r\n    if (head === undefined) {\r\n        console.log(INVALID_MARKER_MESSAGE);\r\n        return \"\";\r\n    }\r\n\r\n    if (tail === undefined) {\r\n        console.log(INVALID_MARKER_MESSAGE);\r\n        return \"\";\r\n    }\r\n\r\n    if (tail < head) {\r\n        console.log(INVALID_MARKER_MESSAGE);\r\n        return \"\";\r\n    }\r\n\r\n    const code = lines\r\n        .slice(head + 1, tail)\r\n        .join(\"\\n\")\r\n        .trim();\r\n\r\n    if (code.length === 0) {\r\n        console.log(\"No code. Nothing happens.\");\r\n        return \"\";\r\n    }\r\n\r\n    return code;\r\n}\r\n\r\n\r\n// Function bodies are normally sync; an async body lets the clipboard code use\r\n// top-level await (for example `await tools.pwsh(...)`).\r\nconst AsyncFunction = Object.getPrototypeOf(async function () {}).constructor as new (\r\n    ...args: string[]\r\n) => (...params: unknown[]) => Promise<unknown>;\r\n\r\n/**\r\n * Read the clipboard, pull the MEATPROXY code block out of it, run that code and\r\n * copy whatever it printed back to the clipboard for the next round.\r\n */\r\nexport async function run(): Promise<void> {\r\n    let text: string;\r\n\r\n    try {\r\n        text = await clipboard.read();\r\n    } catch (error) {\r\n        console.log(\"could not read the clipboard\");\r\n        return;\r\n    }\r\n\r\n    const code = extractCodeBlock(text);\r\n    if (code.length === 0) {\r\n        return;\r\n    }\r\n\r\n    const captured = new OutputConsole();\r\n\r\n    try {\r\n        const func = new AsyncFunction(\"tools\", \"console\", code);\r\n        await func(new Tools(), captured);\r\n    } catch (error) {\r\n        captured.log(error);\r\n    }\r\n\r\n    if (captured.lines.length === 0) {\r\n        console.log(\"No output to copy.\");\r\n        return;\r\n    }\r\n\r\n    try {\r\n        await clipboard.write(captured.lines.join(\"\\n\"));\r\n    } catch (error) {\r\n        console.log(\"could not write to the clipboard\");\r\n        return;\r\n    }\r\n\r\n    console.log(\"Output copied to the clipboard. Paste it back to the agent.\");\r\n}\r\n","import { format } from \"node:util\";\n\n/**\n * Console handed to the clipboard code as the `console` parameter.\n *\n * Every call is forwarded to the real console and also recorded as formatted\n * text, so the output can be copied to the clipboard afterwards. Methods are\n * bound, which keeps `const { log }console` working.\n */\nexport class OutputConsole {\n    /** Everything written so far, one entry per console call. */\n    readonly lines: string[] = [];\n\n    log(...args: unknown[]): void {\n        console.log(...args);\n        this.lines.push(format(...args));\n    };\n\n    info(...args: unknown[]): void {\n        console.info(...args);\n        this.lines.push(format(...args));\n    };\n\n    warn(...args: unknown[]): void {\n        console.warn(...args);\n        this.lines.push(format(...args));\n    };\n\n    error(...args: unknown[]): void {\n        console.error(...args);\n        this.lines.push(format(...args));\n    };\n\n    debug(...args: unknown[]): void {\n        console.debug(...args);\n        this.lines.push(format(...args));\n    };\n}\n","import { spawnSync } from \"node:child_process\";\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport path from \"path\";\n\nexport interface ReadRequest {\n    /** Path of the file to read, resolved against the tool root. */\n    file_path: string;\n}\n\nexport interface WriteRequest {\n    /** Path of the file to write, resolved against the tool root. */\n    file_path: string;\n    /** Full UTF-8 contents of the file. */\n    content: string;\n}\n\nexport interface EditRequest {\n    /** Path of the file to edit, resolved against the tool root. */\n    file_path: string;\n    /** Literal text to look for. It has to be unique unless `replace_all` is set. */\n    old_string: string;\n    /** Replacement text. An empty string deletes the match. */\n    new_string: string;\n    /** Replace every occurrence instead of requiring a unique match. */\n    replace_all?: boolean;\n}\n\nexport interface PwshRequest {\n    /** PowerShell command or script to run. */\n    command: string;\n    /** Working directory, resolved against the tool root. Defaults to the tool root. */\n    cwd?: string;\n    /** Timeout in milliseconds. Defaults to 120000. */\n    timeoutMs?: number;\n}\n\nexport interface PwshResult {\n    stdout: string;\n    stderr: string;\n    exitCode: number | null;\n}\n\nconst DEFAULT_PWSH_TIMEOUT = 120_000;\nconst MAX_PWSH_OUTPUT_BYTES = 16 * 1024 * 1024;\n\n// PowerShell encodes redirected output with the console code page by default, which\n// mangles non-ASCII text, and it reports progress records on stderr. Switch the\n// output to UTF-8 without a BOM and silence progress before running anything.\nconst PWSH_PRELUDE = [\n    \"$ProgressPreference = 'SilentlyContinue'\",\n    \"try { [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false) } catch {}\",\n].join(\"\\n\");\n\n// Windows PowerShell serializes error records as CLIXML when stderr is redirected.\nconst CLIXML_ERROR_PATTERN = /<S S=\"Error\">([\\s\\S]*?)<\\/S>/g;\n\nfunction unescapeClixml(text: string): string {\n    return text\n        .replace(/_x([0-9a-f]{4})_/gi, (_match, code: string) => String.fromCharCode(Number.parseInt(code, 16)))\n        .replace(/&lt;/g, '<')\n        .replace(/&gt;/g, '>')\n        .replace(/&quot;/g, '\"')\n        .replace(/&apos;/g, \"'\")\n        .replace(/&amp;/g, '&');\n}\n\nfunction decodePowerShellStderr(stderr: string): string {\n    if (!stderr.startsWith(\"#< CLIXML\")) {\n        return stderr;\n    }\n\n    const messages = Array.from(stderr.matchAll(CLIXML_ERROR_PATTERN), (match) =>\n        unescapeClixml(match[1] ?? \"\"),\n    );\n\n    return messages.length > 0 ? messages.join(\"\") : stderr;\n}\n\nfunction shellCandidates(): string[] {\n    // PowerShell 7 first (it supports && and friends), Windows PowerShell as fallback.\n    return process.platform === \"win32\" ? [\"pwsh\", \"powershell.exe\"] : [\"pwsh\"];\n}\n\nfunction describeError(error: unknown): string {\n    return error instanceof Error ? error.message : String(error);\n}\n\nfunction requirePath(value: unknown, method: string): string {\n    if (typeof value !== \"string\" || value.length === 0) {\n        throw new TypeError(`${method} failed: file_path must be a non-empty string.`);\n    }\n\n    return value;\n}\n\nfunction requireText(value: unknown, method: string, field: string): string {\n    if (typeof value !== \"string\") {\n        throw new TypeError(`${method} failed: ${field} must be a string.`);\n    }\n\n    return value;\n}\n\nfunction countOccurrences(text: string, search: string): number {\n    let count = 0;\n    let index = text.indexOf(search);\n\n    while (index !== -1) {\n        count += 1;\n        index = text.indexOf(search, index + search.length);\n    }\n\n    return count;\n}\n\nfunction replaceFirst(text: string, search: string, replacement: string): string {\n    const index = text.indexOf(search);\n    if (index === -1) {\n        return text;\n    }\n\n    return text.slice(0, index) + replacement + text.slice(index + search.length);\n}\n\n/**\n * Editing tools handed to the clipboard code, so agent can use this object to\n * do edit.\n *\n * The code is compiled with a single parameter named `tools`, so it can call\n * `tools.read({ file_path })`, `tools.write({ file_path, content })`,\n * `tools.edit({ file_path, old_string, new_string })` and `tools.pwsh({ command })`.\n * All paths are resolved against `root` (the current working directory by default).\n */\nexport class Tools {\n    private readonly root: string;\n\n    constructor(root: string = process.cwd()) {\n        this.root = path.resolve(root);\n    }\n\n    /** Read a UTF-8 text file and return its full contents. */\n    read(request: ReadRequest): string {\n        const filePath = requirePath(request?.file_path, \"read\");\n        const target = this.resolve(filePath);\n\n        try {\n            return readFileSync(target, \"utf8\");\n        } catch (error) {\n            throw new Error(`Read failed for ${filePath}: ${describeError(error)}`);\n        }\n    }\n\n    /** Create or fully overwrite a UTF-8 text file, creating parent directories. */\n    write(request: WriteRequest): void {\n        const filePath = requirePath(request?.file_path, \"write\");\n        const content = requireText(request?.content, \"write\", \"content\");\n        const target = this.resolve(filePath);\n\n        try {\n            mkdirSync(path.dirname(target), { recursive: true });\n            writeFileSync(target, content, \"utf8\");\n        } catch (error) {\n            throw new Error(`Write failed for ${filePath}: ${describeError(error)}`);\n        }\n    }\n\n    /**\n     * Replace literal text in a file.\n     *\n     * `old_string` has to be unique unless `replace_all` is true, and an empty\n     * `old_string` is rejected because it would match everywhere.\n     */\n    edit(request: EditRequest): void {\n        const filePath = requirePath(request?.file_path, \"edit\");\n        const oldText = requireText(request?.old_string, \"edit\", \"old_string\");\n        const newText = requireText(request?.new_string, \"edit\", \"new_string\");\n\n        if (oldText.length === 0) {\n            throw new Error(\"Edit failed: old_string must not be empty.\");\n        }\n\n        const original = this.read({ file_path: filePath });\n        const occurrences = countOccurrences(original, oldText);\n\n        if (occurrences === 0) {\n            throw new Error(`Edit failed for ${filePath}: old_string was not found.`);\n        }\n\n        if (occurrences > 1 && !request.replace_all) {\n            throw new Error(\n                `Edit failed for ${filePath}: old_string appears ${occurrences} times. ` +\n                    \"Make it unique or pass replace_all = true.\",\n            );\n        }\n\n        const updated = request.replace_all\n            ? original.split(oldText).join(newText)\n            : replaceFirst(original, oldText, newText);\n\n        this.write({ file_path: filePath, content: updated });\n    }\n\n    /**\n     * Run a PowerShell command synchronously and return its output.\n     *\n     * A non-zero `exitCode` is returned instead of thrown, so the code can inspect\n     * `stdout` and `stderr` itself. The command runs with `pwsh` when it is\n     * available and falls back to `powershell.exe` on Windows.\n     */\n    pwsh(request: PwshRequest): PwshResult {\n        const command = requireText(request?.command, \"pwsh\", \"command\");\n        const timeout = request.timeoutMs ?? DEFAULT_PWSH_TIMEOUT;\n        const cwd = request.cwd ? this.resolve(request.cwd) : this.root;\n        const encoded = Buffer.from(`${PWSH_PRELUDE}\\n${command}`, \"utf16le\").toString(\"base64\");\n\n        for (const shell of shellCandidates()) {\n            const result = spawnSync(\n                shell,\n                [\"-NoProfile\", \"-NonInteractive\", \"-EncodedCommand\", encoded],\n                {\n                    cwd,\n                    encoding: \"utf8\",\n                    maxBuffer: MAX_PWSH_OUTPUT_BYTES,\n                    timeout,\n                    windowsHide: true,\n                },\n            );\n\n            if (result.error) {\n                const code = (result.error as NodeJS.ErrnoException).code;\n\n                if (code === \"ENOENT\") {\n                    continue;\n                }\n\n                if (code === \"ETIMEDOUT\") {\n                    throw new Error(`Pwsh timed out after ${timeout} ms.`);\n                }\n\n                throw new Error(`Pwsh failed: ${result.error.message}`);\n            }\n\n            return {\n                stdout: result.stdout,\n                stderr: decodePowerShellStderr(result.stderr),\n                exitCode: result.status,\n            };\n        }\n\n        throw new Error(\"Pwsh failed: PowerShell is not available on this machine.\");\n    }\n\n    private resolve(filePath: string): string {\n        return path.resolve(this.root, filePath);\n    }\n}\n","import clipboard from \"clipboardy\";\nimport type { Command } from \"commander\";\nimport { INIT_PROMPT } from \"../prompt.js\";\n\nexport function registerInit(program: Command) {\n    program\n        .command(\"init\")\n        .description(\"Copy the agent prompt to the clipboard\")\n        .action(async () => {\n            try {\n                await clipboard.write(INIT_PROMPT);\n            } catch (error) {\n                console.log(\"could not write to the clipboard\");\n                return;\n            }\n\n            console.log(\"Prompt copied to the clipboard.\");\n            console.log(\"Paste it into a web chatbot, add what you want it to do, and send.\");\n            console.log(\"Then copy the chatbot's reply back here and run `mtp`.\");\n        });\n}\n","/**\n * Text copied to the clipboard by `mtp init`.\n *\n * It is pasted into a web chatbot so the agent knows how to format the code that\n * this CLI will read back from the clipboard and execute.\n */\nexport const INIT_PROMPT = [\n    \"You help through MeatProxy: the user pastes your replies into a terminal, which runs the JavaScript you send locally.\",\n    \"\",\n    \"To inspect or edit files, reply with one snippet shaped like this:\",\n    \"\",\n    \"```js\",\n    \"<<<<<<< MEATPROXY\",\n    \"// your JavaScript here\",\n    \">>>>>>> MEATPROXY\",\n    \"```\",\n    \"\",\n    \"Keep the marker lines exactly as shown, each on its own line, inside the code block. The terminal reads everything between them and ignores the rest of your reply.\",\n    \"\",\n    \"Guidelines:\",\n    \"- Use relative paths; the working directory is the project root.\",\n    \"- Do one step per snippet: the user runs it, then pastes the output back to you.\",\n    \"- Use console.log for results and progress; everything printed is copied to the clipboard automatically.\",\n    \"- Keep explanations outside the code block.\",\n    \"\",\n    \"The snippet runs in Node with a `tools` object:\",\n    \"tools.read({ file_path }) -> string\",\n    \"tools.write({ file_path, content })\",\n    \"tools.edit({ file_path, old_string, new_string, replace_all? })\",\n    \"tools.pwsh({ command, cwd?, timeoutMs? }) -> { stdout, stderr, exitCode }\",\n    \"\",\n    \"\"\n].join(\"\\n\");\n"],"mappings":"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","names":["clipboard","program","clipboard"]}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@adyingdeath/meatproxy",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "MeatProxy is a small bridge between your clipboard and chatbots.",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "keywords": ["cli", "ai", "llm", "agent", "agent harness"],
+  "author": "adyingdeath",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adyingdeath/meatproxy.git"
+  },
+  "homepage": "https://github.com/adyingdeath/meatproxy",
+  "bugs": {
+    "url": "https://github.com/adyingdeath/meatproxy/issues"
+  },
+  "type": "module",
+  "bin": {
+    "mtp": "./dist/index.js",
+    "meatproxy": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "dependencies": {
+    "clipboardy": "^5.3.2",
+    "commander": "^15.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "tsup": "^9.0.0",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2"
+  }
+}