@tiny-fish/cli 0.1.2 → 0.1.3-next.17

package/README.md

@@ -0,0 +1,87 @@
+# TinyFish CLI
+
+Run web automations from your terminal, shell scripts, and CI/CD pipelines.
+
+## Installation
+
+```bash
+npm install -g @tiny-fish/cli
+```
+
+Requires Node.js 24+.
+
+## Authentication
+
+Get your API key from [agent.tinyfish.ai](https://agent.tinyfish.ai).
+
+```bash
+# Interactive (opens browser, prompts for key)
+tinyfish auth login
+
+# CI/CD safe (pipe key via stdin)
+echo $TINYFISH_API_KEY | tinyfish auth set
+
+# Or set via environment variable
+export TINYFISH_API_KEY=sk-tinyfish-...
+```
+
+## Usage
+
+### Run an automation
+
+```bash
+# Stream steps as they happen (default)
+tinyfish agent run "Find the pricing page" --url https://example.com
+
+# Human-readable output
+tinyfish agent run "Find the pricing page" --url https://example.com --pretty
+
+# Wait for result without streaming
+tinyfish agent run "Find the pricing page" --url https://example.com --sync
+
+# Submit and return immediately (don't wait)
+tinyfish agent run "Find the pricing page" --url https://example.com --async
+```
+
+### Manage runs
+
+```bash
+# List recent runs
+tinyfish agent run list --pretty
+
+# Filter by status
+tinyfish agent run list --status RUNNING --pretty
+
+# Inspect a run
+tinyfish agent run get <run_id> --pretty
+
+# Cancel a run
+tinyfish agent run cancel <run_id> --pretty
+```
+
+### Output format
+
+By default all commands output newline-delimited JSON to stdout — pipe-friendly for agents and scripts. Add `--pretty` for human-readable output.
+
+Errors are JSON to stderr with exit code 1. Ctrl+C during a streaming run cancels it automatically.
+
+### Debug
+
+```bash
+TINYFISH_DEBUG=1 tinyfish agent run "..." --url https://example.com
+# or
+tinyfish --debug agent run "..." --url https://example.com
+```
+
+## CI/CD
+
+```yaml
+- name: Run automation
+  env:
+    TINYFISH_API_KEY: ${{ secrets.TINYFISH_API_KEY }}
+  run: |
+    tinyfish agent run "Check that the login flow works" \
+      --url https://staging.example.com \
+      --sync \
+      --pretty
+```

package/dist/lib/client.js

@@ -2,9 +2,11 @@ import { BASE_URL } from "./constants.js";
 import { ApiError } from "./output.js";
 const API_TIMEOUT_MS = 30_000;
 // ── Debug logging ─────────────────────────────────────────────────────────────
-const DEBUG_ENABLED = /^(1|true)$/i.test(process.env["TINYFISH_DEBUG"] ?? "");
+function isDebugEnabled() {
+    return /^(1|true)$/i.test(process.env["TINYFISH_DEBUG"] ?? "");
+}
 function debugLog(msg) {
-    if (DEBUG_ENABLED) {
+    if (isDebugEnabled()) {
         process.stderr.write(`[debug] ${msg}\n`);
     }
 }

package/dist/lib/constants.js

@@ -1,5 +1,19 @@
-/** Base URL for the TinyFish API. Override with TINYFISH_API_URL for staging/self-hosted. */
+/** Base URL for the TinyFish API. Override with TINYFISH_API_URL for staging/self-hosted (must be https). */
 const apiUrlOverride = process.env["TINYFISH_API_URL"]?.trim();
+if (apiUrlOverride) {
+    let parsed;
+    try {
+        parsed = new URL(apiUrlOverride);
+    }
+    catch {
+        process.stderr.write("Error: TINYFISH_API_URL must be a valid https URL\n");
+        process.exit(1);
+    }
+    if (parsed.protocol !== "https:") {
+        process.stderr.write(`Error: TINYFISH_API_URL must use https:// (got protocol "${parsed.protocol || "unknown"}")\n`);
+        process.exit(1);
+    }
+}
 export const BASE_URL = apiUrlOverride || "https://agent.tinyfish.ai";
 /** URL where users can create and manage API keys */
 export const DASHBOARD_URL = `${BASE_URL}/api-keys`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tiny-fish/cli",
-  "version": "0.1.2",
-  "description": "TinyFish CLI \u2014 run web automations from your terminal",
+  "version": "0.1.3-next.17",
+  "description": "TinyFish CLI — run web automations from your terminal",
   "type": "module",
   "bin": {
     "tinyfish": "./dist/index.js"
@@ -39,7 +39,6 @@
     "node": ">=24.0.0"
   },
   "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "restricted"
+    "registry": "https://registry.npmjs.org/"
   }
 }