@pingroom/sdk 0.7.1 → 0.9.0

package/dist/namespaces/notifications.js

@@ -0,0 +1,128 @@
+// `pr.notifications`: history, one-shot waits and the listen() iterator.
+import { PingRoomError } from '../errors.js';
+import { sleep } from '../internal/async.js';
+import { requireNonEmpty } from '../internal/guards.js';
+import { isTransientError, transientDelayMs } from '../internal/retry.js';
+import { isRecord } from '../internal/validate.js';
+import { enc, dropUndefined, MIN_LISTEN_POLL_INTERVAL_MS, waitTimeoutMs } from '../internal/request.js';
+/**
+ * A 2xx that is not a wait answer (a captive portal's HTML, a proxy's error
+ * page served as 200) must not end `listen()` with a bare TypeError, nor
+ * advance its cursor.
+ */
+function validateListenResult(value, requireCursor) {
+    if (!isRecord(value)
+        || !Array.isArray(value['notifications'])
+        || value['notifications'].some((notification) => !isRecord(notification))
+        || (value['cursor'] === undefined ? requireCursor : typeof value['cursor'] !== 'string')) {
+        throw new PingRoomError('PingRoom returned an invalid notifications wait response.', {
+            code: 'invalid_response',
+        });
+    }
+    return value;
+}
+export class NotificationsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Paginated list (polling fallback). Prefer wait()/listen() for real-time. */
+    async list(input = {}) {
+        const { notifications_per_page, ...query } = input;
+        const page = await this.http.request('GET', '/api/agent/notifications', {
+            query: dropUndefined({ ...query, limit: input.limit ?? notifications_per_page }),
+        });
+        return {
+            ...page,
+            data: page.data.map(({ room, ...notification }) => ({
+                ...notification,
+                ...(room ? { room: { ...room, code: room.invite_code } } : {}),
+            })),
+        };
+    }
+    /** Fetch one visible notification, including its current acknowledgement state. */
+    getNotification(notificationId) {
+        requireNonEmpty(notificationId, 'notificationId');
+        return this.http.request('GET', `/api/agent/notifications/${enc(notificationId)}`);
+    }
+    /**
+     * One bounded long-poll for an ack-required ping. The returned state may
+     * still be `open` when the hold timeout elapses; call again to keep waiting.
+     */
+    waitForAcknowledgement(notificationId, input = {}) {
+        requireNonEmpty(notificationId, 'notificationId');
+        return this.http.request('GET', `/api/agent/notifications/${enc(notificationId)}/ack/wait`, {
+            query: dropUndefined({ timeout: input.timeout }),
+            timeoutMs: waitTimeoutMs(input.timeout),
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+    }
+    /** One long-poll: resolves as soon as new pings land, or with an empty list at timeout. */
+    wait(input = {}) {
+        return this.http.request('GET', '/api/agent/notifications/wait', {
+            query: dropUndefined({ after: input.after, timeout: input.timeout, limit: input.limit }),
+            timeoutMs: waitTimeoutMs(input.timeout),
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+    }
+    /**
+     * Continuous real-time inbound: an async iterator that long-polls in a loop,
+     * advancing the cursor, yielding each new ping. Stops when `signal` aborts.
+     *
+     *   for await (const ping of pr.notifications.listen({ signal })) { ... }
+     */
+    async *listen(input = {}) {
+        let cursor = input.after;
+        let headRead = cursor !== undefined;
+        const backoffMs = input.backoffMs ?? 1000;
+        let failures = 0;
+        while (!input.signal?.aborted) {
+            let result;
+            // The head read is an immediate answer by design; only polls ahead of
+            // the cursor are spaced.
+            const polledForward = headRead;
+            const pollStartedAt = Date.now();
+            try {
+                // The head read exists to obtain a cursor, so it must carry one.
+                result = validateListenResult(headRead
+                    ? await this.wait({
+                        after: cursor,
+                        ...(input.timeout !== undefined ? { timeout: input.timeout } : {}),
+                        ...(input.limit !== undefined ? { limit: input.limit } : {}),
+                        ...(input.signal ? { signal: input.signal } : {}),
+                    })
+                    // No cursor yet: read the current head (an immediate, empty answer)
+                    // so only pings that land after this call are delivered.
+                    : await this.wait({ timeout: 0, ...(input.signal ? { signal: input.signal } : {}) }), !headRead);
+            }
+            catch (err) {
+                if (input.signal?.aborted) {
+                    return;
+                }
+                // A revoked credential or a bad request never heals; only network
+                // failures, deadlines, 429 and 5xx are retried.
+                if (!isTransientError(err)) {
+                    throw err;
+                }
+                failures += 1;
+                input.onError?.(err);
+                await sleep(Math.max(transientDelayMs(err, failures, backoffMs), MIN_LISTEN_POLL_INTERVAL_MS - (Date.now() - pollStartedAt)), input.signal);
+                continue;
+            }
+            failures = 0;
+            headRead = true;
+            cursor = result.cursor ?? cursor;
+            for (const n of result.notifications) {
+                yield n;
+            }
+            // Yield between polls so timer-driven cancellation can run (see
+            // ApprovalsApi). After an empty answer also keep polls a floor apart, so
+            // `timeout: 0` or an early-answering proxy cannot spin the loop.
+            const spacingMs = polledForward && result.notifications.length === 0
+                ? Math.max(0, MIN_LISTEN_POLL_INTERVAL_MS - (Date.now() - pollStartedAt))
+                : 0;
+            await sleep(spacingMs, input.signal);
+        }
+    }
+}
+//# sourceMappingURL=notifications.js.map

package/dist/namespaces/notifications.js.map

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

package/dist/namespaces/profile.d.ts

@@ -0,0 +1,19 @@
+import type { HttpClient } from '../http.js';
+import type { RotateHandleResult } from '../types.js';
+export declare class ProfileApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Set this agent's own avatar (from the bot avatar set) — the robot face
+     * its pings and Questions wear. Never touches the bound human's profile
+     * picture. Returns `{ ok, avatar_id, avatar_url }`.
+     */
+    setAvatar(avatarId: string): Promise<{
+        ok: boolean;
+        avatar_id: string;
+        avatar_url: string;
+    }>;
+    /** Rotate the agent's handle — the kill-switch for a leaked handle. */
+    rotateHandle(): Promise<RotateHandleResult>;
+}
+//# sourceMappingURL=profile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/namespaces/profile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAK5F,uEAAuE;IACvE,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAG5C"}

package/dist/namespaces/profile.js

@@ -0,0 +1,22 @@
+// `pr.profile`: this agent's own avatar and handle.
+import { requireNonEmpty } from '../internal/guards.js';
+export class ProfileApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Set this agent's own avatar (from the bot avatar set) — the robot face
+     * its pings and Questions wear. Never touches the bound human's profile
+     * picture. Returns `{ ok, avatar_id, avatar_url }`.
+     */
+    setAvatar(avatarId) {
+        requireNonEmpty(avatarId, 'avatarId');
+        return this.http.request('POST', '/api/agent/profile/avatar', { body: { avatar_id: avatarId } });
+    }
+    /** Rotate the agent's handle — the kill-switch for a leaked handle. */
+    rotateHandle() {
+        return this.http.request('POST', '/api/agent/profile/handle/rotate', { body: {} });
+    }
+}
+//# sourceMappingURL=profile.js.map

package/dist/namespaces/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/namespaces/profile.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAGpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;OAIG;IACH,SAAS,CAAC,QAAgB;QACxB,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,uEAAuE;IACvE,YAAY;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kCAAkC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}

