@parlor/agent-ui 0.0.0-stage → 0.2.0

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":"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","sourcesContent":["import type {\n  AgentOrigin,\n  ConfirmationAnswer,\n  ConfirmationPrompt,\n  ConfirmationsFrame,\n} from \"../protocol.js\";\nimport type { ClientDirectory, DirectoryListener } from \"./directory.js\";\n\n/** The 60 s the user gets, less 1 s so a client on MCP's default 60 s timeout hears our code. */\nexport const DEFAULT_CONFIRM_TIMEOUT_MS = 59_000;\n\nexport const ORPHAN_GRACE_MS = 5_000;\n\nexport const MAX_PENDING_PER_SCOPE = 8;\n\nexport interface ConfirmationRequest {\n  readonly scope: string;\n  readonly clientId?: string | undefined;\n  /**\n   * Set when an inline agent asks inside a chat turn: the audience is then every client\n   * watching the thread plus `clientId`, not the presence selection.\n   */\n  readonly thread?: ConfirmationThread | undefined;\n  readonly action: string;\n  readonly description: string;\n  readonly input: unknown;\n  readonly origin: AgentOrigin;\n  readonly signal?: AbortSignal | undefined;\n}\n\nexport interface ConfirmationThread {\n  readonly threadId: string;\n  readonly turnId: string;\n}\n\nexport type ConfirmationOutcome =\n  | \"approved\"\n  | \"declined\"\n  | \"timeout\"\n  | \"unavailable\"\n  | \"cancelled\"\n  | \"shutdown\";\n\nexport interface ConfirmationBoardOptions {\n  readonly directory: ClientDirectory;\n  readonly timeoutMs: number;\n  readonly orphanGraceMs?: number | undefined;\n  readonly maxPendingPerScope?: number | undefined;\n  readonly newId?: (() => string) | undefined;\n}\n\ntype Timer = ReturnType<typeof setTimeout>;\n\nclass Pending {\n  readonly audience = new Set<string>();\n  orphanTimer: Timer | undefined;\n  #deadlineTimer: Timer | undefined;\n  #settled = false;\n\n  constructor(\n    readonly id: string,\n    readonly request: ConfirmationRequest,\n    readonly deadline: number,\n    private readonly finish: (outcome: ConfirmationOutcome) => void,\n    private readonly cleanup: () => void,\n  ) {}\n\n  armDeadline(timeoutMs: number): void {\n    this.#deadlineTimer = setTimeout(() => this.settle(\"timeout\"), timeoutMs);\n  }\n\n  settle(outcome: ConfirmationOutcome): void {\n    if (this.#settled) return;\n    this.#settled = true;\n    clearTimeout(this.#deadlineTimer);\n    clearTimeout(this.orphanTimer);\n    this.cleanup();\n    this.finish(outcome);\n  }\n}\n\nconst EMPTY_LIST = \"[]\";\n\nfunction jsonOf(value: unknown): string {\n  const seen = new WeakSet<object>();\n  return JSON.stringify(value, (_key, item: unknown) => {\n    if (typeof item === \"bigint\") return item.toString();\n    if (typeof item === \"object\" && item !== null) {\n      if (seen.has(item)) return \"[circular]\";\n      seen.add(item);\n    }\n    return item;\n  });\n}\n\nexport class ConfirmationBoard {\n  readonly #directory: ClientDirectory;\n  readonly #timeoutMs: number;\n  readonly #graceMs: number;\n  readonly #maxPerScope: number;\n  readonly #newId: () => string;\n  readonly #pending = new Map<string, Pending>();\n  readonly #byScope = new Map<string, Set<Pending>>();\n  readonly #sent = new Map<string, { readonly scope: string; signature: string }>();\n  readonly #forgetting = new Map<string, Timer>();\n  #closed = false;\n\n  constructor(options: ConfirmationBoardOptions) {\n    this.#directory = options.directory;\n    this.#timeoutMs = options.timeoutMs;\n    this.#graceMs = options.orphanGraceMs ?? ORPHAN_GRACE_MS;\n    this.#maxPerScope = options.maxPendingPerScope ?? MAX_PENDING_PER_SCOPE;\n    let ids = 0;\n    this.#newId = options.newId ?? (() => `${Date.now().toString(36)}-${++ids}`);\n    options.directory.subscribe(this.#changed);\n  }\n\n  ask(request: ConfirmationRequest): Promise<ConfirmationOutcome> {\n    const { scope, signal } = request;\n    if (this.#closed) return Promise.resolve(\"shutdown\");\n    if (signal?.aborted) return Promise.resolve(\"cancelled\");\n    if ((this.#byScope.get(scope)?.size ?? 0) >= this.#maxPerScope) {\n      return Promise.resolve(\"unavailable\");\n    }\n    const audience = this.#selected(request);\n    if (audience.length === 0) return Promise.resolve(\"unavailable\");\n\n    return new Promise((resolve) => {\n      const onAbort = () => pending.settle(\"cancelled\");\n      const pending = new Pending(\n        this.#newId(),\n        request,\n        Date.now() + this.#timeoutMs,\n        resolve,\n        () => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          this.#pending.delete(pending.id);\n          const peers = this.#byScope.get(scope);\n          peers?.delete(pending);\n          if (peers?.size === 0) this.#byScope.delete(scope);\n          this.#refresh(scope);\n        },\n      );\n      for (const id of audience) pending.audience.add(id);\n      this.#pending.set(pending.id, pending);\n      let peers = this.#byScope.get(scope);\n      if (!peers) this.#byScope.set(scope, (peers = new Set()));\n      peers.add(pending);\n      pending.armDeadline(this.#timeoutMs);\n      signal?.addEventListener(\"abort\", onAbort, { once: true });\n      this.#refresh(scope);\n    });\n  }\n\n  answer(clientId: string, scope: string, answer: ConfirmationAnswer): boolean {\n    const pending = this.#pending.get(answer.id);\n    if (!pending || pending.request.scope !== scope || !pending.audience.has(clientId)) {\n      return false;\n    }\n    pending.settle(answer.approve ? \"approved\" : \"declined\");\n    return true;\n  }\n\n  close(): void {\n    this.#closed = true;\n    for (const pending of [...this.#pending.values()]) pending.settle(\"shutdown\");\n    for (const timer of this.#forgetting.values()) clearTimeout(timer);\n    this.#forgetting.clear();\n  }\n\n  readonly #changed: DirectoryListener = (scope, clientId, change) => {\n    const peers = this.#byScope.get(scope);\n    if (change === \"left\") {\n      for (const pending of peers ?? []) pending.audience.delete(clientId);\n      this.#forgetLater(clientId);\n    }\n    if (change === \"joined\") {\n      this.#stopForgetting(clientId);\n      if (this.#sent.has(clientId)) {\n        this.#sent.set(clientId, { scope, signature: \"stale\" });\n      }\n    }\n    this.#refresh(scope);\n  };\n\n  #forgetLater(clientId: string): void {\n    this.#stopForgetting(clientId);\n    if (!this.#sent.has(clientId)) return;\n    const timer = setTimeout(() => {\n      this.#forgetting.delete(clientId);\n      this.#sent.delete(clientId);\n    }, this.#timeoutMs);\n    timer.unref();\n    this.#forgetting.set(clientId, timer);\n  }\n\n  #stopForgetting(clientId: string): void {\n    clearTimeout(this.#forgetting.get(clientId));\n    this.#forgetting.delete(clientId);\n  }\n\n  #selected(request: ConfirmationRequest): string[] {\n    if (request.thread) return this.#watchers(request, request.thread);\n    const selection = this.#directory.select(request.scope, request.clientId);\n    if (!selection) return [];\n    return [selection.target.client, ...selection.tied]\n      .filter((client) => client.canConfirm)\n      .map((client) => client.id);\n  }\n\n  #watchers(request: ConfirmationRequest, thread: ConfirmationThread): string[] {\n    return this.#directory\n      .targets(request.scope)\n      .map(({ client }) => client)\n      .filter(\n        (client) =>\n          client.canConfirm &&\n          (client.id === request.clientId || client.watching.includes(thread.threadId)),\n      )\n      .map((client) => client.id);\n  }\n\n  #canShow(clientId: string): boolean {\n    return this.#directory.target(clientId)?.client.canConfirm ?? false;\n  }\n\n  #refresh(scope: string): void {\n    const peers = this.#byScope.get(scope);\n    if (!peers && ![...this.#sent.values()].some((sent) => sent.scope === scope)) return;\n    for (const pending of peers ?? []) {\n      const selected = this.#selected(pending.request);\n      if (pending.request.thread) pending.audience.clear();\n      for (const id of selected) pending.audience.add(id);\n    }\n    for (const target of this.#directory.targets(scope)) {\n      this.#deliver(target, [...(peers ?? [])]);\n    }\n    for (const pending of peers ?? []) this.#watchOrphan(pending);\n  }\n\n  #deliver(\n    target: ReturnType<ClientDirectory[\"targets\"]>[number],\n    peers: readonly Pending[],\n  ): void {\n    const { id, scope, canConfirm } = target.client;\n    const mine = canConfirm ? peers.filter((pending) => pending.audience.has(id)) : [];\n    const now = Date.now();\n    const prompts = mine.map((pending) => this.#prompt(pending, now));\n    const signature =\n      prompts.length === 0\n        ? EMPTY_LIST\n        : jsonOf(prompts.map(({ expiresInMs: _expires, ...rest }) => rest));\n    const previous = this.#sent.get(id)?.signature;\n    if (previous === signature || (previous === undefined && prompts.length === 0))\n      return;\n    const frame: ConfirmationsFrame = { type: \"confirmations\", items: prompts };\n    if (!target.send(jsonOf(frame))) return;\n    if (prompts.length === 0) this.#sent.delete(id);\n    else this.#sent.set(id, { scope, signature });\n  }\n\n  #prompt(pending: Pending, now: number): ConfirmationPrompt {\n    const { id, request, deadline } = pending;\n    return {\n      id,\n      action: request.action,\n      description: request.description,\n      input: request.input ?? null,\n      origin: request.origin,\n      expiresInMs: Math.max(0, deadline - now),\n      ...(request.thread ? { threadId: request.thread.threadId } : {}),\n    };\n  }\n\n  #watchOrphan(pending: Pending): void {\n    const shown = [...pending.audience].some((id) => this.#canShow(id));\n    if (shown) {\n      clearTimeout(pending.orphanTimer);\n      pending.orphanTimer = undefined;\n    } else if (pending.orphanTimer === undefined) {\n      pending.orphanTimer = setTimeout(\n        () => pending.settle(\"unavailable\"),\n        this.#graceMs,\n      );\n    }\n  }\n}\n"]}

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"}

