@parlor/agent-ui 0.0.0-stage → 0.2.0

package/dist/client/write.js

@@ -0,0 +1,101 @@
+import { jsonEqual } from "./json-equal.js";
+export { jsonEqual };
+export function notMounted(input) {
+    const target = input.key === undefined ? input.view : `${input.view} ${input.key}`;
+    return {
+        code: "not_mounted",
+        message: `${target} is not on screen. Call ui_screen to see what is.`,
+    };
+}
+export function userEditing(registry, target, changed, env) {
+    const document = env.document;
+    if (!document?.hasFocus())
+        return [];
+    const active = document.activeElement;
+    if (!active || active === registry.agentFocus() || registry.owner(active) !== target) {
+        return [];
+    }
+    const name = active.getAttribute("name");
+    return name !== null && changed.includes(name) ? [name] : [];
+}
+const NO_FIELDS = new Set();
+export function agentFieldsOf(writes, current) {
+    if (writes.size === 0)
+        return NO_FIELDS;
+    return new Set([...writes.keys()].filter((field) => jsonEqual(current[field], writes.get(field))));
+}
+function refused(view, fields, detail) {
+    return {
+        code: "not_writable",
+        message: `${view.name}: ${detail}`,
+        issues: fields.map((path) => ({ path, message: "Not writable" })),
+    };
+}
+function unlistedFields(view, changed) {
+    const { writable } = view;
+    if (writable === true)
+        return [];
+    return changed.filter((field) => writable === false || !writable.includes(field));
+}
+function writableDetail(view) {
+    const { writable } = view;
+    return writable === false || writable === true || writable.length === 0
+        ? "this view is read-only."
+        : `only ${writable.join(", ")} can be written.`;
+}
+const pick = (source, fields) => Object.fromEntries(fields.filter((f) => Object.hasOwn(source, f)).map((f) => [f, source[f]]));
+const segmentOf = (segment) => String(typeof segment === "object" ? segment.key : segment);
+export async function setView(registry, input, env) {
+    const target = registry.find(input);
+    if (!target)
+        return notMounted(input);
+    const { view, binding } = target;
+    const changed = Object.keys(input.value);
+    const unlisted = unlistedFields(view, changed);
+    if (unlisted.length > 0 || !binding.set) {
+        return refused(view, unlisted.length > 0 ? unlisted : changed, writableDetail(view));
+    }
+    const editing = userEditing(registry, target, changed, env);
+    if (editing.length > 0) {
+        return {
+            code: "user_editing",
+            message: `The user is typing in ${editing.join(", ")}. Wait, or ask them.`,
+            issues: editing.map((path) => ({ path, message: "The user is typing here." })),
+        };
+    }
+    const checked = await view.schema["~standard"].validate({
+        ...binding.get(),
+        ...input.value,
+    });
+    if (checked.issues) {
+        return {
+            code: "invalid_value",
+            message: `${view.name} would be invalid with this value.`,
+            issues: checked.issues.map(({ path, message }) => ({
+                path: path?.map(segmentOf).join(".") ?? "",
+                message,
+            })),
+        };
+    }
+    const parsed = checked.value;
+    const dropped = changed.filter((field) => !Object.hasOwn(parsed, field));
+    if (dropped.length > 0) {
+        return refused(view, dropped, `${dropped.join(", ")} is not a field of this view.`);
+    }
+    const accepted = pick(parsed, changed);
+    const previous = target.writes;
+    registry.remember(target, accepted);
+    try {
+        await binding.set(parsed, changed);
+    }
+    catch (error) {
+        registry.restore(target, previous);
+        throw error;
+    }
+    const value = registry.find(input)?.binding.get() ?? parsed;
+    const normalised = changed.filter((field) => !jsonEqual(value[field], accepted[field]));
+    if (normalised.length > 0)
+        registry.remember(target, pick(value, normalised));
+    return { value, agentFields: [...agentFieldsOf(target.writes, value)] };
+}
+//# sourceMappingURL=write.js.map

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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","sourcesContent":["import type { UiError, UiOpInput, UiOpResults } from \"../protocol.js\";\nimport type { AnyAgentView } from \"../view.js\";\nimport type { BrowserEnvironment } from \"./environment.js\";\nimport { jsonEqual } from \"./json-equal.js\";\nimport type { AgentWrites, MountedView, ViewRegistryRuntime } from \"./registry.js\";\n\nexport { jsonEqual };\n\nexport function notMounted(input: { view: string; key?: string | undefined }): UiError {\n  const target = input.key === undefined ? input.view : `${input.view} ${input.key}`;\n  return {\n    code: \"not_mounted\",\n    message: `${target} is not on screen. Call ui_screen to see what is.`,\n  };\n}\n\nexport function userEditing(\n  registry: Pick<ViewRegistryRuntime, \"owner\" | \"agentFocus\">,\n  target: MountedView,\n  changed: readonly string[],\n  env: Pick<BrowserEnvironment, \"document\">,\n): readonly string[] {\n  const document = env.document;\n  if (!document?.hasFocus()) return [];\n  const active = document.activeElement;\n  if (!active || active === registry.agentFocus() || registry.owner(active) !== target) {\n    return [];\n  }\n  const name = active.getAttribute(\"name\");\n  return name !== null && changed.includes(name) ? [name] : [];\n}\n\nconst NO_FIELDS: ReadonlySet<string> = new Set();\n\nexport function agentFieldsOf(\n  writes: AgentWrites,\n  current: Readonly<Record<string, unknown>>,\n): ReadonlySet<string> {\n  if (writes.size === 0) return NO_FIELDS;\n  return new Set(\n    [...writes.keys()].filter((field) => jsonEqual(current[field], writes.get(field))),\n  );\n}\n\nfunction refused(view: AnyAgentView, fields: readonly string[], detail: string): UiError {\n  return {\n    code: \"not_writable\",\n    message: `${view.name}: ${detail}`,\n    issues: fields.map((path) => ({ path, message: \"Not writable\" })),\n  };\n}\n\nfunction unlistedFields(view: AnyAgentView, changed: readonly string[]): string[] {\n  const { writable } = view;\n  if (writable === true) return [];\n  return changed.filter((field) => writable === false || !writable.includes(field));\n}\n\nfunction writableDetail(view: AnyAgentView): string {\n  const { writable } = view;\n  return writable === false || writable === true || writable.length === 0\n    ? \"this view is read-only.\"\n    : `only ${writable.join(\", \")} can be written.`;\n}\n\nconst pick = (source: Readonly<Record<string, unknown>>, fields: readonly string[]) =>\n  Object.fromEntries(\n    fields.filter((f) => Object.hasOwn(source, f)).map((f) => [f, source[f]]),\n  );\n\nconst segmentOf = (segment: PropertyKey | { readonly key: PropertyKey }) =>\n  String(typeof segment === \"object\" ? segment.key : segment);\n\nexport async function setView(\n  registry: ViewRegistryRuntime,\n  input: UiOpInput<\"set\">,\n  env: Pick<BrowserEnvironment, \"document\">,\n): Promise<UiOpResults[\"set\"] | UiError> {\n  const target = registry.find(input);\n  if (!target) return notMounted(input);\n  const { view, binding } = target;\n  const changed = Object.keys(input.value);\n\n  const unlisted = unlistedFields(view, changed);\n  if (unlisted.length > 0 || !binding.set) {\n    return refused(view, unlisted.length > 0 ? unlisted : changed, writableDetail(view));\n  }\n  const editing = userEditing(registry, target, changed, env);\n  if (editing.length > 0) {\n    return {\n      code: \"user_editing\",\n      message: `The user is typing in ${editing.join(\", \")}. Wait, or ask them.`,\n      issues: editing.map((path) => ({ path, message: \"The user is typing here.\" })),\n    };\n  }\n\n  const checked = await view.schema[\"~standard\"].validate({\n    ...binding.get(),\n    ...input.value,\n  });\n  if (checked.issues) {\n    return {\n      code: \"invalid_value\",\n      message: `${view.name} would be invalid with this value.`,\n      issues: checked.issues.map(({ path, message }) => ({\n        path: path?.map(segmentOf).join(\".\") ?? \"\",\n        message,\n      })),\n    };\n  }\n  const parsed = checked.value;\n  const dropped = changed.filter((field) => !Object.hasOwn(parsed, field));\n  if (dropped.length > 0) {\n    return refused(view, dropped, `${dropped.join(\", \")} is not a field of this view.`);\n  }\n\n  const accepted = pick(parsed, changed);\n  const previous = target.writes;\n  registry.remember(target, accepted);\n  try {\n    await binding.set(parsed, changed);\n  } catch (error) {\n    registry.restore(target, previous);\n    throw error;\n  }\n\n  const value = registry.find(input)?.binding.get() ?? parsed;\n  const normalised = changed.filter((field) => !jsonEqual(value[field], accepted[field]));\n  if (normalised.length > 0) registry.remember(target, pick(value, normalised));\n  return { value, agentFields: [...agentFieldsOf(target.writes, value)] };\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+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";
+export { pagePattern, UNROUTED_HEADER } from "./pages.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;AACnB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+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";
+export { pagePattern, UNROUTED_HEADER } from "./pages.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;AACnB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export {\n  type AgentRouteData,\n  type JsonSchema,\n  type ManifestBuild,\n  type RouteEntry,\n  routeHref,\n  type UiAppInfo,\n  UI_MANIFEST_FILE,\n  type UiManifest,\n  type ViewEntry,\n} from \"./manifest.js\";\nexport {\n  type AgentOrigin,\n  type AttentionSnapshot,\n  type ClientMessage,\n  type ClientSummary,\n  type FocusSnapshot,\n  type ItemSnapshot,\n  type JsonObject,\n  type KeyedViewSnapshot,\n  type LeaveNotice,\n  MAX_WATCHED_THREADS,\n  type MatchedRouteSnapshot,\n  type NotFoundRouteSnapshot,\n  type PresenceUpdate,\n  type QuerySnapshot,\n  type QueryStatus,\n  type RecentRef,\n  type RouteSnapshot,\n  type ScreenSnapshot,\n  type SelectionSnapshot,\n  type SingleViewSnapshot,\n  type TruncatedValue,\n  UI_CHANNEL,\n  UI_ERROR_CODES,\n  UI_OPS,\n  type UiError,\n  type UiErrorCode,\n  type UiOp,\n  type UiOpInput,\n  type UiOpInputs,\n  uiOpReadOnly,\n  uiOps,\n  type UiOpResults,\n  type UiReply,\n  type UiRequest,\n  type ViewSnapshot,\n} from \"./protocol.js\";\nexport {\n  type AgentViewBinding,\n  type AgentViewConfig,\n  type AgentViewDefinition,\n  type AnyAgentView,\n  defineAgentView,\n  isAgentView,\n  type IsWritable,\n  type ViewField,\n  type ViewRef,\n  type ViewSchema,\n  type ViewSetter,\n  type ViewValue,\n  type WritableField,\n} from \"./view.js\";\nexport { pagePattern, UNROUTED_HEADER } from \"./pages.js\";\n"]}

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","sourcesContent":["import type { StaticDataRouteOption } from \"@tanstack/router-core\";\n\nimport type { AnyAgentView } from \"./view.js\";\n\ndeclare module \"@tanstack/router-core\" {\n  interface StaticDataRouteOption {\n    readonly description?: string | undefined;\n    readonly views?: readonly AnyAgentView[] | undefined;\n  }\n}\n\nexport type AgentRouteData = Pick<StaticDataRouteOption, \"description\" | \"views\">;\n\nexport const UI_MANIFEST_FILE = \"ui-manifest.json\";\n\nexport type JsonSchema = Readonly<Record<string, unknown>>;\n\nexport interface UiAppInfo {\n  readonly id: string;\n  readonly name: string;\n  readonly description?: string | undefined;\n  readonly scheme?: string | undefined;\n}\n\nexport interface RouteEntry {\n  readonly path: string;\n  readonly description?: string | undefined;\n  readonly params: readonly string[];\n  readonly search?: JsonSchema | undefined;\n  readonly views: readonly string[];\n}\n\nexport interface ViewEntry {\n  readonly name: string;\n  readonly description: string;\n  readonly keyed: boolean;\n  readonly schema?: JsonSchema | undefined;\n  readonly writable: readonly string[];\n}\n\nexport interface UiManifest {\n  readonly protocol: 1;\n  readonly app: UiAppInfo;\n  readonly buildId?: string | undefined;\n  readonly routes: readonly RouteEntry[];\n  readonly views: readonly ViewEntry[];\n}\n\nexport interface ManifestBuild {\n  readonly manifest: UiManifest;\n  readonly warnings: readonly string[];\n}\n\nexport function routeHref(\n  route: RouteEntry,\n  params: Readonly<Record<string, string>> | undefined,\n  search: Readonly<Record<string, unknown>> | undefined,\n): string {\n  const path = route.path\n    .split(\"/\")\n    .map((segment) => {\n      if (!segment.startsWith(\"$\")) return segment;\n      const value = params?.[segment === \"$\" ? \"_splat\" : segment.slice(1)] ?? \"\";\n      return segment === \"$\"\n        ? value.split(\"/\").map(encodeURIComponent).join(\"/\")\n        : encodeURIComponent(value);\n    })\n    .join(\"/\");\n  const query = new URLSearchParams();\n  for (const [key, value] of Object.entries(search ?? {})) {\n    if (value === undefined) continue;\n    query.set(key, typeof value === \"string\" ? value : JSON.stringify(value));\n  }\n  const queryString = query.toString();\n  return queryString ? `${path}?${queryString}` : path;\n}\n"]}

