@parlor/agent-ui 0.0.0-stage → 0.1.0

package/dist/client/write.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { type AgentRouteData, type JsonSchema, type ManifestBuild, type RouteEntry, routeHref, type UiAppInfo, UI_MANIFEST_FILE, type UiManifest, type ViewEntry, } from "./manifest.js";
+export { type AgentOrigin, type AttentionSnapshot, type ClientMessage, type ClientSummary, type FocusSnapshot, type ItemSnapshot, type JsonObject, type KeyedViewSnapshot, type LeaveNotice, MAX_WATCHED_THREADS, type MatchedRouteSnapshot, type NotFoundRouteSnapshot, type PresenceUpdate, type QuerySnapshot, type QueryStatus, type RecentRef, type RouteSnapshot, type ScreenSnapshot, type SelectionSnapshot, type SingleViewSnapshot, type TruncatedValue, UI_CHANNEL, UI_ERROR_CODES, UI_OPS, type UiError, type UiErrorCode, type UiOp, type UiOpInput, type UiOpInputs, uiOpReadOnly, uiOps, type UiOpResults, type UiReply, type UiRequest, type ViewSnapshot, } from "./protocol.js";
+export { type AgentViewBinding, type AgentViewConfig, type AgentViewDefinition, type AnyAgentView, defineAgentView, isAgentView, type IsWritable, type ViewField, type ViewRef, type ViewSchema, type ViewSetter, type ViewValue, type WritableField, } from "./view.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,SAAS,EACT,KAAK,SAAS,EACd,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,UAAU,EACV,cAAc,EACd,MAAM,EACN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,UAAU,EACf,YAAY,EACZ,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,eAAe,EACf,WAAW,EACX,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { routeHref, UI_MANIFEST_FILE, } from "./manifest.js";
+export { MAX_WATCHED_THREADS, UI_CHANNEL, UI_ERROR_CODES, UI_OPS, uiOpReadOnly, uiOps, } from "./protocol.js";
+export { defineAgentView, isAgentView, } from "./view.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,SAAS,EAET,gBAAgB,GAGjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAUL,mBAAmB,EAYnB,UAAU,EACV,cAAc,EACd,MAAM,EAMN,YAAY,EACZ,KAAK,GAKN,MAAM,eAAe,CAAC;AACvB,OAAO,EAKL,eAAe,EACf,WAAW,GAQZ,MAAM,WAAW,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,44 @@
+import type { StaticDataRouteOption } from "@tanstack/router-core";
+import type { AnyAgentView } from "./view.js";
+declare module "@tanstack/router-core" {
+    interface StaticDataRouteOption {
+        readonly description?: string | undefined;
+        readonly views?: readonly AnyAgentView[] | undefined;
+    }
+}
+export type AgentRouteData = Pick<StaticDataRouteOption, "description" | "views">;
+export declare const UI_MANIFEST_FILE = "ui-manifest.json";
+export type JsonSchema = Readonly<Record<string, unknown>>;
+export interface UiAppInfo {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly scheme?: string | undefined;
+}
+export interface RouteEntry {
+    readonly path: string;
+    readonly description?: string | undefined;
+    readonly params: readonly string[];
+    readonly search?: JsonSchema | undefined;
+    readonly views: readonly string[];
+}
+export interface ViewEntry {
+    readonly name: string;
+    readonly description: string;
+    readonly keyed: boolean;
+    readonly schema?: JsonSchema | undefined;
+    readonly writable: readonly string[];
+}
+export interface UiManifest {
+    readonly protocol: 1;
+    readonly app: UiAppInfo;
+    readonly buildId?: string | undefined;
+    readonly routes: readonly RouteEntry[];
+    readonly views: readonly ViewEntry[];
+}
+export interface ManifestBuild {
+    readonly manifest: UiManifest;
+    readonly warnings: readonly string[];
+}
+export declare function routeHref(route: RouteEntry, params: Readonly<Record<string, string>> | undefined, search: Readonly<Record<string, unknown>> | undefined): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,QAAQ,uBAAuB,CAAC;IACrC,UAAU,qBAAqB;QAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;KACtD;CACF;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,qBAAqB,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;AAElF,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EACpD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACpD,MAAM,CAkBR"}

