@tiny-fish/cli 0.1.4-next.40 → 0.1.4-next.43

package/README.md

@@ -88,6 +88,19 @@ tinyfish fetch content get https://agentql.com --links --image-links
 tinyfish fetch content get https://agentql.com --pretty
 ```
 
+### Browser
+
+```bash
+# Create a remote browser session
+tinyfish browser session create
+
+# Open a URL when the session starts
+tinyfish browser session create --url https://agentql.com
+
+# Human-readable output
+tinyfish browser session create --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.

package/dist/commands/browser.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerBrowser(program: Command): void;

package/dist/commands/browser.js

@@ -0,0 +1,41 @@
+import { getApiKey } from "../lib/auth.js";
+import { browserSessionCreate } from "../lib/client.js";
+import { handleApiError, out, outLine } from "../lib/output.js";
+function printPrettyBrowserSession(session) {
+    outLine("Browser session created");
+    outLine(`Session ID: ${session.session_id}`);
+    outLine(`CDP URL: ${session.cdp_url}`);
+    outLine(`Base URL: ${session.base_url}`);
+}
+export function registerBrowser(program) {
+    const browserCmd = program
+        .command("browser")
+        .description("Browser commands")
+        .enablePositionalOptions();
+    const sessionCmd = browserCmd
+        .command("session")
+        .description("Manage browser sessions")
+        .enablePositionalOptions();
+    sessionCmd
+        .command("create")
+        .description("Create a remote browser session")
+        .option("--url <value>", "Open a URL after session creation")
+        .option("--pretty", "Human-readable output")
+        .action(async (opts) => {
+        const apiKey = getApiKey();
+        try {
+            const response = await browserSessionCreate({
+                ...(opts.url !== undefined ? { url: opts.url } : {}),
+            }, apiKey);
+            if (opts.pretty) {
+                printPrettyBrowserSession(response);
+            }
+            else {
+                out(response);
+            }
+        }
+        catch (error) {
+            handleApiError(error);
+        }
+    });
+}

package/dist/index.js

@@ -4,6 +4,7 @@ import { Command } from "commander";
 import { registerAuth } from "./commands/auth.js";
 import { registerBatch } from "./commands/batch.js";
 import { registerFetch } from "./commands/fetch.js";
+import { registerBrowser } from "./commands/browser.js";
 import { registerRun } from "./commands/run.js";
 import { registerRuns } from "./commands/runs.js";
 import { registerSearch } from "./commands/search.js";
@@ -23,6 +24,7 @@ program
     }
 });
 registerAuth(program);
+registerBrowser(program);
 const agentCmd = program
     .command("agent")
     .description("Agent automation commands")

package/dist/lib/client.d.ts

@@ -1,4 +1,4 @@
-import { type AgentRunAsyncResponse, type AgentRunParams, type AgentRunResponse, type AgentRunWithStreamingResponse, type FetchGetContentsParams, type FetchResponse, type Run, type RunListParams, type RunListResponse, type SearchQueryParams, type SearchQueryResponse } from "@tiny-fish/sdk";
+import { type AgentRunAsyncResponse, type AgentRunParams, type AgentRunResponse, type AgentRunWithStreamingResponse, type FetchGetContentsParams, type FetchResponse, type BrowserSession, type BrowserSessionCreateParams, type Run, type RunListParams, type RunListResponse, type SearchQueryParams, type SearchQueryResponse } from "@tiny-fish/sdk";
 import type { BatchCancelResponse, BatchGetResponse, BatchRunRequest, BatchRunResponse, CancelRunResponse } from "./types.js";
 export declare function runSync(req: AgentRunParams, apiKey: string): Promise<AgentRunResponse>;
 export declare function runAsync(req: AgentRunParams, apiKey: string): Promise<AgentRunAsyncResponse>;
@@ -7,6 +7,7 @@ export declare function listRuns(opts: RunListParams, apiKey: string): Promise<R
 export declare function getRun(runId: string, apiKey: string): Promise<Run>;
 export declare function searchQuery(params: SearchQueryParams, apiKey: string): Promise<SearchQueryResponse>;
 export declare function fetchContentGet(params: FetchGetContentsParams, apiKey: string): Promise<FetchResponse>;
+export declare function browserSessionCreate(params: BrowserSessionCreateParams, apiKey: string): Promise<BrowserSession>;
 export declare function cancelRun(runId: string, apiKey: string): Promise<CancelRunResponse>;
 export declare function submitBatch(req: BatchRunRequest, apiKey: string): Promise<BatchRunResponse>;
 export declare function getBatchRuns(runIds: string[], apiKey: string): Promise<BatchGetResponse>;

