@parlor/client 0.0.0-stage → 0.2.0

package/dist/react/agent-ui/chat-confirm.js

@@ -0,0 +1,140 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, Fragment, use, useCallback, useId, useLayoutEffect, useMemo, useRef, } from "react";
+import { useAgentConfirmations } from "./use-agent-confirmations.js";
+const ConfirmScope = createContext(undefined);
+const ListScope = createContext(undefined);
+function assignRef(ref, value) {
+    if (typeof ref === "function")
+        return ref(value);
+    if (ref) {
+        ref.current = value;
+        return () => {
+            ref.current = null;
+        };
+    }
+}
+function useConfirm(part) {
+    const scope = use(ConfirmScope);
+    if (!scope)
+        throw new Error(`${part} must be rendered inside Chat.Confirm.`);
+    return scope;
+}
+/**
+ * Lists the agent requests waiting for this user, newest last. Rendering it is what tells
+ * the server this client can show a confirmation, so keep it mounted wherever the user can
+ * answer. `data-pending` carries the count while any wait. When the card holding focus goes
+ * away, focus moves to the next card, or to the list when none is left, so it never falls
+ * out of an enclosing dialog.
+ */
+export function Confirmations({ empty, children, ref, ...props }) {
+    const confirmations = useAgentConfirmations();
+    const list = useRef(null);
+    const cards = useRef(new Map());
+    const shownIds = useRef([]);
+    const releasedId = useRef(undefined);
+    const attach = useCallback((element) => {
+        list.current = element;
+        const detach = assignRef(ref, element);
+        return () => {
+            list.current = null;
+            if (detach)
+                detach();
+            else
+                assignRef(ref, null);
+        };
+    }, [ref]);
+    const scope = useMemo(() => ({
+        register: (id, element) => {
+            cards.current.set(id, element);
+            return () => {
+                cards.current.delete(id);
+            };
+        },
+        releasingFocus: (id) => {
+            releasedId.current = id;
+        },
+    }), []);
+    useLayoutEffect(() => {
+        const released = releasedId.current;
+        releasedId.current = undefined;
+        const ids = confirmations.map((confirmation) => confirmation.id);
+        const previousIds = shownIds.current;
+        shownIds.current = ids;
+        const listElement = list.current;
+        if (released === undefined || !listElement)
+            return;
+        const active = document.activeElement;
+        if (active && active !== document.body && listElement.contains(active))
+            return;
+        const index = previousIds.indexOf(released);
+        const nextId = ids[Math.min(index, ids.length - 1)];
+        (nextId === undefined
+            ? listElement
+            : (cards.current.get(nextId) ?? listElement)).focus();
+    });
+    return (_jsx(ListScope, { value: scope, children: _jsx("div", { "aria-live": "polite", tabIndex: -1, ...props, ref: attach, "data-pending": confirmations.length > 0 ? confirmations.length : undefined, children: confirmations.length === 0
+                ? empty
+                : confirmations.map((confirmation) => (_jsx(Fragment, { children: children(confirmation) }, confirmation.id))) }) }));
+}
+/**
+ * One request as a labelled group. Escape inside it declines, and stops there so an
+ * enclosing dialog stays open. It never takes focus by itself, but it can hold it
+ * (`tabIndex` -1) so `Chat.Confirmations` can keep focus in the list.
+ */
+export function Confirm({ confirmation, onKeyDown, ref, ...props }) {
+    const labelId = useId();
+    const list = use(ListScope);
+    const group = useRef(null);
+    const { id } = confirmation;
+    useLayoutEffect(() => {
+        const element = group.current;
+        if (!list || !element)
+            return;
+        const unregister = list.register(id, element);
+        return () => {
+            if (element.contains(document.activeElement))
+                list.releasingFocus(id);
+            unregister();
+        };
+    }, [list, id]);
+    const attach = useCallback((element) => {
+        group.current = element;
+        const detach = assignRef(ref, element);
+        return () => {
+            if (detach)
+                detach();
+            else
+                assignRef(ref, null);
+        };
+    }, [ref]);
+    const decline = (event) => {
+        onKeyDown?.(event);
+        if (event.defaultPrevented || event.key !== "Escape")
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        confirmation.decline();
+    };
+    return (_jsx(ConfirmScope, { value: { confirmation, labelId }, children: _jsx("div", { role: "group", "aria-labelledby": labelId, "data-action": confirmation.action, tabIndex: -1, ...props, ref: attach, onKeyDown: decline }) }));
+}
+export function ConfirmLabel(props) {
+    const { labelId } = useConfirm("Chat.ConfirmLabel");
+    return _jsx("p", { ...props, id: labelId });
+}
+export function Approve({ onClick, ...props }) {
+    const { confirmation } = useConfirm("Chat.Approve");
+    return (_jsx("button", { type: "button", ...props, onClick: (event) => {
+            onClick?.(event);
+            if (!event.defaultPrevented)
+                confirmation.approve();
+        } }));
+}
+export function Decline({ onClick, ...props }) {
+    const { confirmation } = useConfirm("Chat.Decline");
+    return (_jsx("button", { type: "button", ...props, onClick: (event) => {
+            onClick?.(event);
+            if (!event.defaultPrevented)
+                confirmation.decline();
+        } }));
+}
+//# sourceMappingURL=chat-confirm.js.map

