@alexkroman1/aai-ui 16.1.0 → 18.0.0

package/dist/default-client/index.html

@@ -6,9 +6,9 @@
     <title>aai</title>
     <link rel="icon" href="./favicon.ico" />
     <style>html, body { background: #FBF8F2; margin: 0; }</style>
-    <script type="module" crossorigin src="./assets/index-eOmPq2sS.js"></script>
+    <script type="module" crossorigin src="./assets/index-tc-nAWq3.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/client-audio-constants-CP13UQZt.js">
-    <link rel="stylesheet" crossorigin href="./assets/index-CMh4E-Ci.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-5XG8PqGw.css">
   </head>
   <body>
     <main id="app"></main>

package/dist/default-client.d.ts

@@ -1,2 +1,23 @@
 /** @jsxImportSource react */
+/**
+ * The page every agent gets with NO `client.tsx` of its own — and which page
+ * follows the agent's declared front door.
+ *
+ * One bundle serves both, because the CLI serves one directory for every agent
+ * (`resolveClientDir`'s fallback to `defaultClientDir()`): the choice cannot be
+ * made at build time, so it is made here, from the `page` field
+ * `GET client-config` reports precisely so a browser knows before it dials.
+ *
+ * It used to call `mountClient({})` unconditionally. For a WORKFLOW APP that
+ * renders a start screen and then opens a `/websocket` the server declines by
+ * design — a dead page — which is why "you do not need a `client.tsx`" was only
+ * ever true of a voice agent. Both mounts have a default shell now, so it is
+ * true of either.
+ *
+ * The name is FORWARDED rather than looked up twice: on the platform this
+ * endpoint is the broker, so a request able to boot a sandbox should not be
+ * issued once here and again by the shell. Both shells treat an explicit name as
+ * final and skip their own lookup. An agent that declared none still costs the
+ * shell its own request, which is what it cost before.
+ */
 import "../styles.css";

package/dist/define-client.js

@@ -1,11 +1,11 @@
-import { t as ChatView } from "./chat-view-DsylXJsw.js";
-import { n as fetchClientConfig } from "./client-config-DJQHnYjm.js";
-import { SessionProvider, ThemeProvider } from "./context.js";
+import { t as ChatView } from "./chat-view-P12pHKQU.js";
 import { n as setPageTitle, t as pageBaseUrl } from "./_utils-DnQDM9Uy.js";
+import { n as fetchClientConfig } from "./client-config-CFhkMkmv.js";
+import { SessionProvider, ThemeProvider } from "./context.js";
 import { t as ToolConfigContext } from "./tool-config-context-Es4YUzV2.js";
 import { SidebarLayout } from "./components/sidebar-layout.js";
 import { StartScreen } from "./components/start-screen.js";
-import { t as createBrowserSession } from "./session-core-gwePM95B.js";
+import { t as createBrowserSession } from "./session-core-TOdm_Con.js";
 import { jsx } from "react/jsx-runtime";
 import { createElement, useEffect, useState } from "react";
 import { flushSync } from "react-dom";

package/dist/hooks.d.ts

@@ -102,8 +102,8 @@ export declare function useToolResult<R = unknown>(callback: (name: string, resu
 export declare function useAgentState<S = DefaultToolResult>(): S | null;
 /**
  * The agent's projected session state, typed and defaulted by the SAME
- * projection the agent pushes — pass `slot.projection(view)` and there is no
- * type argument to restate and no empty frame to derive.
+ * projection the agent pushes — pass `slot.projected` and there is no type
+ * argument to restate and no empty frame to derive.
  *
  * This is the overload to reach for whenever `syncState` is a slot projection,
  * because it closes the round-trip the other two leave open. A projection is
@@ -114,20 +114,29 @@ export declare function useAgentState<S = DefaultToolResult>(): S | null;
  * declaration and both were written by hand:
  *
  * ```tsx no-check
- * // `no-check`: the projection lives with the agent, in another file.
+ * // `no-check`: the slot lives with the agent, in another file.
  * // Before — the empty frame derived by hand, the type named three times:
  * const EMPTY: CartView = cartSlot.projection(cartView)(undefined);
  * const cart = useAgentState<CartView>(EMPTY);
  *
- * // After — `shared.ts` exports the projection once, both ends import it:
- * const cart = useAgentState(cartProjection);
+ * // After — the slot declares its `view`, and both ends pass the one object
+ * // it built at declaration:
+ * const cart = useAgentState(cartSlot.projected);
  * ```
  *
+ * **`slot.projected` is the spelling to prefer, and it retires the caveat
+ * below.** Declare the view on the slot (`sessionSlot(key, create, { view })`)
+ * and the projection is built ONCE where the slot is, so `agent({ syncState })`
+ * and this hook are handed the same object and nothing has to arrange for that.
+ * `slot.projection(view)` composes a NEW projection per call, which is what
+ * leaves both halves below to a convention.
+ *
  * The empty frame is memoized on the projection's identity, so a module-scope
  * projection (the normal case) produces ONE frame for the life of the
  * component — which the `fallback` overload can only ask you to arrange by
  * hoisting, and which a `slot.projection(view)` spelled inline in the render
- * body silently got wrong.
+ * body silently got wrong. A `slot.projected` cannot be spelled inline: it is
+ * the slot's own field.
  *
  * **The one case that cannot use this overload is a slot whose declaring module
  * is expensive to IMPORT.** A projection is built from the slot, so the browser
@@ -139,9 +148,10 @@ export declare function useAgentState<S = DefaultToolResult>(): S | null;
  * everywhere the slot's module is cheap, which is every other stateful
  * template.
  *
- * @param projection - The same `slot.projection(view)` the agent declares as
- *   `syncState`. Export it from the module that declares the slot so the two
- *   ends cannot drift.
+ * @param projection - The same projection the agent declares as `syncState`.
+ *   `slot.projected` is that object by construction; a `slot.projection(view)`
+ *   has to be exported from the module that declares the slot so the two ends
+ *   cannot drift.
  *
  * @public
  */

package/dist/hooks.js

@@ -1,5 +1,5 @@
-import { useSessionSelector } from "./context.js";
 import { i as tryParseJSON } from "./_utils-DnQDM9Uy.js";
+import { useSessionSelector } from "./context.js";
 import { useEffect, useMemo, useRef } from "react";
 //#region src/hooks.ts
 /** Index of the first item whose sequence number is above the watermark (tail scan from the end). */

package/dist/index.d.ts

@@ -25,7 +25,7 @@
  * | --- | --- |
  * | the call itself | {@link useSession} (everything), {@link useSessionStatus}, {@link useSessionError}, {@link useSessionActions}, {@link useSessionSelector} |
  * | what was said | {@link useConversation}, {@link useUserTranscript} |
- * | what the agent projects | {@link useAgentState} — pass the `slot.projection(…)` the agent declared, and it types the state AND supplies the frame rendered before the first push |
+ * | what the agent projects | {@link useAgentState} — pass the `slot.projected` the agent declared as `syncState`, and it types the state AND supplies the frame rendered before the first push |
  * | tools, as they run | {@link useToolCallStart}, {@link useToolResult}, {@link useEvent} |
  * | a durable run | {@link useWorkflowSubmit} (start one), {@link useWorkflowRun} (watch one), {@link useWorkflowRuns} / {@link useWorkflows} (list), {@link useWorkflowProgress} / {@link useWorkflowStream} (its output as it arrives) |
  * | page chrome | {@link useTheme}, {@link useCopy}, {@link useFlash}, {@link useDownloadUrl}, {@link useRunKey} |
@@ -39,17 +39,20 @@
  *
  * ## Two things worth knowing before the reference below
  *
- * **Three names are re-exported from `@alexkroman1/aai`** — {@link WorkflowInputOf},
- * {@link WorkflowOutputOf} and {@link WorkflowSummary}, plus {@link isTerminal}
- * and {@link ClientConfigResponse}. They are one declaration with two reference
- * pages, not two types; a page takes them from here, an `agent.ts` from there.
+ * **Several names are re-exported from `@alexkroman1/aai`** —
+ * {@link WorkflowInputOf}, {@link WorkflowOutputOf}, {@link WorkflowSummary} and
+ * {@link AgentClient}, plus {@link isTerminal} and {@link ClientConfigResponse}.
+ * They are one declaration with two reference pages, not two types; a page takes
+ * them from here, an `agent.ts` from there.
  *
- * **{@link createWorkflowApi} is the browser's workflow client, and there are two
- * others.** `createWorkflowApiClient` (`@alexkroman1/aai/workflow-api`) is the
- * same call set for a caller with no page to default its base URL from — a
- * script, a cron job, a server — and `createAgentClient` on that subpath is a
- * superset that also reaches `/client-config`. Reach for the one here whenever
- * the code runs in a page the agent serves.
+ * **{@link createWorkflowApi} is the browser's client, and there is one other.**
+ * `createAgentClient` (`@alexkroman1/aai/workflow-api`) is the same
+ * {@link AgentClient} for a caller with no page to default its base URL from — a
+ * script, a cron job, a server. Reach for the one here whenever the code runs in
+ * a page the agent serves; it delegates to that factory, so there is one
+ * implementation of the routes and one `config()`. (It used to answer the
+ * narrower `WorkflowApi`, which made a page wanting the agent's own name build a
+ * second client for one read.)
  *
  * @module
  */
@@ -87,12 +90,13 @@ export { mountClient } from "./define-client.tsx";
 export { useAgentState, useEvent, useToolCallStart, useToolResult } from "./hooks.ts";
 export { mountPage, type PageConfig, type PageHandle } from "./page.tsx";
 export { createBrowserSession } from "./session-core.ts";
-export type { AgentCustomEvent, BrowserSession, SessionSnapshot, } from "./session-core-types.ts";
+export type { AgentCustomEvent, BrowserSession, browserSessionBrand, SessionSnapshot, UserTurnControls, } from "./session-core-types.ts";
 export type { AgentState, ChatMessage, ClientTheme, SessionError, SessionErrorCode, ToolCallInfo, VoiceSessionOptions, WebSocketConstructor, } from "./types.ts";
 export { type ConversationItem, type UseConversationResult, useConversation, } from "./use-conversation.ts";
 export { type UseCopyResult, useCopy } from "./use-copy.ts";
 export { type UseDownloadUrlOptions, type UseDownloadUrlResult, useDownloadUrl, } from "./use-download-url.ts";
 export { type UseFlashResult, useFlash } from "./use-flash.ts";
+export { type UsePushToTalkOptions, type UsePushToTalkResult, usePushToTalk, } from "./use-push-to-talk.ts";
 export { useRunKey } from "./use-run-key.ts";
 export { type UseSessionControlsResult, useSessionControls } from "./use-session-controls.ts";
 export { type UseUserTranscriptResult, useUserTranscript } from "./use-user-transcript.ts";
@@ -102,7 +106,7 @@ export { type UseWorkflowRunResult, useWorkflowRun } from "./use-workflow-run.ts
 export { type UseWorkflowRunsOptions, type UseWorkflowRunsResult, useWorkflowRuns, } from "./use-workflow-runs.ts";
 export { type UseWorkflowStreamOptions, useWorkflowStream, type WorkflowStreamSubmission, } from "./use-workflow-stream.ts";
 export { type UseWorkflowsOptions, type UseWorkflowsResult, useWorkflows, } from "./use-workflows.ts";
-export { createWorkflowApi, isTerminal, type WorkflowApi, type WorkflowApiOptions, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRun, type WorkflowRunStatus, type WorkflowSummary, } from "./workflow-client.ts";
+export { type AgentClient, createWorkflowApi, isTerminal, type WorkflowApi, type WorkflowApiOptions, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRun, type WorkflowRunStatus, type WorkflowSummary, } from "./workflow-client.ts";
 export type { SubmitInputOf } from "./workflow-def-types.ts";
 export { fieldKindFor, type WorkflowFieldKind } from "./workflow-field-kind.ts";
 export { WORKFLOW_STATUS_LABELS } from "./workflow-status-labels.ts";