@assistant-ui/react-generative-ui 0.0.23 → 0.1.0

package/src/ir.ts

@@ -1,279 +1 @@
-/**
- * The generative-ui intermediate representation: a model-emitted, cross-platform
- * UI tree. React-free, so converters and non-web runtimes consume it without
- * pulling React. The flat `$type` shape is the canonical form; the legacy
- * `component` shape is accepted as a backward-compatible alias.
- *
- * Reserved keys are partitioned off from component props so the component prop
- * namespace stays fully free:
- *
- * - `$`-prefixed keys are framework-reserved (`$type`, `$key`, `$action`,
- *   `$status`). Components never declare `$`-prefixed props, so a component
- *   can use `type`, `status`, `variant`, etc. as ordinary props without
- *   colliding with the framework.
- * - `children` is additionally reserved (the JSX convention).
- * - every other key is an inline prop passed straight to the component.
- */
-
-import { TYPE_KEY } from "./constants";
-
-export const TEXT_SIZES = ["sm", "md", "lg", "xl", "2xl", "3xl"] as const;
-export type TextSize = (typeof TEXT_SIZES)[number];
-
-export const IMAGE_SIZE_TOKENS = ["sm", "md", "lg"] as const;
-export type ImageSize = (typeof IMAGE_SIZE_TOKENS)[number] | number;
-
-export const WEIGHTS = ["normal", "medium", "semibold", "bold"] as const;
-export type Weight = (typeof WEIGHTS)[number];
-
-export const COLORS = [
-  "emphasis",
-  "secondary",
-  "alpha-70",
-  "white",
-  "white-70",
-  "white-50",
-] as const;
-export type Color = (typeof COLORS)[number];
-
-export const ALIGNS = ["start", "center", "end"] as const;
-export type Align = (typeof ALIGNS)[number];
-
-export const JUSTIFIES = ["start", "center", "end", "between"] as const;
-export type Justify = (typeof JUSTIFIES)[number];
-
-export const BUTTON_STYLES = [
-  "primary",
-  "secondary",
-  "outline",
-  "ghost",
-  "danger",
-] as const;
-export type ButtonStyle = (typeof BUTTON_STYLES)[number];
-
-export const ALERT_TONES = ["info", "success", "warning", "danger"] as const;
-/** A severity level, from informational to destructive. */
-export type AlertTone = (typeof ALERT_TONES)[number];
-
-export const ICON_NAMES = [
-  "sun",
-  "moon",
-  "cloud",
-  "rain",
-  "snow",
-  "wind",
-  "play",
-  "pause",
-  "check",
-  "x",
-  "star",
-  "heart",
-  "arrow-right",
-  "arrow-up-right",
-  "chevron-right",
-  "calendar",
-  "clock",
-  "map-pin",
-  "plane",
-  "truck",
-  "credit-card",
-  "user",
-  "search",
-  "bell",
-] as const;
-/** A name from the built-in icon set; the closed enum lets the model see exactly which icons exist. */
-export type IconName = (typeof ICON_NAMES)[number];
-
-/**
- * Behavior payload carried by an interactive node. `type` is resolved by the host's action registry, not the renderer; keeping behavior as data keeps the tree serializable, so the same node renders on web while converters may bind the type to a native action id on other platforms. A `{ "$field": name }` value anywhere in the payload refers to the current value of the control with that `name`, resolved when the action fires, and `{ "$field": name, "fallback": value }` resolves to `fallback` when no control holds a value.
- */
-export interface Action {
-  readonly type: string;
-  readonly [payload: string]: unknown;
-}
-
-/**
- * Anything renderable as generative UI, as the model emits it. The renderer
- * also accepts `number`, `boolean`, `null`, `undefined`, and arrays at the
- * input boundary (numbers render as text, falsy/boolean as nothing, arrays as
- * lists); {@link normalizeUINode} accepts that full range.
- */
-export type UINode = string | number | UIElement | LegacyComponentNode;
-
-export type UIChildren = UINode | readonly UINode[];
-
-/** The flat node shape: inline props keep the tree compact and natural for a
- * model to emit, instead of a nested `{ type, props }` bag. Reserved keys are
- * stripped before props reach the component (see the module header). */
-export interface UIElement {
-  readonly $type: string;
-  readonly $key?: string | number;
-  readonly children?: UIChildren;
-  readonly $action?: Action;
-  readonly [prop: string]: unknown;
-}
-
-/**
- * The legacy node shape: a `component` name plus a nested `props` bag. Kept
- * for backward compatibility. New code authors the flat {@link UIElement}
- * shape instead.
- */
-export interface LegacyComponentNode {
-  readonly component: string;
-  readonly props?: Record<string, unknown>;
-  readonly children?: UIChildren;
-  readonly key?: string;
-}
-
-export type UISpec = UINode | readonly UINode[];
-
-/**
- * A node normalized to a single canonical shape: a `type` string, an inline
- * `props` bag, recursive `children`, an optional `key`, and an optional
- * `action`. Renderers and platform converters consume this form, so they never
- * branch on whether the model emitted the flat `$type` shape or the legacy
- * `component` shape, and they never see the reserved `$`-prefixed keys leak
- * into component props.
- */
-export interface NormalizedUIElement {
-  readonly type: string;
-  readonly props: Readonly<Record<string, unknown>>;
-  readonly children?: NormalizedUINode | undefined;
-  readonly key?: string | number | undefined;
-  readonly action?: Action | undefined;
-}
-
-export type NormalizedUINode =
-  | string
-  | number
-  | readonly NormalizedUINode[]
-  | NormalizedUIElement
-  | null;
-
-const isRecord = (value: unknown): value is Record<string, unknown> =>
-  typeof value === "object" && value !== null && !Array.isArray(value);
-
-type LegacyNodeRecord = { component: string } & Record<string, unknown>;
-
-const isLegacyNode = (
-  node: Record<string, unknown>,
-): node is LegacyNodeRecord => typeof node["component"] === "string";
-
-const isTypeNode = (node: Record<string, unknown>): node is UIElement =>
-  typeof node[TYPE_KEY] === "string";
-
-/** Bounds recursion so a runaway or adversarial model response cannot overflow
- * the stack; past this depth (far beyond any real UI) we stop. */
-const MAX_DEPTH = 64;
-
-/**
- * Steps a streaming partial path down into `key`. `partialPath` is the remaining
- * segment of the parse meta's partial path relative to `node` (`undefined` once
- * the walk leaves the partial frontier, i.e. everything below is complete).
- */
-function descend(
-  partialPath: readonly string[] | undefined,
-  key: string,
-): readonly string[] | undefined {
-  return partialPath?.[0] === key ? partialPath.slice(1) : undefined;
-}
-
-/**
- * Normalizes a generative-ui input to {@link NormalizedUINode}. The flat
- * `$type` shape and the legacy `component` shape both map to the same canonical
- * element, with reserved keys (`$type`, `$key`, `$action`, `children`) stripped
- * from the prop bag. A node that carries neither a `$type` nor a `component`
- * string is not renderable and resolves to `null` rather than throwing, so a
- * partially-streamed or malformed node degrades to "render nothing".
- *
- * `partialPath` carries streaming state from the tool-args parse meta: a node
- * whose `$type` is still mid-arrival is held back (resolves to `null`) until it
- * completes, and the path is threaded into `children` so a nested streaming
- * node is held back while completed siblings render. Omit it for a
- * non-streaming (converter) normalize.
- */
-export function normalizeUINode(
-  node: unknown,
-  partialPath?: readonly string[] | undefined,
-  depth = 0,
-): NormalizedUINode {
-  if (depth > MAX_DEPTH) return null;
-  if (node == null || typeof node === "boolean") return null;
-  if (typeof node === "string" || typeof node === "number") return node;
-  if (Array.isArray(node))
-    return node.map((child, index) =>
-      normalizeUINode(child, descend(partialPath, String(index)), depth + 1),
-    );
-  if (!isRecord(node)) return null;
-
-  // The flat `$type` shape is the canonical form; detect it first so a flat
-  // node that happens to use `component` as an ordinary prop is not swallowed
-  // by the legacy `component`-shape branch.
-  if (isTypeNode(node)) {
-    if (partialPath?.length === 1 && partialPath[0] === TYPE_KEY) return null;
-    const { [TYPE_KEY]: type, $key, $action, children, ...rest } = node;
-    // The `$`-prefixed namespace is framework-reserved (see the module header),
-    // so any model-supplied `$`-prefixed key is stripped from the prop bag the
-    // component sees. `$type`/`$key`/`$action` are pulled above; sweep the rest
-    // (e.g. a stray `$status`) so it never leaks to converters or components.
-    const props = stripReservedProps(rest);
-    return {
-      type,
-      props,
-      children: normalizeChildren(children, partialPath, depth),
-      key: $key,
-      action: $action,
-    };
-  }
-
-  if (isLegacyNode(node)) {
-    const props = stripReservedProps(
-      (node.props ?? {}) as Record<string, unknown>,
-    );
-    return {
-      type: node.component,
-      props,
-      children: normalizeChildren(node.children, partialPath, depth),
-      key: node.key as string | undefined,
-    };
-  }
-
-  return null;
-}
-
-function stripReservedProps(
-  props: Record<string, unknown>,
-): Record<string, unknown> {
-  let out: Record<string, unknown> | undefined;
-  for (const key of Object.keys(props)) {
-    if (key.startsWith("$")) {
-      out ??= { ...props };
-      delete out[key];
-    }
-  }
-  return out ?? props;
-}
-
-function normalizeChildren(
-  children: unknown,
-  partialPath: readonly string[] | undefined,
-  depth: number,
-): NormalizedUINode | undefined {
-  if (children === undefined) return undefined;
-  return normalizeUINode(children, descend(partialPath, "children"), depth + 1);
-}
-
-/**
- * Normalizes the root of a {@link UISpec}, preserving whether the root was a
- * single node or a list.
- */
-export function normalizeSpec(spec: UISpec): {
-  readonly root: NormalizedUINode | readonly NormalizedUINode[];
-} {
-  if (Array.isArray(spec)) {
-    return {
-      root: (spec as readonly UINode[]).map((node) => normalizeUINode(node)),
-    };
-  }
-  return { root: normalizeUINode(spec) };
-}
+export * from "@assistant-ui/generative-ui";

