@alexkroman1/aai-ui 13.2.0 → 13.3.0

package/dist/internal.js

@@ -1,8 +1,8 @@
-import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-BT_kWID5.js";
+import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-DD820zHn.js";
 import { SessionProvider, ThemeProvider } from "./context.js";
-import { n as SessionUrlChips, r as UiUrlChip, t as ApiUrlChip } from "./url-chips-YqhCjWfQ.js";
-import { t as TRANSCRIBING_PLACEHOLDER } from "./use-user-transcript-C14qWFu2.js";
-import { t as ToolConfigContext } from "./tool-config-context-DzAofqi_.js";
-import { i as MAX_MISSING_READS, r as DEFAULT_WORKFLOW_POLL_MS, t as DEFAULT_PROGRESS_POLL_MS } from "./use-workflow-progress-Cu0SxMyg.js";
+import { n as SessionUrlChips, r as UiUrlChip, t as ApiUrlChip } from "./url-chips-C2u7QPv8.js";
+import { t as TRANSCRIBING_PLACEHOLDER } from "./use-user-transcript-DFTSEuZN.js";
+import { t as ToolConfigContext } from "./tool-config-context-Bh8p3DtG.js";
+import { i as DEFAULT_PROGRESS_POLL_MS, n as MAX_MISSING_READS, t as DEFAULT_WORKFLOW_POLL_MS } from "./use-workflow-run-CXGEcM0l.js";
 import { VOICE_CAPTURE_CONSTRAINTS } from "./types.js";
 export { ApiUrlChip, DEFAULT_PROGRESS_POLL_MS, DEFAULT_WORKFLOW_POLL_MS, MAX_MISSING_READS, SessionProvider, SessionUrlChips, TRANSCRIBING_PLACEHOLDER, ThemeProvider, ToolConfigContext, UiUrlChip, VOICE_CAPTURE_CONSTRAINTS, buildAgentUrl, loadClientConfig };

package/dist/{message-list-BJYyuIcR.js → message-list-C0pL7x41.js}

@@ -1,14 +1,14 @@
 import { useSessionSelector, useTheme } from "./context.js";
-import { i as primaryTint, r as inkTint } from "./_colors-j8XMToi9.js";
-import { n as useUserTranscript } from "./use-user-transcript-C14qWFu2.js";
-import { t as ToolCallBlock } from "./tool-call-block-tcPQAkcP.js";
+import { i as primaryTint, r as inkTint } from "./_colors-CZ6OlPbL.js";
+import { n as useUserTranscript } from "./use-user-transcript-DFTSEuZN.js";
+import { t as ToolCallBlock } from "./tool-call-block-Bunc6rCw.js";
 import clsx from "clsx";
 import { StickToBottom } from "use-stick-to-bottom";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { memo, useMemo } from "react";
 import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
-//#region components/auto-scroll.tsx
+//#region src/components/auto-scroll.tsx
 /** @jsxImportSource react */
 /**
 * A scroll container that stays pinned to the bottom as its content grows,
@@ -66,7 +66,7 @@ function AutoScroll({ children, className, contentClassName, scrollClassName = "
 	});
 }
 //#endregion
-//#region use-conversation.ts
+//#region src/use-conversation.ts
 /**
 * `useConversation` — the exchange, already assembled, with nothing rendered.
 *
@@ -191,7 +191,7 @@ function useConversation() {
 	};
 }
 //#endregion
-//#region components/markdown.tsx
+//#region src/components/markdown.tsx
 /** @jsxImportSource react */
 const BARE_ORDERED_MARKER = /^(\s*)(\d{1,9})([.)])\s*$/;
 const BARE_BULLET_MARKER = /^(\s*)([-*+])\s*$/;
@@ -377,7 +377,7 @@ const Markdown = memo(function Markdown({ text, variant = "default" }) {
 	});
 });
 //#endregion