package/dist/namespaces/questions.d.ts

@@ -0,0 +1,41 @@
+import type { HttpClient } from '../http.js';
+import type { ListQuestionsInput, Question, QuestionInput, WaitForOutcomeOptions, WaitQuestionInput } from '../types.js';
+/**
+ * The general human-in-the-loop primitive: ask a human a question with 2–4
+ * options (or a short typed answer) and block until they tap an answer. An
+ * {@link ApprovalsApi | approval} is the two-option case; reach for questions
+ * when you need more choices, a typed reply, or room-scope answering.
+ */
+export declare class QuestionsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Ask a Question in a room; returns the pending Question (id + computed
+     * expiry). Pass `resolution_policy: 'all'` to poll the room: everyone asked
+     * votes once, and `results` carries the tally on every read.
+     */
+    ask(inviteCode: string, input: QuestionInput): Promise<Question>;
+    /** Fetch a Question's current state. */
+    get(questionId: string): Promise<Question>;
+    /** One long-poll for the answer; returns the (possibly still-pending) Question. */
+    wait(questionId: string, input?: WaitQuestionInput): Promise<Question>;
+    /**
+     * Block until the human answers (or the question expires/cancels), looping
+     * wait() under the hood. Returns the resolved Question — inspect `state` and
+     * `answer.value` to branch. A poll returns once it closes; its `answer` is the
+     * leading option, or `null` on a tie, and `results` holds the tally.
+     *
+     * Polls start at least 2.1 s apart. A response that is not this Question in a
+     * known state 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 Question's
+     * `expires_at` by 5 minutes (15 minutes of failures while no `expires_at` has
+     * been read); that rejects with `unavailable`. See {@link WaitForOutcomeOptions}.
+     */
+    waitForAnswer(questionId: string, input?: WaitForOutcomeOptions): Promise<Question>;
+    /** List the asker's Questions, optionally filtered by state. */
+    list(input?: ListQuestionsInput): Promise<Question[]>;
+    /** Withdraw a still-pending Question (409 if it already resolved). */
+    cancel(questionId: string): Promise<Question>;
+}
+//# sourceMappingURL=questions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../src/namespaces/questions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,KAAK,EACV,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAqBrB;;;;;GAKG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;OAIG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWhE,wCAAwC;IACxC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI1C,mFAAmF;IACnF,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,iBAAsB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ1E;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,qBAA0B,GAAG,OAAO,CAAC,QAAQ,CAAC;IAe7F,gEAAgE;IAC1D,IAAI,CAAC,KAAK,GAAE,kBAAuB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAO/D,sEAAsE;IACtE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAG9C"}