package/dist/react/agent-ui/chat-confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-confirm.js","sourceRoot":"","sources":["../../../src/react/agent-ui/chat-confirm.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { AgentConfirmation } from \"@parlor/agent-ui/client\";\nimport {\n  type ComponentProps,\n  createContext,\n  Fragment,\n  type KeyboardEvent,\n  type ReactNode,\n  type Ref,\n  use,\n  useCallback,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n} from \"react\";\n\nimport { useAgentConfirmations } from \"./use-agent-confirmations.js\";\n\ninterface ConfirmContext {\n  readonly confirmation: AgentConfirmation;\n  readonly labelId: string;\n}\n\nconst ConfirmScope = createContext<ConfirmContext | undefined>(undefined);\n\ninterface ListContext {\n  readonly register: (id: string, element: HTMLElement) => () => void;\n  readonly releasingFocus: (id: string) => void;\n}\n\nconst ListScope = createContext<ListContext | undefined>(undefined);\n\nfunction assignRef<T>(ref: Ref<T> | undefined, value: T | null): (() => void) | void {\n  if (typeof ref === \"function\") return ref(value);\n  if (ref) {\n    ref.current = value;\n    return () => {\n      ref.current = null;\n    };\n  }\n}\n\nfunction useConfirm(part: string): ConfirmContext {\n  const scope = use(ConfirmScope);\n  if (!scope) throw new Error(`${part} must be rendered inside Chat.Confirm.`);\n  return scope;\n}\n\nexport interface ChatConfirmationsProps extends Omit<ComponentProps<\"div\">, \"children\"> {\n  /** Shown while no agent request waits. */\n  readonly empty?: ReactNode;\n  readonly children: (confirmation: AgentConfirmation) => ReactNode;\n}\n\n/**\n * Lists the agent requests waiting for this user, newest last. Rendering it is what tells\n * the server this client can show a confirmation, so keep it mounted wherever the user can\n * answer. `data-pending` carries the count while any wait. When the card holding focus goes\n * away, focus moves to the next card, or to the list when none is left, so it never falls\n * out of an enclosing dialog.\n */\nexport function Confirmations({\n  empty,\n  children,\n  ref,\n  ...props\n}: ChatConfirmationsProps) {\n  const confirmations = useAgentConfirmations();\n  const list = useRef<HTMLDivElement | null>(null);\n  const cards = useRef(new Map<string, HTMLElement>());\n  const shownIds = useRef<readonly string[]>([]);\n  const releasedId = useRef<string | undefined>(undefined);\n  const attach = useCallback(\n    (element: HTMLDivElement | null) => {\n      list.current = element;\n      const detach = assignRef(ref, element);\n      return () => {\n        list.current = null;\n        if (detach) detach();\n        else assignRef(ref, null);\n      };\n    },\n    [ref],\n  );\n  const scope = useMemo<ListContext>(\n    () => ({\n      register: (id, element) => {\n        cards.current.set(id, element);\n        return () => {\n          cards.current.delete(id);\n        };\n      },\n      releasingFocus: (id) => {\n        releasedId.current = id;\n      },\n    }),\n    [],\n  );\n\n  useLayoutEffect(() => {\n    const released = releasedId.current;\n    releasedId.current = undefined;\n    const ids = confirmations.map((confirmation) => confirmation.id);\n    const previousIds = shownIds.current;\n    shownIds.current = ids;\n    const listElement = list.current;\n    if (released === undefined || !listElement) return;\n    const active = document.activeElement;\n    if (active && active !== document.body && listElement.contains(active)) return;\n    const index = previousIds.indexOf(released);\n    const nextId = ids[Math.min(index, ids.length - 1)];\n    (nextId === undefined\n      ? listElement\n      : (cards.current.get(nextId) ?? listElement)\n    ).focus();\n  });\n\n  return (\n    <ListScope value={scope}>\n      <div\n        aria-live=\"polite\"\n        tabIndex={-1}\n        {...props}\n        ref={attach}\n        data-pending={confirmations.length > 0 ? confirmations.length : undefined}\n      >\n        {confirmations.length === 0\n          ? empty\n          : confirmations.map((confirmation) => (\n              <Fragment key={confirmation.id}>{children(confirmation)}</Fragment>\n            ))}\n      </div>\n    </ListScope>\n  );\n}\n\nexport interface ChatConfirmProps extends ComponentProps<\"div\"> {\n  readonly confirmation: AgentConfirmation;\n}\n\n/**\n * One request as a labelled group. Escape inside it declines, and stops there so an\n * enclosing dialog stays open. It never takes focus by itself, but it can hold it\n * (`tabIndex` -1) so `Chat.Confirmations` can keep focus in the list.\n */\nexport function Confirm({ confirmation, onKeyDown, ref, ...props }: ChatConfirmProps) {\n  const labelId = useId();\n  const list = use(ListScope);\n  const group = useRef<HTMLDivElement | null>(null);\n  const { id } = confirmation;\n  useLayoutEffect(() => {\n    const element = group.current;\n    if (!list || !element) return;\n    const unregister = list.register(id, element);\n    return () => {\n      if (element.contains(document.activeElement)) list.releasingFocus(id);\n      unregister();\n    };\n  }, [list, id]);\n  const attach = useCallback(\n    (element: HTMLDivElement | null) => {\n      group.current = element;\n      const detach = assignRef(ref, element);\n      return () => {\n        if (detach) detach();\n        else assignRef(ref, null);\n      };\n    },\n    [ref],\n  );\n  const decline = (event: KeyboardEvent<HTMLDivElement>) => {\n    onKeyDown?.(event);\n    if (event.defaultPrevented || event.key !== \"Escape\") return;\n    event.preventDefault();\n    event.stopPropagation();\n    confirmation.decline();\n  };\n  return (\n    <ConfirmScope value={{ confirmation, labelId }}>\n      <div\n        role=\"group\"\n        aria-labelledby={labelId}\n        data-action={confirmation.action}\n        tabIndex={-1}\n        {...props}\n        ref={attach}\n        onKeyDown={decline}\n      />\n    </ConfirmScope>\n  );\n}\n\nexport function ConfirmLabel(props: Omit<ComponentProps<\"p\">, \"id\">) {\n  const { labelId } = useConfirm(\"Chat.ConfirmLabel\");\n  return <p {...props} id={labelId} />;\n}\n\nexport function Approve({ onClick, ...props }: ComponentProps<\"button\">) {\n  const { confirmation } = useConfirm(\"Chat.Approve\");\n  return (\n    <button\n      type=\"button\"\n      {...props}\n      onClick={(event) => {\n        onClick?.(event);\n        if (!event.defaultPrevented) confirmation.approve();\n      }}\n    />\n  );\n}\n\nexport function Decline({ onClick, ...props }: ComponentProps<\"button\">) {\n  const { confirmation } = useConfirm(\"Chat.Decline\");\n  return (\n    <button\n      type=\"button\"\n      {...props}\n      onClick={(event) => {\n        onClick?.(event);\n        if (!event.defaultPrevented) confirmation.decline();\n      }}\n    />\n  );\n}\n"]}

