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

package/dist/vocabulary/text.js

@@ -1,49 +0,0 @@
-import { COLORS, TEXT_SIZES, WEIGHTS } from "../ir.js";
-import { toTextContent } from "./toTextContent.js";
-import { jsxs } from "react/jsx-runtime";
-import { z } from "zod";
-//#region src/vocabulary/text.tsx
-const textVocabulary = {
-	Header: {
-		description: "A section heading. Renders as a bold title.",
-		properties: z.object({
-			text: z.string().describe("The heading text."),
-			size: z.enum(TEXT_SIZES).optional().describe("Heading size; defaults to `lg`.")
-		}),
-		render: ({ text, size, children }) => /* @__PURE__ */ jsxs("h2", {
-			"data-aui": "header",
-			"data-aui-size": size ?? "lg",
-			children: [toTextContent(text), children]
-		})
-	},
-	Text: {
-		description: "A run of text. Use for paragraphs, labels, or inline copy.",
-		properties: z.object({
-			value: z.string().describe("The text content."),
-			size: z.enum(TEXT_SIZES).optional().describe("Text size; defaults to `md`."),
-			weight: z.enum(WEIGHTS).optional().describe("Font weight."),
-			color: z.enum(COLORS).optional().describe("Foreground color token.")
-		}),
-		streamProperties: true,
-		render: ({ value, size, weight, color, children }) => /* @__PURE__ */ jsxs("span", {
-			"data-aui": "text",
-			"data-aui-size": size ?? "md",
-			"data-aui-weight": weight,
-			"data-aui-color": color,
-			children: [toTextContent(value), children]
-		})
-	},
-	Caption: {
-		description: "Secondary, de-emphasized text under a primary element.",
-		properties: z.object({ value: z.string().describe("The caption text.") }),
-		streamProperties: true,
-		render: ({ value, children }) => /* @__PURE__ */ jsxs("p", {
-			"data-aui": "caption",
-			children: [toTextContent(value), children]
-		})
-	}
-};
-//#endregion
-export { textVocabulary };
-
-//# sourceMappingURL=text.js.map

package/dist/vocabulary/text.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"text.js","names":[],"sources":["../../src/vocabulary/text.tsx"],"sourcesContent":["import { z } from \"zod\";\nimport type { GenerativeUILibrary } from \"../types\";\nimport { COLORS, TEXT_SIZES, WEIGHTS } from \"../ir\";\nimport { toTextContent } from \"./toTextContent\";\n\nexport const textVocabulary = {\n  Header: {\n    description: \"A section heading. Renders as a bold title.\",\n    properties: z.object({\n      text: z.string().describe(\"The heading text.\"),\n      size: z\n        .enum(TEXT_SIZES)\n        .optional()\n        .describe(\"Heading size; defaults to `lg`.\"),\n    }),\n    render: ({ text, size, children }) => (\n      <h2 data-aui=\"header\" data-aui-size={size ?? \"lg\"}>\n        {toTextContent(text)}\n        {children}\n      </h2>\n    ),\n  },\n  Text: {\n    description: \"A run of text. Use for paragraphs, labels, or inline copy.\",\n    properties: z.object({\n      value: z.string().describe(\"The text content.\"),\n      size: z\n        .enum(TEXT_SIZES)\n        .optional()\n        .describe(\"Text size; defaults to `md`.\"),\n      weight: z.enum(WEIGHTS).optional().describe(\"Font weight.\"),\n      color: z.enum(COLORS).optional().describe(\"Foreground color token.\"),\n    }),\n    streamProperties: true,\n    render: ({ value, size, weight, color, children }) => (\n      <span\n        data-aui=\"text\"\n        data-aui-size={size ?? \"md\"}\n        data-aui-weight={weight}\n        data-aui-color={color}\n      >\n        {toTextContent(value)}\n        {children}\n      </span>\n    ),\n  },\n  Caption: {\n    description: \"Secondary, de-emphasized text under a primary element.\",\n    properties: z.object({\n      value: z.string().describe(\"The caption text.\"),\n    }),\n    streamProperties: true,\n    render: ({ value, children }) => (\n      <p data-aui=\"caption\">\n        {toTextContent(value)}\n        {children}\n      </p>\n    ),\n  },\n} satisfies GenerativeUILibrary;\n"],"mappings":";;;;;AAKA,MAAa,iBAAiB;CAC5B,QAAQ;EACN,aAAa;EACb,YAAY,EAAE,OAAO;GACnB,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,mBAAmB;GAC7C,MAAM,EACH,KAAK,UAAU,CAAC,CAChB,SAAS,CAAC,CACV,SAAS,iCAAiC;EAC/C,CAAC;EACD,SAAS,EAAE,MAAM,MAAM,eACrB,qBAAC,MAAD;GAAI,YAAS;GAAS,iBAAe,QAAQ;GAA7C,UAAA,CACG,cAAc,IAAI,GAClB,QACC;;CAER;CACA,MAAM;EACJ,aAAa;EACb,YAAY,EAAE,OAAO;GACnB,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,mBAAmB;GAC9C,MAAM,EACH,KAAK,UAAU,CAAC,CAChB,SAAS,CAAC,CACV,SAAS,8BAA8B;GAC1C,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,cAAc;GAC1D,OAAO,EAAE,KAAK,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,yBAAyB;EACrE,CAAC;EACD,kBAAkB;EAClB,SAAS,EAAE,OAAO,MAAM,QAAQ,OAAO,eACrC,qBAAC,QAAD;GACE,YAAS;GACT,iBAAe,QAAQ;GACvB,mBAAiB;GACjB,kBAAgB;GAJlB,UAAA,CAMG,cAAc,KAAK,GACnB,QACG;;CAEV;CACA,SAAS;EACP,aAAa;EACb,YAAY,EAAE,OAAO,EACnB,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,mBAAmB,EAChD,CAAC;EACD,kBAAkB;EAClB,SAAS,EAAE,OAAO,eAChB,qBAAC,KAAD;GAAG,YAAS;GAAZ,UAAA,CACG,cAAc,KAAK,GACnB,QACA;;CAEP;AACF"}