package/dist/pages.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Marks the 404 the app's server answers when none of its routes match, so the host serves
+ * the app's document instead and the page shows its own not-found view.
+ */
+export declare const UNROUTED_HEADER = "x-parlor-unrouted";
+/**
+ * Matches the URL paths, with or without a query string, that the page route at `path`
+ * renders, case-insensitively like the router.
+ */
+export declare function pagePattern(path: string): RegExp;
+//# sourceMappingURL=pages.d.ts.map

package/dist/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAyBnD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD"}

package/dist/pages.js

@@ -0,0 +1,42 @@
+/**
+ * Marks the 404 the app's server answers when none of its routes match, so the host serves
+ * the app's document instead and the page shows its own not-found view.
+ */
+export const UNROUTED_HEADER = "x-parlor-unrouted";
+const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** Mirrors `parseSegment` in `@tanstack/router-core`, erring towards matching more. */
+function segmentSource(segment) {
+    if (segment === "$")
+        return { source: "(?:/.*)?", rest: true };
+    if (segment.startsWith("$"))
+        return { source: "/[^/]+", rest: false };
+    const open = segment.indexOf("{");
+    const close = segment.indexOf("}", open);
+    const optional = segment[open + 1] === "-";
+    const nameStart = open + (optional ? 3 : 2);
+    if (open < 0 || close < 0 || segment[nameStart - 1] !== "$") {
+        return { source: `/${escape(segment)}`, rest: false };
+    }
+    const prefix = escape(segment.slice(0, open));
+    const suffix = escape(segment.slice(close + 1));
+    if (optional)
+        return { source: `(?:/${prefix}[^/]+${suffix})?`, rest: false };
+    if (nameStart === close)
+        return { source: `/${prefix}.*`, rest: true };
+    return { source: `/${prefix}[^/]+${suffix}`, rest: false };
+}
+/**
+ * Matches the URL paths, with or without a query string, that the page route at `path`
+ * renders, case-insensitively like the router.
+ */
+export function pagePattern(path) {
+    let source = "";
+    for (const segment of path.split("/").filter(Boolean)) {
+        const next = segmentSource(segment);
+        source += next.source;
+        if (next.rest)
+            break;
+    }
+    return new RegExp(`^${source}/?(?:\\?.*)?$`, "i");
+}
+//# sourceMappingURL=pages.js.map

