@springbrand/cli 0.1.0

package/dist/lib/hermes-plugin.js

@@ -0,0 +1,168 @@
+/** 复刻自 tiny-fish CLI 编译产物：hermes-plugin.d.ts + hermes-plugin.impl.js */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import spawn from 'cross-spawn';
+import { z } from 'zod';
+import { capturedOutput, replay, SKILL_INSTALL_TIMEOUT_MS, STEP_MAX_BUFFER, } from './cli-install.js';
+import { commandNotFound, ConnectStepError, spawnStepError, throwIfInterrupted, } from './connect-runtime.js';
+import { HARNESS_PROBE_TIMEOUT_MS } from './constants.js';
+import { HERMES_HEADER_TEMPLATE, HERMES_MCP_SERVER_KEY } from './hermes-config.js';
+import { errLine, parseJson } from './output.js';
+// Bump per CLI release.
+export const HERMES_PLUGIN_SHA = '496cd63fefd982bbaa8a85ce78ef2270d700984f';
+// Bump with the SHA; the source is `hermes/plugin.yaml` at that commit.
+export const HERMES_PLUGIN_VERSION = '0.1.0';
+// Manifest `name:`, not the repo subdir; `plugins uninstall` keys on it.
+const PLUGIN_SOURCE = 'springbrand-lab/springbrand-web-agent-integrations/hermes';
+const PLUGIN_REPO_URL = 'https://github.com/springbrand-lab/springbrand-web-agent-integrations.git';
+export const HERMES_PLUGIN_MANUAL_INSTALL = `hermes plugins install ${PLUGIN_SOURCE} --ref ${HERMES_PLUGIN_SHA} --enable`;
+// Anchored to --ref: another rejected flag would fail the clone path too.
+const REF_UNSUPPORTED_PATTERN = /unrecognized arguments:[^\n]*--ref/;
+function installSpawnEnv(home, apiKey) {
+    // Hermes' install-time requires_env check reads os.environ, not our .env seed.
+    return { ...process.env, HERMES_HOME: home, SPRINGBRAND_API_KEY: apiKey };
+}
+function runPluginInstall(source, env) {
+    // Captured even under --verbose: the fallback matches on stderr.
+    return spawn.sync('hermes', ['plugins', 'install', ...source, '--enable', '--force'], {
+        encoding: 'utf8',
+        maxBuffer: STEP_MAX_BUFFER,
+        timeout: SKILL_INSTALL_TIMEOUT_MS,
+        env,
+    });
+}
+function refUnsupported(result) {
+    return result.status !== 0 && REF_UNSUPPORTED_PATTERN.test(String(result.stderr ?? ''));
+}
+function runGit(args) {
+    const result = spawn.sync('git', args, {
+        encoding: 'utf8',
+        maxBuffer: STEP_MAX_BUFFER,
+        timeout: SKILL_INSTALL_TIMEOUT_MS,
+    });
+    if (!result.error && result.status === 0)
+        return;
+    if (commandNotFound(result.error)) {
+        throw new ConnectStepError('git is required to stage the pinned plugin; install git and run connect again', 'command_not_found');
+    }
+    // Built first: its interrupt check must run before any replay.
+    const error = spawnStepError('Could not stage the SpringBrand Hermes plugin', result);
+    replay(capturedOutput(result));
+    throw error;
+}
+// Pre-`--ref` Hermes: stage the pin ourselves, mirroring `--ref` internals.
+function installFromClone(env) {
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'springbrand-hermes-plugin-'));
+    try {
+        runGit(['clone', '--depth', '1', PLUGIN_REPO_URL, tmp]);
+        runGit(['-C', tmp, 'fetch', '--depth', '1', 'origin', HERMES_PLUGIN_SHA]);
+        runGit(['-C', tmp, 'checkout', '--detach', HERMES_PLUGIN_SHA]);
+        return runPluginInstall([`${pathToFileURL(tmp).href}#hermes`], env);
+    }
+    finally {
+        fs.rmSync(tmp, { recursive: true, force: true });
+    }
+}
+export function installHermesPlugin(home, apiKey, { verbose }) {
+    errLine('Installing the SpringBrand web plugin in Hermes...');
+    const env = installSpawnEnv(home, apiKey);
+    // --ref always: a same-source reinstall without it keeps the previous pin.
+    const primary = runPluginInstall([PLUGIN_SOURCE, '--ref', HERMES_PLUGIN_SHA], env);
+    const result = refUnsupported(primary) ? installFromClone(env) : primary;
+    if (result.error || result.status !== 0) {
+        // A declined security scan exits 1 here, and reconnecting repeats it.
+        const error = spawnStepError(`Could not install the SpringBrand web plugin in Hermes; to install it yourself run: ${HERMES_PLUGIN_MANUAL_INSTALL}`, result);
+        replay(capturedOutput(result));
+        throw error;
+    }
+    if (verbose)
+        replay(capturedOutput(result));
+}
+function hermesConfig(args, home) {
+    return spawn.sync('hermes', ['config', ...args], {
+        encoding: 'utf8',
+        maxBuffer: STEP_MAX_BUFFER,
+        timeout: HARNESS_PROBE_TIMEOUT_MS,
+        env: { ...process.env, HERMES_HOME: home },
+    });
+}
+function configWrite(home, args) {
+    const result = hermesConfig(args, home);
+    if (!result.error && result.status === 0)
+        return;
+    // Built first: its interrupt check must run before any replay.
+    const error = spawnStepError(`Could not run \`hermes config ${args.join(' ')}\``, result);
+    replay(capturedOutput(result));
+    throw error;
+}
+/** Absent `enabled` reads as enabled, so never write this field-by-field. */
+export function writeHermesMcpEntry(home, mcpUrl) {
+    const entry = {
+        url: mcpUrl,
+        headers: { Authorization: HERMES_HEADER_TEMPLATE },
+        enabled: true,
+    };
+    const result = hermesConfig(['set', `mcp_servers.${HERMES_MCP_SERVER_KEY}`, JSON.stringify(entry)], home);
+    // `config set` exits 0 on a bad key, so only an interrupt is worth raising here.
+    throwIfInterrupted(result);
+}
+/** Retracts our row; an absent `enabled` reads as enabled, so a partial one is live. */
+export function removeHermesMcpEntry(home) {
+    configWrite(home, ['unset', `mcp_servers.${HERMES_MCP_SERVER_KEY}`]);
+}
+const HERMES_BACKEND_KEYS = ['web.search_backend', 'web.extract_backend'];
+// Dispatch falls back to web.backend, and the plugin's own setup can set it.
+const HERMES_OWNED_BACKEND_KEYS = [...HERMES_BACKEND_KEYS, 'web.backend'];
+/** After install only: backends must never name an absent provider. */
+export function setHermesWebBackends(home) {
+    for (const key of HERMES_BACKEND_KEYS)
+        configWrite(home, ['set', key, 'springbrand']);
+}
+/** Unset prints empty and exits 0, so a failed read must not read as unset. */
+function configGet(home, key) {
+    const result = hermesConfig(['get', key], home);
+    throwIfInterrupted(result);
+    if (result.error || result.status !== 0) {
+        throw spawnStepError(`Could not read \`hermes config get ${key}\``, result);
+    }
+    return String(result.stdout ?? '').trim() || undefined;
+}
+/** Ours-only unsets: a user-chosen backend value survives the uninstall. */
+export function clearHermesWebBackends(home) {
+    for (const key of HERMES_OWNED_BACKEND_KEYS) {
+        if (configGet(home, key) === 'springbrand')
+            configWrite(home, ['unset', key]);
+    }
+}
+const hermesPluginStatusSchema = z.looseObject({
+    ok: z.boolean(),
+    api_key_configured: z.boolean(),
+    api_key_env_var: z.string().nullish(),
+    plugin_version: z.string().nullish(),
+    provider_available: z.boolean().nullish(),
+    web_backend_configured: z.boolean(),
+});
+/** `status --json` always exits 0; a non-zero exit means the subcommand is absent. */
+export function readHermesPluginStatus(home) {
+    const result = spawn.sync('hermes', ['springbrand', 'status', '--json'], {
+        encoding: 'utf8',
+        maxBuffer: STEP_MAX_BUFFER,
+        timeout: HARNESS_PROBE_TIMEOUT_MS,
+        env: { ...process.env, HERMES_HOME: home, FORCE_COLOR: '0', NO_COLOR: '1' },
+    });
+    // A timeout also lands in result.error, where "not installed" would be a lie.
+    if (result.error) {
+        return commandNotFound(result.error) ? { state: 'not_installed' } : { state: 'unreachable' };
+    }
+    if (result.status !== 0)
+        return { state: 'not_installed' };
+    const parsed = hermesPluginStatusSchema.safeParse(parseJson(String(result.stdout ?? '')));
+    return parsed.success ? { state: 'ok', status: parsed.data } : { state: 'unparseable' };
+}
+/** Fallback verdict input when the plugin CLI cannot answer. */
+export function hermesWebBackendsOurs(home) {
+    return HERMES_OWNED_BACKEND_KEYS.some((key) => configGet(home, key) === 'springbrand');
+}
+//# sourceMappingURL=hermes-plugin.js.map