package/dist/server/directory.js

@@ -0,0 +1,193 @@
+import { isUiOp, LEGACY_UI_OPS, } from "../protocol.js";
+import { audienceOf } from "./audience.js";
+export class ClientDirectory {
+    #now;
+    #byId = new Map();
+    #byScope = new Map();
+    #unannounced = new Map();
+    #listeners = new Set();
+    constructor(now = Date.now) {
+        this.#now = now;
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    connect(stream) {
+        const { clientId } = stream;
+        if (clientId === undefined)
+            return () => { };
+        const connection = {
+            ...stream,
+            scope: audienceOf(stream.scope, stream.principal),
+        };
+        this.#keepUnannounced(clientId, [
+            ...(this.#unannounced.get(clientId) ?? []),
+            connection,
+        ]);
+        return () => this.#disconnect(clientId, connection);
+    }
+    touch(clientId, scope) {
+        if (clientId === undefined)
+            return;
+        const entry = this.#byId.get(clientId);
+        if (!entry || entry.client.scope !== scope)
+            return;
+        entry.client = { ...entry.client, seenAt: this.#now() };
+        this.#notify(entry.client, "updated");
+    }
+    presence(clientId, scope, update) {
+        const announcing = this.#takeUnannounced(clientId, scope);
+        let entry = this.#byId.get(clientId);
+        if (entry && entry.client.scope !== scope) {
+            if (announcing.length === 0)
+                return "rejected";
+            this.#forget(entry);
+            entry = undefined;
+        }
+        if (!entry && announcing.length === 0)
+            return "rejected";
+        const client = {
+            id: clientId,
+            scope,
+            platform: update.platform,
+            buildId: update.buildId,
+            focused: update.focused,
+            visible: update.visible,
+            ops: update.ops ? update.ops.filter(isUiOp) : LEGACY_UI_OPS,
+            canConfirm: update.canConfirm ?? false,
+            watching: update.watching ?? [],
+            seenAt: this.#now(),
+        };
+        if (entry) {
+            entry.client = client;
+        }
+        else {
+            entry = { client, connections: [] };
+            this.#byId.set(clientId, entry);
+            this.#scopeSet(scope).add(entry);
+        }
+        entry.connections.push(...announcing);
+        const outcome = announcing.length > 0 ? "registered" : "updated";
+        this.#notify(client, outcome === "registered" ? "joined" : "updated");
+        return outcome;
+    }
+    leave(clientId, scope) {
+        const entry = this.#byId.get(clientId);
+        if (!entry || entry.client.scope !== scope)
+            return false;
+        const released = entry.connections.splice(0);
+        this.#forget(entry);
+        this.#keepUnannounced(clientId, [
+            ...(this.#unannounced.get(clientId) ?? []),
+            ...released,
+        ]);
+        return true;
+    }
+    connected(scope, clientId) {
+        return this.#byId.get(clientId)?.client.scope === scope;
+    }
+    targets(scope) {
+        return [...(this.#byScope.get(scope) ?? [])].map((entry) => this.#targetOf(entry));
+    }
+    target(clientId) {
+        const entry = this.#byId.get(clientId);
+        return entry && this.#targetOf(entry);
+    }
+    select(scope, clientId) {
+        const entries = [...(this.#byScope.get(scope) ?? [])];
+        if (entries.length === 0)
+            return undefined;
+        const explicit = clientId === undefined ? undefined : this.#byId.get(clientId);
+        if (explicit && explicit.client.scope === scope) {
+            return { target: this.#targetOf(explicit), tied: [] };
+        }
+        const focused = entries.filter((e) => e.client.focused);
+        if (focused.length > 0)
+            return this.#mostRecent(focused, () => true);
+        const visible = entries.filter((e) => e.client.visible);
+        const pool = visible.length > 0 ? visible : entries;
+        return this.#mostRecent(pool, (a, b) => a.client.seenAt === b.client.seenAt);
+    }
+    summaries(scope) {
+        return [...(this.#byScope.get(scope) ?? [])].map((entry) => this.summary(entry.client));
+    }
+    summary(client) {
+        return {
+            id: client.id,
+            platform: client.platform,
+            ...(client.buildId === undefined ? {} : { buildId: client.buildId }),
+            focused: client.focused,
+            visible: client.visible,
+            seenAgoMs: Math.max(0, this.#now() - client.seenAt),
+        };
+    }
+    #mostRecent(pool, ties) {
+        let best = pool[0];
+        for (const entry of pool)
+            if (entry.client.seenAt >= best.client.seenAt)
+                best = entry;
+        const tied = pool.filter((entry) => entry !== best && ties(entry, best));
+        return { target: this.#targetOf(best), tied: tied.map((entry) => entry.client) };
+    }
+    #targetOf(entry) {
+        return {
+            client: entry.client,
+            send: (data) => {
+                const connection = entry.connections.at(-1);
+                if (!connection)
+                    return false;
+                connection.send(data);
+                return true;
+            },
+        };
+    }
+    #takeUnannounced(clientId, scope) {
+        const waiting = this.#unannounced.get(clientId) ?? [];
+        this.#keepUnannounced(clientId, waiting.filter((connection) => connection.scope !== scope));
+        return waiting.filter((connection) => connection.scope === scope);
+    }
+    #keepUnannounced(clientId, connections) {
+        if (connections.length > 0)
+            this.#unannounced.set(clientId, connections);
+        else
+            this.#unannounced.delete(clientId);
+    }
+    #disconnect(clientId, connection) {
+        const waiting = this.#unannounced.get(clientId);
+        if (waiting?.includes(connection)) {
+            this.#keepUnannounced(clientId, waiting.filter((candidate) => candidate !== connection));
+            return;
+        }
+        const entry = this.#byId.get(clientId);
+        const index = entry?.connections.indexOf(connection) ?? -1;
+        if (!entry || index === -1)
+            return;
+        entry.connections.splice(index, 1);
+        if (entry.connections.length === 0)
+            this.#forget(entry);
+    }
+    #forget(entry) {
+        if (this.#byId.get(entry.client.id) !== entry)
+            return;
+        this.#byId.delete(entry.client.id);
+        const peers = this.#byScope.get(entry.client.scope);
+        peers?.delete(entry);
+        if (peers?.size === 0)
+            this.#byScope.delete(entry.client.scope);
+        this.#notify(entry.client, "left");
+    }
+    #notify(client, change) {
+        for (const listener of this.#listeners)
+            listener(client.scope, client.id, change);
+    }
+    #scopeSet(scope) {
+        let set = this.#byScope.get(scope);
+        if (!set) {
+            set = new Set();
+            this.#byScope.set(scope, set);
+        }
+        return set;
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/server/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../src/server/directory.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChannelConnection } from \"@parlor/sync\";\n\nimport {\n  type ClientSummary,\n  isUiOp,\n  LEGACY_UI_OPS,\n  type PresenceUpdate,\n  type UiOp,\n} from \"../protocol.js\";\nimport { audienceOf } from \"./audience.js\";\n\nexport interface ConnectedClient {\n  readonly id: string;\n  readonly scope: string;\n  readonly platform: string;\n  readonly buildId: string | undefined;\n  readonly focused: boolean;\n  readonly visible: boolean;\n  readonly ops: readonly UiOp[];\n  readonly canConfirm: boolean;\n  readonly watching: readonly string[];\n  readonly seenAt: number;\n}\n\nexport interface ClientTarget {\n  readonly client: ConnectedClient;\n  send(data: string): boolean;\n}\n\nexport interface Selection {\n  readonly target: ClientTarget;\n  readonly tied: readonly ConnectedClient[];\n}\n\nexport type PresenceOutcome = \"rejected\" | \"updated\" | \"registered\";\n\nexport type DirectoryChange = \"joined\" | \"updated\" | \"left\";\n\nexport type DirectoryListener = (\n  scope: string,\n  clientId: string,\n  change: DirectoryChange,\n) => void;\n\ninterface Entry {\n  client: ConnectedClient;\n  readonly connections: ChannelConnection[];\n}\n\nexport class ClientDirectory {\n  readonly #now: () => number;\n  readonly #byId = new Map<string, Entry>();\n  readonly #byScope = new Map<string, Set<Entry>>();\n  readonly #unannounced = new Map<string, ChannelConnection[]>();\n\n  readonly #listeners = new Set<DirectoryListener>();\n\n  constructor(now: () => number = Date.now) {\n    this.#now = now;\n  }\n\n  subscribe(listener: DirectoryListener): () => void {\n    this.#listeners.add(listener);\n    return () => this.#listeners.delete(listener);\n  }\n\n  connect(stream: ChannelConnection): () => void {\n    const { clientId } = stream;\n    if (clientId === undefined) return () => {};\n    const connection: ChannelConnection = {\n      ...stream,\n      scope: audienceOf(stream.scope, stream.principal),\n    };\n    this.#keepUnannounced(clientId, [\n      ...(this.#unannounced.get(clientId) ?? []),\n      connection,\n    ]);\n    return () => this.#disconnect(clientId, connection);\n  }\n\n  touch(clientId: string | undefined, scope: string): void {\n    if (clientId === undefined) return;\n    const entry = this.#byId.get(clientId);\n    if (!entry || entry.client.scope !== scope) return;\n    entry.client = { ...entry.client, seenAt: this.#now() };\n    this.#notify(entry.client, \"updated\");\n  }\n\n  presence(clientId: string, scope: string, update: PresenceUpdate): PresenceOutcome {\n    const announcing = this.#takeUnannounced(clientId, scope);\n    let entry = this.#byId.get(clientId);\n    if (entry && entry.client.scope !== scope) {\n      if (announcing.length === 0) return \"rejected\";\n      this.#forget(entry);\n      entry = undefined;\n    }\n    if (!entry && announcing.length === 0) return \"rejected\";\n    const client: ConnectedClient = {\n      id: clientId,\n      scope,\n      platform: update.platform,\n      buildId: update.buildId,\n      focused: update.focused,\n      visible: update.visible,\n      ops: update.ops ? update.ops.filter(isUiOp) : LEGACY_UI_OPS,\n      canConfirm: update.canConfirm ?? false,\n      watching: update.watching ?? [],\n      seenAt: this.#now(),\n    };\n    if (entry) {\n      entry.client = client;\n    } else {\n      entry = { client, connections: [] };\n      this.#byId.set(clientId, entry);\n      this.#scopeSet(scope).add(entry);\n    }\n    entry.connections.push(...announcing);\n    const outcome = announcing.length > 0 ? \"registered\" : \"updated\";\n    this.#notify(client, outcome === \"registered\" ? \"joined\" : \"updated\");\n    return outcome;\n  }\n\n  leave(clientId: string, scope: string): boolean {\n    const entry = this.#byId.get(clientId);\n    if (!entry || entry.client.scope !== scope) return false;\n    const released = entry.connections.splice(0);\n    this.#forget(entry);\n    this.#keepUnannounced(clientId, [\n      ...(this.#unannounced.get(clientId) ?? []),\n      ...released,\n    ]);\n    return true;\n  }\n\n  connected(scope: string, clientId: string): boolean {\n    return this.#byId.get(clientId)?.client.scope === scope;\n  }\n\n  targets(scope: string): readonly ClientTarget[] {\n    return [...(this.#byScope.get(scope) ?? [])].map((entry) => this.#targetOf(entry));\n  }\n\n  target(clientId: string): ClientTarget | undefined {\n    const entry = this.#byId.get(clientId);\n    return entry && this.#targetOf(entry);\n  }\n\n  select(scope: string, clientId?: string): Selection | undefined {\n    const entries = [...(this.#byScope.get(scope) ?? [])];\n    if (entries.length === 0) return undefined;\n    const explicit = clientId === undefined ? undefined : this.#byId.get(clientId);\n    if (explicit && explicit.client.scope === scope) {\n      return { target: this.#targetOf(explicit), tied: [] };\n    }\n    const focused = entries.filter((e) => e.client.focused);\n    if (focused.length > 0) return this.#mostRecent(focused, () => true);\n    const visible = entries.filter((e) => e.client.visible);\n    const pool = visible.length > 0 ? visible : entries;\n    return this.#mostRecent(pool, (a, b) => a.client.seenAt === b.client.seenAt);\n  }\n\n  summaries(scope: string): ClientSummary[] {\n    return [...(this.#byScope.get(scope) ?? [])].map((entry) =>\n      this.summary(entry.client),\n    );\n  }\n\n  summary(client: ConnectedClient): ClientSummary {\n    return {\n      id: client.id,\n      platform: client.platform,\n      ...(client.buildId === undefined ? {} : { buildId: client.buildId }),\n      focused: client.focused,\n      visible: client.visible,\n      seenAgoMs: Math.max(0, this.#now() - client.seenAt),\n    };\n  }\n\n  #mostRecent(pool: Entry[], ties: (a: Entry, b: Entry) => boolean): Selection {\n    let best = pool[0]!;\n    for (const entry of pool) if (entry.client.seenAt >= best.client.seenAt) best = entry;\n    const tied = pool.filter((entry) => entry !== best && ties(entry, best));\n    return { target: this.#targetOf(best), tied: tied.map((entry) => entry.client) };\n  }\n\n  #targetOf(entry: Entry): ClientTarget {\n    return {\n      client: entry.client,\n      send: (data) => {\n        const connection = entry.connections.at(-1);\n        if (!connection) return false;\n        connection.send(data);\n        return true;\n      },\n    };\n  }\n\n  #takeUnannounced(clientId: string, scope: string): ChannelConnection[] {\n    const waiting = this.#unannounced.get(clientId) ?? [];\n    this.#keepUnannounced(\n      clientId,\n      waiting.filter((connection) => connection.scope !== scope),\n    );\n    return waiting.filter((connection) => connection.scope === scope);\n  }\n\n  #keepUnannounced(clientId: string, connections: ChannelConnection[]): void {\n    if (connections.length > 0) this.#unannounced.set(clientId, connections);\n    else this.#unannounced.delete(clientId);\n  }\n\n  #disconnect(clientId: string, connection: ChannelConnection): void {\n    const waiting = this.#unannounced.get(clientId);\n    if (waiting?.includes(connection)) {\n      this.#keepUnannounced(\n        clientId,\n        waiting.filter((candidate) => candidate !== connection),\n      );\n      return;\n    }\n    const entry = this.#byId.get(clientId);\n    const index = entry?.connections.indexOf(connection) ?? -1;\n    if (!entry || index === -1) return;\n    entry.connections.splice(index, 1);\n    if (entry.connections.length === 0) this.#forget(entry);\n  }\n\n  #forget(entry: Entry): void {\n    if (this.#byId.get(entry.client.id) !== entry) return;\n    this.#byId.delete(entry.client.id);\n    const peers = this.#byScope.get(entry.client.scope);\n    peers?.delete(entry);\n    if (peers?.size === 0) this.#byScope.delete(entry.client.scope);\n    this.#notify(entry.client, \"left\");\n  }\n\n  #notify(client: ConnectedClient, change: DirectoryChange): void {\n    for (const listener of this.#listeners) listener(client.scope, client.id, change);\n  }\n\n  #scopeSet(scope: string): Set<Entry> {\n    let set = this.#byScope.get(scope);\n    if (!set) {\n      set = new Set();\n      this.#byScope.set(scope, set);\n    }\n    return set;\n  }\n}\n"]}

package/dist/server/index.d.ts

@@ -0,0 +1,10 @@
+export { type AgentUi, type AgentUiDependencies, type AgentUiOptions, createAgentUi, DEFAULT_UI_TIMEOUT_MS, type ExternalUiPolicy, webOriginFromEnv, } from "./agent-ui.js";
+export { audienceOf, userAudience } from "./audience.js";
+export { type ConfirmationOutcome, type ConfirmationRequest, type ConfirmationThread, DEFAULT_CONFIRM_TIMEOUT_MS, } from "./confirmations.js";
+export { fileManifestSource, type UiManifestInput, type UiManifestSource, } from "./manifest-source.js";
+export { type BrokerOptions, UiBroker, UiFailure, type UiReceipt } from "./broker.js";
+export { ClientDirectory, type ClientTarget, type ConnectedClient, type PresenceOutcome, type Selection, } from "./directory.js";
+export { type AgentUiRouteOptions, MAX_CLIENT_MESSAGE_BYTES, registerAgentUiRoutes, } from "./routes.js";
+export { parseClientMessage, uiOpInputs } from "./schemas.js";
+export { type AgentTool, type AgentToolContext, type HighlightToolResult, type NavigateToolResult, type ScreenToolResult, type SetToolResult, UI_MANIFEST_RESOURCE, UI_TOOLS, type UiToolName, type UnreachableResult, } from "./tools.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,aAAa,EACb,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,mBAAmB,EACxB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,oBAAoB,EACpB,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,10 @@
+export { createAgentUi, DEFAULT_UI_TIMEOUT_MS, webOriginFromEnv, } from "./agent-ui.js";
+export { audienceOf, userAudience } from "./audience.js";
+export { DEFAULT_CONFIRM_TIMEOUT_MS, } from "./confirmations.js";
+export { fileManifestSource, } from "./manifest-source.js";
+export { UiBroker, UiFailure } from "./broker.js";
+export { ClientDirectory, } from "./directory.js";
+export { MAX_CLIENT_MESSAGE_BYTES, registerAgentUiRoutes, } from "./routes.js";
+export { parseClientMessage, uiOpInputs } from "./schemas.js";
+export { UI_MANIFEST_RESOURCE, UI_TOOLS, } from "./tools.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,EACb,qBAAqB,EAErB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAIL,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAsB,QAAQ,EAAE,SAAS,EAAkB,MAAM,aAAa,CAAC;AACtF,OAAO,EACL,eAAe,GAKhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAOL,oBAAoB,EACpB,QAAQ,GAGT,MAAM,YAAY,CAAC","sourcesContent":["export {\n  type AgentUi,\n  type AgentUiDependencies,\n  type AgentUiOptions,\n  createAgentUi,\n  DEFAULT_UI_TIMEOUT_MS,\n  type ExternalUiPolicy,\n  webOriginFromEnv,\n} from \"./agent-ui.js\";\nexport { audienceOf, userAudience } from \"./audience.js\";\nexport {\n  type ConfirmationOutcome,\n  type ConfirmationRequest,\n  type ConfirmationThread,\n  DEFAULT_CONFIRM_TIMEOUT_MS,\n} from \"./confirmations.js\";\nexport {\n  fileManifestSource,\n  type UiManifestInput,\n  type UiManifestSource,\n} from \"./manifest-source.js\";\nexport { type BrokerOptions, UiBroker, UiFailure, type UiReceipt } from \"./broker.js\";\nexport {\n  ClientDirectory,\n  type ClientTarget,\n  type ConnectedClient,\n  type PresenceOutcome,\n  type Selection,\n} from \"./directory.js\";\nexport {\n  type AgentUiRouteOptions,\n  MAX_CLIENT_MESSAGE_BYTES,\n  registerAgentUiRoutes,\n} from \"./routes.js\";\nexport { parseClientMessage, uiOpInputs } from \"./schemas.js\";\nexport {\n  type AgentTool,\n  type AgentToolContext,\n  type HighlightToolResult,\n  type NavigateToolResult,\n  type ScreenToolResult,\n  type SetToolResult,\n  UI_MANIFEST_RESOURCE,\n  UI_TOOLS,\n  type UiToolName,\n  type UnreachableResult,\n} from \"./tools.js\";\n"]}

package/dist/server/manifest-source.d.ts

@@ -0,0 +1,10 @@
+import type { UiManifest, ViewEntry } from "../manifest.js";
+export type UiManifestInput = Omit<UiManifest, "views"> & {
+    readonly views: readonly (Omit<ViewEntry, "writable"> & {
+        readonly writable?: readonly string[] | undefined;
+    })[];
+};
+export type UiManifestSource = () => UiManifestInput | undefined;
+export declare function normalizeManifest(manifest: UiManifestInput): UiManifest;
+export declare function fileManifestSource(path: string): UiManifestSource;
+//# sourceMappingURL=manifest-source.d.ts.map

package/dist/server/manifest-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-source.d.ts","sourceRoot":"","sources":["../../src/server/manifest-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG;QACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;KACnD,CAAC,EAAE,CAAC;CACN,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,eAAe,GAAG,SAAS,CAAC;AAEjE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,CAKvE;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAqBjE"}

package/dist/server/manifest-source.js

@@ -0,0 +1,36 @@
+import { readFileSync, statSync } from "node:fs";
+export function normalizeManifest(manifest) {
+    return {
+        ...manifest,
+        views: manifest.views.map((view) => ({ ...view, writable: view.writable ?? [] })),
+    };
+}
+function readManifest(path) {
+    return normalizeManifest(JSON.parse(readFileSync(path, "utf8")));
+}
+export function fileManifestSource(path) {
+    let mtimeMs;
+    let manifest;
+    return () => {
+        let stat;
+        try {
+            stat = statSync(path);
+        }
+        catch {
+            mtimeMs = undefined;
+            manifest = undefined;
+            return undefined;
+        }
+        if (stat.mtimeMs === mtimeMs)
+            return manifest;
+        try {
+            manifest = readManifest(path);
+            mtimeMs = stat.mtimeMs;
+        }
+        catch {
+            return manifest;
+        }
+        return manifest;
+    };
+}
+//# sourceMappingURL=manifest-source.js.map

package/dist/server/manifest-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-source.js","sourceRoot":"","sources":["../../src/server/manifest-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAYjD,MAAM,UAAU,iBAAiB,CAAC,QAAyB;IACzD,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC;KAClF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAoB,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,OAA2B,CAAC;IAChC,IAAI,QAAgC,CAAC;IACrC,OAAO,GAAG,EAAE;QACV,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,SAAS,CAAC;YACpB,QAAQ,GAAG,SAAS,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO,QAAQ,CAAC;QAC9C,IAAI,CAAC;YACH,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC9B,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { readFileSync, statSync } from \"node:fs\";\n\nimport type { UiManifest, ViewEntry } from \"../manifest.js\";\n\nexport type UiManifestInput = Omit<UiManifest, \"views\"> & {\n  readonly views: readonly (Omit<ViewEntry, \"writable\"> & {\n    readonly writable?: readonly string[] | undefined;\n  })[];\n};\n\nexport type UiManifestSource = () => UiManifestInput | undefined;\n\nexport function normalizeManifest(manifest: UiManifestInput): UiManifest {\n  return {\n    ...manifest,\n    views: manifest.views.map((view) => ({ ...view, writable: view.writable ?? [] })),\n  };\n}\n\nfunction readManifest(path: string): UiManifest {\n  return normalizeManifest(JSON.parse(readFileSync(path, \"utf8\")) as UiManifestInput);\n}\n\nexport function fileManifestSource(path: string): UiManifestSource {\n  let mtimeMs: number | undefined;\n  let manifest: UiManifest | undefined;\n  return () => {\n    let stat;\n    try {\n      stat = statSync(path);\n    } catch {\n      mtimeMs = undefined;\n      manifest = undefined;\n      return undefined;\n    }\n    if (stat.mtimeMs === mtimeMs) return manifest;\n    try {\n      manifest = readManifest(path);\n      mtimeMs = stat.mtimeMs;\n    } catch {\n      return manifest;\n    }\n    return manifest;\n  };\n}\n"]}