@the-librarian/cli 1.0.0-rc.21

package/dist/harnesses/codex.js

@@ -0,0 +1,183 @@
+// Codex harness.
+//
+// Prefers the native `codex` CLI; falls back to editing the config file
+// directly only when `codex` isn't on PATH but the config is still
+// writable (so a partial Codex setup can still be wired up).
+//
+//   detect    `~/.codex/config.toml` has a `[mcp_servers.librarian]` table
+//   install   `codex mcp add librarian --url <U>
+//                 --bearer-token-env-var LIBRARIAN_AGENT_TOKEN`
+//             (fallback: write the table into config.toml)
+//   uninstall `codex mcp remove librarian` (fallback: strip the table)
+//   update    re-run install (idempotent)
+//
+// Token handling (spec §9): the token's *value* never enters config or the
+// command line. Codex stores only the env-var NAME `LIBRARIAN_AGENT_TOKEN`;
+// it resolves the value at request time. We pass `cfg.mcpUrl` (not the
+// token) on the CLI, so nothing secret is ever logged.
+import fs from "node:fs";
+import path from "node:path";
+import { run, which } from "../exec.js";
+import { codexConfigPath } from "../paths.js";
+const CLI = "codex";
+const SERVER_ID = "librarian";
+const TOKEN_ENV_VAR = "LIBRARIAN_AGENT_TOKEN";
+const TABLE_HEADER = "[mcp_servers.librarian]";
+// The config-shape version we stamp, so detect can report something even
+// though TOML carries no native version for an MCP entry.
+const CONFIG_VERSION = "1";
+const VERSION_MARKER = "# librarian-config-version =";
+/** Read config.toml, or "" if it doesn't exist yet. */
+function readConfig() {
+    try {
+        return fs.readFileSync(codexConfigPath(), "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+/** True iff the config text already declares our MCP server table. */
+function hasTable(config) {
+    return config.split("\n").some((line) => line.trim() === TABLE_HEADER);
+}
+/** Parse the stamped config-shape version from a managed comment, if any. */
+function parseConfigVersion(config) {
+    for (const line of config.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith(VERSION_MARKER)) {
+            const v = trimmed
+                .slice(VERSION_MARKER.length)
+                .trim()
+                .replace(/^["']|["']$/g, "");
+            if (v)
+                return v;
+        }
+    }
+    return undefined;
+}
+/** Append our managed table to existing config text (idempotent caller). */
+function withTable(config, cfg) {
+    const block = [
+        `${VERSION_MARKER} "${CONFIG_VERSION}"`,
+        TABLE_HEADER,
+        `url = ${tomlString(cfg.mcpUrl)}`,
+        `bearer_token_env_var = ${tomlString(TOKEN_ENV_VAR)}`,
+    ].join("\n");
+    const base = config.length === 0 || config.endsWith("\n") ? config : `${config}\n`;
+    const sep = base.length === 0 ? "" : "\n";
+    return `${base}${sep}${block}\n`;
+}
+/** Strip our managed table (and its version marker) from config text. */
+function withoutTable(config) {
+    const lines = config.split("\n");
+    const out = [];
+    let skipping = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === VERSION_MARKER || trimmed.startsWith(VERSION_MARKER)) {
+            // Drop a marker line immediately preceding our table.
+            continue;
+        }
+        if (trimmed === TABLE_HEADER) {
+            skipping = true;
+            continue;
+        }
+        if (skipping) {
+            // A new table header (or end of our keys) ends the skip region.
+            if (/^\[.+\]$/.test(trimmed)) {
+                skipping = false;
+                out.push(line);
+                continue;
+            }
+            if (trimmed === "" || /^[A-Za-z0-9_]+\s*=/.test(trimmed)) {
+                continue; // a key/blank inside our table — drop it
+            }
+            skipping = false;
+        }
+        out.push(line);
+    }
+    // Tidy trailing blank lines.
+    while (out.length > 0 && out[out.length - 1] === "")
+        out.pop();
+    return out.length === 0 ? "" : `${out.join("\n")}\n`;
+}
+function writeConfig(content) {
+    const file = codexConfigPath();
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, content, "utf8");
+}
+export const codex = {
+    id: "codex",
+    displayName: "Codex",
+    async detect() {
+        const config = readConfig();
+        if (!hasTable(config))
+            return { installed: false };
+        const version = parseConfigVersion(config) ?? CONFIG_VERSION;
+        return { installed: true, version };
+    },
+    async install(cfg) {
+        if (await which(CLI)) {
+            // Idempotent: if our table is already present, do nothing.
+            if (hasTable(readConfig()))
+                return;
+            const result = await run(CLI, [
+                "mcp",
+                "add",
+                SERVER_ID,
+                "--url",
+                cfg.mcpUrl,
+                "--bearer-token-env-var",
+                TOKEN_ENV_VAR,
+            ]);
+            if (result.code !== 0) {
+                throw new Error(`codex mcp add failed: ${oneLine(result.stderr || result.stdout)}`);
+            }
+            // Stamp our config-shape version alongside the CLI-written table so
+            // detect can report it (the CLI doesn't write the marker comment).
+            stampVersionIfMissing();
+            return;
+        }
+        // Fallback: no `codex` on PATH. We can still write the config file.
+        const config = readConfig();
+        if (hasTable(config))
+            return; // idempotent
+        writeConfig(withTable(config, cfg));
+    },
+    async uninstall() {
+        if (await which(CLI)) {
+            // `codex mcp remove` is a no-op when the server is absent.
+            await run(CLI, ["mcp", "remove", SERVER_ID]);
+        }
+        // Always clean the config text too (covers the CLI-absent path and the
+        // version marker the CLI doesn't manage).
+        const config = readConfig();
+        if (hasTable(config) || parseConfigVersion(config) !== undefined) {
+            writeConfig(withoutTable(config));
+        }
+    },
+    async update(cfg) {
+        // Re-applying is idempotent; install short-circuits when present.
+        await this.install(cfg);
+    },
+};
+/** If the table exists but our version marker doesn't, add the marker. */
+function stampVersionIfMissing() {
+    const config = readConfig();
+    if (!hasTable(config) || parseConfigVersion(config) !== undefined)
+        return;
+    const lines = config.split("\n");
+    const idx = lines.findIndex((line) => line.trim() === TABLE_HEADER);
+    if (idx === -1)
+        return;
+    lines.splice(idx, 0, `${VERSION_MARKER} "${CONFIG_VERSION}"`);
+    writeConfig(lines.join("\n"));
+}
+/** Double-quote a TOML string value with minimal escaping. */
+function tomlString(value) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function oneLine(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=codex.js.map

package/dist/harnesses/codex.js.map

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

package/dist/harnesses/hermes.d.ts

@@ -0,0 +1,16 @@
+import type { HarnessModule } from "./types.js";
+export declare const PINNED_REF: string;
+/**
+ * Fetches the Hermes adapter for a pinned ref and returns the absolute
+ * path to a directory whose contents ARE the adapter (the equivalent of
+ * `integrations/hermes/librarian/`). The caller copies from there.
+ *
+ * Injectable so tests substitute a local fixture instead of the network.
+ */
+export type AdapterFetcher = (ref: string) => Promise<string>;
+/** Override the adapter fetcher (tests inject a local-fixture fetcher). */
+export declare function setAdapterFetcher(next: AdapterFetcher): void;
+/** Restore the default (network) adapter fetcher (tests). */
+export declare function resetAdapterFetcher(): void;
+export declare const hermes: HarnessModule;
+//# sourceMappingURL=hermes.d.ts.map

package/dist/harnesses/hermes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.d.ts","sourceRoot":"","sources":["../../src/harnesses/hermes.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAQ/D,eAAO,MAAM,UAAU,QAAqB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAqC9D,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAE5D;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAoDD,eAAO,MAAM,MAAM,EAAE,aA+CpB,CAAC"}

package/dist/harnesses/hermes.js

@@ -0,0 +1,158 @@
+// Hermes harness.
+//
+// Hermes has no native install command for a memory provider, so we:
+//   - copy the adapter into `~/.hermes/plugins/librarian`, and
+//   - set `memory.provider = librarian` in `~/.hermes/config.json`.
+//
+//   detect    plugin dir present AND provider set to "librarian"
+//             version comes from the adapter's `plugin.yaml`
+//   uninstall remove the plugin dir + unset the provider key
+//   update    re-fetch + re-copy the adapter (idempotent)
+//
+// ARTIFACT SOURCING. On a user's machine the adapter does NOT live in the
+// repo — the CLI must fetch it from a pinned release. We download a tarball
+// of the pinned ref from GitHub's codeload endpoint
+//   https://codeload.github.com/JimJafar/the-librarian/tar.gz/refs/tags/<ref>
+// and extract `integrations/hermes/librarian/**` out of it with `tar`. The
+// FETCH is injectable (`setAdapterFetcher`): tests inject a fetcher that
+// returns a local fixture dir, so nothing touches the network. The pinned
+// ref defaults to the repo's current release tag (PINNED_REF).
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { run } from "../exec.js";
+import { hermesConfigPath, hermesHomeDir, hermesPluginDir } from "../paths.js";
+import { cliVersion } from "../version.js";
+const PROVIDER_ID = "librarian";
+// The pinned monorepo release we fetch the adapter from: the tag matching this
+// CLI's own version. DERIVED (not hardcoded) so it can't drift — the published
+// package's version is stamped from the root at publish (scripts/stamp-version.mjs),
+// and the matching `vX.Y.Z` tag exists before the package is published. A
+// hardcoded literal here silently froze at rc.5 once before.
+export const PINNED_REF = `v${cliVersion()}`;
+/** The default fetcher: codeload tarball → `tar` extract → adapter dir. */
+const defaultFetcher = async (ref) => {
+    const url = `https://codeload.github.com/JimJafar/the-librarian/tar.gz/refs/tags/${ref}`;
+    const work = fs.mkdtempSync(path.join(os.tmpdir(), "librarian-hermes-fetch-"));
+    const tarball = path.join(work, "src.tar.gz");
+    const res = await fetch(url, { redirect: "error" });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch Hermes adapter (${ref}): HTTP ${res.status}`);
+    }
+    const buf = Buffer.from(await res.arrayBuffer());
+    fs.writeFileSync(tarball, buf);
+    // codeload nests the adapter at
+    //   the-librarian-<ref>/integrations/hermes/librarian/**
+    // — four leading path components. Strip all four so the adapter's own
+    // files (plugin.yaml, …) land at the extraction root, which is what the
+    // caller copies into `~/.hermes/plugins/librarian/`.
+    const out = path.join(work, "adapter");
+    fs.mkdirSync(out, { recursive: true });
+    const extract = await run("tar", [
+        "-xzf",
+        tarball,
+        "-C",
+        out,
+        "--strip-components=4",
+        "--wildcards",
+        "*/integrations/hermes/librarian/*",
+    ]);
+    if (extract.code !== 0) {
+        throw new Error(`Failed to extract Hermes adapter: ${(extract.stderr || "").trim()}`);
+    }
+    return out;
+};
+let fetcher = defaultFetcher;
+/** Override the adapter fetcher (tests inject a local-fixture fetcher). */
+export function setAdapterFetcher(next) {
+    fetcher = next;
+}
+/** Restore the default (network) adapter fetcher (tests). */
+export function resetAdapterFetcher() {
+    fetcher = defaultFetcher;
+}
+function readHermesConfig() {
+    try {
+        const raw = fs.readFileSync(hermesConfigPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeHermesConfig(config) {
+    fs.mkdirSync(hermesHomeDir(), { recursive: true });
+    fs.writeFileSync(hermesConfigPath(), `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+/** True iff `memory.provider` is set to our provider id. */
+function providerSet() {
+    const config = readHermesConfig();
+    return config?.memory?.provider === PROVIDER_ID;
+}
+/** Parse `version:` from the installed adapter's plugin.yaml, if present. */
+function readAdapterVersion() {
+    try {
+        const raw = fs.readFileSync(path.join(hermesPluginDir(), "plugin.yaml"), "utf8");
+        for (const line of raw.split("\n")) {
+            const m = /^\s*version\s*:\s*["']?([^"'#\s]+)/.exec(line);
+            if (m?.[1])
+                return m[1];
+        }
+    }
+    catch {
+        // dir/file gone — no version
+    }
+    return undefined;
+}
+/** Recursively copy a directory tree (Node 22 `fs.cpSync`). */
+function copyDir(from, to) {
+    fs.rmSync(to, { recursive: true, force: true });
+    fs.mkdirSync(path.dirname(to), { recursive: true });
+    fs.cpSync(from, to, { recursive: true });
+}
+export const hermes = {
+    id: "hermes",
+    displayName: "Hermes",
+    async detect() {
+        const dirPresent = fs.existsSync(hermesPluginDir());
+        if (!dirPresent || !providerSet())
+            return { installed: false };
+        const version = readAdapterVersion();
+        return version === undefined ? { installed: true } : { installed: true, version };
+    },
+    async install(_cfg) {
+        // Fetch the adapter for the pinned ref (network by default; a local
+        // fixture in tests) and copy it into place — overwriting any prior copy
+        // so re-running is idempotent.
+        const adapterDir = await fetcher(PINNED_REF);
+        copyDir(adapterDir, hermesPluginDir());
+        // Set memory.provider = librarian, preserving any other config keys.
+        const config = readHermesConfig() ?? {};
+        const memory = (config.memory && typeof config.memory === "object" ? config.memory : {});
+        memory.provider = PROVIDER_ID;
+        config.memory = memory;
+        writeHermesConfig(config);
+    },
+    async uninstall() {
+        // Remove the plugin dir (no-op if already gone).
+        fs.rmSync(hermesPluginDir(), { recursive: true, force: true });
+        // Unset memory.provider only if it's ours, preserving other keys.
+        const config = readHermesConfig();
+        if (config?.memory && typeof config.memory === "object") {
+            if (config.memory.provider === PROVIDER_ID) {
+                delete config.memory.provider;
+                if (Object.keys(config.memory).length === 0)
+                    delete config.memory;
+                writeHermesConfig(config);
+            }
+        }
+    },
+    async update(cfg) {
+        await this.install(cfg);
+    },
+};
+//# sourceMappingURL=hermes.js.map

package/dist/harnesses/hermes.js.map

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

package/dist/harnesses/index.d.ts

@@ -0,0 +1,12 @@
+import type { HarnessId, HarnessModule } from "./types.js";
+/** Every harness module, keyed by id. */
+export declare const registry: Record<HarnessId, HarnessModule>;
+/** The harness ids in canonical display order. */
+export declare const HARNESS_IDS: readonly HarnessId[];
+/** All harness modules in canonical display order. */
+export declare const allHarnesses: readonly HarnessModule[];
+/** True iff `id` names a known harness. */
+export declare function isHarnessId(id: string): id is HarnessId;
+export type { HarnessConfig, HarnessModule, DetectResult, HarnessId } from "./types.js";
+export { NotImplemented } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/harnesses/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harnesses/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,yCAAyC;AACzC,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,CAMrD,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAAoD,CAAC;AAEjG,sDAAsD;AACtD,eAAO,MAAM,YAAY,EAAE,SAAS,aAAa,EAA0C,CAAC;AAE5F,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,SAAS,CAEvD;AAED,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/harnesses/index.js

@@ -0,0 +1,29 @@
+// The harness registry: id → module.
+//
+// The single source of truth for "which harnesses exist". Commands iterate
+// this in declaration order (the order the dashboard and prompts show them).
+// The next wave swaps the stub modules for real implementations without
+// touching this file.
+import { claude } from "./claude.js";
+import { codex } from "./codex.js";
+import { hermes } from "./hermes.js";
+import { opencode } from "./opencode.js";
+import { pi } from "./pi.js";
+/** Every harness module, keyed by id. */
+export const registry = {
+    claude,
+    codex,
+    opencode,
+    hermes,
+    pi,
+};
+/** The harness ids in canonical display order. */
+export const HARNESS_IDS = ["claude", "codex", "opencode", "hermes", "pi"];
+/** All harness modules in canonical display order. */
+export const allHarnesses = HARNESS_IDS.map((id) => registry[id]);
+/** True iff `id` names a known harness. */
+export function isHarnessId(id) {
+    return Object.prototype.hasOwnProperty.call(registry, id);
+}
+export { NotImplemented } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/harnesses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harnesses/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,wEAAwE;AACxE,sBAAsB;AAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,yCAAyC;AACzC,MAAM,CAAC,MAAM,QAAQ,GAAqC;IACxD,MAAM;IACN,KAAK;IACL,QAAQ;IACR,MAAM;IACN,EAAE;CACH,CAAC;AAEF,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AAEjG,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAA6B,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AAE5F,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC5D,CAAC;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/harnesses/opencode.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessModule } from "./types.js";
+export declare const opencode: HarnessModule;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/harnesses/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/harnesses/opencode.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AA4E/D,eAAO,MAAM,QAAQ,EAAE,aAuEtB,CAAC"}

package/dist/harnesses/opencode.js

@@ -0,0 +1,141 @@
+// OpenCode harness.
+//
+// OpenCode has no native install command, so we edit its global config
+// (`~/.config/opencode/opencode.json`) idempotently, preserving every key
+// the user already had. We add exactly two things:
+//
+//   - `mcp.librarian`: a remote MCP block (type/url/enabled/headers). The
+//     Authorization header references the env var, not the token value —
+//     `Bearer {env:LIBRARIAN_AGENT_TOKEN}` — so the secret never lands in
+//     the file (spec §9).
+//   - the primer entry `<serverUrl>/primer.md` in the `instructions` array.
+//
+// We stamp a managed version marker (`mcp.librarian._librarianVersion`) so
+// detect can report a version, plus the EXACT primer URL we added
+// (`mcp.librarian._librarianPrimer`) so uninstall removes only our own entry
+// from `instructions` and never a foreign `…/primer.md`. detect =
+// `mcp.librarian` present. uninstall removes only the keys/entries we added,
+// leaving the rest of the JSON intact.
+import fs from "node:fs";
+import path from "node:path";
+import { opencodeConfigPath } from "../paths.js";
+const SERVER_ID = "librarian";
+const TOKEN_ENV_VAR = "LIBRARIAN_AGENT_TOKEN";
+const MANAGED_VERSION = "1.0.0";
+const VERSION_KEY = "_librarianVersion";
+// The exact primer instruction we added, stamped into the managed block so
+// uninstall can target only it (and not a foreign `…/primer.md`).
+const PRIMER_KEY = "_librarianPrimer";
+/** The primer instruction entry derived from the server URL. */
+function primerEntry(serverUrl) {
+    return `${serverUrl.replace(/\/+$/, "")}/primer.md`;
+}
+/** Read + parse opencode.json, or null if absent / unreadable / invalid. */
+function readConfig() {
+    let raw;
+    try {
+        raw = fs.readFileSync(opencodeConfigPath(), "utf8");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeConfig(config) {
+    const file = opencodeConfigPath();
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+/** The managed remote block we install. */
+function librarianBlock(cfg) {
+    return {
+        type: "remote",
+        url: cfg.mcpUrl,
+        enabled: true,
+        headers: { Authorization: `Bearer {env:${TOKEN_ENV_VAR}}` },
+        [VERSION_KEY]: MANAGED_VERSION,
+        // Stamp the exact primer entry we add so uninstall removes only ours.
+        [PRIMER_KEY]: primerEntry(cfg.serverUrl),
+    };
+}
+function getMcpEntry(config) {
+    const mcp = config?.mcp;
+    if (mcp && typeof mcp === "object" && SERVER_ID in mcp) {
+        return mcp[SERVER_ID];
+    }
+    return undefined;
+}
+export const opencode = {
+    id: "opencode",
+    displayName: "OpenCode",
+    async detect() {
+        const entry = getMcpEntry(readConfig());
+        if (!entry)
+            return { installed: false };
+        const version = typeof entry[VERSION_KEY] === "string" ? entry[VERSION_KEY] : undefined;
+        return version === undefined ? { installed: true } : { installed: true, version };
+    },
+    async install(cfg) {
+        const config = readConfig() ?? {};
+        // mcp.librarian — overwrite our managed block (idempotent), preserve
+        // every other mcp server.
+        const mcp = (config.mcp && typeof config.mcp === "object" ? config.mcp : {});
+        mcp[SERVER_ID] = librarianBlock(cfg);
+        config.mcp = mcp;
+        // instructions — ensure the primer entry is present exactly once,
+        // preserving any existing entries. Tolerate a missing/non-array value.
+        const entry = primerEntry(cfg.serverUrl);
+        const existing = Array.isArray(config.instructions)
+            ? config.instructions.filter((x) => typeof x === "string")
+            : [];
+        if (!existing.includes(entry))
+            existing.push(entry);
+        config.instructions = existing;
+        writeConfig(config);
+    },
+    async uninstall() {
+        const config = readConfig();
+        if (!config)
+            return; // nothing to do — no-op when absent
+        let changed = false;
+        // Read the EXACT primer entry we stamped before removing our block, so we
+        // can target only our own instruction and never a foreign `…/primer.md`.
+        const ourPrimer = getMcpEntry(config)?.[PRIMER_KEY];
+        // Remove our mcp.librarian key only.
+        if (config.mcp && typeof config.mcp === "object" && SERVER_ID in config.mcp) {
+            delete config.mcp[SERVER_ID];
+            changed = true;
+            // Drop an emptied mcp object so we don't leave `{"mcp":{}}` litter.
+            if (Object.keys(config.mcp).length === 0)
+                delete config.mcp;
+        }
+        // Remove only OUR exact primer entry from instructions, preserving the
+        // rest (including any foreign `…/primer.md` we didn't add).
+        if (typeof ourPrimer === "string" && Array.isArray(config.instructions)) {
+            const before = config.instructions;
+            const kept = before.filter((x) => x !== ourPrimer);
+            if (kept.length !== before.length) {
+                changed = true;
+                if (kept.length === 0)
+                    delete config.instructions;
+                else
+                    config.instructions = kept;
+            }
+        }
+        if (changed)
+            writeConfig(config);
+    },
+    async update(cfg) {
+        await this.install(cfg);
+    },
+};
+//# sourceMappingURL=opencode.js.map

package/dist/harnesses/opencode.js.map

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

package/dist/harnesses/pi.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessModule } from "./types.js";
+export declare const pi: HarnessModule;
+//# sourceMappingURL=pi.d.ts.map

package/dist/harnesses/pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../../src/harnesses/pi.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAyB/D,eAAO,MAAM,EAAE,EAAE,aAgChB,CAAC"}