package/dist/react/agent-ui/chat.d.ts

@@ -0,0 +1,7 @@
+export { Activity } from "./chat-activity.js";
+export { Approve, Confirm, ConfirmLabel, Confirmations, Decline, } from "./chat-confirm.js";
+export { Ask, AskChoice, AskForm } from "../chat/chat-ask.js";
+export { Composer, Input, Send, Status, Stop } from "../chat/chat-composer.js";
+export { Root } from "../chat/chat-root.js";
+export { LoadOlder, Thread } from "../chat/chat-thread.js";
+//# sourceMappingURL=chat.d.ts.map

package/dist/react/agent-ui/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/react/agent-ui/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,OAAO,EACP,OAAO,EACP,YAAY,EACZ,aAAa,EACb,OAAO,GACR,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/react/agent-ui/chat.js

@@ -0,0 +1,7 @@
+export { Activity } from "./chat-activity.js";
+export { Approve, Confirm, ConfirmLabel, Confirmations, Decline, } from "./chat-confirm.js";
+export { Ask, AskChoice, AskForm } from "../chat/chat-ask.js";
+export { Composer, Input, Send, Status, Stop } from "../chat/chat-composer.js";
+export { Root } from "../chat/chat-root.js";
+export { LoadOlder, Thread } from "../chat/chat-thread.js";
+//# sourceMappingURL=chat.js.map

package/dist/react/agent-ui/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/react/agent-ui/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,OAAO,EACP,OAAO,EACP,YAAY,EACZ,aAAa,EACb,OAAO,GACR,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["export { Activity } from \"./chat-activity.js\";\nexport {\n  Approve,\n  Confirm,\n  ConfirmLabel,\n  Confirmations,\n  Decline,\n} from \"./chat-confirm.js\";\nexport { Ask, AskChoice, AskForm } from \"../chat/chat-ask.js\";\nexport { Composer, Input, Send, Status, Stop } from \"../chat/chat-composer.js\";\nexport { Root } from \"../chat/chat-root.js\";\nexport { LoadOlder, Thread } from \"../chat/chat-thread.js\";\n"]}

package/dist/react/agent-ui/dev.d.ts

@@ -0,0 +1,12 @@
+import type { ScreenSnapshot } from "@parlor/agent-ui";
+import type { AgentUiClient } from "@parlor/agent-ui/client";
+declare global {
+    interface Window {
+        __parlor?: {
+            readonly clientId: string;
+            screen(): Promise<ScreenSnapshot>;
+        } | undefined;
+    }
+}
+export declare function installAgentUiDevtools(agentUi: AgentUiClient, clientId: string): () => void;
+//# sourceMappingURL=dev.d.ts.map

package/dist/react/agent-ui/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/react/agent-ui/dev.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,CAAC,EACL;YAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;SAAE,GAChE,SAAS,CAAC;KACf;CACF;AA4ED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,IAAI,CAOZ"}

package/dist/react/agent-ui/dev.js

@@ -0,0 +1,80 @@
+const TOGGLE_HINT = "Alt+Shift+A";
+const MAX_LOG = 10;
+function overlay(agentUi, clientId) {
+    const panel = document.createElement("aside");
+    panel.setAttribute("aria-label", "Parlor agent UI");
+    panel.hidden = true;
+    Object.assign(panel.style, {
+        position: "fixed",
+        right: "12px",
+        bottom: "12px",
+        width: "min(420px, calc(100vw - 24px))",
+        maxHeight: "60vh",
+        overflow: "auto",
+        zIndex: "2147483647",
+        background: "#111",
+        color: "#eee",
+        font: "12px/1.4 ui-monospace, monospace",
+        padding: "12px",
+        borderRadius: "8px",
+        boxShadow: "0 4px 24px rgba(0, 0, 0, 0.3)",
+    });
+    const header = document.createElement("div");
+    const log = document.createElement("ol");
+    log.style.margin = "8px 0";
+    log.style.paddingLeft = "28px";
+    const snapshot = document.createElement("pre");
+    snapshot.style.margin = "0";
+    snapshot.style.whiteSpace = "pre-wrap";
+    panel.append(header, log, snapshot);
+    document.body.append(panel);
+    const entries = [];
+    let lastStarted;
+    const render = () => {
+        header.textContent = `client ${clientId} (${TOGGLE_HINT} to close)`;
+        log.replaceChildren(...entries.map((text) => Object.assign(document.createElement("li"), { textContent: text })));
+        void agentUi.screen().then((screen) => {
+            snapshot.textContent = JSON.stringify(screen, null, 2);
+        });
+    };
+    const unsubscribe = agentUi.activity.subscribe(() => {
+        const { busy, last } = agentUi.activity.get();
+        if (!busy || !last || last.at === lastStarted)
+            return;
+        lastStarted = last.at;
+        const via = last.origin.name
+            ? `${last.origin.via} ${last.origin.name}`
+            : last.origin.via;
+        entries.unshift(`${new Date(last.at).toLocaleTimeString()} ${last.op} from ${via}`);
+        entries.length = Math.min(entries.length, MAX_LOG);
+        if (!panel.hidden)
+            render();
+    });
+    let refresh;
+    const onKey = (event) => {
+        if (!(event.altKey && event.shiftKey && event.code === "KeyA"))
+            return;
+        panel.hidden = !panel.hidden;
+        clearInterval(refresh);
+        if (panel.hidden)
+            return;
+        render();
+        refresh = setInterval(render, 1000);
+    };
+    window.addEventListener("keydown", onKey);
+    return () => {
+        window.removeEventListener("keydown", onKey);
+        clearInterval(refresh);
+        unsubscribe();
+        panel.remove();
+    };
+}
+export function installAgentUiDevtools(agentUi, clientId) {
+    window.__parlor = { clientId, screen: () => agentUi.screen() };
+    const removeOverlay = overlay(agentUi, clientId);
+    return () => {
+        removeOverlay();
+        delete window.__parlor;
+    };
+}
+//# sourceMappingURL=dev.js.map

