Proxies for AI agents

import hashlib
import os
from urllib.parse import quote

import httpx

GATEWAY = {"US": "us", "DE": "eu", "GB": "eu"}  # Americas or Europe gateway


def proxy_for(run_id: str, country: str = "US", ttl: int = 30) -> str:
    """Proxy URL for one agent run: same session ID, same exit IP for the TTL."""
    sid = hashlib.sha256(run_id.encode()).hexdigest()[:8]  # letters and digits only
    user = quote(f"{os.environ['NETDASH_USERNAME']}-cc-{country}-session-{sid}-ttl-{ttl}", safe="")
    password = quote(os.environ["NETDASH_PASSWORD"], safe="")
    return f"http://{user}:{password}@scale-{GATEWAY[country]}.netdash.io:2000"


def fetch_page(url: str, run_id: str, country: str = "US") -> str:
    """Tool the agent calls. The model passes a URL; credentials stay in the environment."""
    with httpx.Client(proxy=proxy_for(run_id, country), timeout=30) as client:
        try:
            response = client.get(url, follow_redirects=True)
        except httpx.ProxyError as exc:  # e.g. 407: check the username syntax and password
            raise RuntimeError("netdash refused the proxy connection") from exc
        response.raise_for_status()
        return response.text


if __name__ == "__main__":
    print(fetch_page("https://api.ipify.org?format=json", run_id="run-2026-10-09-001"))

import { createHash } from "node:crypto";
import { chromium } from "playwright";

const GATEWAY = { US: "us", DE: "eu", GB: "eu" }; // Americas or Europe gateway

// One browser per agent run, kept on one exit IP by a sticky session.
export function browserForRun(runId, country = "US") {
  const sid = createHash("sha256").update(runId).digest("hex").slice(0, 8);
  return chromium.launch({
    proxy: {
      server: `http://scale-${GATEWAY[country]}.netdash.io:2000`,
      username: `${process.env.NETDASH_USERNAME}-cc-${country}-session-${sid}-ttl-30`,
      password: process.env.NETDASH_PASSWORD,
    },
  });
}

const browser = await browserForRun("run-2026-10-09-001");
const page = await browser.newPage();
await page.goto("https://api.ipify.org?format=json", { timeout: 30_000 });
console.log(await page.textContent("body"));
await browser.close();