package/src/slack.ts

@@ -1,39 +1 @@
-export { decodeBlockAction } from "./slack/decodeBlockAction";
-export { fromSlackBlocks } from "./slack/fromSlackBlocks";
-export { toSlackBlocks } from "./slack/toSlackBlocks";
-export type {
-  FromSlackBlocksResult,
-  SlackActionElement,
-  SlackActionsBlock,
-  SlackAlertBlock,
-  SlackAlertLevel,
-  SlackBlock,
-  SlackBlocksResult,
-  SlackButtonElement,
-  SlackCardBlock,
-  SlackCarouselBlock,
-  SlackCheckboxesElement,
-  SlackContextBlock,
-  SlackConversionWarning,
-  SlackDataTableBlock,
-  SlackDataTableCell,
-  SlackDataTableRawNumberCell,
-  SlackDataTableRawTextCell,
-  SlackDatePickerElement,
-  SlackDateTimePickerElement,
-  SlackDividerBlock,
-  SlackHeaderBlock,
-  SlackImageBlock,
-  SlackInputBlock,
-  SlackMarkdownBlock,
-  SlackMrkdwnText,
-  SlackOption,
-  SlackPlainText,
-  SlackPlainTextInputElement,
-  SlackRadioButtonsElement,
-  SlackSectionBlock,
-  SlackStaticSelectElement,
-  SlackTextObject,
-  SlackTimePickerElement,
-  ToSlackBlocksOptions,
-} from "./slack/types";
+export * from "@assistant-ui/generative-ui/slack";

