@springbrand/cli 0.1.0

package/dist/lib/connect-clients.js

@@ -0,0 +1,358 @@
+/** 复刻自 tiny-fish CLI 编译产物：connect-clients.d.ts + connect-clients.impl.js */
+import spawn from 'cross-spawn';
+import { SKILL_INSTALL_TIMEOUT_MS } from './cli-install.js';
+import { detectHumanInitiated } from './harness.js';
+import { harnessConfigPath } from './harness-detect.js';
+import { errLine, sanitizeLine, warnLine } from './output.js';
+import { ConnectInterruptedError, ConnectStepError, spawnStepError, } from './connect-runtime.js';
+import { SPRINGBRAND_API_KEY_VAR } from './constants.js';
+import { HARNESS_SPECS, NATIVE_HARNESSES, harnessSpec, } from './harness-spec.js';
+import { HERMES_KEY_VAR, captureHermesKeyRestore, hermesEnvPath, resolveHermesHome, writeHermesKey, } from './hermes-env.js';
+import { hermesConfigPath, readHermesEntry } from './hermes-config.js';
+import { HERMES_PLUGIN_VERSION, installHermesPlugin, removeHermesMcpEntry, setHermesWebBackends, writeHermesMcpEntry, } from './hermes-plugin.js';
+const HERMES_SEED_TIMEOUT_MS = 120_000;
+const OPENCLAW_SKILL = '@springbrand/springbrand';
+// --force makes this an unconditional overwrite, so the same call installs and refreshes.
+export function openclawSkillInstallArgs(ackFlag) {
+    const ack = ackFlag === undefined ? [] : [ackFlag];
+    return ['skills', 'install', OPENCLAW_SKILL, '--global', '--force', ...ack];
+}
+/** `openclaw skills` has no uninstall; ClawHub removes from the global dir. */
+export function openclawSkillUninstall() {
+    return {
+        command: 'npx',
+        args: [
+            '-y',
+            // Pinned: npx would otherwise execute whatever is newest at run time.
+            'clawhub@0.23.3',
+            '--workdir',
+            harnessConfigPath('openclaw'),
+            'uninstall',
+            OPENCLAW_SKILL,
+            '--yes',
+        ],
+        timeoutMs: SKILL_INSTALL_TIMEOUT_MS,
+    };
+}
+export const DEFAULT_ONBOARDING_PROMPT = 'I just connected SpringBrand. Use the MCP server named `springbrand` for every SpringBrand tool call; ' +
+    'if another SpringBrand server is also registered, still use `springbrand` and do not ask me which. ' +
+    'Start by asking me which service and operation I want to try — sending a Gmail message or pulling ' +
+    'Search Console data, for example — and wait for my reply. Then call `search_tools` with an English ' +
+    'query, show me what came back, and let me pick one before calling `get_tool_schemas` for its ' +
+    'contract. Confirm the arguments with me before `execute_tools`. If the operation needs an account ' +
+    'I have not linked yet, use `manage_connections` first and show me the authorization link unchanged. ' +
+    'Ask for my input and wait for my reply before each SpringBrand tool call. If a tool call comes back ' +
+    'blocked or not approved, tell me which tool needs approval and how to grant it, then wait for ' +
+    'me instead of ending the walkthrough.';
+export const OPENCLAW_ONBOARDING_PROMPT = 'I just installed the SpringBrand skill. Guide me through it interactively: first ask which service ' +
+    'and operation I want to try and wait for my reply, then call `search_tools` with an English query. ' +
+    'Show me the results, ask which one I want, and wait before calling `get_tool_schemas` for its ' +
+    'contract. Confirm the arguments with me before `execute_tools`, and use `manage_connections` first ' +
+    'if the operation needs an account I have not linked. Never skip ahead or choose for me.';
+/** Cursor writes its own MCP config, so it has no descriptor to carry this. */
+export const CURSOR_SKILL_TARGET = {
+    skillAgent: HARNESS_SPECS.cursor.skillAgent,
+    displayName: HARNESS_SPECS.cursor.displayName,
+};
+/**
+ * `cmd` re-parses its command line after `/c`, so an unquoted `&` in the query string ends the
+ * command and truncates the URL. Quoting needs windowsVerbatimArguments, or Node escapes the
+ * quotes back out. Untested on Windows.
+ */
+export function openExternalUrl(url) {
+    if (process.platform === 'darwin')
+        return spawn.sync('open', [url], { stdio: 'ignore' });
+    if (process.platform === 'win32') {
+        return spawn.sync('cmd', ['/c', 'start', '""', `"${url}"`], {
+            stdio: 'ignore',
+            windowsVerbatimArguments: true,
+        });
+    }
+    return spawn.sync('xdg-open', [url], { stdio: 'ignore' });
+}
+function launchCodexWalkthrough() {
+    const deepLink = new URL('codex://new');
+    deepLink.searchParams.set('prompt', DEFAULT_ONBOARDING_PROMPT);
+    deepLink.searchParams.set('path', process.cwd());
+    const result = openExternalUrl(deepLink.toString());
+    if (result.error || result.status !== 0) {
+        // Headless box: nothing can open a window; recover like the gated clients.
+        printPromptForHandoff('Codex', 'codex', DEFAULT_ONBOARDING_PROMPT, 'Codex could not be opened here (no `codex://` handler)');
+        return 'printed';
+    }
+    errLine('Codex opened with the SpringBrand walkthrough ready. Send the prompt to start.');
+    return 'launched';
+}
+// Handover: spawn errors are ours; the exit is the user's.
+function handOverTerminal(command, args, displayName) {
+    const result = spawn.sync(command, args, { stdio: 'inherit' });
+    if (result.error) {
+        throw spawnStepError(`Could not launch ${displayName}`, result);
+    }
+}
+function launchHermesWalkthrough() {
+    const seedResult = spawn.sync('hermes', ['chat', '-Q', '-q', DEFAULT_ONBOARDING_PROMPT], {
+        encoding: 'utf8',
+        timeout: HERMES_SEED_TIMEOUT_MS,
+    });
+    if (seedResult.error || seedResult.status !== 0) {
+        throw spawnStepError('Could not start the SpringBrand walkthrough in Hermes', seedResult);
+    }
+    // A colourised id would carry its trailing escape sequence into `--resume` (PF-3452).
+    const sessionId = sanitizeLine(seedResult.stderr ?? '').match(/session_id:\s*([^\s]+)/i)?.[1];
+    if (!sessionId) {
+        throw new Error('Hermes did not return a walkthrough session ID');
+    }
+    handOverTerminal('hermes', ['--resume', sessionId], 'Hermes');
+}
+/** Writes exit 0 having saved nothing, a disabled entry, or a keyless one. */
+export function hermesRegistrationEnabled(home) {
+    const entry = readHermesEntry(home);
+    if (entry.state === 'enabled') {
+        if (entry.usesKeyHeader)
+            return { ok: true };
+        // Exit codes carry no signal, so a corrupt entry can only be caught here.
+        return {
+            ok: false,
+            detail: 'the entry does not read the seeded key',
+            tag: 'hermes_entry_no_key_header',
+        };
+    }
+    // Each of these is a different repair, so none of them share wording.
+    const detail = {
+        disabled: 'the entry was saved disabled',
+        absent: 'no springbrand entry was saved',
+        unreadable: `${hermesConfigPath(home)} could not be read`,
+        unparseable: `${hermesConfigPath(home)} could not be parsed`,
+    }[entry.state];
+    // The tag keeps the path-bearing prose out of telemetry.
+    return { ok: false, detail, tag: `hermes_entry_${entry.state}` };
+}
+// A plain Error settles unexpected_error; cli_connect_stage is load-bearing.
+function requireHermesHome() {
+    const resolved = resolveHermesHome();
+    if (typeof resolved === 'string')
+        return resolved;
+    throw new ConnectStepError("Could not determine Hermes' home directory from `hermes dump`", 'invalid_config', { failureDetail: `hermes_home_undetermined_${resolved.reason}` });
+}
+/** Our own write, so `mcp add`'s install-time probe never disables the entry. */
+function registerHermesEntry(home, mcpUrl) {
+    try {
+        writeHermesMcpEntry(home, mcpUrl);
+    }
+    catch (error) {
+        // A Ctrl+C must abandon the attempt, not fall through to `mcp add`.
+        if (error instanceof ConnectInterruptedError)
+            throw error;
+        return false;
+    }
+    return hermesRegistrationEnabled(home).ok;
+}
+function seedHermesKey(apiKey) {
+    const home = requireHermesHome();
+    const restore = captureHermesKeyRestore(home);
+    writeHermesKey(home, apiKey);
+    // Set before the write, which can land even when it later throws.
+    let wroteEntry = false;
+    return {
+        home,
+        // Pins HERMES_HOME so a sticky profile can't shadow this key.
+        env: { ...process.env, HERMES_HOME: home },
+        // Three: a failed `mcp remove` adds an extra Overwrite prompt.
+        stdinInput: 'y\ny\ny\n',
+        note: `Wrote ${HERMES_KEY_VAR} to ${hermesEnvPath(home)} — Hermes reads the key from there.`,
+        rollback: () => rollbackHermesKey(home, restore, wroteEntry),
+        register: (mcpUrl) => {
+            wroteEntry = true;
+            return registerHermesEntry(home, mcpUrl);
+        },
+        confirmRegistered: () => hermesRegistrationEnabled(home),
+    };
+}
+// A failed re-run must not cost a working key.
+function rollbackHermesKey(home, restore, wroteEntry) {
+    try {
+        // The next `hermes mcp add` silently reuses whatever value survives here.
+        restore();
+    }
+    catch {
+        warnLine(`Could not restore ${HERMES_KEY_VAR} in ${hermesEnvPath(home)}; check it by hand.`);
+    }
+    if (!wroteEntry)
+        return;
+    try {
+        // Left behind, the row stays enabled with no key behind it.
+        removeHermesMcpEntry(home);
+    }
+    catch {
+        warnLine(`Could not remove the springbrand entry in ${hermesConfigPath(home)}; check it by hand.`);
+    }
+}
+// Hermes is keyRequired; a missing key here is a resolution bug.
+function installHermesWebPlugin({ apiKey, verbose, seededHome, }) {
+    if (!apiKey) {
+        throw new ConnectStepError('No SpringBrand API key was available to install the Hermes web plugin', 'invalid_config');
+    }
+    // Reuses the seed's home: a second `hermes dump` can disagree with the first.
+    const home = seededHome ?? requireHermesHome();
+    installHermesPlugin(home, apiKey, { verbose });
+    setHermesWebBackends(home);
+}
+// OpenCode's TUI takes a positional as a project directory, so a bare `opencode "<prompt>"`
+// would be read as a folder. The `--prompt` flag seeds the interactive TUI with a first message
+// (opencode.ai/docs/cli), so the onboarding guide fires just like the other agents.
+function launchOpencode() {
+    handOverTerminal('opencode', ['--prompt', DEFAULT_ONBOARDING_PROMPT], 'OpenCode');
+}
+/** "positional": flags before `springbrand <url>`. "flag": flags after `--url`. */
+function specAddArgs(spec, mcpUrl) {
+    const flags = spec.addFlags ?? [];
+    return spec.urlStyle === 'positional'
+        ? ['mcp', 'add', ...flags, 'springbrand', mcpUrl]
+        : ['mcp', 'add', 'springbrand', '--url', mcpUrl, ...flags];
+}
+/** `mcp add` probes the server and runs OAuth; add-json only writes config. */
+function jsonAddArgs(spec, mcpUrl, apiKey) {
+    const { header } = spec;
+    const body = {
+        transport: 'http',
+        url: mcpUrl,
+        ...(header ? { headers: { [header.name]: `${header.valuePrefix ?? ''}${apiKey}` } } : {}),
+    };
+    return ['mcp', 'add-json', ...(spec.keyedAddJsonFlags ?? []), 'springbrand', JSON.stringify(body)];
+}
+function specKeyAuth(spec) {
+    const { header, keyEnvFlag, keyAddFlags } = spec;
+    if (spec.keyedAddJsonFlags) {
+        return { addArgs: (mcpUrl, apiKey) => jsonAddArgs(spec, mcpUrl, apiKey) };
+    }
+    if (keyEnvFlag) {
+        return {
+            envVar: SPRINGBRAND_API_KEY_VAR,
+            addArgs: (mcpUrl) => [...specAddArgs(spec, mcpUrl), keyEnvFlag, SPRINGBRAND_API_KEY_VAR],
+        };
+    }
+    if (keyAddFlags) {
+        return { addArgs: (mcpUrl) => [...specAddArgs(spec, mcpUrl), ...keyAddFlags] };
+    }
+    if (!header)
+        return undefined;
+    const value = (apiKey) => `${header.name}${header.sep}${header.valuePrefix ?? ''}${apiKey}`;
+    if (header.viaEnv) {
+        return {
+            envVar: SPRINGBRAND_API_KEY_VAR,
+            addArgs: (mcpUrl) => [
+                ...specAddArgs(spec, mcpUrl),
+                '--header',
+                value(`\${${SPRINGBRAND_API_KEY_VAR}}`),
+            ],
+        };
+    }
+    return {
+        addArgs: (mcpUrl, apiKey) => [...specAddArgs(spec, mcpUrl), '--header', value(apiKey)],
+    };
+}
+const HARNESS_OVERRIDES = {
+    codex: { detachedLaunch: launchCodexWalkthrough },
+    hermes: {
+        launchWalkthrough: launchHermesWalkthrough,
+        extraPostInstall: installHermesWebPlugin,
+        pluginVersion: HERMES_PLUGIN_VERSION,
+        seedKey: seedHermesKey,
+    },
+    opencode: { launchWalkthrough: launchOpencode },
+};
+function toNativeClient(harness) {
+    const spec = harnessSpec(harness);
+    if (!spec.supportCheck)
+        throw new Error(`${harness} has no supportCheck to probe`);
+    const overrides = HARNESS_OVERRIDES[harness] ?? {};
+    const keyed = specKeyAuth(spec);
+    const keyAuth = keyed && { ...keyed, seedKey: overrides.seedKey };
+    const base = {
+        command: spec.command,
+        connectClient: harness,
+        displayName: spec.displayName,
+        supportCheck: spec.supportCheck,
+        skillAgent: spec.skillAgent,
+        nonInteractiveAdd: spec.nonInteractiveAdd,
+        keyAuth,
+        signInHint: spec.signInHint,
+        degradedAuthNotes: spec.degradedAuthNotes,
+        removals: spec.removals ?? [
+            {
+                args: ['mcp', 'remove', 'springbrand'],
+                label: `SpringBrand registration from ${spec.displayName}`,
+            },
+        ],
+        launchWalkthrough: overrides.launchWalkthrough,
+        detachedLaunch: overrides.detachedLaunch,
+        postConnectNote: spec.postConnectNote,
+        extraPostInstall: overrides.extraPostInstall,
+        pluginVersion: overrides.pluginVersion,
+        uninstallExtra: spec.uninstallExtra,
+    };
+    if (spec.keyRequired) {
+        if (!keyAuth)
+            throw new Error(`${harness} takes only a key but has no keyed add`);
+        return { ...base, keyRequired: true, keyAuth };
+    }
+    return {
+        ...base,
+        loginArgs: spec.loginArgs,
+        addArgs: (mcpUrl) => specAddArgs(spec, mcpUrl),
+    };
+}
+export const NATIVE_MCP_CLIENTS = NATIVE_HARNESSES.map(toNativeClient);
+/** Native descriptor by harness id; Cursor and OpenClaw have none. */
+export const NATIVE_BY_HARNESS = new Map(NATIVE_MCP_CLIENTS.map((client) => [client.connectClient, client]));
+export const OPENCLAW = {
+    command: HARNESS_SPECS.openclaw.command,
+    displayName: HARNESS_SPECS.openclaw.displayName,
+    supportCheck: HARNESS_SPECS.openclaw.supportCheck,
+};
+function printPromptForHandoff(displayName, command, prompt, reason) {
+    // "set up", not "connected": sign-in can still be deferred here.
+    errLine(`SpringBrand is set up in ${displayName}.`);
+    errLine(`${reason}, so SpringBrand did not launch it. Start ${displayName} (\`${command}\`) yourself ` +
+        `and paste this first message:`);
+    errLine('');
+    errLine(prompt);
+}
+/** One gate + one decide-before-block path for every terminal handover. */
+async function deliverWalkthrough(displayName, command, prompt, handover, onDecided) {
+    // Inherited-stdio handover: a non-TTY parent cannot approve tool calls.
+    if (!detectHumanInitiated()) {
+        await onDecided?.('printed');
+        printPromptForHandoff(displayName, command, prompt, `This terminal cannot answer ${displayName}'s tool-approval prompts`);
+        return 'printed';
+    }
+    // Decided and delivered first: the handover blocks for the whole session.
+    await onDecided?.('launched');
+    errLine(`Starting the SpringBrand walkthrough in ${displayName}...`);
+    handover();
+    return 'launched';
+}
+export async function launchNativeMcpClient(client, onDecided) {
+    if (client.detachedLaunch) {
+        // Detached: the open attempt never blocks, so decide after it.
+        errLine(`Starting the SpringBrand walkthrough in ${client.displayName}...`);
+        const outcome = client.detachedLaunch();
+        await onDecided?.(outcome);
+        return outcome;
+    }
+    return deliverWalkthrough(client.displayName, client.command, DEFAULT_ONBOARDING_PROMPT, () => client.launchWalkthrough
+        ? client.launchWalkthrough()
+        : handOverTerminal(client.command, [DEFAULT_ONBOARDING_PROMPT], client.displayName), onDecided);
+}
+// Via deliverWalkthrough: handOverTerminal alone would wedge a headless --launch.
+export function launchOmpWalkthrough(onDecided) {
+    return deliverWalkthrough('omp', 'omp', DEFAULT_ONBOARDING_PROMPT, () => handOverTerminal('omp', [DEFAULT_ONBOARDING_PROMPT], 'omp'), onDecided);
+}
+export function launchPiWalkthrough(onDecided) {
+    return deliverWalkthrough('Pi', 'pi', DEFAULT_ONBOARDING_PROMPT, () => handOverTerminal('pi', [DEFAULT_ONBOARDING_PROMPT], 'Pi'), onDecided);
+}
+export function launchOpenClawWalkthrough(onDecided) {
+    return deliverWalkthrough('OpenClaw', 'openclaw', OPENCLAW_ONBOARDING_PROMPT, () => handOverTerminal('openclaw', ['chat', '--message', OPENCLAW_ONBOARDING_PROMPT], 'OpenClaw'), onDecided);
+}
+//# sourceMappingURL=connect-clients.js.map

