@geohar/pi-svg-mcp 0.0.0

package/dist/index.js

@@ -0,0 +1,258 @@
+// Pi extension: run the `svg-mcp` MCP server via the `sharedserver` CLI and inject the
+// diagram-authoring directive into the system prompt.
+//
+// It is the Pi counterpart of svg-mcp's Claude Code and OpenCode plugins, and mirrors
+// their behaviour:
+//
+//   1. Stand-down switch — if a combiner already serves svg-mcp (global MCP_COMBINER, or
+//      the per-backend MCP_COMBINER_SERVES_SVG_MCP override, which wins), do NOT launch
+//      a standalone backend. The combiner owns svg-mcp's lifecycle. Only the launch is
+//      gated — the directive applies either way, since svg-mcp's tools are present via
+//      the combiner too.
+//   2. Process — on `session_start`, drive `sharedserver use … -- <svg-mcp serve argv>`
+//      so one warm svg-mcp is running and refcounted (shared across clients), paying its
+//      cold start (numpy + pillow) once. Released on `session_shutdown` when
+//      `reason === "quit"` (reload/resume/fork keep the process and re-attach).
+//   3. Directive — append the diagram-authoring text to the system prompt via
+//      `before_agent_start` (analogue of CC's additionalContext / OpenCode's
+//      system.transform).
+//
+// WHICH svg-mcp RUNS (mirrors the OpenCode plugin's resolveServeArgv):
+//   default            uvx svg-mcp@<version>      (published release, pinned)
+//   SVG_MCP_DEV=<dir>  uv run --project <dir>     (a dev checkout)
+//   SVG_MCP_DEV=1      uv run --project <repo>    (in-repo source, if resolvable)
+//
+// MCP registration itself (pointing pi-mcp-adapter at svg-mcp) is a single mcp.json
+// entry — see mcp.json.example and the README; static, and unnecessary when
+// combiner-served. The sharedserver resolution is ported from plugins/opencode.
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveSharedserver } from "./sharedserver-resolve.js";
+const DEFAULT_PORT = 7731;
+const DEFAULT_NAME = "svg-mcp";
+const DEFAULT_GRACE = "1h";
+// Floor-only against sharedserver's latest release: svg-mcp consumes sharedserver rather
+// than shipping it. Kept equal to the sibling plugins' value.
+const SHAREDSERVER_MIN_VERSION = "0.6.7";
+// The svg-mcp PyPI release this extension runs by default (`uvx svg-mcp@<v>`). Decoupled
+// from this package's OWN version (matching the OpenCode plugin); override per-launch
+// with $SVG_MCP_VERSION. Keep it pointing at a real svg-mcp release.
+const SVG_MCP_TOOL_VERSION = "0.2.6";
+// ── the diagram-authoring directive ────────────────────────────────
+// Appended to the system prompt so the agent reaches for svg-mcp's tools instead of
+// hand-writing SVG XML. 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 injects
+// nothing.
+const SVG_DIAGRAM_DIRECTIVE = (() => {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        return readFileSync(join(here, "..", "instructions.txt"), "utf8");
+    }
+    catch {
+        return "";
+    }
+})();
+const DIRECTIVE_MARKER = SVG_DIAGRAM_DIRECTIVE.split("\n", 1)[0] ?? "";
+// ── env configuration ──────────────────────────────────────────────
+// svg-mcp's tool knobs use the shared SVG_MCP_* namespace (as its OpenCode plugin does),
+// so a user's SVG_MCP_PORT/VERSION/DEV apply across every client. Pi-extension-specific
+// toggles use PI_SVG_MCP_*.
+function env(name) {
+    const v = process.env[name];
+    return v !== undefined && v !== "" ? v : undefined;
+}
+// ── stand-down switch (mirrors the CC hook's combiner_serves) ──────
+function truthy(v) {
+    if (v == null)
+        return false;
+    return !["", "0", "false", "no", "off"].includes(v.trim().toLowerCase());
+}
+/** Does a combiner serve `name`? The per-backend `MCP_COMBINER_SERVES_<NAME>` override
+ *  wins over the global `MCP_COMBINER` switch (presence, even empty, counts). Shared
+ *  cross-tool switches — NOT PI_-namespaced. */
+function combinerServes(name) {
+    const key = "MCP_COMBINER_SERVES_" + name.toUpperCase().replace(/[-\s]/g, "_");
+    if (key in process.env)
+        return truthy(process.env[key]);
+    return truthy(process.env.MCP_COMBINER);
+}
+function onPath(cmd) {
+    return spawnSync(cmd, ["--version"], { stdio: "ignore", env: process.env }).status === 0;
+}
+/** Repo-root guess for `SVG_MCP_DEV=1` — three levels up from dist/index.js
+ *  (plugins/pi/dist → repo root), only if it holds svg-mcp source. */
+function inRepoSource() {
+    try {
+        const root = fileURLToPath(new URL("../../..", import.meta.url));
+        return existsSync(join(root, "pyproject.toml")) ? root : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Resolve the argv that serves svg-mcp over streamable-http, or a `missing` runner. */
+function resolveServeArgv(port) {
+    const dev = env("SVG_MCP_DEV");
+    if (dev) {
+        if (!onPath("uv"))
+            return { argv: [], missing: "uv" };
+        const project = dev !== "1" && existsSync(dev) ? dev : inRepoSource();
+        if (project) {
+            return {
+                argv: ["uv", "run", "--project", project, "svg-mcp", "--transport", "streamable-http", "--port", port],
+            };
+        }
+        // dev requested but no checkout given and no in-repo source — fall through.
+    }
+    if (!onPath("uvx"))
+        return { argv: [], missing: "uvx" };
+    const ver = env("SVG_MCP_VERSION") ?? SVG_MCP_TOOL_VERSION;
+    const spec = ver ? `svg-mcp@${ver}` : "svg-mcp";
+    return { argv: ["uvx", spec, "--transport", "streamable-http", "--port", port] };
+}
+let attachment = null;
+let cleanupInstalled = false;
+function installProcessCleanup() {
+    if (cleanupInstalled)
+        return;
+    cleanupInstalled = true;
+    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 svgMcp(pi) {
+    const notify = env("PI_SVG_MCP_NOTIFY") !== "false";
+    const wantInstructions = env("PI_SVG_MCP_INSTRUCTIONS") !== "false";
+    const manage = env("PI_SVG_MCP_MANAGE") !== "false";
+    const name = env("PI_SVG_MCP_NAME") ?? DEFAULT_NAME;
+    const served = combinerServes(name);
+    // ── directive: appended every turn (dup-guarded across turns) ──
+    pi.on("before_agent_start", (event) => {
+        if (!wantInstructions || !SVG_DIAGRAM_DIRECTIVE)
+            return;
+        if (DIRECTIVE_MARKER && event.systemPrompt.includes(DIRECTIVE_MARKER))
+            return;
+        return { systemPrompt: `${event.systemPrompt}\n\n${SVG_DIAGRAM_DIRECTIVE}` };
+    });
+    // ── /svg-mcp command: inspect the extension (verb: system-prompt) ──
+    pi.registerCommand("svg-mcp", {
+        description: "svg-mcp 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, "svg-mcp", SVG_DIAGRAM_DIRECTIVE, wantInstructions);
+                return;
+            }
+            ctx.ui?.notify?.(`svg-mcp: unknown verb "${verb}". Try: system-prompt`, "warn");
+        },
+    });
+    // Combiner-served or manage=false: nothing to launch. The directive still applies.
+    if (served || !manage)
+        return;
+    // ── process: launch on session_start, release on session_shutdown("quit") ──
+    pi.on("session_start", (_event, ctx) => {
+        if (attachment)
+            return;
+        const log = makeLog(ctx, notify);
+        const binary = resolveSharedserver({
+            label: "svg-mcp",
+            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_SVG_MCP_MANAGE=false");
+            return;
+        }
+        const port = env("SVG_MCP_PORT") ?? String(DEFAULT_PORT);
+        const { argv, missing } = resolveServeArgv(port);
+        if (missing) {
+            log("error", `\`${missing}\` not on PATH; install uv (https://docs.astral.sh/uv/), or PI_SVG_MCP_MANAGE=false`);
+            return;
+        }
+        const grace = env("PI_SVG_MCP_GRACE") ?? DEFAULT_GRACE;
+        const useArgs = [
+            "use",
+            name,
+            "--pid",
+            String(process.pid),
+            "--grace-period",
+            grace,
+            "--metadata",
+            `pi-${process.pid}`,
+        ];
+        const logFile = env("PI_SVG_MCP_LOG");
+        if (logFile && logFile !== "none")
+            useArgs.push("--log-file", logFile);
+        useArgs.push("--", ...argv);
+        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", `svg-mcp "${name}" attached on port ${port} (${argv.join(" ")})`);
+    });
+    pi.on("session_shutdown", (event) => {
+        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 = `svg-mcp: ${message}`;
+        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`);
+        }
+    };
+}
+//# 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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"}

package/dist/pi.d.ts

@@ -0,0 +1,70 @@
+export type SessionStartReason = "startup" | "reload" | "new" | "resume" | "fork";
+export type SessionShutdownReason = "quit" | "reload" | "new" | "resume" | "fork";
+export type SessionStartEvent = {
+    reason: SessionStartReason;
+    previousSessionFile?: string;
+};
+export type SessionShutdownEvent = {
+    reason: SessionShutdownReason;
+    targetSessionFile?: string;
+};
+export type BeforeAgentStartEvent = {
+    systemPrompt: string;
+};
+export type BeforeAgentStartResult = {
+    systemPrompt?: string;
+} | void;
+export type ExtensionContext = {
+    cwd: string;
+    mode: "tui" | "rpc" | "json" | "print";
+    hasUI: boolean;
+    signal?: AbortSignal;
+    ui?: {
+        notify?: (message: string, level?: "info" | "warn" | "error") => void;
+    };
+};
+/** Context handed to a command handler. Superset of ExtensionContext in practice; we
+ *  only read `signal`, `ui`, and `hasUI`. */
+export type ExtensionCommandContext = ExtensionContext;
+export type AutocompleteItem = {
+    value: string;
+    label?: string;
+};
+export type ExecResult = {
+    stdout: string;
+    stderr: string;
+    code: number;
+    killed: boolean;
+};
+export type ExecOptions = {
+    signal?: AbortSignal;
+    timeout?: number;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+};
+/** An LLM-visible message injected from a command. `display:true` shows it in the TUI;
+ *  `{triggerTurn:true, deliverAs:"steer"}` makes the model act on it this turn. */
+export type SendMessage = {
+    customType: string;
+    content: string;
+    display?: boolean;
+    details?: Record<string, unknown>;
+};
+export type SendMessageOptions = {
+    triggerTurn?: boolean;
+    deliverAs?: "steer" | "followUp";
+};
+export type CommandSpec = {
+    description: string;
+    handler: (args: string, ctx: ExtensionCommandContext) => void | Promise<void>;
+    getArgumentCompletions?: (prefix: string) => AutocompleteItem[] | null;
+};
+export interface ExtensionAPI {
+    on(event: "session_start", handler: (event: SessionStartEvent, ctx: ExtensionContext) => void | Promise<void>): void;
+    on(event: "session_shutdown", handler: (event: SessionShutdownEvent, ctx: ExtensionContext) => void | Promise<void>): void;
+    on(event: "before_agent_start", handler: (event: BeforeAgentStartEvent, ctx: ExtensionContext) => BeforeAgentStartResult | Promise<BeforeAgentStartResult>): void;
+    registerCommand(name: string, spec: CommandSpec): void;
+    exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
+    sendMessage(message: SendMessage, options?: SendMessageOptions): void;
+}
+//# sourceMappingURL=pi.d.ts.map

package/dist/pi.d.ts.map

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

package/dist/pi.js

@@ -0,0 +1,10 @@
+// Narrow, local typing for the slice of Pi's extension API this plugin uses.
+//
+// Pi (badlogic/pi-mono, earendil-works/pi) ships its ExtensionAPI types with the
+// harness rather than as a standalone npm package we can depend on, so we declare
+// exactly the surface we touch — three lifecycle events, `registerCommand`, `exec`,
+// and `sendMessage`. Kept deliberately minimal: a wider mirror would rot against a
+// moving upstream. Signatures follow the published extension docs
+// (https://pi.dev/docs/latest/extensions).
+export {};
+//# sourceMappingURL=pi.js.map

package/dist/pi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.js","sourceRoot":"","sources":["../src/pi.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,iFAAiF;AACjF,kFAAkF;AAClF,oFAAoF;AACpF,mFAAmF;AACnF,kEAAkE;AAClE,2CAA2C"}

package/dist/sharedserver-resolve.d.ts

@@ -0,0 +1,19 @@
+export type LogFn = (level: "info" | "warn" | "error", message: string) => void;
+export type ToastFn = (variant: "success" | "warning" | "error", message: string) => void;
+export type ResolveConfig = {
+    /** Prefix for user-facing messages. Default "sharedserver". */
+    label?: string;
+    /** Minimum acceptable version. Defaults to pkgVersion (lockstep). */
+    minVersion?: string;
+    /** Installer to fetch. Defaults to the release pinned to pkgVersion. */
+    installerUrl?: string;
+    /** The host package's own version — only meaningful in lockstep mode. */
+    pkgVersion?: string;
+};
+/** Resolve the sharedserver binary, fetching a release when nothing usable is present.
+ *
+ *  Behaviourally identical to plugins/claude/bin/sharedserver — same ladder, floor,
+ *  lock and degrade-rather-than-die fallback, so a user running both clients gets the
+ *  same answer to "which sharedserver am I on, and why". */
+export declare function resolveSharedserver(cfg: ResolveConfig, override: string | undefined, env: NodeJS.ProcessEnv, log?: LogFn, toast?: ToastFn): string | undefined;
+//# sourceMappingURL=sharedserver-resolve.d.ts.map

package/dist/sharedserver-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharedserver-resolve.d.ts","sourceRoot":"","sources":["../src/sharedserver-resolve.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAC/E,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAEzF,MAAM,MAAM,aAAa,GAAG;IACxB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAyID;;;;4DAI4D;AAC5D,wBAAgB,mBAAmB,CAC/B,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,CAAC,EAAE,KAAK,EACX,KAAK,CAAC,EAAE,OAAO,GAChB,MAAM,GAAG,SAAS,CA4CpB"}

package/dist/sharedserver-resolve.js

@@ -0,0 +1,188 @@
+// Resolve the `sharedserver` binary, fetching it when none is usable.
+//
+// VENDORED FILE. This is copied byte-identical into the consuming OpenCode plugins
+// (cribsheet, svg-mcp) by their scripts/sync-vendored.sh, so the drift check is a plain
+// diff. There is no way to share it as a dependency without coupling their versions to
+// sharedserver's — see plugins/claude/bin/sharedserver for the same reasoning on the
+// shell side. Edit it HERE; consumers re-sync.
+//
+// Everything repo-specific arrives through ResolveConfig rather than being hardcoded,
+// mirroring bin/sharedserver.conf.
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Oldest release these plugins are correct against: 0.5.0 added the PID-reuse guard,
+ *  without which a recycled client PID can hold a server open indefinitely. */
+const HARDCODED_FLOOR = "0.5.0";
+const CANDIDATE_BINARIES = [
+    "sharedserver",
+    join(homedir(), ".cargo", "bin", "sharedserver"),
+    join(homedir(), ".local", "bin", "sharedserver"),
+    "/usr/local/bin/sharedserver",
+    "/opt/homebrew/bin/sharedserver",
+];
+function parseVersion(text) {
+    const m = text.match(/(\d+)\.(\d+)\.(\d+)/);
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : undefined;
+}
+function gte(a, b) {
+    for (let i = 0; i < 3; i++)
+        if (a[i] !== b[i])
+            return a[i] > b[i];
+    return true;
+}
+function versionOf(candidate, env) {
+    const r = spawnSync(candidate, ["--version"], { env });
+    if (r.error)
+        return undefined;
+    return parseVersion(`${r.stdout?.toString() ?? ""}${r.stderr?.toString() ?? ""}`);
+}
+/** Synchronous sleep — this path runs before anything can be awaited, so the lock wait
+ *  cannot use timers. Atomics.wait blocks without spinning. */
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+/** First sharedserver found at ANY version, or undefined. */
+function probeAny(override, env) {
+    const candidates = [override, env.SHAREDSERVER_BIN, ...CANDIDATE_BINARIES].filter((v) => typeof v === "string" && v.length > 0);
+    for (const candidate of candidates) {
+        if (candidate.includes("/")) {
+            if (existsSync(candidate))
+                return candidate;
+            continue;
+        }
+        // Presence is "spawn did not fail", NOT "exited 0" — a build that rejects some
+        // flag is still present.
+        if (!spawnSync(candidate, ["--version"], { stdio: "ignore", env }).error)
+            return candidate;
+    }
+    return undefined;
+}
+/** Download and run the cargo-dist installer, then re-probe. */
+function installPinned(cfg, url, what, env, log, toast) {
+    // The SAME lock directory as the shell shim — cross-client coordination, so a
+    // Claude session and an OpenCode session starting together do not race.
+    const lockdir = join(env.TMPDIR || "/tmp", ".sharedserver-install.lock");
+    let haveLock = false;
+    try {
+        mkdirSync(lockdir);
+        haveLock = true;
+    }
+    catch {
+        const deadline = Date.now() + 20_000;
+        while (existsSync(lockdir) && Date.now() < deadline)
+            sleepSync(250);
+        const after = probeAny(undefined, env);
+        if (after)
+            return after;
+        try {
+            mkdirSync(lockdir);
+            haveLock = true;
+        }
+        catch {
+            log?.("warn", `${cfg.label}: another process is installing sharedserver and did not finish; remove the stale lock if this persists: ${lockdir}`);
+            return undefined;
+        }
+    }
+    try {
+        // Re-probe under the lock: the winner may have finished while we waited.
+        const already = probeAny(undefined, env);
+        const floor = parseVersion(cfg.minVersion ?? HARDCODED_FLOOR);
+        if (already) {
+            const v = versionOf(already, env);
+            if (v && floor && gte(v, floor))
+                return already;
+        }
+        // Download to a file, then run it. `curl … | sh` would report success on a 404,
+        // since a pipeline's status is sh's; spawnSync uses no shell, so this is exact.
+        const script = join(lockdir, "installer.sh");
+        const dl = spawnSync("curl", ["--proto", "=https", "--tlsv1.2", "-LsSf", url, "-o", script], { env });
+        if (dl.error || dl.status !== 0) {
+            const msg = `${cfg.label}: could not download the sharedserver installer (${what})`;
+            log?.("warn", msg);
+            toast?.("warning", msg);
+            return undefined;
+        }
+        if (!existsSync(script) || statSync(script).size === 0) {
+            log?.("warn", `${cfg.label}: the downloaded sharedserver installer was empty`);
+            return undefined;
+        }
+        // cargo-dist embeds the expected sha256 but looks up only `sha256sum` and SKIPS
+        // verification when missing — i.e. always, on macOS. Give it one (identical
+        // output) rather than execute an unverified binary.
+        let runEnv = env;
+        if (spawnSync("sh", ["-c", "command -v sha256sum"], { stdio: "ignore" }).status !== 0) {
+            if (spawnSync("sh", ["-c", "command -v shasum"], { stdio: "ignore" }).status !== 0) {
+                log?.("warn", `${cfg.label}: refusing to install sharedserver — no sha256sum or shasum to verify the download`);
+                return undefined;
+            }
+            writeFileSync(join(lockdir, "sha256sum"), '#!/bin/sh\nexec shasum -a 256 "$@"\n', { mode: 0o755 });
+            runEnv = { ...env, PATH: `${lockdir}:${env.PATH ?? ""}` };
+        }
+        const run = spawnSync("sh", [script], { env: runEnv, stdio: "ignore" });
+        if (run.error || run.status !== 0) {
+            log?.("warn", `${cfg.label}: the sharedserver installer ran but failed`);
+            return undefined;
+        }
+        return probeAny(undefined, env);
+    }
+    finally {
+        if (haveLock) {
+            try {
+                rmSync(lockdir, { recursive: true, force: true });
+            }
+            catch {
+                /* best effort — a leaked lock costs the next run its bounded wait */
+            }
+        }
+    }
+}
+/** Resolve the sharedserver binary, fetching a release when nothing usable is present.
+ *
+ *  Behaviourally identical to plugins/claude/bin/sharedserver — same ladder, floor,
+ *  lock and degrade-rather-than-die fallback, so a user running both clients gets the
+ *  same answer to "which sharedserver am I on, and why". */
+export function resolveSharedserver(cfg, override, env, log, toast) {
+    const label = cfg.label ?? "sharedserver";
+    const minVersion = cfg.minVersion ?? cfg.pkgVersion ?? HARDCODED_FLOOR;
+    const url = cfg.installerUrl ??
+        (cfg.pkgVersion
+            ? `https://github.com/georgeharker/sharedserver/releases/download/v${cfg.pkgVersion}/sharedserver-installer.sh`
+            : "https://github.com/georgeharker/sharedserver/releases/latest/download/sharedserver-installer.sh");
+    const what = cfg.installerUrl || !cfg.pkgVersion ? "the latest release" : `v${cfg.pkgVersion}`;
+    const resolved = { ...cfg, label, minVersion };
+    const floor = parseVersion(minVersion);
+    // An explicit binary / SHAREDSERVER_BIN is never second-guessed: the user named a
+    // specific one, so quietly downloading a different one is the wrong answer.
+    const explicit = override ?? env.SHAREDSERVER_BIN;
+    if (explicit) {
+        const present = explicit.includes("/")
+            ? existsSync(explicit)
+            : !spawnSync(explicit, ["--version"], { stdio: "ignore", env }).error;
+        if (present) {
+            const v = versionOf(explicit, env);
+            if (v && floor && !gte(v, floor)) {
+                const msg = `${label}: sharedserver at ${explicit} is ${v.join(".")}; this plugin expects >= ${minVersion}. Using it anyway because you set it explicitly.`;
+                log?.("warn", msg);
+                toast?.("warning", msg);
+            }
+            return explicit;
+        }
+    }
+    const found = probeAny(override, env);
+    if (found) {
+        const v = versionOf(found, env);
+        if (v && floor && gte(v, floor))
+            return found;
+        // Too old: fetch, but remember this one — if the download fails we would rather
+        // run the old binary than nothing.
+        const msg = `${label}: sharedserver at ${found} is ${v?.join(".") ?? "an unknown version"}; this plugin expects >= ${minVersion}. Fetching ${what}. To keep your own build, set SHAREDSERVER_BIN=${found}`;
+        log?.("warn", msg);
+        toast?.("warning", msg);
+        return installPinned(resolved, url, what, env, log, toast) ?? found;
+    }
+    log?.("info", `${label}: no usable sharedserver found; fetching ${what} (one time). This needs no Rust toolchain.`);
+    return installPinned(resolved, url, what, env, log, toast);
+}
+//# sourceMappingURL=sharedserver-resolve.js.map

package/dist/sharedserver-resolve.js.map

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