@plurnk/plurnk-execs-common 0.1.0

package/.env.example

@@ -0,0 +1,16 @@
+# @plurnk/plurnk-execs-common — environment
+
+# Operator kill-switch per runtime tag. Set to 0 (or false) to disable a tag
+# even when its interpreter is installed on the host. Absent = enabled (the tag
+# is offered when its binary is on PATH). Disabling drops it from the model's
+# available-runtimes list with a "disabled" reason on the 501.
+#
+# PLURNK_EXECS_PERL=0
+# PLURNK_EXECS_RUBY=0
+# PLURNK_EXECS_PHP=0
+# PLURNK_EXECS_LUA=0
+# PLURNK_EXECS_DENO=0
+# PLURNK_EXECS_BUN=0
+# PLURNK_EXECS_TCL=0
+# PLURNK_EXECS_BC=0
+# PLURNK_EXECS_AWK=0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PossumTech Laboratories
+
+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,29 @@
+# @plurnk/plurnk-execs-common
+
+A **detection harness** for [plurnk-service](https://github.com/plurnk/plurnk-service)'s `exec` scheme: one package that exposes whichever common interpreters/REPLs exist on the host. Install it once and the model gets `perl`/`ruby`/`php`/`lua`/`awk`/`bc`/… — but only the ones actually present.
+
+A `@plurnk/plurnk-execs-*` sibling built on the [plurnk-execs](https://github.com/plurnk/plurnk-execs) framework.
+
+## How it works
+
+The manifest claims a candidate set of common-REPL tags. The framework's `probe()` (per-tag, cheap `command -v`) lights up only the interpreters on PATH, so the consumer offers the model exactly the platform's runtimes. No per-language packages to install — one harness adapts to the host.
+
+| Tag | Binary | Command via |
+|---|---|---|
+| `perl` 🐪 / `ruby` 💎 / `lua` 🌙 | perl / ruby / lua | `-e <command>` |
+| `php` 🐘 | php | `-r <command>` |
+| `deno` 🦕 | deno | `eval <command>` |
+| `bun` 🥟 | bun | `-e <command>` |
+| `tcl` 🪶 | tclsh | stdin |
+| `bc` 🧮 | bc | stdin (e.g. `6 * 7`) |
+| `awk` 🪄 | awk | program arg, empty stdin (`BEGIN { … }`) |
+
+All run arbitrary code → `effect: host` → **proposal-gated** (not auto-run). For the snappy auto-run tier, see the pure in-process evaluators (`calc`/`jq`/`wasm`, planned). Input-processing transforms (`sed`, input-driven `awk`) await the EXEC input-channel and aren't claimed here.
+
+## Configuration
+
+`.env.example` documents per-tag kill-switches: `PLURNK_EXECS_<TAG>=0` disables a tag even when installed (drops it from the available list with a "disabled" 501 reason).
+
+## Tests
+
+`test:lint`, `test:unit`. Live-eval tests auto-skip where the interpreter is absent.

package/dist/Common.d.ts

@@ -0,0 +1,8 @@
+import { SubprocessExecutor } from "@plurnk/plurnk-execs";
+import type { RuntimeAvailability, SpawnArgs } from "@plurnk/plurnk-execs";
+export declare const RUNTIME_TAGS: readonly string[];
+export default class Common extends SubprocessExecutor {
+    protected spawnArgs(runtime: string, command: string): SpawnArgs;
+    probe(): Promise<RuntimeAvailability>;
+}
+//# sourceMappingURL=Common.d.ts.map

package/dist/Common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Common.d.ts","sourceRoot":"","sources":["../src/Common.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AA2B3E,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAwC,CAAC;AAqBnF,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,kBAAkB;cAC/B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS;IAU1D,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAUvD"}

package/dist/Common.js

@@ -0,0 +1,57 @@
+import { spawnSync } from "node:child_process";
+import { SubprocessExecutor } from "@plurnk/plurnk-execs";
+const RECIPES = Object.freeze({
+    perl: { bin: "perl", arg: (c) => ["-e", c] },
+    ruby: { bin: "ruby", arg: (c) => ["-e", c] },
+    php: { bin: "php", arg: (c) => ["-r", c] },
+    lua: { bin: "lua", arg: (c) => ["-e", c] },
+    deno: { bin: "deno", arg: (c) => ["eval", c] },
+    bun: { bin: "bun", arg: (c) => ["-e", c] },
+    tcl: { bin: "tclsh", stdin: true },
+    bc: { bin: "bc", stdin: true },
+    awk: { bin: "awk", bare: true },
+});
+// Exposed for tests / consumers wanting the candidate set.
+export const RUNTIME_TAGS = Object.freeze(Object.keys(RECIPES));
+// Operator kill-switch: PLURNK_EXECS_<TAG>=0 (or "false") disables a tag even
+// when its interpreter is installed. (Honored here locally; the cross-family
+// equivalent is service registry policy.)
+const isDisabled = (tag) => {
+    const v = process.env[`PLURNK_EXECS_${tag.toUpperCase()}`];
+    return v === "0" || v?.toLowerCase() === "false";
+};
+// PATH presence via POSIX `command -v` — robust across interpreters that don't
+// support `--version` (tclsh, bc, some awks). bin is from the fixed table above.
+const onPath = (bin) => spawnSync("sh", ["-c", `command -v "$1"`, "sh", bin]).status === 0;
+// Detection harness: one package claiming the common-REPL tags. probe() lights
+// up only the interpreters present on this host (and not operator-disabled), so
+// the consumer offers the model exactly what the platform has — "plurnk supports
+// the host's REPLs out of the box". All run arbitrary code → effect `host`
+// (inherited, proposal-gated). Reuses SubprocessExecutor's run() (streaming +
+// process-group abort) via the spawnArgs() hook.
+export default class Common extends SubprocessExecutor {
+    spawnArgs(runtime, command) {
+        const r = RECIPES[runtime];
+        if (r === undefined)
+            throw new Error(`plurnk-execs-common received unclaimed runtime tag '${runtime}'`);
+        // Trailing newline so line-oriented readers (bc, tclsh) evaluate the
+        // final line before EOF rather than erroring on an unterminated line.
+        if (r.stdin)
+            return { cmd: r.bin, args: [], useShell: false, stdin: `${command}\n` };
+        if (r.bare)
+            return { cmd: r.bin, args: [command], useShell: false, stdin: "" };
+        return { cmd: r.bin, args: r.arg(command), useShell: false };
+    }
+    async probe() {
+        const r = RECIPES[this.runtime];
+        if (r === undefined)
+            return { available: false, detail: `unknown runtime '${this.runtime}'` };
+        if (isDisabled(this.runtime)) {
+            return { available: false, detail: `disabled (PLURNK_EXECS_${this.runtime.toUpperCase()}=0)` };
+        }
+        return onPath(r.bin)
+            ? { available: true, detail: r.bin }
+            : { available: false, detail: `${r.bin} not on PATH` };
+    }
+}
+//# sourceMappingURL=Common.js.map

package/dist/Common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Common.js","sourceRoot":"","sources":["../src/Common.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as Common, RUNTIME_TAGS } from "./Common.ts";
+export { default } from "./Common.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as Common, RUNTIME_TAGS } from "./Common.js";
+export { default } from "./Common.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+    "name": "@plurnk/plurnk-execs-common",
+    "version": "0.1.0",
+    "description": "Common-REPL detection harness for plurnk-service's exec scheme — one package that exposes whichever common interpreters (perl, ruby, php, lua, awk, bc, …) exist on the host.",
+    "keywords": ["plurnk", "exec", "runtime", "executor", "repl", "perl", "ruby", "lua", "awk"],
+    "homepage": "https://github.com/plurnk/plurnk-execs-common#readme",
+    "bugs": {
+        "url": "https://github.com/plurnk/plurnk-execs-common/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/plurnk/plurnk-execs-common.git"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "license": "MIT",
+    "author": "@wikitopian",
+    "type": "module",
+    "publishConfig": {
+        "access": "public"
+    },
+    "plurnk": {
+        "kind": "exec",
+        "runtimes": [
+            { "name": "perl", "glyph": "🐪" },
+            { "name": "ruby", "glyph": "💎" },
+            { "name": "php", "glyph": "🐘" },
+            { "name": "lua", "glyph": "🌙" },
+            { "name": "deno", "glyph": "🦕" },
+            { "name": "bun", "glyph": "🥟" },
+            { "name": "tcl", "glyph": "🪶" },
+            { "name": "bc", "glyph": "🧮" },
+            { "name": "awk", "glyph": "🪄" }
+        ]
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md",
+        ".env.example"
+    ],
+    "scripts": {
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --test \"src/**/*.test.ts\"",
+        "test": "npm run test:lint && npm run test:unit",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:dist",
+        "prepare": "npm run build"
+    },
+    "dependencies": {
+        "@plurnk/plurnk-execs": "0.4.1"
+    },
+    "devDependencies": {
+        "@types/node": "^25.8.0",
+        "typescript": "^6.0.3"
+    }
+}