@parlor/agent-ui 0.0.0-stage → 0.1.0

package/dist/server/audience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audience.d.ts","sourceRoot":"","sources":["../../src/server/audience.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,MAAM,EAAU,MAAM,cAAc,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAElF;AAED,+FAA+F;AAC/F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI9E"}

package/dist/server/audience.js

@@ -0,0 +1,15 @@
+import { DEV_USER_ID, userOf } from "@parlor/core";
+/**
+ * Whose screens a request may see and drive: its scope and, once signed in, its user.
+ * Without auth, or as the dev user, it is the scope itself.
+ */
+export function audienceOf(scope, principal) {
+    return userAudience(scope, userOf(principal));
+}
+/** `audienceOf` for a known user: the sync stream only that user's tabs and computers hear. */
+export function userAudience(scope, userId) {
+    return userId === undefined || userId === DEV_USER_ID
+        ? scope
+        : `${scope}\u001f${userId}`;
+}
+//# sourceMappingURL=audience.js.map

package/dist/server/audience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audience.js","sourceRoot":"","sources":["../../src/server/audience.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA+B,MAAM,EAAE,MAAM,cAAc,CAAC;AAEhF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,SAAgC;IACxE,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,MAA0B;IACpE,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,WAAW;QACnD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,GAAG,KAAK,SAAS,MAAM,EAAE,CAAC;AAChC,CAAC"}

package/dist/server/broker.d.ts

@@ -0,0 +1,29 @@
+import { type AgentOrigin, type UiError, type UiOp, type UiOpInput, type UiOpResults, type UiReply } from "../protocol.js";
+import type { ClientTarget } from "./directory.js";
+export declare class UiFailure extends Error {
+    readonly error: UiError;
+    constructor(error: UiError);
+}
+export interface BrokerOptions {
+    readonly timeoutMs: number;
+    readonly maxPendingPerClient?: number | undefined;
+    readonly maxPending?: number | undefined;
+    readonly newId?: (() => string) | undefined;
+    readonly now?: (() => number) | undefined;
+    readonly setTimeout?: typeof globalThis.setTimeout | undefined;
+    readonly clearTimeout?: typeof globalThis.clearTimeout | undefined;
+}
+export interface UiReceipt {
+    readonly accepted: boolean;
+    readonly next?: string | undefined;
+}
+export declare class UiBroker {
+    #private;
+    constructor(options: BrokerOptions);
+    request<O extends UiOp>(target: ClientTarget, op: O, input: UiOpInput<O>, origin: AgentOrigin, signal?: AbortSignal): Promise<UiOpResults[O]>;
+    reply(clientId: string, reply: UiReply): UiReceipt;
+    reconnected(target: ClientTarget): void;
+    abandon(clientId: string): void;
+    close(): void;
+}
+//# sourceMappingURL=broker.d.ts.map

package/dist/server/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/server/broker.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,WAAW,EAEhB,KAAK,OAAO,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,qBAAa,SAAU,SAAQ,KAAK;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO;IAAnC,YAAqB,KAAK,EAAE,OAAO,EAElC;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC,UAAU,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC,YAAY,GAAG,SAAS,CAAC;CACpE;AAiBD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAqBD,qBAAa,QAAQ;;IAWnB,YAAY,OAAO,EAAE,aAAa,EASjC;IAED,OAAO,CAAC,CAAC,SAAS,IAAI,EACpB,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA+CzB;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAKjD;IAED,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAMtC;IAED,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAO9B;IAED,KAAK,IAAI,IAAI,CAOZ;CA+BF"}

package/dist/server/broker.js