package/dist/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAEnD,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAE7E,uFAAuF;AACvF,SAAS,aAAa,CAAC,OAAe;IAIpC,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/D,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QAC5D,OAAO,EAAE,MAAM,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACxD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,MAAM,QAAQ,MAAM,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC9E,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,MAAM,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,IAAI,MAAM,QAAQ,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QACtB,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM;IACvB,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,eAAe,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC","sourcesContent":["/**\n * Marks the 404 the app's server answers when none of its routes match, so the host serves\n * the app's document instead and the page shows its own not-found view.\n */\nexport const UNROUTED_HEADER = \"x-parlor-unrouted\";\n\nconst escape = (text: string) => text.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n/** Mirrors `parseSegment` in `@tanstack/router-core`, erring towards matching more. */\nfunction segmentSource(segment: string): {\n  readonly source: string;\n  readonly rest: boolean;\n} {\n  if (segment === \"$\") return { source: \"(?:/.*)?\", rest: true };\n  if (segment.startsWith(\"$\")) return { source: \"/[^/]+\", rest: false };\n  const open = segment.indexOf(\"{\");\n  const close = segment.indexOf(\"}\", open);\n  const optional = segment[open + 1] === \"-\";\n  const nameStart = open + (optional ? 3 : 2);\n  if (open < 0 || close < 0 || segment[nameStart - 1] !== \"$\") {\n    return { source: `/${escape(segment)}`, rest: false };\n  }\n  const prefix = escape(segment.slice(0, open));\n  const suffix = escape(segment.slice(close + 1));\n  if (optional) return { source: `(?:/${prefix}[^/]+${suffix})?`, rest: false };\n  if (nameStart === close) return { source: `/${prefix}.*`, rest: true };\n  return { source: `/${prefix}[^/]+${suffix}`, rest: false };\n}\n\n/**\n * Matches the URL paths, with or without a query string, that the page route at `path`\n * renders, case-insensitively like the router.\n */\nexport function pagePattern(path: string): RegExp {\n  let source = \"\";\n  for (const segment of path.split(\"/\").filter(Boolean)) {\n    const next = segmentSource(segment);\n    source += next.source;\n    if (next.rest) break;\n  }\n  return new RegExp(`^${source}/?(?:\\\\?.*)?$`, \"i\");\n}\n"]}

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