@pingroom/sdk 0.7.1 → 0.9.0

package/dist/namespaces/approvals.d.ts

@@ -0,0 +1,23 @@
+import type { HttpClient } from '../http.js';
+import type { Approval, ApprovalInput, WaitApprovalInput, WaitForOutcomeOptions } from '../types.js';
+export declare class ApprovalsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Ask the human you act for to decide; returns the pending approval. */
+    request(inviteCode: string, input: ApprovalInput): Promise<Approval>;
+    get(approvalId: string): Promise<Approval>;
+    /** One long-poll for the decision; returns the (possibly still-pending) approval. */
+    wait(approvalId: string, input?: WaitApprovalInput): Promise<Approval>;
+    /**
+     * Block until the human decides (or the request expires or is cancelled),
+     * looping wait() under the hood, with polls started at least 2.1 s apart. A
+     * response that is not this approval in a known status rejects with
+     * `invalid_response`. Network failures, 429 and 5xx are retried with backoff
+     * (honouring `retryAfter`), and reported to `onRetry`, until `signal` aborts
+     * or the outage outlasts the approval's `expires_at` by 5 minutes (15 minutes
+     * of failures while no `expires_at` has been read); that rejects with
+     * `unavailable`. See {@link WaitForOutcomeOptions}.
+     */
+    waitForDecision(approvalId: string, input?: WaitForOutcomeOptions): Promise<Approval>;
+}
+//# sourceMappingURL=approvals.d.ts.map

package/dist/namespaces/approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/namespaces/approvals.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AA0CrB,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,yEAAyE;IACzE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUpE,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI1C,qFAAqF;IACrF,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,iBAAsB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ1E;;;;;;;;;OASG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,qBAA0B,GAAG,OAAO,CAAC,QAAQ,CAAC;CAchG"}

package/dist/namespaces/approvals.js

