@alexkroman1/aai-ui 16.1.0 → 18.0.0

package/dist/internal.js

@@ -1,8 +1,8 @@
-import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-DJQHnYjm.js";
+import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-CFhkMkmv.js";
 import { SessionProvider, ThemeProvider } from "./context.js";
-import { n as SessionUrlChips, r as UiUrlChip, t as ApiUrlChip } from "./url-chips-D62RTz7v.js";
+import { n as SessionUrlChips, r as UiUrlChip, t as ApiUrlChip } from "./url-chips-0n35fPJY.js";
 import { t as TRANSCRIBING_PLACEHOLDER } from "./use-user-transcript-uyHhzy4d.js";
 import { t as ToolConfigContext } from "./tool-config-context-Es4YUzV2.js";
-import { i as DEFAULT_PROGRESS_POLL_MS, n as MAX_MISSING_READS, t as DEFAULT_WORKFLOW_POLL_MS } from "./use-workflow-run-CNahvlgL.js";
+import { i as DEFAULT_PROGRESS_POLL_MS, n as MAX_MISSING_READS, t as DEFAULT_WORKFLOW_POLL_MS } from "./use-workflow-run-ZqJWJn2-.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-BLyPRS1Q.js → message-list-CJX560b5.js}

@@ -1,7 +1,7 @@
 import { useSessionSelector, useTheme } from "./context.js";
 import { a as inkTint, o as primaryTint } from "./_colors-CpZO-88A.js";
 import { n as useUserTranscript } from "./use-user-transcript-uyHhzy4d.js";
-import { n as ToolCallRow, t as ToolCallBlock } from "./tool-call-block-C2t_5fpp.js";
+import { n as ToolCallRow, t as ToolCallBlock } from "./tool-call-block-4gXoL_eP.js";
 import clsx from "clsx";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { StickToBottom } from "use-stick-to-bottom";

package/dist/page.d.ts

@@ -14,7 +14,13 @@
  * Authoring is otherwise identical — the file is still `client.tsx`, still
  * React, still Tailwind, still the same theme tokens — so a workflow app reads
  * like every other agent. What it reaches for instead of `useSession()` is
- * `createWorkflowApi()` / `useWorkflowRun()`.
+ * `useWorkflowSubmit()` / `useWorkflowRun()`, neither of which needs a client
+ * built for it.
+ *
+ * And `component` is OPTIONAL, the way `mountClient()`'s is: with none, this
+ * mounts the generated shell in `_page-shell.tsx`. That is also what a workflow
+ * app with NO `client.tsx` at all now gets — `default-client.tsx`, the prebuilt
+ * page, branches on the agent's declared front door and mounts this.
  */
 import { type ComponentType } from "react";
 import type { ClientTheme } from "./types.ts";
@@ -25,10 +31,17 @@ import type { ClientTheme } from "./types.ts";
  */
 export type PageConfig = {
     /**
-     * The root component. Required — a workflow app has no default shell to fall
-     * back to, because there is no session for one to render.
+     * The root component, rendered instead of the generated shell.
+     *
+     * **Optional**, the way `mountClient()`'s is: leave it out and `mountPage()`
+     * renders a form per declared workflow, the run's progress, its failure and
+     * its output — see `_page-shell.tsx` for what that shell is composed of and
+     * why it is deliberately functional rather than designed. It was REQUIRED,
+     * because "a workflow app has no default shell to fall back to" — true of a
+     * session and false of the page, and it cost the six shipped workflow
+     * templates 220-511 lines each of the same composition.
      */
-    component: ComponentType;
+    component?: ComponentType;
     /** CSS selector or DOM element to render into. Defaults to `"#app"`. */
     target?: string | HTMLElement;
     /**
@@ -53,28 +66,41 @@ export type PageHandle = {
 /**
  * Mount a page for an agent whose work happens in workflows.
  *
- * There is deliberately no session, no microphone, and no socket: the component
- * talks to the agent over the workflow HTTP API
- * (`createWorkflowApi`/`useWorkflowRun`), which is durable and outlives the tab.
+ * There is deliberately no session, no microphone, and no socket: the page talks
+ * to the agent over the workflow HTTP API (`useWorkflowSubmit`/`useWorkflowRun`),
+ * which is durable and outlives the tab.
+ *
+ * **Config only:** leave `component` out and the generated shell renders — a
+ * form per declared workflow, the run's progress, its failure, its output.
+ *
+ * **A custom component:** pass `component` and it is rendered inside the theme
+ * provider instead. The pieces the default shell is built from are all published
+ * (`useWorkflows`, `<WorkflowFields>`, `useWorkflowSubmit`,
+ * `<WorkflowProgress>`, `<WorkflowRunError>`), so replacing the shell does not
+ * mean starting from `fetch`.
  *
- * @example
+ * @example The default shell
  * ```tsx
- * import { createWorkflowApi, mountPage, useWorkflowRun } from "@alexkroman1/aai-ui";
- * import { useState } from "react";
+ * import { mountPage } from "@alexkroman1/aai-ui";
  *
- * // Hoisted: a client built in render is a new object every render.
- * const api = createWorkflowApi();
+ * mountPage({ name: "Digest" });
+ * ```
+ *
+ * @example A custom component
+ * ```tsx
+ * import { mountPage, useWorkflows } from "@alexkroman1/aai-ui";
  *
  * function App() {
- *   const [runId, setRunId] = useState<string>();
- *   const { run } = useWorkflowRun(runId, { api });
+ *   // No client to build and none to hoist: every workflow hook defaults to one
+ *   // aimed at the agent serving this page, built lazily and once.
+ *   const { workflows, loading } = useWorkflows();
+ *   if (loading) return <p>Loading…</p>;
  *   return (
- *     <button
- *       type="button"
- *       onClick={() => void api.start("digest", { topic: "ai" }).then(setRunId)}
- *     >
- *       {run ? run.status : "Start"}
- *     </button>
+ *     <ul>
+ *       {workflows.map((entry) => (
+ *         <li key={entry.name}>{entry.description ?? entry.name}</li>
+ *       ))}
+ *     </ul>
  *   );
  * }
  *
@@ -85,4 +111,4 @@ export type PageHandle = {
  *
  * @public
  */
-export declare function mountPage(config: PageConfig): PageHandle;
+export declare function mountPage(config?: PageConfig): PageHandle;