@parlor/client 0.0.0-stage → 0.2.0

package/dist/react/chat/runtime.d.ts

@@ -0,0 +1,167 @@
+import type { AgentConfirmation, AgentUiClient } from "@parlor/agent-ui/client";
+import type { CapabilityHandle, LocalAgentHost } from "@parlor/capabilities";
+import { type ChatItem, type HostSummary, type ThreadSummary } from "@parlor/chat";
+import type { ChatUserActionMap } from "@parlor/chat/server";
+import { type Tag } from "@parlor/core";
+import type { ClientChannel } from "@parlor/sync";
+import type { PluginClient } from "../../plugin-client.js";
+import type { DeviceLinker, DeviceSource, HostAuthorizer } from "../../session.js";
+/** One agent the user can talk to; `key` is `<hostId>/<agentId>`. */
+export interface AgentChoice {
+    readonly key: string;
+    readonly name: string;
+    readonly hostName: string;
+    readonly online: boolean;
+    readonly ready: boolean;
+    readonly problem: string | undefined;
+}
+/** How this client adds a computer, decided by the `localAgentHost` capability. */
+export type ConnectOption = {
+    readonly kind: "command";
+    readonly command: string;
+} | {
+    readonly kind: "here";
+    start(): Promise<void>;
+};
+/**
+ * `waiting`: a prompt waits for a computer, which `ChatState.wait` names: one that must
+ * still approve this device, or one that is offline while the prompt queues.
+ * `unavailable`: this backend has no chat, this user may not use it, or the first read
+ * failed and is being retried; `ChatState.unavailable` says which.
+ */
+export type ChatStatus = "loading" | "idle" | "sending" | "waiting" | "running" | "unavailable";
+/**
+ * Why chat is `unavailable`: `forbidden` when the app's chat `access` refuses this user,
+ * so the agent should not show at all; `not_found` when the server has no chat;
+ * `unauthenticated` when nobody is signed in; `error` while a failed read is retried.
+ */
+export interface ChatUnavailable {
+    readonly reason: "forbidden" | "not_found" | "unauthenticated" | "error";
+}
+export interface ChatWait {
+    readonly reason: "offline" | "approval";
+    readonly hostId: string;
+    readonly hostName: string;
+}
+/**
+ * Whether this device may send: `linked` (or nothing to link), `checking` until it knows, or
+ * `unlinked` with the code it shows once `startLink` made one. A device links once, from a
+ * device already linked or from the computer.
+ */
+export type LinkState = {
+    readonly status: "linked" | "checking";
+} | {
+    readonly status: "unlinked";
+    readonly hostName: string;
+    readonly code?: string | undefined;
+    /** What a linked phone's camera opens to link this device: `<app>/link#d=…&c=…`. */
+    readonly qr?: string | undefined;
+    /** What to run on the computer to link this device there instead, while `code` is shown. */
+    readonly command?: string | undefined;
+    readonly expiresAt?: string | undefined;
+    /** The code shown last ran out; `startLink` shows a new one. */
+    readonly expired: boolean;
+    /** No other device is linked yet to link this one, so only the computer can, with `command`. */
+    readonly onlyComputer: boolean;
+    readonly busy: boolean;
+    readonly error?: string | undefined;
+};
+/**
+ * Set while an action waits for this device to be set up: on a browser, the first prompt
+ * would otherwise open a passkey prompt with no warning. `explain` until the user picks,
+ * `passkey` while the browser asks, `cancelled` once they dismissed it.
+ */
+export interface DeviceSetup {
+    readonly step: "explain" | "passkey" | "cancelled";
+}
+export interface ChatState {
+    readonly status: ChatStatus;
+    /** Set exactly while `status` is `waiting`; approval wins when both reasons hold. */
+    readonly wait: ChatWait | undefined;
+    /** Set exactly while `status` is `unavailable`. */
+    readonly unavailable: ChatUnavailable | undefined;
+    readonly thread: ThreadSummary | undefined;
+    readonly threads: readonly ThreadSummary[];
+    /** Older threads exist past `threads`; `loadMoreThreads` reads them. */
+    readonly moreThreads: boolean;
+    readonly items: readonly ChatItem<AgentConfirmation>[];
+    /** The thread has items before the first one shown; `loadOlder` reads them. */
+    readonly hasOlder: boolean;
+    /** Set while `loadOlder` or `loadMoreThreads` reads. */
+    readonly loadingOlder: boolean;
+    readonly hosts: readonly HostSummary[];
+    readonly agents: readonly AgentChoice[];
+    readonly agent: AgentChoice | undefined;
+    readonly connect: ConnectOption;
+    readonly draft: string;
+    /** Why the last send, stop or answer failed; cleared by the next one that succeeds. */
+    readonly error: string | undefined;
+    readonly setup: DeviceSetup | undefined;
+    readonly link: LinkState;
+    /**
+     * The chosen agent's computer wants this device to confirm it is the user again, so
+     * sending asks for Face ID or Touch ID first.
+     */
+    readonly presenceDue: boolean;
+}
+export interface ChatCommands {
+    setDraft(text: string): void;
+    /** Signs the draft (or `text`) and sends it to the chosen agent; idempotent per call. */
+    send(text?: string): Promise<void>;
+    stop(): Promise<void>;
+    /** Sends a prompt again as a new turn in its thread, signed anew. */
+    resend(promptItemId: string): Promise<void>;
+    /** Reads the thread's next earlier page while `hasOlder`. */
+    loadOlder(): Promise<void>;
+    /** Reads the next older threads while `moreThreads`. */
+    loadMoreThreads(): Promise<void>;
+    /** A `presence` ask triggers the OS prompt first; a `computer` ask refuses. */
+    answer(askId: string, choice: string, values?: Readonly<Record<string, string | number | boolean>>): Promise<void>;
+    choose(agentKey: string): void;
+    /** `undefined` opens the most recent thread, if there is one. */
+    openThread(threadId: string | undefined): void;
+    /** Starts a blank thread; it exists on the server once the first prompt is sent. */
+    newThread(): void;
+    /** Shows this device's link code, after Face ID or Touch ID unless `presence` is false. */
+    startLink(options?: {
+        readonly presence?: boolean;
+    }): Promise<void>;
+}
+export interface DeviceSetupCommands {
+    /** Sets this device up, with a passkey or without one, then runs what waited for it. */
+    setUpDevice(options: {
+        readonly passkey: boolean;
+    }): Promise<void>;
+    /** Drops what waited for the setup; the draft stays. */
+    dismissSetup(): void;
+}
+export interface ChatRuntime extends ChatCommands, DeviceSetupCommands {
+    subscribe(listener: () => void): () => void;
+    get(): ChatState;
+    start(): () => void;
+    /**
+     * Called by a UI that explains the device setup, until it unmounts. Without one, the first
+     * prompt enrolls the device directly, as before.
+     */
+    explainSetup(): () => void;
+}
+export interface ChatRuntimeDeps {
+    readonly calls: PluginClient<ChatUserActionMap>;
+    readonly clientId: string;
+    readonly appOrigin: string;
+    readonly agentUi: AgentUiClient;
+    readonly addChannel: (channel: ClientChannel) => () => void;
+    readonly onSyncTags: (listener: (tags: readonly Tag[]) => void) => () => void;
+    readonly onResume: (listener: () => void) => () => void;
+    /** What the server negotiated for sync; `undefined` until it has. */
+    readonly transport: () => "sse" | "poll" | undefined;
+    readonly onNegotiated: (listener: (transport: "sse" | "poll") => void) => () => void;
+    readonly isHidden?: (() => boolean) | undefined;
+    readonly auth: Partial<DeviceSource & HostAuthorizer & DeviceLinker> | undefined;
+    readonly localHost: Promise<CapabilityHandle<LocalAgentHost>>;
+    readonly threadId: string | undefined;
+}
+export declare const HOST_GRANTS_TAG = "parlor_auth_hosts";
+export declare const DEVICES_TAG = "parlor_auth_devices";
+export declare function createChatRuntime(deps: ChatRuntimeDeps): ChatRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/react/chat/runtime.d.ts.map

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