package/dist/react/agent-ui/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../../src/react/agent-ui/dev.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ScreenSnapshot } from \"@parlor/agent-ui\";\nimport type { AgentUiClient } from \"@parlor/agent-ui/client\";\n\ndeclare global {\n  interface Window {\n    __parlor?:\n      | { readonly clientId: string; screen(): Promise<ScreenSnapshot> }\n      | undefined;\n  }\n}\n\nconst TOGGLE_HINT = \"Alt+Shift+A\";\nconst MAX_LOG = 10;\n\nfunction overlay(agentUi: AgentUiClient, clientId: string): () => void {\n  const panel = document.createElement(\"aside\");\n  panel.setAttribute(\"aria-label\", \"Parlor agent UI\");\n  panel.hidden = true;\n  Object.assign(panel.style, {\n    position: \"fixed\",\n    right: \"12px\",\n    bottom: \"12px\",\n    width: \"min(420px, calc(100vw - 24px))\",\n    maxHeight: \"60vh\",\n    overflow: \"auto\",\n    zIndex: \"2147483647\",\n    background: \"#111\",\n    color: \"#eee\",\n    font: \"12px/1.4 ui-monospace, monospace\",\n    padding: \"12px\",\n    borderRadius: \"8px\",\n    boxShadow: \"0 4px 24px rgba(0, 0, 0, 0.3)\",\n  });\n  const header = document.createElement(\"div\");\n  const log = document.createElement(\"ol\");\n  log.style.margin = \"8px 0\";\n  log.style.paddingLeft = \"28px\";\n  const snapshot = document.createElement(\"pre\");\n  snapshot.style.margin = \"0\";\n  snapshot.style.whiteSpace = \"pre-wrap\";\n  panel.append(header, log, snapshot);\n  document.body.append(panel);\n\n  const entries: string[] = [];\n  let lastStarted: number | undefined;\n  const render = () => {\n    header.textContent = `client ${clientId} (${TOGGLE_HINT} to close)`;\n    log.replaceChildren(\n      ...entries.map((text) =>\n        Object.assign(document.createElement(\"li\"), { textContent: text }),\n      ),\n    );\n    void agentUi.screen().then((screen) => {\n      snapshot.textContent = JSON.stringify(screen, null, 2);\n    });\n  };\n  const unsubscribe = agentUi.activity.subscribe(() => {\n    const { busy, last } = agentUi.activity.get();\n    if (!busy || !last || last.at === lastStarted) return;\n    lastStarted = last.at;\n    const via = last.origin.name\n      ? `${last.origin.via} ${last.origin.name}`\n      : last.origin.via;\n    entries.unshift(`${new Date(last.at).toLocaleTimeString()} ${last.op} from ${via}`);\n    entries.length = Math.min(entries.length, MAX_LOG);\n    if (!panel.hidden) render();\n  });\n  let refresh: ReturnType<typeof setInterval> | undefined;\n  const onKey = (event: KeyboardEvent) => {\n    if (!(event.altKey && event.shiftKey && event.code === \"KeyA\")) return;\n    panel.hidden = !panel.hidden;\n    clearInterval(refresh);\n    if (panel.hidden) return;\n    render();\n    refresh = setInterval(render, 1000);\n  };\n  window.addEventListener(\"keydown\", onKey);\n  return () => {\n    window.removeEventListener(\"keydown\", onKey);\n    clearInterval(refresh);\n    unsubscribe();\n    panel.remove();\n  };\n}\n\nexport function installAgentUiDevtools(\n  agentUi: AgentUiClient,\n  clientId: string,\n): () => void {\n  window.__parlor = { clientId, screen: () => agentUi.screen() };\n  const removeOverlay = overlay(agentUi, clientId);\n  return () => {\n    removeOverlay();\n    delete window.__parlor;\n  };\n}\n"]}

package/dist/react/agent-ui/runtime.d.ts

