Register a new account

sente register https://app.example.com/signup --autonomous
# Run it in a terminal without --autonomous / --confirm-before-submit and it asks which submit mode
# you want. In scripts and CI always pass one explicitly (non-TTY defaults to autonomous).
#
# The CLI waits for the run and exits non-zero unless it completed; a blocked run prints its
# live-view URL and `sente run resume <runId>`.

sente credentials <registrationId>   # → the vaulted username / password / origin

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

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

// No identityId — the account's email address is provisioned from the app's hostname.
const { registration, run } = await sente.registrations.register({
  appUrl: "https://app.example.com/signup",
  // credentials: { username: "acme-bot" },   // optional; password is generated if omitted
});

const settled = await sente.runs.waitForRun(run.id);   // timeout in ms, default 180000
if (settled.status === "blocked") {
  // A person clears the one step at settled.liveViewUrl, then:
  //   await sente.runs.resume(run.id);
  throw new Error(`${settled.error?.code}: a human is needed at ${settled.liveViewUrl}`);
}
if (settled.status !== "completed") throw new Error(`register failed: ${settled.error?.code}`);

const creds = await sente.registrations.getCredentials(registration.id);
// { username, password, origin: "generated" | "supplied" }

import os
from sente import Sente

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

# No identity_id — the account's email address is provisioned from the app's hostname.
registration, run = sente.registrations.register(
    app_url="https://app.example.com/signup",
    # credentials={"username": "acme-bot"},   # optional; password is generated if omitted
)

settled = sente.runs.wait_for_run(run.id)              # timeout in SECONDS, default 180
if settled.status == "blocked":
    # A person clears the one step at settled.live_view_url, then:
    #   sente.runs.resume(run.id)
    raise RuntimeError(f"{settled.error['code']}: a human is needed at {settled.live_view_url}")
if settled.status != "completed":
    raise RuntimeError(f"register failed: {settled.error}")

creds = sente.registrations.get_credentials(registration.id)
# { "username": ..., "password": ..., "origin": "generated" | "supplied" }

sente register https://app.example.com/signup --confirm-before-submit
# → blocked (SUBMIT_CONFIRMATION_REQUIRED)
#   live view: https://…      ← open it, click submit
#   resume:    sente run resume <runId>
sente run resume <runId>

const { run } = await sente.registrations.register({
  appUrl: "https://app.example.com/signup",
  confirmBeforeSubmit: true,
});

const settled = await sente.runs.waitForRun(run.id);
if (settled.status === "blocked" && settled.error?.code === "SUBMIT_CONFIRMATION_REQUIRED") {
  console.log("click submit here:", settled.liveViewUrl);
  // …after the human has clicked it:
  await sente.runs.resume(run.id);
  const done = await sente.runs.waitForRun(run.id);
}

registration, run = sente.registrations.register(
    app_url="https://app.example.com/signup",
    confirm_before_submit=True,
)

settled = sente.runs.wait_for_run(run.id)
if settled.status == "blocked" and settled.error["code"] == "SUBMIT_CONFIRMATION_REQUIRED":
    print("click submit here:", settled.live_view_url)
    # …after the human has clicked it:
    sente.runs.resume(run.id)
    done = sente.runs.wait_for_run(run.id)