package/dist/namespaces/questions.js

@@ -0,0 +1,107 @@
+// `pr.questions`: Questions and polls in a room.
+import { PingRoomError } from '../errors.js';
+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, sameId, invalidWaitResponse } from '../internal/validate.js';
+const QUESTION_STATES = new Set(['pending', 'answered', 'expired', 'cancelled']);
+function validateQuestionWait(value, questionId) {
+    const state = isRecord(value) ? value['state'] : undefined;
+    if (!isRecord(value) || !sameId(value['id'], questionId) || typeof state !== 'string' || !QUESTION_STATES.has(state)) {
+        return invalidWaitResponse('question', questionId, value, 'state');
+    }
+    return value;
+}
+/**
+ * The general human-in-the-loop primitive: ask a human a question with 2–4
+ * options (or a short typed answer) and block until they tap an answer. An
+ * {@link ApprovalsApi | approval} is the two-option case; reach for questions
+ * when you need more choices, a typed reply, or room-scope answering.
+ */
+export class QuestionsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Ask a Question in a room; returns the pending Question (id + computed
+     * expiry). Pass `resolution_policy: 'all'` to poll the room: everyone asked
+     * votes once, and `results` carries the tally on every read.
+     */
+    ask(inviteCode, input) {
+        requireNonEmpty(input.prompt, 'prompt');
+        assertStructuredData(input.data);
+        assertPollShape(input);
+        const { body, headers } = splitIdempotencyKey(input);
+        return this.http.request('POST', `/api/agent/rooms/${enc(inviteCode)}/questions`, {
+            body: dropUndefined(body),
+            ...(headers ? { headers } : {}),
+        });
+    }
+    /** Fetch a Question's current state. */
+    get(questionId) {
+        return this.http.request('GET', `/api/agent/questions/${enc(questionId)}`);
+    }
+    /** One long-poll for the answer; returns the (possibly still-pending) Question. */
+    wait(questionId, input = {}) {
+        return this.http.request('GET', `/api/agent/questions/${enc(questionId)}/wait`, {
+            query: dropUndefined({ timeout: input.timeout }),
+            timeoutMs: waitTimeoutMs(input.timeout),
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+    }
+    /**
+     * Block until the human answers (or the question expires/cancels), looping
+     * wait() under the hood. Returns the resolved Question — inspect `state` and
+     * `answer.value` to branch. A poll returns once it closes; its `answer` is the
+     * leading option, or `null` on a tie, and `results` holds the tally.
+     *
+     * Polls start at least 2.1 s apart. A response that is not this Question in a
+     * known state 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 Question'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 waitForAnswer(questionId, input = {}) {
+        requireNonEmpty(questionId, 'questionId');
+        assertOnRetry(input.onRetry);
+        return pollUntilSettled({
+            poll: () => this.wait(questionId, input.signal ? { signal: input.signal } : {}),
+            validate: (value) => validateQuestionWait(value, questionId),
+            settled: (question) => question.state !== 'pending',
+            expiresAt: (question) => question.expires_at,
+            what: `question ${questionId}`,
+            minIntervalMs: MIN_WAIT_POLL_INTERVAL_MS,
+            ...(input.signal ? { signal: input.signal } : {}),
+            ...(input.onRetry ? { onRetry: input.onRetry } : {}),
+        });
+    }
+    /** List the asker's Questions, optionally filtered by state. */
+    async list(input = {}) {
+        const res = await this.http.request('GET', '/api/agent/questions', {
+            query: dropUndefined({ state: input.state }),
+        });
+        return res.questions ?? [];
+    }
+    /** Withdraw a still-pending Question (409 if it already resolved). */
+    cancel(questionId) {
+        return this.http.request('POST', `/api/agent/questions/${enc(questionId)}/cancel`, { body: {} });
+    }
+}
+/**
+ * A poll asks the whole room and counts option votes, so the server refuses it
+ * (422 on `resolution_policy`) alongside a direct scope, a named target, or a
+ * typed answer. Fail before the request instead.
+ */
+function assertPollShape(input) {
+    if (input.resolution_policy !== 'all')
+        return;
+    const target = input.target_user_id;
+    if (input.responder_scope === 'direct'
+        || (target !== undefined && target !== null && target !== '')
+        || (input.text_input !== undefined && input.text_input !== null)) {
+        throw new PingRoomError("A poll (`resolution_policy: 'all'`) asks the whole room with options only; it cannot use `responder_scope: 'direct'`, `target_user_id`, or `text_input`.", { code: 'invalid_request' });
+    }
+}
+//# sourceMappingURL=questions.js.map

package/dist/namespaces/questions.js.map

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

package/dist/namespaces/rooms.d.ts

@@ -0,0 +1,13 @@
+import type { HttpClient } from '../http.js';
+import type { CreatePublicRoomInput, CreateRoomInput, JoinRoomInput, Room, RoomIconCatalog } from '../types.js';
+export declare class RoomsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    icons(): Promise<RoomIconCatalog>;
+    list(): Promise<Room[]>;
+    get(inviteCode: string): Promise<Room>;
+    create(input: CreateRoomInput): Promise<Room>;
+    createPublic(input: CreatePublicRoomInput): Promise<Room>;
+    join(input: JoinRoomInput): Promise<Room>;
+}
+//# sourceMappingURL=rooms.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.d.ts","sourceRoot":"","sources":["../../src/namespaces/rooms.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,IAAI,EACJ,eAAe,EAChB,MAAM,aAAa,CAAC;AAGrB,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IAIjC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAIvB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAI1C"}

