Runs

# Starts the run and waits for it (up to 10 minutes), printing each status change.
# Exits non-zero unless the run completed. In an interactive terminal it first asks
# who presses the final submit — pass --autonomous or --confirm-before-submit to skip.
sente register https://app.example.com --autonomous

# Or return immediately and follow it yourself:
sente register https://app.example.com --no-wait   # → prints the run id
sente run run_8d9e0f1a2b3c4d5e6f708192a3b4c5d6     # status, error, live-view URL
sente run resume run_8d9e0f1a2b3c4d5e6f708192a3b4c5d6   # after a human cleared a block
sente run abort  run_8d9e0f1a2b3c4d5e6f708192a3b4c5d6   # stop it

import { Sente } from "@sente-labs/sdk";

const sente = new Sente({ apiKey: process.env.SENTE_API_TOKEN! });

// 1. Start it. No identityId — Sente provisions the backing email address itself.
const { registration, run } = await sente.registrations.register({
  appUrl: "https://app.example.com",
});

// 2. Follow it. Returns on completed | failed | blocked. `timeout` is MILLISECONDS.
let current = await sente.runs.waitForRun(run.id, { timeout: 300_000 });

// 3. blocked = a person is needed. Sente never works around the gate.
if (current.status === "blocked") {
  console.log(`needs a human (${current.error?.code}): ${current.liveViewUrl}`);
  // …a person clears the step in the live view, then:
  await sente.runs.resume(current.id);
  current = await sente.runs.waitForRun(current.id, { timeout: 300_000 });
}

// 4. Use the account.
if (current.status === "completed") {
  const creds = await sente.registrations.getCredentials(registration.id);
  console.log("ready:", registration.appUrl, creds.username);
} else {
  console.error("run", current.status, current.error?.code, current.error?.detail);
}

import os
from sente import Sente

sente = Sente(api_key=os.environ["SENTE_API_TOKEN"])

# 1. Start it. No identity_id — Sente provisions the backing email address itself.
registration, run = sente.registrations.register(app_url="https://app.example.com")

# 2. Follow it. Returns on completed | failed | blocked. `timeout` is SECONDS.
current = sente.runs.wait_for_run(run.id, timeout=300)

# 3. blocked = a person is needed. Sente never works around the gate.
if current.status == "blocked":
    print("needs a human (%s): %s" % (current.error["code"], current.live_view_url))
    # …a person clears the step in the live view, then:
    sente.runs.resume(current.id)
    current = sente.runs.wait_for_run(current.id, timeout=300)

# 4. Use the account.
if current.status == "completed":
    creds = sente.registrations.get_credentials(registration.id)
    print("ready:", registration.app_url, creds["username"])
else:
    print("run", current.status, current.error)