package/dist/manifest.js

@@ -0,0 +1,23 @@
+export const UI_MANIFEST_FILE = "ui-manifest.json";
+export function routeHref(route, params, search) {
+    const path = route.path
+        .split("/")
+        .map((segment) => {
+        if (!segment.startsWith("$"))
+            return segment;
+        const value = params?.[segment === "$" ? "_splat" : segment.slice(1)] ?? "";
+        return segment === "$"
+            ? value.split("/").map(encodeURIComponent).join("/")
+            : encodeURIComponent(value);
+    })
+        .join("/");
+    const query = new URLSearchParams();
+    for (const [key, value] of Object.entries(search ?? {})) {
+        if (value === undefined)
+            continue;
+        query.set(key, typeof value === "string" ? value : JSON.stringify(value));
+    }
+    const queryString = query.toString();
+    return queryString ? `${path}?${queryString}` : path;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAwCnD,MAAM,UAAU,SAAS,CACvB,KAAiB,EACjB,MAAoD,EACpD,MAAqD;IAErD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI;SACpB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACf,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5E,OAAO,OAAO,KAAK,GAAG;YACpB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACpD,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IACrC,OAAO,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,206 @@
+import type { ActionSource } from "@parlor/core";
+import type { ViewRef } from "./view.js";
+export declare const UI_CHANNEL = "ui";
+/** Presence names at most this many watched chat threads; a client sending more is truncated. */
+export declare const MAX_WATCHED_THREADS = 8;
+export interface UiOpInputs {
+    readonly screen: Readonly<Record<string, never>>;
+    readonly navigate: {
+        readonly to: string;
+        readonly params?: Readonly<Record<string, string>> | undefined;
+        readonly search?: Readonly<Record<string, unknown>> | undefined;
+        readonly replace?: boolean | undefined;
+    };
+    readonly set: {
+        readonly view: string;
+        readonly key?: string | undefined;
+        readonly value: JsonObject;
+    };
+    readonly highlight: {
+        readonly view: string;
+        readonly key?: string | undefined;
+        readonly field?: string | undefined;
+    };
+}
+export type UiOp = keyof UiOpInputs;
+export type UiOpInput<O extends UiOp> = UiOpInputs[O];
+export interface UiOpResults {
+    readonly screen: ScreenSnapshot;
+    readonly navigate: {
+        readonly screen: ScreenSnapshot;
+    };
+    readonly set: {
+        readonly value: JsonObject;
+        readonly agentFields: readonly string[];
+    };
+    readonly highlight: {
+        readonly shown: number;
+    };
+}
+interface UiOpSpec<O extends UiOp> {
+    readonly readOnly: boolean;
+    readonly input: (value: unknown) => UiOpInput<O> | undefined;
+}
+export declare const uiOps: {
+    readonly [O in UiOp]: UiOpSpec<O>;
+};
+export declare const UI_OPS: readonly UiOp[];
+export declare const isUiOp: (value: unknown) => value is UiOp;
+export declare const LEGACY_UI_OPS: readonly UiOp[];
+export declare const uiOpReadOnly: {
+    readonly [O in UiOp]: boolean;
+};
+export interface AgentOrigin {
+    readonly via: Extract<ActionSource, "mcp" | "agent">;
+    readonly name?: string | undefined;
+}
+export type UiRequest = {
+    readonly [O in UiOp]: {
+        readonly id: string;
+        readonly op: O;
+        readonly input: UiOpInput<O>;
+        readonly origin: AgentOrigin;
+        readonly timeoutMs: number;
+    };
+}[UiOp];
+export declare const UI_ERROR_CODES: readonly ["unknown_route", "unknown_client", "ambiguous_client", "not_mounted", "not_writable", "invalid_value", "user_editing", "unsupported_op", "busy", "timeout", "outcome_unknown", "internal"];
+export type UiErrorCode = (typeof UI_ERROR_CODES)[number];
+export interface UiError {
+    readonly code: UiErrorCode;
+    readonly message: string;
+    readonly issues?: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[] | undefined;
+}
+export type UiReply = {
+    readonly type: "reply";
+    readonly id: string;
+    readonly ok: true;
+    readonly result: unknown;
+} | {
+    readonly type: "reply";
+    readonly id: string;
+    readonly ok: false;
+    readonly error: UiError;
+};
+export interface PresenceUpdate {
+    readonly type: "presence";
+    readonly focused: boolean;
+    readonly visible: boolean;
+    readonly platform: string;
+    readonly buildId?: string | undefined;
+    readonly ops?: readonly string[] | undefined;
+    readonly canConfirm?: boolean | undefined;
+    /** Chat threads this client shows; a confirmation bound to one reaches every watcher. */
+    readonly watching?: readonly string[] | undefined;
+}
+export interface LeaveNotice {
+    readonly type: "leave";
+}
+export interface ConfirmationAnswer {
+    readonly type: "answer";
+    readonly id: string;
+    readonly approve: boolean;
+}
+export type ClientMessage = UiReply | PresenceUpdate | LeaveNotice | ConfirmationAnswer;
+export interface ConfirmationPrompt {
+    readonly id: string;
+    readonly action: string;
+    readonly description: string;
+    readonly input: unknown;
+    readonly origin: AgentOrigin;
+    readonly expiresInMs: number;
+    /** The chat thread whose turn asked; the chat renders the card inline there. */
+    readonly threadId?: string | undefined;
+}
+export interface ConfirmationsFrame {
+    readonly type: "confirmations";
+    readonly items: readonly ConfirmationPrompt[];
+}
+export type UiFrame = UiRequest | ConfirmationsFrame;
+export type JsonObject = {
+    readonly [key: string]: unknown;
+};
+export interface TruncatedValue {
+    readonly truncated: true;
+    readonly bytes: number;
+}
+export interface MatchedRouteSnapshot {
+    readonly notFound: false;
+    readonly path: string;
+    readonly params: Readonly<Record<string, string>>;
+    readonly search: JsonObject;
+    readonly url: string;
+}
+export interface NotFoundRouteSnapshot {
+    readonly notFound: true;
+    readonly url: string;
+}
+export type RouteSnapshot = MatchedRouteSnapshot | NotFoundRouteSnapshot;
+export type QueryStatus = "pending" | "error" | "success";
+export interface QuerySnapshot {
+    readonly action: string;
+    readonly input: unknown;
+    readonly status: QueryStatus;
+}
+export interface SingleViewSnapshot {
+    readonly value: JsonObject | TruncatedValue;
+    readonly shown?: number | undefined;
+}
+export interface ItemSnapshot {
+    readonly key: string;
+    readonly value: JsonObject | TruncatedValue;
+    readonly shown: number;
+}
+export interface KeyedViewSnapshot {
+    readonly items: readonly ItemSnapshot[];
+    readonly offscreen: number;
+}
+export type ViewSnapshot = SingleViewSnapshot | KeyedViewSnapshot;
+export interface RecentRef extends ViewRef {
+    readonly agoMs: number;
+}
+export interface FocusSnapshot {
+    readonly view?: string | undefined;
+    readonly key?: string | undefined;
+    readonly field?: string | undefined;
+    readonly label?: string | undefined;
+}
+export interface SelectionSnapshot {
+    readonly text: string;
+    readonly within: ViewRef;
+    readonly truncated: boolean;
+}
+export interface AttentionSnapshot {
+    readonly focus: FocusSnapshot | null;
+    readonly selection: SelectionSnapshot | null;
+    readonly lastInteracted: RecentRef | null;
+    readonly lastEntered: RecentRef | null;
+    readonly focal: ViewRef | null;
+}
+export interface ScreenSnapshot {
+    readonly route: RouteSnapshot | null;
+    readonly queries: readonly QuerySnapshot[];
+    readonly views: Readonly<Record<string, ViewSnapshot>>;
+    readonly attention: AttentionSnapshot;
+    readonly truncated: boolean;
+}
+export interface ClientSummary {
+    readonly id: string;
+    readonly platform: string;
+    readonly buildId?: string | undefined;
+    readonly focused: boolean;
+    readonly visible: boolean;
+    readonly seenAgoMs: number;
+}
+export type ParsedUiFrame = {
+    readonly ok: true;
+    readonly frame: UiFrame;
+} | {
+    readonly ok: false;
+    readonly id: string | undefined;
+};
+export declare function parseUiFrame(data: string): ParsedUiFrame;
+export {};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,152 @@
+export const UI_CHANNEL = "ui";
+/** Presence names at most this many watched chat threads; a client sending more is truncated. */
+export const MAX_WATCHED_THREADS = 8;
+export const uiOps = {
+    screen: { readOnly: true, input: (value) => (isFields(value) ? {} : undefined) },
+    navigate: { readOnly: false, input: (value) => navigateInputOf(value) },
+    set: { readOnly: false, input: (value) => setInputOf(value) },
+    highlight: { readOnly: false, input: (value) => highlightInputOf(value) },
+};
+export const UI_OPS = Object.keys(uiOps);
+export const isUiOp = (value) => typeof value === "string" && Object.hasOwn(uiOps, value);
+export const LEGACY_UI_OPS = ["screen", "navigate"];
+export const uiOpReadOnly = {
+    screen: uiOps.screen.readOnly,
+    navigate: uiOps.navigate.readOnly,
+    set: uiOps.set.readOnly,
+    highlight: uiOps.highlight.readOnly,
+};
+export const UI_ERROR_CODES = [
+    "unknown_route",
+    "unknown_client",
+    "ambiguous_client",
+    "not_mounted",
+    "not_writable",
+    "invalid_value",
+    "user_editing",
+    "unsupported_op",
+    "busy",
+    "timeout",
+    "outcome_unknown",
+    "internal",
+];
+const isFields = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isString = (value) => typeof value === "string";
+const isBoolean = (value) => typeof value === "boolean";
+const isPositiveInteger = (value) => typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+const isStringFields = (value) => isFields(value) && Object.values(value).every(isString);
+const absentOr = (value, guard) => value === undefined || guard(value);
+function originOf(value) {
+    if (!isFields(value))
+        return undefined;
+    const { via, name } = value;
+    if (via !== "mcp" && via !== "agent")
+        return undefined;
+    if (!absentOr(name, isString))
+        return undefined;
+    return name === undefined ? { via } : { via, name };
+}
+function navigateInputOf(value) {
+    if (!isFields(value) || !isString(value.to))
+        return undefined;
+    const { to, params, search, replace } = value;
+    if (!absentOr(params, isStringFields) ||
+        !absentOr(search, isFields) ||
+        !absentOr(replace, isBoolean)) {
+        return undefined;
+    }
+    return {
+        to,
+        ...(params === undefined ? {} : { params }),
+        ...(search === undefined ? {} : { search }),
+        ...(replace === undefined ? {} : { replace }),
+    };
+}
+function setInputOf(value) {
+    if (!isFields(value) || !isString(value.view) || !isFields(value.value)) {
+        return undefined;
+    }
+    if (!absentOr(value.key, isString))
+        return undefined;
+    const { view, key } = value;
+    return key === undefined
+        ? { view, value: value.value }
+        : { view, key, value: value.value };
+}
+function highlightInputOf(value) {
+    if (!isFields(value) || !isString(value.view))
+        return undefined;
+    if (!absentOr(value.key, isString) || !absentOr(value.field, isString))
+        return undefined;
+    const { view, key, field } = value;
+    return {
+        view,
+        ...(key === undefined ? {} : { key }),
+        ...(field === undefined ? {} : { field }),
+    };
+}
+function requestOf(json) {
+    if (!isFields(json))
+        return undefined;
+    const { id, op, input, timeoutMs } = json;
+    const origin = originOf(json.origin);
+    if (!isString(id) || id === "" || !origin || !isPositiveInteger(timeoutMs)) {
+        return undefined;
+    }
+    if (!isUiOp(op))
+        return undefined;
+    const parsed = uiOps[op].input(input);
+    return parsed === undefined
+        ? undefined
+        : { id, origin, timeoutMs, op, input: parsed };
+}
+const isNonNegativeInteger = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+function promptOf(json) {
+    if (!isFields(json))
+        return undefined;
+    const { id, action, description, input, expiresInMs } = json;
+    const origin = originOf(json.origin);
+    if (!isString(id) || id === "" || !isString(action) || !isString(description)) {
+        return undefined;
+    }
+    if (!origin || !isNonNegativeInteger(expiresInMs))
+        return undefined;
+    const { threadId } = json;
+    return {
+        id,
+        action,
+        description,
+        input,
+        origin,
+        expiresInMs,
+        ...(isString(threadId) && threadId !== "" ? { threadId } : {}),
+    };
+}
+function confirmationsOf(json) {
+    if (!Array.isArray(json.items))
+        return undefined;
+    const items = json.items.flatMap((item) => promptOf(item) ?? []);
+    return { type: "confirmations", items };
+}
+function parseJson(data) {
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        return undefined;
+    }
+}
+const idOf = (json) => {
+    const id = isFields(json) ? json.id : undefined;
+    return isString(id) && id !== "" ? id : undefined;
+};
+export function parseUiFrame(data) {
+    const json = parseJson(data);
+    if (isFields(json) && json.type === "confirmations") {
+        const frame = confirmationsOf(json);
+        return frame ? { ok: true, frame } : { ok: false, id: undefined };
+    }
+    const request = requestOf(json);
+    return request ? { ok: true, frame: request } : { ok: false, id: idOf(json) };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/server/agent-ui.d.ts

@@ -0,0 +1,36 @@
+import type { ServerChannel } from "@parlor/sync";
+import type { UiManifest } from "../manifest.js";
+import { type AgentOrigin, type ClientMessage } from "../protocol.js";
+import { type UiReceipt } from "./broker.js";
+import { type ConfirmationOutcome, type ConfirmationRequest } from "./confirmations.js";
+import { type UiManifestSource } from "./manifest-source.js";
+import { type AgentTool, type AgentToolContext } from "./tools.js";
+export type ExternalUiPolicy = boolean | "read-only";
+export interface AgentUiOptions {
+    readonly external?: ExternalUiPolicy | undefined;
+    readonly timeoutMs?: number | undefined;
+    readonly confirmTimeoutMs?: number | undefined;
+}
+export interface AgentUiDependencies {
+    readonly audience: (request: Request) => string | Promise<string>;
+    readonly webOrigin?: string | undefined;
+}
+export interface AgentUi {
+    readonly channel: ServerChannel;
+    touch(clientId: string | undefined, audience: string): void;
+    receive(clientId: string, audience: string, message: ClientMessage): UiReceipt;
+    tools(surface: "mcp" | "agent"): readonly AgentTool[];
+    /** `chat` binds an inline agent's `ui_*` calls to the client its turn's prompt came from. */
+    contextFor(request: Request | undefined, origin: AgentOrigin, signal?: AbortSignal, chat?: {
+        readonly clientId: string;
+    }): Promise<AgentToolContext>;
+    instructions(surface: "mcp" | "agent"): string | undefined;
+    confirm(request: ConfirmationRequest): Promise<ConfirmationOutcome>;
+    manifest(): UiManifest | undefined;
+    install(source: UiManifestSource): void;
+    close(): void;
+}
+export declare const DEFAULT_UI_TIMEOUT_MS = 10000;
+export declare function webOriginFromEnv(value?: string | undefined): string | undefined;
+export declare function createAgentUi(options: AgentUiOptions & AgentUiDependencies): AgentUi;
+//# sourceMappingURL=agent-ui.d.ts.map

package/dist/server/agent-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ui.d.ts","sourceRoot":"","sources":["../../src/server/agent-ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,SAAS,EACd,KAAK,gBAAgB,EAGtB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,CAAC;IAC/E,KAAK,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,SAAS,EAAE,CAAC;IACtD,6FAA6F;IAC7F,UAAU,CACR,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7B,YAAY,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3D,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACpE,QAAQ,IAAI,UAAU,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,MAAM,GAAG,SAAyC,GACxD,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,GAAG,OAAO,CA0EpF"}

package/dist/server/agent-ui.js

@@ -0,0 +1,89 @@
+import { UI_CHANNEL } from "../protocol.js";
+import { UiBroker } from "./broker.js";
+import { ConfirmationBoard, DEFAULT_CONFIRM_TIMEOUT_MS, } from "./confirmations.js";
+import { ClientDirectory } from "./directory.js";
+import { normalizeManifest, } from "./manifest-source.js";
+import { createUiTools, uiInstructions, } from "./tools.js";
+export const DEFAULT_UI_TIMEOUT_MS = 10_000;
+export function webOriginFromEnv(value = process.env.PARLOR_WEB_ORIGIN) {
+    return value && /^https?:\/\//.test(value) ? value : undefined;
+}
+export function createAgentUi(options) {
+    const external = options.external ?? true;
+    const webOrigin = "webOrigin" in options ? options.webOrigin : webOriginFromEnv();
+    const directory = new ClientDirectory();
+    const confirmations = new ConfirmationBoard({
+        directory,
+        timeoutMs: options.confirmTimeoutMs ?? DEFAULT_CONFIRM_TIMEOUT_MS,
+    });
+    const broker = new UiBroker({ timeoutMs: options.timeoutMs ?? DEFAULT_UI_TIMEOUT_MS });
+    const toolsFor = createUiTools({ directory, broker });
+    let source = () => undefined;
+    let normalized;
+    const manifest = () => {
+        const input = source();
+        if (!input)
+            return undefined;
+        if (normalized?.input !== input) {
+            normalized = { input, manifest: normalizeManifest(input) };
+        }
+        return normalized.manifest;
+    };
+    const tools = (surface) => {
+        const allTools = toolsFor(manifest());
+        if (surface === "agent" || external === true)
+            return allTools;
+        if (external === "read-only")
+            return allTools.filter((tool) => tool.readOnly);
+        return [];
+    };
+    return {
+        channel: {
+            event: UI_CHANNEL,
+            connect: (connection) => directory.connect(connection),
+        },
+        touch: (clientId, audience) => directory.touch(clientId, audience),
+        receive(clientId, audience, message) {
+            switch (message.type) {
+                case "presence": {
+                    const outcome = directory.presence(clientId, audience, message);
+                    const target = directory.target(clientId);
+                    if (outcome === "registered" && target)
+                        broker.reconnected(target);
+                    return { accepted: outcome !== "rejected" };
+                }
+                case "leave": {
+                    const left = directory.leave(clientId, audience);
+                    if (left)
+                        broker.abandon(clientId);
+                    return { accepted: left };
+                }
+                case "reply":
+                    return broker.reply(clientId, message);
+                case "answer":
+                    return { accepted: confirmations.answer(clientId, audience, message) };
+            }
+        },
+        tools,
+        async contextFor(request, origin, signal, chat) {
+            return {
+                scope: request ? await options.audience(request) : "default",
+                ...(chat ? { clientId: chat.clientId } : {}),
+                origin,
+                signal,
+                webOrigin: webOrigin ?? (request ? new URL(request.url).origin : undefined),
+            };
+        },
+        instructions: (surface) => (tools(surface).length > 0 ? uiInstructions() : undefined),
+        confirm: (request) => confirmations.ask(request),
+        manifest,
+        install(next) {
+            source = next;
+        },
+        close: () => {
+            broker.close();
+            confirmations.close();
+        },
+    };
+}
+//# sourceMappingURL=agent-ui.js.map

package/dist/server/agent-ui.js.map

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

package/dist/server/audience.d.ts

@@ -0,0 +1,9 @@
+import { type Principal, type UserId } 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 declare function audienceOf(scope: string, principal: Principal | undefined): string;
+/** `audienceOf` for a known user: the sync stream only that user's tabs and computers hear. */
+export declare function userAudience(scope: string, userId: UserId | undefined): string;
+//# sourceMappingURL=audience.d.ts.map