@springbrand/cli 0.1.0

package/dist/lib/harness-spec.d.ts

@@ -0,0 +1,285 @@
+/** 复刻自 tiny-fish CLI 编译产物：harness-spec.d.ts + harness-spec.impl.js */
+/** One entry per harness; every per-harness list derives from it. */
+export declare const HARNESS_SPECS: {
+    'claude-code': {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        skillAgent: "claude-code";
+        nonInteractiveAdd: true;
+        supportCheck: {
+            args: string[];
+            patterns: RegExp[];
+            optionalPatterns: RegExp[];
+            keyAuthPattern: RegExp;
+            unavailableMessage: string;
+        };
+        urlStyle: "positional";
+        addFlags: string[];
+        header: {
+            name: string;
+            sep: ": ";
+            valuePrefix: string;
+        };
+        loginArgs: string[];
+        degradedAuthNotes: {
+            keyed: string;
+            deferred: string;
+        };
+        removals: {
+            args: string[];
+            label: string;
+        }[];
+    };
+    codex: {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        skillAgent: "codex";
+        supportCheck: {
+            args: string[];
+            patterns: RegExp[];
+            optionalPatterns: RegExp[];
+            keyAuthPattern: RegExp;
+            unavailableMessage: string;
+        };
+        urlStyle: "flag";
+        keyEnvFlag: string;
+        degradedAuthNotes: {
+            keyed: string;
+            deferred: string;
+        };
+        loginArgs: string[];
+        authDeferredAtInstall: true;
+    };
+    'command-code': {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        skillAgent: "command-code";
+        supportCheck: {
+            args: string[];
+            patterns: RegExp[];
+            timeoutMs: number;
+            unavailableMessage: string;
+        };
+        keyRequired: true;
+        header: {
+            name: string;
+            sep: ": ";
+            valuePrefix: string;
+        };
+        keyedAddJsonFlags: string[];
+        removals: {
+            args: string[];
+            label: string;
+        }[];
+    };
+    cursor: {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        skillAgent: "cursor";
+        readableWithoutBinary: true;
+        canVerifyAuth: true;
+        keyHeldByCli: true;
+        cliWritesConfig: true;
+    };
+    grok: {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        nonInteractiveAdd: true;
+        supportCheck: {
+            args: string[];
+            patterns: RegExp[];
+            keyAuthPattern: RegExp;
+            unavailableMessage: string;
+        };
+        urlStyle: "positional";
+        addFlags: string[];
+        header: {
+            name: string;
+            sep: ": ";
+            valuePrefix: string;
+            viaEnv: true;
+        };
+        signInHint: string;
+    };
+    hermes: {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        skillAgent: "hermes-agent";
+        keyRequired: true;
+        supportCheck: {
+            args: string[];
+            patterns: RegExp[];
+            keyAuthPattern: RegExp;
+            unavailableMessage: string;
+        };
+        urlStyle: "flag";
+        keyAddFlags: string[];
+        uninstallExtra: {
+            args: string[];
+            label: string;
+        };
+        postConnectNote: string;
+        keyHeldByCli: true;
+    };
+    omp: {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        canVerifyAuth: true;
+        keyHeldByCli: true;
+        cliWritesConfig: true;
+    };
+    openclaw: {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        supportCheck: {
+            args: string[];
+            patterns: RegExp[];
+            variants: string[];
+            unknownVariant: RegExp;
+            timeoutMs: number;
+            unavailableMessage: string;
+        };
+        signInViaCliLogin: true;
+        canVerifyAuth: true;
+        keyHeldByCli: true;
+    };
+    opencode: {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        skillAgent: "opencode";
+        nonInteractiveAdd: true;
+        supportCheck: {
+            args: string[];
+            patterns: RegExp[];
+            keyAuthPattern: RegExp;
+            unavailableMessage: string;
+        };
+        urlStyle: "flag";
+        header: {
+            name: string;
+            sep: "=";
+            valuePrefix: string;
+        };
+        loginArgs: string[];
+        removals: never[];
+        postConnectNote: string;
+    };
+    pi: {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        skillAgent: "pi";
+        canVerifyAuth: true;
+        keyHeldByCli: true;
+        cliWritesConfig: true;
+    };
+};
+export declare const ALL_HARNESSES: Harness[];
+export declare function harnessSpec(harness: Harness): HarnessSpec;
+/** Native MCP harnesses generate an add; key-only ones generate only the keyed form. */
+export declare const NATIVE_HARNESSES: ("openclaw" | "omp" | "grok" | "cursor" | "codex" | "hermes" | "command-code" | "opencode" | "pi" | "claude-code")[];
+export type SkillAgent = 'claude-code' | 'codex' | 'command-code' | 'cursor' | 'hermes-agent' | 'opencode' | 'pi';
+export interface HarnessSupportCheck {
+    args: string[];
+    /** Missing → nothing can work; setup fails. */
+    patterns: RegExp[];
+    /** Missing → degrade to key or deferred auth, never refuse. */
+    optionalPatterns?: RegExp[];
+    /** Missing → this install cannot take a stored key; fall back to OAuth. */
+    keyAuthPattern?: RegExp;
+    /** Ordered alternative flags in one help output; first match wins. */
+    variants?: string[];
+    /** Matches an alternative we do not know; renames fail loudly. */
+    unknownVariant?: RegExp;
+    /** Defaults to NON_INTERACTIVE_TIMEOUT_MS; raise for a slow cold start. */
+    timeoutMs?: number;
+    unavailableMessage: string;
+}
+export interface HarnessSpec {
+    command: string;
+    displayName: string;
+    /** Home-relative; existing dir means the harness ran here once. */
+    configDir: string;
+    /** MCP config is read at startup; a running harness needs this to see SpringBrand. */
+    reloadAction: string;
+    skillAgent?: SkillAgent;
+    /** Absent for Cursor: its connect writes mcp.json, no binary probe. */
+    supportCheck?: HarnessSupportCheck;
+    /** Capturable: this `mcp add` never runs OAuth inline; unset stays inherited. */
+    nonInteractiveAdd?: true;
+    /** Present only on native MCP harnesses; absent means connect is an override. */
+    urlStyle?: 'flag' | 'positional';
+    /** "positional": before `springbrand <url>`. "flag": after `--url <url>`. */
+    addFlags?: string[];
+    /** Keyed adds append `--header` built from these parts. */
+    header?: {
+        name: string;
+        sep: ': ' | '=';
+        valuePrefix?: string;
+        viaEnv?: boolean;
+    };
+    /** Keyed adds append this flag plus the env var name (Codex). */
+    keyEnvFlag?: string;
+    /** Keyed adds append these flags; the key itself is seeded elsewhere (Hermes). */
+    keyAddFlags?: string[];
+    /** Keyed adds go through `mcp add-json`, which takes the URL and header in its body. */
+    keyedAddJsonFlags?: string[];
+    /** No sign-in exists here, so connect refuses a keyless install (Hermes). */
+    keyRequired?: true;
+    loginArgs?: string[];
+    /** Default: one `mcp remove springbrand` labeled from displayName. */
+    removals?: {
+        args: string[];
+        label: string;
+    }[];
+    /** Extra --uninstall row beyond `removals`; never runs pre-add. */
+    uninstallExtra?: {
+        args: string[];
+        label: string;
+    };
+    /** Shown when a keyless install leaves sign-in to the harness. */
+    signInHint?: string;
+    /** Replaces the `loginArgs` step when `supportCheck.optionalPatterns` miss. */
+    degradedAuthNotes?: {
+        keyed: string;
+        deferred: string;
+    };
+    /** Printed after a successful connect, on both the launch and non-launch paths. */
+    postConnectNote?: string;
+    /** Sign-in is the CLI's own interactive `sp auth login`. */
+    signInViaCliLogin?: true;
+    /** Stored-key auth verification works against this harness's config. */
+    canVerifyAuth?: true;
+    /** The CLI holds or writes the key; no harness `mcp add` carries it. */
+    keyHeldByCli?: true;
+    /** Connect writes the MCP config file; no harness binary is spawned. */
+    cliWritesConfig?: true;
+    /** A second reader (Cursor's IDE) loads the config with no harness binary on PATH. */
+    readableWithoutBinary?: true;
+    /** `mcp add` succeeds unauthenticated; OAuth lands at first tool use. */
+    authDeferredAtInstall?: true;
+}
+export type Harness = keyof typeof HARNESS_SPECS;
+export type NonNativeHarness = {
+    [K in Harness]: 'urlStyle' extends keyof (typeof HARNESS_SPECS)[K] ? never : 'keyRequired' extends keyof (typeof HARNESS_SPECS)[K] ? never : K;
+}[Harness];
+//# sourceMappingURL=harness-spec.d.ts.map