package/src/teams.ts

@@ -1,35 +1 @@
-export { decodeSubmitData } from "./teams/decodeSubmitData";
-export { toAdaptiveCard } from "./teams/toAdaptiveCard";
-export { toTeamsAttachments } from "./teams/toTeamsAttachments";
-export type {
-  AdaptiveCardResult,
-  TeamsAdaptiveCard,
-  TeamsActionSet,
-  TeamsAttachmentsResult,
-  TeamsCardAction,
-  TeamsCardAttachment,
-  TeamsCardElement,
-  TeamsColumn,
-  TeamsColumnSet,
-  TeamsContainer,
-  TeamsContainerStyle,
-  TeamsConversionWarning,
-  TeamsFact,
-  TeamsFactSet,
-  TeamsImage,
-  TeamsInputChoice,
-  TeamsInputChoiceSet,
-  TeamsInputDate,
-  TeamsInputText,
-  TeamsInputTime,
-  TeamsInputToggle,
-  TeamsSubmitAction,
-  TeamsSubmitData,
-  TeamsTable,
-  TeamsTableCell,
-  TeamsTableColumnDefinition,
-  TeamsTableRow,
-  TeamsTextBlock,
-  TeamsTextSize,
-  ToAdaptiveCardOptions,
-} from "./teams/types";
+export * from "@assistant-ui/generative-ui/teams";

package/dist/JSONGenerativeUI.client.d.ts

@@ -1,28 +0,0 @@
-import { type JSONGenerativeUIOptions, type PresentTool, type PresentToolOptions, type PromptUserTool } from "./JSONGenerativeUI.shared.js";
-/**
- * Client build of {@link JSONGenerativeUI}, resolved through the package's
- * `default` export condition (browser and SSR).
- *
- * `present` is a frontend tool that renders the model's `{ $type, ...props }`
- * tree against the library and resolves immediately. `prompt_user` is a
- * human-in-the-loop tool: the model pauses and the rendered UI supplies the
- * result. Both draw the tree the same way, so they share one `render`. The
- * `actions` registry (if provided) is threaded into the render context so
- * interactive components can fire `$action` through `$dispatch`.
- */
-export declare class JSONGenerativeUI {
-    private readonly library;
-    private readonly parameters;
-    private readonly actions;
-    private readonly completedPromptToolCallIds;
-    constructor(options: JSONGenerativeUIOptions);
-    /**
-     * The surface a `present` call paints into. It owns the vertical rhythm
-     * between top-level blocks, which the host's message container does not
-     * provide, and stays out of the way while it has nothing to show.
-     */
-    private readonly render;
-    present(options?: PresentToolOptions): PresentTool;
-    promptUser(): PromptUserTool;
-}
-//# sourceMappingURL=JSONGenerativeUI.client.d.ts.map