package/dist/lib/connect-clients.js.map

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

package/dist/lib/connect-fallback.d.ts

@@ -0,0 +1,27 @@
+/** 复刻自 tiny-fish CLI 编译产物：connect-fallback.d.ts + connect-fallback.impl.js */
+import type { CliFallbackOutcome, ConnectCheckpoint, ConnectFailureStage } from './connect-runtime.js';
+export declare const SEARCH_RETRY = "springbrand search query --pretty -- \"<your query>\"";
+export declare const DEFAULT_VERIFICATION_QUERY = "today's top Hacker News story";
+export declare const MALFORMED_ENV_KEY_MESSAGE = "SPRINGBRAND_API_KEY is set but malformed; it will override any stored key. Fix or unset it, then re-run.";
+export declare const MALFORMED_STORED_KEY_MESSAGE = "The stored SpringBrand API key is malformed. Run: sp auth login";
+export type Prompt = (question: string) => Promise<string>;
+interface CliFallbackHooks {
+    onStepStart?: (stage: ConnectFailureStage) => void;
+    onStepDone?: (phase: ConnectCheckpoint) => void;
+}
+export interface CliFallbackOptions {
+    apiKey?: string;
+    verbose: boolean;
+    /** Absent means headless: no interactive login, no query prompt. */
+    prompt?: Prompt;
+    /** Whole-command retry line, per entry point. */
+    retryCommand: string;
+    /** Absent under --all's zero-harness path, which has no telemetry object. */
+    hooks?: CliFallbackHooks;
+}
+/** One readline per question; a held-open interface wedges raw-stdin children. */
+export declare function createStdinPrompt(): Prompt;
+/** Steps print retry lines and return outcomes; only interrupts throw. */
+export declare function runCliFallback(opts: CliFallbackOptions): Promise<CliFallbackOutcome>;
+export {};
+//# sourceMappingURL=connect-fallback.d.ts.map