@@ -0,0 +1,12 @@
+import { type AgentUiClient } from "@parlor/agent-ui/client";
+import type { QueryClient } from "@tanstack/react-query";
+import type { AnyRouter } from "@tanstack/react-router";
+import type { ActionClient } from "../../action-client.js";
+import type { RegisteredActions } from "../../register.js";
+export interface AgentUiRuntimeInput {
+    readonly client: ActionClient<RegisteredActions>;
+    readonly queryClient: QueryClient;
+    readonly router: AnyRouter | undefined;
+}
+export declare function createAgentUiRuntime({ client, queryClient, router, }: AgentUiRuntimeInput): AgentUiClient;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/react/agent-ui/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/react/agent-ui/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,yBAAyB,CAAC;AAElF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;CACxC;AAqBD,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,WAAW,EACX,MAAM,GACP,EAAE,mBAAmB,GAAG,aAAa,CA2BrC"}

package/dist/react/agent-ui/runtime.js

@@ -0,0 +1,50 @@
+import { createAgentUiClient } from "@parlor/agent-ui/client";
+import { detectPlatform } from "@parlor/capabilities";
+import { ACTION_QUERY_PREFIX } from "../../query-keys.js";
+function fetchingActions(queryClient) {
+    return queryClient.isFetching({ queryKey: ACTION_QUERY_PREFIX });
+}
+function actionsSettled(queryClient, timeoutMs) {
+    if (fetchingActions(queryClient) === 0)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const done = () => {
+            unsubscribe();
+            clearTimeout(timer);
+            resolve();
+        };
+        const unsubscribe = queryClient.getQueryCache().subscribe(() => {
+            if (fetchingActions(queryClient) === 0)
+                done();
+        });
+        const timer = setTimeout(done, timeoutMs);
+    });
+}
+export function createAgentUiRuntime({ client, queryClient, router, }) {
+    return createAgentUiClient({
+        router,
+        queries: {
+            active: () => queryClient
+                .getQueryCache()
+                .findAll({ queryKey: ACTION_QUERY_PREFIX, type: "active" })
+                .map((query) => ({
+                action: String(query.queryKey[ACTION_QUERY_PREFIX.length]),
+                input: query.queryKey[ACTION_QUERY_PREFIX.length + 1] ?? {},
+                status: query.state.status,
+            })),
+            settled: (timeoutMs) => actionsSettled(queryClient, timeoutMs),
+        },
+        send: async (message) => {
+            const response = await client.request(`${client.basePath}/ui`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(message),
+                keepalive: message.type !== "reply",
+            });
+            return response.status === 200 ? response.text() : undefined;
+        },
+        platform: detectPlatform(),
+        dev: import.meta.env.DEV,
+    });
+}
+//# sourceMappingURL=runtime.js.map

package/dist/react/agent-ui/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/react/agent-ui/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAS1D,SAAS,eAAe,CAAC,WAAwB;IAC/C,OAAO,WAAW,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,cAAc,CAAC,WAAwB,EAAE,SAAiB;IACjE,IAAI,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACjE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,WAAW,EAAE,CAAC;YACd,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;YAC7D,IAAI,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,IAAI,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EACnC,MAAM,EACN,WAAW,EACX,MAAM,GACc;IACpB,OAAO,mBAAmB,CAAC;QACzB,MAAM;QACN,OAAO,EAAE;YACP,MAAM,EAAE,GAAG,EAAE,CACX,WAAW;iBACR,aAAa,EAAE;iBACf,OAAO,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;iBAC1D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACf,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBAC1D,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE;gBAC3D,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;aAC3B,CAAC,CAAC;YACP,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,SAAS,CAAC;SAC/D;QACD,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,QAAQ,KAAK,EAAE;gBAC7D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,SAAS,EAAE,OAAO,CAAC,IAAI,KAAK,OAAO;aACpC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/D,CAAC;QACD,QAAQ,EAAE,cAAc,EAAE;QAC1B,GAAG,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { type AgentUiClient, createAgentUiClient } from \"@parlor/agent-ui/client\";\nimport { detectPlatform } from \"@parlor/capabilities\";\nimport type { QueryClient } from \"@tanstack/react-query\";\nimport type { AnyRouter } from \"@tanstack/react-router\";\n\nimport type { ActionClient } from \"../../action-client.js\";\nimport { ACTION_QUERY_PREFIX } from \"../../query-keys.js\";\nimport type { RegisteredActions } from \"../../register.js\";\n\nexport interface AgentUiRuntimeInput {\n  readonly client: ActionClient<RegisteredActions>;\n  readonly queryClient: QueryClient;\n  readonly router: AnyRouter | undefined;\n}\n\nfunction fetchingActions(queryClient: QueryClient): number {\n  return queryClient.isFetching({ queryKey: ACTION_QUERY_PREFIX });\n}\n\nfunction actionsSettled(queryClient: QueryClient, timeoutMs: number): Promise<void> {\n  if (fetchingActions(queryClient) === 0) return Promise.resolve();\n  return new Promise((resolve) => {\n    const done = () => {\n      unsubscribe();\n      clearTimeout(timer);\n      resolve();\n    };\n    const unsubscribe = queryClient.getQueryCache().subscribe(() => {\n      if (fetchingActions(queryClient) === 0) done();\n    });\n    const timer = setTimeout(done, timeoutMs);\n  });\n}\n\nexport function createAgentUiRuntime({\n  client,\n  queryClient,\n  router,\n}: AgentUiRuntimeInput): AgentUiClient {\n  return createAgentUiClient({\n    router,\n    queries: {\n      active: () =>\n        queryClient\n          .getQueryCache()\n          .findAll({ queryKey: ACTION_QUERY_PREFIX, type: \"active\" })\n          .map((query) => ({\n            action: String(query.queryKey[ACTION_QUERY_PREFIX.length]),\n            input: query.queryKey[ACTION_QUERY_PREFIX.length + 1] ?? {},\n            status: query.state.status,\n          })),\n      settled: (timeoutMs) => actionsSettled(queryClient, timeoutMs),\n    },\n    send: async (message) => {\n      const response = await client.request(`${client.basePath}/ui`, {\n        method: \"POST\",\n        headers: { \"content-type\": \"application/json\" },\n        body: JSON.stringify(message),\n        keepalive: message.type !== \"reply\",\n      });\n      return response.status === 200 ? response.text() : undefined;\n    },\n    platform: detectPlatform(),\n    dev: import.meta.env.DEV,\n  });\n}\n"]}