package/dist/JSONGenerativeUI.client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"JSONGenerativeUI.client.d.ts","sourceRoot":"","sources":["../src/JSONGenerativeUI.client.tsx"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,uBAAuB,EAE5B,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,qCAAkC;AAiBnC;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAqB;gBAEpD,OAAO,EAAE,uBAAuB;IAM5C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CA0FrB;IAEF,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW;IASlD,UAAU,IAAI,cAAc;CAO7B"}

package/dist/JSONGenerativeUI.client.js

@@ -1,101 +0,0 @@
-import { renderGenerativeUI } from "./renderGenerativeUI.js";
-import { A2uiPresentRenderer } from "./a2ui/PresentRenderer.js";
-import { AnsweredValuesProvider, findAnsweredValues } from "./answeredValues.js";
-import { buildPresentParameters } from "./buildPresentParameters.js";
-import { presentToolBase, promptUserToolBase } from "./JSONGenerativeUI.shared.js";
-import { getPartialJsonObjectMeta } from "assistant-stream/utils";
-import { jsx } from "react/jsx-runtime";
-//#region src/JSONGenerativeUI.client.tsx
-function uiStatus(status, args) {
-	return status.type === "complete" || status.type === "requires-action" && getPartialJsonObjectMeta(args)?.state !== "partial" ? "done" : "streaming";
-}
-/**
-* Client build of {@link JSONGenerativeUI}, resolved through the package's
-* `default` export condition (browser and SSR).
-*
-* `present` is a frontend tool that renders the model's `{ $type, ...props }`
-* tree against the library and resolves immediately. `prompt_user` is a
-* human-in-the-loop tool: the model pauses and the rendered UI supplies the
-* result. Both draw the tree the same way, so they share one `render`. The
-* `actions` registry (if provided) is threaded into the render context so
-* interactive components can fire `$action` through `$dispatch`.
-*/
-var JSONGenerativeUI = class {
-	library;
-	parameters;
-	actions;
-	completedPromptToolCallIds = /* @__PURE__ */ new Set();
-	constructor(options) {
-		this.library = options.library;
-		this.parameters = buildPresentParameters(options.library);
-		this.actions = options.actions;
-	}
-	/**
-	* The surface a `present` call paints into. It owns the vertical rhythm
-	* between top-level blocks, which the host's message container does not
-	* provide, and stays out of the way while it has nothing to show.
-	*/
-	render = ({ args, status, addResult, result, toolCallId, artifact, unstable_recordInteraction, unstable_interactions }, completesPrompt = false) => {
-		const answered = completesPrompt && result !== void 0;
-		const actions = this.actions;
-		const dispatch = !answered && actions ? (action) => {
-			if (unstable_recordInteraction) try {
-				unstable_recordInteraction({
-					type: "action",
-					payload: action
-				}).catch(() => {});
-			} catch {}
-			const actionResult = actions.dispatch(action);
-			if (completesPrompt && actionResult !== void 0 && result === void 0) Promise.resolve(actionResult).then((response) => {
-				if (response !== void 0 && !this.completedPromptToolCallIds.has(toolCallId)) {
-					this.completedPromptToolCallIds.add(toolCallId);
-					addResult(response);
-				}
-			}).catch(() => {});
-			return actionResult;
-		} : void 0;
-		const artifactValue = artifact !== null && typeof artifact === "object" ? artifact["a2ui"] : void 0;
-		const surfaceId = typeof toolCallId === "string" && toolCallId.startsWith("a2ui:") ? toolCallId.slice(5) : void 0;
-		const rendered = surfaceId && Array.isArray(artifactValue) ? /* @__PURE__ */ jsx(A2uiPresentRenderer, {
-			surfaceId,
-			operations: artifactValue,
-			fallback: args,
-			library: this.library,
-			status: uiStatus(status, args),
-			...dispatch ? { dispatch } : {}
-		}, surfaceId) : renderGenerativeUI(args, this.library, {
-			status: uiStatus(status, args),
-			...dispatch ? { dispatch } : {}
-		});
-		return /* @__PURE__ */ jsx("div", {
-			"data-aui": "root",
-			children: answered ? /* @__PURE__ */ jsx(AnsweredValuesProvider, {
-				values: findAnsweredValues(unstable_interactions),
-				children: /* @__PURE__ */ jsx("fieldset", {
-					disabled: true,
-					"data-aui": "answered",
-					children: rendered
-				})
-			}) : rendered
-		});
-	};
-	present(options) {
-		return {
-			...presentToolBase(this.parameters, options),
-			unstable_backendDefault: { parameters: true },
-			execute: async () => ({}),
-			render: this.render
-		};
-	}
-	promptUser() {
-		return {
-			...promptUserToolBase(this.parameters),
-			unstable_backendDefault: { parameters: true },
-			render: (props) => this.render(props, true)
-		};
-	}
-};
-//#endregion
-export { JSONGenerativeUI };
-
-//# sourceMappingURL=JSONGenerativeUI.client.js.map

package/dist/JSONGenerativeUI.client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"JSONGenerativeUI.client.js","names":[],"sources":["../src/JSONGenerativeUI.client.tsx"],"sourcesContent":["import type { ToolCallMessagePartProps } from \"@assistant-ui/react\";\nimport { getPartialJsonObjectMeta } from \"assistant-stream/utils\";\nimport type { ReactNode } from \"react\";\nimport { A2uiPresentRenderer } from \"./a2ui/PresentRenderer\";\nimport { AnsweredValuesProvider, findAnsweredValues } from \"./answeredValues\";\nimport { buildPresentParameters } from \"./buildPresentParameters\";\nimport {\n  presentToolBase,\n  promptUserToolBase,\n  type JSONGenerativeUIOptions,\n  type PresentParameters,\n  type PresentTool,\n  type PresentToolOptions,\n  type PromptUserTool,\n} from \"./JSONGenerativeUI.shared\";\nimport { type ActionRegistry } from \"./actionRegistry\";\nimport { renderGenerativeUI } from \"./renderGenerativeUI\";\nimport type { GenerativeUILibrary, GenerativeUIStatus } from \"./types\";\n\n// A cancelled argument stream can leave a tool waiting with partial arguments.\nfunction uiStatus(\n  status: { type: string },\n  args: Record<string, unknown>,\n): GenerativeUIStatus {\n  return status.type === \"complete\" ||\n    (status.type === \"requires-action\" &&\n      getPartialJsonObjectMeta(args)?.state !== \"partial\")\n    ? \"done\"\n    : \"streaming\";\n}\n\n/**\n * Client build of {@link JSONGenerativeUI}, resolved through the package's\n * `default` export condition (browser and SSR).\n *\n * `present` is a frontend tool that renders the model's `{ $type, ...props }`\n * tree against the library and resolves immediately. `prompt_user` is a\n * human-in-the-loop tool: the model pauses and the rendered UI supplies the\n * result. Both draw the tree the same way, so they share one `render`. The\n * `actions` registry (if provided) is threaded into the render context so\n * interactive components can fire `$action` through `$dispatch`.\n */\nexport class JSONGenerativeUI {\n  private readonly library: GenerativeUILibrary;\n  private readonly parameters: PresentParameters;\n  private readonly actions: ActionRegistry | undefined;\n  private readonly completedPromptToolCallIds = new Set<string>();\n\n  constructor(options: JSONGenerativeUIOptions) {\n    this.library = options.library;\n    this.parameters = buildPresentParameters(options.library);\n    this.actions = options.actions;\n  }\n\n  /**\n   * The surface a `present` call paints into. It owns the vertical rhythm\n   * between top-level blocks, which the host's message container does not\n   * provide, and stays out of the way while it has nothing to show.\n   */\n  private readonly render = (\n    {\n      args,\n      status,\n      addResult,\n      result,\n      toolCallId,\n      artifact,\n      unstable_recordInteraction,\n      unstable_interactions,\n    }: ToolCallMessagePartProps<Record<string, unknown>, any>,\n    completesPrompt = false,\n  ): ReactNode => {\n    const answered = completesPrompt && result !== undefined;\n    const actions = this.actions;\n    const dispatch =\n      !answered && actions\n        ? (action: Parameters<ActionRegistry[\"dispatch\"]>[0]) => {\n            if (unstable_recordInteraction) {\n              try {\n                void unstable_recordInteraction({\n                  type: \"action\",\n                  payload: action,\n                }).catch(() => {});\n              } catch {}\n            }\n\n            const actionResult = actions.dispatch(action);\n            if (\n              completesPrompt &&\n              actionResult !== undefined &&\n              result === undefined\n            ) {\n              void Promise.resolve(actionResult)\n                .then((response) => {\n                  if (\n                    response !== undefined &&\n                    !this.completedPromptToolCallIds.has(toolCallId)\n                  ) {\n                    this.completedPromptToolCallIds.add(toolCallId);\n                    addResult(response);\n                  }\n                })\n                .catch(() => {});\n            }\n            return actionResult;\n          }\n        : undefined;\n\n    const artifactValue =\n      artifact !== null && typeof artifact === \"object\"\n        ? (artifact as Record<string, unknown>)[\"a2ui\"]\n        : undefined;\n    const surfaceId =\n      typeof toolCallId === \"string\" && toolCallId.startsWith(\"a2ui:\")\n        ? toolCallId.slice(\"a2ui:\".length)\n        : undefined;\n    const rendered =\n      surfaceId && Array.isArray(artifactValue) ? (\n        <A2uiPresentRenderer\n          key={surfaceId}\n          surfaceId={surfaceId}\n          operations={artifactValue}\n          fallback={args}\n          library={this.library}\n          status={uiStatus(status, args)}\n          {...(dispatch ? { dispatch } : {})}\n        />\n      ) : (\n        renderGenerativeUI(args, this.library, {\n          status: uiStatus(status, args),\n          ...(dispatch ? { dispatch } : {}),\n        })\n      );\n\n    return (\n      <div data-aui=\"root\">\n        {answered ? (\n          <AnsweredValuesProvider\n            values={findAnsweredValues(unstable_interactions)}\n          >\n            <fieldset disabled data-aui=\"answered\">\n              {rendered}\n            </fieldset>\n          </AnsweredValuesProvider>\n        ) : (\n          rendered\n        )}\n      </div>\n    );\n  };\n\n  present(options?: PresentToolOptions): PresentTool {\n    return {\n      ...presentToolBase(this.parameters, options),\n      unstable_backendDefault: { parameters: true },\n      execute: async () => ({}),\n      render: this.render,\n    };\n  }\n\n  promptUser(): PromptUserTool {\n    return {\n      ...promptUserToolBase(this.parameters),\n      unstable_backendDefault: { parameters: true },\n      render: (props) => this.render(props, true),\n    };\n  }\n}\n"],"mappings":";;;;;;;;AAoBA,SAAS,SACP,QACA,MACoB;CACpB,OAAO,OAAO,SAAS,cACpB,OAAO,SAAS,qBACf,yBAAyB,IAAI,CAAC,EAAE,UAAU,YAC1C,SACA;AACN;;;;;;;;;;;;AAaA,IAAa,mBAAb,MAA8B;CAC5B;CACA;CACA;CACA,6CAA8C,IAAI,IAAY;CAE9D,YAAY,SAAkC;EAC5C,KAAK,UAAU,QAAQ;EACvB,KAAK,aAAa,uBAAuB,QAAQ,OAAO;EACxD,KAAK,UAAU,QAAQ;CACzB;;;;;;CAOA,UACE,EACE,MACA,QACA,WACA,QACA,YACA,UACA,4BACA,yBAEF,kBAAkB,UACJ;EACd,MAAM,WAAW,mBAAmB,WAAW,KAAA;EAC/C,MAAM,UAAU,KAAK;EACrB,MAAM,WACJ,CAAC,YAAY,WACR,WAAsD;GACrD,IAAI,4BACF,IAAI;IACF,2BAAgC;KAC9B,MAAM;KACN,SAAS;IACX,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;GACnB,QAAQ,CAAC;GAGX,MAAM,eAAe,QAAQ,SAAS,MAAM;GAC5C,IACE,mBACA,iBAAiB,KAAA,KACjB,WAAW,KAAA,GAEX,QAAa,QAAQ,YAAY,CAAC,CAC/B,MAAM,aAAa;IAClB,IACE,aAAa,KAAA,KACb,CAAC,KAAK,2BAA2B,IAAI,UAAU,GAC/C;KACA,KAAK,2BAA2B,IAAI,UAAU;KAC9C,UAAU,QAAQ;IACpB;GACF,CAAC,CAAC,CACD,YAAY,CAAC,CAAC;GAEnB,OAAO;EACT,IACA,KAAA;EAEN,MAAM,gBACJ,aAAa,QAAQ,OAAO,aAAa,WACpC,SAAqC,UACtC,KAAA;EACN,MAAM,YACJ,OAAO,eAAe,YAAY,WAAW,WAAW,OAAO,IAC3D,WAAW,MAAM,CAAc,IAC/B,KAAA;EACN,MAAM,WACJ,aAAa,MAAM,QAAQ,aAAa,IACtC,oBAAC,qBAAD;GAEa;GACX,YAAY;GACZ,UAAU;GACV,SAAS,KAAK;GACd,QAAQ,SAAS,QAAQ,IAAI;GAC7B,GAAK,WAAW,EAAE,SAAS,IAAI,CAAC;EACjC,GAPM,SAON,IAED,mBAAmB,MAAM,KAAK,SAAS;GACrC,QAAQ,SAAS,QAAQ,IAAI;GAC7B,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;EACjC,CAAC;EAGL,OACE,oBAAC,OAAD;GAAK,YAAS;GACX,UAAA,WACC,oBAAC,wBAAD;IACE,QAAQ,mBAAmB,qBAAqB;IAEhD,UAAA,oBAAC,YAAD;KAAU,UAAA;KAAS,YAAS;KACzB,UAAA;IACO,CAAA;GACY,CAAA,IAExB;EAEC,CAAA;CAET;CAEA,QAAQ,SAA2C;EACjD,OAAO;GACL,GAAG,gBAAgB,KAAK,YAAY,OAAO;GAC3C,yBAAyB,EAAE,YAAY,KAAK;GAC5C,SAAS,aAAa,CAAC;GACvB,QAAQ,KAAK;EACf;CACF;CAEA,aAA6B;EAC3B,OAAO;GACL,GAAG,mBAAmB,KAAK,UAAU;GACrC,yBAAyB,EAAE,YAAY,KAAK;GAC5C,SAAS,UAAU,KAAK,OAAO,OAAO,IAAI;EAC5C;CACF;AACF"}