@@ -0,0 +1,152 @@
+import { uiOpReadOnly, } from "../protocol.js";
+export class UiFailure extends Error {
+    error;
+    constructor(error) {
+        super(error.message);
+        this.error = error;
+    }
+}
+function unanswered(pending, reason) {
+    if (!pending.dispatched) {
+        return { code: "timeout", message: `${reason} The app did not receive it.` };
+    }
+    if (pending.readOnly) {
+        return {
+            code: "timeout",
+            message: `${reason} Nothing on screen changed; retrying is safe.`,
+        };
+    }
+    return {
+        code: "outcome_unknown",
+        message: `${reason} The app may still have applied it; read the screen before retrying.`,
+    };
+}
+const DEFAULT_MAX_PENDING_PER_CLIENT = 8;
+const DEFAULT_MAX_PENDING = 256;
+export class UiBroker {
+    #timeoutMs;
+    #maxPendingPerClient;
+    #maxPending;
+    #newId;
+    #now;
+    #setTimeout;
+    #clearTimeout;
+    #pending = new Map();
+    #lanes = new Map();
+    constructor(options) {
+        this.#timeoutMs = options.timeoutMs;
+        this.#maxPendingPerClient =
+            options.maxPendingPerClient ?? DEFAULT_MAX_PENDING_PER_CLIENT;
+        this.#maxPending = options.maxPending ?? DEFAULT_MAX_PENDING;
+        this.#newId = options.newId ?? (() => crypto.randomUUID());
+        this.#now = options.now ?? (() => Date.now());
+        this.#setTimeout = options.setTimeout ?? ((fn, ms) => globalThis.setTimeout(fn, ms));
+        this.#clearTimeout = options.clearTimeout ?? ((id) => globalThis.clearTimeout(id));
+    }
+    request(target, op, input, origin, signal) {
+        const clientId = target.client.id;
+        if (this.#pending.size >= this.#maxPending ||
+            (this.#lanes.get(clientId)?.queue.length ?? 0) >= this.#maxPendingPerClient) {
+            return Promise.reject(new UiFailure({
+                code: "busy",
+                message: "Too many UI requests are waiting for this app; try again shortly.",
+            }));
+        }
+        const id = this.#newId();
+        const frame = JSON.stringify({ id, op, input, origin, timeoutMs: this.#timeoutMs });
+        return new Promise((resolve, reject) => {
+            const giveUp = (reason) => this.#giveUp(pending, reason);
+            const onAbort = () => giveUp("The UI request was cancelled.");
+            const timer = this.#setTimeout(() => giveUp(`The app did not answer within ${this.#timeoutMs} ms.`), this.#timeoutMs);
+            const pending = {
+                id,
+                clientId,
+                frame,
+                readOnly: uiOpReadOnly[op],
+                deadline: this.#now() + this.#timeoutMs,
+                dispatched: false,
+                settle: (outcome) => {
+                    this.#clearTimeout(timer);
+                    signal?.removeEventListener("abort", onAbort);
+                    if (!("type" in outcome))
+                        reject(new UiFailure(outcome));
+                    else if (outcome.ok)
+                        resolve(outcome.result);
+                    else
+                        reject(new UiFailure(outcome.error));
+                },
+            };
+            this.#pending.set(id, pending);
+            const lane = this.#lanes.get(clientId) ?? { target, queue: [] };
+            lane.target = target;
+            lane.queue.push(pending);
+            this.#lanes.set(clientId, lane);
+            signal?.addEventListener("abort", onAbort, { once: true });
+            if (lane.queue[0] === pending)
+                pending.dispatched = target.send(frame);
+            if (signal?.aborted)
+                onAbort();
+        });
+    }
+    reply(clientId, reply) {
+        const pending = this.#pending.get(reply.id);
+        if (!pending || pending.clientId !== clientId)
+            return { accepted: false };
+        this.#finish(pending, reply);
+        return { accepted: true, next: this.#handOver(clientId) };
+    }
+    reconnected(target) {
+        const lane = this.#lanes.get(target.client.id);
+        if (!lane)
+            return;
+        lane.target = target;
+        const head = lane.queue[0];
+        if (head && target.send(head.frame))
+            head.dispatched = true;
+    }
+    abandon(clientId) {
+        for (const pending of [...(this.#lanes.get(clientId)?.queue ?? [])]) {
+            this.#finish(pending, unanswered(pending, "The app client closed before it answered."));
+        }
+    }
+    close() {
+        for (const pending of [...this.#pending.values()]) {
+            this.#finish(pending, {
+                code: "internal",
+                message: "The server is shutting down.",
+            });
+        }
+    }
+    #giveUp(pending, reason) {
+        if (!this.#finish(pending, unanswered(pending, reason)))
+            return;
+        const lane = this.#lanes.get(pending.clientId);
+        const next = this.#waiting(pending.clientId);
+        if (lane && next)
+            next.dispatched = lane.target.send(next.frame);
+    }
+    #handOver(clientId) {
+        const next = this.#waiting(clientId);
+        if (!next)
+            return undefined;
+        next.dispatched = true;
+        return next.frame;
+    }
+    #waiting(clientId) {
+        const head = this.#lanes.get(clientId)?.queue[0];
+        return head && !head.dispatched && head.deadline > this.#now() ? head : undefined;
+    }
+    #finish(pending, outcome) {
+        if (!this.#pending.delete(pending.id))
+            return false;
+        const lane = this.#lanes.get(pending.clientId);
+        if (lane) {
+            lane.queue.splice(lane.queue.indexOf(pending), 1);
+            if (lane.queue.length === 0)
+                this.#lanes.delete(pending.clientId);
+        }
+        pending.settle(outcome);
+        return true;
+    }
+}
+//# sourceMappingURL=broker.js.map

package/dist/server/broker.js.map

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

package/dist/server/confirmations.d.ts

@@ -0,0 +1,40 @@
+import type { AgentOrigin, ConfirmationAnswer } from "../protocol.js";
+import type { ClientDirectory } from "./directory.js";
+/** The 60 s the user gets, less 1 s so a client on MCP's default 60 s timeout hears our code. */
+export declare const DEFAULT_CONFIRM_TIMEOUT_MS = 59000;
+export declare const ORPHAN_GRACE_MS = 5000;
+export declare const MAX_PENDING_PER_SCOPE = 8;
+export interface ConfirmationRequest {
+    readonly scope: string;
+    readonly clientId?: string | undefined;
+    /**
+     * Set when an inline agent asks inside a chat turn: the audience is then every client
+     * watching the thread plus `clientId`, not the presence selection.
+     */
+    readonly thread?: ConfirmationThread | undefined;
+    readonly action: string;
+    readonly description: string;
+    readonly input: unknown;
+    readonly origin: AgentOrigin;
+    readonly signal?: AbortSignal | undefined;
+}
+export interface ConfirmationThread {
+    readonly threadId: string;
+    readonly turnId: string;
+}
+export type ConfirmationOutcome = "approved" | "declined" | "timeout" | "unavailable" | "cancelled" | "shutdown";
+export interface ConfirmationBoardOptions {
+    readonly directory: ClientDirectory;
+    readonly timeoutMs: number;
+    readonly orphanGraceMs?: number | undefined;
+    readonly maxPendingPerScope?: number | undefined;
+    readonly newId?: (() => string) | undefined;
+}
+export declare class ConfirmationBoard {
+    #private;
+    constructor(options: ConfirmationBoardOptions);
+    ask(request: ConfirmationRequest): Promise<ConfirmationOutcome>;
+    answer(clientId: string, scope: string, answer: ConfirmationAnswer): boolean;
+    close(): void;
+}
+//# sourceMappingURL=confirmations.d.ts.map

package/dist/server/confirmations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmations.d.ts","sourceRoot":"","sources":["../../src/server/confirmations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAGnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,gBAAgB,CAAC;AAEzE,iGAAiG;AACjG,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,eAAO,MAAM,eAAe,OAAQ,CAAC;AAErC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,UAAU,GACV,SAAS,GACT,aAAa,GACb,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7C;AA8CD,qBAAa,iBAAiB;;IAY5B,YAAY,OAAO,EAAE,wBAAwB,EAQ5C;IAED,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmC9D;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAO3E;IAED,KAAK,IAAI,IAAI,CAKZ;CAsHF"}

package/dist/server/confirmations.js

@@ -0,0 +1,230 @@
+/** The 60 s the user gets, less 1 s so a client on MCP's default 60 s timeout hears our code. */
+export const DEFAULT_CONFIRM_TIMEOUT_MS = 59_000;
+export const ORPHAN_GRACE_MS = 5_000;
+export const MAX_PENDING_PER_SCOPE = 8;
+class Pending {
+    id;
+    request;
+    deadline;
+    finish;
+    cleanup;
+    audience = new Set();
+    orphanTimer;
+    #deadlineTimer;
+    #settled = false;
+    constructor(id, request, deadline, finish, cleanup) {
+        this.id = id;
+        this.request = request;
+        this.deadline = deadline;
+        this.finish = finish;
+        this.cleanup = cleanup;
+    }
+    armDeadline(timeoutMs) {
+        this.#deadlineTimer = setTimeout(() => this.settle("timeout"), timeoutMs);
+    }
+    settle(outcome) {
+        if (this.#settled)
+            return;
+        this.#settled = true;
+        clearTimeout(this.#deadlineTimer);
+        clearTimeout(this.orphanTimer);
+        this.cleanup();
+        this.finish(outcome);
+    }
+}
+const EMPTY_LIST = "[]";
+function jsonOf(value) {
+    const seen = new WeakSet();
+    return JSON.stringify(value, (_key, item) => {
+        if (typeof item === "bigint")
+            return item.toString();
+        if (typeof item === "object" && item !== null) {
+            if (seen.has(item))
+                return "[circular]";
+            seen.add(item);
+        }
+        return item;
+    });
+}
+export class ConfirmationBoard {
+    #directory;
+    #timeoutMs;
+    #graceMs;
+    #maxPerScope;
+    #newId;
+    #pending = new Map();
+    #byScope = new Map();
+    #sent = new Map();
+    #forgetting = new Map();
+    #closed = false;
+    constructor(options) {
+        this.#directory = options.directory;
+        this.#timeoutMs = options.timeoutMs;
+        this.#graceMs = options.orphanGraceMs ?? ORPHAN_GRACE_MS;
+        this.#maxPerScope = options.maxPendingPerScope ?? MAX_PENDING_PER_SCOPE;
+        let ids = 0;
+        this.#newId = options.newId ?? (() => `${Date.now().toString(36)}-${++ids}`);
+        options.directory.subscribe(this.#changed);
+    }
+    ask(request) {
+        const { scope, signal } = request;
+        if (this.#closed)
+            return Promise.resolve("shutdown");
+        if (signal?.aborted)
+            return Promise.resolve("cancelled");
+        if ((this.#byScope.get(scope)?.size ?? 0) >= this.#maxPerScope) {
+            return Promise.resolve("unavailable");
+        }
+        const audience = this.#selected(request);
+        if (audience.length === 0)
+            return Promise.resolve("unavailable");
+        return new Promise((resolve) => {
+            const onAbort = () => pending.settle("cancelled");
+            const pending = new Pending(this.#newId(), request, Date.now() + this.#timeoutMs, resolve, () => {
+                signal?.removeEventListener("abort", onAbort);
+                this.#pending.delete(pending.id);
+                const peers = this.#byScope.get(scope);
+                peers?.delete(pending);
+                if (peers?.size === 0)
+                    this.#byScope.delete(scope);
+                this.#refresh(scope);
+            });
+            for (const id of audience)
+                pending.audience.add(id);
+            this.#pending.set(pending.id, pending);
+            let peers = this.#byScope.get(scope);
+            if (!peers)
+                this.#byScope.set(scope, (peers = new Set()));
+            peers.add(pending);
+            pending.armDeadline(this.#timeoutMs);
+            signal?.addEventListener("abort", onAbort, { once: true });
+            this.#refresh(scope);
+        });
+    }
+    answer(clientId, scope, answer) {
+        const pending = this.#pending.get(answer.id);
+        if (!pending || pending.request.scope !== scope || !pending.audience.has(clientId)) {
+            return false;
+        }
+        pending.settle(answer.approve ? "approved" : "declined");
+        return true;
+    }
+    close() {
+        this.#closed = true;
+        for (const pending of [...this.#pending.values()])
+            pending.settle("shutdown");
+        for (const timer of this.#forgetting.values())
+            clearTimeout(timer);
+        this.#forgetting.clear();
+    }
+    #changed = (scope, clientId, change) => {
+        const peers = this.#byScope.get(scope);
+        if (change === "left") {
+            for (const pending of peers ?? [])
+                pending.audience.delete(clientId);
+            this.#forgetLater(clientId);
+        }
+        if (change === "joined") {
+            this.#stopForgetting(clientId);
+            if (this.#sent.has(clientId)) {
+                this.#sent.set(clientId, { scope, signature: "stale" });
+            }
+        }
+        this.#refresh(scope);
+    };
+    #forgetLater(clientId) {
+        this.#stopForgetting(clientId);
+        if (!this.#sent.has(clientId))
+            return;
+        const timer = setTimeout(() => {
+            this.#forgetting.delete(clientId);
+            this.#sent.delete(clientId);
+        }, this.#timeoutMs);
+        timer.unref();
+        this.#forgetting.set(clientId, timer);
+    }
+    #stopForgetting(clientId) {
+        clearTimeout(this.#forgetting.get(clientId));
+        this.#forgetting.delete(clientId);
+    }
+    #selected(request) {
+        if (request.thread)
+            return this.#watchers(request, request.thread);
+        const selection = this.#directory.select(request.scope, request.clientId);
+        if (!selection)
+            return [];
+        return [selection.target.client, ...selection.tied]
+            .filter((client) => client.canConfirm)
+            .map((client) => client.id);
+    }
+    #watchers(request, thread) {
+        return this.#directory
+            .targets(request.scope)
+            .map(({ client }) => client)
+            .filter((client) => client.canConfirm &&
+            (client.id === request.clientId || client.watching.includes(thread.threadId)))
+            .map((client) => client.id);
+    }
+    #canShow(clientId) {
+        return this.#directory.target(clientId)?.client.canConfirm ?? false;
+    }
+    #refresh(scope) {
+        const peers = this.#byScope.get(scope);
+        if (!peers && ![...this.#sent.values()].some((sent) => sent.scope === scope))
+            return;
+        for (const pending of peers ?? []) {
+            const selected = this.#selected(pending.request);
+            if (pending.request.thread)
+                pending.audience.clear();
+            for (const id of selected)
+                pending.audience.add(id);
+        }
+        for (const target of this.#directory.targets(scope)) {
+            this.#deliver(target, [...(peers ?? [])]);
+        }
+        for (const pending of peers ?? [])
+            this.#watchOrphan(pending);
+    }
+    #deliver(target, peers) {
+        const { id, scope, canConfirm } = target.client;
+        const mine = canConfirm ? peers.filter((pending) => pending.audience.has(id)) : [];
+        const now = Date.now();
+        const prompts = mine.map((pending) => this.#prompt(pending, now));
+        const signature = prompts.length === 0
+            ? EMPTY_LIST
+            : jsonOf(prompts.map(({ expiresInMs: _expires, ...rest }) => rest));
+        const previous = this.#sent.get(id)?.signature;
+        if (previous === signature || (previous === undefined && prompts.length === 0))
+            return;
+        const frame = { type: "confirmations", items: prompts };
+        if (!target.send(jsonOf(frame)))
+            return;
+        if (prompts.length === 0)
+            this.#sent.delete(id);
+        else
+            this.#sent.set(id, { scope, signature });
+    }
+    #prompt(pending, now) {
+        const { id, request, deadline } = pending;
+        return {
+            id,
+            action: request.action,
+            description: request.description,
+            input: request.input ?? null,
+            origin: request.origin,
+            expiresInMs: Math.max(0, deadline - now),
+            ...(request.thread ? { threadId: request.thread.threadId } : {}),
+        };
+    }
+    #watchOrphan(pending) {
+        const shown = [...pending.audience].some((id) => this.#canShow(id));
+        if (shown) {
+            clearTimeout(pending.orphanTimer);
+            pending.orphanTimer = undefined;
+        }
+        else if (pending.orphanTimer === undefined) {
+            pending.orphanTimer = setTimeout(() => pending.settle("unavailable"), this.#graceMs);
+        }
+    }
+}
+//# sourceMappingURL=confirmations.js.map

package/dist/server/confirmations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmations.js","sourceRoot":"","sources":["../../src/server/confirmations.ts"],"names":[],"mappings":"AAQA,iGAAiG;AACjG,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAEjD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAwCvC,MAAM,OAAO;IAOA,EAAE;IACF,OAAO;IACP,QAAQ;IACA,MAAM;IACN,OAAO;IAVjB,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,WAAW,CAAoB;IAC/B,cAAc,CAAoB;IAClC,QAAQ,GAAG,KAAK,CAAC;IAEjB,YACW,EAAU,EACV,OAA4B,EAC5B,QAAgB,EACR,MAA8C,EAC9C,OAAmB;kBAJ3B,EAAE;uBACF,OAAO;wBACP,QAAQ;sBACA,MAAM;uBACN,OAAO;IACvB,CAAC;IAEJ,WAAW,CAAC,SAAiB;QAC3B,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,OAA4B;QACjC,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAClC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,SAAS,MAAM,CAAC,KAAc;IAC5B,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAa,EAAE,EAAE;QACnD,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,YAAY,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,iBAAiB;IACnB,UAAU,CAAkB;IAC5B,UAAU,CAAS;IACnB,QAAQ,CAAS;IACjB,YAAY,CAAS;IACrB,MAAM,CAAe;IACrB,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtC,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC3C,KAAK,GAAG,IAAI,GAAG,EAAyD,CAAC;IACzE,WAAW,GAAG,IAAI,GAAG,EAAiB,CAAC;IAChD,OAAO,GAAG,KAAK,CAAC;IAEhB,YAAY,OAAiC;QAC3C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,aAAa,IAAI,eAAe,CAAC;QACzD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,kBAAkB,IAAI,qBAAqB,CAAC;QACxE,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7E,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,GAAG,CAAC,OAA4B;QAC9B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAClC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAEjE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,IAAI,OAAO,CACzB,IAAI,CAAC,MAAM,EAAE,EACb,OAAO,EACP,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,EAC5B,OAAO,EACP,GAAG,EAAE;gBACH,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACjC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACvC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBACvB,IAAI,KAAK,EAAE,IAAI,KAAK,CAAC;oBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC,CACF,CAAC;YACF,KAAK,MAAM,EAAE,IAAI,QAAQ;gBAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACvC,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1D,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACnB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACrC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,QAAgB,EAAE,KAAa,EAAE,MAA0B;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEQ,QAAQ,GAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,KAAK,MAAM,OAAO,IAAI,KAAK,IAAI,EAAE;gBAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpB,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,eAAe,CAAC,QAAgB;QAC9B,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,SAAS,CAAC,OAA4B;QACpC,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACnE,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1E,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1B,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC;aAChD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;aACrC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,OAA4B,EAAE,MAA0B;QAChE,OAAO,IAAI,CAAC,UAAU;aACnB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;aACtB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC;aAC3B,MAAM,CACL,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU;YACjB,CAAC,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAChF;aACA,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,QAAQ,CAAC,QAAgB;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC;IACtE,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC;YAAE,OAAO;QACrF,KAAK,MAAM,OAAO,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACjD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM;gBAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACrD,KAAK,MAAM,EAAE,IAAI,QAAQ;gBAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,KAAK,IAAI,EAAE;YAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,QAAQ,CACN,MAAsD,EACtD,KAAyB;QAEzB,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;QAChD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAClE,MAAM,SAAS,GACb,OAAO,CAAC,MAAM,KAAK,CAAC;YAClB,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;QAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;YAC5E,OAAO;QACT,MAAM,KAAK,GAAuB,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC5E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO;QACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;;YAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,CAAC,OAAgB,EAAE,GAAW;QACnC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAC1C,OAAO;YACL,EAAE;YACF,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,GAAG,CAAC;YACxC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,OAAgB;QAC3B,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAClC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;QAClC,CAAC;aAAM,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YAC7C,OAAO,CAAC,WAAW,GAAG,UAAU,CAC9B,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,EACnC,IAAI,CAAC,QAAQ,CACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/server/directory.d.ts

@@ -0,0 +1,41 @@
+import type { ChannelConnection } from "@parlor/sync";
+import { type ClientSummary, type PresenceUpdate, type UiOp } from "../protocol.js";
+export interface ConnectedClient {
+    readonly id: string;
+    readonly scope: string;
+    readonly platform: string;
+    readonly buildId: string | undefined;
+    readonly focused: boolean;
+    readonly visible: boolean;
+    readonly ops: readonly UiOp[];
+    readonly canConfirm: boolean;
+    readonly watching: readonly string[];
+    readonly seenAt: number;
+}
+export interface ClientTarget {
+    readonly client: ConnectedClient;
+    send(data: string): boolean;
+}
+export interface Selection {
+    readonly target: ClientTarget;
+    readonly tied: readonly ConnectedClient[];
+}
+export type PresenceOutcome = "rejected" | "updated" | "registered";
+export type DirectoryChange = "joined" | "updated" | "left";
+export type DirectoryListener = (scope: string, clientId: string, change: DirectoryChange) => void;
+export declare class ClientDirectory {
+    #private;
+    constructor(now?: () => number);
+    subscribe(listener: DirectoryListener): () => void;
+    connect(stream: ChannelConnection): () => void;
+    touch(clientId: string | undefined, scope: string): void;
+    presence(clientId: string, scope: string, update: PresenceUpdate): PresenceOutcome;
+    leave(clientId: string, scope: string): boolean;
+    connected(scope: string, clientId: string): boolean;
+    targets(scope: string): readonly ClientTarget[];
+    target(clientId: string): ClientTarget | undefined;
+    select(scope: string, clientId?: string): Selection | undefined;
+    summaries(scope: string): ClientSummary[];
+    summary(client: ConnectedClient): ClientSummary;
+}
+//# sourceMappingURL=directory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/server/directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,cAAc,EACnB,KAAK,IAAI,EACV,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;CAC3C;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,KACpB,IAAI,CAAC;AAOV,qBAAa,eAAe;;IAQ1B,YAAY,GAAG,GAAE,MAAM,MAAiB,EAEvC;IAED,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAGjD;IAED,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAY7C;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMvD;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,eAAe,CAgCjF;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAU9C;IAED,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElD;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAE9C;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGjD;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAY9D;IAED,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAIxC;IAED,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAS9C;CAwEF"}