@@ -0,0 +1,78 @@
+// `pr.approvals`: two-option human-in-the-loop decisions.
+import { assertStructuredData, requireNonEmpty } from '../internal/guards.js';
+import { pollUntilSettled } from '../internal/retry.js';
+import { MIN_WAIT_POLL_INTERVAL_MS, enc, splitIdempotencyKey, assertOnRetry, dropUndefined, waitTimeoutMs, } from '../internal/request.js';
+import { isRecord, isNonEmptyString, isNullableString, sameId, invalidWaitResponse, } from '../internal/validate.js';
+const APPROVAL_STATUSES = new Set(['pending', 'decided', 'expired', 'cancelled']);
+/**
+ * A wait response is trusted as an outcome only when it is the approval that
+ * was asked about, in a known status. A captive portal's HTML, `{}`, or another
+ * approval must not read as "decided".
+ */
+function validateApprovalWait(value, approvalId) {
+    const status = isRecord(value) ? value['status'] : undefined;
+    if (!isRecord(value)
+        || !sameId(value['id'], approvalId)
+        || typeof status !== 'string'
+        || !APPROVAL_STATUSES.has(status)
+        || !isNullableString(value['decided_at'])
+        // A gate acts on `decision`; a decided approval without one, or a pending
+        // one already stamped decided, is not an outcome it can act on.
+        || (status === 'decided' && !isNonEmptyString(value['decision']))
+        || (status === 'pending' && value['decided_at'] !== null)) {
+        return invalidWaitResponse('approval', approvalId, value, 'status');
+    }
+    return value;
+}
+export class ApprovalsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Ask the human you act for to decide; returns the pending approval. */
+    request(inviteCode, input) {
+        requireNonEmpty(input.question, 'question');
+        assertStructuredData(input.data);
+        const { body, headers } = splitIdempotencyKey(input);
+        return this.http.request('POST', `/api/agent/rooms/${enc(inviteCode)}/approvals`, {
+            body: dropUndefined({ ...body }),
+            ...(headers ? { headers } : {}),
+        });
+    }
+    get(approvalId) {
+        return this.http.request('GET', `/api/agent/approvals/${enc(approvalId)}`);
+    }
+    /** One long-poll for the decision; returns the (possibly still-pending) approval. */
+    wait(approvalId, input = {}) {
+        return this.http.request('GET', `/api/agent/approvals/${enc(approvalId)}/wait`, {
+            query: dropUndefined({ timeout: input.timeout }),
+            timeoutMs: waitTimeoutMs(input.timeout),
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+    }
+    /**
+     * Block until the human decides (or the request expires or is cancelled),
+     * looping wait() under the hood, with polls started at least 2.1 s apart. A
+     * response that is not this approval in a known status rejects with
+     * `invalid_response`. Network failures, 429 and 5xx are retried with backoff
+     * (honouring `retryAfter`), and reported to `onRetry`, until `signal` aborts
+     * or the outage outlasts the approval's `expires_at` by 5 minutes (15 minutes
+     * of failures while no `expires_at` has been read); that rejects with
+     * `unavailable`. See {@link WaitForOutcomeOptions}.
+     */
+    async waitForDecision(approvalId, input = {}) {
+        requireNonEmpty(approvalId, 'approvalId');
+        assertOnRetry(input.onRetry);
+        return pollUntilSettled({
+            poll: () => this.wait(approvalId, input.signal ? { signal: input.signal } : {}),
+            validate: (value) => validateApprovalWait(value, approvalId),
+            settled: (approval) => approval.status !== 'pending',
+            expiresAt: (approval) => approval.expires_at,
+            what: `approval ${approvalId}`,
+            minIntervalMs: MIN_WAIT_POLL_INTERVAL_MS,
+            ...(input.signal ? { signal: input.signal } : {}),
+            ...(input.onRetry ? { onRetry: input.onRetry } : {}),
+        });
+    }
+}
+//# sourceMappingURL=approvals.js.map

package/dist/namespaces/approvals.js.map

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

package/dist/namespaces/attachments.d.ts

@@ -0,0 +1,37 @@
+import type { HttpClient } from '../http.js';
+import type { Attachment, ZipManifest, UploadAttachmentInput } from '../types.js';
+/**
+ * Private files that a Ping or Question can carry.
+ *
+ * Upload first, then pass the returned ids to `broadcast()` / `questions.ask()`
+ * as `attachment_ids`. Bytes never travel inside a JSON ping body (the MCP
+ * `upload_attachment` tool takes only small files, about 90 KiB, as base64). An
+ * upload that is never attached expires on its own after 24 hours.
+ * Each file must be 1 byte–5 MiB with an md/pdf/html/txt/jpg/jpeg/png/zip filename;
+ * a Ping or Question accepts at most four ids.
+ *
+ * Uploading requires the bound account to hold Pro (the API answers 402
+ * `pro_required` otherwise). Reading and deleting are not gated.
+ */
+export declare class AttachmentsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Upload one file and get back the id a send can claim. */
+    upload(input: UploadAttachmentInput): Promise<Attachment>;
+    /**
+     * Raw bytes for an attachment this credential is allowed to see. Returns the
+     * undecoded Response so a caller can stream it, or read text/arrayBuffer.
+     */
+    content(attachmentId: string, signal?: AbortSignal): Promise<Response>;
+    /**
+     * The listing of a `.zip`'s contents, recorded when it was uploaded.
+     *
+     * Resolves null for a non-archive, and for an archive whose central
+     * directory did not parse. Nothing decompresses the file to produce this, so
+     * the declared sizes are what the archive claims, not verified output.
+     */
+    manifest(attachmentId: string, signal?: AbortSignal): Promise<ZipManifest | null>;
+    /** Discard an upload that has not been attached to a ping yet. */
+    delete(attachmentId: string): Promise<void>;
+}
+//# sourceMappingURL=attachments.d.ts.map

package/dist/namespaces/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/namespaces/attachments.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAYlF;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,4DAA4D;IAC5D,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqBzD;;;OAGG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOtE;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAWjF,kEAAkE;IAClE,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI5C"}

