npm i @agentgo-dev/sdk

import { AgentGo } from '@agentgo-dev/sdk';

const client = new AgentGo({
  apiKey: 'your_api_key_here',
});

async function example() {
  // Create a new browser session
  const session = await client.sessions.create({
    region: 'US',
    keepAlive: true,
  });

  console.log('Session created:', session.id);
  console.log('Connection URL:', session.connectionUrl);

  // List all sessions
  const sessions = await client.sessions.list({
    status: 'IDLE',
    limit: 10,
  });

  console.log('Active sessions:', sessions.sessions.length);

  // Get session details
  const sessionDetails = await client.sessions.retrieve(session.id);
  console.log('Session status:', sessionDetails.status);
}

example().catch(console.error);

const { AgentGo } = require('@agentgo-dev/sdk');

const client = new AgentGo({
  apiKey: 'your_api_key_here',
});

client.sessions
  .create({
    region: 'US',
    keepAlive: true,
  })
  .then((session) => {
    console.log('Session created:', session.id);
  })
  .catch(console.error);

// 1. Constructor option
const client = new AgentGo({
  apiKey: 'your_api_key_here',
});

// 2. Environment variable
// Set AGENTGO_API_KEY=your_api_key_here
const client = new AgentGo();

// 3. Configuration object
const client = new AgentGo({
  apiKey: 'your_api_key_here',
  baseURL: 'https://session.browsers.live', // optional
  timeout: 30000, // optional
  maxRetries: 3, // optional
});

const session = await client.sessions.create({
  region?: 'US',           // Geographic region
  keepAlive?: true         // Prevent 30-second timeout
});

const sessions = await client.sessions.list({
  status?: 'IDLE',         // Filter by status (IDLE/RUNNING/EXPIRED)
  region?: 'US',           // Filter by region
  limit?: 20,              // Max results (1-100)
});

const session = await client.sessions.retrieve('session-id');

import { AgentGo, AgentGoError } from '@agentgo-dev/sdk';

try {
  const session = await client.sessions.create({
    region: 'INVALID_REGION',
  });
} catch (error) {
  if (error instanceof AgentGoError) {
    console.log('Error type:', error.type);
    console.log('Error message:', error.message);
    console.log('Status code:', error.status);
  }
}

import { AgentGo, Session, SessionCreateParams } from '@agentgo-dev/sdk';

const client = new AgentGo({ apiKey: 'your_api_key_here' });

const params: SessionCreateParams = {
  region: 'US',
  keepAlive: true,
};

const session: Session = await client.sessions.create(params);