package/dist/JSONGenerativeUI.server.d.ts

@@ -1,21 +0,0 @@
-import { type JSONGenerativeUIOptions, type PresentTool, type PresentToolOptions, type PromptUserTool } from "./JSONGenerativeUI.shared.js";
-/**
- * Server build of {@link JSONGenerativeUI}, resolved through the package's
- * `react-server` export condition.
- *
- * The model only needs each tool's `type`, `description`, and `parameters` on
- * the server, so `present`/`prompt_user` return exactly that — no `execute` and
- * no `render`, keeping the renderer (and React) out of the server graph. The
- * client build adds those back. The two builds share one set of public types, so
- * consumers see a single {@link JSONGenerativeUI} either way.
- *
- * `as` casts here because the tool types require a `render` for frontend/human
- * tools; on the server it is structurally absent and never read.
- */
-export declare class JSONGenerativeUI {
-    private readonly parameters;
-    constructor(options: JSONGenerativeUIOptions);
-    present(options?: PresentToolOptions): PresentTool;
-    promptUser(): PromptUserTool;
-}
-//# sourceMappingURL=JSONGenerativeUI.server.d.ts.map

package/dist/JSONGenerativeUI.server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"JSONGenerativeUI.server.d.ts","sourceRoot":"","sources":["../src/JSONGenerativeUI.server.tsx"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,uBAAuB,EAE5B,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,qCAAkC;AAEnC;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,OAAO,EAAE,uBAAuB;IAI5C,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW;IAIlD,UAAU,IAAI,cAAc;CAG7B"}

package/dist/JSONGenerativeUI.server.js

@@ -1,32 +0,0 @@
-import { buildPresentParameters } from "./buildPresentParameters.js";
-import { presentToolBase, promptUserToolBase } from "./JSONGenerativeUI.shared.js";
-//#region src/JSONGenerativeUI.server.tsx
-/**
-* Server build of {@link JSONGenerativeUI}, resolved through the package's
-* `react-server` export condition.
-*
-* The model only needs each tool's `type`, `description`, and `parameters` on
-* the server, so `present`/`prompt_user` return exactly that — no `execute` and
-* no `render`, keeping the renderer (and React) out of the server graph. The
-* client build adds those back. The two builds share one set of public types, so
-* consumers see a single {@link JSONGenerativeUI} either way.
-*
-* `as` casts here because the tool types require a `render` for frontend/human
-* tools; on the server it is structurally absent and never read.
-*/
-var JSONGenerativeUI = class {
-	parameters;
-	constructor(options) {
-		this.parameters = buildPresentParameters(options.library);
-	}
-	present(options) {
-		return presentToolBase(this.parameters, options);
-	}
-	promptUser() {
-		return promptUserToolBase(this.parameters);
-	}
-};
-//#endregion
-export { JSONGenerativeUI };
-
-//# sourceMappingURL=JSONGenerativeUI.server.js.map

package/dist/JSONGenerativeUI.server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"JSONGenerativeUI.server.js","names":[],"sources":["../src/JSONGenerativeUI.server.tsx"],"sourcesContent":["import { buildPresentParameters } from \"./buildPresentParameters\";\nimport {\n  presentToolBase,\n  promptUserToolBase,\n  type JSONGenerativeUIOptions,\n  type PresentParameters,\n  type PresentTool,\n  type PresentToolOptions,\n  type PromptUserTool,\n} from \"./JSONGenerativeUI.shared\";\n\n/**\n * Server build of {@link JSONGenerativeUI}, resolved through the package's\n * `react-server` export condition.\n *\n * The model only needs each tool's `type`, `description`, and `parameters` on\n * the server, so `present`/`prompt_user` return exactly that — no `execute` and\n * no `render`, keeping the renderer (and React) out of the server graph. The\n * client build adds those back. The two builds share one set of public types, so\n * consumers see a single {@link JSONGenerativeUI} either way.\n *\n * `as` casts here because the tool types require a `render` for frontend/human\n * tools; on the server it is structurally absent and never read.\n */\nexport class JSONGenerativeUI {\n  private readonly parameters: PresentParameters;\n\n  constructor(options: JSONGenerativeUIOptions) {\n    this.parameters = buildPresentParameters(options.library);\n  }\n\n  present(options?: PresentToolOptions): PresentTool {\n    return presentToolBase(this.parameters, options) as PresentTool;\n  }\n\n  promptUser(): PromptUserTool {\n    return promptUserToolBase(this.parameters) as PromptUserTool;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAwBA,IAAa,mBAAb,MAA8B;CAC5B;CAEA,YAAY,SAAkC;EAC5C,KAAK,aAAa,uBAAuB,QAAQ,OAAO;CAC1D;CAEA,QAAQ,SAA2C;EACjD,OAAO,gBAAgB,KAAK,YAAY,OAAO;CACjD;CAEA,aAA6B;EAC3B,OAAO,mBAAmB,KAAK,UAAU;CAC3C;AACF"}

package/dist/JSONGenerativeUI.shared.d.ts

@@ -1,63 +0,0 @@
-import type { ToolDefinition } from "@assistant-ui/react";
-import type { JSONSchema7 } from "json-schema";
-import type { ActionRegistry } from "./actionRegistry.js";
-import type { GenerativeUILibrary } from "./types.js";
-/** Options for {@link JSONGenerativeUI}. */
-export type JSONGenerativeUIOptions = {
-    /**
-     * The components the model is allowed to render, keyed by the `$type` it
-     * selects them with. Author it with `defineGenerativeComponents({ ... })` so a
-     * `"use generative"` build can split each `render` from its `properties`.
-     */
-    library: GenerativeUILibrary;
-    /**
-     * Host-provided map from `$action.type` to its handler. Interactive
-     * components (`Button`/`Select`/`Input`/`DatePicker`) call `$dispatch($action)`
-     * on their event, which resolves through this registry. Omit it for a
-     * read-only render where model-emitted actions degrade to a no-op.
-     */
-    actions?: ActionRegistry;
-};
-/** Options for {@link JSONGenerativeUI.present}. */
-export type PresentToolOptions = {
-    /**
-     * Set `"standalone"` to render the component on its own surface (outside the
-     * chain-of-thought trace), e.g. a full-bleed artifact like a card. Omit it for
-     * the default inline rendering — there is no `"inline"` value because that is
-     * already the default.
-     */
-    display?: "standalone";
-};
-type BackendDefaultMetadata = {
-    unstable_backendDefault?: {
-        parameters?: boolean;
-    };
-};
-/** The `present` tool, as the model sees it (no client `render`/`execute`). */
-export type PresentTool = ToolDefinition<Record<string, unknown>, Record<string, never>> & BackendDefaultMetadata;
-/** The `prompt_user` tool, as the model sees it (no client `render`). */
-export type PromptUserTool = ToolDefinition<Record<string, unknown>, unknown> & BackendDefaultMetadata;
-/** The tool `parameters` schema, built once per instance (see `buildPresentParameters`). */
-export type PresentParameters = JSONSchema7;
-/**
- * The schema-only half of the `present` tool, shared by both builds. The server
- * build returns exactly this; the client build adds `execute` and `render`.
- * Takes the already-built `parameters` so it isn't recomputed per tool.
- */
-export declare function presentToolBase(parameters: PresentParameters, options?: PresentToolOptions): {
-    display?: "standalone";
-    type: "frontend";
-    description: string;
-    parameters: JSONSchema7;
-};
-/**
- * The schema-only half of the `prompt_user` tool, shared by both builds. The
- * server build returns exactly this; the client build adds `render`.
- */
-export declare function promptUserToolBase(parameters: PresentParameters): {
-    type: "human";
-    description: string;
-    parameters: JSONSchema7;
-};
-export {};
-//# sourceMappingURL=JSONGenerativeUI.shared.d.ts.map

package/dist/JSONGenerativeUI.shared.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"JSONGenerativeUI.shared.d.ts","sourceRoot":"","sources":["../src/JSONGenerativeUI.shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,4BAAyB;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAgB;AAEnD,4CAA4C;AAC5C,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;OAIG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,uBAAuB,CAAC,EAAE;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,cAAc,CACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CACtB,GACC,sBAAsB,CAAC;AAEzB,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,GAC3E,sBAAsB,CAAC;AAWzB,4FAA4F;AAC5F,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,iBAAiB,EAC7B,OAAO,CAAC,EAAE,kBAAkB;;;;;EAQ7B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB;;;;EAM/D"}