package/dist/lib/harness-spec.d.ts.map

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

package/dist/lib/harness-spec.js

@@ -0,0 +1,268 @@
+/** 复刻自 tiny-fish CLI 编译产物：harness-spec.d.ts + harness-spec.impl.js */
+import { HERMES_PLUGIN_NAME } from './constants.js';
+// An old install is only one reason a flag can go unseen, so no message asserts the cause.
+const SUPPORT_CHECK_DEBUG_HINT = ' Set SPRINGBRAND_DEBUG=1 and retry to print the help output SpringBrand read.';
+const MCP_ADD_UNAVAILABLE_MESSAGE = 'Could not confirm this Claude Code installation exposes `claude mcp add`: `claude mcp ' +
+    '--help` did not list it. Update Claude Code with `claude update` and retry.' +
+    SUPPORT_CHECK_DEBUG_HINT;
+// `claude mcp login` only exists upstream from Claude Code 2.1.186; older installs still register.
+const CLAUDE_CODE_KEYED_FALLBACK_NOTE = 'Using your stored SpringBrand API key: this Claude Code predates one-command sign-in ' +
+    '(`claude mcp login`), so no browser sign-in is needed.';
+const CLAUDE_CODE_DEFERRED_AUTH_NOTE = 'SpringBrand is registered in Claude Code but not signed in: this Claude Code predates ' +
+    'one-command sign-in (`claude mcp login`). Open Claude Code and run `/mcp` to sign in to ' +
+    'SpringBrand. `claude update` gets you one-command sign-in. Already have a SpringBrand API key? ' +
+    'Run `sp connect claude-code --api-key <key>` instead.';
+const CODEX_MCP_URL_UNAVAILABLE_MESSAGE = 'Could not confirm this Codex installation supports remote MCP servers: `codex mcp add ' +
+    '--help` did not list `--url`. Update Codex and retry, or add SpringBrand manually with ' +
+    '`codex mcp add`.' +
+    SUPPORT_CHECK_DEBUG_HINT;
+const CODEX_KEYED_FALLBACK_NOTE = 'Using your stored SpringBrand API key: this Codex cannot report whether an OAuth sign-in ' +
+    'finished, so no browser sign-in is attempted.';
+const CODEX_DEFERRED_AUTH_NOTE = 'SpringBrand is registered in Codex but not signed in: this Codex predates reliable sign-in ' +
+    'reporting. Run `codex mcp login springbrand` to sign in, or update Codex with ' +
+    '`npm install -g @openai/codex@latest` for one-command sign-in.';
+const HERMES_OAUTH_UNAVAILABLE_MESSAGE = 'Could not confirm this Hermes installation supports one-command MCP authentication: `hermes ' +
+    'mcp add --help` did not list `--auth oauth`. Update Hermes and retry, or add SpringBrand ' +
+    'manually with `hermes mcp add`.' +
+    SUPPORT_CHECK_DEBUG_HINT;
+const GROK_HTTP_UNAVAILABLE_MESSAGE = 'Could not confirm this Grok installation supports remote MCP servers: `grok mcp add --help` ' +
+    'did not list `--transport`. Update Grok and retry, or add SpringBrand manually with ' +
+    '`grok mcp add`.' +
+    SUPPORT_CHECK_DEBUG_HINT;
+// Grok has no `mcp login`; sign-in only happens inside the TUI. No key nudge here: a revoked
+// key leaves Grok with no OAuth fallback, and doctor cannot spot that yet (PF-3618).
+const GROK_SIGN_IN_HINT = 'SpringBrand is registered in Grok. Open Grok, run `/mcps`, select springbrand, and press `i` to ' +
+    'sign in.';
+const OPENCLAW_SKILL_UNAVAILABLE_MESSAGE = 'Could not confirm this OpenClaw installation supports global skill installation: `openclaw ' +
+    'skills install --help` did not list `--global`. Update OpenClaw and retry, or install ' +
+    'manually with `openclaw skills install @springbrand/springbrand --global`.' +
+    SUPPORT_CHECK_DEBUG_HINT;
+const OPENCODE_MCP_ADD_UNAVAILABLE_MESSAGE = 'Could not confirm this OpenCode installation supports one-command MCP setup: `opencode mcp ' +
+    'add --help` did not list `--url`. Update OpenCode and retry, or add SpringBrand manually with ' +
+    '`opencode mcp add`.' +
+    SUPPORT_CHECK_DEBUG_HINT;
+// OpenCode is model-agnostic (unlike Claude Code / Codex), so a fresh install can default to a
+// model with no tool support — SpringBrand runs entirely on tool calls, so it would fail there.
+const OPENCODE_MODEL_NOTE = 'Note: SpringBrand runs on tool calls, so OpenCode needs a model that supports tool use. Image-only ' +
+    'models (e.g. Nano Banana Pro) will show "No endpoints found that support tool use" — switch ' +
+    "OpenCode's model if the walkthrough can't start.";
+const HERMES_RESTART_NOTE = 'Restart your Hermes session to pick up SpringBrand — Hermes discovers MCP servers at startup.';
+const COMMAND_CODE_ADD_JSON_UNAVAILABLE_MESSAGE = 'Could not confirm this Command Code installation supports keyed MCP setup: `commandcode mcp ' +
+    '--help` did not list `add-json`. Run `commandcode update` and retry.' +
+    SUPPORT_CHECK_DEBUG_HINT;
+const HEADER_FLAG = /(?:^|\s)--header(?:[\s<=]|$)/m;
+const ADD_JSON_COMMAND = /^\s*add-json(?:\s|\[)/m;
+/** One entry per harness; every per-harness list derives from it. */
+export const HARNESS_SPECS = {
+    'claude-code': {
+        command: 'claude',
+        displayName: 'Claude Code',
+        configDir: '.claude',
+        reloadAction: 'restart it',
+        skillAgent: 'claude-code',
+        nonInteractiveAdd: true,
+        supportCheck: {
+            args: ['mcp', '--help'],
+            patterns: [/^\s*add(?:\s|\[)/m],
+            optionalPatterns: [/^\s*login(?:\s|\[)/m],
+            keyAuthPattern: HEADER_FLAG,
+            unavailableMessage: MCP_ADD_UNAVAILABLE_MESSAGE,
+        },
+        urlStyle: 'positional',
+        addFlags: ['--scope', 'user', '--transport', 'http'],
+        header: { name: 'Authorization', sep: ': ', valuePrefix: 'Bearer ' },
+        loginArgs: ['mcp', 'login', 'springbrand'],
+        degradedAuthNotes: {
+            keyed: CLAUDE_CODE_KEYED_FALLBACK_NOTE,
+            deferred: CLAUDE_CODE_DEFERRED_AUTH_NOTE,
+        },
+        // Project scope is shared in .mcp.json; a user setup command must not rewrite it.
+        removals: [
+            {
+                args: ['mcp', 'remove', 'springbrand', '--scope', 'user'],
+                label: 'user SpringBrand registration',
+            },
+            {
+                args: ['mcp', 'remove', 'springbrand', '--scope', 'local'],
+                label: 'local SpringBrand registration',
+            },
+        ],
+    },
+    codex: {
+        command: 'codex',
+        displayName: 'Codex',
+        configDir: '.codex',
+        reloadAction: 'restart it',
+        skillAgent: 'codex',
+        supportCheck: {
+            args: ['mcp', 'add', '--help'],
+            patterns: [/--url(?:[\s<=]|$)/m],
+            // Codex before ~0.142 reports `o_auth` for a server it never signed in to, so the
+            // sign-in probe lies; `--oauth-resource` is the only marker separating the two.
+            optionalPatterns: [/--oauth-resource(?:[\s<=]|$)/m],
+            keyAuthPattern: /(?:^|\s)--bearer-token-env-var(?:[\s<=]|$)/m,
+            unavailableMessage: CODEX_MCP_URL_UNAVAILABLE_MESSAGE,
+        },
+        urlStyle: 'flag',
+        // Codex has no `--header`; it sends the variable's value as `Bearer <key>`, which is
+        // exactly what `/mcp` reads.
+        keyEnvFlag: '--bearer-token-env-var',
+        degradedAuthNotes: { keyed: CODEX_KEYED_FALLBACK_NOTE, deferred: CODEX_DEFERRED_AUTH_NOTE },
+        // `--oauth-resource` duplicates the resource Codex discovers; Clerk rejects both.
+        // `mcp add` still runs OAuth inline, so `loginArgs` stays a retry.
+        loginArgs: ['mcp', 'login', 'springbrand'],
+        // TODO(PF-3580): connect now probes Codex sign-in, so this over-warns a signed-in install.
+        authDeferredAtInstall: true,
+    },
+    'command-code': {
+        // Same package ships `cmd`, but that is cmd.exe on Windows; this alias collides with nothing.
+        command: 'commandcode',
+        displayName: 'Command Code',
+        configDir: '.commandcode',
+        reloadAction: 'restart it',
+        skillAgent: 'command-code',
+        // add-json is the only command this harness uses, so it is what must exist.
+        supportCheck: {
+            args: ['mcp', '--help'],
+            patterns: [ADD_JSON_COMMAND],
+            // Command Code self-updates inside the probe, which outlasts the default budget.
+            timeoutMs: 30_000,
+            unavailableMessage: COMMAND_CODE_ADD_JSON_UNAVAILABLE_MESSAGE,
+        },
+        // Key-only: `cmd mcp add` runs browser OAuth even when a header is supplied.
+        keyRequired: true,
+        header: { name: 'Authorization', sep: ': ', valuePrefix: 'Bearer ' },
+        // Default scope is `local`, which writes a per-project entry instead of the user's.
+        keyedAddJsonFlags: ['--scope', 'user'],
+        removals: [
+            {
+                args: ['mcp', 'remove', 'springbrand', '--scope', 'user'],
+                label: 'user SpringBrand registration',
+            },
+        ],
+    },
+    cursor: {
+        command: 'cursor-agent',
+        displayName: 'Cursor',
+        configDir: '.cursor',
+        reloadAction: 'reload the window',
+        skillAgent: 'cursor',
+        readableWithoutBinary: true,
+        canVerifyAuth: true,
+        keyHeldByCli: true,
+        cliWritesConfig: true,
+    },
+    grok: {
+        command: 'grok',
+        displayName: 'Grok',
+        configDir: '.grok',
+        // docs.x.ai/build/features/mcp-servers: `r` in /mcps rereads the config.
+        reloadAction: 'run /mcps and press r',
+        nonInteractiveAdd: true,
+        supportCheck: {
+            args: ['mcp', 'add', '--help'],
+            patterns: [/--transport(?:[\s<=]|$)/m],
+            keyAuthPattern: HEADER_FLAG,
+            unavailableMessage: GROK_HTTP_UNAVAILABLE_MESSAGE,
+        },
+        urlStyle: 'positional',
+        addFlags: ['--transport', 'http'],
+        // Grok expands `${VAR}` in headers at load, so the key stays out of argv and config.toml.
+        header: { name: 'Authorization', sep: ': ', valuePrefix: 'Bearer ', viaEnv: true },
+        signInHint: GROK_SIGN_IN_HINT,
+    },
+    hermes: {
+        command: 'hermes',
+        displayName: 'Hermes',
+        configDir: '.hermes',
+        reloadAction: 'restart it',
+        skillAgent: 'hermes-agent',
+        keyRequired: true,
+        supportCheck: {
+            args: ['mcp', 'add', '--help'],
+            patterns: [/--auth\s+\{[^}]*oauth[^}]*\}/],
+            keyAuthPattern: /--auth\s+\{[^}]*header[^}]*\}/,
+            unavailableMessage: HERMES_OAUTH_UNAVAILABLE_MESSAGE,
+        },
+        urlStyle: 'flag',
+        // No `header`: the key goes into Hermes' .env, and `--auth header` reads it from there.
+        keyAddFlags: ['--auth', 'header'],
+        uninstallExtra: {
+            args: ['plugins', 'uninstall', HERMES_PLUGIN_NAME],
+            label: 'SpringBrand web plugin from Hermes',
+        },
+        postConnectNote: HERMES_RESTART_NOTE,
+        // No canVerifyAuth: keyed already covers auth; true breaks keyless installs.
+        keyHeldByCli: true,
+    },
+    omp: {
+        command: 'omp',
+        displayName: 'omp',
+        configDir: '.omp',
+        reloadAction: 'restart it',
+        canVerifyAuth: true,
+        keyHeldByCli: true,
+        cliWritesConfig: true,
+    },
+    openclaw: {
+        command: 'openclaw',
+        displayName: 'OpenClaw',
+        configDir: '.openclaw',
+        reloadAction: 'restart it',
+        supportCheck: {
+            args: ['skills', 'install', '--help'],
+            patterns: [/--global(?:\s|$)/],
+            // Renamed in 2026.8.1; absent before 2026.7, where no trust gate existed.
+            variants: ['--acknowledge-install-policy-warning', '--acknowledge-clawhub-risk'],
+            unknownVariant: /--acknowledge-[a-z-]+/,
+            // 212MB dist; win32 cold starts drove most of the 10s timeouts.
+            timeoutMs: 30_000,
+            unavailableMessage: OPENCLAW_SKILL_UNAVAILABLE_MESSAGE,
+        },
+        signInViaCliLogin: true,
+        canVerifyAuth: true,
+        keyHeldByCli: true,
+    },
+    opencode: {
+        command: 'opencode',
+        displayName: 'OpenCode',
+        configDir: '.config/opencode',
+        reloadAction: 'restart it',
+        skillAgent: 'opencode',
+        nonInteractiveAdd: true,
+        supportCheck: {
+            args: ['mcp', 'add', '--help'],
+            patterns: [/--url(?:\s|$)/m],
+            keyAuthPattern: HEADER_FLAG,
+            unavailableMessage: OPENCODE_MCP_ADD_UNAVAILABLE_MESSAGE,
+        },
+        urlStyle: 'flag',
+        // OpenCode takes `--header NAME=VALUE`, not Claude Code's `NAME: VALUE`.
+        header: { name: 'Authorization', sep: '=', valuePrefix: 'Bearer ' },
+        // OpenCode writes its config itself; `mcp auth` is the separate OAuth step.
+        loginArgs: ['mcp', 'auth', 'springbrand'],
+        // `opencode mcp add` upserts by name and ships no `mcp remove`.
+        removals: [],
+        postConnectNote: OPENCODE_MODEL_NOTE,
+    },
+    pi: {
+        command: 'pi',
+        displayName: 'Pi',
+        configDir: '.pi/agent',
+        reloadAction: 'restart it',
+        skillAgent: 'pi',
+        canVerifyAuth: true,
+        keyHeldByCli: true,
+        cliWritesConfig: true,
+    },
+};
+export const ALL_HARNESSES = Object.keys(HARNESS_SPECS);
+export function harnessSpec(harness) {
+    return HARNESS_SPECS[harness];
+}
+/** Native MCP harnesses generate an add; key-only ones generate only the keyed form. */
+export const NATIVE_HARNESSES = ALL_HARNESSES.filter((harness) => {
+    const spec = harnessSpec(harness);
+    return spec.urlStyle !== undefined || spec.keyRequired === true;
+});
+//# sourceMappingURL=harness-spec.js.map