package/dist/lib/client.js

@@ -1,4 +1,4 @@
-import { APIStatusError, fetchResponseSchema, searchQueryResponseSchema, TinyFish, runSchema, } from "@tiny-fish/sdk";
+import { APIStatusError, fetchResponseSchema, browserSessionSchema, searchQueryResponseSchema, TinyFish, runSchema, } from "@tiny-fish/sdk";
 import { BASE_URL } from "./constants.js";
 import { ApiError } from "./output.js";
 import { z } from "zod";
@@ -133,6 +133,15 @@ export async function fetchContentGet(params, apiKey) {
         rethrowSdkError(error);
     }
 }
+export async function browserSessionCreate(params, apiKey) {
+    try {
+        const response = await createSdkClient(apiKey).browser.sessions.create(params);
+        return browserSessionSchema.parse(response);
+    }
+    catch (error) {
+        rethrowSdkError(error);
+    }
+}
 export async function cancelRun(runId, apiKey) {
     try {
         const response = await createSdkClient(apiKey).post(`/v1/runs/${encodeURIComponent(runId)}/cancel`, { json: {} });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-fish/cli",
-  "version": "0.1.4-next.40",
+  "version": "0.1.4-next.43",
   "description": "TinyFish CLI — run web automations from your terminal",
   "type": "module",
   "bin": {
@@ -18,13 +18,14 @@
     "test:watch": "vitest",
     "test:integration:auth": "vitest --run --config vitest.integration.config.ts tests/auth.integration.test.ts",
     "test:integration:api:fetch": "vitest --run --passWithNoTests --config vitest.integration.config.ts tests/api.integration.test.ts --testNamePattern \"fetch content get|skips real API coverage when TINYFISH_API_KEY is not set\"",
+    "test:integration:api:browser": "vitest --run --passWithNoTests --config vitest.integration.config.ts tests/api.integration.test.ts --testNamePattern \"browser session create|skips real API coverage when TINYFISH_API_KEY is not set\"",
     "test:integration:api:search": "vitest --run --passWithNoTests --config vitest.integration.config.ts tests/api.integration.test.ts --testNamePattern \"search query|skips real API coverage when TINYFISH_API_KEY is not set\"",
     "test:integration:api:sync": "vitest --run --passWithNoTests --config vitest.integration.config.ts tests/api.integration.test.ts --testNamePattern \"agent run --sync|skips real API coverage when TINYFISH_API_KEY is not set\"",
     "test:integration:api:stream": "vitest --run --passWithNoTests --config vitest.integration.config.ts tests/api.integration.test.ts --testNamePattern \"agent run streaming exits cleanly after COMPLETE|skips real API coverage when TINYFISH_API_KEY is not set\"",
     "test:integration:api:async": "vitest --run --passWithNoTests --config vitest.integration.config.ts tests/api.integration.test.ts --testNamePattern \"agent run --async returns a run id that can be fetched and listed|skips real API coverage when TINYFISH_API_KEY is not set\"",
     "test:integration:api:cancel": "vitest --run --passWithNoTests --config vitest.integration.config.ts tests/api.integration.test.ts --testNamePattern \"agent run cancel cancels an in-flight run|skips real API coverage when TINYFISH_API_KEY is not set\"",
     "test:integration:api:batch": "vitest --run --passWithNoTests --config vitest.integration.config.ts tests/api.integration.test.ts --testNamePattern \"batch commands work end-to-end against the real API|skips real API coverage when TINYFISH_API_KEY is not set\"",
-    "test:integration": "npm run test:integration:auth && npm run test:integration:api:fetch && npm run test:integration:api:search && npm run test:integration:api:sync && npm run test:integration:api:stream && npm run test:integration:api:async && npm run test:integration:api:cancel && npm run test:integration:api:batch",
+    "test:integration": "npm run test:integration:auth && npm run test:integration:api:fetch && npm run test:integration:api:browser && npm run test:integration:api:search && npm run test:integration:api:sync && npm run test:integration:api:stream && npm run test:integration:api:async && npm run test:integration:api:cancel && npm run test:integration:api:batch",
     "lint": "eslint src tests",
     "format": "prettier --write src tests",
     "type-check": "tsc --noEmit --project tsconfig.all.json",
@@ -47,6 +48,7 @@
     "vitest": "^3.0.0"
   },
   "overrides": {
+    "vite": "7.3.2",
     "brace-expansion": "5.0.5"
   },
   "engines": {