package/dist/react/agent-ui/use-agent-activity.d.ts

@@ -0,0 +1,3 @@
+import type { AgentActivity } from "@parlor/agent-ui/client";
+export declare function useAgentActivity(): AgentActivity;
+//# sourceMappingURL=use-agent-activity.d.ts.map

package/dist/react/agent-ui/use-agent-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-activity.d.ts","sourceRoot":"","sources":["../../../src/react/agent-ui/use-agent-activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK7D,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD"}

package/dist/react/agent-ui/use-agent-activity.js

@@ -0,0 +1,7 @@
+import { useSyncExternalStore } from "react";
+import { useFramework } from "../provider.js";
+export function useAgentActivity() {
+    const { activity } = useFramework().agentUi;
+    return useSyncExternalStore(activity.subscribe, activity.get, activity.get);
+}
+//# sourceMappingURL=use-agent-activity.js.map

package/dist/react/agent-ui/use-agent-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-activity.js","sourceRoot":"","sources":["../../../src/react/agent-ui/use-agent-activity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC,OAAO,CAAC;IAC5C,OAAO,oBAAoB,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["import type { AgentActivity } from \"@parlor/agent-ui/client\";\nimport { useSyncExternalStore } from \"react\";\n\nimport { useFramework } from \"../provider.js\";\n\nexport function useAgentActivity(): AgentActivity {\n  const { activity } = useFramework().agentUi;\n  return useSyncExternalStore(activity.subscribe, activity.get, activity.get);\n}\n"]}

package/dist/react/agent-ui/use-agent-confirmations.d.ts

@@ -0,0 +1,8 @@
+import type { AgentConfirmation } from "@parlor/agent-ui/client";
+/**
+ * The agent requests waiting for this user's approval on this client, newest last. Headless:
+ * the app draws the card and calls `approve` or `decline`. Rendering this hook is what tells
+ * the server this client can show a confirmation; render it where it is always mounted.
+ */
+export declare function useAgentConfirmations(): readonly AgentConfirmation[];
+//# sourceMappingURL=use-agent-confirmations.d.ts.map

package/dist/react/agent-ui/use-agent-confirmations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-confirmations.d.ts","sourceRoot":"","sources":["../../../src/react/agent-ui/use-agent-confirmations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKjE;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,iBAAiB,EAAE,CAOpE"}

package/dist/react/agent-ui/use-agent-confirmations.js

@@ -0,0 +1,12 @@
+import { useSyncExternalStore } from "react";
+import { useFramework } from "../provider.js";
+/**
+ * The agent requests waiting for this user's approval on this client, newest last. Headless:
+ * the app draws the card and calls `approve` or `decline`. Rendering this hook is what tells
+ * the server this client can show a confirmation; render it where it is always mounted.
+ */
+export function useAgentConfirmations() {
+    const { confirmations } = useFramework().agentUi;
+    return useSyncExternalStore(confirmations.subscribe, confirmations.get, confirmations.get);
+}
+//# sourceMappingURL=use-agent-confirmations.js.map

package/dist/react/agent-ui/use-agent-confirmations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-confirmations.js","sourceRoot":"","sources":["../../../src/react/agent-ui/use-agent-confirmations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,aAAa,EAAE,GAAG,YAAY,EAAE,CAAC,OAAO,CAAC;IACjD,OAAO,oBAAoB,CACzB,aAAa,CAAC,SAAS,EACvB,aAAa,CAAC,GAAG,EACjB,aAAa,CAAC,GAAG,CAClB,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentConfirmation } from \"@parlor/agent-ui/client\";\nimport { useSyncExternalStore } from \"react\";\n\nimport { useFramework } from \"../provider.js\";\n\n/**\n * The agent requests waiting for this user's approval on this client, newest last. Headless:\n * the app draws the card and calls `approve` or `decline`. Rendering this hook is what tells\n * the server this client can show a confirmation; render it where it is always mounted.\n */\nexport function useAgentConfirmations(): readonly AgentConfirmation[] {\n  const { confirmations } = useFramework().agentUi;\n  return useSyncExternalStore(\n    confirmations.subscribe,\n    confirmations.get,\n    confirmations.get,\n  );\n}\n"]}

package/dist/react/agent-ui/use-agent-view.d.ts

@@ -0,0 +1,11 @@
+import type { AgentViewBinding, AnyAgentView, WritableField } from "@parlor/agent-ui";
+export interface AgentViewHandle<D extends AnyAgentView = AnyAgentView> {
+    readonly ref: (element: Element | null) => void;
+    /**
+     * Fields the agent wrote that still hold what it wrote, for the app to style; the user
+     * changing a field removes it. Always empty for a read-only view.
+     */
+    readonly agentFields: ReadonlySet<WritableField<D>>;
+}
+export declare function useAgentView<D extends AnyAgentView>(view: D, binding: AgentViewBinding<D>): AgentViewHandle<D>;
+//# sourceMappingURL=use-agent-view.d.ts.map