package/dist/lib/harness-spec.js.map

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

package/dist/lib/harness.d.ts

@@ -0,0 +1,27 @@
+/** 复刻自 tiny-fish CLI 编译产物：harness.d.ts + harness.impl.js */
+type Env = Record<string, string | undefined>;
+export type RuntimeEnv = 'container' | 'desktop';
+interface FsApi {
+    existsSync: (path: string) => boolean;
+    readFileSync: (path: string, encoding: 'utf8') => string;
+}
+/** Returns the detected harness name, or null when none match. */
+export declare function detectHarness(env?: Env): string | null;
+/** Fails open to desktop: a probe error must never break telemetry. */
+export declare function detectRuntimeEnv(env?: Env, fsApi?: FsApi): RuntimeEnv;
+/**
+ * True only when both ends are a real terminal — a human at a prompt. Agents
+ * shell out without a TTY, so this reads false for every harness above and is
+ * the free agent-vs-human signal behind `X-SP-Human-Initiated`.
+ */
+export declare function detectHumanInitiated(streams?: HumanInitiatedStreams): boolean;
+interface HumanInitiatedStreams {
+    stdin: {
+        isTTY?: boolean;
+    };
+    stdout: {
+        isTTY?: boolean;
+    };
+}
+export {};
+//# sourceMappingURL=harness.d.ts.map

package/dist/lib/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/lib/harness.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAa5D,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAEjD,UAAU,KAAK;IACX,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5D;AA+BD,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAGtD;AAoCD,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAOrE;AA4BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAE7E;AAGD,UAAU,qBAAqB;IAC3B,KAAK,EAAE;QACH,KAAK,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,MAAM,EAAE;QACJ,KAAK,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACL"}