package/dist/namespaces/rooms.js

@@ -0,0 +1,41 @@
+// `pr.rooms`: list, read, create and join rooms.
+import { PingRoomError } from '../errors.js';
+import { requireNonEmpty } from '../internal/guards.js';
+import { enc, dropUndefined } from '../internal/request.js';
+export class RoomsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    icons() {
+        return this.http.request('GET', '/api/agent/room-icons');
+    }
+    list() {
+        return this.http.request('GET', '/api/agent/rooms');
+    }
+    get(inviteCode) {
+        return this.http.request('GET', `/api/agent/rooms/${enc(inviteCode)}`);
+    }
+    create(input) {
+        requireNonEmpty(input.name, 'name');
+        return this.http.request('POST', '/api/agent/rooms', { body: dropUndefined({ ...input }) });
+    }
+    createPublic(input) {
+        requireNonEmpty(input.name, 'name');
+        requireNonEmpty(input.handle, 'handle');
+        // The server takes the location trio all-or-nothing; a partial set is a
+        // 422 on a field the caller may not have meant to send at all.
+        const present = [input.location_name, input.location_latitude, input.location_longitude].filter((v) => v !== undefined).length;
+        if (present !== 0 && present !== 3) {
+            throw new PingRoomError('Send `location_name`, `location_latitude` and `location_longitude` together, or none of them.', {
+                code: 'invalid_request',
+            });
+        }
+        return this.http.request('POST', '/api/agent/rooms/public', { body: dropUndefined({ ...input }) });
+    }
+    join(input) {
+        requireNonEmpty(input.invite_code, 'invite_code');
+        return this.http.request('POST', '/api/agent/rooms/join', { body: dropUndefined({ ...input }) });
+    }
+}
+//# sourceMappingURL=rooms.js.map

