@tiny-fish/cli 0.45.2-next.354 → 0.45.2-next.357

package/dist/lib/connect-steps.js

@@ -0,0 +1,104 @@
+import { verifyMcpHealth } from './verify.js';
+import { installTinyFishCli } from './cli-install.js';
+import { createStdinPrompt, runCliFallback } from './connect-fallback.js';
+import { detectHumanInitiated } from './harness.js';
+import { errLine } from './output.js';
+import { ConnectInterruptedError, ConnectStepError, HoistedFailureReportedError, finishSetupCommand, requireCommandSupport, settle, stageDurationOf, withStageDuration, } from './connect-runtime.js';
+export async function requireKeylessMcp(mcpUrl) {
+    if ((await verifyMcpHealth(mcpUrl, true)).ok)
+        return;
+    throw new ConnectStepError('TinyFish keyless Search is unavailable', 'invalid_config');
+}
+function isMissingHarness(error) {
+    return error instanceof ConnectStepError && error.failureReason === 'harness_not_installed';
+}
+/** Undefined means the rescue ran; the caller returns immediately. */
+export async function requireSupportOrRescue(client, connectClient, state, telemetry, options) {
+    try {
+        return requireCommandSupport(client);
+    }
+    catch (error) {
+        if (!options.fallbackWhenMissing || !isMissingHarness(error))
+            throw error;
+        await runMissingHarnessFallback(client.displayName, connectClient, state, telemetry, options);
+        return undefined;
+    }
+}
+// The harness attempt stays failed; the rescue rides fallback_outcome (PF-3707).
+async function runMissingHarnessFallback(displayName, connectClient, state, telemetry, options) {
+    // Stamped before any step: Ctrl+C settles before an outcome exists.
+    telemetry.setFallbackOutcome('abandoned');
+    errLine(`${displayName} was not found on PATH. Setting up the TinyFish CLI instead.`);
+    const outcome = await runCliFallback({
+        apiKey: options.apiKey,
+        verbose: options.verbose ?? false,
+        prompt: detectHumanInitiated() ? createStdinPrompt() : undefined,
+        retryCommand: `npx @tiny-fish/cli connect ${connectClient}`,
+        hooks: {
+            // Terminal detail is explicit below; abort rows still name the step.
+            onStepStart: (stage) => {
+                state.stage = stage;
+            },
+            onStepDone: (phase) => telemetry.track('checkpoint', { phase }),
+        },
+    });
+    telemetry.setFallbackOutcome(outcome);
+    // Never `completed`: dashboards read that as "the harness install worked".
+    settle(state, telemetry, 'failed', {
+        failedStage: 'prerequisite_check',
+        failureReason: 'harness_not_installed',
+    });
+    if (outcome !== 'cli_verified') {
+        process.exitCode = 1;
+        return;
+    }
+    errLine('The TinyFish CLI is installed and working.');
+    errLine('Using a different agent? Run: tinyfish connect --all');
+}
+/** Fails on a carried failure; only the first take reports anything. */
+function takeHoistedCliInstall(take, telemetry) {
+    const { outcome, firstTake } = take();
+    if (!outcome.ok) {
+        // Late takers fail too; only the first reports the install.
+        if (!firstTake)
+            throw new HoistedFailureReportedError(outcome.error.message);
+        throw withStageDuration(outcome.error, outcome.durationMs);
+    }
+    if (firstTake) {
+        telemetry.track('checkpoint', {
+            phase: 'cli_installed',
+            stageDurationMs: outcome.durationMs,
+        });
+    }
+}
+/** Consumes the `--all` hoist when present; installs inline otherwise. */
+export function runCliInstallStep(options, telemetry) {
+    if (options.hoistedCliInstall) {
+        takeHoistedCliInstall(options.hoistedCliInstall, telemetry);
+        return;
+    }
+    installTinyFishCli({ verbose: options.verbose ?? false, announce: true });
+    telemetry.track('checkpoint', { phase: 'cli_installed' });
+}
+export function walkthroughPhase(outcome) {
+    return outcome === 'printed' ? 'walkthrough_prompt_printed' : 'walkthrough_launched';
+}
+export function finishSetupHint(connectClient) {
+    return `Finish setup with: ${finishSetupCommand(connectClient)}`;
+}
+/** Warn + report post_install_failed; interrupts are abandonment, not failure. */
+export function trackPostInstallFailure(displayName, state, telemetry, error) {
+    if (error instanceof ConnectInterruptedError)
+        return;
+    // An earlier harness already owns the shared install's failure record.
+    if (!(error instanceof HoistedFailureReportedError)) {
+        telemetry.track('post_install_failed', {
+            failedStage: state.stage,
+            failureReason: error instanceof ConnectStepError ? error.failureReason : 'unexpected_error',
+            failureDetail: error instanceof ConnectStepError ? (error.failureDetail ?? error.message) : undefined,
+            stageDurationMs: stageDurationOf(error),
+        });
+    }
+    errLine(`The ${displayName} MCP connection succeeded, but a finishing step ` +
+        `(${state.stage}) failed: ${error instanceof Error ? error.message : String(error)}`);
+}

