@parlor/agent-ui 0.0.0-stage → 0.1.0

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

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

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

package/dist/server/routes.d.ts

@@ -0,0 +1,11 @@
+import type { H3 } from "h3";
+import type { AgentUi } from "./agent-ui.js";
+export declare const MAX_CLIENT_MESSAGE_BYTES: number;
+export interface AgentUiRouteOptions {
+    readonly basePath: string;
+    readonly agentUi: AgentUi;
+    readonly audience: (request: Request) => string | Promise<string>;
+    readonly clientId: (request: Request) => string | undefined;
+}
+export declare function registerAgentUiRoutes(app: H3, options: AgentUiRouteOptions): void;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/server/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,IAAI,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CAC7D;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CA6BjF"}

package/dist/server/routes.js

@@ -0,0 +1,38 @@
+import { parseClientMessage } from "./schemas.js";
+export const MAX_CLIENT_MESSAGE_BYTES = 256 * 1024;
+const status = (code) => new Response(null, { status: code });
+export function registerAgentUiRoutes(app, options) {
+    const { basePath, agentUi, audience, clientId } = options;
+    app.post(`${basePath}/ui`, async (event) => {
+        const request = event.req;
+        if (Number(request.headers.get("content-length") ?? 0) > MAX_CLIENT_MESSAGE_BYTES) {
+            return status(413);
+        }
+        const body = await request.text();
+        if (new TextEncoder().encode(body).byteLength > MAX_CLIENT_MESSAGE_BYTES) {
+            return status(413);
+        }
+        const id = clientId(request);
+        if (!id)
+            return status(400);
+        let json;
+        try {
+            json = JSON.parse(body);
+        }
+        catch {
+            return status(400);
+        }
+        const message = parseClientMessage(json);
+        if (!message)
+            return status(400);
+        const receipt = agentUi.receive(id, await audience(request), message);
+        if (!receipt.accepted)
+            return status(404);
+        if (receipt.next === undefined)
+            return status(204);
+        return new Response(receipt.next, {
+            headers: { "content-type": "application/json" },
+        });
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/server/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/server/routes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,GAAG,IAAI,CAAC;AASnD,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAEtE,MAAM,UAAU,qBAAqB,CAAC,GAAO,EAAE,OAA4B;IACzE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE1D,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC;QAC1B,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,wBAAwB,EAAE,CAAC;YAClF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,wBAAwB,EAAE,CAAC;YACzE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACnD,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE;YAChC,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/schemas.d.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { type ClientMessage } from "../protocol.js";
+export declare const uiOpInputs: {
+    screen: z.ZodObject<{}, z.core.$strip>;
+    navigate: z.ZodObject<{
+        to: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        search: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        replace: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    set: z.ZodObject<{
+        view: z.ZodString;
+        key: z.ZodOptional<z.ZodString>;
+        value: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>;
+    highlight: z.ZodObject<{
+        view: z.ZodString;
+        key: z.ZodOptional<z.ZodString>;
+        field: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+export declare const clientMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"reply">;
+    id: z.ZodString;
+    ok: z.ZodLiteral<true>;
+    result: z.ZodUnknown;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reply">;
+    id: z.ZodString;
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            ambiguous_client: "ambiguous_client";
+            busy: "busy";
+            internal: "internal";
+            invalid_value: "invalid_value";
+            not_mounted: "not_mounted";
+            not_writable: "not_writable";
+            outcome_unknown: "outcome_unknown";
+            timeout: "timeout";
+            unknown_client: "unknown_client";
+            unknown_route: "unknown_route";
+            unsupported_op: "unsupported_op";
+            user_editing: "user_editing";
+        }>;
+        message: z.ZodString;
+        issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"presence">;
+    focused: z.ZodBoolean;
+    visible: z.ZodBoolean;
+    platform: z.ZodString;
+    buildId: z.ZodOptional<z.ZodString>;
+    ops: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    canConfirm: z.ZodOptional<z.ZodBoolean>;
+    watching: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<string[], unknown[]>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"leave">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"answer">;
+    id: z.ZodString;
+    approve: z.ZodBoolean;
+}, z.core.$strip>]>;
+export declare function parseClientMessage(body: unknown): ClientMessage | undefined;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/server/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,aAAa,EAAuC,MAAM,gBAAgB,CAAC;AAEzF,eAAO,MAAM,UAAU;IACrB,MAAM;IACN,QAAQ;;;;;;IAeR,GAAG;;;;;IAOH,SAAS;;;;;CAQV,CAAC;AAkBF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAyB9B,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAG3E"}

package/dist/server/schemas.js

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { MAX_WATCHED_THREADS, UI_ERROR_CODES } from "../protocol.js";
+export const uiOpInputs = {
+    screen: z.object({}),
+    navigate: z.object({
+        to: z.string(),
+        params: z
+            .record(z.string(), z.string())
+            .optional()
+            .describe('Values for the $params in the path, e.g. { "taskId": "..." }.'),
+        search: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe("Search params for the page, as its entry in the list names them."),
+        replace: z
+            .boolean()
+            .optional()
+            .describe("Replace the current history entry instead of pushing one."),
+    }),
+    set: z.object({
+        view: z.string().describe("A writable view's name, as listed."),
+        key: z.string().optional().describe("The item's key, for a keyed view."),
+        value: z
+            .record(z.string(), z.unknown())
+            .describe("The fields to write; others keep their current value."),
+    }),
+    highlight: z.object({
+        view: z.string().describe("A view's name, as ui_screen reports it."),
+        key: z.string().optional().describe("The item's key, for a keyed view."),
+        field: z
+            .string()
+            .optional()
+            .describe("A field inside the view to focus, by its input name."),
+    }),
+};
+const errorSchema = z.object({
+    code: z.enum(UI_ERROR_CODES),
+    message: z.string(),
+    issues: z.array(z.object({ path: z.string(), message: z.string() })).optional(),
+});
+const watchingSchema = z
+    .array(z.unknown())
+    .transform((ids) => ids
+    .filter((id) => typeof id === "string" && id !== "")
+    .slice(0, MAX_WATCHED_THREADS))
+    .optional()
+    .catch(undefined);
+export const clientMessageSchema = z.union([
+    z.object({
+        type: z.literal("reply"),
+        id: z.string().min(1),
+        ok: z.literal(true),
+        result: z.unknown(),
+    }),
+    z.object({
+        type: z.literal("reply"),
+        id: z.string().min(1),
+        ok: z.literal(false),
+        error: errorSchema,
+    }),
+    z.object({
+        type: z.literal("presence"),
+        focused: z.boolean(),
+        visible: z.boolean(),
+        platform: z.string(),
+        buildId: z.string().optional(),
+        ops: z.array(z.string()).optional(),
+        canConfirm: z.boolean().optional(),
+        watching: watchingSchema,
+    }),
+    z.object({ type: z.literal("leave") }),
+    z.object({ type: z.literal("answer"), id: z.string().min(1), approve: z.boolean() }),
+]);
+export function parseClientMessage(body) {
+    const parsed = clientMessageSchema.safeParse(body);
+    return parsed.success ? parsed.data : undefined;
+}
+//# sourceMappingURL=schemas.js.map

package/dist/server/schemas.js.map

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

package/dist/server/tools.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { type UiManifest } from "../manifest.js";
+import { type AgentOrigin, type ClientSummary, type ScreenSnapshot, type UiOp, type UiOpResults } from "../protocol.js";
+import { type UiBroker } from "./broker.js";
+import type { ClientDirectory } from "./directory.js";
+export type UiToolName = `ui_${UiOp}`;
+export declare const UI_TOOLS: readonly UiToolName[];
+export declare const UI_MANIFEST_RESOURCE = "parlor://manifest";
+export interface AgentToolContext {
+    readonly scope: string;
+    readonly clientId?: string | undefined;
+    readonly origin: AgentOrigin;
+    readonly signal?: AbortSignal | undefined;
+    readonly webOrigin?: string | undefined;
+}
+export interface AgentTool<I extends z.ZodObject = z.ZodObject> {
+    readonly name: UiToolName;
+    readonly description: string;
+    readonly input: I;
+    readonly readOnly: boolean;
+    run(input: z.output<I>, ctx: AgentToolContext): Promise<unknown>;
+}
+export interface ScreenToolResult extends ScreenSnapshot {
+    readonly client: ClientSummary;
+    readonly otherClients: readonly ClientSummary[];
+    readonly tiedWith?: readonly string[] | undefined;
+}
+export interface NavigateToolResult {
+    readonly client: ClientSummary;
+    readonly screen: ScreenSnapshot;
+}
+export type SetToolResult = UiOpResults["set"] & {
+    readonly client: ClientSummary;
+};
+export type HighlightToolResult = UiOpResults["highlight"] & {
+    readonly client: ClientSummary;
+};
+export interface UnreachableResult {
+    readonly reachable: false;
+    readonly reason: "no_client";
+    readonly href?: string | undefined;
+}
+export interface UiToolDeps {
+    readonly directory: ClientDirectory;
+    readonly broker: UiBroker;
+}
+export declare function createUiTools(deps: UiToolDeps): (manifest: UiManifest | undefined) => readonly AgentTool[];
+export declare function uiInstructions(): string;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/server/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EAEnB,KAAK,IAAI,EACT,KAAK,WAAW,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,QAAQ,EAAa,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,gBAAgB,CAAC;AAGjE,MAAM,MAAM,UAAU,GAAG,MAAM,IAAI,EAAE,CAAC;AAItC,eAAO,MAAM,QAAQ,EAAE,SAAS,UAAU,EAAyB,CAAC;AAEpE,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;IAC5D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,SAAS,aAAa,EAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG;IAC3D,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;CAC3B;AA4JD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,GACf,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,KAAK,SAAS,SAAS,EAAE,CAmM5D;AAED,wBAAgB,cAAc,IAAI,MAAM,CAavC"}