package/dist/namespaces/attachments.js

@@ -0,0 +1,91 @@
+// `pr.attachments`: upload, read and discard private files.
+import { PingRoomError } from '../errors.js';
+import { requireNonEmpty } from '../internal/guards.js';
+import { enc } from '../internal/request.js';
+/** Server cap per uploaded file; a larger body is a 413 the server answers before reading it. */
+const ATTACHMENT_MAX_BYTES = 5 * 1024 * 1024;
+function attachmentByteLength(content) {
+    if (content instanceof Blob)
+        return content.size;
+    if (typeof content === 'string')
+        return new TextEncoder().encode(content).byteLength;
+    return content.byteLength;
+}
+/**
+ * Private files that a Ping or Question can carry.
+ *
+ * Upload first, then pass the returned ids to `broadcast()` / `questions.ask()`
+ * as `attachment_ids`. Bytes never travel inside a JSON ping body (the MCP
+ * `upload_attachment` tool takes only small files, about 90 KiB, as base64). An
+ * upload that is never attached expires on its own after 24 hours.
+ * Each file must be 1 byte–5 MiB with an md/pdf/html/txt/jpg/jpeg/png/zip filename;
+ * a Ping or Question accepts at most four ids.
+ *
+ * Uploading requires the bound account to hold Pro (the API answers 402
+ * `pro_required` otherwise). Reading and deleting are not gated.
+ */
+export class AttachmentsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Upload one file and get back the id a send can claim. */
+    upload(input) {
+        requireNonEmpty(input.filename, 'filename');
+        // The server answers an oversized body with 413 before reading it; refuse
+        // locally so no bytes travel for a file that can never be accepted.
+        if (attachmentByteLength(input.content) > ATTACHMENT_MAX_BYTES) {
+            return Promise.reject(new PingRoomError('Attachments are at most 5 MiB each.', { code: 'attachment_too_large', status: 413 }));
+        }
+        const body = new FormData();
+        body.append('file', toAttachmentBlob(input), input.filename);
+        return this.http
+            .request('POST', '/api/agent/attachments', {
+            body,
+            ...(input.signal ? { signal: input.signal } : {}),
+        })
+            .then((res) => res.attachment);
+    }
+    /**
+     * Raw bytes for an attachment this credential is allowed to see. Returns the
+     * undecoded Response so a caller can stream it, or read text/arrayBuffer.
+     */
+    content(attachmentId, signal) {
+        requireNonEmpty(attachmentId, 'attachmentId');
+        return this.http.raw('GET', `/api/agent/attachments/${enc(attachmentId)}/content`, {
+            ...(signal ? { signal } : {}),
+        });
+    }
+    /**
+     * The listing of a `.zip`'s contents, recorded when it was uploaded.
+     *
+     * Resolves null for a non-archive, and for an archive whose central
+     * directory did not parse. Nothing decompresses the file to produce this, so
+     * the declared sizes are what the archive claims, not verified output.
+     */
+    manifest(attachmentId, signal) {
+        requireNonEmpty(attachmentId, 'attachmentId');
+        return this.http
+            .request('GET', `/api/agent/attachments/${enc(attachmentId)}/manifest`, { ...(signal ? { signal } : {}) })
+            .then((res) => res.manifest ?? null);
+    }
+    /** Discard an upload that has not been attached to a ping yet. */
+    delete(attachmentId) {
+        requireNonEmpty(attachmentId, 'attachmentId');
+        return this.http.request('DELETE', `/api/agent/attachments/${enc(attachmentId)}`);
+    }
+}
+/** Normalise the three accepted content shapes into one multipart part. */
+function toAttachmentBlob(input) {
+    const type = input.contentType ?? '';
+    if (input.content instanceof Blob) {
+        return type ? new Blob([input.content], { type }) : input.content;
+    }
+    // Copy into a plain ArrayBuffer: a Uint8Array view may be a window onto a
+    // larger (or SharedArrayBuffer-backed) buffer, which Blob would not accept.
+    const parts = typeof input.content === 'string'
+        ? [input.content]
+        : [new Uint8Array(input.content).slice().buffer];
+    return new Blob(parts, type ? { type } : undefined);
+}
+//# sourceMappingURL=attachments.js.map

