@geohar/pi-mcp-combiner 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 George Harker
+
+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,151 @@
+# @geohar/pi-mcp-combiner
+
+A [Pi](https://pi.dev) extension that makes the **`mcp-combiner`** MCP aggregator
+available to Pi: it starts the combiner (supervised by
+[`sharedserver`](https://github.com/georgeharker/sharedserver)) and appends the
+combiner's tool-discovery directive to the system prompt.
+
+It is the Pi counterpart of the
+[Claude Code](https://github.com/georgeharker/mcp-companion/tree/main/plugins/claude)
+and
+[OpenCode](https://github.com/georgeharker/mcp-companion/tree/main/plugins/opencode)
+plugins, and shares the same combiner and the same `sharedserver` instance — so Pi,
+Claude Code, OpenCode, and Neovim can all talk to **one** refcounted combiner process.
+
+## How it fits together
+
+Pi has no MCP of its own. Two pieces give it the combiner:
+
+1. **[`pi-mcp-adapter`](https://pi.dev/packages/pi-mcp-adapter)** — the Pi package that
+   actually speaks MCP. It reads its own `mcp.json` and connects to the combiner over
+   HTTP. **This extension does not replace it — you install both.**
+2. **This extension** — the process + instructions half, mirroring the sibling plugins:
+   - **Run the combiner** — on `session_start` it drives
+     ```
+     sharedserver use <name> --pid <pi-pid> --grace-period <g> \
+         -- <combiner> --mcp --config <servers.json> --port <port>
+     ```
+     `sharedserver` refcounts by PID with a grace period, so the combiner is shared
+     across clients and outlives any single one. It releases the refcount on
+     `session_shutdown` — but only when `reason === "quit"`, since reload/resume/fork
+     keep the same Pi process and a fresh `session_start` re-attaches.
+   - **Inject instructions** — on `before_agent_start` it appends the combiner's
+     `<server>_`-prefix / "discover before assuming" directive to the system prompt. The
+     combiner also serves the same text as its MCP `instructions`, which `pi-mcp-adapter`
+     surfaces on connect, so this is a belt to those braces.
+
+`sharedserver` itself is fetched automatically if it is not already installed (a pinned
+release via the cargo-dist installer — no Rust toolchain needed), using the exact same
+resolver as the other two plugins.
+
+## Requirements
+
+- **`pi-mcp-adapter`** installed in Pi: `pi install npm:pi-mcp-adapter`.
+- **`mcp-combiner`** available as a command (`uv tool install mcp-combiner`), or just
+  **`uv`** on PATH — a pinned release is fetched from PyPI on demand. Requires combiner
+  ≥ 0.8.0 (the `--mcp` serve flag; version-gated automatically).
+- A combiner **`servers.json`** (see auto-probe locations below).
+
+## Install
+
+### 1. Point `pi-mcp-adapter` at the combiner
+
+Drop the combiner entry into one of `pi-mcp-adapter`'s `mcp.json` locations — e.g.
+project-local `.pi/mcp.json`, or global `~/.config/mcp/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "mcp-combiner": {
+      "url": "http://127.0.0.1:9741/mcp"
+    }
+  }
+}
+```
+
+(See [`mcp.json.example`](./mcp.json.example).) To give this Pi instance its own chat
+identity toward the combiner — parking its isolated upstream sessions separately — add a
+path token: `"url": "http://127.0.0.1:9741/mcp/pi-<yourname>"`. The combiner gives URL
+tokens first priority.
+
+If you edit `mcp.json` while Pi is running, run `/reload` (or `mcp({ connect:
+"mcp-combiner" })`) so the adapter re-reads it.
+
+### 2. Install this extension
+
+Any of Pi's extension-loading mechanisms — all support a **local directory**:
+
+```sh
+# a) drop-in package dir (uses "main": dist/index.js — run `npm run build` first)
+npm --prefix plugins/pi run build
+ln -s "$PWD/plugins/pi" ~/.pi/agent/extensions/mcp-combiner
+
+# b) one-off, build-free live dev — Pi loads the TS source directly
+pi -e ./plugins/pi/src/index.ts
+
+# c) settings.json — list a local path under "extensions"
+#    { "extensions": ["/abs/path/to/mcp-companion/plugins/pi/src/index.ts"] }
+
+# d) published package — list under "packages" in settings.json
+#    { "packages": ["@geohar/pi-mcp-combiner@latest"] }
+```
+
+## Configuration
+
+Everything is via the `PI_MCP_COMBINER_*` environment namespace, which mirrors the Claude
+plugin's `CLAUDE_MCP_COMBINER_*` and the OpenCode plugin's `OPENCODE_MCP_COMBINER_*` — so
+running several clients means one namespace per client.
+
+| Variable | Default | Effect |
+|----------|---------|--------|
+| `PI_MCP_COMBINER_PORT` | `9741` | HTTP port the combiner serves on. |
+| `PI_MCP_COMBINER_HOST` | `127.0.0.1` | HTTP host the combiner binds. |
+| `PI_MCP_COMBINER_CONFIG` | *(auto-probed)* | Path to the combiner's `servers.json`. |
+| `PI_MCP_COMBINER_COMMAND` / `_ARGS` | *(auto-resolved)* | Override the combiner invocation. |
+| `PI_MCP_COMBINER_CHECKOUT` | — | Checkout for `uv run --project <checkout> python -m mcp_combiner`. |
+| `PI_MCP_COMBINER_NAME` | `mcp-combiner` | `sharedserver` instance name. |
+| `PI_MCP_COMBINER_GRACE` | `30m` | `sharedserver` grace period. |
+| `PI_MCP_COMBINER_LOG` | `~/.local/state/mcp-combiner/mcp-combiner.log` | Capture the combiner's stdout/stderr; `"none"` disables. |
+| `PI_MCP_COMBINER_PYLOG` | `~/.local/state/mcp-combiner/mcp-combiner-py.log` | The combiner's own `--log-file`; `"none"` disables. |
+| `PI_MCP_COMBINER_LOG_LEVEL` | `info` | The combiner's `--log-level`. |
+| `PI_MCP_COMBINER_MANAGE` | `true` | `false` → don't launch (assume the combiner runs elsewhere); instructions only. |
+| `PI_MCP_COMBINER_INSTRUCTIONS` | `true` | `false` → don't append the directive to the system prompt. |
+| `PI_MCP_COMBINER_NOTIFY` | `true` | `false` → don't surface attach/health messages via the Pi UI. |
+| `SHAREDSERVER_BIN` | *(auto-resolved)* | Path to the `sharedserver` binary. |
+| `SHAREDSERVER_LOCKDIR` | — | `sharedserver` lock directory. |
+
+### `servers.json` auto-probe
+
+`$PI_MCP_COMBINER_CONFIG` → `~/.cache/secrets/<user>.mcpservers.json` →
+`~/.config/mcp-combiner/servers.json` → `~/.config/mcp/servers.json`.
+
+### Combiner command resolution
+
+`$PI_MCP_COMBINER_COMMAND` (+`$PI_MCP_COMBINER_ARGS`) → `mcp-combiner` on `PATH` (only
+when ≥ 0.8.0) → `uv run --project <checkout> python -m mcp_combiner` → a pinned release
+via `uvx`. If the `mcp-combiner` on PATH is older than 0.8.0, the extension warns and
+falls back to a pinned `uvx` release rather than silently using a stale binary.
+
+## Host-owned mode
+
+If **`$MCP_COMPANION_COMBINER_URL`** is set, an editor/host (e.g. Neovim) already owns
+and refcounts the combiner. The extension then **only injects instructions** and never
+starts or stops the process — the same early-exit as the sibling plugins. Equivalent to
+`PI_MCP_COMBINER_MANAGE=false`.
+
+## Development
+
+```sh
+npm install
+npm run typecheck
+npm run build      # emits dist/ (not committed; built on publish)
+```
+
+The `src/sharedserver-resolve.ts` file is **vendored byte-identical** from
+[`georgeharker/sharedserver`](https://github.com/georgeharker/sharedserver) (via
+`scripts/sync-vendored.sh`), shared with the OpenCode plugin so both answer "which
+sharedserver, and why" identically. Edit it upstream; re-sync here.
+
+## License
+
+MIT © George Harker

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "./pi.js";
+export default function mcpCombiner(pi: ExtensionAPI): void;
+//# 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":"AAiCA,OAAO,KAAK,EAER,YAAY,EAIf,MAAM,SAAS,CAAA;AA6NhB,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA+I1D"}

package/dist/index.js

@@ -0,0 +1,419 @@
+// Pi extension: run the `mcp-combiner` MCP aggregator via the `sharedserver` CLI so it
+// is available to Pi through `pi-mcp-adapter`.
+//
+// Pi has no MCP of its own; `pi-mcp-adapter` (a separate Pi package) is what actually
+// talks MCP, reading its own `mcp.json`. This extension is the OTHER half — the exact
+// counterpart of the process side of the Claude Code and OpenCode plugins:
+//
+//   1. Process — drive `sharedserver use … -- <combiner> --mcp --config … --port …` so
+//      the combiner is running and refcounted, SHARED with any other client (Claude
+//      Code, OpenCode, Neovim) that uses the same sharedserver name. Launched in
+//      `session_start` (Pi forbids background startup from the factory) and released in
+//      `session_shutdown` — but only on `reason === "quit"`, since reload/new/resume/
+//      fork keep the same Pi process alive and a fresh `session_start` re-attaches.
+//   2. Instructions — append the combiner's tool-discovery directive to the system
+//      prompt via `before_agent_start` (analogue of the CC plugin's SessionStart
+//      additionalContext and the OpenCode plugin's system.transform hook). The combiner
+//      also serves the same text as its MCP `instructions`, which pi-mcp-adapter
+//      surfaces on connect — this is the guaranteed, client-native belt to that braces.
+//
+// Registration itself (pointing pi-mcp-adapter at the combiner) is a single `mcp.json`
+// entry — see mcp.json.example and the README. That is static, CC-style, by design;
+// this extension deliberately does not write another extension's config.
+//
+// The sharedserver resolution/fetch and the combiner command ladder are ported
+// faithfully from plugins/opencode/src/index.ts — same floor, same warnings, same
+// degrade-rather-than-die behaviour, so a user running several clients gets one answer
+// to "which combiner / which sharedserver am I on, and why".
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveSharedserver } from "./sharedserver-resolve.js";
+const DEFAULT_PORT = 9741;
+const DEFAULT_NAME = "mcp-combiner";
+const DEFAULT_GRACE = "30m";
+// The `--mcp` serve flag arrived in combiner 0.8.0; older versions serve with a bare
+// `--config`. That boundary is also the floor for trusting a PATH install — below it we
+// fetch a known-good release via uvx rather than limp along. NOT the lockstep release
+// version; it moves only when this extension depends on newer combiner behaviour.
+const MIN_COMBINER_VERSION = [0, 8, 0];
+// Floor-only against sharedserver's latest release: this repo consumes sharedserver
+// rather than shipping it. Kept equal to the OpenCode plugin's value (they resolve the
+// same binary the same way).
+const SHAREDSERVER_MIN_VERSION = "0.6.7";
+// ── the tool-discovery directive ───────────────────────────────────
+// Appended to the system prompt so the agent knows combined tools arrive under a
+// `<server>_` prefix (and, through pi-mcp-adapter, are reached via its `mcp()` proxy or
+// promoted `directTools`), and looks before deciding a capability is absent. Canonical
+// source: CLAUDE.md.example at the repo root; a release-time `prepack` copies it to this
+// package's root as instructions.txt (see package.json). A dev/unbuilt run without the
+// copy falls back to empty and simply injects nothing.
+const COMBINER_DIRECTIVE = (() => {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        // dist/index.js and the packed instructions.txt both sit one level up from here
+        // when built (dist/), and the source layout mirrors it (src/ → package root).
+        return readFileSync(join(here, "..", "instructions.txt"), "utf8");
+    }
+    catch {
+        return "";
+    }
+})();
+// First line of the directive — used to detect an already-appended prompt so repeated
+// `before_agent_start` turns do not stack duplicate copies.
+const DIRECTIVE_MARKER = COMBINER_DIRECTIVE.split("\n", 1)[0] ?? "";
+// ── env configuration ──────────────────────────────────────────────
+// The PI_MCP_COMBINER_* namespace mirrors the Claude plugin's CLAUDE_MCP_COMBINER_* and
+// the OpenCode plugin's OPENCODE_MCP_COMBINER_*, so a user running several clients keeps
+// one namespace per client rather than options in one place and env vars in another.
+function env(name) {
+    const v = process.env[name];
+    return v !== undefined && v !== "" ? v : undefined;
+}
+function splitArgs(value) {
+    if (!value)
+        return [];
+    return value.split(/\s+/).filter((s) => s.length > 0);
+}
+function parseVersion(text) {
+    const m = text.match(/(\d+)\.(\d+)\.(\d+)/);
+    if (!m)
+        return undefined;
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+function gte(a, b) {
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i])
+            return a[i] > b[i];
+    }
+    return true;
+}
+/** Probe a command once for BOTH facts: is it runnable, and which version. Presence is
+ *  "spawn did not fail", NOT "exited 0" — a pre-0.8.0 combiner exits non-zero on
+ *  `--version` (the flag did not exist), which is exactly the stale install the floor
+ *  exists to catch. Probes with ONLY the structural args; the user's extras are never
+ *  folded in, so one arg the CLI rejects cannot make a healthy install look absent. */
+function probe(cmd) {
+    const r = spawnSync(cmd.cmd, [...cmd.args, "--version"], { env: process.env });
+    if (r.error)
+        return { present: false };
+    if (r.status !== 0)
+        return { present: true };
+    return { present: true, version: parseVersion(`${r.stdout?.toString() ?? ""}${r.stderr?.toString() ?? ""}`) };
+}
+function probeUsable(cmd) {
+    const { version } = probe(cmd);
+    if (!version || !gte(version, MIN_COMBINER_VERSION))
+        return undefined;
+    return { ...cmd, version };
+}
+/** This extension's own version, kept equal to the published PyPI mcp-combiner by
+ *  lockstep releases (scripts/bump-version.sh). Used as the uvx pin — read from the
+ *  manifest, never duplicated as a constant. */
+const PLUGIN_VERSION = (() => {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+        return pkg.version;
+    }
+    catch {
+        return undefined;
+    }
+})();
+/** Resolve how to invoke the combiner, mirroring the sibling plugins' priority:
+ *  explicit env command → `mcp-combiner` on PATH (only when new enough) →
+ *  `uv run --project <checkout> python -m mcp_combiner` → a pinned release via uvx. The
+ *  uvx tail is what makes a bare install work with nothing installed by hand. */
+function resolveCombiner(log) {
+    const extra = splitArgs(env("PI_MCP_COMBINER_ARGS"));
+    const command = env("PI_MCP_COMBINER_COMMAND");
+    if (command) {
+        return { cmd: command, args: [], extra };
+    }
+    const onPath = { cmd: "mcp-combiner", args: [] };
+    const pathProbe = probe(onPath);
+    if (pathProbe.present) {
+        if (pathProbe.version && gte(pathProbe.version, MIN_COMBINER_VERSION)) {
+            return { ...onPath, extra, version: pathProbe.version };
+        }
+        log("warn", `mcp-combiner on PATH reports ${pathProbe.version?.join(".") ?? "a pre-0.8.0 version"}, older than ` +
+            `${MIN_COMBINER_VERSION.join(".")} — ignoring it and fetching a pinned release instead. ` +
+            "Upgrade with: uv tool install --upgrade mcp-combiner");
+    }
+    const checkout = env("PI_MCP_COMBINER_CHECKOUT");
+    if (checkout && existsSync(checkout) && probe({ cmd: "uv", args: [] }).present) {
+        return { cmd: "uv", args: ["run", "--project", checkout, "python", "-m", "mcp_combiner"], extra };
+    }
+    // Out-of-the-box path: no install required, fetch from PyPI. Pinned to this
+    // extension's version so the pair moves in lockstep; if that exact release is
+    // missing, fall back to latest rather than failing. The probe both validates the pin
+    // and warms uv's cache, so the real spawn is a cache hit.
+    if (probe({ cmd: "uvx", args: [] }).present) {
+        if (PLUGIN_VERSION) {
+            const pinned = probeUsable({ cmd: "uvx", args: [`mcp-combiner@${PLUGIN_VERSION}`] });
+            if (pinned)
+                return { ...pinned, extra };
+            log("warn", `pinned mcp-combiner@${PLUGIN_VERSION} unavailable or too old; trying latest from PyPI`);
+        }
+        const latest = probeUsable({ cmd: "uvx", args: ["mcp-combiner"] });
+        if (latest)
+            return { ...latest, extra };
+    }
+    return undefined;
+}
+/** True if the resolved combiner supports (needs) the `--mcp` serve flag. Unknown
+ *  version → assume NO: a version we cannot read is a pre-0.8.0 build serving on a bare
+ *  `--config`, and a bare `--config` still serves on newer releases (with a deprecation
+ *  warning), so guessing low degrades gracefully whereas guessing high does not. */
+function combinerNeedsMcpFlag(cmd) {
+    const ver = cmd.version ?? probe({ cmd: cmd.cmd, args: cmd.args }).version;
+    return ver ? gte(ver, MIN_COMBINER_VERSION) : false;
+}
+// ── servers.json resolution (mirrors the sibling plugins) ──
+function resolveConfig(log) {
+    const explicit = env("PI_MCP_COMBINER_CONFIG");
+    if (explicit)
+        return explicit;
+    const user = process.env.USER ?? process.env.LOGNAME ?? "";
+    const candidates = [
+        join(homedir(), ".cache", "secrets", `${user}.mcpservers.json`),
+        join(homedir(), ".config", "mcp-combiner", "servers.json"),
+        join(homedir(), ".config", "mcp", "servers.json"),
+    ];
+    const found = candidates.find(existsSync);
+    if (!found) {
+        log("error", "no combiner servers.json found; set $PI_MCP_COMBINER_CONFIG (probed " +
+            "~/.cache/secrets/<user>.mcpservers.json, ~/.config/mcp-combiner/servers.json, " +
+            "~/.config/mcp/servers.json)");
+    }
+    return found;
+}
+let attachment = null;
+let cleanupInstalled = false;
+function installProcessCleanup() {
+    if (cleanupInstalled)
+        return;
+    cleanupInstalled = true;
+    // Belt to the session_shutdown("quit") braces: if Pi is killed hard enough that
+    // session_shutdown never fires, still release the refcount. Idempotent via `detach`.
+    process.on("exit", () => detach());
+    for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+        process.on(sig, () => {
+            detach();
+            process.kill(process.pid, sig);
+        });
+    }
+}
+function detach() {
+    if (!attachment)
+        return;
+    const { binary, name } = attachment;
+    attachment = null;
+    spawnSync(binary, ["unuse", name, "--pid", String(process.pid)], { stdio: "ignore", env: process.env });
+}
+// ── the extension ──────────────────────────────────────────────────
+export default function mcpCombiner(pi) {
+    const notify = env("PI_MCP_COMBINER_NOTIFY") !== "false";
+    const wantInstructions = env("PI_MCP_COMBINER_INSTRUCTIONS") !== "false";
+    const manage = env("PI_MCP_COMBINER_MANAGE") !== "false";
+    // Host-owned mode: a set $MCP_COMPANION_COMBINER_URL means an editor/host (e.g.
+    // Neovim) already owns and refcounts the combiner. Then we NEVER launch — only the
+    // instructions half runs. The host never sets a port var, mirroring the sibling
+    // plugins' distinction.
+    const hostOwned = env("MCP_COMPANION_COMBINER_URL") !== undefined && env("PI_MCP_COMBINER_PORT") === undefined;
+    // ── instructions: appended every turn (analogue of the sibling plugins) ──
+    pi.on("before_agent_start", (event) => {
+        if (!wantInstructions || !COMBINER_DIRECTIVE)
+            return;
+        // Do not stack duplicates across turns: the chained prompt carries forward.
+        if (DIRECTIVE_MARKER && event.systemPrompt.includes(DIRECTIVE_MARKER))
+            return;
+        return { systemPrompt: `${event.systemPrompt}\n\n${COMBINER_DIRECTIVE}` };
+    });
+    // ── /mcp-combiner command: inspect the extension (verb: system-prompt) ──
+    pi.registerCommand("mcp-combiner", {
+        description: "mcp-combiner extension — verb: system-prompt (show the injected directive)",
+        getArgumentCompletions: (prefix) => completeVerbs(prefix),
+        handler: (args, ctx) => {
+            const verb = args.trim();
+            if (verb === "" || verb === "system-prompt") {
+                showDirective(ctx, "mcp-combiner", COMBINER_DIRECTIVE, wantInstructions);
+                return;
+            }
+            ctx.ui?.notify?.(`mcp-combiner: unknown verb "${verb}". Try: system-prompt`, "warn");
+        },
+    });
+    if (hostOwned || !manage) {
+        // Registration is static (mcp.json) and the combiner is someone else's to run:
+        // nothing to launch. The instructions handler above still applies.
+        return;
+    }
+    // ── process: launch on session_start, release on session_shutdown("quit") ──
+    // Pi forbids starting background resources from the factory, so all of this is
+    // deferred to session_start. session_start fires again on reload/new/resume/fork
+    // within the same process; the `attachment` guard makes re-entry a no-op attach.
+    pi.on("session_start", (_event, ctx) => {
+        if (attachment)
+            return; // already attached in this process
+        const log = makeLog(ctx, notify);
+        const binary = resolveSharedserver({
+            label: "mcp-combiner",
+            minVersion: SHAREDSERVER_MIN_VERSION,
+            installerUrl: "https://github.com/georgeharker/sharedserver/releases/latest/download/sharedserver-installer.sh",
+        }, env("SHAREDSERVER_BIN"), process.env, log);
+        if (!binary) {
+            log("error", "sharedserver binary not found; set $SHAREDSERVER_BIN, or PI_MCP_COMBINER_MANAGE=false");
+            return;
+        }
+        const combiner = resolveCombiner(log);
+        if (!combiner) {
+            log("error", "mcp-combiner could not be found or fetched; install uv and it is fetched from PyPI on demand, " +
+                "or install mcp-combiner, or set $PI_MCP_COMBINER_COMMAND / $PI_MCP_COMBINER_CHECKOUT");
+            return;
+        }
+        const cfgPath = resolveConfig(log);
+        if (!cfgPath)
+            return; // resolveConfig already logged the specifics
+        const name = env("PI_MCP_COMBINER_NAME") ?? DEFAULT_NAME;
+        const port = resolvePort(log);
+        const grace = env("PI_MCP_COMBINER_GRACE") ?? DEFAULT_GRACE;
+        // Assemble: <combiner> [--mcp] --config <cfg> --port <port> [--host <host>]
+        const serve = [];
+        const modern = combinerNeedsMcpFlag(combiner);
+        if (modern)
+            serve.push("--mcp");
+        serve.push("--config", cfgPath, "--port", String(port));
+        const host = env("PI_MCP_COMBINER_HOST");
+        if (host)
+            serve.push("--host", host);
+        // Logging parity with the sibling plugins' two-file scheme: sharedserver captures
+        // raw stdout/stderr (--log-file on `use`), and the combiner writes its own
+        // --log-file. Both default under $XDG_STATE_HOME/mcp-combiner; "none" disables.
+        // Combiner-side flags ride the same version gate as --mcp.
+        const logDir = join(process.env.XDG_STATE_HOME || join(homedir(), ".local", "state"), "mcp-combiner");
+        const pyLogFile = env("PI_MCP_COMBINER_PYLOG") ?? join(logDir, "mcp-combiner-py.log");
+        if (modern) {
+            if (pyLogFile !== "none")
+                serve.push("--log-file", pyLogFile);
+            serve.push("--log-level", env("PI_MCP_COMBINER_LOG_LEVEL") ?? "info");
+        }
+        const wrappedArgs = [...combiner.args, ...(combiner.extra ?? []), ...serve];
+        const useArgs = [
+            "use",
+            name,
+            "--pid",
+            String(process.pid),
+            "--grace-period",
+            grace,
+            "--metadata",
+            `pi-${process.pid}`,
+        ];
+        const logFile = env("PI_MCP_COMBINER_LOG") ?? join(logDir, "mcp-combiner.log");
+        if (logFile !== "none") {
+            try {
+                mkdirSync(dirname(logFile), { recursive: true });
+            }
+            catch {
+                // best-effort — a failed mkdir just means sharedserver may drop the capture
+            }
+            useArgs.push("--log-file", logFile);
+        }
+        useArgs.push("--", combiner.cmd, ...wrappedArgs);
+        installProcessCleanup();
+        const result = spawnSync(binary, useArgs, { stdio: "pipe", env: process.env });
+        if (result.error) {
+            log("error", `${name}: failed to spawn sharedserver (${result.error.message})`);
+            return;
+        }
+        if (result.status !== 0) {
+            const stderr = result.stderr?.toString().trim();
+            log("error", `${name}: sharedserver use exited ${result.status}${stderr ? ` (${stderr})` : ""}`);
+            return;
+        }
+        attachment = { binary, name };
+        log("info", `combiner "${name}" attached on port ${port} (${combiner.cmd} ${wrappedArgs.join(" ")})`);
+    });
+    pi.on("session_shutdown", (event) => {
+        // Only "quit" means the Pi process is actually leaving. reload/new/resume/fork
+        // keep the process alive and a fresh session_start re-attaches — releasing the
+        // refcount on those would needlessly drop (and re-take) the shared combiner.
+        if (event.reason === "quit")
+            detach();
+    });
+}
+// ── helpers ────────────────────────────────────────────────────────
+// The verbs the extension's slash command understands. `system-prompt` shows the
+// directive this extension injects — the show-command pattern from pi-custom-system-prompt,
+// since `before_agent_start` injections are per-turn and never appear in Pi's own
+// `/system-prompt` (which reports the base prompt only).
+const COMMAND_VERBS = ["system-prompt"];
+function completeVerbs(prefix) {
+    const p = prefix.trim();
+    const matches = COMMAND_VERBS.filter((v) => v.startsWith(p));
+    return matches.length ? matches.map((v) => ({ value: v, label: v })) : null;
+}
+const SHOW_LIMIT = 1600;
+function showDirective(ctx, label, directive, enabled) {
+    if (!directive) {
+        ctx.ui?.notify?.(`${label}: no directive bundled (instructions.txt missing)`, "warn");
+        return;
+    }
+    const head = enabled
+        ? `${label} directive — injected into the system prompt on every turn (before_agent_start):`
+        : `${label} directive — injection is DISABLED this session; it would be:`;
+    const body = directive.length > SHOW_LIMIT
+        ? `${directive.slice(0, SHOW_LIMIT)}\n\n… (${directive.length} chars total)`
+        : directive;
+    ctx.ui?.notify?.(`${head}\n\n${body}`, "info");
+}
+function makeLog(ctx, notify) {
+    return (level, message) => {
+        const line = `mcp-combiner: ${message}`;
+        // Pi has no structured plugin log sink like OpenCode's client.app.log; surface
+        // through the UI when there is one (and the user has not opted out), else stderr.
+        if (notify && ctx.hasUI && ctx.ui?.notify) {
+            ctx.ui.notify(line, level === "error" ? "error" : level === "warn" ? "warn" : "info");
+        }
+        else if (level === "error" || level === "warn") {
+            process.stderr.write(`${line}\n`);
+        }
+    };
+}
+/** The port to serve on, reconciling PI_MCP_COMBINER_PORT with any explicit
+ *  $MCP_COMPANION_COMBINER_URL (which is what pi-mcp-adapter registers, so serving
+ *  anywhere else would be unreachable — the URL wins, same rule as the sibling plugins). */
+function resolvePort(log) {
+    const raw = env("PI_MCP_COMBINER_PORT");
+    let port = DEFAULT_PORT;
+    if (raw !== undefined) {
+        const n = Number(raw);
+        if (Number.isInteger(n) && n > 0)
+            port = n;
+        else
+            log("warn", `PI_MCP_COMBINER_PORT=${raw} is not a positive integer; using ${DEFAULT_PORT}`);
+    }
+    const url = env("MCP_COMPANION_COMBINER_URL");
+    if (url && raw !== undefined) {
+        let urlPort = Number.NaN;
+        try {
+            urlPort = Number(new URL(url).port);
+        }
+        catch {
+            // malformed URL — fall through to the no-usable-port warning below
+        }
+        if (!Number.isInteger(urlPort) || urlPort <= 0) {
+            log("warn", `MCP_COMPANION_COMBINER_URL=${url} has no explicit port; serving on ${port}. ` +
+                `Use an explicit port in the URL (e.g. http://127.0.0.1:${port}/mcp).`);
+        }
+        else if (urlPort !== port) {
+            log("warn", `PI_MCP_COMBINER_PORT=${port} disagrees with MCP_COMPANION_COMBINER_URL=${url}; the URL is what ` +
+                `pi-mcp-adapter registers, so serving on ${port} would be unreachable — using ${urlPort}. ` +
+                "Set them to the same port.");
+            port = urlPort;
+        }
+    }
+    return port;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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