@petersr/pupptyeer 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PeterSR
+
+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

@@ -0,0 +1,35 @@
+# @petersr/pupptyeer
+
+Install the [pupptyeer](https://github.com/PeterSR/pupptyeer) daemon, CLI, and MCP front-end as a
+prebuilt binary, via npm. This package ships no JavaScript implementation: it is a thin launcher
+whose `optionalDependencies` are per-platform packages (`@petersr/pupptyeer-linux-x64`,
+`@petersr/pupptyeer-darwin-arm64`, `@petersr/pupptyeer-win32-x64`, ...), each carrying the static Go
+binaries for one OS/arch. npm installs only the one matching your machine; the `pupptyeer` /
+`pupptyeer-mcp` commands exec it.
+
+pupptyeer is a local daemon that owns persistent PTY sessions, with a CLI and an MCP server.
+
+## Install
+
+```sh
+# global CLI + daemon
+npm i -g @petersr/pupptyeer
+
+pupptyeer daemon install      # run the daemon as a per-user managed service
+pupptyeer --help
+
+# or run without installing
+npx @petersr/pupptyeer --help
+npx -p @petersr/pupptyeer pupptyeer-mcp --help
+```
+
+Prebuilt binaries are provided for linux, macOS, and Windows on x64 and arm64. On an unsupported
+platform the launcher prints how to build from source.
+
+To program against the daemon, use a client library instead:
+[`pupptyeer-client`](https://www.npmjs.com/package/pupptyeer-client) (Node),
+[`pupptyeer-client`](https://pypi.org/project/pupptyeer-client/) (Python), or the Go client.
+
+## License
+
+MIT

package/bin/pupptyeer-mcp.cjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+"use strict";
+// Launcher for the pupptyeer MCP front-end. Resolves the prebuilt binary from
+// the platform package installed as an optional dependency and execs it.
+require("../lib/launch.cjs").launch("pupptyeer-mcp");

package/bin/pupptyeer.cjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+"use strict";
+// Launcher for the pupptyeer daemon + CLI. Resolves the prebuilt binary from
+// the platform package installed as an optional dependency and execs it.
+require("../lib/launch.cjs").launch("pupptyeer");

package/lib/launch.cjs

@@ -0,0 +1,31 @@
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const { resolveBinary } = require("./resolve.cjs");
+
+// Resolve the named bundled binary, exec it with this process's args, and
+// propagate its exit status (or terminating signal). Used by the bin shims.
+function launch(name) {
+  let bin;
+  try {
+    bin = resolveBinary(name);
+  } catch (err) {
+    console.error(err.message);
+    process.exit(1);
+  }
+
+  const result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+
+  if (result.error) {
+    console.error(`pupptyeer: failed to launch ${bin}: ${result.error.message}`);
+    process.exit(1);
+  }
+  if (result.signal) {
+    // Re-raise the signal so callers see the child's termination cause.
+    process.kill(process.pid, result.signal);
+    return;
+  }
+  process.exit(result.status === null ? 1 : result.status);
+}
+
+module.exports = { launch };

package/lib/resolve.cjs

@@ -0,0 +1,45 @@
+"use strict";
+
+// Map this Node process's platform to the per-platform npm package that ships
+// its prebuilt binaries. Keep this table in step with ../../platforms.mjs (this
+// copy stays plain CommonJS so the wrapper needs no build step).
+const SUPPORTED = {
+  "linux-x64": "@petersr/pupptyeer-linux-x64",
+  "linux-arm64": "@petersr/pupptyeer-linux-arm64",
+  "darwin-x64": "@petersr/pupptyeer-darwin-x64",
+  "darwin-arm64": "@petersr/pupptyeer-darwin-arm64",
+  "win32-x64": "@petersr/pupptyeer-win32-x64",
+  "win32-arm64": "@petersr/pupptyeer-win32-arm64",
+};
+
+function platformKey() {
+  return `${process.platform}-${process.arch}`;
+}
+
+// Resolve the absolute path to a bundled binary ("pupptyeer" or
+// "pupptyeer-mcp") inside the matching platform package. Throws with an
+// actionable message if the platform is unsupported or its package is absent.
+function resolveBinary(name) {
+  const key = platformKey();
+  const pkg = SUPPORTED[key];
+  if (!pkg) {
+    throw new Error(
+      `pupptyeer: unsupported platform "${key}". Supported: ${Object.keys(SUPPORTED).join(", ")}.\n` +
+        `Build from source instead: https://github.com/PeterSR/pupptyeer`
+    );
+  }
+  const ext = process.platform === "win32" ? ".exe" : "";
+  try {
+    return require.resolve(`${pkg}/bin/${name}${ext}`);
+  } catch (err) {
+    throw new Error(
+      `pupptyeer: the platform package "${pkg}" is not installed.\n` +
+        `It should install automatically as an optional dependency of "pupptyeer".\n` +
+        `If you used --no-optional or --omit=optional, reinstall without it, or run:\n` +
+        `  npm i ${pkg}\n` +
+        `Underlying error: ${err && err.message ? err.message : err}`
+    );
+  }
+}
+
+module.exports = { resolveBinary, platformKey, SUPPORTED };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@petersr/pupptyeer",
+  "version": "0.5.0",
+  "description": "Install the pupptyeer daemon, CLI, and MCP front-end as a prebuilt binary for your platform.",
+  "bin": {
+    "pupptyeer": "bin/pupptyeer.cjs",
+    "pupptyeer-mcp": "bin/pupptyeer-mcp.cjs"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "pty",
+    "terminal",
+    "tty",
+    "daemon",
+    "mcp",
+    "pupptyeer",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PeterSR/pupptyeer.git",
+    "directory": "npm/pupptyeer"
+  },
+  "homepage": "https://github.com/PeterSR/pupptyeer#readme",
+  "bugs": "https://github.com/PeterSR/pupptyeer/issues",
+  "author": "PeterSR",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@petersr/pupptyeer-linux-x64": "0.5.0",
+    "@petersr/pupptyeer-linux-arm64": "0.5.0",
+    "@petersr/pupptyeer-darwin-x64": "0.5.0",
+    "@petersr/pupptyeer-darwin-arm64": "0.5.0",
+    "@petersr/pupptyeer-win32-x64": "0.5.0",
+    "@petersr/pupptyeer-win32-arm64": "0.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}