package/dist/namespaces/rooms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.js","sourceRoot":"","sources":["../../src/namespaces/rooms.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQxD,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,KAAK;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IACtD,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,KAAsB;QAC3B,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,YAAY,CAAC,KAA4B;QACvC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACxC,wEAAwE;QACxE,+DAA+D;QAC/D,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QAC/H,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,aAAa,CAAC,+FAA+F,EAAE;gBACvH,IAAI,EAAE,iBAAiB;aACxB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,yBAAyB,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,IAAI,CAAC,KAAoB;QACvB,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC;CACF"}

package/dist/namespaces/webhooks.d.ts

@@ -0,0 +1,11 @@
+import type { HttpClient } from '../http.js';
+import type { CreateWebhookInput, UpdateWebhookInput, Webhook } from '../types.js';
+export declare class WebhooksApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(inviteCode: string): Promise<Webhook[]>;
+    create(inviteCode: string, input: CreateWebhookInput): Promise<Webhook>;
+    update(inviteCode: string, webhookId: string, input: UpdateWebhookInput): Promise<Webhook>;
+    delete(inviteCode: string, webhookId: string): Promise<void>;
+}
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/namespaces/webhooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGnF,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEvC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAOlD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpF,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAInE"}

package/dist/namespaces/webhooks.js