package/dist/react/agent-ui/use-agent-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-view.d.ts","sourceRoot":"","sources":["../../../src/react/agent-ui/use-agent-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOtF,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACpE,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;CACrD;AAYD,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EACjD,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,eAAe,CAAC,CAAC,CAAC,CASpB"}

package/dist/react/agent-ui/use-agent-view.js

@@ -0,0 +1,25 @@
+import { agentFieldsOf } from "@parlor/agent-ui/client";
+import { useEffect, useInsertionEffect, useState, useSyncExternalStore } from "react";
+import { flushSync } from "react-dom";
+import { useFramework } from "../provider.js";
+function committing(binding) {
+    const { set } = binding;
+    if (!set)
+        return binding;
+    return {
+        key: binding.key,
+        get: binding.get,
+        set: (next, changed) => flushSync(() => set(next, changed)),
+    };
+}
+export function useAgentView(view, binding) {
+    const { agentUi } = useFramework();
+    const erased = committing(binding);
+    const [slot] = useState(() => agentUi.views.track(view, erased));
+    useInsertionEffect(() => slot.bind(erased));
+    useEffect(() => slot.mount(binding.key), [slot, binding.key]);
+    const writes = useSyncExternalStore(slot.subscribeWrites, slot.writes, slot.writes);
+    const agentFields = agentFieldsOf(writes, writes.size === 0 ? {} : binding.get());
+    return { ref: slot.ref, agentFields };
+}
+//# sourceMappingURL=use-agent-view.js.map

package/dist/react/agent-ui/use-agent-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-view.js","sourceRoot":"","sources":["../../../src/react/agent-ui/use-agent-view.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAuB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAW9C,SAAS,UAAU,CAAC,OAAuC;IACzD,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACxB,IAAI,CAAC,GAAG;QAAE,OAAO,OAAO,CAAC;IACzB,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAO,EACP,OAA4B;IAE5B,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAoD,CAAC,CAAC;IAChF,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpF,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAClF,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,EAAwB,CAAC;AAC9D,CAAC","sourcesContent":["import type { AgentViewBinding, AnyAgentView, WritableField } from \"@parlor/agent-ui\";\nimport { agentFieldsOf, type AnyViewBinding } from \"@parlor/agent-ui/client\";\nimport { useEffect, useInsertionEffect, useState, useSyncExternalStore } from \"react\";\nimport { flushSync } from \"react-dom\";\n\nimport { useFramework } from \"../provider.js\";\n\nexport interface AgentViewHandle<D extends AnyAgentView = AnyAgentView> {\n  readonly ref: (element: Element | null) => void;\n  /**\n   * Fields the agent wrote that still hold what it wrote, for the app to style; the user\n   * changing a field removes it. Always empty for a read-only view.\n   */\n  readonly agentFields: ReadonlySet<WritableField<D>>;\n}\n\nfunction committing(binding: AgentViewBinding<AnyAgentView>): AnyViewBinding {\n  const { set } = binding;\n  if (!set) return binding;\n  return {\n    key: binding.key,\n    get: binding.get,\n    set: (next, changed) => flushSync(() => set(next, changed)),\n  };\n}\n\nexport function useAgentView<D extends AnyAgentView>(\n  view: D,\n  binding: AgentViewBinding<D>,\n): AgentViewHandle<D> {\n  const { agentUi } = useFramework();\n  const erased = committing(binding as unknown as AgentViewBinding<AnyAgentView>);\n  const [slot] = useState(() => agentUi.views.track(view, erased));\n  useInsertionEffect(() => slot.bind(erased));\n  useEffect(() => slot.mount(binding.key), [slot, binding.key]);\n  const writes = useSyncExternalStore(slot.subscribeWrites, slot.writes, slot.writes);\n  const agentFields = agentFieldsOf(writes, writes.size === 0 ? {} : binding.get());\n  return { ref: slot.ref, agentFields } as AgentViewHandle<D>;\n}\n"]}

package/dist/react/chat/ask-fields.d.ts

@@ -0,0 +1,13 @@
+export interface AskField {
+    readonly name: string;
+    readonly label: string;
+    readonly type: "number" | "checkbox" | "text";
+    readonly integer: boolean;
+    readonly required: boolean;
+}
+export type AskValues = Record<string, string | number | boolean>;
+/** One field per property of a form ask's JSON Schema object, in schema order. */
+export declare function askFields(form: Readonly<Record<string, unknown>>): AskField[];
+/** What a filled form answers: numbers as numbers, checkboxes as booleans, blanks left out. */
+export declare function askValues(fields: readonly AskField[], form: HTMLFormElement): AskValues;
+//# sourceMappingURL=ask-fields.d.ts.map

package/dist/react/chat/ask-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-fields.d.ts","sourceRoot":"","sources":["../../../src/react/chat/ask-fields.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAkBlE,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,QAAQ,EAAE,CAY7E;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,GAAG,SAAS,CAWvF"}

package/dist/react/chat/ask-fields.js

@@ -0,0 +1,46 @@
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function typeOf(schema) {
+    switch (schema.type) {
+        case "integer":
+            return { type: "number", integer: true };
+        case "number":
+            return { type: "number", integer: false };
+        case "boolean":
+            return { type: "checkbox", integer: false };
+        default:
+            return { type: "text", integer: false };
+    }
+}
+/** One field per property of a form ask's JSON Schema object, in schema order. */
+export function askFields(form) {
+    const properties = isRecord(form.properties) ? form.properties : {};
+    const required = Array.isArray(form.required) ? form.required : [];
+    return Object.entries(properties).map(([name, property]) => {
+        const schema = isRecord(property) ? property : {};
+        return {
+            name,
+            label: typeof schema.title === "string" ? schema.title : name,
+            required: required.includes(name),
+            ...typeOf(schema),
+        };
+    });
+}
+/** What a filled form answers: numbers as numbers, checkboxes as booleans, blanks left out. */
+export function askValues(fields, form) {
+    const values = {};
+    for (const field of fields) {
+        const input = form.elements.namedItem(field.name);
+        if (!(input instanceof HTMLInputElement))
+            continue;
+        if (field.type === "checkbox")
+            values[field.name] = input.checked;
+        else if (input.value === "")
+            continue;
+        else if (field.type === "number")
+            values[field.name] = Number(input.value);
+        else
+            values[field.name] = input.value;
+    }
+    return values;
+}
+//# sourceMappingURL=ask-fields.js.map