package/dist/lib/hermes-plugin.js.map

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

package/dist/lib/install-root.d.ts

@@ -0,0 +1,18 @@
+/** 复刻自 tiny-fish CLI 编译产物：install-root.d.ts + install-root.impl.js */
+/**
+ * The prefix to upgrade in place, or null when the layout is not npm's.
+ *
+ * Guarded on purpose: npx, pnpm and bun all nest the package under a bare `node_modules`, and
+ * installing into their trees would report a success the PATH binary never sees.
+ */
+export declare function resolveInstallRoot(packageRoot: string, platform: typeof process.platform, onDisk?: (candidate: string) => boolean): InstallRoot | null;
+export declare function installRoot(): InstallRoot | null;
+/** This package's own dir under a prefix's node_modules. */
+export declare function installedPackageDir(nodeModules: string): string;
+/** The version on disk under a prefix, which is the only account of what `@latest` resolved to. */
+export declare function readInstalledVersion(nodeModules: string): string | null;
+export type InstallRoot = {
+    prefix: string;
+    nodeModules: string;
+};
+//# sourceMappingURL=install-root.d.ts.map

package/dist/lib/install-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-root.d.ts","sourceRoot":"","sources":["../../src/lib/install-root.ts"],"names":[],"mappings":"AAAA,sEAAsE;AActE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,WAAW,GAAG,IAAI,CAetJ;AACD,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAIhD;AACD,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AACD,mGAAmG;AACnG,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQvE;AAGD,MAAM,MAAM,WAAW,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC"}

