zcode-acp-server 0.1.0 → 0.3.0

package/dist/bin/quota.js

@@ -0,0 +1,333 @@
+#!/usr/bin/env node
+/**
+ * Standalone CLI for querying GLM Coding Plan usage — a thin wrapper over the
+ * same `queryQuota()` + `formatQuotaPlain()` the `/quota` slash command uses.
+ *
+ * No ACP server, no zcode subprocess: only reads `~/.zcode/v2/config.json` for
+ * credentials and hits the quota HTTP API directly.
+ *
+ * Usage:
+ *   zcode-quota                  one-shot: print the card and exit
+ *   zcode-quota -w               watch mode (default 30s refresh)
+ *   zcode-quota -w -i 60         watch with a 60s interval
+ *   zcode-quota -d               show per-model MCP detail sub-lines
+ *   zcode-quota --watch --interval 15
+ *   zcode-quota -h | --help      show help
+ *
+ * The refresh interval has a 10s floor: the in-memory quota cache TTL is 10s,
+ * and a shorter interval would just keep returning the cached value.
+ */
+import process from "node:process";
+import { clearCache as clearGlmCache } from "../quota/cache.js";
+import { defaultGoWindows, formatCombinedCardPlain, queryCombined, } from "../quota/combined.js";
+import { clearGoCache } from "../quota/opencode-go/index.js";
+/** Clear both provider caches — used by watch mode per tick for live values. */
+function clearAllCaches() {
+    clearGlmCache();
+    clearGoCache();
+}
+/** Minimum watch interval (ms). Equals the quota cache TTL. */
+const MIN_INTERVAL_MS = 10_000;
+/** Default watch interval (ms). */
+const DEFAULT_INTERVAL_MS = 30_000;
+// ANSI escape sequences used by watch mode (no external dep — Local First).
+const ANSI = {
+    clearScreen: "\x1B[2J\x1B[H", // clear + cursor home
+    clearLine: "\x1B[2K", // clear the entire current line
+    hideCursor: "\x1B[?25l",
+    showCursor: "\x1B[?25h",
+};
+/** Human-readable usage text. */
+const HELP_TEXT = `Usage: zcode-quota [provider] [options]
+
+Query usage from the terminal. By default shows both GLM Coding Plan and
+Opencode Go in one card; pass a provider to focus on one.
+
+Providers:
+  (none)                    Both GLM + Opencode Go (rolling + weekly + monthly).
+  glm                       GLM Coding Plan only.
+  go                        Opencode Go only (rolling + weekly + monthly).
+
+GLM credentials: read from ~/.zcode/v2/config.json (created by the ZCode app).
+Opencode Go credentials (env vars override the config file, field by field):
+  Config file  ~/.pi/agent/opencode-go.json   {"workspaceId":"wrk_…","authCookie":"Fe26.2**…"}
+  OPENCODE_GO_WORKSPACE_ID    e.g. wrk_abc123 (from the opencode.ai workspace URL)
+  OPENCODE_GO_AUTH_COOKIE     the "auth" cookie value (starts with Fe26.2**)
+  Get the cookie via browser DevTools → Application → Cookies → opencode.ai.
+
+Options:
+  -w, --watch              Watch mode: clear the screen and refresh periodically.
+  -i, --interval <seconds> Refresh interval for watch mode (default 30, min 10).
+  -d, --detail             Show per-model MCP usage detail sub-lines (GLM only).
+  -p, --plain              Plain monochrome bars (no color, no in-bar overlay).
+                           Color is the default on a terminal; disabled
+                           automatically when stdout is piped or redirected.
+  -h, --help               Show this help and exit.
+
+Examples:
+  zcode-quota                 # both providers, print once and exit (color bars)
+  zcode-quota go              # Opencode Go only (3 windows)
+  zcode-quota glm -w          # GLM only, live monitor every 30s
+  zcode-quota -w -i 60        # both, refresh every 60s
+  zcode-quota -d              # both, include per-model MCP breakdown
+  zcode-quota --plain         # both, classic monochrome bars`;
+/**
+ * Clamp a raw interval (seconds, optional) to a valid ms value. Returns the
+ * clamped value plus whether a user-supplied value was raised to the floor.
+ *
+ * Exported for unit testing.
+ */
+export function resolveIntervalMs(seconds) {
+    const requested = (seconds ?? DEFAULT_INTERVAL_MS / 1000) * 1000;
+    if (requested < MIN_INTERVAL_MS) {
+        return { ms: MIN_INTERVAL_MS, clamped: seconds !== undefined };
+    }
+    return { ms: requested, clamped: false };
+}
+/**
+ * Parse argv into {@link CliOptions}. Supports `-w`/`--watch`, `-h`/`--help`,
+ * `-i <n>`/`--interval <n>` (space), `--interval=<n>`, and `-i<n>` (attached).
+ * The first non-flag positional arg is the provider (`glm`/`go`); any other
+ * value is ignored (treated as `all`). Unknown flags are ignored.
+ *
+ * Exported for unit testing.
+ */
+export function parseArgs(argv) {
+    let watch = false;
+    let help = false;
+    let detail = false;
+    let plain = false;
+    let interval;
+    let provider = "all";
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case "-w":
+            case "--watch":
+                watch = true;
+                break;
+            case "-d":
+            case "--detail":
+                detail = true;
+                break;
+            case "-p":
+            case "--plain":
+                plain = true;
+                break;
+            case "-h":
+            case "--help":
+                help = true;
+                break;
+            case "-i":
+            case "--interval": {
+                const next = argv[i + 1];
+                if (next !== undefined) {
+                    const n = Number(next);
+                    if (Number.isFinite(n))
+                        interval = n;
+                    i++; // consume the value
+                }
+                break;
+            }
+            default:
+                // Support `-i<value>` / `--interval=<value>` attached forms.
+                if (arg?.startsWith("--interval=")) {
+                    const n = Number(arg.slice("--interval=".length));
+                    if (Number.isFinite(n))
+                        interval = n;
+                }
+                else if (arg?.startsWith("-i") && arg.length > 2) {
+                    const n = Number(arg.slice(2));
+                    if (Number.isFinite(n))
+                        interval = n;
+                }
+                else if (arg === "glm" || arg === "go") {
+                    // First positional provider token. Only honor the first; a second
+                    // (e.g. `zcode-quota glm go`) is ignored to keep parsing simple.
+                    if (provider === "all")
+                        provider = arg;
+                }
+                // Other non-flag tokens are ignored (forward-compat / typos).
+                break;
+        }
+    }
+    const resolved = resolveIntervalMs(interval);
+    return {
+        watch,
+        detail,
+        help,
+        plain,
+        provider,
+        intervalMs: resolved.ms,
+        intervalClamped: resolved.clamped,
+    };
+}
+/**
+ * Sleep helper. Accepts an AbortSignal so SIGINT can break the wait early.
+ *
+ * NOTE: the timer is deliberately NOT `unref()`-ed. In watch mode this sleep
+ * is the only thing keeping the event loop alive between ticks; an unref'd
+ * timer lets Node exit immediately after the first frame renders, which
+ * silently kills the monitor. Only a real abort (Ctrl-C) should end the wait.
+ */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const t = setTimeout(resolve, ms);
+        signal?.addEventListener("abort", () => {
+            clearTimeout(t);
+            reject(new Error("aborted"));
+        }, { once: true });
+    });
+}
+/** Format the watch-mode countdown suffix appended to the first header. */
+function refreshSuffix(remainingSec) {
+    return `refresh in ${remainingSec}s`;
+}
+/**
+ * Render the card for a given provider selection. Centralises the
+ * combined-card formatting so watch and one-shot share one code path. In watch
+ * mode the refresh countdown is rendered on the separator row after the first
+ * section (its position is fixed whether or not a second section appears).
+ *
+ * `color` switches the bars to a heat-colored (green→red) 24-bit ANSI layout
+ * with the usage numbers overlaid inside. The CLI caller gates this on
+ * `stdout.isTTY && !plain`.
+ */
+function renderCard(combined, provider, detail, color, refresh) {
+    const text = formatCombinedCardPlain(combined, {
+        provider,
+        glm: { detail },
+        goWindows: defaultGoWindows(provider),
+        color,
+        refreshSuffix: refresh,
+    });
+    // The refresh line is the one carrying the countdown text. Without a refresh
+    // suffix there is no such line. When present it sits right after the first
+    // section, so we can find it by matching the suffix.
+    let refreshRow = null;
+    if (refresh) {
+        const lines = text.split("\n");
+        const idx = lines.findIndex((l) => l.includes(refresh));
+        refreshRow = idx >= 0 ? idx : null;
+    }
+    return { text, refreshRow };
+}
+/**
+ * Full redraw of one watch frame: clear screen, then the card (with the
+ * refresh countdown on the separator row after the first section).
+ */
+function renderFrame(text) {
+    return `${ANSI.clearScreen}${text}`;
+}
+/**
+ * Run the watch loop until the process is interrupted. Each tick clears both
+ * caches (so the displayed values are fresh, not stale cache hits), queries,
+ * and redraws. Between ticks a per-second countdown rewrites only the footer
+ * line so the card body doesn't flicker. The combined query never throws —
+ * each provider degrades internally — so this loop is robust.
+ */
+async function runWatch(intervalMs, provider, detail, color) {
+    const intervalSec = Math.round(intervalMs / 1000);
+    const controller = new AbortController();
+    const restore = () => {
+        process.stdout.write(ANSI.showCursor);
+        process.stdout.write("\n");
+    };
+    // Ctrl-C: stop the loop, restore the cursor, exit cleanly.
+    const onInt = () => {
+        controller.abort();
+        restore();
+        process.exit(0);
+    };
+    process.on("SIGINT", onInt);
+    process.stdout.write(ANSI.hideCursor);
+    try {
+        while (!controller.signal.aborted) {
+            clearAllCaches(); // bypass caches — always show live values
+            const combined = await queryCombined(provider);
+            // Full redraw with the countdown starting at the interval max.
+            const first = renderCard(combined, provider, detail, color, refreshSuffix(intervalSec));
+            process.stdout.write(renderFrame(first.text));
+            // Per-second countdown: rewrite only the refresh row (the separator line
+            // after the first section), leaving the card body untouched. Its row is
+            // fixed for the lifetime of this `combined` result, so we re-render the
+            // card with the new countdown purely to extract the refreshed line text,
+            // then blast it to that row via cursor-position + clear-line.
+            for (let remaining = intervalSec - 1; remaining > 0; remaining--) {
+                await sleep(1000, controller.signal).catch(() => undefined);
+                if (controller.signal.aborted)
+                    break;
+                const next = renderCard(combined, provider, detail, color, refreshSuffix(remaining));
+                if (first.refreshRow !== null && next.refreshRow !== null) {
+                    const row = first.refreshRow + 1; // ANSI rows are 1-based
+                    const line = next.text.split("\n")[next.refreshRow] ?? "";
+                    // Move to (row, col 1), clear the line, write the refreshed countdown.
+                    process.stdout.write(`\x1B[${row};1H${ANSI.clearLine}${line}`);
+                }
+            }
+        }
+    }
+    finally {
+        restore();
+        process.off("SIGINT", onInt);
+    }
+}
+/**
+ * Print the card once and exit. A fully-unavailable result (no provider could
+ * produce data) → stderr + exit 1, so scripts can detect failure. A partial
+ * result (at least one provider succeeded or is merely not_configured) goes
+ * to stdout with exit 0.
+ */
+async function runOnce(provider, detail, color) {
+    const combined = await queryCombined(provider);
+    const out = renderCard(combined, provider, detail, color).text;
+    // Failure = every selected provider ended up unavailable (not merely
+    // not_configured, which is a deliberate "skip me" state).
+    const glmFailed = combined.glm.kind === "unavailable";
+    const goFailed = combined.go.kind === "unavailable";
+    const glmSelected = provider === "all" || provider === "glm";
+    const goSelected = provider === "all" || provider === "go";
+    const selectedFailed = (glmSelected && glmFailed && (!goSelected || goFailed)) ||
+        (goSelected && goFailed && (!glmSelected || glmFailed));
+    if (selectedFailed) {
+        process.stderr.write(out + "\n");
+        process.exit(1);
+    }
+    process.stdout.write(out + "\n");
+}
+async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    if (opts.help) {
+        process.stdout.write(HELP_TEXT + "\n");
+        return;
+    }
+    if (opts.intervalClamped) {
+        process.stderr.write(`zcode-quota: interval below 10s raised to 10s (cache TTL is 10s)\n`);
+    }
+    // Color is on by default on a real terminal; turn it off when piped/
+    // redirected (isTTY is only `true` on a real TTY — Node leaves it
+    // `undefined` for pipes/files) or when the user asks for --plain. This
+    // matches the common CLI convention (ls, git, grep) and keeps raw escape
+    // codes out of captured output.
+    const color = process.stdout.isTTY === true && !opts.plain;
+    if (opts.watch) {
+        await runWatch(opts.intervalMs, opts.provider, opts.detail, color);
+    }
+    else {
+        await runOnce(opts.provider, opts.detail, color);
+    }
+}
+// Only auto-run when invoked directly (not when imported by tests). In an ESM
+// build there is no `require.main`, so fall back to a heuristic: if argv[1]
+// (the executed script) ends with this file's path, we are the entry point.
+const invokedDirectly = (() => {
+    const entry = process.argv[1] ?? "";
+    return entry.endsWith("bin/quota.js") || entry.endsWith("bin/quota.ts");
+})();
+if (invokedDirectly) {
+    main().catch((err) => {
+        process.stderr.write(`zcode-quota: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=quota.js.map

package/dist/bin/quota.js.map

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

package/dist/config/auto-compact.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Auto-compact: when the session's context-window usage exceeds a threshold,
+ * automatically invoke `session/compact` so the next prompt has room.
+ *
+ * Configured via `ZCODE_ACP_AUTO_COMPACT_THRESHOLD` (absolute token count;
+ * 0/unset = disabled). The compaction target is decided by the zcode backend
+ * — we only control *when* to trigger.
+ *
+ * Triggered from `prompt()` after a successful `end_turn`, before the response
+ * returns. Failures are best-effort (logged, never thrown) so they never break
+ * the prompt response.
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import type { ZcodeAcpServer } from "../server.js";
+/** ENV: `ZCODE_ACP_AUTO_COMPACT_THRESHOLD` — absolute token count (0 = disabled). */
+export declare function autoCompactThreshold(): number;
+/**
+ * If the threshold is configured and the session's current context usage meets
+ * or exceeds it, invoke `compact()`. No-op when the threshold is unset/zero,
+ * when usage is below the threshold, or on any error (best-effort).
+ */
+export declare function maybeAutoCompact(server: ZcodeAcpServer, cx: acp.AgentContext, acpSid: string, zcodeSid: string): Promise<void>;
+//# sourceMappingURL=auto-compact.d.ts.map

package/dist/config/auto-compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-compact.d.ts","sourceRoot":"","sources":["../../src/config/auto-compact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAGrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,qFAAqF;AACrF,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA2Df"}

package/dist/config/auto-compact.js

@@ -0,0 +1,67 @@
+/**
+ * Auto-compact: when the session's context-window usage exceeds a threshold,
+ * automatically invoke `session/compact` so the next prompt has room.
+ *
+ * Configured via `ZCODE_ACP_AUTO_COMPACT_THRESHOLD` (absolute token count;
+ * 0/unset = disabled). The compaction target is decided by the zcode backend
+ * — we only control *when* to trigger.
+ *
+ * Triggered from `prompt()` after a successful `end_turn`, before the response
+ * returns. Failures are best-effort (logged, never thrown) so they never break
+ * the prompt response.
+ */
+import { randomUUID } from "node:crypto";
+import { compact } from "../handlers/extensions.js";
+import { log, warn } from "../utils.js";
+import { sendTextChunk } from "../handlers/io.js";
+/** ENV: `ZCODE_ACP_AUTO_COMPACT_THRESHOLD` — absolute token count (0 = disabled). */
+export function autoCompactThreshold() {
+    const raw = Number(process.env.ZCODE_ACP_AUTO_COMPACT_THRESHOLD ?? "0");
+    return Number.isFinite(raw) && raw > 0 ? raw : 0;
+}
+/**
+ * If the threshold is configured and the session's current context usage meets
+ * or exceeds it, invoke `compact()`. No-op when the threshold is unset/zero,
+ * when usage is below the threshold, or on any error (best-effort).
+ */
+export async function maybeAutoCompact(server, cx, acpSid, zcodeSid) {
+    const threshold = autoCompactThreshold();
+    if (threshold <= 0)
+        return; // disabled
+    const msgId = randomUUID();
+    try {
+        // Read current context usage via session/read.
+        let used = 0;
+        try {
+            const backend = server.ensureBackend();
+            const resp = await backend.request(server.nextId(), "session/read", { sessionId: zcodeSid }, 5000);
+            if (resp.error)
+                return;
+            const result = (resp.result ?? {});
+            used = result.projection?.contextUsed ?? 0;
+        }
+        catch (e) {
+            warn(`auto-compact: session/read failed (${e instanceof Error ? e.message : String(e)})`);
+            return;
+        }
+        if (used < threshold)
+            return;
+        log(`auto-compact: contextUsed=${used} >= threshold=${threshold}, compacting…`);
+        await sendTextChunk(cx, acpSid, `🔄 auto-compact: context usage ${used.toLocaleString()} ≥ threshold ${threshold.toLocaleString()}, compressing…`, msgId);
+        // compact() handles: session/compact → waitForTurnIdle → emitInitialUsage.
+        const result = (await compact(server, { sessionId: acpSid }, cx));
+        if (result.__lockTimeout) {
+            await sendTextChunk(cx, acpSid, "⚠ auto-compact timed out (300s) — backend may still be processing", msgId);
+        }
+        else {
+            await sendTextChunk(cx, acpSid, "✓ auto-compact: context compressed", msgId);
+        }
+        log("auto-compact: done");
+    }
+    catch (e) {
+        warn(`auto-compact: compact failed (${e instanceof Error ? e.message : String(e)})`);
+        await sendTextChunk(cx, acpSid, `⚠ auto-compact failed: ${e instanceof Error ? e.message : String(e)}`, msgId);
+        // Best-effort: never break the prompt response.
+    }
+}
+//# sourceMappingURL=auto-compact.js.map

package/dist/config/auto-compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-compact.js","sourceRoot":"","sources":["../../src/config/auto-compact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEpD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,qFAAqF;AACrF,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,GAAG,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAsB,EACtB,EAAoB,EACpB,MAAc,EACd,QAAgB;IAEhB,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,CAAC,WAAW;IAEvC,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,+CAA+C;QAC/C,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAChC,MAAM,CAAC,MAAM,EAAE,EACf,cAAc,EACd,EAAE,SAAS,EAAE,QAAQ,EAAE,EACvB,IAAI,CACL,CAAC;YACF,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO;YACvB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAA8C,CAAC;YAChF,IAAI,GAAG,MAAM,CAAC,UAAU,EAAE,WAAW,IAAI,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,sCAAsC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC1F,OAAO;QACT,CAAC;QAED,IAAI,IAAI,GAAG,SAAS;YAAE,OAAO;QAE7B,GAAG,CAAC,6BAA6B,IAAI,iBAAiB,SAAS,eAAe,CAAC,CAAC;QAChF,MAAM,aAAa,CACjB,EAAE,EACF,MAAM,EACN,kCAAkC,IAAI,CAAC,cAAc,EAAE,gBAAgB,SAAS,CAAC,cAAc,EAAE,gBAAgB,EACjH,KAAK,CACN,CAAC;QAEF,2EAA2E;QAC3E,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAE/D,CAAC;QACF,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,MAAM,aAAa,CACjB,EAAE,EACF,MAAM,EACN,mEAAmE,EACnE,KAAK,CACN,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,oCAAoC,EAAE,KAAK,CAAC,CAAC;QAC/E,CAAC;QACD,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,iCAAiC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACrF,MAAM,aAAa,CACjB,EAAE,EACF,MAAM,EACN,0BAA0B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EACtE,KAAK,CACN,CAAC;QACF,gDAAgD;IAClD,CAAC;AACH,CAAC"}

package/dist/config/mcp-discovery.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MCP server discovery — reads MCP server configurations from the same sources
+ * ZCode uses, so `/mcp` can show users exactly which servers are available.
+ *
+ * Sources:
+ *   1. ~/.zcode/cli/config.json → mcp.servers (user-configured)
+ *   2. Enabled plugin .mcp.json files (two formats: flat and nested)
+ *
+ * The ZCode backend loads these automatically and exposes their tools to the
+ * model. This module is purely informational — it lists what's configured so
+ * users know what's available without needing the TUI.
+ */
+/** Information about a discovered MCP server. */
+export interface McpServerInfo {
+    name: string;
+    type: string;
+    command?: string;
+    args?: string[];
+    url?: string;
+    source: string;
+}
+/**
+ * Discover all MCP servers from config.json and enabled plugins.
+ *
+ * Best-effort: failures are logged and swallowed.
+ */
+export declare function loadMcpServers(): McpServerInfo[];
+/**
+ * Format MCP servers into a human-readable card for the `/mcp` command.
+ *
+ * Groups by source (config vs plugins) and aligns columns for readability.
+ */
+export declare function formatMcpServers(servers: McpServerInfo[]): string;
+//# sourceMappingURL=mcp-discovery.d.ts.map

package/dist/config/mcp-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-discovery.d.ts","sourceRoot":"","sources":["../../src/config/mcp-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAsBD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,aAAa,EAAE,CAmFhD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CA2BjE"}

package/dist/config/mcp-discovery.js

@@ -0,0 +1,153 @@
+/**
+ * MCP server discovery — reads MCP server configurations from the same sources
+ * ZCode uses, so `/mcp` can show users exactly which servers are available.
+ *
+ * Sources:
+ *   1. ~/.zcode/cli/config.json → mcp.servers (user-configured)
+ *   2. Enabled plugin .mcp.json files (two formats: flat and nested)
+ *
+ * The ZCode backend loads these automatically and exposes their tools to the
+ * model. This module is purely informational — it lists what's configured so
+ * users know what's available without needing the TUI.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { compareVersions, log } from "../utils.js";
+const HOME = homedir();
+const CLI_CONFIG_PATH = path.join(HOME, ".zcode", "cli", "config.json");
+const PLUGIN_CACHE_DIR = path.join(HOME, ".zcode", "cli", "plugins", "cache");
+/**
+ * Discover all MCP servers from config.json and enabled plugins.
+ *
+ * Best-effort: failures are logged and swallowed.
+ */
+export function loadMcpServers() {
+    const results = [];
+    let config = null;
+    try {
+        if (existsSync(CLI_CONFIG_PATH)) {
+            config = JSON.parse(readFileSync(CLI_CONFIG_PATH, "utf8"));
+        }
+    }
+    catch (e) {
+        log(`mcp-discovery: config read failed (${e instanceof Error ? e.message : String(e)})`);
+        return results;
+    }
+    // 1. User-configured servers from config.json.
+    const servers = config?.mcp?.servers ?? {};
+    for (const [name, cfg] of Object.entries(servers)) {
+        results.push({
+            name,
+            type: cfg.type ?? "stdio",
+            command: cfg.command,
+            args: cfg.args,
+            url: cfg.url,
+            source: "config",
+        });
+    }
+    // 2. Plugin-provided servers from .mcp.json files.
+    const enabledPlugins = config?.plugins?.enabledPlugins ?? {};
+    for (const [pluginKey, enabledFlag] of Object.entries(enabledPlugins)) {
+        if (!enabledFlag)
+            continue;
+        const atIdx = pluginKey.indexOf("@");
+        if (atIdx <= 0)
+            continue;
+        const pluginName = pluginKey.slice(0, atIdx);
+        const marketplace = pluginKey.slice(atIdx + 1);
+        const pluginDir = path.join(PLUGIN_CACHE_DIR, marketplace, pluginName);
+        if (!existsSync(pluginDir))
+            continue;
+        // Find the latest version directory.
+        let latestVersion = "";
+        try {
+            for (const entry of readdirSync(pluginDir)) {
+                const vDir = path.join(pluginDir, entry);
+                if (statSync(vDir).isDirectory() && compareVersions(entry, latestVersion) > 0) {
+                    latestVersion = entry;
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+        if (!latestVersion)
+            continue;
+        const mcpFile = path.join(pluginDir, latestVersion, ".mcp.json");
+        if (!existsSync(mcpFile))
+            continue;
+        try {
+            const mcpConfig = JSON.parse(readFileSync(mcpFile, "utf8"));
+            // Two formats:
+            //   Flat:   { "server-name": { "command": "..." } }
+            //   Nested: { "mcpServers": { "server-name": { ... } } }
+            const serverMap = mcpConfig["mcpServers"] ?? mcpConfig;
+            for (const [name, cfg] of Object.entries(serverMap)) {
+                results.push({
+                    name,
+                    type: cfg.type ?? "stdio",
+                    command: cfg.command,
+                    args: cfg.args,
+                    url: cfg.url,
+                    source: `plugin: ${pluginName}`,
+                });
+            }
+        }
+        catch (e) {
+            log(`mcp-discovery: failed to read ${mcpFile} (${e instanceof Error ? e.message : String(e)})`);
+        }
+    }
+    log(`mcp-discovery: found ${results.length} MCP server(s)`);
+    return results;
+}
+/**
+ * Format MCP servers into a human-readable card for the `/mcp` command.
+ *
+ * Groups by source (config vs plugins) and aligns columns for readability.
+ */
+export function formatMcpServers(servers) {
+    if (servers.length === 0) {
+        return "📡 No MCP servers configured.\nUse the ZCode desktop app to add MCP servers.";
+    }
+    const configServers = servers.filter((s) => s.source === "config");
+    const pluginServers = servers.filter((s) => s.source !== "config");
+    const lines = [`📡 MCP Servers (${servers.length})`];
+    if (configServers.length > 0) {
+        lines.push("", "From config.json:");
+        for (const s of configServers) {
+            lines.push(`  ${pad(s.name, 16)} ${pad(s.type, 6)} ${formatEndpoint(s)}`);
+        }
+    }
+    if (pluginServers.length > 0) {
+        lines.push("", "From plugins:");
+        for (const s of pluginServers) {
+            const pluginLabel = `[${s.source.replace("plugin: ", "")}]`;
+            lines.push(`  ${pad(s.name, 16)} ${pad(s.type, 6)} ${formatEndpoint(s)}  ${pluginLabel}`);
+        }
+    }
+    lines.push("", "MCP tools are auto-invoked by the model when needed.");
+    return lines.join("\n");
+}
+/** Format the endpoint/command string for display. */
+function formatEndpoint(s) {
+    if (s.url) {
+        try {
+            const u = new URL(s.url);
+            return u.host + u.pathname;
+        }
+        catch {
+            return s.url;
+        }
+    }
+    if (s.command) {
+        const args = s.args?.length ? " " + s.args.join(" ") : "";
+        return s.command + args;
+    }
+    return "?";
+}
+/** Pad a string to the given width for column alignment. */
+function pad(s, width) {
+    return s.length >= width ? s : s + " ".repeat(width - s.length);
+}
+//# sourceMappingURL=mcp-discovery.js.map

package/dist/config/mcp-discovery.js.map

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