@simular-ai/sai-sdk 0.0.0-stage → 0.1.0-alpha.2

package/dist/sessions.js

@@ -0,0 +1,378 @@
+/**
+ * Sessions: a conversation with Sai on one computer. Sai decides every click.
+ *
+ * Maps to `/v1/agents/*`: `new-session`, `message` (wait=false), `events`,
+ * `approve`, `abort`. Every message gets a turn id (`turn.id`, read with
+ * `sai.turns`); a message with `inputs`, `outputSchema` or `successCriteria`
+ * is structured and its turn also returns a typed result.
+ */
+import { ConflictError, LinkOnlyApprovalError, NotFoundError, RateLimitError } from './errors.js';
+import { idOf } from './machines.js';
+import { parseApproval, parseEvent, parseTurnRecord, parseUsage, } from './types.js';
+const POLL_WAIT = 30;
+/** Between turn reads; `GET /v1/agents/turns/{id}` never holds. */
+const RECORD_POLL_INTERVAL_MS = 2_000;
+export class Sessions {
+    http;
+    machines;
+    constructor(http, machines) {
+        this.http = http;
+        this.machines = machines;
+    }
+    /**
+     * Start a fresh conversation on a computer: the next message has no memory
+     * of earlier ones. `machine` may be omitted with one computer.
+     */
+    async create(opts = {}) {
+        const machineId = await this.machines.resolveId(opts.machine);
+        let sessionId = null;
+        try {
+            const d = await this.http.json('POST', '/v1/agents/new-session', {
+                json: { machineId, channel: 'api' },
+            });
+            sessionId = d.sessionId ?? null;
+        }
+        catch (err) {
+            // A free account's computer between claims has no conversation to
+            // rotate; the first message starts one.
+            if (!(err instanceof NotFoundError))
+                throw err;
+        }
+        return new Session(this.http, machineId, sessionId);
+    }
+    /** Reattach to a session started elsewhere, e.g. to poll or abort it. */
+    resume(sessionId, opts = {}) {
+        return new Session(this.http, opts.machine ? idOf(opts.machine) : null, sessionId);
+    }
+}
+/** A conversation with Sai. Each `send()` is a turn; turns share context. */
+export class Session {
+    http;
+    machineId;
+    id;
+    constructor(http, machineId, id) {
+        this.http = http;
+        this.machineId = machineId;
+        this.id = id;
+    }
+    /**
+     * Give Sai a task, or steer the running one. Returns at once. Sent while a
+     * turn is running, the message steers that turn (`turn.queued` is true).
+     *
+     * Any of `inputs`, `outputSchema` or `successCriteria` makes the message
+     * structured: the message is a template whose `{{name}}` placeholders are
+     * filled from `inputs`, the output must match `outputSchema`, and the turn
+     * is checked against `successCriteria`. `wait()` then also returns the
+     * turn's record in `result.record`. A structured message is refused with
+     * `ConflictError` (`session_busy`) while a turn is running. These go to the
+     * API as `options`.
+     */
+    async send(message, opts = {}) {
+        const body = { message, wait: false };
+        if (this.machineId)
+            body.machineId = this.machineId;
+        if (this.id)
+            body.sessionId = this.id;
+        if (opts.model)
+            body.model = opts.model;
+        if (opts.attachments?.length)
+            body.attachments = opts.attachments.map((a) => a.raw);
+        if (opts.autonomous)
+            body.autonomous = true;
+        const options = {};
+        if (opts.inputs !== undefined)
+            options.inputs = opts.inputs;
+        if (opts.outputSchema !== undefined)
+            options.output_schema = opts.outputSchema;
+        if (opts.successCriteria !== undefined)
+            options.success_criteria = opts.successCriteria;
+        if (opts.idempotencyKey !== undefined)
+            options.idempotency_key = opts.idempotencyKey;
+        if (opts.recordTrajectory)
+            options.recordTrajectory = true;
+        if (Object.keys(options).length)
+            body.options = options;
+        const structured = [opts.inputs, opts.outputSchema, opts.successCriteria].some((v) => v !== undefined);
+        const d = await this.http.json('POST', '/v1/agents/message', {
+            json: body,
+        });
+        if (d.idempotent_replay) {
+            // The key was used before: this is that turn, and nothing was sent.
+            const record = parseTurnRecord(d);
+            this.id = record.sessionId ?? this.id;
+            this.machineId = record.machineId || this.machineId;
+            return new Turn(this, this.http, false, null, { id: record.id, structured, replay: record });
+        }
+        if (typeof d.sessionId !== 'string' || !d.sessionId) {
+            // Handled without starting a task (e.g. a plain acknowledgement): the reply is in `reply`,
+            // or in `error` on servers before `reply` existed.
+            const text = typeof d.reply === 'string' ? d.reply : typeof d.error === 'string' ? d.error : '';
+            return new Turn(this, this.http, false, localResult(this.id ?? '', text));
+        }
+        this.id = d.sessionId;
+        if (typeof d.machineId === 'string')
+            this.machineId = d.machineId;
+        const id = typeof d.turnId === 'string' ? d.turnId : null;
+        return new Turn(this, this.http, Boolean(d.queued), null, { id, structured });
+    }
+    /** `send()` then `wait()`: the answer, or where it stopped. */
+    async run(message, opts = {}) {
+        const turn = await this.send(message, opts);
+        return turn.wait(opts);
+    }
+    /** Stop the running turn. Pending approvals are denied. False if nothing was running. */
+    async abort() {
+        if (!this.id)
+            return false;
+        const d = await this.http.json('POST', '/v1/agents/abort', {
+            json: { sessionId: this.id },
+        });
+        return Boolean(d.aborted);
+    }
+    /**
+     * Answer an approval: `yes`, `no`, or `task` (allow for the rest of the task).
+     * A `choice` approval needs `selections`, one list of option values per
+     * question. Throws `LinkOnlyApprovalError` (with `approvalUrl`) when only a
+     * browser can answer it. Resolves to `approved`, `approved_task` or `denied`.
+     */
+    async respond(approval, response = 'yes', opts = {}) {
+        if (typeof approval !== 'string' && approval.isLinkOnly) {
+            throw new LinkOnlyApprovalError('This approval must be completed in a browser. Open approval.url.', { status: 409, code: 'link_only', body: { approvalUrl: approval.url } });
+        }
+        const body = {
+            approvalId: typeof approval === 'string' ? approval : approval.id,
+            response,
+        };
+        if (opts.selections)
+            body.selections = opts.selections;
+        const d = await this.http.json('POST', '/v1/agents/approve', {
+            json: body,
+        });
+        return d.status ?? '';
+    }
+}
+/**
+ * One message's work. Iterate `events()` to watch it, or `wait()` for the
+ * result. `id` is the turn the message started, or the running turn it joined
+ * (`sai.turns.get(turn)`); null when the message was answered without one.
+ */
+export class Turn {
+    session;
+    http;
+    queued;
+    id;
+    cursor = null;
+    last;
+    structured;
+    replay;
+    // answered without starting a task, or an idempotent replay: no events to poll
+    local;
+    constructor(session, http, queued, done = null, turn = {
+        id: null,
+        structured: false,
+    }) {
+        this.session = session;
+        this.http = http;
+        this.queued = queued;
+        this.last = done;
+        this.id = turn.id;
+        this.structured = turn.structured;
+        this.replay = turn.replay ?? null;
+        this.local = done !== null || this.replay !== null;
+    }
+    get status() {
+        return this.last?.status ?? 'running';
+    }
+    /** The last known state, or null before the first poll. */
+    get result() {
+        return this.last;
+    }
+    /**
+     * Yield events until the turn is idle or errors. It keeps going through
+     * `needs_approval`: answer with `turn.respond(ev.approval, ...)` inside the
+     * loop, or let a human answer a link-only approval in a browser. Without
+     * `raw`, framing, reasoning and tool-call frames are skipped.
+     */
+    async *events(opts = {}) {
+        if (this.local)
+            return;
+        for (;;) {
+            const page = await this.#poll(opts.pollWait ?? POLL_WAIT);
+            for (const e of page.events ?? []) {
+                const ev = parseEvent(e);
+                if (opts.raw || ev.kind !== 'other')
+                    yield ev;
+            }
+            if (page.status === 'idle' || page.status === 'error')
+                return;
+        }
+    }
+    /**
+     * Wait until the turn is done, or stops on an approval nobody answered.
+     * Without `onApproval`, resolves with `status === 'needs_approval'` and the
+     * `approval` so the caller can decide. With it, the handler's answer is sent
+     * and waiting continues; a handler returning null leaves the approval to
+     * someone else (a link-only one to a human) and keeps waiting. For a
+     * structured message, it then waits for the turn's record (`result.record`:
+     * output, evidence), which is worked out after the turn.
+     */
+    async wait(opts = {}) {
+        const deadline = opts.timeoutMs === undefined ? null : Date.now() + opts.timeoutMs;
+        if (this.replay) {
+            const record = this.replay.done
+                ? this.replay
+                : await waitTurnRecord(this.http, this.replay.id, deadline);
+            this.last = replayResult(record, record.sessionId ?? this.session.id ?? '');
+            return this.last;
+        }
+        if (this.local)
+            return this.last;
+        const answered = new Set();
+        for (;;) {
+            let pollWait = opts.pollWait ?? POLL_WAIT;
+            if (deadline !== null) {
+                const left = deadline - Date.now();
+                if (left <= 0) {
+                    throw new DOMException(`Turn still ${this.status} after ${opts.timeoutMs}ms (session ${this.session.id}).`, 'TimeoutError');
+                }
+                pollWait = Math.max(1, Math.min(pollWait, Math.floor(left / 1000)));
+            }
+            const page = await this.#poll(pollWait);
+            if (page.status === 'idle' || page.status === 'error') {
+                if (this.structured && this.id) {
+                    this.last = withRecord(this.last, await waitTurnRecord(this.http, this.id, deadline));
+                }
+                return this.last;
+            }
+            const approval = this.last?.approval;
+            if (page.status !== 'needs_approval' || !approval)
+                continue;
+            if (!opts.onApproval)
+                return this.last;
+            if (answered.has(approval.id))
+                continue;
+            const answer = await opts.onApproval(approval);
+            answered.add(approval.id);
+            if (answer === null)
+                continue;
+            const [response, selections] = typeof answer === 'string' ? [answer, undefined] : answer;
+            try {
+                await this.session.respond(approval, response, { selections });
+            }
+            catch (err) {
+                // answered elsewhere or expired; the next poll shows the new state
+                if (!(err instanceof ConflictError))
+                    throw err;
+            }
+        }
+    }
+    respond(approval, response = 'yes', opts = {}) {
+        return this.session.respond(approval, response, opts);
+    }
+    abort() {
+        return this.session.abort();
+    }
+    async #poll(wait) {
+        let page;
+        for (;;) {
+            try {
+                page = await this.http.json('GET', '/v1/agents/events', {
+                    params: { sessionId: this.session.id ?? '', wait, since: this.cursor ?? undefined },
+                    timeoutMs: (wait + 30) * 1000,
+                });
+                break;
+            }
+            catch (err) {
+                if (!(err instanceof RateLimitError))
+                    throw err;
+                await new Promise((r) => setTimeout(r, (err.retryAfter ?? 30) * 1000));
+            }
+        }
+        this.cursor = page.cursor ?? this.cursor;
+        let error = this.last?.error ?? null;
+        let errorCode = this.last?.errorCode ?? null;
+        for (const e of page.events ?? []) {
+            if (e.type === 'error') {
+                error = typeof e.errorText === 'string' ? e.errorText : error;
+                errorCode = typeof e.code === 'string' ? e.code : errorCode;
+            }
+        }
+        const status = page.status ?? 'running';
+        this.last = {
+            status,
+            text: page.text ?? '',
+            sessionId: page.sessionId ?? this.session.id ?? '',
+            approval: page.approval ? parseApproval(page.approval) : null,
+            error,
+            errorCode,
+            usage: parseUsage(page.usage),
+            sessionUsage: parseUsage(page.sessionUsage),
+            record: null,
+            ok: status === 'idle',
+        };
+        return page;
+    }
+}
+/**
+ * Read the turn's record until its status is in `stop`. Throws a `TimeoutError`
+ * (DOMException) past `deadline` (epoch ms).
+ */
+export async function waitTurnRecord(http, turnId, deadline, stop = ['succeeded', 'failed']) {
+    for (;;) {
+        let record;
+        try {
+            record = parseTurnRecord(await http.json('GET', `/v1/agents/turns/${encodeURIComponent(turnId)}`));
+        }
+        catch (err) {
+            if (!(err instanceof RateLimitError))
+                throw err;
+            await sleep((err.retryAfter ?? 30) * 1000);
+            continue;
+        }
+        if (stop.includes(record.status))
+            return record;
+        if (deadline !== null && Date.now() + RECORD_POLL_INTERVAL_MS > deadline) {
+            throw new DOMException(`Turn ${turnId} still ${record.status}.`, 'TimeoutError');
+        }
+        await sleep(RECORD_POLL_INTERVAL_MS);
+    }
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function withRecord(result, record) {
+    return { ...result, record, ok: result.status === 'idle' && record.ok };
+}
+// A turn that failed for these reasons still has the agent's answer; the turn itself did not break.
+const ANSWERED_REASONS = ['output_invalid', 'criteria_not_met', 'criteria_unchecked'];
+/** The result the live path would have returned for this finished turn, from its record. */
+function replayResult(record, sessionId) {
+    const result = localResult(sessionId, record.rawAnswer || outputText(record.output));
+    if (record.status === 'failed' && !ANSWERED_REASONS.includes(record.reasonCode ?? '')) {
+        result.status = 'error';
+        result.text = '';
+        result.error = record.rawAnswer || `The turn failed (${record.reasonCode ?? 'unknown'}).`;
+        result.errorCode = record.errorCode;
+    }
+    result.usage = record.usage;
+    return withRecord(result, record);
+}
+/** `output` as text: a plain message's answer as is, an `outputSchema` object as JSON. */
+function outputText(output) {
+    if (output === null || output === undefined)
+        return '';
+    return typeof output === 'string' ? output : JSON.stringify(output);
+}
+function localResult(sessionId, text) {
+    return {
+        status: 'idle',
+        text,
+        sessionId,
+        approval: null,
+        error: null,
+        errorCode: null,
+        usage: null,
+        sessionUsage: null,
+        record: null,
+        ok: true,
+    };
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"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"}

package/dist/tenants.d.ts

@@ -0,0 +1,102 @@
+import type { Sai } from './client.js';
+import type { Credential, Http } from './http.js';
+import { type Enrollment, type Tenant, type TenantMachine, type TenantPage, type TenantToken } from './types.js';
+export type TenantRef = Tenant | string;
+export type TenantMachineRef = TenantMachine | string;
+/** `tenants.client()` exchanges again when its token has less than this left. */
+export declare const TOKEN_REFRESH_MARGIN_MS: number;
+/** Tenants: your customers, under an Organisation. Every call takes an Organisation Key. */
+export declare class Tenants {
+    private readonly http;
+    private readonly orgId;
+    private readonly withCredential;
+    constructor(http: Http, orgId: string | undefined, withCredential: (credential: Credential) => Sai);
+    /** `externalId` is your id for the customer, unique in the Organisation, and cannot change later. */
+    create(name: string, opts?: {
+        externalId?: string;
+        metadata?: Record<string, string>;
+    }): Promise<Tenant>;
+    /**
+     * One page, newest first. `externalId` finds the Tenant with that id (zero or one) and
+     * cannot be combined with `status`.
+     */
+    list(opts?: {
+        status?: string;
+        externalId?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<TenantPage>;
+    get(tenant: TenantRef): Promise<Tenant>;
+    /**
+     * `metadata` replaces the whole map. `status: 'disabled'` stops the Tenant's tokens and
+     * machines; `status: 'active'` brings it back.
+     *
+     * `cloudMachineLimit` (0 to 1000) caps the Tenant's cloud machines; `null` removes the cap.
+     * Lowering it deletes nothing: creates are refused until the count fits. `residentialProxy`
+     * is the Tenant's residential proxy switch; it has no effect yet, and traffic goes direct.
+     * Only the Organisation Key or an owner may set these two.
+     */
+    update(tenant: TenantRef, opts: {
+        name?: string;
+        metadata?: Record<string, string>;
+        status?: string;
+        cloudMachineLimit?: number | null;
+        residentialProxy?: boolean;
+    }): Promise<Tenant>;
+    /**
+     * Disables the Tenant and revokes every enrolled machine. Cloud machines stay and hibernate:
+     * delete them with `tenantMachines.delete`. Its data is kept: erase it from the console.
+     */
+    delete(tenant: TenantRef): Promise<void>;
+    /** A single-use code that enrolls one computer into the Tenant. It expires in 15 minutes. */
+    createEnrollment(tenant: TenantRef): Promise<Enrollment>;
+    /**
+     * Exchange the Organisation Key for a one-hour token that acts as the Tenant. `orgId`
+     * defaults to the client's `orgId` (`SAI_ORG_ID`).
+     */
+    token(tenant: TenantRef, opts?: {
+        orgId?: string;
+    }): Promise<TenantToken>;
+    /**
+     * A client that acts as the Tenant. It exchanges a token now, and again before a request
+     * when the token has less than five minutes left. Uses this client's Organisation Key.
+     */
+    client(tenant: TenantRef, opts?: {
+        orgId?: string;
+    }): Promise<Sai>;
+}
+/** A Tenant's computers, enrolled and cloud. Every call takes an Organisation Key. */
+export declare class TenantMachines {
+    private readonly http;
+    constructor(http: Http);
+    /**
+     * Create a cloud machine for the Tenant. `os` is `windows` or `linux`; the size follows it.
+     * `name` (up to 64 characters) is a label you show your users.
+     *
+     * `requestId` (letters, digits, `_` and `-`, up to 128) makes a retry safe: the same id and
+     * body return the first machine, and the same id with another body throws `ConflictError`
+     * (`request_id_reused`). Without one, every call creates a machine.
+     *
+     * Returns at once with `state: 'provisioning'`. `wait: true` reads the machine until it is
+     * `ready`; it throws `SaiError` if the machine fails or is deleted, and a `TimeoutError`
+     * (DOMException) after `timeoutMs` (default 10 minutes).
+     */
+    create(tenant: TenantRef, opts: {
+        os: 'windows' | 'linux';
+        name?: string;
+        requestId?: string;
+        wait?: boolean;
+        timeoutMs?: number;
+    }): Promise<TenantMachine>;
+    /** Both kinds, enrolled and cloud. A cloud machine is listed from the moment it is created. */
+    list(tenant: TenantRef): Promise<TenantMachine[]>;
+    get(tenant: TenantRef, machineId: string): Promise<TenantMachine>;
+    /**
+     * An enrolled machine is signed out at once (`'revoked'`); enroll it again with a new code to
+     * bring it back. A cloud machine is deleted with its disk (`'deleting'`), which cannot be
+     * undone; it leaves the list when the deletion finishes.
+     */
+    delete(tenant: TenantRef, machine: TenantMachineRef): Promise<'revoked' | 'deleting'>;
+    /** `delete` without its answer. On a cloud machine it deletes the machine: use `delete`. */
+    revoke(tenant: TenantRef, machine: TenantMachineRef): Promise<void>;
+}

package/dist/tenants.js

@@ -0,0 +1,157 @@
+import { RateLimitError, SaiError } from './errors.js';
+import { parseEnrollment, parseTenant, parseTenantMachine, parseTenantToken, } from './types.js';
+/** `tenants.client()` exchanges again when its token has less than this left. */
+export const TOKEN_REFRESH_MARGIN_MS = 5 * 60 * 1000;
+/** Between machine reads while `tenantMachines.create({ wait: true })` waits. */
+const MACHINE_POLL_INTERVAL_MS = 5_000;
+const q = encodeURIComponent;
+const tenantPath = (tenant) => `/v1/tenants/${q(typeof tenant === 'string' ? tenant : tenant.id)}`;
+/** Tenants: your customers, under an Organisation. Every call takes an Organisation Key. */
+export class Tenants {
+    http;
+    orgId;
+    withCredential;
+    constructor(http, orgId, withCredential) {
+        this.http = http;
+        this.orgId = orgId;
+        this.withCredential = withCredential;
+    }
+    /** `externalId` is your id for the customer, unique in the Organisation, and cannot change later. */
+    async create(name, opts = {}) {
+        return parseTenant(await this.http.json('POST', '/v1/tenants', {
+            json: { name, externalId: opts.externalId, metadata: opts.metadata },
+        }));
+    }
+    /**
+     * One page, newest first. `externalId` finds the Tenant with that id (zero or one) and
+     * cannot be combined with `status`.
+     */
+    async list(opts = {}) {
+        const d = await this.http.json('GET', '/v1/tenants', { params: opts });
+        return { tenants: (d.tenants ?? []).map(parseTenant), nextCursor: d.nextCursor ?? null };
+    }
+    async get(tenant) {
+        return parseTenant(await this.http.json('GET', tenantPath(tenant)));
+    }
+    /**
+     * `metadata` replaces the whole map. `status: 'disabled'` stops the Tenant's tokens and
+     * machines; `status: 'active'` brings it back.
+     *
+     * `cloudMachineLimit` (0 to 1000) caps the Tenant's cloud machines; `null` removes the cap.
+     * Lowering it deletes nothing: creates are refused until the count fits. `residentialProxy`
+     * is the Tenant's residential proxy switch; it has no effect yet, and traffic goes direct.
+     * Only the Organisation Key or an owner may set these two.
+     */
+    async update(tenant, opts) {
+        return parseTenant(await this.http.json('PATCH', tenantPath(tenant), { json: opts }));
+    }
+    /**
+     * Disables the Tenant and revokes every enrolled machine. Cloud machines stay and hibernate:
+     * delete them with `tenantMachines.delete`. Its data is kept: erase it from the console.
+     */
+    async delete(tenant) {
+        await this.http.request('DELETE', tenantPath(tenant));
+    }
+    /** A single-use code that enrolls one computer into the Tenant. It expires in 15 minutes. */
+    async createEnrollment(tenant) {
+        return parseEnrollment(await this.http.json('POST', `${tenantPath(tenant)}/enrollments`));
+    }
+    /**
+     * Exchange the Organisation Key for a one-hour token that acts as the Tenant. `orgId`
+     * defaults to the client's `orgId` (`SAI_ORG_ID`).
+     */
+    async token(tenant, opts = {}) {
+        const orgId = opts.orgId ?? this.orgId;
+        if (!orgId) {
+            throw new Error('No Organisation id: pass orgId here or to new Sai(), or set SAI_ORG_ID.');
+        }
+        const id = typeof tenant === 'string' ? tenant : tenant.id;
+        return parseTenantToken(await this.http.json('POST', `/v1/orgs/${q(orgId)}/tenants/${q(id)}/token`));
+    }
+    /**
+     * A client that acts as the Tenant. It exchanges a token now, and again before a request
+     * when the token has less than five minutes left. Uses this client's Organisation Key.
+     */
+    async client(tenant, opts = {}) {
+        let current = await this.token(tenant, opts);
+        let pending;
+        return this.withCredential(async () => {
+            if (current.expiresAt - Date.now() >= TOKEN_REFRESH_MARGIN_MS)
+                return current.token;
+            pending ??= this.token(tenant, opts).finally(() => {
+                pending = undefined;
+            });
+            current = await pending;
+            return current.token;
+        });
+    }
+}
+/** A Tenant's computers, enrolled and cloud. Every call takes an Organisation Key. */
+export class TenantMachines {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Create a cloud machine for the Tenant. `os` is `windows` or `linux`; the size follows it.
+     * `name` (up to 64 characters) is a label you show your users.
+     *
+     * `requestId` (letters, digits, `_` and `-`, up to 128) makes a retry safe: the same id and
+     * body return the first machine, and the same id with another body throws `ConflictError`
+     * (`request_id_reused`). Without one, every call creates a machine.
+     *
+     * Returns at once with `state: 'provisioning'`. `wait: true` reads the machine until it is
+     * `ready`; it throws `SaiError` if the machine fails or is deleted, and a `TimeoutError`
+     * (DOMException) after `timeoutMs` (default 10 minutes).
+     */
+    async create(tenant, opts) {
+        let machine = parseTenantMachine(await this.http.json('POST', `${tenantPath(tenant)}/machines`, {
+            json: { os: opts.os, name: opts.name, requestId: opts.requestId },
+        }));
+        if (!opts.wait)
+            return machine;
+        const deadline = Date.now() + (opts.timeoutMs ?? 600_000);
+        while (machine.state !== 'ready') {
+            if (machine.state === 'failed' || machine.state === 'deleting') {
+                throw new SaiError(`Cloud machine ${machine.id} is ${machine.state} and will not become ready.`, { body: machine.raw });
+            }
+            if (Date.now() + MACHINE_POLL_INTERVAL_MS > deadline) {
+                throw new DOMException(`Cloud machine ${machine.id} still ${machine.state}.`, 'TimeoutError');
+            }
+            await sleep(MACHINE_POLL_INTERVAL_MS);
+            try {
+                machine = await this.get(tenant, machine.id);
+            }
+            catch (err) {
+                if (!(err instanceof RateLimitError))
+                    throw err;
+                await sleep((err.retryAfter ?? 30) * 1000);
+            }
+        }
+        return machine;
+    }
+    /** Both kinds, enrolled and cloud. A cloud machine is listed from the moment it is created. */
+    async list(tenant) {
+        const d = await this.http.json('GET', `${tenantPath(tenant)}/machines`);
+        return (d.machines ?? []).map(parseTenantMachine);
+    }
+    async get(tenant, machineId) {
+        return parseTenantMachine(await this.http.json('GET', `${tenantPath(tenant)}/machines/${q(machineId)}`));
+    }
+    /**
+     * An enrolled machine is signed out at once (`'revoked'`); enroll it again with a new code to
+     * bring it back. A cloud machine is deleted with its disk (`'deleting'`), which cannot be
+     * undone; it leaves the list when the deletion finishes.
+     */
+    async delete(tenant, machine) {
+        const id = typeof machine === 'string' ? machine : machine.id;
+        const res = await this.http.request('DELETE', `${tenantPath(tenant)}/machines/${q(id)}`);
+        return res.status === 202 ? 'deleting' : 'revoked';
+    }
+    /** `delete` without its answer. On a cloud machine it deletes the machine: use `delete`. */
+    async revoke(tenant, machine) {
+        await this.delete(tenant, machine);
+    }
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+//# sourceMappingURL=tenants.js.map