package/dist/lib/doctor-checks.js

@@ -4,7 +4,7 @@ import { AuthMode, Registered } from './harness-detect.js';
 import { resolveHermesHome } from './hermes-env.js';
 import { hermesWebBackendsOurs, readHermesPluginStatus, } from './hermes-plugin.js';
 import { endpointOf, isDefaultEndpoint } from './mcp-endpoint.js';
-import { PI_ADAPTER_INSTALL_COMMAND, piMcpAdapterState } from './pi-config.js';
+import { PI_ADAPTER_INSTALL_COMMAND, piMcpAdapterState } from './config/pi-config.js';
 import { boundedVersion } from './output.js';
 import { verifyMcpHealth } from './verify.js';
 // A green auth mode with a red auth call proves nothing, so the call's verdict gates the claim.

package/dist/lib/doctor-repairs.js

@@ -1,5 +1,5 @@
 import spawn from 'cross-spawn';
-import { connectHarness } from '../commands/connect.js';
+import { connectHarness } from './connect-harness.js';
 import { OAUTH_SIGN_IN_TIMEOUT_MS } from './connect-all-auth.js';
 import { Registered } from './harness-detect.js';
 import { detectHumanInitiated } from './harness.js';

package/dist/lib/doctor-report.d.ts

@@ -43,6 +43,7 @@ declare const doctorCheckSchema: z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
     }>>;
     scope: z.ZodEnum<{
@@ -62,6 +63,7 @@ declare const doctorHarnessSchema: z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
     }>;
     detected: z.ZodBoolean;
@@ -91,6 +93,7 @@ declare const doctorRepairSchema: z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
     }>>;
     command: z.ZodString;
@@ -129,6 +132,7 @@ export declare const doctorReportSchema: z.ZodObject<{
             "command-code": "command-code";
             opencode: "opencode";
             pi: "pi";
+            cline: "cline";
             "claude-code": "claude-code";
         }>>;
         scope: z.ZodEnum<{
@@ -148,6 +152,7 @@ export declare const doctorReportSchema: z.ZodObject<{
             "command-code": "command-code";
             opencode: "opencode";
             pi: "pi";
+            cline: "cline";
             "claude-code": "claude-code";
         }>;
         detected: z.ZodBoolean;
@@ -177,6 +182,7 @@ export declare const doctorReportSchema: z.ZodObject<{
             "command-code": "command-code";
             opencode: "opencode";
             pi: "pi";
+            cline: "cline";
             "claude-code": "claude-code";
         }>>;
         command: z.ZodString;

package/dist/lib/harness-detect.js

@@ -3,7 +3,8 @@ import * as os from 'os';
 import * as path from 'path';
 import which from 'which';
 import { ALL_HARNESSES, harnessSpec } from './harness-spec.js';
-import { piAgentDir, piBinaryIsPi } from './pi-config.js';
+import { clineConfigDir } from './config/cline-config.js';
+import { piAgentDir, piBinaryIsPi } from './config/pi-config.js';
 export { ALL_HARNESSES };
 export const HARNESS_DISPLAY_NAMES = Object.fromEntries(ALL_HARNESSES.map((harness) => [harness, harnessSpec(harness).displayName]));
 export const RELOAD_ACTION = Object.fromEntries(ALL_HARNESSES.map((harness) => [harness, harnessSpec(harness).reloadAction]));
@@ -33,8 +34,11 @@ export function commandOnPath(command) {
         return false;
     }
 }
