@alexkroman1/aai 0.7.12 → 0.8.1

package/dist/sdk/types.d.ts

@@ -21,8 +21,9 @@ export type BeforeStepResult = {
  * - `"fetch_json"` — Call a REST API endpoint and return the JSON response.
  * - `"run_code"` — Execute JavaScript in a sandbox for calculations and data processing.
  * - `"vector_search"` — Search the agent's RAG knowledge base for relevant documents.
+ * - `"memory"` — Persistent KV memory: save_memory, recall_memory, list_memories, forget_memory.
  */
-export type BuiltinTool = "web_search" | "visit_webpage" | "fetch_json" | "run_code" | "vector_search";
+export type BuiltinTool = "web_search" | "visit_webpage" | "fetch_json" | "run_code" | "vector_search" | "memory";
 /**
  * How the LLM should select tools during a turn.
  *
@@ -136,17 +137,31 @@ export type ToolDef<P extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawS
     execute(args: z.infer<P>, ctx: ToolContext<S>): Promise<unknown> | unknown;
 };
 /**
- * Available TTS voice identifiers (Cartesia voice UUIDs).
+ * Identity helper that preserves the Zod schema generic for type inference.
  *
- * Pass any Cartesia voice UUID as a string. The named constants below are
- * provided for convenience — the type also accepts arbitrary strings to
- * support custom or new voices without an SDK update.
+ * When tools are defined inline in `defineAgent({ tools: { ... } })`, the
+ * generic `P` gets widened to the base `ZodObject` type, so `args` in
+ * `execute` loses its specific shape. Wrapping a tool definition in `tool()`
+ * lets TypeScript infer `P` from `parameters` and type `args` correctly.
  *
- * Browse all voices at https://play.cartesia.ai
+ * @example
+ * ```ts
+ * import { defineAgent, tool } from "aai";
+ * import { z } from "zod";
  *
- * @default {"694f9389-aac1-45b6-b726-9d9369183238"} (Sarah)
+ * export default defineAgent({
+ *   name: "my-agent",
+ *   tools: {
+ *     greet: tool({
+ *       description: "Greet the user",
+ *       parameters: z.object({ name: z.string() }),
+ *       execute: ({ name }) => `Hello, ${name}!`, // name is string
+ *     }),
+ *   },
+ * });
+ * ```
  */
-export type Voice = "694f9389-aac1-45b6-b726-9d9369183238" | "a167e0f3-df7e-4d52-a9c3-f949145efdab" | "829ccd10-f8b3-43cd-b8a0-4aeaa81f3b30" | "156fb8d2-335b-4950-9cb3-a2d33befec77" | "248be419-c632-4f23-adf1-5324ed7dbf1d" | "e3827ec5-697a-4b7c-9704-1a23041bbc51" | "79a125e8-cd45-4c13-8a67-188112f4dd22" | "00a77add-48d5-4ef6-8157-71e5437b282d" | "21b81c14-f85b-436d-aff5-43f2e788ecf8" | "996a8b96-4804-46f0-8e05-3fd4ef1a87cd" | "bf991597-6c13-47e4-8411-91ec2de5c466" | "cd17ff2d-5ea4-4695-be8f-42193949b946" | "15a9cd88-84b0-4a8b-95f2-5d583b54c72e" | "c2ac25f9-ecc4-4f56-9095-651354df60c0" | "573e3144-a684-4e72-ac2b-9b2063a50b53" | "34bde396-9fde-4ebf-ad03-e3a1d1155205" | "b7d50908-b17c-442d-ad8d-810c63997ed9" | "043cfc81-d69f-4bee-ae1e-7862cb358650" | "a3520a8f-226a-428d-9fcd-b0a4711a6829" | "d46abd1d-2d02-43e8-819f-51fb652c1c61" | "820a3788-2b37-4d21-847a-b65d8a68c99a" | "69267136-1bdc-412f-ad78-0caad210fb40" | "f146dcec-e481-45be-8ad2-96e1e40e7f32" | "34575e71-908f-4ab6-ab54-b08c95d6597d" | "ee7ea9f8-c0c1-498c-9279-764d6b56d189" | "b043dea0-a007-4bbe-a708-769dc0d0c569" | "63ff761f-c1e8-414b-b969-d1833d1c870c" | "95856005-0332-41b0-935f-352e296aa0df" | "bd9120b6-7761-47a6-a446-77ca49132781" | "7360f116-6306-4e9a-b487-1235f35a0f21" | "5619d38c-cf51-4d8e-9575-48f61a280413" | "2ee87190-8f84-4925-97da-e52547f9462c" | (string & Record<never, never>);
+export declare function tool<P extends z.ZodObject<z.ZodRawShape>, S = any>(def: ToolDef<P, S>): ToolDef<P, S>;
 /**
  * Information about a completed agentic step, passed to the `onStep` hook.
  *
@@ -199,11 +214,6 @@ export type AgentOptions<S = Record<string, unknown>> = {
     instructions?: string;
     /** Initial spoken greeting when a session starts. */
     greeting?: string;
-    /**
-     * Cartesia voice UUID for TTS. Defaults to the server's configured voice
-     * (Sarah) when omitted. Browse voices at https://play.cartesia.ai.
-     */
-    voice?: Voice;
     /** Prompt hint for the STT model to improve transcription accuracy. */
     sttPrompt?: string;
     /**
@@ -266,7 +276,6 @@ export type AgentDef = {
     name: string;
     instructions: string;
     greeting: string;
-    voice: string;
     sttPrompt?: string;
     maxSteps: number | ((ctx: HookContext) => number);
     toolChoice?: ToolChoice;

package/dist/sdk/types.d.ts.map

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

package/dist/sdk/types.js

@@ -4,6 +4,35 @@
  *
  * @module
  */
+/**
+ * Identity helper that preserves the Zod schema generic for type inference.
+ *
+ * When tools are defined inline in `defineAgent({ tools: { ... } })`, the
+ * generic `P` gets widened to the base `ZodObject` type, so `args` in
+ * `execute` loses its specific shape. Wrapping a tool definition in `tool()`
+ * lets TypeScript infer `P` from `parameters` and type `args` correctly.
+ *
+ * @example
+ * ```ts
+ * import { defineAgent, tool } from "aai";
+ * import { z } from "zod";
+ *
+ * export default defineAgent({
+ *   name: "my-agent",
+ *   tools: {
+ *     greet: tool({
+ *       description: "Greet the user",
+ *       parameters: z.object({ name: z.string() }),
+ *       execute: ({ name }) => `Hello, ${name}!`, // name is string
+ *     }),
+ *   },
+ * });
+ * ```
+ */
+// biome-ignore lint/suspicious/noExplicitAny: S defaults to any so tool() works with any agent state type
+export function tool(def) {
+    return def;
+}
 /**
  * Default system prompt used when `instructions` is not provided.
  *

package/dist/sdk/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../sdk/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;GAIG;AA0SH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAW;;;;;;;;;;;;;;wEAc4B,CAAC;AAEzE,qDAAqD;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAC3B,6DAA6D,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../sdk/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;GAIG;AAsJH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,0GAA0G;AAC1G,MAAM,UAAU,IAAI,CAClB,GAAkB;IAElB,OAAO,GAAG,CAAC;AACb,CAAC;AAqGD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAW;;;;;;;;;;;;;;wEAc4B,CAAC;AAEzE,qDAAqD;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAC3B,6DAA6D,CAAC"}

package/dist/ui/_components/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../ui/_components/app.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAC;AAOtC,wBAAgB,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CA4BxC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../ui/_components/app.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAC;AAetC,wBAAgB,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAQxC"}

package/dist/ui/_components/app.js

@@ -1,14 +1,13 @@
-import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { jsx as _jsx } from "preact/jsx-runtime";
 import { useMountConfig } from "../mount_context.js";
-import { useSession } from "../signals.js";
 import { ChatView } from "./chat_view.js";
+import { StartScreen } from "./start_screen.js";
 const AAI_LOGO = `▄▀█ ▄▀█ █\n█▀█ █▀█ █`;
+function AaiLogo() {
+    return (_jsx("span", { class: "font-aai-mono text-lg leading-[1.1] font-bold text-aai-primary whitespace-pre", children: AAI_LOGO }));
+}
 export function App() {
-    const { started, start } = useSession();
     const { title } = useMountConfig();
-    if (!started.value) {
-        return (_jsx("div", { class: "flex items-center justify-center h-screen bg-aai-bg font-aai", children: _jsxs("div", { class: "flex flex-col items-center gap-6 bg-aai-surface border border-aai-border rounded-lg px-12 py-10", children: [title ? (_jsx("span", { class: "text-lg font-semibold text-aai-primary", children: title })) : (_jsx("span", { class: "font-aai-mono text-lg leading-[1.1] font-bold text-aai-primary whitespace-pre", children: AAI_LOGO })), _jsx("button", { type: "button", class: "h-8 px-4 py-1.5 rounded-aai text-sm font-medium leading-[130%] cursor-pointer bg-aai-surface-hover text-aai-text-secondary border border-aai-border outline-none", onClick: start, children: "Start" })] }) }));
-    }
-    return _jsx(ChatView, {});
+    return (_jsx(StartScreen, { icon: title ? undefined : _jsx(AaiLogo, {}), title: title, children: _jsx(ChatView, {}) }));
 }
 //# sourceMappingURL=app.js.map

package/dist/ui/_components/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../ui/_components/app.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAiB,CAAC;AAE3C,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;IACxC,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,EAAE,CAAC;IAEnC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,CACL,cAAK,KAAK,EAAC,8DAA8D,YACvE,eAAK,KAAK,EAAC,iGAAiG,aACzG,KAAK,CAAC,CAAC,CAAC,CACP,eAAM,KAAK,EAAC,wCAAwC,YAAE,KAAK,GAAQ,CACpE,CAAC,CAAC,CAAC,CACF,eAAM,KAAK,EAAC,+EAA+E,YACxF,QAAQ,GACJ,CACR,EACD,iBACE,IAAI,EAAC,QAAQ,EACb,KAAK,EAAC,kKAAkK,EACxK,OAAO,EAAE,KAAK,sBAGP,IACL,GACF,CACP,CAAC;IACJ,CAAC;IAED,OAAO,KAAC,QAAQ,KAAG,CAAC;AACtB,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../ui/_components/app.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAoB,CAAC;AAEjD,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,SAAS,OAAO;IACd,OAAO,CACL,eAAM,KAAK,EAAC,+EAA+E,YACxF,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,EAAE,CAAC;IAEnC,OAAO,CACL,KAAC,WAAW,IAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAC,OAAO,KAAG,EAAE,KAAK,EAAE,KAAK,YAC9D,KAAC,QAAQ,KAAG,GACA,CACf,CAAC;AACJ,CAAC"}

package/dist/ui/_components/sidebar_layout.d.ts

@@ -0,0 +1,19 @@
+import type { ComponentChildren } from "preact";
+/**
+ * A two-column layout with a fixed-width sidebar and a flexible main area.
+ * Commonly used to pair a custom sidebar (cart, dashboard) with `<ChatView />`.
+ *
+ * @example
+ * ```tsx
+ * <SidebarLayout sidebar={<OrderPanel />}>
+ *   <ChatView />
+ * </SidebarLayout>
+ * ```
+ */
+export declare function SidebarLayout({ sidebar, children, width, side, }: {
+    sidebar: ComponentChildren;
+    children: ComponentChildren;
+    width?: string | undefined;
+    side?: "left" | "right" | undefined;
+}): import("preact").JSX.Element;
+//# sourceMappingURL=sidebar_layout.d.ts.map

package/dist/ui/_components/sidebar_layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar_layout.d.ts","sourceRoot":"","sources":["../../../ui/_components/sidebar_layout.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,QAAQ,EACR,KAAe,EACf,IAAa,GACd,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACrC,gCAqBA"}

package/dist/ui/_components/sidebar_layout.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+/**
+ * A two-column layout with a fixed-width sidebar and a flexible main area.
+ * Commonly used to pair a custom sidebar (cart, dashboard) with `<ChatView />`.
+ *
+ * @example
+ * ```tsx
+ * <SidebarLayout sidebar={<OrderPanel />}>
+ *   <ChatView />
+ * </SidebarLayout>
+ * ```
+ */
+export function SidebarLayout({ sidebar, children, width = "20rem", side = "left", }) {
+    const sidebarEl = (_jsx("div", { class: "flex-shrink-0 flex flex-col overflow-y-auto", style: {
+            width,
+            borderRight: side === "left" ? "1px solid var(--color-aai-border)" : undefined,
+            borderLeft: side === "right" ? "1px solid var(--color-aai-border)" : undefined,
+        }, children: sidebar }));
+    return (_jsxs("div", { class: "flex h-screen", style: { background: "var(--color-aai-bg)" }, children: [side === "left" && sidebarEl, _jsx("div", { class: "flex-1 min-w-0", children: children }), side === "right" && sidebarEl] }));
+}
+//# sourceMappingURL=sidebar_layout.js.map

package/dist/ui/_components/sidebar_layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar_layout.js","sourceRoot":"","sources":["../../../ui/_components/sidebar_layout.tsx"],"names":[],"mappings":";AAIA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,OAAO,EACP,QAAQ,EACR,KAAK,GAAG,OAAO,EACf,IAAI,GAAG,MAAM,GAMd;IACC,MAAM,SAAS,GAAG,CAChB,cACE,KAAK,EAAC,6CAA6C,EACnD,KAAK,EAAE;YACL,KAAK;YACL,WAAW,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,SAAS;YAC9E,UAAU,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,SAAS;SAC/E,YAEA,OAAO,GACJ,CACP,CAAC;IAEF,OAAO,CACL,eAAK,KAAK,EAAC,eAAe,EAAC,KAAK,EAAE,EAAE,UAAU,EAAE,qBAAqB,EAAE,aACpE,IAAI,KAAK,MAAM,IAAI,SAAS,EAC7B,cAAK,KAAK,EAAC,gBAAgB,YAAE,QAAQ,GAAO,EAC3C,IAAI,KAAK,OAAO,IAAI,SAAS,IAC1B,CACP,CAAC;AACJ,CAAC"}

package/dist/ui/_components/start_screen.d.ts

@@ -0,0 +1,24 @@
+import type { ComponentChildren } from "preact";
+/**
+ * A centered start screen with icon, title, subtitle, and a start button.
+ * Renders `children` (the main app) once the session has started.
+ *
+ * @example
+ * ```tsx
+ * function MyAgent() {
+ *   return (
+ *     <StartScreen icon="🍕" title="Pizza Palace" subtitle="Voice-powered ordering">
+ *       <ChatView />
+ *     </StartScreen>
+ *   );
+ * }
+ * ```
+ */
+export declare function StartScreen({ children, icon, title, subtitle, buttonText, }: {
+    children: ComponentChildren;
+    icon?: ComponentChildren | undefined;
+    title?: string | undefined;
+    subtitle?: string | undefined;
+    buttonText?: string | undefined;
+}): import("preact").JSX.Element;
+//# sourceMappingURL=start_screen.d.ts.map

package/dist/ui/_components/start_screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start_screen.d.ts","sourceRoot":"","sources":["../../../ui/_components/start_screen.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAGhD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,UAAoB,GACrB,EAAE;IACD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,gCAuBA"}

package/dist/ui/_components/start_screen.js

@@ -0,0 +1,25 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { useSession } from "../signals.js";
+/**
+ * A centered start screen with icon, title, subtitle, and a start button.
+ * Renders `children` (the main app) once the session has started.
+ *
+ * @example
+ * ```tsx
+ * function MyAgent() {
+ *   return (
+ *     <StartScreen icon="🍕" title="Pizza Palace" subtitle="Voice-powered ordering">
+ *       <ChatView />
+ *     </StartScreen>
+ *   );
+ * }
+ * ```
+ */
+export function StartScreen({ children, icon, title, subtitle, buttonText = "Start", }) {
+    const { started, start } = useSession();
+    if (started.value) {
+        return _jsx(_Fragment, { children: children });
+    }
+    return (_jsx("div", { class: "flex items-center justify-center h-screen bg-aai-bg font-aai", children: _jsxs("div", { class: "flex flex-col items-center gap-6 bg-aai-surface border border-aai-border rounded-lg px-12 py-10", children: [icon && _jsx("div", { class: "text-5xl", children: icon }), title && _jsx("h1", { class: "text-xl font-semibold text-aai-text m-0", children: title }), subtitle && _jsx("p", { class: "text-sm text-aai-text-muted m-0", children: subtitle }), _jsx("button", { type: "button", class: "mt-2 px-8 py-3 rounded-aai text-sm font-medium cursor-pointer bg-aai-primary text-white border-none", onClick: start, children: buttonText })] }) }));
+}
+//# sourceMappingURL=start_screen.js.map

package/dist/ui/_components/start_screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start_screen.js","sourceRoot":"","sources":["../../../ui/_components/start_screen.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,UAAU,GAAG,OAAO,GAOrB;IACC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;IAExC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,OAAO,CACL,cAAK,KAAK,EAAC,8DAA8D,YACvE,eAAK,KAAK,EAAC,iGAAiG,aACzG,IAAI,IAAI,cAAK,KAAK,EAAC,UAAU,YAAE,IAAI,GAAO,EAC1C,KAAK,IAAI,aAAI,KAAK,EAAC,yCAAyC,YAAE,KAAK,GAAM,EACzE,QAAQ,IAAI,YAAG,KAAK,EAAC,iCAAiC,YAAE,QAAQ,GAAK,EACtE,iBACE,IAAI,EAAC,QAAQ,EACb,KAAK,EAAC,qGAAqG,EAC3G,OAAO,EAAE,KAAK,YAEb,UAAU,GACJ,IACL,GACF,CACP,CAAC;AACJ,CAAC"}

package/dist/ui/_hooks.d.ts

@@ -0,0 +1,21 @@
+import type { RefObject } from "preact";
+/**
+ * Auto-scroll a container to the bottom when messages, tool calls,
+ * or utterances change. Returns a ref to attach to a sentinel `<div>`
+ * at the bottom of the scrollable area.
+ *
+ * @example
+ * ```tsx
+ * function MyChat() {
+ *   const bottomRef = useAutoScroll();
+ *   return (
+ *     <div class="overflow-y-auto">
+ *       {messages.map((m, i) => <p key={i}>{m.text}</p>)}
+ *       <div ref={bottomRef} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAutoScroll(): RefObject<HTMLDivElement | null>;
+//# sourceMappingURL=_hooks.d.ts.map

package/dist/ui/_hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_hooks.d.ts","sourceRoot":"","sources":["../../ui/_hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAIxC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAahE"}

package/dist/ui/_hooks.js

@@ -0,0 +1,35 @@
+// Copyright 2025 the AAI authors. MIT license.
+import { useSignalEffect } from "@preact/signals";
+import { useRef } from "preact/hooks";
+import { useSession } from "./signals.js";
+/**
+ * Auto-scroll a container to the bottom when messages, tool calls,
+ * or utterances change. Returns a ref to attach to a sentinel `<div>`
+ * at the bottom of the scrollable area.
+ *
+ * @example
+ * ```tsx
+ * function MyChat() {
+ *   const bottomRef = useAutoScroll();
+ *   return (
+ *     <div class="overflow-y-auto">
+ *       {messages.map((m, i) => <p key={i}>{m.text}</p>)}
+ *       <div ref={bottomRef} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useAutoScroll() {
+    const { session } = useSession();
+    const ref = useRef(null);
+    useSignalEffect(() => {
+        session.messages.value;
+        session.toolCalls.value;
+        session.userUtterance.value;
+        session.agentUtterance.value;
+        ref.current?.scrollIntoView({ behavior: "smooth" });
+    });
+    return ref;
+}
+//# sourceMappingURL=_hooks.js.map

package/dist/ui/_hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_hooks.js","sourceRoot":"","sources":["../../ui/_hooks.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IAEhD,eAAe,CAAC,GAAG,EAAE;QACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;QACxB,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC;QAC7B,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/ui/components.d.ts

@@ -6,6 +6,7 @@
  */
 import type { Signal } from "@preact/signals";
 import type * as preact from "preact";
+import type { ComponentChildren } from "preact";
 import type { AgentState, Message, SessionError, ToolCallInfo } from "./types.ts";
 /** Displays the current agent state as a colored indicator. */
 export declare const StateIndicator: (props: {
@@ -33,4 +34,23 @@ export declare const ThinkingIndicator: () => preact.JSX.Element;
 export declare const ChatView: () => preact.JSX.Element;
 /** Default top-level app component with start screen and chat view. */
 export declare const App: () => preact.JSX.Element;
+/** Session control buttons (Stop/Resume + New Conversation). */
+export declare const Controls: () => preact.JSX.Element;
+/** Message list with auto-scroll, tool call blocks, transcript, and thinking indicator. */
+export declare const MessageList: () => preact.JSX.Element;
+/** Centered start screen that renders children once the session starts. */
+export declare const StartScreen: (props: {
+    children: ComponentChildren;
+    icon?: ComponentChildren | undefined;
+    title?: string | undefined;
+    subtitle?: string | undefined;
+    buttonText?: string | undefined;
+}) => preact.JSX.Element;
+/** Two-column layout with a fixed-width sidebar and flexible main area. */
+export declare const SidebarLayout: (props: {
+    sidebar: ComponentChildren;
+    children: ComponentChildren;
+    width?: string | undefined;
+    side?: "left" | "right" | undefined;
+}) => preact.JSX.Element;
 //# sourceMappingURL=components.d.ts.map

package/dist/ui/components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../ui/components.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAC;AAStC,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElF,+DAA+D;AAC/D,eAAO,MAAM,cAAc,EAAE,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;CAAE,KAAK,MAAM,CAAC,GAAG,CAAC,OACjE,CAAC;AAElB,iEAAiE;AACjE,eAAO,MAAM,WAAW,EAAE,CAAC,KAAK,EAAE;IAChC,KAAK,EAAE,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CACpC,KAAK,MAAM,CAAC,GAAG,CAAC,OAAO,GAAG,IAAmB,CAAC;AAE/C,4CAA4C;AAC5C,eAAO,MAAM,aAAa,EAAE,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,KAAK,MAAM,CAAC,GAAG,CAAC,OAAwB,CAAC;AAEjG,6CAA6C;AAC7C,eAAO,MAAM,aAAa,EAAE,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE,KAAK,MAAM,CAAC,GAAG,CAAC,OAC9D,CAAC;AAEjB,qDAAqD;AACrD,eAAO,MAAM,UAAU,EAAE,CAAC,KAAK,EAAE;IAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACtC,KAAK,MAAM,CAAC,GAAG,CAAC,OAAO,GAAG,IAAkB,CAAC;AAE9C,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,OAA4B,CAAC;AAE9E,uEAAuE;AACvE,eAAO,MAAM,QAAQ,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,OAAmB,CAAC;AAE5D,uEAAuE;AACvE,eAAO,MAAM,GAAG,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,OAAc,CAAC"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../ui/components.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAahD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElF,+DAA+D;AAC/D,eAAO,MAAM,cAAc,EAAE,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;CAAE,KAAK,MAAM,CAAC,GAAG,CAAC,OACjE,CAAC;AAElB,iEAAiE;AACjE,eAAO,MAAM,WAAW,EAAE,CAAC,KAAK,EAAE;IAChC,KAAK,EAAE,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CACpC,KAAK,MAAM,CAAC,GAAG,CAAC,OAAO,GAAG,IAAmB,CAAC;AAE/C,4CAA4C;AAC5C,eAAO,MAAM,aAAa,EAAE,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,KAAK,MAAM,CAAC,GAAG,CAAC,OAAwB,CAAC;AAEjG,6CAA6C;AAC7C,eAAO,MAAM,aAAa,EAAE,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE,KAAK,MAAM,CAAC,GAAG,CAAC,OAC9D,CAAC;AAEjB,qDAAqD;AACrD,eAAO,MAAM,UAAU,EAAE,CAAC,KAAK,EAAE;IAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACtC,KAAK,MAAM,CAAC,GAAG,CAAC,OAAO,GAAG,IAAkB,CAAC;AAE9C,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,OAA4B,CAAC;AAE9E,uEAAuE;AACvE,eAAO,MAAM,QAAQ,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,OAAmB,CAAC;AAE5D,uEAAuE;AACvE,eAAO,MAAM,GAAG,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,OAAc,CAAC;AAElD,gEAAgE;AAChE,eAAO,MAAM,QAAQ,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,OAAmB,CAAC;AAE5D,2FAA2F;AAC3F,eAAO,MAAM,WAAW,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,OAAsB,CAAC;AAElE,2EAA2E;AAC3E,eAAO,MAAM,WAAW,EAAE,CAAC,KAAK,EAAE;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,KAAK,MAAM,CAAC,GAAG,CAAC,OAAsB,CAAC;AAExC,2EAA2E;AAC3E,eAAO,MAAM,aAAa,EAAE,CAAC,KAAK,EAAE;IAClC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACrC,KAAK,MAAM,CAAC,GAAG,CAAC,OAAwB,CAAC"}

package/dist/ui/components.js

@@ -7,8 +7,12 @@
  */
 import { App as _App } from "./_components/app.js";
 import { ChatView as _ChatView } from "./_components/chat_view.js";
+import { Controls as _Controls } from "./_components/controls.js";
 import { ErrorBanner as _ErrorBanner } from "./_components/error_banner.js";
 import { MessageBubble as _MessageBubble } from "./_components/message_bubble.js";
+import { MessageList as _MessageList } from "./_components/message_list.js";
+import { SidebarLayout as _SidebarLayout } from "./_components/sidebar_layout.js";
+import { StartScreen as _StartScreen } from "./_components/start_screen.js";
 import { StateIndicator as _StateIndicator } from "./_components/state_indicator.js";
 import { ThinkingIndicator as _ThinkingIndicator } from "./_components/thinking_indicator.js";
 import { ToolCallBlock as _ToolCallBlock } from "./_components/tool_call_block.js";
@@ -29,4 +33,12 @@ export const ThinkingIndicator = _ThinkingIndicator;
 export const ChatView = _ChatView;
 /** Default top-level app component with start screen and chat view. */
 export const App = _App;
+/** Session control buttons (Stop/Resume + New Conversation). */
+export const Controls = _Controls;
+/** Message list with auto-scroll, tool call blocks, transcript, and thinking indicator. */
+export const MessageList = _MessageList;
+/** Centered start screen that renders children once the session starts. */
+export const StartScreen = _StartScreen;
+/** Two-column layout with a fixed-width sidebar and flexible main area. */
+export const SidebarLayout = _SidebarLayout;
 //# sourceMappingURL=components.js.map

package/dist/ui/components.js.map

@@ -1 +1 @@
-{"version":3,"file":"components.js","sourceRoot":"","sources":["../../ui/components.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;GAKG;AAIH,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,sBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,4BAA6B,CAAC;AACpE,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,+BAAgC,CAAC;AAC7E,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,iCAAkC,CAAC;AACnF,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,kCAAmC,CAAC;AACtF,OAAO,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,MAAM,qCAAsC,CAAC;AAC/F,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,kCAAmC,CAAC;AACpF,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,6BAA8B,CAAC;AAGzE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GACzB,eAAe,CAAC;AAElB,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAEU,YAAY,CAAC;AAE/C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAwD,cAAc,CAAC;AAEjG,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GACxB,cAAc,CAAC;AAEjB,qDAAqD;AACrD,MAAM,CAAC,MAAM,UAAU,GAEW,WAAW,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAA6B,kBAAkB,CAAC;AAE9E,uEAAuE;AACvE,MAAM,CAAC,MAAM,QAAQ,GAA6B,SAAS,CAAC;AAE5D,uEAAuE;AACvE,MAAM,CAAC,MAAM,GAAG,GAA6B,IAAI,CAAC"}
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../ui/components.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;GAKG;AAKH,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,sBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,4BAA6B,CAAC;AACpE,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,2BAA4B,CAAC;AACnE,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,+BAAgC,CAAC;AAC7E,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,iCAAkC,CAAC;AACnF,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,+BAAgC,CAAC;AAC7E,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,iCAAkC,CAAC;AACnF,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,+BAAgC,CAAC;AAC7E,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,kCAAmC,CAAC;AACtF,OAAO,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,MAAM,qCAAsC,CAAC;AAC/F,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,kCAAmC,CAAC;AACpF,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,6BAA8B,CAAC;AAGzE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GACzB,eAAe,CAAC;AAElB,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAEU,YAAY,CAAC;AAE/C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAwD,cAAc,CAAC;AAEjG,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GACxB,cAAc,CAAC;AAEjB,qDAAqD;AACrD,MAAM,CAAC,MAAM,UAAU,GAEW,WAAW,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAA6B,kBAAkB,CAAC;AAE9E,uEAAuE;AACvE,MAAM,CAAC,MAAM,QAAQ,GAA6B,SAAS,CAAC;AAE5D,uEAAuE;AACvE,MAAM,CAAC,MAAM,GAAG,GAA6B,IAAI,CAAC;AAElD,gEAAgE;AAChE,MAAM,CAAC,MAAM,QAAQ,GAA6B,SAAS,CAAC;AAE5D,2FAA2F;AAC3F,MAAM,CAAC,MAAM,WAAW,GAA6B,YAAY,CAAC;AAElE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAMG,YAAY,CAAC;AAExC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,aAAa,GAKC,cAAc,CAAC"}

package/dist/ui/components_mod.d.ts

@@ -12,7 +12,8 @@
  *
  * @module
  */
-export { App, ChatView, ErrorBanner, MessageBubble, StateIndicator, ThinkingIndicator, ToolCallBlock, Transcript, } from "./components.ts";
+export { useAutoScroll } from "./_hooks.ts";
+export { App, ChatView, Controls, ErrorBanner, MessageBubble, MessageList, SidebarLayout, StartScreen, StateIndicator, ThinkingIndicator, ToolCallBlock, Transcript, } from "./components.ts";
 export type { MountHandle, MountOptions, MountTheme } from "./mount.tsx";
 export { mount } from "./mount.tsx";
 export type { MountConfig } from "./mount_context.ts";

package/dist/ui/components_mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"components_mod.d.ts","sourceRoot":"","sources":["../../ui/components_mod.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,GAAG,EACH,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC"}
+{"version":3,"file":"components_mod.d.ts","sourceRoot":"","sources":["../../ui/components_mod.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/ui/components_mod.js

@@ -13,7 +13,8 @@
  *
  * @module
  */
-export { App, ChatView, ErrorBanner, MessageBubble, StateIndicator, ThinkingIndicator, ToolCallBlock, Transcript, } from "./components.js";
+export { useAutoScroll } from "./_hooks.js";
+export { App, ChatView, Controls, ErrorBanner, MessageBubble, MessageList, SidebarLayout, StartScreen, StateIndicator, ThinkingIndicator, ToolCallBlock, Transcript, } from "./components.js";
 export { mount } from "./mount.js";
 export { useMountConfig } from "./mount_context.js";
 export { createSessionControls, SessionProvider, useSession, useToolResult, } from "./signals.js";

package/dist/ui/components_mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"components_mod.js","sourceRoot":"","sources":["../../ui/components_mod.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,GAAG,EACH,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAa,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC"}
+{"version":3,"file":"components_mod.js","sourceRoot":"","sources":["../../ui/components_mod.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAa,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/ui/mod.d.ts

@@ -16,7 +16,8 @@
  *
  * @module
  */
-export { App, ChatView, ErrorBanner, MessageBubble, StateIndicator, ThinkingIndicator, ToolCallBlock, Transcript, } from "./components.ts";
+export { useAutoScroll } from "./_hooks.ts";
+export { App, ChatView, Controls, ErrorBanner, MessageBubble, MessageList, SidebarLayout, StartScreen, StateIndicator, ThinkingIndicator, ToolCallBlock, Transcript, } from "./components.ts";
 export type { MountHandle, MountOptions, MountTheme } from "./mount.tsx";
 export { mount } from "./mount.tsx";
 export type { MountConfig } from "./mount_context.ts";

package/dist/ui/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../ui/mod.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,GAAG,EACH,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,UAAU,EACV,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../ui/mod.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,UAAU,EACV,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/ui/mod.js

@@ -17,7 +17,8 @@
  *
  * @module
  */
-export { App, ChatView, ErrorBanner, MessageBubble, StateIndicator, ThinkingIndicator, ToolCallBlock, Transcript, } from "./components.js";
+export { useAutoScroll } from "./_hooks.js";
+export { App, ChatView, Controls, ErrorBanner, MessageBubble, MessageList, SidebarLayout, StartScreen, StateIndicator, ThinkingIndicator, ToolCallBlock, Transcript, } from "./components.js";
 export { mount } from "./mount.js";
 export { useMountConfig } from "./mount_context.js";
 export { createVoiceSession } from "./session.js";

package/dist/ui/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../ui/mod.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,GAAG,EACH,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAa,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../ui/mod.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAa,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/ui/signals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../ui/signals.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,MAAM,EAAU,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,mEAAmE;IACnE,OAAO,EAAE,YAAY,CAAC;IACtB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,2DAA2D;IAC3D,OAAO,IAAI,IAAI,CAAC;IAChB,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAAC;IACd,wDAAwD;IACxD,MAAM,IAAI,IAAI,CAAC;IACf,oDAAoD;IACpD,KAAK,IAAI,IAAI,CAAC;IACd,0DAA0D;IAC1D,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAgC3E;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAI3C;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,GAC5E,IAAI,CA+BN"}
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../ui/signals.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,MAAM,EAAU,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,mEAAmE;IACnE,OAAO,EAAE,YAAY,CAAC;IACtB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,2DAA2D;IAC3D,OAAO,IAAI,IAAI,CAAC;IAChB,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAAC;IACd,wDAAwD;IACxD,MAAM,IAAI,IAAI,CAAC;IACf,oDAAoD;IACpD,KAAK,IAAI,IAAI,CAAC;IACd,0DAA0D;IAC1D,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAoC3E;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAI3C;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,GAC5E,IAAI,CA+BN"}

package/dist/ui/signals.js

@@ -32,10 +32,13 @@ export function createSessionControls(session) {
             session.connect();
         },
         toggle() {
-            if (running.value)
+            if (running.value) {
+                session.cancel();
                 session.disconnect();
-            else
+            }
+            else {
                 session.connect();
+            }
             running.value = !running.value;
         },
         reset() {

package/dist/ui/signals.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexkroman1/aai",
-  "version": "0.7.12",
+  "version": "0.8.1",
   "type": "module",
   "bin": {
     "aai": "dist/aai.js"
@@ -142,6 +142,22 @@
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"
   },
+  "peerDependencies": {
+    "@preact/signals": "^2.8.2",
+    "preact": "^10.29.0",
+    "tailwindcss": "^4.2.1"
+  },
+  "peerDependenciesMeta": {
+    "@preact/signals": {
+      "optional": true
+    },
+    "preact": {
+      "optional": true
+    },
+    "tailwindcss": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=20"
   },