@tiny-fish/cli 0.46.2-next.369 → 0.47.0

package/README.md

@@ -318,6 +318,20 @@ tinyfish browser session create --url https://agentql.com
 tinyfish browser session create --pretty
 ```
 
+By default the session uses the TinyFish residential proxy in the US, with one exit IP per session. To change that:
+
+```bash
+# Exit from another country (ISO 3166-1 alpha-2)
+tinyfish browser session create --proxy-country DE
+
+# Route through your own HTTP(S) proxy (password from env, never a flag)
+TINYFISH_PROXY_PASSWORD=<password> \
+  tinyfish browser session create --proxy-url http://proxy.example.com:8080 --proxy-username <user>
+
+# Connect directly, without a proxy
+tinyfish browser session create --no-proxy
+```
+
 ### Vault
 
 Connect a credential provider (1Password / Bitwarden), then have runs consume those credentials.

package/dist/commands/browser.js

@@ -11,6 +11,37 @@ function parseBrowserProfile(value) {
     err({ error: `Invalid --browser-profile "${value}". Must be one of: lite, stealth` });
     process.exit(1);
 }
+function exitWithError(message) {
+    err({ error: message });
+    process.exit(1);
+}
+// The proxy password comes from the environment so it stays out of shell history.
+function buildProxyConfig(opts) {
+    if (opts.proxy === false) {
+        if (opts.proxyCountry || opts.proxyUrl || opts.proxyUsername) {
+            exitWithError('--no-proxy cannot be combined with other --proxy-* flags');
+        }
+        return { enabled: false };
+    }
+    if (opts.proxyCountry && opts.proxyUrl) {
+        exitWithError('--proxy-country cannot be combined with --proxy-url');
+    }
+    if (opts.proxyUsername && !opts.proxyUrl) {
+        exitWithError('--proxy-username requires --proxy-url');
+    }
+    if (opts.proxyCountry)
+        return { country_code: opts.proxyCountry.toUpperCase() };
+    if (opts.proxyUrl) {
+        const password = process.env.TINYFISH_PROXY_PASSWORD;
+        return {
+            type: 'custom',
+            url: opts.proxyUrl,
+            ...(opts.proxyUsername ? { username: opts.proxyUsername } : {}),
+            ...(password ? { password } : {}),
+        };
+    }
+    return undefined;
+}
 function printPrettyBrowserSession(session) {
     outLine('Browser session created');
     outLine(`Session ID: ${session.session_id}`);
@@ -31,14 +62,20 @@ export function registerBrowser(program) {
         .description('Create a remote browser session')
         .option('--url <value>', 'Open a URL after session creation')
         .option('--browser-profile <profile>', 'Browser profile for execution (lite|stealth)')
+        .option('--proxy-country <code>', 'Exit country for the TinyFish proxy (ISO 3166-1 alpha-2, default US)')
+        .option('--proxy-url <url>', 'Route through your own HTTP(S) proxy (password via TINYFISH_PROXY_PASSWORD)')
+        .option('--proxy-username <user>', 'Username for --proxy-url')
+        .option('--no-proxy', 'Connect directly, without a proxy')
         .option('--pretty', 'Human-readable output')
         .action(async (opts) => {
         const apiKey = getApiKey();
         const browserProfile = parseBrowserProfile(opts.browserProfile);
+        const proxyConfig = buildProxyConfig(opts);
         try {
             const response = await browserSessionCreate({
                 ...(opts.url !== undefined ? { url: opts.url } : {}),
                 ...(browserProfile !== undefined ? { browser_profile: browserProfile } : {}),
+                ...(proxyConfig !== undefined ? { proxy_config: proxyConfig } : {}),
             }, apiKey);
             if (opts.pretty) {
                 printPrettyBrowserSession(response);

package/dist/lib/types.d.ts

@@ -91,9 +91,18 @@ export interface RunStepsResponse {
     status: RunStatus;
     steps: RunStep[];
 }
+export interface CliBrowserProxyConfig {
+    enabled?: boolean;
+    type?: 'tinyfish' | 'custom';
+    country_code?: string;
+    url?: string;
+    username?: string;
+    password?: string;
+}
 export interface CliBrowserSessionCreateParams {
     url?: string;
     browser_profile?: 'lite' | 'stealth';
+    proxy_config?: CliBrowserProxyConfig;
 }
 export interface CancelRunResponse {
     run_id: string;

package/package.json

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