@parlor/client 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cychien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @parlor/client
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The browser side of a Parlor app: the action client, and React hooks that read and write through actions and refresh when anyone, including an agent, changes the data.
+
+```sh
+pnpm add @parlor/client @tanstack/react-query @tanstack/react-router react react-dom
+```
+
+```tsx
+import { createActionClient } from "@parlor/client";
+import { useActionQuery } from "@parlor/client/react";
+
+export const client = createActionClient();
+
+export function Health() {
+  const status = useActionQuery("health" as never, {} as never);
+  return <p>{status.isSuccess ? "up" : "..."}</p>;
+}
+```
+
+In an app, register the actions once in `src/parlor.d.ts` so names and inputs are typed. Docs: https://cychien.github.io/parlor/guides/pages-and-hooks/

package/dist/action-client.d.ts

@@ -0,0 +1,40 @@
+import { ActionError, type ActionInput, type ActionMap, type ActionOutput, type Tag } from "@parlor/core";
+export declare function generateClientId(): string;
+export type HeadersProvider = HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+export interface ActionClientOptions {
+    readonly baseUrl?: string | undefined;
+    readonly basePath?: string | undefined;
+    readonly fetch?: typeof fetch | undefined;
+    readonly headers?: HeadersProvider | undefined;
+    readonly clientId?: string | undefined;
+}
+export interface CallOptions {
+    readonly signal?: AbortSignal | undefined;
+}
+export interface ActionEnvelope<T> {
+    readonly data: T;
+    readonly tags: readonly Tag[];
+}
+export interface ActionClient<T extends ActionMap> {
+    readonly clientId: string;
+    readonly basePath: string;
+    call<K extends keyof T & string>(name: K, input: ActionInput<T[K]>, options?: CallOptions): Promise<ActionOutput<T[K]>>;
+    invoke<K extends keyof T & string>(name: K, input: ActionInput<T[K]>, options?: CallOptions): Promise<ActionEnvelope<ActionOutput<T[K]>>>;
+    request(path: string, init?: RequestInit): Promise<Response>;
+}
+export declare function toActionError(response: Response, options?: {
+    readonly missingIsNotFound?: boolean;
+}): Promise<ActionError>;
+export declare function invokeAt<T extends ActionMap, K extends keyof T & string>(request: ActionClient<ActionMap>["request"], path: string, input: ActionInput<T[K]>, options?: CallOptions & {
+    readonly missingIsNotFound?: boolean;
+}): Promise<ActionEnvelope<ActionOutput<T[K]>>>;
+export declare function resolveServerOrigin(): string;
+/**
+ * The one name of this app's backend on every surface: the page's own origin when it is
+ * served over http(s) and is not a shell's webview origin, else the shell's `server.url`.
+ * `parlor dev` running several targets names the web target's origin for all of them.
+ * Statements are signed for it and the host is paired with it.
+ */
+export declare function appOrigin(serverUrl?: string, injected?: string): string;
+export declare function createActionClient<T extends ActionMap>(options?: ActionClientOptions): ActionClient<T>;
+//# sourceMappingURL=action-client.d.ts.map

package/dist/action-client.d.ts.map

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

package/dist/action-client.js