-// PI_CODING_AGENT_DIR moves pi's dir; a guessed path would be written unread.
-const CONFIG_PATH_RESOLVERS = { pi: piAgentDir };
+// PI_CODING_AGENT_DIR and CLINE_DIR move these dirs; a guessed path would be written unread.
+const CONFIG_PATH_RESOLVERS = {
+    cline: clineConfigDir,
+    pi: piAgentDir,
+};
 export function harnessConfigPath(harness) {
     const resolved = CONFIG_PATH_RESOLVERS[harness]?.();
     return resolved ?? path.join(os.homedir(), harnessSpec(harness).configDir); // nosemgrep: path-join-resolve-traversal -- fixed dir names under os.homedir()

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

@@ -1,5 +1,5 @@
 /** Our skill-path slugs, inherited from the `skills` CLI era. */
-export type SkillAgent = 'claude-code' | 'codex' | 'command-code' | 'cursor' | 'hermes-agent' | 'opencode' | 'pi';
+export type SkillAgent = 'claude-code' | 'cline' | 'codex' | 'command-code' | 'cursor' | 'hermes-agent' | 'opencode' | 'pi';
 export interface HarnessSupportCheck {
     args: string[];
     /** Missing → nothing can work; setup fails. */
@@ -114,6 +114,27 @@ export declare const HARNESS_SPECS: {
             label: string;
         }[];
     };
+    cline: {
+        command: string;
+        displayName: string;
+        configDir: string;
+        reloadAction: string;
+        skillAgent: "cline";
+        nonInteractiveAdd: true;
+        keyRequired: true;
+        supportCheck: {
+            args: string[];
+            patterns: RegExp[];
+            keyAuthPattern: RegExp;
+            unavailableMessage: string;
+        };
+        urlStyle: "positional";
+        addFlags: string[];
+        header: {
+            name: string;
+            sep: ": ";
+        };
+    };
     codex: {
         command: string;
         displayName: string;
@@ -286,4 +307,4 @@ export type NonNativeHarness = {
     [K in Harness]: 'urlStyle' extends keyof (typeof HARNESS_SPECS)[K] ? never : 'keyRequired' extends keyof (typeof HARNESS_SPECS)[K] ? never : K;
 }[Harness];
 /** 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 declare const NATIVE_HARNESSES: ("openclaw" | "omp" | "grok" | "cursor" | "codex" | "hermes" | "command-code" | "opencode" | "pi" | "cline" | "claude-code")[];

package/dist/lib/harness-spec.js

@@ -46,6 +46,9 @@ const OPENCODE_MODEL_NOTE = 'Note: TinyFish runs on tool calls, so OpenCode need
     '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 TinyFish — Hermes discovers MCP servers at startup.';
+const CLINE_MCP_ADD_UNAVAILABLE_MESSAGE = 'Could not confirm this Cline installation supports non-interactive MCP setup: `cline mcp add ' +
+    '--help` did not list `--transport` and `--yes`. Update Cline with `cline --update` and retry.' +
+    SUPPORT_CHECK_DEBUG_HINT;
 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;
@@ -87,6 +90,26 @@ export const HARNESS_SPECS = {
             },
         ],
     },
+    cline: {
+        command: 'cline',
+        displayName: 'Cline',
+        configDir: '.cline',
+        reloadAction: 'restart it',
+        skillAgent: 'cline',
+        nonInteractiveAdd: true,
+        // Key-only by decision: TinyFish never sends CLI-harness users through OAuth.
+        keyRequired: true,
+        supportCheck: {
+            args: ['mcp', 'add', '--help'],
+            // Without `--yes` the add opens a wizard and exits non-zero off a TTY.
+            patterns: [/--transport(?:[\s<=]|$)/m, /--yes(?:[\s<=]|$)/m],
+            keyAuthPattern: HEADER_FLAG,
+            unavailableMessage: CLINE_MCP_ADD_UNAVAILABLE_MESSAGE,
+        },
+        urlStyle: 'positional',
+        addFlags: ['--transport', 'http', '--yes'],
+        header: { name: 'X-API-Key', sep: ': ' },
+    },
     codex: {
         command: 'codex',
         displayName: 'Codex',

package/dist/lib/harness.js

@@ -32,6 +32,11 @@ const HARNESS_FINGERPRINTS = [
     { name: 'opencode', matches: (env) => Boolean(env['OPENCODE']) },
     // Observed: pi launched from Claude Code inherits CLAUDECODE=1.
     { name: 'pi', matches: (env) => env['PI_CODING_AGENT'] === 'true' },
+    // Runtime-only markers; users export CLINE_API_KEY, so no prefix match.
+    {
+        name: 'cline',
+        matches: (env) => Boolean(env['CLINE_CONNECTOR_CLI_LAUNCH'] || env['CLINE_WRAPPER_PATH']),
+    },
     {
         name: 'claude-code',
         matches: (env) => env['CLAUDECODE'] === '1' || Boolean(env['CLAUDE_CODE_ENTRYPOINT']),

package/dist/lib/hermes-plugin.js

@@ -7,7 +7,7 @@ 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, TINYFISH_ACCESS_MODE_HEADER, TINYFISH_KEYLESS_ACCESS_MODE, } from './constants.js';
-import { HERMES_HEADER_TEMPLATE, HERMES_MCP_SERVER_KEY } from './hermes-config.js';
+import { HERMES_HEADER_TEMPLATE, HERMES_MCP_SERVER_KEY } from './config/hermes-config.js';
 import { errLine, parseJson } from './output.js';
 // Resolved at connect time, so plugin releases need no CLI release.
 export const HERMES_PLUGIN_PACKAGE = '@tiny-fish/hermes';

package/dist/lib/registration-detect.js

@@ -6,12 +6,13 @@ import { loadConfig, matchesCliKey } from './auth.js';
 import { NATIVE_BY_HARNESS } from './connect-clients.js';
 import { HARNESS_PROBE_TIMEOUT_MS } from './constants.js';
 import { errLine } from './output.js';
-import { readCommandCodeTinyfishEntry } from './command-code-config.js';
-import { readCursorTinyfishEntry } from './cursor-config.js';
-import { readOmpTinyfishEntry } from './omp-config.js';
-import { readPiTinyfishEntry } from './pi-config.js';
+import { readClineTinyfishEntry } from './config/cline-config.js';
+import { readCommandCodeTinyfishEntry } from './config/command-code-config.js';
+import { readCursorTinyfishEntry } from './config/cursor-config.js';
+import { readOmpTinyfishEntry } from './config/omp-config.js';
+import { readPiTinyfishEntry } from './config/pi-config.js';
 import { readHermesKey, resolveHermesHome } from './hermes-env.js';
-import { readHermesEntry } from './hermes-config.js';
+import { readHermesEntry } from './config/hermes-config.js';
 import { detectInstalledHarnesses, harnessConfigPath, harnessDisplayPath, AuthMode, Registered, } from './harness-detect.js';
 const NOT_REGISTERED = Object.freeze({
     registered: Registered.No,
@@ -279,6 +280,21 @@ function probeCodex() {
         ...(envVar ? envKeyVerdict(envVar) : {}),
     };
 }
+// No `cline mcp list`, so the settings file is the only registration evidence.
+function probeCline() {
+    const entry = readClineTinyfishEntry();
+    if (entry.error) {
+        return unverified('cline_mcp_settings.json exists but could not be read or parsed');
+    }
+    if (!entry.present)
+        return NOT_REGISTERED;
+    return {
+        registered: Registered.Yes,
+        authMode: entry.hasApiKeyHeader ? AuthMode.ApiKey : AuthMode.Unknown,
+        ...(entry.url ? { registeredUrl: entry.url } : {}),
+        ...(entry.keyMatchesCliKey ? { keyMatchesCliKey: true } : {}),
+    };
+}
 function probeCommandCode() {
     const entry = readCommandCodeTinyfishEntry();
     if (entry.error)
@@ -523,6 +539,7 @@ function probeGrok() {
 }
 const PROBES = {
     'claude-code': () => fromMcpGet('claude'),
+    cline: probeCline,
     codex: probeCodex,
     'command-code': probeCommandCode,
     cursor: probeCursor,

package/dist/lib/setup-telemetry.d.ts

@@ -31,6 +31,7 @@ declare const harnessResultSchema: z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
     }>;
     detected: z.ZodBoolean;
@@ -67,6 +68,7 @@ export declare const setupCompletedPayloadSchema: z.ZodObject<{
             "command-code": "command-code";
             opencode: "opencode";
             pi: "pi";
+            cline: "cline";
             "claude-code": "claude-code";
         }>;
         detected: z.ZodBoolean;
@@ -130,6 +132,7 @@ declare const doctorCompletedPayloadSchema: z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
         all: "all";
     }>;
@@ -145,6 +148,7 @@ declare const doctorCompletedPayloadSchema: z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
     }>>;
     harnesses: z.ZodArray<z.ZodObject<{
@@ -158,6 +162,7 @@ declare const doctorCompletedPayloadSchema: z.ZodObject<{
             "command-code": "command-code";
             opencode: "opencode";
             pi: "pi";
+            cline: "cline";
             "claude-code": "claude-code";
         }>;
         detected: z.ZodBoolean;
@@ -200,6 +205,7 @@ declare const doctorCouldNotRunPayloadSchema: z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
         all: "all";
     }>;
@@ -238,6 +244,7 @@ declare const doctorPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
         all: "all";
     }>;
@@ -253,6 +260,7 @@ declare const doctorPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
     }>>;
     harnesses: z.ZodArray<z.ZodObject<{
@@ -266,6 +274,7 @@ declare const doctorPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "command-code": "command-code";
             opencode: "opencode";
             pi: "pi";
+            cline: "cline";
             "claude-code": "claude-code";
         }>;
         detected: z.ZodBoolean;
@@ -307,6 +316,7 @@ declare const doctorPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "command-code": "command-code";
         opencode: "opencode";
         pi: "pi";
+        cline: "cline";
         "claude-code": "claude-code";
         all: "all";
     }>;

package/dist/lib/skill-paths.js

@@ -14,6 +14,7 @@ const SKILL_DIR_BY_AGENT = {
     'claude-code': () => path.join(agentHome('CLAUDE_CONFIG_DIR', '.claude'), 'skills'),
     // The env value, not resolveHermesHome(): skills@1.5.15 reads $HERMES_HOME directly.
     'hermes-agent': () => path.join(agentHome('HERMES_HOME', '.hermes'), 'skills'),
+    cline: canonicalSkillsDir,
     codex: canonicalSkillsDir,
     // Not the canonical dir: `skills` writes this one under the harness's own config dir.
     'command-code': () => path.join(os.homedir(), '.commandcode', 'skills'), // nosemgrep: path-join-resolve-traversal -- fixed dir names under os.homedir()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-fish/cli",
-  "version": "0.45.2-next.354",
+  "version": "0.45.2-next.357",
   "description": "TinyFish CLI — run web automations from your terminal",
   "type": "module",
   "bin": {