-//#region components/message-list.tsx
+//#region src/components/message-list.tsx
 /** @jsxImportSource react */
 const DOT_STYLES = [
 	0,

package/dist/{session-core-DxBYsfHA.js → session-core-C9elBIdu.js}

@@ -1,4 +1,4 @@
-import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-BT_kWID5.js";
+import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-DD820zHn.js";
 import { MIC_SEND_MAX_BUFFERED_BYTES } from "./types.js";
 import { SessionEventSchema, lenientParse } from "@alexkroman1/aai/protocol";
 import { errorMessage, safeJsonParse } from "@alexkroman1/aai";
@@ -6,7 +6,7 @@ import { omitUndefined } from "@alexkroman1/aai/utils";
 import { DEFAULT_MAX_HISTORY, WS_OPEN, createEpoch, toArgsRecord } from "@alexkroman1/aai/internal";
 import ReconnectingWebSocket from "partysocket/ws";
 import { and, assign, createActor, not, setup, stateIn } from "xstate";
-//#region session-core-audio-setup.ts
+//#region src/session-core-audio-setup.ts
 /**
 * Audio-path initialization for the voice session core.
 *
@@ -119,7 +119,7 @@ async function initAudioCapture(conn, msg, deps) {
 	}
 }
 //#endregion
-//#region session-core-close.ts
+//#region src/session-core-close.ts
 /**
 * What a socket's CLOSE means to the caller.
 *
@@ -160,7 +160,7 @@ function closeFailure(event, socketErrored) {
 	return socketErrored ? "WebSocket connection error" : null;
 }
 //#endregion
-//#region session-core-reconnect.ts
+//#region src/session-core-reconnect.ts
 /**
 * Automatic reconnection for the browser session socket, built on
 * partysocket's `ReconnectingWebSocket`. Kept out of `session-core.ts` so
@@ -209,7 +209,7 @@ function reconnectPending(socket) {
 	return socket instanceof ReconnectingWebSocket && socket.shouldReconnect && socket.retryCount < RECONNECT_OPTIONS.maxRetries;
 }
 //#endregion
-//#region session-core-url.ts
+//#region src/session-core-url.ts
 /** Build the session WebSocket URL from the platform URL and resume state. */
 function buildWsUrl(platformUrl, resume, sessionId) {
 	return applyResumeParams(buildAgentUrl(platformUrl, "websocket"), resume, sessionId);
@@ -232,7 +232,7 @@ function applyResumeParams(wsUrl, resume, sessionId) {
 	return wsUrl;
 }
 //#endregion
-//#region session-resume-store.ts
+//#region src/session-resume-store.ts
 /**
 * Where a session id survives a page RELOAD.
 *
@@ -300,7 +300,7 @@ function clearStoredSessionId(platformUrl) {
 	} catch {}
 }
 //#endregion
-//#region session-core-dial.ts
+//#region src/session-core-dial.ts
 /**
 * How the next connection attempt is DIALLED, and the resume identity it dials
 * with.
@@ -383,7 +383,7 @@ function createDialer(options) {
 	};
 }
 //#endregion
-//#region session-core-handshake.ts
+//#region src/session-core-handshake.ts
 /**
 * The deadline on a socket that opened but never became a session.
 *
@@ -463,7 +463,7 @@ function createHandshakeGuard(opts) {
 	};
 }
 //#endregion
-//#region session-core-messages.ts
+//#region src/session-core-messages.ts
 /**
 * Incoming-message handling for the voice session core.
 *
@@ -798,7 +798,7 @@ function createMessageHandlers(deps) {
 	};
 }
 //#endregion
-//#region session-core-state.ts
+//#region src/session-core-state.ts
 /**
 * The browser session's {@link AgentState}, and the error beside it, as a
 * statechart.
@@ -980,7 +980,7 @@ function createSessionStateMachine() {
 	};
 }
 //#endregion
-//#region session-core.ts
+//#region src/session-core.ts
 /**
 * Framework-agnostic voice session core.
 *

package/dist/session-core.js

@@ -1,2 +1,2 @@
-import { t as createSessionCore } from "./session-core-DxBYsfHA.js";
+import { t as createSessionCore } from "./session-core-C9elBIdu.js";
 export { createSessionCore };

package/dist/{tool-call-block-tcPQAkcP.js → tool-call-block-Bunc6rCw.js}

@@ -1,12 +1,12 @@
 import { useTheme } from "./context.js";
-import { r as inkTint } from "./_colors-j8XMToi9.js";
-import { t as Eyebrow } from "./eyebrow-C6ZFuiz6.js";
-import { i as tryParseJSON, r as truncate } from "./_utils-B6498_bm.js";
-import { n as useToolConfig } from "./tool-config-context-DzAofqi_.js";
+import { r as inkTint } from "./_colors-CZ6OlPbL.js";
+import { t as Eyebrow } from "./eyebrow-UfmSz9yy.js";
+import { i as tryParseJSON, r as truncate } from "./_utils-CyzjK0gW.js";
+import { n as useToolConfig } from "./tool-config-context-Bh8p3DtG.js";
 import clsx from "clsx";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { memo, useMemo, useState } from "react";
-//#region components/tool-call-row.tsx
+//#region src/components/tool-call-row.tsx
 /** @jsxImportSource react */
 const VARIANT_CLASSES = {
 	default: {
@@ -116,7 +116,7 @@ function ToolCallRow({ title, detail, pending = false, icon, variant = "default"
 	});
 }
 //#endregion
-//#region components/tool-call-block.tsx
+//#region src/components/tool-call-block.tsx
 /** @jsxImportSource react */
 function formatResult(result) {
 	const parsed = tryParseJSON(result);

package/dist/{tool-config-context-DzAofqi_.js → tool-config-context-Bh8p3DtG.js}

@@ -1,5 +1,5 @@
 import { createContext, useContext } from "react";
-//#region components/tool-config-context.ts
+//#region src/components/tool-config-context.ts
 /**
 * Context for tool display configuration. Installed by `client()` from
 * `ClientConfig.tools`; the built-in components read it via `useToolConfig`.

package/dist/types.js

@@ -1,5 +1,5 @@
 import { CAPTURE_STOP_ACK_TIMEOUT_MS, CLIENT_AUDIO_LEAD_MS, HEARD_AUDIO_LAG_MS, MIC_BUFFER_SECONDS, MIC_SEND_MAX_BUFFERED_BYTES, MIC_SILENCE_PROBE_MS, PACER_BURST_MS, PIPELINE_PLAYBACK_GRACE_MS, PLAYBACK_BUFFER_SECONDS, PLAYBACK_CONCEAL_FADE_MS, PLAYBACK_CONCEAL_FLOOR, PLAYBACK_DONE_MAX_WAIT_MS, PLAYBACK_DONE_POLL_MS, PLAYBACK_FILL_MS, PLAYBACK_PROGRESS_INTERVAL_MS } from "@alexkroman1/aai/internal";
-//#region types.ts
+//#region src/types.ts
 /**
 * `getUserMedia` audio constraints for every capture path in this package.
 *

package/dist/{url-chips-YqhCjWfQ.js → url-chips-C2u7QPv8.js}

@@ -1,10 +1,10 @@
 import { useSessionSelector, useTheme } from "./context.js";
-import { r as inkTint } from "./_colors-j8XMToi9.js";
-import { t as pageBaseUrl } from "./_utils-B6498_bm.js";
+import { r as inkTint } from "./_colors-CZ6OlPbL.js";
+import { t as pageBaseUrl } from "./_utils-CyzjK0gW.js";
 import clsx from "clsx";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
-//#region components/url-chips.tsx
+//#region src/components/url-chips.tsx
 /** @jsxImportSource react */
 /** How long the "Copied" confirmation replaces the label after a click. */
 const COPIED_FEEDBACK_MS = 1500;

package/dist/use-run-key.d.ts

@@ -1,13 +1,22 @@
 /**
  * The handle a page keeps on the runs it started, across a reload.
  *
- * `useWorkflowSubmit({ key, recover: true })` is what makes a run survivable —
- * the run id is that hook's own state, so a refresh loses it while the run
- * carries on — and the `key` is deliberately the caller's to choose, because it
- * is a lookup CAPABILITY: there is no per-user filtering behind `find`, so the
- * key IS the scoping mechanism. Choosing one is easy to get wrong in three
- * separate ways, and six shipped templates had each written the same twenty
- * lines to get it right. This is those lines.
+ * `useWorkflowSubmit` is what makes a run survivable — the run id is that
+ * hook's own state, so a refresh loses it while the run carries on — and the
+ * `key` is what it looks the run up BY, because it is a lookup CAPABILITY:
+ * there is no per-user filtering behind `find`, so the key IS the scoping
+ * mechanism. Choosing one is easy to get wrong in three separate ways, and six
+ * shipped templates had each written the same twenty lines to get it right.
+ * This is those lines.
+ *
+ * **`useWorkflowSubmit` now mints one for itself** ({@link useDefaultRunKey}),
+ * so a page resumes its own run across a reload with nothing written at the
+ * call site — six of six page templates passed `useRunKey()` and
+ * `recover: true`, which is a default in the wrong place. The hook stays
+ * PUBLIC for the page that wants to choose: an app with accounts passes the
+ * ACCOUNT's own id instead, and a run then follows the person to a new device,
+ * which is a promise only a login can keep; a page whose run outlives the tab
+ * passes `useRunKey({ storage: "local" })`.
  *
  * ## Three properties, and the rejected alternatives are why each one matters
  *
@@ -42,7 +51,9 @@
  * coming back on Friday to press Stop is the ordinary case rather than an edge
  * one, and a tab-scoped key would answer that with an empty form beside a run
  * still posting somewhere. It is as far as a key can go without a login, and no
- * further. `podcast-digest` is that template; the other five ship the default.
+ * further. `podcast-digest` is that template, and the reason this hook is still
+ * called by name anywhere; the other five take the tab-scoped default the
+ * submit hook mints for them.
  *
  * ## Anything ELSE a page stores back must be VALIDATED on read
  *
@@ -77,8 +88,31 @@
  * failing to render.
  */
 /**
- * A lookup key for `useWorkflowSubmit({ key, recover: true })`, stable across
- * reloads.
+ * The key `useWorkflowSubmit` uses when the page named none.
+ *
+ * Two things it does that a plain `useRunKey()` at the call site cannot, and
+ * both are about a page that DID name one:
+ *
+ * - **It mints nothing when the caller has a key.** Minting writes to storage,
+ *   so an unconditional `useRunKey()` inside the hook would leave a slot behind
+ *   on every page that passes an account id and never reads it back.
+ * - **It stays reactive to the caller's key.** A key that arrives late — an
+ *   account id resolved after a login — must reach the lookup, which re-asks on
+ *   a changed key by design; freezing it into `useState` would pin the page to
+ *   whatever it held on its first render.
+ *
+ * The minted half is still frozen for the component's life, which is what
+ * `useRunKey` freezes it for: a fresh key per render would record every run
+ * under a name the next load cannot produce.
+ *
+ * @param explicit - The caller's own key, or undefined for a page with none.
+ * @returns The key to record runs under and look them up by.
+ *
+ * @internal
+ */
+export declare function useDefaultRunKey(explicit: string | undefined): string;
+/**
+ * A lookup key for `useWorkflowSubmit({ key })`, stable across reloads.
  *
  * @param options - See the module doc for the whole argument. The storage kind
  *   is read once, when the key is minted: a value that changed afterwards would

package/dist/{use-user-transcript-C14qWFu2.js → use-user-transcript-DFTSEuZN.js}

@@ -1,5 +1,5 @@
 import { useSessionSelector } from "./context.js";
-//#region use-user-transcript.ts
+//#region src/use-user-transcript.ts
 /**
 * `useUserTranscript` — what the caller is saying RIGHT NOW, read correctly.
 *

package/dist/use-workflow-form.d.ts

@@ -1,11 +1,10 @@
 /**
- * The two hooks a FORM needs, as against the one a status view does.
+ * The hook a FORM needs, as against the one a status view does.
  *
  * `useWorkflowRun` (`workflow-client.ts`) watches a run you already have.
- * These two are what comes before it: `useWorkflows` reads the declared
- * workflows so `<WorkflowFields>` can render a form from a schema, and
- * `useWorkflowSubmit` starts a run and hands the id straight to
- * `useWorkflowRun`.
+ * This is what comes before it: `useWorkflowSubmit` starts a run and hands the
+ * id straight to `useWorkflowRun`. Its sibling `useWorkflows` — the listing
+ * `<WorkflowFields>` renders a form from — is `use-workflows.ts`.
  *
  * ## `useWorkflowSubmit` — a form's two halves in one hook
  *
@@ -32,76 +31,10 @@
  * `wait` here when the page really does want one request, and the run is
  * followed from the same id either way.
  */
-import type { AnyWorkflowDef, UploadParallel, UploadProgress, WorkflowOutputOf, WorkflowSummary } from "@alexkroman1/aai/workflow-api";
+import type { AnyWorkflowDef, UploadParallel, UploadProgress, WorkflowOutputOf } from "@alexkroman1/aai/workflow-api";
 import type { FormValues } from "./components/form-types.ts";
 import type { WorkflowApi, WorkflowRun } from "./workflow-client.ts";
 import type { SubmitInputOf } from "./workflow-def-types.ts";
-/** Options for {@link useWorkflows}. */
-export type UseWorkflowsOptions = {
-    /** The client to read the listing with. Defaults to one for the page's own agent. */
-    api?: WorkflowApi;
-    /**
-     * Skip the lookup entirely, reporting an empty listing that is not loading.
-     *
-     * For a caller that may or may not need the listing and cannot decide with a
-     * conditional hook — `<WorkflowFields>` handed a summary rather than a name is
-     * the one in this package. It reports `loading: false`, because a skipped
-     * lookup is finished rather than pending.
-     */
-    skip?: boolean;
-};
-/** What {@link useWorkflows} reports. */
-export type UseWorkflowsResult = {
-    /** The agent's declared workflows, each with the JSON Schema of its input. */
-    workflows: WorkflowSummary[];
-    /** True until the listing lands, so a form can hold its fields back. */
-    loading: boolean;
-    /** The lookup's failure. Set alongside an EMPTY list, which is why it exists. */
-    error: string | undefined;
-};
-/**
- * Read the agent's declared workflows.
- *
- * What `<WorkflowFields>` renders a form FROM: each summary carries the JSON
- * Schema of that workflow's input, converted server-side precisely so a browser
- * can read it.
- *
- * The failure is reported rather than swallowed, because the alternative is an
- * empty list — which renders as a form with no fields and reads as "this agent
- * declares no workflows" about an agent that was merely unreachable.
- *
- * @example
- * ```tsx
- * import { useWorkflows } from "@alexkroman1/aai-ui";
- *
- * // A page rendering its own chrome from the listing — a picker, say. A form
- * // for ONE workflow wants `<WorkflowFields workflow="name" />` instead,
- * // which does this lookup itself.
- * function WorkflowPicker({ onPick }: { onPick: (name: string) => void }) {
- *   const { workflows, loading, error } = useWorkflows();
- *   if (loading) return <p>Loading…</p>;
- *   if (error !== undefined) return <p role="alert">{error}</p>;
- *   return (
- *     <ul>
- *       {workflows.map((summary) => (
- *         <li key={summary.name}>
- *           <button type="button" onClick={() => onPick(summary.name)}>
- *             {summary.description ?? summary.name}
- *           </button>
- *         </li>
- *       ))}
- *     </ul>
- *   );
- * }
- * ```
- *
- * @param opts - See {@link UseWorkflowsOptions}.
- * @returns The listing, its loading flag and its failure — see
- * {@link UseWorkflowsResult}.
- *
- * @public
- */
-export declare function useWorkflows(opts?: UseWorkflowsOptions): UseWorkflowsResult;
 /**
  * What {@link WorkflowSubmission.upload} reports while the bytes are going.
  *
@@ -229,29 +162,37 @@ export type WorkflowSubmission<R = unknown, I = unknown> = {
 export type UseWorkflowSubmitOptions = {
     /** The client to start runs with. Defaults to one for the page's own agent. */
     api?: WorkflowApi;
-    /** Correlation key recorded with the run, for finding it again without the id. */
+    /**
+     * Correlation key recorded with the run, for finding it again without the id.
+     *
+     * **Defaulted**, to an opaque per-page key in `sessionStorage` that the next
+     * load produces again — `useRunKey()`'s, minted by the hook. Pass one to
+     * scope runs to something the page knows better: an ACCOUNT's own id, which
+     * is what makes a run follow the person to a new device, or
+     * `useRunKey({ storage: "local" })` for a run that outlives the tab by
+     * design. The key is a lookup CAPABILITY (there is no per-user filtering
+     * behind `find`), it must fit the route's 256-character bound, and anything
+     * derived from a person's own input both collides and carries what they
+     * typed — `use-run-key.ts` argues every alternative.
+     */
     key?: string;
     /**
      * On mount, adopt the newest run this `key` already has.
      *
-     * **This is what makes a reload survivable.** The run id is this hook's own
-     * state, so a refresh loses it while the run carries on — and a page that
-     * cannot name a run cannot show it, cancel it or wake it. With a `key` and
-     * this flag the hook asks `find(workflow, key)` once as it mounts and follows
-     * whatever comes back, so the answer, the progress and the controls are all
-     * there again.
-     *
-     * Inert without a `key`, because the key IS the lookup. Opt-in because a
-     * `key` on its own means only "record this with the run", which is what a
-     * page passing an account id may well want; adopting a run is a decision
-     * about the page.
+     * **This is what makes a reload survivable, and it is ON.** The run id is
+     * this hook's own state, so a refresh loses it while the run carries on — and
+     * a page that cannot name a run cannot show it, cancel it or wake it. The
+     * hook asks `find(workflow, key)` once as it mounts and follows whatever
+     * comes back, so the answer, the progress and the controls are all there
+     * again.
      *
-     * The key has to be one the next load can produce, and choosing it is the
-     * caller's: it is a lookup CAPABILITY (there is no per-user filtering behind
-     * `find`), it must fit the route's 256-character bound, and anything derived
-     * from a person's own input both collides and carries what they typed.
-     * `useRunKey()` is that key, and its module argues every alternative; a page
-     * with accounts passes the account's own id instead.
+     * It used to be opt-in, on the argument that a `key` alone means only "record
+     * this with the run" — true of `ctx.workflows.start({ key })`, where there is
+     * no page to put a run back on, and not of a form: six of six page templates
+     * passed `useRunKey()` and `recover: true` together, which is a default in
+     * the wrong place. `false` is the opt-out, and what it buys is a form that
+     * always opens empty — no lookup on mount, and a live run reachable only by
+     * an id the page has already lost.
      */
     recover?: boolean;
     /**