@@ -0,0 +1,83 @@
+import { ActionError, SHELL_ORIGINS, } from "@parlor/core";
+const DEFAULT_BASE_PATH = "/_parlor";
+const SOURCE_HEADER = "x-parlor-source";
+const CLIENT_HEADER = "x-parlor-client";
+function injectedServerUrl() {
+    const env = import.meta.env;
+    return env?.PARLOR_SERVER_URL ?? "";
+}
+export function generateClientId() {
+    return globalThis.crypto?.randomUUID?.() ?? Math.random().toString(36).slice(2);
+}
+async function resolveHeaders(provider, clientId, extra) {
+    const headers = new Headers(typeof provider === "function" ? await provider() : provider);
+    new Headers(extra).forEach((value, key) => headers.set(key, value));
+    headers.set(SOURCE_HEADER, "ui");
+    headers.set(CLIENT_HEADER, clientId);
+    return headers;
+}
+export async function toActionError(response, options = {}) {
+    const body = await response.json().catch(() => undefined);
+    if (ActionError.isBody(body))
+        return ActionError.fromBody(body);
+    const code = options.missingIsNotFound && response.status === 404 ? "not_found" : "internal";
+    return new ActionError(code, `Action request failed with HTTP ${response.status}`);
+}
+export async function invokeAt(request, path, input, options = {}) {
+    const response = await request(path, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(input ?? {}),
+        signal: options.signal ?? null,
+    });
+    if (!response.ok) {
+        throw await toActionError(response, options.missingIsNotFound ? { missingIsNotFound: true } : {});
+    }
+    const body = (await response.json());
+    return { data: body.data, tags: body.tags ?? [] };
+}
+export function resolveServerOrigin() {
+    return injectedServerUrl() || globalThis.location?.origin || "";
+}
+function injectedAppOrigin() {
+    const env = import.meta.env;
+    return env?.PARLOR_APP_ORIGIN ?? "";
+}
+/**
+ * The one name of this app's backend on every surface: the page's own origin when it is
+ * served over http(s) and is not a shell's webview origin, else the shell's `server.url`.
+ * `parlor dev` running several targets names the web target's origin for all of them.
+ * Statements are signed for it and the host is paired with it.
+ */
+export function appOrigin(serverUrl = resolveServerOrigin(), injected = injectedAppOrigin()) {
+    if (injected)
+        return new URL(injected).origin;
+    const page = globalThis.location?.origin ?? "";
+    if (/^https?:\/\//.test(page) && !SHELL_ORIGINS.includes(page))
+        return page;
+    try {
+        return new URL(serverUrl).origin;
+    }
+    catch {
+        return serverUrl;
+    }
+}
+export function createActionClient(options = {}) {
+    const { baseUrl = injectedServerUrl(), basePath = DEFAULT_BASE_PATH, headers, clientId = generateClientId(), } = options;
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    const request = async (path, init = {}) => fetchImpl(`${baseUrl}${path}`, {
+        ...init,
+        headers: await resolveHeaders(headers, clientId, init.headers),
+    });
+    const invoke = async (name, input, callOptions = {}) => {
+        return invokeAt(request, `${basePath}/actions/${name}`, input, callOptions);
+    };
+    return {
+        clientId,
+        basePath,
+        request,
+        invoke,
+        call: async (name, input, callOptions) => (await invoke(name, input, callOptions)).data,
+    };
+}
+//# sourceMappingURL=action-client.js.map

package/dist/action-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { type ActionClient, appOrigin, type ActionClientOptions, type ActionEnvelope, type CallOptions, createActionClient, generateClientId, type HeadersProvider, } from "./action-client.js";
+export { type AgentViewBinding, type AgentViewDefinition, type AnyAgentView, defineAgentView, type WritableField, } from "@parlor/agent-ui";
+export { ACTION_QUERY_PREFIX, actionQueryKey } from "./query-keys.js";
+export { createPluginClient, type PluginClient } from "./plugin-client.js";
+export type { AccountDevice, DeviceLinker, DeviceSource, FrameworkAuth, HostAuthorizer, PendingLink, SessionDevice, SessionSnapshot, SessionSource, SessionUser, } from "./session.js";
+export { LinkOnComputer } from "./session.js";
+export type { Register, RegisteredActions } from "./register.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,YAAY,EACjB,SAAS,EACT,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { appOrigin, createActionClient, generateClientId, } from "./action-client.js";
+export { defineAgentView, } from "@parlor/agent-ui";
+export { ACTION_QUERY_PREFIX, actionQueryKey } from "./query-keys.js";
+export { createPluginClient } from "./plugin-client.js";
+export { LinkOnComputer } from "./session.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,EAEL,SAAS,EAIT,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,eAAe,GAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,oBAAoB,CAAC;AAa3E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/plugin-client.d.ts

@@ -0,0 +1,11 @@
+import type { ActionMap } from "@parlor/core";
+import { type ActionClient } from "./action-client.js";
+/** A plugin's actions at `/_parlor/<plugin>/actions/<name>`, typed by its registry. */
+export type PluginClient<T extends ActionMap> = Pick<ActionClient<T>, "call" | "invoke">;
+/**
+ * Reuses the app client's base URL, headers provider (the session) and client id, so a
+ * plugin's actions travel exactly like the app's. A server without the plugin answers
+ * `not_found`.
+ */
+export declare function createPluginClient<T extends ActionMap>(client: Pick<ActionClient<ActionMap>, "basePath" | "clientId" | "request">, plugin: string): PluginClient<T>;
+//# sourceMappingURL=plugin-client.d.ts.map

package/dist/plugin-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-client.d.ts","sourceRoot":"","sources":["../src/plugin-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,oBAAoB,CAAC;AAEjE,uFAAuF;AACvF,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;AAEzF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,EACpD,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC,EAC1E,MAAM,EAAE,MAAM,GACb,YAAY,CAAC,CAAC,CAAC,CAYjB"}

package/dist/plugin-client.js

@@ -0,0 +1,14 @@
+import { invokeAt } from "./action-client.js";
+/**
+ * Reuses the app client's base URL, headers provider (the session) and client id, so a
+ * plugin's actions travel exactly like the app's. A server without the plugin answers
+ * `not_found`.
+ */
+export function createPluginClient(client, plugin) {
+    const invoke = (name, input, options) => invokeAt(client.request, `${client.basePath}/${plugin}/actions/${name}`, input, { ...options, missingIsNotFound: true });
+    return {
+        invoke,
+        call: async (name, input, options) => (await invoke(name, input, options)).data,
+    };
+}
+//# sourceMappingURL=plugin-client.js.map

package/dist/plugin-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-client.js","sourceRoot":"","sources":["../src/plugin-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAKjE;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA0E,EAC1E,MAAc;IAEd,MAAM,MAAM,GAA8B,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CACjE,QAAQ,CACN,MAAM,CAAC,OAAO,EACd,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,YAAY,IAAI,EAAE,EAC9C,KAAK,EACL,EAAE,GAAG,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,CACxC,CAAC;IACJ,OAAO;QACL,MAAM;QACN,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI;KAChF,CAAC;AACJ,CAAC"}

package/dist/query-keys.d.ts

@@ -0,0 +1,3 @@
+export declare const ACTION_QUERY_PREFIX: readonly ["_parlor", "action"];
+export declare function actionQueryKey(name: string, input: unknown): readonly ["_parlor", "action", string, {}];
+//# sourceMappingURL=query-keys.d.ts.map

package/dist/query-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../src/query-keys.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,YAAI,SAAS,EAAE,QAAQ,CAAU,CAAC;AAElE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,8CAE1D"}

package/dist/query-keys.js

@@ -0,0 +1,5 @@
+export const ACTION_QUERY_PREFIX = ["_parlor", "action"];
+export function actionQueryKey(name, input) {
+    return [...ACTION_QUERY_PREFIX, name, input ?? {}];
+}
+//# sourceMappingURL=query-keys.js.map

package/dist/query-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-keys.js","sourceRoot":"","sources":["../src/query-keys.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAElE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAc;IACzD,OAAO,CAAC,GAAG,mBAAmB,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAU,CAAC;AAC9D,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { AgentOrigin, UiErrorCode } from "@parlor/agent-ui";
+import type { AgentActivity, AgentActivityKind } from "@parlor/agent-ui/client";
+export type AgentActivityState = {
+    readonly status: "idle";
+} | {
+    readonly status: "busy";
+    readonly op: AgentActivityKind;
+    readonly origin: AgentOrigin;
+} | {
+    readonly status: "done";
+    readonly op: AgentActivityKind;
+    readonly origin: AgentOrigin;
+} | {
+    readonly status: "refused";
+    readonly op: AgentActivityKind;
+    readonly origin: AgentOrigin;
+    readonly code: UiErrorCode;
+};
+export declare function deriveActivityState({ busy, last }: AgentActivity, faded: AgentActivity["last"]): AgentActivityState;
+//# sourceMappingURL=activity-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity-state.d.ts","sourceRoot":"","sources":["../../../src/react/agent-ui/activity-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3B;IACE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B,CAAC;AAEN,wBAAgB,mBAAmB,CACjC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,aAAa,EAC7B,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,kBAAkB,CASpB"}

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

@@ -0,0 +1,14 @@
+export function deriveActivityState({ busy, last }, faded) {
+    if (!last)
+        return { status: "idle" };
+    const { op, origin, outcome } = last;
+    if (busy)
+        return { status: "busy", op, origin };
+    if (last === faded)
+        return { status: "idle" };
+    if (outcome?.status === "refused") {
+        return { status: "refused", op, origin, code: outcome.code };
+    }
+    return { status: "done", op, origin };
+}
+//# sourceMappingURL=activity-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity-state.js","sourceRoot":"","sources":["../../../src/react/agent-ui/activity-state.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,mBAAmB,CACjC,EAAE,IAAI,EAAE,IAAI,EAAiB,EAC7B,KAA4B;IAE5B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACrC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACrC,IAAI,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAChD,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC9C,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type ComponentProps, type ReactNode } from "react";
+import { type AgentActivityState } from "./activity-state.js";
+export interface ChatActivityProps extends Omit<ComponentProps<"span">, "children"> {
+    /** Milliseconds a finished event stays `done` or `refused` before it reads `idle`. */
+    readonly linger?: number;
+    readonly children: (state: AgentActivityState) => ReactNode;
+}
+/**
+ * A polite live region that says what an agent is doing on this screen. The app writes the
+ * words; style it through `[data-state]` and `[data-op]`.
+ */
+export declare function Activity({ linger, children, ...props }: ChatActivityProps): import("react").JSX.Element;
+//# sourceMappingURL=chat-activity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-activity.d.ts","sourceRoot":"","sources":["../../../src/react/agent-ui/chat-activity.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAEjF,OAAO,EAAE,KAAK,kBAAkB,EAAuB,MAAM,qBAAqB,CAAC;AAiBnF,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IACjF,sFAAsF;IACtF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC;CAC7D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EACvB,MAA0B,EAC1B,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,iBAAiB,+BAanB"}

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

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { deriveActivityState } from "./activity-state.js";
+import { useAgentActivity } from "./use-agent-activity.js";
+const DEFAULT_LINGER_MS = 2000;
+function useActivityState(lingerMs) {
+    const activity = useAgentActivity();
+    const [faded, setFaded] = useState();
+    const { busy, last } = activity;
+    useEffect(() => {
+        if (busy || !last)
+            return;
+        const timer = setTimeout(() => setFaded(last), lingerMs);
+        return () => clearTimeout(timer);
+    }, [busy, last, lingerMs]);
+    return deriveActivityState(activity, faded);
+}
+/**
+ * A polite live region that says what an agent is doing on this screen. The app writes the
+ * words; style it through `[data-state]` and `[data-op]`.
+ */
+export function Activity({ linger = DEFAULT_LINGER_MS, children, ...props }) {
+    const state = useActivityState(linger);
+    return (_jsx("span", { role: "status", "aria-live": "polite", ...props, "data-state": state.status, "data-op": state.status === "idle" ? undefined : state.op, children: children(state) }));
+}
+//# sourceMappingURL=chat-activity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-activity.js","sourceRoot":"","sources":["../../../src/react/agent-ui/chat-activity.tsx"],"names":[],"mappings":";AACA,OAAO,EAAuC,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjF,OAAO,EAA2B,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,SAAS,gBAAgB,CAAC,QAAgB;IACxC,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,EAAyB,CAAC;IAC5D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO;QAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzD,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3B,OAAO,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,MAAM,GAAG,iBAAiB,EAC1B,QAAQ,EACR,GAAG,KAAK,EACU;IAClB,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CACL,eACE,IAAI,EAAC,QAAQ,eACH,QAAQ,KACd,KAAK,gBACG,KAAK,CAAC,MAAM,aACf,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,YAEtD,QAAQ,CAAC,KAAK,CAAC,GACX,CACR,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { AgentConfirmation } from "@parlor/agent-ui/client";
+import { type ComponentProps, type ReactNode } from "react";
+export interface ChatConfirmationsProps extends Omit<ComponentProps<"div">, "children"> {
+    /** Shown while no agent request waits. */
+    readonly empty?: ReactNode;
+    readonly children: (confirmation: AgentConfirmation) => ReactNode;
+}
+/**
+ * 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 declare function Confirmations({ empty, children, ref, ...props }: ChatConfirmationsProps): import("react").JSX.Element;
+export interface ChatConfirmProps extends ComponentProps<"div"> {
+    readonly confirmation: AgentConfirmation;
+}
+/**
+ * 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 declare function Confirm({ confirmation, onKeyDown, ref, ...props }: ChatConfirmProps): import("react").JSX.Element;
+export declare function ConfirmLabel(props: Omit<ComponentProps<"p">, "id">): import("react").JSX.Element;
+export declare function Approve({ onClick, ...props }: ComponentProps<"button">): import("react").JSX.Element;
+export declare function Decline({ onClick, ...props }: ComponentProps<"button">): import("react").JSX.Element;
+//# sourceMappingURL=chat-confirm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-confirm.d.ts","sourceRoot":"","sources":["../../../src/react/agent-ui/chat-confirm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,KAAK,cAAc,EAInB,KAAK,SAAS,EAQf,MAAM,OAAO,CAAC;AAkCf,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACrF,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,iBAAiB,KAAK,SAAS,CAAC;CACnE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,GAAG,EACH,GAAG,KAAK,EACT,EAAE,sBAAsB,+BAoExB;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc,CAAC,KAAK,CAAC;IAC7D,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,+BA6CnF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,+BAGlE;AAED,wBAAgB,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,+BAYtE;AAED,wBAAgB,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,+BAYtE"}

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

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

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