package/dist/lib/connect-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-fallback.d.ts","sourceRoot":"","sources":["../../src/lib/connect-fallback.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AASvG,eAAO,MAAM,YAAY,0DAAwD,CAAC;AAElF,eAAO,MAAM,0BAA0B,kCAAkC,CAAC;AAI1E,eAAO,MAAM,yBAAyB,6GAA6G,CAAC;AACpJ,eAAO,MAAM,4BAA4B,oEAAoE,CAAC;AAE9G,MAAM,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE3D,UAAU,gBAAgB;IACtB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACnD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAOD,kFAAkF;AAClF,wBAAgB,iBAAiB,IAAI,MAAM,CA4B1C;AAkFD,0EAA0E;AAC1E,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8B1F"}

package/dist/lib/connect-fallback.js

@@ -0,0 +1,166 @@
+/** 复刻自 tiny-fish CLI 编译产物：connect-fallback.d.ts + connect-fallback.impl.js */
+import * as readline from 'node:readline/promises';
+import spawn from 'cross-spawn';
+import { resolvedApiKey, validateKeyFormat } from './auth.js';
+import { installSpringBrandCli } from './cli-install.js';
+import { ensureCliAuthenticated, SPRINGBRAND_CLI_NOT_FOUND_MESSAGE } from './connect-auth.js';
+import { SPRINGBRAND_API_KEY_VAR } from './constants.js';
+import { commandNotFound, ConnectInterruptedError, ConnectStepError, throwIfInterrupted, } from './connect-runtime.js';
+import { errLine, outLine } from './output.js';
+export const SEARCH_RETRY = 'springbrand search query --pretty -- "<your query>"';
+// Echoes the finale suggestion, so headless rescues rehearse the same task.
+export const DEFAULT_VERIFICATION_QUERY = "today's top Hacker News story";
+// Must undercut agent tool-call budgets (Claude Code Bash defaults to 120s).
+const HEADLESS_VERIFY_TIMEOUT_MS = 90_000;
+// An exported var must be unset, not re-logged-in.
+export const MALFORMED_ENV_KEY_MESSAGE = 'SPRINGBRAND_API_KEY is set but malformed; it will override any stored key. Fix or unset it, then re-run.';
+export const MALFORMED_STORED_KEY_MESSAGE = 'The stored SpringBrand API key is malformed. Run: sp auth login';
+function searchRetry(query) {
+    if (process.platform === 'win32')
+        return SEARCH_RETRY;
+    return `springbrand search query --pretty -- '${query.replaceAll("'", "'\\''")}'`;
+}
+/** One readline per question; a held-open interface wedges raw-stdin children. */
+export function createStdinPrompt() {
+    let stdinClosed = false;
+    return async (question) => {
+        if (stdinClosed)
+            throw new Error('stdin is closed');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+        // Without a close-linked signal, question() never settles on Ctrl+D.
+        const closed = new AbortController();
+        rl.on('close', () => closed.abort());
+        // Raw mode swallows Ctrl+C here; resurface it as the interrupt.
+        let interrupted = false;
+        rl.on('SIGINT', () => {
+            interrupted = true;
+            rl.close();
+        });
+        try {
+            return await rl.question(question, { signal: closed.signal });
+        }
+        catch (error) {
+            if (interrupted)
+                throw new ConnectInterruptedError('Setup interrupted');
+            stdinClosed = true;
+            throw error;
+        }
+        finally {
+            rl.close();
+        }
+    };
+}
+function installStep(opts) {
+    try {
+        installSpringBrandCli({ verbose: opts.verbose, announce: true });
+        return null;
+    }
+    catch (error) {
+        if (error instanceof ConnectInterruptedError)
+            throw error;
+        errLine(error instanceof Error ? error.message : String(error));
+        outLine(`Retry: ${opts.retryCommand}`);
+        return 'cli_install_failed';
+    }
+}
+function authStep(opts) {
+    // Resolved raw: validatedApiKey collapses a malformed key into "no key".
+    const rawKey = resolvedApiKey(opts.apiKey);
+    if (rawKey && !validateKeyFormat(rawKey)) {
+        // Terminal even in a TTY: login writes config; env shadows it.
+        errLine(process.env[SPRINGBRAND_API_KEY_VAR] ? MALFORMED_ENV_KEY_MESSAGE : MALFORMED_STORED_KEY_MESSAGE);
+        outLine(`Retry: ${opts.retryCommand}`);
+        return 'invalid_credentials';
+    }
+    if (!opts.prompt && !rawKey) {
+        outLine(`Retry in a terminal: ${opts.retryCommand}`);
+        return 'no_credentials';
+    }
+    try {
+        // Gate-only widening: a config-only key must not re-persist anywhere.
+        // Headless has no one to answer a login prompt; never inherit stdio there.
+        ensureCliAuthenticated('cli', opts.apiKey ?? process.env[SPRINGBRAND_API_KEY_VAR], {
+            interactiveLogin: !!opts.prompt,
+        });
+        return null;
+    }
+    catch (error) {
+        if (error instanceof ConnectInterruptedError)
+            throw error;
+        errLine(error instanceof Error ? error.message : String(error));
+        outLine(error instanceof ConnectStepError && error.failureReason === 'command_not_found'
+            ? 'Retry in a new terminal: sp auth login'
+            : 'Retry: sp auth login');
+        return 'authentication_failed';
+    }
+}
+/** null = abandoned; the retry line is already printed. */
+async function promptQuery(prompt) {
+    let query;
+    try {
+        query = (await prompt('What would you like to search? ')).trim();
+    }
+    catch (error) {
+        if (error instanceof ConnectInterruptedError)
+            throw error;
+        outLine(`Retry: ${SEARCH_RETRY}`);
+        return null;
+    }
+    if (!query) {
+        outLine(`Retry: ${SEARCH_RETRY}`);
+        return null;
+    }
+    return query;
+}
+function verifyStep(query, interactive) {
+    const search = spawn.sync('sp', ['search', 'query', '--pretty', '--', query], {
+        stdio: 'inherit',
+        env: { ...process.env, TF_SETUP_VERIFICATION: '1' },
+        // A user-driven search must never be cut off.
+        timeout: interactive ? undefined : HEADLESS_VERIFY_TIMEOUT_MS,
+    });
+    if (commandNotFound(search.error)) {
+        errLine(SPRINGBRAND_CLI_NOT_FOUND_MESSAGE);
+        outLine(`Retry in a new terminal: ${searchRetry(query)}`);
+        return 'verification_failed';
+    }
+    throwIfInterrupted(search);
+    if (search.error || search.status !== 0) {
+        outLine(`Retry: ${searchRetry(query)}`);
+        return 'verification_failed';
+    }
+    return 'cli_verified';
+}
+/** Steps print retry lines and return outcomes; only interrupts throw. */
+export async function runCliFallback(opts) {
+    const { hooks, prompt } = opts;
+    const stepStart = hooks?.onStepStart ?? (() => { });
+    const stepDone = hooks?.onStepDone ?? (() => { });
+    stepStart('cli_install');
+    const installFailure = installStep(opts);
+    if (installFailure)
+        return installFailure;
+    stepDone('cli_installed');
+    stepStart('authentication');
+    const authFailure = authStep(opts);
+    if (authFailure)
+        return authFailure;
+    stepDone('authenticated');
+    stepStart('cli_verification');
+    let query;
+    if (prompt) {
+        const answered = await promptQuery(prompt);
+        if (answered === null)
+            return 'abandoned';
+        query = answered;
+    }
+    else {
+        // Headless with a key: a canned query still proves the pipe.
+        query = DEFAULT_VERIFICATION_QUERY;
+    }
+    const outcome = verifyStep(query, !!prompt);
+    if (outcome === 'cli_verified')
+        stepDone('cli_verified');
+    return outcome;
+}
+//# sourceMappingURL=connect-fallback.js.map

