@tiny-fish/cli 0.24.1-next.211 → 0.24.1-next.212

package/README.md

@@ -101,6 +101,9 @@ Brings both halves of an install current: the global `@tiny-fish/cli` package an
 Successful steps are summarised in one line each. Add `--verbose` to see the full npm and skills
 output; a failing step prints its output either way.
 
+`--cli-only` updates just the global package and `--skill-only` refreshes just the skill. The two
+flags are mutually exclusive.
+
 The skill step refreshes only the TinyFish skill, and only for the agents you ran
 `tinyfish connect` against. Other global skills, and agents you never connected, are left alone.
 The refresh overwrites your copy of the skill, including any local edits to it. Restart your

package/dist/commands/connect.d.ts

@@ -9,6 +9,8 @@ interface NativeConnectOptions {
     attemptId?: string;
     /** Headless: refuse rather than fall back to an unfinishable browser sign-in. */
     keyAuthOnly?: boolean;
+    /** Internal only: false leaves the global npm tree untouched. */
+    cliInstall?: boolean;
     /** Set by `--all`: the CLI install already ran once, upfront. */
     hoistedCliInstall?: TakeHoistedCliInstall;
     /** Lets `--all` warn in its summary instead of all-green. */
@@ -23,7 +25,7 @@ export declare function connectOpenClaw(options: {
     apiKey?: string;
     mcpUrl: string;
     launch: boolean;
-    installCli?: boolean;
+    cliInstall?: boolean;
     attemptId?: string;
     /** Set by `--all`: the CLI install already ran once, upfront. */
     hoistedCliInstall?: TakeHoistedCliInstall;

package/dist/commands/connect.js

@@ -162,7 +162,9 @@ function runPostInstallSteps(client, options, state, telemetry, signInDeferred)
         }
     };
     try {
-        attempt("cli_install", () => runCliInstallStep(options, telemetry));
+        if (options.cliInstall !== false) {
+            attempt("cli_install", () => runCliInstallStep(options, telemetry));
+        }
         if (client.skillAgent) {
             attempt("skill_install", () => {
                 installWebSkill(client);
@@ -275,7 +277,7 @@ export async function connectOpenClaw(options) {
                 });
             }
         }
-        else if (options.installCli !== false) {
+        else if (options.cliInstall !== false) {
             state.stage = "cli_install";
             installTinyFishCli({ verbose: true });
             telemetry.track("checkpoint", { phase: "cli_installed" });

package/dist/commands/onboard.js

@@ -87,7 +87,7 @@ async function connectAgent(id) {
         return;
     const mcpUrl = new URL("/mcp", BASE_URL).toString();
     if (id === "openclaw") {
-        await connectOpenClaw({ mcpUrl, launch: false, installCli: false });
+        await connectOpenClaw({ mcpUrl, launch: false, cliInstall: false });
     }
     else {
         await agent.connect({ mcpUrl, launch: false });

package/dist/commands/upgrade.d.ts

@@ -1,6 +1,7 @@
 import { Command } from "commander";
+import { type UpgradeScope } from "../lib/setup-telemetry.js";
 /** Returns the version now installed, so the caller reports exactly what the user was told. */
-export declare function runUpgrade(verbose?: boolean): string | null;
+export declare function runUpgrade(verbose?: boolean, scope?: UpgradeScope): string | null;
 /** `runUpgrade` plus its outcome telemetry, which must never change what the upgrade does. */
-export declare function runUpgradeCommand(verbose?: boolean): Promise<void>;
+export declare function runUpgradeCommand(verbose?: boolean, scope?: UpgradeScope): Promise<void>;
 export declare function registerUpgrade(program: Command): void;

package/dist/commands/upgrade.js

@@ -27,16 +27,20 @@ function attempt(label, run) {
     }
 }
 /** Returns the version now installed, so the caller reports exactly what the user was told. */
-export function runUpgrade(verbose = false) {
+export function runUpgrade(verbose = false, scope = "both") {
     errLine("Upgrading TinyFish...");
     let refreshed = false;
     try {
-        // Both steps always run: neither artifact should stay stale because the other failed.
+        // Every selected step runs: one failing must not stall the other.
         const failures = [
-            attempt("update the TinyFish CLI", () => installTinyFishCli({ verbose })),
-            attempt("refresh the TinyFish web skill", () => {
-                refreshed = updateWebSkill({ verbose });
-            }),
+            scope === "skill"
+                ? undefined
+                : attempt("update the TinyFish CLI", () => installTinyFishCli({ verbose })),
+            scope === "cli"
+                ? undefined
+                : attempt("refresh the TinyFish web skill", () => {
+                    refreshed = updateWebSkill({ verbose });
+                }),
         ].filter((failure) => failure !== undefined);
         if (failures.length > 0)
             throw new Error(`tinyfish upgrade failed: ${failures.join("; ")}`);
@@ -49,7 +53,10 @@ export function runUpgrade(verbose = false) {
         return null;
     }
     const version = installedCliVersion();
-    const upToDate = version ? `TinyFish CLI ${version} is up to date.` : "TinyFish is up to date.";
+    // --skill-only never checked the CLI, so no versioned claim.
+    const upToDate = version && scope !== "skill"
+        ? `TinyFish CLI ${version} is up to date.`
+        : "TinyFish is up to date.";
     // Only a rewritten skill needs an agent restart.
     errLine(refreshed ? `${upToDate} Restart your agent to pick up the refreshed skill.` : upToDate);
     return version;
@@ -71,7 +78,7 @@ function globalCliVersion() {
     }
 }
 /** `runUpgrade` plus its outcome telemetry, which must never change what the upgrade does. */
-export async function runUpgradeCommand(verbose = false) {
+export async function runUpgradeCommand(verbose = false, scope = "both") {
     // This command is the upgrade, so a trailing "an update is available" would be noise.
     suppressNotice();
     let reported = false;
@@ -86,7 +93,7 @@ export async function runUpgradeCommand(verbose = false) {
             return;
         // Interrupted skips the read — racing the exit. Undercounts; see posthog-events.md.
         const toVersion = outcome === "interrupted" ? null : (printedVersion ?? installedCliVersion());
-        await sendUpgradeCompleted(CLI_VERSION, toVersion, outcome, resolvedApiKey());
+        await sendUpgradeCompleted(CLI_VERSION, toVersion, outcome, scope, resolvedApiKey());
     };
     const uninstallSignalGuard = installSignalGuard(async () => {
         errLine(INTERRUPTED_MESSAGE);
@@ -94,7 +101,7 @@ export async function runUpgradeCommand(verbose = false) {
     });
     let outcome = "updated";
     try {
-        printedVersion = runUpgrade(verbose);
+        printedVersion = runUpgrade(verbose, scope);
         if (process.exitCode === SIGNAL_EXIT_CODES.SIGINT)
             outcome = "interrupted";
     }
@@ -113,7 +120,13 @@ export function registerUpgrade(program) {
         .command("upgrade")
         .description("Update the TinyFish CLI and the use-tinyfish skill to the latest versions")
         .option("--verbose", "Print the full npm and skills output instead of only on failure")
+        .option("--cli-only", "Update only the TinyFish CLI, leaving the skill untouched")
+        .option("--skill-only", "Refresh only the use-tinyfish skill, leaving the CLI untouched")
         .action(async (options) => {
-        await runUpgradeCommand(Boolean(options.verbose));
+        if (options.cliOnly && options.skillOnly) {
+            throw new Error("Pass either --cli-only or --skill-only, not both.");
+        }
+        const scope = options.cliOnly ? "cli" : options.skillOnly ? "skill" : "both";
+        await runUpgradeCommand(Boolean(options.verbose), scope);
     });
 }

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

@@ -64,7 +64,9 @@ export declare const setupCompletedPayloadSchema: z.ZodObject<{
 export type SetupCompletedPayload = z.infer<typeof setupCompletedPayloadSchema>;
 export type HarnessResult = z.infer<typeof harnessResultSchema>;
 export type UpgradeOutcome = "updated" | "failed" | "interrupted";
+/** Step selection; "updated" means every selected step ran. */
+export type UpgradeScope = "both" | "cli" | "skill";
 /** `toVersion` is null when the run was interrupted or the installed version could not be read. */
-export declare function sendUpgradeCompleted(fromVersion: string, toVersion: string | null, outcome: UpgradeOutcome, apiKey?: string): Promise<void>;
+export declare function sendUpgradeCompleted(fromVersion: string, toVersion: string | null, outcome: UpgradeOutcome, scope: UpgradeScope, apiKey?: string): Promise<void>;
 export declare function sendSetupCompleted(mcpUrl: string, harnesses: HarnessResult[], apiKey?: string): Promise<void>;
 export {};

package/dist/lib/setup-telemetry.js

@@ -111,7 +111,7 @@ export const setupCompletedPayloadSchema = z.object({
     cli_version: z.string(),
 });
 /** `toVersion` is null when the run was interrupted or the installed version could not be read. */
-export async function sendUpgradeCompleted(fromVersion, toVersion, outcome, apiKey) {
+export async function sendUpgradeCompleted(fromVersion, toVersion, outcome, scope, apiKey) {
     await postConnectEvent({
         endpoint: new URL("/api/cli/connect-event", BASE_URL).toString(),
         body: JSON.stringify({
@@ -119,6 +119,7 @@ export async function sendUpgradeCompleted(fromVersion, toVersion, outcome, apiK
             from_version: fromVersion,
             to_version: toVersion,
             outcome,
+            scope,
         }),
         attempts: 1,
         label: "upgrade",

package/package.json

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