package/dist/lib/install-root.js

@@ -0,0 +1,55 @@
+/** 复刻自 tiny-fish CLI 编译产物：install-root.d.ts + install-root.impl.js */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SPRINGBRAND_CLI_PACKAGE } from './constants.js';
+function isDirectory(candidate) {
+    try {
+        return fs.statSync(candidate).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The prefix to upgrade in place, or null when the layout is not npm's.
+ *
+ * Guarded on purpose: npx, pnpm and bun all nest the package under a bare `node_modules`, and
+ * installing into their trees would report a success the PATH binary never sees.
+ */
+export function resolveInstallRoot(packageRoot, platform, onDisk) {
+    const p = platform === 'win32' ? path.win32 : path.posix;
+    // npx's win32 cache uses the same bare layout as a global install.
+    if (packageRoot.split(p.sep).includes('_npx'))
+        return null;
+    const nodeModules = p.resolve(packageRoot, '..', '..');
+    if (p.basename(nodeModules) !== 'node_modules')
+        return null;
+    const container = p.dirname(nodeModules);
+    // Only win32 puts node_modules directly under the prefix.
+    if (platform !== 'win32' && p.basename(container) !== 'lib')
+        return null;
+    if (!onDisk?.(nodeModules))
+        return null;
+    return { prefix: platform === 'win32' ? container : p.dirname(container), nodeModules };
+}
+export function installRoot() {
+    // Two levels up from dist/lib/ is the package root, and tsc mirrors src/ into dist/.
+    const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+    return resolveInstallRoot(packageRoot, process.platform);
+}
+/** This package's own dir under a prefix's node_modules. */
+export function installedPackageDir(nodeModules) {
+    return path.join(nodeModules, ...SPRINGBRAND_CLI_PACKAGE.split('/'));
+}
+/** The version on disk under a prefix, which is the only account of what `@latest` resolved to. */
+export function readInstalledVersion(nodeModules) {
+    try {
+        const manifest = fs.readFileSync(path.join(installedPackageDir(nodeModules), 'package.json'), 'utf8');
+        return JSON.parse(manifest).version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=install-root.js.map

package/dist/lib/install-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-root.js","sourceRoot":"","sources":["../../src/lib/install-root.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,SAAS,WAAW,CAAC,SAAiB;IAClC,IAAI,CAAC;QACD,OAAO,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,CAAC;IACD,MAAM,CAAC;QACH,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AACD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,QAAiC,EAAE,MAAuC;IAC9H,MAAM,CAAC,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IACzD,mEAAmE;IACnE,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC;IAChB,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,cAAc;QAC1C,OAAO,IAAI,CAAC;IAChB,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC,0DAA0D;IAC1D,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,KAAK;QACvD,OAAO,IAAI,CAAC;IAChB,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC;QACtB,OAAO,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;AAC5F,CAAC;AACD,MAAM,UAAU,WAAW;IACvB,qFAAqF;IACrF,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3F,OAAO,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC7D,CAAC;AACD,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,uBAAuB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACzE,CAAC;AACD,mGAAmG;AACnG,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACpD,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QACtG,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;IAChD,CAAC;IACD,MAAM,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * MCP server configuration for agent config files
+ */
+export interface McpServerConfig {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+export interface McpConfig {
+    mcpServers?: Record<string, McpServerConfig>;
+}
+/**
+ * Read existing MCP config from agent
+ */
+export declare function readMcpConfig(configPath: string): McpConfig;
+/**
+ * Write MCP config to agent (stage-then-swap for atomicity)
+ */
+export declare function writeMcpConfig(configPath: string, config: McpConfig): void;
+/**
+ * Add or update MCP Gateway server entry
+ */
+export declare function upsertMcpGatewayServer(configPath: string, serverName: string, config: McpServerConfig): void;
+/**
+ * Check if MCP Gateway is already configured
+ */
+export declare function isMcpGatewayConfigured(configPath: string, serverName: string): boolean;
+/**
+ * Generate MCP Gateway server config
+ */
+export declare function generateMcpGatewayConfig(cliPath: string, accessToken: string, mcpUrl: string): McpServerConfig;
+/**
+ * Remove MCP Gateway server entry
+ */
+export declare function removeMcpGatewayServer(configPath: string, serverName: string): void;
+//# sourceMappingURL=mcp-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-config.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAW3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAuB1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,GACtB,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAOtF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,eAAe,CASjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAUnF"}

package/dist/lib/mcp-config.js

@@ -0,0 +1,90 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { dirname } from 'path';
+/**
+ * Read existing MCP config from agent
+ */
+export function readMcpConfig(configPath) {
+    if (!existsSync(configPath)) {
+        return { mcpServers: {} };
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Failed to read MCP config from ${configPath}: ${error}`);
+    }
+}
+/**
+ * Write MCP config to agent (stage-then-swap for atomicity)
+ */
+export function writeMcpConfig(configPath, config) {
+    try {
+        // Ensure directory exists
+        const dir = dirname(configPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Stage to temp file first
+        const tmpPath = `${configPath}.tmp`;
+        const content = JSON.stringify(config, null, 2);
+        writeFileSync(tmpPath, content, { encoding: 'utf-8', mode: 0o600 });
+        // Atomic swap
+        writeFileSync(configPath, content, { encoding: 'utf-8', mode: 0o600 });
+        // Clean up temp
+        if (existsSync(tmpPath)) {
+            require('fs').unlinkSync(tmpPath);
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to write MCP config to ${configPath}: ${error}`);
+    }
+}
+/**
+ * Add or update MCP Gateway server entry
+ */
+export function upsertMcpGatewayServer(configPath, serverName, config) {
+    const mcpConfig = readMcpConfig(configPath);
+    if (!mcpConfig.mcpServers) {
+        mcpConfig.mcpServers = {};
+    }
+    mcpConfig.mcpServers[serverName] = config;
+    writeMcpConfig(configPath, mcpConfig);
+}
+/**
+ * Check if MCP Gateway is already configured
+ */
+export function isMcpGatewayConfigured(configPath, serverName) {
+    if (!existsSync(configPath)) {
+        return false;
+    }
+    const config = readMcpConfig(configPath);
+    return !!config.mcpServers?.[serverName];
+}
+/**
+ * Generate MCP Gateway server config
+ */
+export function generateMcpGatewayConfig(cliPath, accessToken, mcpUrl) {
+    return {
+        command: 'node',
+        args: [cliPath, 'mcp-server'],
+        env: {
+            MCP_GATEWAY_TOKEN: accessToken,
+            MCP_GATEWAY_URL: mcpUrl,
+        },
+    };
+}
+/**
+ * Remove MCP Gateway server entry
+ */
+export function removeMcpGatewayServer(configPath, serverName) {
+    if (!existsSync(configPath)) {
+        return;
+    }
+    const config = readMcpConfig(configPath);
+    if (config.mcpServers?.[serverName]) {
+        delete config.mcpServers[serverName];
+        writeMcpConfig(configPath, config);
+    }
+}
+//# sourceMappingURL=mcp-config.js.map

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

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

package/dist/lib/mcp-endpoint.d.ts

@@ -0,0 +1,16 @@
+/** 复刻自 tiny-fish CLI 编译产物：mcp-endpoint.d.ts + mcp-endpoint.impl.js */
+import type { KeyEnvironment } from './auth.js';
+export declare const DEFAULT_MCP_URL = "https://connector.springbrand.ai/mcp";
+/**
+ * Which environment's keys an endpoint accepts. Mirrors the Gateway's `mcpWireEnvironment`:
+ * the production host serves production keys and every other host — dev, local — serves dev.
+ * A key from the other environment is refused with 401, so this comparison is worth making
+ * before anything is written.
+ */
+export declare function environmentOf(mcpUrl: string): KeyEnvironment | undefined;
+export declare function endpointOf(url: string): string;
+/** One host serves `/mcp` and `/v1`, so origin is the API base. */
+export declare function apiBaseFromMcpUrl(mcpUrl: string): string | undefined;
+/** doctor reuses the CLI's own BASE_URL check; off-default endpoints cannot. */
+export declare function isDefaultEndpoint(mcpUrl: string): boolean;
+//# sourceMappingURL=mcp-endpoint.d.ts.map

package/dist/lib/mcp-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-endpoint.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-endpoint.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,eAAO,MAAM,eAAe,yCAAyC,CAAC;AAEtE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAOxE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C;AACD,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpE;AACD,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOzD"}

package/dist/lib/mcp-endpoint.js

@@ -0,0 +1,41 @@
+/** 复刻自 tiny-fish CLI 编译产物：mcp-endpoint.d.ts + mcp-endpoint.impl.js */
+export const DEFAULT_MCP_URL = 'https://connector.springbrand.ai/mcp';
+const PRODUCTION_HOST = 'connector.springbrand.ai';
+/**
+ * Which environment's keys an endpoint accepts. Mirrors the Gateway's `mcpWireEnvironment`:
+ * the production host serves production keys and every other host — dev, local — serves dev.
+ * A key from the other environment is refused with 401, so this comparison is worth making
+ * before anything is written.
+ */
+export function environmentOf(mcpUrl) {
+    try {
+        return new URL(mcpUrl).hostname.toLowerCase() === PRODUCTION_HOST ? 'production' : 'dev';
+    }
+    catch {
+        return undefined;
+    }
+}
+// Query strings carry the connect attempt id, so they differ on every healthy install.
+export function endpointOf(url) {
+    const parsed = new URL(url);
+    return `${parsed.origin}${parsed.pathname.replace(/\/$/, '')}`;
+}
+/** One host serves `/mcp` and `/v1`, so origin is the API base. */
+export function apiBaseFromMcpUrl(mcpUrl) {
+    try {
+        return new URL(mcpUrl).origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** doctor reuses the CLI's own BASE_URL check; off-default endpoints cannot. */
+export function isDefaultEndpoint(mcpUrl) {
+    try {
+        return endpointOf(mcpUrl) === endpointOf(DEFAULT_MCP_URL);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=mcp-endpoint.js.map

package/dist/lib/mcp-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-endpoint.js","sourceRoot":"","sources":["../../src/lib/mcp-endpoint.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAGtE,MAAM,CAAC,MAAM,eAAe,GAAG,sCAAsC,CAAC;AACtE,MAAM,eAAe,GAAG,0BAA0B,CAAC;AACnD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IACxC,IAAI,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7F,CAAC;IACD,MAAM,CAAC;QACH,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AACD,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,GAAW;IAClC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;AACnE,CAAC;AACD,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC5C,IAAI,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IAClC,CAAC;IACD,MAAM,CAAC;QACH,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AACD,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC5C,IAAI,CAAC;QACD,OAAO,UAAU,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,eAAe,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,CAAC;QACH,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}

package/dist/lib/mcp-json-config.d.ts

@@ -0,0 +1,43 @@
+/** 复刻自 tiny-fish CLI 编译产物：mcp-json-config.d.ts + mcp-json-config.impl.js */
+export declare function buildSpringbrandServerEntry(mcpUrl: string, apiKey?: string): Record<string, unknown>;
+/** Dry-run description of the pending write; touches nothing. */
+export declare function planWrite(target: McpJsonTarget, mcpUrl: string, apiKey?: string): string;
+/** Reports the header's shape, never its value. */
+export declare function readSpringbrandEntry(target: McpJsonTarget): McpJsonServerEntry;
+/** Merges only the target's key; skips unreadable/corrupt files rather than clobber. */
+export declare function writeMcpConfig(target: McpJsonTarget, mcpUrl: string, apiKey?: string): McpJsonWriteResult;
+/** Removes only the target's key. */
+export declare function removeServer(target: McpJsonTarget): McpJsonWriteResult;
+export interface McpJsonTarget {
+    serverKey: string;
+    /** Functions so paths resolve at call time. */
+    dir(): string;
+    file(): string;
+    /** Read-side only; defaults to what the write path emits (Command Code writes its own). */
+    keyHeader?: {
+        name: string;
+        valuePrefix?: string;
+    };
+}
+export interface McpJsonWriteResult {
+    status: 'written' | 'unchanged' | 'corrupt_skip';
+    backupPath?: string;
+    error?: string;
+    /** A pre-existing entry was replaced — a repair, not a fresh install. */
+    repaired?: boolean;
+}
+export interface McpJsonServerEntry {
+    present: boolean;
+    hasApiKeyHeader: boolean;
+    /** Only ever false: harnesses with a disable toggle write it, the rest omit it. */
+    enabled?: false;
+    /** The key rides the pre-Bearer `X-API-Key` header, which the Gateway does not read. */
+    legacyKeyHeader?: true;
+    /** Registered endpoint, so a caller can tell "registered" from "registered at the right place". */
+    url?: string;
+    keyMatchesCliKey?: boolean;
+    /** Whole-value `${VAR}` template: the variable name, never a key. */
+    keyTemplateVar?: string;
+    error?: string;
+}
+//# sourceMappingURL=mcp-json-config.d.ts.map

package/dist/lib/mcp-json-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-json-config.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-json-config.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAqB5E,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEpG;AA+BD,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBxF;AAGD,mDAAmD;AACnD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAmB9E;AAiDD,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAczG;AACD,qCAAqC;AACrC,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAatE;AAGD,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,GAAG,IAAI,MAAM,CAAC;IACd,IAAI,IAAI,MAAM,CAAC;IACf,2FAA2F;IAC3F,SAAS,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,wFAAwF;IACxF,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}