package/dist/lib/connect-fallback.js.map

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

package/dist/lib/connect-picker.d.ts

@@ -0,0 +1,19 @@
+/** 复刻自 tiny-fish CLI 编译产物：connect-picker.d.ts + connect-picker.impl.js */
+import type { Readable } from 'node:stream';
+import type { Harness, HarnessDetection } from './harness-detect.js';
+export declare function pickHarnesses(detections: HarnessDetection[], connectedBefore: ReadonlySet<string>, io?: PickerIo): Promise<PickResult>;
+type PickSelection = Harness[] | 'cancel';
+export interface PickResult {
+    selection: PickSelection;
+    mode: 'pick' | 'pick_numeric';
+}
+type PickerStdin = Readable & {
+    setRawMode?: (raw: boolean) => unknown;
+};
+export interface PickerIo {
+    stdin?: PickerStdin;
+    write?: (text: string) => void;
+    prompt?: (question: string) => Promise<string>;
+}
+export {};
+//# sourceMappingURL=connect-picker.d.ts.map

package/dist/lib/connect-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-picker.d.ts","sourceRoot":"","sources":["../../src/lib/connect-picker.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA+IrE,wBAAsB,aAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,EAAE,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB5I;AAGD,KAAK,aAAa,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC;AAE1C,MAAM,WAAW,UAAU;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;CACjC;AAED,KAAK,WAAW,GAAG,QAAQ,GAAG;IAC1B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CAC1C,CAAC;AAEF,MAAM,WAAW,QAAQ;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD"}