@@ -0,0 +1,32 @@
+// `pr.webhooks`: a room's incoming webhooks.
+import { assertActionNumber, requireNonEmpty } from '../internal/guards.js';
+import { enc, dropUndefined } from '../internal/request.js';
+export class WebhooksApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async list(inviteCode) {
+        const result = await this.http.request('GET', `/api/agent/rooms/${enc(inviteCode)}/webhooks`);
+        return result.webhooks;
+    }
+    create(inviteCode, input) {
+        requireNonEmpty(input.name, 'name');
+        assertActionNumber(input.action_number);
+        return this.http.request('POST', `/api/agent/rooms/${enc(inviteCode)}/webhooks`, {
+            body: dropUndefined({ ...input }),
+        });
+    }
+    update(inviteCode, webhookId, input) {
+        requireNonEmpty(webhookId, 'webhookId');
+        assertActionNumber(input.action_number);
+        return this.http.request('PUT', `/api/agent/rooms/${enc(inviteCode)}/webhooks/${enc(webhookId)}`, {
+            body: dropUndefined({ ...input }),
+        });
+    }
+    async delete(inviteCode, webhookId) {
+        requireNonEmpty(webhookId, 'webhookId');
+        await this.http.request('DELETE', `/api/agent/rooms/${enc(inviteCode)}/webhooks/${enc(webhookId)}`);
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/namespaces/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/namespaces/webhooks.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAG7C,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,KAAK,CAAC,IAAI,CAAC,UAAkB;QAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACpC,KAAK,EAAE,oBAAoB,GAAG,CAAC,UAAU,CAAC,WAAW,CACtD,CAAC;QACF,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,UAAkB,EAAE,KAAyB;QAClD,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,kBAAkB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE;YAC/E,IAAI,EAAE,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,UAAkB,EAAE,SAAiB,EAAE,KAAyB;QACrE,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACxC,kBAAkB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,CAAC,UAAU,CAAC,aAAa,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE;YAChG,IAAI,EAAE,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,SAAiB;QAChD,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,oBAAoB,GAAG,CAAC,UAAU,CAAC,aAAa,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;CACF"}

package/dist/types/approvals.d.ts

@@ -0,0 +1,62 @@
+import type { PingRoomError } from '../errors.js';
+import type { JsonObject } from './common.js';
+export interface ApprovalInput {
+    question: string;
+    title?: string;
+    options?: string[];
+    correlation_id?: string;
+    data?: JsonObject;
+    ttl?: number;
+    /**
+     * Sent as the `Idempotency-Key` header (1–255 printable ASCII characters,
+     * spaces allowed), never in the body.
+     * Reuse the same key when retrying after a timeout or network error: the
+     * server replays the first result instead of asking the human a second time.
+     */
+    idempotencyKey?: string;
+}
+export interface Approval {
+    id: string;
+    /**
+     * A human answer has status `decided`; inspect `decision` for the chosen
+     * option. `approved`/`denied` are never sent.
+     */
+    status: 'pending' | 'decided' | 'expired' | 'cancelled' | (string & {});
+    question: string;
+    title: string | null;
+    options: string[];
+    decision: string | null;
+    decided_at: string | null;
+    expires_at: string | null;
+    correlation_id: string | null;
+    data: JsonObject | null;
+    /** Null when the approval's room no longer exists. */
+    room_code: string | null;
+    [key: string]: unknown;
+}
+export interface WaitApprovalInput {
+    /** Seconds the server holds the connection (0–30, default 20). */
+    timeout?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Options for the blocking waits: `approvals.waitForDecision()`,
+ * `questions.waitForAnswer()` and `handoffs.waitForResult()`.
+ *
+ * Network errors, request timeouts, 429 and 5xx are retried with backoff. The
+ * retries stop with `PingRoomError` code `unavailable` (the last failure as
+ * its `cause`) once only failures have come back since the last valid
+ * response and the last-seen `expires_at` is more than 5 minutes past, or,
+ * before any `expires_at` was seen, after 15 minutes of unbroken failures.
+ */
+export interface WaitForOutcomeOptions {
+    /** Abort to stop waiting; the wait rejects with the signal's reason. */
+    signal?: AbortSignal;
+    /**
+     * Called before each retry of a transient failure, with that failure and
+     * the number of consecutive failures so far (1 on the first). Throwing from
+     * it ends the wait with the thrown error.
+     */
+    onRetry?: (error: PingRoomError, attempt: number) => void;
+}
+//# sourceMappingURL=approvals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/types/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,sDAAsD;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D"}

package/dist/types/approvals.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=approvals.js.map

package/dist/types/approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/types/approvals.ts"],"names":[],"mappings":""}