package/dist/react/chat/ask-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-fields.js","sourceRoot":"","sources":["../../../src/react/chat/ask-fields.ts"],"names":[],"mappings":"AAUA,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,SAAS,MAAM,CAAC,MAA+B;IAC7C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3C,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5C,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9C;YACE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,IAAuC;IAC/D,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE;QACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO;YACL,IAAI;YACJ,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YAC7D,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjC,GAAG,MAAM,CAAC,MAAM,CAAC;SAClB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,SAAS,CAAC,MAA2B,EAAE,IAAqB;IAC1E,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,CAAC,KAAK,YAAY,gBAAgB,CAAC;YAAE,SAAS;QACnD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;aAC7D,IAAI,KAAK,CAAC,KAAK,KAAK,EAAE;YAAE,SAAS;aACjC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;;YACtE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["export interface AskField {\n  readonly name: string;\n  readonly label: string;\n  readonly type: \"number\" | \"checkbox\" | \"text\";\n  readonly integer: boolean;\n  readonly required: boolean;\n}\n\nexport type AskValues = Record<string, string | number | boolean>;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nfunction typeOf(schema: Record<string, unknown>): Pick<AskField, \"type\" | \"integer\"> {\n  switch (schema.type) {\n    case \"integer\":\n      return { type: \"number\", integer: true };\n    case \"number\":\n      return { type: \"number\", integer: false };\n    case \"boolean\":\n      return { type: \"checkbox\", integer: false };\n    default:\n      return { type: \"text\", integer: false };\n  }\n}\n\n/** One field per property of a form ask's JSON Schema object, in schema order. */\nexport function askFields(form: Readonly<Record<string, unknown>>): AskField[] {\n  const properties = isRecord(form.properties) ? form.properties : {};\n  const required = Array.isArray(form.required) ? form.required : [];\n  return Object.entries(properties).map(([name, property]) => {\n    const schema = isRecord(property) ? property : {};\n    return {\n      name,\n      label: typeof schema.title === \"string\" ? schema.title : name,\n      required: required.includes(name),\n      ...typeOf(schema),\n    };\n  });\n}\n\n/** What a filled form answers: numbers as numbers, checkboxes as booleans, blanks left out. */\nexport function askValues(fields: readonly AskField[], form: HTMLFormElement): AskValues {\n  const values: AskValues = {};\n  for (const field of fields) {\n    const input = form.elements.namedItem(field.name);\n    if (!(input instanceof HTMLInputElement)) continue;\n    if (field.type === \"checkbox\") values[field.name] = input.checked;\n    else if (input.value === \"\") continue;\n    else if (field.type === \"number\") values[field.name] = Number(input.value);\n    else values[field.name] = input.value;\n  }\n  return values;\n}\n"]}

package/dist/react/chat/chat-ask.d.ts

@@ -0,0 +1,32 @@
+import type { AgentConfirmation } from "@parlor/agent-ui/client";
+import type { ChatItem } from "@parlor/chat";
+import { type ComponentProps, type ReactNode } from "react";
+type AskItem = Extract<ChatItem<AgentConfirmation>, {
+    kind: "ask";
+}>;
+export interface ChatAskProps extends ComponentProps<"div"> {
+    readonly item: AskItem;
+}
+/**
+ * The agent's own permission prompt or question: `role="group"` named by its question.
+ * `data-approval` is `presence` (answering triggers the OS prompt) or `computer` (answered
+ * on the computer; choices disabled). `data-state` is `open`, `answered` or `closed`.
+ * Escape declines.
+ */
+export declare function Ask({ item, onKeyDown, ...props }: ChatAskProps): ReactNode;
+export interface ChatAskChoiceProps extends ComponentProps<"button"> {
+    readonly choice: AskItem["choices"][number];
+}
+/** `type="button"`; answers the enclosing ask with this choice. */
+export declare function AskChoice({ choice, onClick, ...props }: ChatAskChoiceProps): ReactNode;
+export type ChatAskFormProps = ComponentProps<"form">;
+/**
+ * A form ask's `<form>`: one `<input name="{property}">` per property of its schema (`number`
+ * for numbers and integers, `checkbox` for booleans, text otherwise). Submitting answers the
+ * ask with its allow choice and the values typed per the schema. Its children, a submit
+ * button for one, go after the inputs. Everything is disabled once the ask is not open or
+ * is answered on the computer. Renders nothing for an ask without a form.
+ */
+export declare function AskForm({ onSubmit, children, ...props }: ChatAskFormProps): ReactNode;
+export {};
+//# sourceMappingURL=chat-ask.d.ts.map

package/dist/react/chat/chat-ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-ask.d.ts","sourceRoot":"","sources":["../../../src/react/chat/chat-ask.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAKf,KAAK,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAOrE,MAAM,WAAW,YAAa,SAAQ,cAAc,CAAC,KAAK,CAAC;IACzD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG,SAAS,CAyB1E;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,GAAG,SAAS,CAmBtF;AAID,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,GAAG,SAAS,CA2BrF"}