@geohar/pi-cribsheet 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 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,85 @@
+# @geohar/pi-cribsheet
+
+A [Pi](https://pi.dev) extension that makes **cribsheet** (the `crib` memory +
+code-index MCP server) available to Pi: it starts `crib` (supervised by
+[`sharedserver`](https://github.com/georgeharker/sharedserver)), injects the
+reach-for-crib directive into the system prompt, and ships the `/crib` recall command.
+
+It is the Pi counterpart of cribsheet's
+[Claude Code](https://github.com/georgeharker/cribsheet/tree/main/plugins/claude) and
+[OpenCode](https://github.com/georgeharker/cribsheet/tree/main/plugins/opencode)
+plugins, and shares the same `crib` server and `sharedserver` instance — so Pi, Claude
+Code, OpenCode, and Neovim all talk to one refcounted process.
+
+## How it fits together
+
+Pi has no MCP of its own. Two pieces give it crib:
+
+1. **[`pi-mcp-adapter`](https://pi.dev/packages/pi-mcp-adapter)** — the Pi package that
+   speaks MCP. It reads its own `mcp.json` and connects to `crib` over HTTP. **Install
+   it too** (`pi install npm:pi-mcp-adapter`).
+2. **This extension** — the process + directive + command half:
+   - **Run crib** on `session_start` via `sharedserver use … -- crib --mcp --http …`,
+     refcounted and shared across clients; released on `session_shutdown` when
+     `reason === "quit"`.
+   - **Inject the directive** on `before_agent_start` (analogue of CC's
+     `additionalContext` and OpenCode's `system.transform`).
+   - **`/crib <topic>`** — shells out to the crib CLI (`note apropos` + `code lookup`)
+     and steers the model to summarise, mirroring `commands/crib.md`.
+
+### Stand-down when combiner-served
+
+If a **combiner** already serves crib (the global `MCP_COMBINER` switch, or the
+per-backend `MCP_COMBINER_SERVES_CRIBSHEET` override, which wins), the extension does
+**not** launch a standalone backend — the combiner owns crib's lifecycle. The directive
+and `/crib` command still apply, since crib's tools are present via the combiner too. In
+that setup you register the *combiner* with pi-mcp-adapter (see the mcp-companion Pi
+extension), not crib directly.
+
+## Install
+
+```sh
+# build
+npm --prefix plugins/pi install && npm --prefix plugins/pi run build
+# install into Pi (symlink the package dir; uses "main": dist/index.js)
+ln -sfn "$PWD/plugins/pi" ~/.pi/agent/extensions/cribsheet
+# MCP transport (skip the mcp.json when crib is combiner-served)
+pi install npm:pi-mcp-adapter
+cp plugins/pi/mcp.json.example ~/.config/mcp/mcp.json   # standalone only
+```
+
+Build-free live dev: `pi -e ./plugins/pi/src/index.ts`.
+
+## Configuration
+
+`PI_CRIBSHEET_*` env namespace (mirrors the OpenCode plugin's `OPENCODE_CRIBSHEET_*`):
+
+| Variable | Default | Effect |
+|----------|---------|--------|
+| `PI_CRIBSHEET_PORT` | `7732` | HTTP port crib serves on. |
+| `PI_CRIBSHEET_HOST` | `127.0.0.1` | HTTP host crib binds. |
+| `PI_CRIBSHEET_COMMAND` / `_ARGS` | *(auto: `crib` on PATH)* | Override the crib invocation. |
+| `PI_CRIBSHEET_CHECKOUT` | — | Checkout for `uv run --project <checkout> crib`. |
+| `PI_CRIBSHEET_NAME` | `cribsheet` | `sharedserver` instance name. |
+| `PI_CRIBSHEET_GRACE` | `1h` | `sharedserver` grace period. |
+| `PI_CRIBSHEET_LOG` | — | Capture crib's stdout/stderr (`sharedserver --log-file`); `"none"`/unset disables. |
+| `PI_CRIBSHEET_MANAGE` | `true` | `false` → don't launch (assume crib runs elsewhere). |
+| `PI_CRIBSHEET_INSTRUCTIONS` | `true` | `false` → don't inject the directive. |
+| `PI_CRIBSHEET_COMMAND_ENABLE` | `true` | `false` → don't register `/crib`. |
+| `PI_CRIBSHEET_NOTIFY` | `true` | `false` → don't surface messages via the Pi UI. |
+| `MCP_COMBINER` / `MCP_COMBINER_SERVES_CRIBSHEET` | — | Combiner serves crib → don't launch a standalone backend. |
+| `SHAREDSERVER_BIN` / `SHAREDSERVER_LOCKDIR` | *(auto)* | sharedserver binary / lock dir. |
+
+## Development
+
+```sh
+npm install && npm run typecheck && npm run build
+```
+
+`src/sharedserver-resolve.ts` is vendored byte-identical from
+[`georgeharker/sharedserver`](https://github.com/georgeharker/sharedserver) via
+`scripts/sync-vendored.sh` — edit 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 cribsheet(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":"AA8BA,OAAO,KAAK,EAER,YAAY,EAIf,MAAM,SAAS,CAAA;AA0GhB,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAyIxD"}

package/dist/index.js

@@ -0,0 +1,275 @@
+// Pi extension: run the `crib` (cribsheet) memory + code-index MCP server via the
+// `sharedserver` CLI, inject the reach-for-crib directive into the system prompt, and
+// ship the `/crib` recall command.
+//
+// It is the Pi counterpart of cribsheet's Claude Code and OpenCode plugins, and mirrors
+// their behaviour:
+//
+//   1. Stand-down switch — if a combiner already serves crib (global MCP_COMBINER, or
+//      the per-backend MCP_COMBINER_SERVES_CRIBSHEET override, which wins), do NOT
+//      launch a standalone backend. The combiner owns crib's lifecycle. Only the launch
+//      is gated — the directive and /crib command apply either way, since crib's tools
+//      are present via the combiner too.
+//   2. Process — on `session_start`, drive `sharedserver use … -- crib --mcp --http …`
+//      so one warm crib is running and refcounted (shared across clients). Released on
+//      `session_shutdown` when `reason === "quit"` (reload/resume/fork keep the process
+//      and re-attach).
+//   3. Directive — append the reach-for-crib text to the system prompt via
+//      `before_agent_start` (analogue of Claude Code's SessionStart additionalContext
+//      and OpenCode's system.transform).
+//   4. /crib command — a Pi command mirroring commands/crib.md: shells out to the crib
+//      CLI (`note apropos` + `code lookup`) and steers the model to summarise.
+//
+// MCP registration itself (pointing pi-mcp-adapter at crib) is a single mcp.json entry
+// — see mcp.json.example and the README; static, and unnecessary when combiner-served.
+// The sharedserver resolution is ported faithfully from plugins/opencode/src/index.ts.
+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 = 7732;
+const DEFAULT_HOST = "127.0.0.1";
+const DEFAULT_NAME = "cribsheet";
+const DEFAULT_GRACE = "1h";
+// Floor-only against sharedserver's latest release: cribsheet consumes sharedserver
+// rather than shipping it. Kept equal to the sibling plugins' value.
+const SHAREDSERVER_MIN_VERSION = "0.6.7";
+// ── the reach-for-crib directive ───────────────────────────────────
+// Appended to the system prompt so the agent reaches for crib's tools. 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 CRIB_DIRECTIVE = (() => {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        return readFileSync(join(here, "..", "instructions.txt"), "utf8");
+    }
+    catch {
+        return "";
+    }
+})();
+const DIRECTIVE_MARKER = CRIB_DIRECTIVE.split("\n", 1)[0] ?? "";
+// ── env configuration ──────────────────────────────────────────────
+// The PI_CRIBSHEET_* namespace mirrors the OpenCode plugin's OPENCODE_CRIBSHEET_* and
+// the CC hook's CRIBSHEET_* set — one namespace per client.
+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);
+}
+// ── 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). These are
+ *  the cross-tool switches shared with the CC/OpenCode plugins — 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;
+}
+/** Resolve how to invoke crib: env command → `crib` on PATH → `uv run --project
+ *  <checkout> crib`. Returns the base command; callers append their own args. */
+function resolveCrib() {
+    const command = env("PI_CRIBSHEET_COMMAND");
+    if (command)
+        return { cmd: command, args: splitArgs(env("PI_CRIBSHEET_ARGS")) };
+    if (onPath("crib"))
+        return { cmd: "crib", args: [] };
+    const checkout = env("PI_CRIBSHEET_CHECKOUT");
+    if (checkout && existsSync(checkout) && onPath("uv")) {
+        return { cmd: "uv", args: ["run", "--project", checkout, "crib"] };
+    }
+    return undefined;
+}
+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 cribsheet(pi) {
+    const notify = env("PI_CRIBSHEET_NOTIFY") !== "false";
+    const wantInstructions = env("PI_CRIBSHEET_INSTRUCTIONS") !== "false";
+    const wantCommand = env("PI_CRIBSHEET_COMMAND_ENABLE") !== "false";
+    const manage = env("PI_CRIBSHEET_MANAGE") !== "false";
+    const name = env("PI_CRIBSHEET_NAME") ?? DEFAULT_NAME;
+    const served = combinerServes(name);
+    // ── directive: appended every turn (dup-guarded across turns) ──
+    pi.on("before_agent_start", (event) => {
+        if (!wantInstructions || !CRIB_DIRECTIVE)
+            return;
+        if (DIRECTIVE_MARKER && event.systemPrompt.includes(DIRECTIVE_MARKER))
+            return;
+        return { systemPrompt: `${event.systemPrompt}\n\n${CRIB_DIRECTIVE}` };
+    });
+    // ── /crib command: recall memory + code index, then steer the model ──
+    if (wantCommand) {
+        pi.registerCommand("crib", {
+            description: "Consult crib (recall memory + code index); verb: system-prompt shows the directive",
+            getArgumentCompletions: (prefix) => completeVerbs(prefix),
+            handler: async (args, ctx) => {
+                const arg = args.trim();
+                if (arg === "system-prompt") {
+                    showDirective(ctx, "cribsheet", CRIB_DIRECTIVE, wantInstructions);
+                    return;
+                }
+                const topic = arg;
+                if (!topic) {
+                    ctx.ui?.notify?.("crib: give me a topic (e.g. /crib auth flow), or /crib system-prompt", "warn");
+                    return;
+                }
+                const crib = resolveCrib();
+                if (!crib) {
+                    ctx.ui?.notify?.("crib: CLI not found; install cribsheet or set $PI_CRIBSHEET_COMMAND", "error");
+                    return;
+                }
+                const run = async (sub) => {
+                    try {
+                        const r = await pi.exec(crib.cmd, [...crib.args, ...sub, topic], {
+                            signal: ctx.signal,
+                            timeout: 30_000,
+                        });
+                        return r.stdout.trim() || r.stderr.trim();
+                    }
+                    catch (e) {
+                        return `(crib ${sub.join(" ")} failed: ${e instanceof Error ? e.message : String(e)})`;
+                    }
+                };
+                const [memory, code] = await Promise.all([run(["note", "apropos"]), run(["code", "lookup"])]);
+                const content = `Consult crib first for "${topic}" — recalled below. Summarise what crib already knows: ` +
+                    "lead with the notes' answer, fold in any relevant code symbols, and cite note/symbol names " +
+                    "so the user can `crib note read` / `crib code dossier` to go deeper. If nothing relevant came " +
+                    "back, say so plainly rather than guessing.\n\n" +
+                    `Memory — semantic recall (crib note apropos):\n${memory}\n\n` +
+                    `Code index — symbols by concept or name (crib code lookup):\n${code}`;
+                pi.sendMessage({ customType: "crib-recall", content, display: true, details: { topic } }, { triggerTurn: true, deliverAs: "steer" });
+            },
+        });
+    }
+    // Combiner-served or manage=false: nothing to launch (crib runs elsewhere). The
+    // directive + command above still apply.
+    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: "cribsheet",
+            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_CRIBSHEET_MANAGE=false");
+            return;
+        }
+        const crib = resolveCrib();
+        if (!crib) {
+            log("error", "crib command not found; install cribsheet (so `crib` is on PATH), or set " +
+                "$PI_CRIBSHEET_COMMAND / $PI_CRIBSHEET_CHECKOUT");
+            return;
+        }
+        const port = env("PI_CRIBSHEET_PORT") ?? String(DEFAULT_PORT);
+        const host = env("PI_CRIBSHEET_HOST") ?? DEFAULT_HOST;
+        const grace = env("PI_CRIBSHEET_GRACE") ?? DEFAULT_GRACE;
+        // Assemble: crib [extra] --mcp --http --host <host> --port <port>
+        const serve = ["--mcp", "--http", "--host", host, "--port", port];
+        const useArgs = [
+            "use",
+            name,
+            "--pid",
+            String(process.pid),
+            "--grace-period",
+            grace,
+            "--metadata",
+            `pi-${process.pid}`,
+        ];
+        const logFile = env("PI_CRIBSHEET_LOG");
+        if (logFile && logFile !== "none")
+            useArgs.push("--log-file", logFile);
+        useArgs.push("--", crib.cmd, ...crib.args, ...serve);
+        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", `crib "${name}" attached on ${host}:${port} (${crib.cmd} ${crib.args.join(" ")})`);
+    });
+    pi.on("session_shutdown", (event) => {
+        if (event.reason === "quit")
+            detach();
+    });
+}
+// ── helpers ────────────────────────────────────────────────────────
+// Slash-command verbs. `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` (base 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 = `cribsheet: ${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"}