package/dist/vocabulary/toTextContent.d.ts

@@ -1,2 +0,0 @@
-export declare const toTextContent: (value: unknown) => string | number | null;
-//# sourceMappingURL=toTextContent.d.ts.map

package/dist/vocabulary/toTextContent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"toTextContent.d.ts","sourceRoot":"","sources":["../../src/vocabulary/toTextContent.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,MAAM,GAAG,IACM,CAAC"}

package/dist/vocabulary/toTextContent.js

@@ -1,6 +0,0 @@
-//#region src/vocabulary/toTextContent.ts
-const toTextContent = (value) => typeof value === "string" || typeof value === "number" ? value : null;
-//#endregion
-export { toTextContent };
-
-//# sourceMappingURL=toTextContent.js.map

package/dist/vocabulary/toTextContent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"toTextContent.js","names":[],"sources":["../../src/vocabulary/toTextContent.ts"],"sourcesContent":["export const toTextContent = (value: unknown): string | number | null =>\n  typeof value === \"string\" || typeof value === \"number\" ? value : null;\n"],"mappings":";AAAA,MAAa,iBAAiB,UAC5B,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,QAAQ"}

package/src/JSONGenerativeUI.client.tsx

@@ -1,168 +0,0 @@
-import type { ToolCallMessagePartProps } from "@assistant-ui/react";
-import { getPartialJsonObjectMeta } from "assistant-stream/utils";
-import type { ReactNode } from "react";
-import { A2uiPresentRenderer } from "./a2ui/PresentRenderer";
-import { AnsweredValuesProvider, findAnsweredValues } from "./answeredValues";
-import { buildPresentParameters } from "./buildPresentParameters";
-import {
-  presentToolBase,
-  promptUserToolBase,
-  type JSONGenerativeUIOptions,
-  type PresentParameters,
-  type PresentTool,
-  type PresentToolOptions,
-  type PromptUserTool,
-} from "./JSONGenerativeUI.shared";
-import { type ActionRegistry } from "./actionRegistry";
-import { renderGenerativeUI } from "./renderGenerativeUI";
-import type { GenerativeUILibrary, GenerativeUIStatus } from "./types";
-
-// A cancelled argument stream can leave a tool waiting with partial arguments.
-function uiStatus(
-  status: { type: string },
-  args: Record<string, unknown>,
-): GenerativeUIStatus {
-  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`.
- */
-export class JSONGenerativeUI {
-  private readonly library: GenerativeUILibrary;
-  private readonly parameters: PresentParameters;
-  private readonly actions: ActionRegistry | undefined;
-  private readonly completedPromptToolCallIds = new Set<string>();
-
-  constructor(options: JSONGenerativeUIOptions) {
-    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.
-   */
-  private readonly render = (
-    {
-      args,
-      status,
-      addResult,
-      result,
-      toolCallId,
-      artifact,
-      unstable_recordInteraction,
-      unstable_interactions,
-    }: ToolCallMessagePartProps<Record<string, unknown>, any>,
-    completesPrompt = false,
-  ): ReactNode => {
-    const answered = completesPrompt && result !== undefined;
-    const actions = this.actions;
-    const dispatch =
-      !answered && actions
-        ? (action: Parameters<ActionRegistry["dispatch"]>[0]) => {
-            if (unstable_recordInteraction) {
-              try {
-                void unstable_recordInteraction({
-                  type: "action",
-                  payload: action,
-                }).catch(() => {});
-              } catch {}
-            }
-
-            const actionResult = actions.dispatch(action);
-            if (
-              completesPrompt &&
-              actionResult !== undefined &&
-              result === undefined
-            ) {
-              void Promise.resolve(actionResult)
-                .then((response) => {
-                  if (
-                    response !== undefined &&
-                    !this.completedPromptToolCallIds.has(toolCallId)
-                  ) {
-                    this.completedPromptToolCallIds.add(toolCallId);
-                    addResult(response);
-                  }
-                })
-                .catch(() => {});
-            }
-            return actionResult;
-          }
-        : undefined;
-
-    const artifactValue =
-      artifact !== null && typeof artifact === "object"
-        ? (artifact as Record<string, unknown>)["a2ui"]
-        : undefined;
-    const surfaceId =
-      typeof toolCallId === "string" && toolCallId.startsWith("a2ui:")
-        ? toolCallId.slice("a2ui:".length)
-        : undefined;
-    const rendered =
-      surfaceId && Array.isArray(artifactValue) ? (
-        <A2uiPresentRenderer
-          key={surfaceId}
-          surfaceId={surfaceId}
-          operations={artifactValue}
-          fallback={args}
-          library={this.library}
-          status={uiStatus(status, args)}
-          {...(dispatch ? { dispatch } : {})}
-        />
-      ) : (
-        renderGenerativeUI(args, this.library, {
-          status: uiStatus(status, args),
-          ...(dispatch ? { dispatch } : {}),
-        })
-      );
-
-    return (
-      <div data-aui="root">
-        {answered ? (
-          <AnsweredValuesProvider
-            values={findAnsweredValues(unstable_interactions)}
-          >
-            <fieldset disabled data-aui="answered">
-              {rendered}
-            </fieldset>
-          </AnsweredValuesProvider>
-        ) : (
-          rendered
-        )}
-      </div>
-    );
-  };
-
-  present(options?: PresentToolOptions): PresentTool {
-    return {
-      ...presentToolBase(this.parameters, options),
-      unstable_backendDefault: { parameters: true },
-      execute: async () => ({}),
-      render: this.render,
-    };
-  }
-
-  promptUser(): PromptUserTool {
-    return {
-      ...promptUserToolBase(this.parameters),
-      unstable_backendDefault: { parameters: true },
-      render: (props) => this.render(props, true),
-    };
-  }
-}

package/src/JSONGenerativeUI.server.tsx

@@ -1,39 +0,0 @@
-import { buildPresentParameters } from "./buildPresentParameters";
-import {
-  presentToolBase,
-  promptUserToolBase,
-  type JSONGenerativeUIOptions,
-  type PresentParameters,
-  type PresentTool,
-  type PresentToolOptions,
-  type PromptUserTool,
-} from "./JSONGenerativeUI.shared";
-
-/**
- * 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 class JSONGenerativeUI {
-  private readonly parameters: PresentParameters;
-
-  constructor(options: JSONGenerativeUIOptions) {
-    this.parameters = buildPresentParameters(options.library);
-  }
-
-  present(options?: PresentToolOptions): PresentTool {
-    return presentToolBase(this.parameters, options) as PresentTool;
-  }
-
-  promptUser(): PromptUserTool {
-    return promptUserToolBase(this.parameters) as PromptUserTool;
-  }
-}

package/src/JSONGenerativeUI.shared.ts

@@ -1,90 +0,0 @@
-import type { ToolDefinition } from "@assistant-ui/react";
-import type { JSONSchema7 } from "json-schema";
-import type { ActionRegistry } from "./actionRegistry";
-import type { GenerativeUILibrary } from "./types";
-
-/** 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;
-
-const PRESENT_DESCRIPTION =
-  "Present a UI component to the user. Select a component with `$type` and " +
-  "provide its props inline; nest components with `children`.";
-
-const PROMPT_USER_DESCRIPTION =
-  "Present a UI component to the user and wait for their response. Select a " +
-  "component with `$type` and provide its props inline; nest components with " +
-  "`children`. The user interacts with it and the result is returned to you.";
-
-/** 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 function presentToolBase(
-  parameters: PresentParameters,
-  options?: PresentToolOptions,
-) {
-  return {
-    type: "frontend" as const,
-    description: PRESENT_DESCRIPTION,
-    parameters,
-    ...(options?.display !== undefined ? { display: options.display } : {}),
-  };
-}
-
-/**
- * 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 function promptUserToolBase(parameters: PresentParameters) {
-  return {
-    type: "human" as const,
-    description: PROMPT_USER_DESCRIPTION,
-    parameters,
-  };
-}