iPhone Safari browsers in the cloud.

Describe the task in plain words. The AI plans each step, runs it, and sends back its answer.

import { Driftstack } from '@driftstack/sdk';

const ds = new Driftstack({ apiKey: process.env.DRIFTSTACK_API_KEY! });

// Every session goes out through one of your saved proxies.
let session = await ds.agentSessions.create({ proxy_id: process.env.DRIFTSTACK_PROXY_ID! });

try {
  // Wait up to two minutes for its browser to start.
  for (let i = 0; session.ready === false && i < 60; i++) {
    if (session.status === 'closed') throw new Error('The session did not start');
    await new Promise((resolve) => setTimeout(resolve, 2_000));
    session = await ds.agentSessions.get(session.id);
  }

  // Say what you want. The AI plans the steps and runs them;
  // the call returns when its turn ends.
  const reply = await ds.agentSessions.message(
    session.id,
    'Open https://books.toscrape.com, go to the Travel category ' +
      'and tell me the cheapest book there and its price.',
    { onStep: ({ index, result }) => console.log('step', index + 1, result.kind) },
  );

  // A turn that stops early (a limit, or a question for you) carries a notice.
  if (reply.kind !== 'plan-executed' || reply.notice !== undefined || reply.answer === undefined) {
    throw new Error('The task did not finish');
  }
  console.log(reply.answer);
} finally {
  await ds.agentSessions.close(session.id);
}

Up to 8 steps you write, run exactly as written. No AI, and none of the AI budget used.

import { Driftstack } from '@driftstack/sdk';

const ds = new Driftstack({ apiKey: process.env.DRIFTSTACK_API_KEY! });

let session = await ds.agentSessions.create({ proxy_id: process.env.DRIFTSTACK_PROXY_ID! });

try {
  // Wait up to two minutes for its browser to start.
  for (let i = 0; session.ready === false && i < 60; i++) {
    if (session.status === 'closed') throw new Error('The session did not start');
    await new Promise((resolve) => setTimeout(resolve, 2_000));
    session = await ds.agentSessions.get(session.id);
  }

  // Open a page, type, tap, wait, read: each step runs as written.
  const run = await ds.agentSessions.runSteps(session.id, [
    { kind: 'navigate', url: 'https://quotes.toscrape.com/login' },
    { kind: 'interact', action: 'type', selector: '#username', value: 'demo' },
    { kind: 'interact', action: 'type', selector: '#password', value: 'demo', sensitive: true },
    { kind: 'interact', action: 'tap', selector: 'input[type="submit"]' },
    { kind: 'wait', condition: 'selector_visible', selector: 'a[href$="logout"]' },
    { kind: 'extract', selector: '.quote .text' },
  ]);

  const quote = run.kind === 'plan-executed' && run.ok ? run.results.at(-1) : undefined;
  if (quote?.kind !== 'success') throw new Error('A step failed');
  console.log(quote.summary); // the first quote on the signed-in page
} finally {
  await ds.agentSessions.close(session.id);
}

A profile is one saved iPhone. Every session you start with it is that same device, with its cookies and logins.

import { Driftstack } from '@driftstack/sdk';

const ds = new Driftstack({ apiKey: process.env.DRIFTSTACK_API_KEY! });

// Save an iPhone once. The device is chosen for you unless you name one.
const profile = await ds.profiles.create({ name: 'Example shop account' });

try {
  // Start sessions as this iPhone with
  // agentSessions.create({ profile_id: profile.id, proxy_id }).
  const saved = await ds.profiles.get(profile.id);
  console.log(saved.name, 'runs as', saved.archetype);
} finally {
  // This example cleans up after itself; yours would keep the profile.
  await ds.profiles.delete(profile.id);
}