package/dist/namespaces/attachments.js.map

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

package/dist/namespaces/auth.d.ts

@@ -0,0 +1,58 @@
+import type { HttpClient } from '../http.js';
+import type { AgentConnectionInfo, AgentDisconnectResult, Credential, ClaimCompleteParams, ClaimStartParams, RegisterParams, PairingStart, PairingStatus, PairedCredential, StartPairingParams, WaitForPairingOptions } from '../types.js';
+/** Agent credential lifecycle (auth.md flow). */
+export declare class AuthApi {
+    private readonly http;
+    private pairing;
+    constructor(http: HttpClient);
+    /** Register an agent. Anonymous or via an identity assertion (ID-JAG / verified email). Public. */
+    register(params: RegisterParams): Promise<Credential>;
+    /** Begin claiming a pre-claim credential onto a human account; emails an OTP. */
+    claimStart(params: ClaimStartParams): Promise<{
+        message: string;
+        expires_in: number;
+    }>;
+    /** Complete the claim with the emailed OTP; returns an active credential + handle. */
+    claimComplete(params: ClaimCompleteParams): Promise<Credential>;
+    /**
+     * Register a pending agent and create a short-lived link that opens the
+     * PingRoom app. The server owns the full grant shown to the approver; this
+     * client sends no scope list. The pending credential stays private inside the
+     * client and is replaced automatically once waitForPairing() succeeds. If the
+     * client already held a credential, it is put back when the pairing expires
+     * or the wait is aborted, so a re-pairing that never completes leaves the
+     * client on the working credential rather than the dead pending one.
+     */
+    startPairing(params?: StartPairingParams): Promise<PairingStart>;
+    /** Read the current state of an app pairing using the pending credential. */
+    pairingStatus(options?: Pick<WaitForPairingOptions, 'signal'>): Promise<PairingStatus>;
+    /**
+     * Wait until the person approves in PingRoom, or the short-lived link
+     * expires. Transient network, 429, and 5xx failures are retried inside the
+     * server-provided lifetime. On success the client immediately starts using
+     * the active credential returned by the server. When the link expires or the
+     * wait is aborted, the credential the client held before startPairing() is
+     * restored; calling waitForPairing() again after an abort resumes the same
+     * pairing.
+     */
+    waitForPairing(pairing: PairingStart, options?: WaitForPairingOptions): Promise<PairedCredential>;
+    private pollPairing;
+    /** Rotate to a fresh credential (same scopes/handle). */
+    refresh(): Promise<Credential>;
+    /** Revoke the current credential. */
+    revoke(): Promise<void>;
+    /**
+     * What this credential is connected to: the robot, the owner's public id and
+     * name, the home room and room memberships, and the room grant. Check
+     * `owner.id` and `handle` against the account and robot you approved before
+     * sending anything.
+     */
+    connection(): Promise<AgentConnectionInfo>;
+    /**
+     * Disconnect this agent: revokes the calling credential and its refresh
+     * credentials. The client keeps the now-revoked token; clear it with
+     * `setToken(null)` or pair again.
+     */
+    disconnect(): Promise<AgentDisconnectResult>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/namespaces/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/namespaces/auth.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AA2CrB,iDAAiD;AACjD,qBAAa,OAAO;IAGN,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,OAAO,CAA+B;gBAEjB,IAAI,EAAE,UAAU;IAE7C,mGAAmG;IACnG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAKrD,iFAAiF;IACjF,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAKtF,sFAAsF;IACtF,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAM/D;;;;;;;;OAQG;IACG,YAAY,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IA8B1E,6EAA6E;IAC7E,aAAa,CAAC,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1F;;;;;;;;OAQG;IACG,cAAc,CAClB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,gBAAgB,CAAC;YAyBd,WAAW;IAwFzB,yDAAyD;IACzD,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAI9B,qCAAqC;IACrC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB;;;;;OAKG;IACH,UAAU,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI1C;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,qBAAqB,CAAC;CAG7C"}

package/dist/namespaces/auth.js

@@ -0,0 +1,242 @@
+// `pr.auth`: registration, claim, app pairing and the credential lifecycle.
+import { PingRoomError } from '../errors.js';
+import { sleep, throwIfAborted } from '../internal/async.js';
+import { requireNonEmpty } from '../internal/guards.js';
+import { dropUndefined } from '../internal/request.js';
+import { isRecord } from '../internal/validate.js';
+/** Drop a malformed or unsafe server-provided URL without rejecting its response. */
+function normalizePublicHttpUrl(candidate) {
+    if (typeof candidate !== 'string' || candidate.trim() === '')
+        return undefined;
+    const trimmed = candidate.trim();
+    // eslint-disable-next-line no-control-regex
+    if (/[\u0000-\u001F\u007F-\u009F]/.test(trimmed))
+        return undefined;
+    try {
+        const url = new URL(trimmed);
+        if (url.protocol !== 'https:' && url.protocol !== 'http:')
+            return undefined;
+        if (url.username !== '' || url.password !== '')
+            return undefined;
+    }
+    catch {
+        return undefined;
+    }
+    return trimmed;
+}
+/** Drop malformed or unsafe server-provided links without rejecting a valid credential. */
+function normalizePairingLinks(value) {
+    if (!isRecord(value))
+        return undefined;
+    const latestPings = normalizePublicHttpUrl(value['latest_pings']);
+    if (!latestPings)
+        return undefined;
+    const installApp = normalizePublicHttpUrl(value['install_app']);
+    return {
+        latest_pings: latestPings,
+        ...(installApp ? { install_app: installApp } : {}),
+    };
+}
+/** Agent credential lifecycle (auth.md flow). */
+export class AuthApi {
+    http;
+    pairing = null;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Register an agent. Anonymous or via an identity assertion (ID-JAG / verified email). Public. */
+    register(params) {
+        requireNonEmpty(params.type, 'type');
+        return this.http.request('POST', '/api/agent/auth', { auth: false, body: dropUndefined({ ...params }) });
+    }
+    /** Begin claiming a pre-claim credential onto a human account; emails an OTP. */
+    claimStart(params) {
+        requireNonEmpty(params.email, 'email');
+        return this.http.request('POST', '/api/agent/auth/claim/start', { body: { email: params.email } });
+    }
+    /** Complete the claim with the emailed OTP; returns an active credential + handle. */
+    claimComplete(params) {
+        requireNonEmpty(params.email, 'email');
+        requireNonEmpty(params.otp, 'otp');
+        return this.http.request('POST', '/api/agent/auth/claim/complete', { body: dropUndefined({ ...params }) });
+    }
+    /**
+     * Register a pending agent and create a short-lived link that opens the
+     * PingRoom app. The server owns the full grant shown to the approver; this
+     * client sends no scope list. The pending credential stays private inside the
+     * client and is replaced automatically once waitForPairing() succeeds. If the
+     * client already held a credential, it is put back when the pairing expires
+     * or the wait is aborted, so a re-pairing that never completes leaves the
+     * client on the working credential rather than the dead pending one.
+     */
+    async startPairing(params = {}) {
+        const previousToken = this.http.getToken();
+        const pending = await this.register({
+            type: 'anonymous',
+            ...(params.agent_label ? { agent_label: params.agent_label } : {}),
+        });
+        this.http.setToken(pending.credential);
+        try {
+            const started = await this.http.request('POST', '/api/agent/auth/pair/start', {
+                body: {},
+            });
+            // A second pairing started while the first is still pending falls back
+            // to the credential beneath it, not to the first pairing's pending one.
+            this.pairing = {
+                pairToken: started.pair_token,
+                pending: pending.credential,
+                previous: this.pairing !== null && this.pairing.pending === previousToken
+                    ? this.pairing.previous
+                    : previousToken,
+            };
+            return started;
+        }
+        catch (error) {
+            if (this.http.getToken() === pending.credential) {
+                this.http.setToken(previousToken);
+            }
+            throw error;
+        }
+    }
+    /** Read the current state of an app pairing using the pending credential. */
+    pairingStatus(options = {}) {
+        return this.http.request('GET', '/api/agent/auth/pair/status', { signal: options.signal });
+    }
+    /**
+     * Wait until the person approves in PingRoom, or the short-lived link
+     * expires. Transient network, 429, and 5xx failures are retried inside the
+     * server-provided lifetime. On success the client immediately starts using
+     * the active credential returned by the server. When the link expires or the
+     * wait is aborted, the credential the client held before startPairing() is
+     * restored; calling waitForPairing() again after an abort resumes the same
+     * pairing.
+     */
+    async waitForPairing(pairing, options = {}) {
+        const tracked = this.pairing !== null && this.pairing.pairToken === pairing.pair_token
+            ? this.pairing
+            : null;
+        if (tracked !== null && this.http.getToken() === tracked.previous) {
+            // Resuming after an abort put the earlier credential back.
+            this.http.setToken(tracked.pending);
+        }
+        try {
+            const paired = await this.pollPairing(pairing, options);
+            if (tracked !== null && this.pairing === tracked)
+                this.pairing = null;
+            return paired;
+        }
+        catch (error) {
+            if (tracked !== null && this.pairing === tracked) {
+                const expired = error instanceof PingRoomError && error.code === 'pairing_expired';
+                if (expired || options.signal?.aborted === true) {
+                    if (this.http.getToken() === tracked.pending)
+                        this.http.setToken(tracked.previous);
+                }
+                // An expired pairing cannot be resumed; an aborted one can.
+                if (expired)
+                    this.pairing = null;
+            }
+            throw error;
+        }
+    }
+    async pollPairing(pairing, options) {
+        const lifetimeMs = Math.max(1, Number(pairing.expires_in) || 900) * 1000;
+        const requestedInterval = options.pollIntervalMs ?? pairing.poll_interval_ms;
+        const intervalMs = Math.min(Math.max(Number(requestedInterval) || 1500, 1000), 10_000);
+        const startedAt = Date.now();
+        const deadline = startedAt + lifetimeMs;
+        let transientFailures = 0;
+        while (Date.now() < deadline) {
+            throwIfAborted(options.signal);
+            try {
+                const status = await this.pairingStatus({ signal: options.signal });
+                throwIfAborted(options.signal);
+                transientFailures = 0;
+                if (status.status === 'active') {
+                    if (typeof status.credential !== 'string'
+                        || status.credential.trim() === ''
+                        || status.credential_type !== 'active'
+                        || (status.expires_in !== null
+                            && (typeof status.expires_in !== 'number'
+                                || !Number.isFinite(status.expires_in)
+                                || status.expires_in < 0))
+                        // A null/absent `room` is valid when the account has no eligible
+                        // private delivery room (and on older servers). Only a room that is
+                        // present but malformed is a broken response.
+                        || (status.room != null
+                            && (typeof status.room.invite_code !== 'string'
+                                || status.room.invite_code.trim() === ''))) {
+                        throw new PingRoomError('PingRoom returned an incomplete approved pairing.', {
+                            code: 'pairing_invalid_response',
+                            body: { status: status.status },
+                        });
+                    }
+                    this.http.setToken(status.credential);
+                    // Pairing is server-authoritative. Some servers still include their
+                    // internal grant marker for protocol compatibility; it is neither a
+                    // client input nor part of the paired credential surface.
+                    const { status: _status, scopes: _serverScopes, links: rawLinks, ...credential } = status;
+                    const links = normalizePairingLinks(rawLinks);
+                    return links ? { ...credential, links } : credential;
+                }
+                if (status.status === 'expired') {
+                    throw new PingRoomError('The PingRoom pairing link expired before it was approved.', {
+                        code: 'pairing_expired',
+                    });
+                }
+            }
+            catch (error) {
+                if (error instanceof PingRoomError
+                    && [401, 403, 404].includes(error.status)
+                    && Date.now() - startedAt >= lifetimeMs / 2) {
+                    // The pending bearer can expire before the server returns an
+                    // explicit expired pairing state. Keep early auth failures intact.
+                    throw new PingRoomError('The PingRoom pairing link expired before it was approved.', {
+                        code: 'pairing_expired',
+                    });
+                }
+                if (error instanceof PingRoomError
+                    && (error.code === 'network_error'
+                        || error.code === 'timeout'
+                        || error.status === 429
+                        || error.status >= 500)) {
+                    transientFailures += 1;
+                    const backoffMs = Math.min(intervalMs * 2 ** Math.max(0, transientFailures - 3), 30_000);
+                    await sleep(Math.max(0, Math.min(backoffMs, deadline - Date.now())), options.signal);
+                    continue;
+                }
+                throw error;
+            }
+            await sleep(Math.max(0, Math.min(intervalMs, deadline - Date.now())), options.signal);
+        }
+        throw new PingRoomError('The PingRoom pairing link expired before it was approved.', {
+            code: 'pairing_expired',
+        });
+    }
+    /** Rotate to a fresh credential (same scopes/handle). */
+    refresh() {
+        return this.http.request('POST', '/api/agent/auth/refresh', { body: {} });
+    }
+    /** Revoke the current credential. */
+    revoke() {
+        return this.http.request('POST', '/api/agent/auth/revoke', { body: {} });
+    }
+    /**
+     * What this credential is connected to: the robot, the owner's public id and
+     * name, the home room and room memberships, and the room grant. Check
+     * `owner.id` and `handle` against the account and robot you approved before
+     * sending anything.
+     */
+    connection() {
+        return this.http.request('GET', '/api/agent/connection');
+    }
+    /**
+     * Disconnect this agent: revokes the calling credential and its refresh
+     * credentials. The client keeps the now-revoked token; clear it with
+     * `setToken(null)` or pair again.
+     */
+    disconnect() {
+        return this.http.request('POST', '/api/agent/disconnect', { body: {} });
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/namespaces/auth.js.map

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

package/dist/namespaces/directory.d.ts

@@ -0,0 +1,10 @@
+import type { HttpClient } from '../http.js';
+import type { DirectoryEntry, DirectoryListInput, DirectoryProfile, Paginated } from '../types.js';
+/** Public, unauthenticated agent directory. */
+export declare class DirectoryApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(input?: DirectoryListInput): Promise<Paginated<DirectoryEntry>>;
+    get(handle: string): Promise<DirectoryProfile>;
+}
+//# sourceMappingURL=directory.d.ts.map

package/dist/namespaces/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/namespaces/directory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGnG,+CAA+C;AAC/C,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,CAAC,KAAK,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAOxE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAG/C"}

package/dist/namespaces/directory.js

@@ -0,0 +1,19 @@
+// `pr.directory`: the public agent directory.
+import { enc, dropUndefined } from '../internal/request.js';
+/** Public, unauthenticated agent directory. */
+export class DirectoryApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(input = {}) {
+        return this.http.request('GET', '/api/agents/directory', {
+            auth: false,
+            query: dropUndefined({ ...input }),
+        });
+    }
+    get(handle) {
+        return this.http.request('GET', `/api/agents/directory/${enc(handle)}`, { auth: false });
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/namespaces/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../src/namespaces/directory.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAI9C,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,+CAA+C;AAC/C,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,IAAI,CAAC,QAA4B,EAAE;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,uBAAuB,EAAE;YACvD,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,yBAAyB,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3F,CAAC;CACF"}