@dudousxd/nestjs-agent-react 0.33.0 → 0.34.0

package/README.md

@@ -7,6 +7,13 @@ SSE, plus threads, personas, quota, cancel, and human-in-the-loop approve/reject
 turns the streamed messages into a renderable model — grouped parts, derived values, actions as state
 machines — and the chat components are one rendering of it. Optional rich-markdown subpath.
 
+## Component registries and server rendering
+
+Tools support a `present` hook in both functional and decorated class forms. Register custom components per app, share React renderers between web screens and static exports, and generate paginated PNG/PDF tables and charts for your own delivery adapters.
+
+See the [component rendering guide](../../docs/component-rendering.md) for complete examples, schemas, text fallbacks, and capture configuration.
+
+
 ## Install
 
 ```bash

package/dist/{client-B6EE8-AC.d.cts → client-BdHUuqy-.d.cts}

@@ -1,4 +1,4 @@
-import { ActionProposalMutationResult, ChatQueueState, ThreadSummary, ThreadDetail, ActionProposal, MessageAttachment, ToolCatalogEntry, SkillCatalogEntry, QuotaReport, ModelCatalogView, AgentCatalogEntry, AgentClientConfig, MessageFeedbackValue, MessageFeedback } from '@dudousxd/nestjs-agent-core';
+import { ActionProposalMutationView, ChatQueueState, ThreadSummary, ThreadDetail, ActionProposalView, MessageAttachment, ToolCatalogEntry, SkillCatalogEntry, QuotaReport, ModelCatalogView, AgentCatalogEntry, AgentClientConfig, MessageFeedbackValue, MessageFeedback } from '@dudousxd/nestjs-agent-core';
 
 /**
  * What a server said when it refused a request, read once so every error class of this package
@@ -69,7 +69,7 @@ interface ResumeStreamRequest {
 interface ChatStreamResponse {
     proposalDecision?: {
         threadId: string;
-        proposalDecision: ActionProposalMutationResult | {
+        proposalDecision: ActionProposalMutationView | {
             status: 'ambiguous';
             proposalIds: string[];
         };
@@ -199,17 +199,17 @@ interface AgentBackend {
     truncateFromMessage?(threadId: string, messageId: string): Promise<unknown>;
     listActionProposals?(input: {
         threadId: string;
-    }): Promise<ActionProposal[]>;
+    }): Promise<ActionProposalView[]>;
     approveActionProposal?(input: {
         threadId: string;
         proposalId: string;
         remember?: boolean;
-    }): Promise<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     rejectActionProposal?(input: {
         threadId: string;
         proposalId: string;
         reason?: string;
-    }): Promise<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     approveToolCall?(input: {
         toolCallId: string;
         remember?: boolean;
@@ -415,17 +415,17 @@ declare class AgentClient implements AgentBackend {
      */
     listActionProposals({ threadId }: {
         threadId: string;
-    }): Promise<ActionProposal[]>;
+    }): Promise<ActionProposalView[]>;
     approveActionProposal({ threadId, proposalId, remember, }: {
         threadId: string;
         proposalId: string;
         remember?: boolean;
-    }): Promise<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     rejectActionProposal({ threadId, proposalId, reason, }: {
         threadId: string;
         proposalId: string;
         reason?: string;
-    }): Promise<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     approveToolCall(input: {
         toolCallId: string;
         remember?: boolean;

package/dist/{client-B6EE8-AC.d.ts → client-BdHUuqy-.d.ts}

@@ -1,4 +1,4 @@
-import { ActionProposalMutationResult, ChatQueueState, ThreadSummary, ThreadDetail, ActionProposal, MessageAttachment, ToolCatalogEntry, SkillCatalogEntry, QuotaReport, ModelCatalogView, AgentCatalogEntry, AgentClientConfig, MessageFeedbackValue, MessageFeedback } from '@dudousxd/nestjs-agent-core';
+import { ActionProposalMutationView, ChatQueueState, ThreadSummary, ThreadDetail, ActionProposalView, MessageAttachment, ToolCatalogEntry, SkillCatalogEntry, QuotaReport, ModelCatalogView, AgentCatalogEntry, AgentClientConfig, MessageFeedbackValue, MessageFeedback } from '@dudousxd/nestjs-agent-core';
 
 /**
  * What a server said when it refused a request, read once so every error class of this package
@@ -69,7 +69,7 @@ interface ResumeStreamRequest {
 interface ChatStreamResponse {
     proposalDecision?: {
         threadId: string;
-        proposalDecision: ActionProposalMutationResult | {
+        proposalDecision: ActionProposalMutationView | {
             status: 'ambiguous';
             proposalIds: string[];
         };
@@ -199,17 +199,17 @@ interface AgentBackend {
     truncateFromMessage?(threadId: string, messageId: string): Promise<unknown>;
     listActionProposals?(input: {
         threadId: string;
-    }): Promise<ActionProposal[]>;
+    }): Promise<ActionProposalView[]>;
     approveActionProposal?(input: {
         threadId: string;
         proposalId: string;
         remember?: boolean;
-    }): Promise<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     rejectActionProposal?(input: {
         threadId: string;
         proposalId: string;
         reason?: string;
-    }): Promise<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     approveToolCall?(input: {
         toolCallId: string;
         remember?: boolean;
@@ -415,17 +415,17 @@ declare class AgentClient implements AgentBackend {
      */
     listActionProposals({ threadId }: {
         threadId: string;
-    }): Promise<ActionProposal[]>;
+    }): Promise<ActionProposalView[]>;
     approveActionProposal({ threadId, proposalId, remember, }: {
         threadId: string;
         proposalId: string;
         remember?: boolean;
-    }): Promise<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     rejectActionProposal({ threadId, proposalId, reason, }: {
         threadId: string;
         proposalId: string;
         reason?: string;
-    }): Promise<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     approveToolCall(input: {
         toolCallId: string;
         remember?: boolean;

package/dist/{generative-ui-DOe2RsoO.d.cts → generative-ui-CyHY8Lh1.d.cts}

@@ -1,7 +1,8 @@
 import * as React from 'react';
-import { ComponentType, ReactNode } from 'react';
-import { ActionProposal, StoredMessage, ElicitationQuestion, ElicitationInputType, ToolPresentation, ToolCatalogEntry, ToolResultField, ToolResultView, ToolPresentationTone, ToolConfirmation, ElicitationInput } from '@dudousxd/nestjs-agent-core';
+import { ReactNode } from 'react';
+import { ActionProposalView, StoredMessage, ElicitationQuestion, ElicitationInputType, ToolPresentation, ToolCatalogEntry, ToolResultField, ToolResultView, ToolPresentationTone, ToolConfirmation, ElicitationInput } from '@dudousxd/nestjs-agent-core';
 import { UIMessage, ToolUIPart, DynamicToolUIPart } from 'ai';
+import { c as GenerativeUIOptions, G as GenerativeUIItem, d as GenerativeUIProblem, b as GenerativeUIElement, e as GenerativeUIState } from './types-DZtFsWec.cjs';
 
 type ApprovalTarget = {
     kind: 'legacy';
@@ -11,9 +12,9 @@ type ApprovalTarget = {
     proposalId: string;
     threadId?: string;
 };
-declare function proposalNeedsPolling(proposal: ActionProposal): boolean;
+declare function proposalNeedsPolling(proposal: ActionProposalView): boolean;
 /** Patch proposal metadata and append outcome facts; never replace live text with stored rows. */
-declare function reconcileProposalMessages(current: UIMessage[], proposals: ActionProposal[], facts: StoredMessage[]): UIMessage[];
+declare function reconcileProposalMessages(current: UIMessage[], proposals: ActionProposalView[], facts: StoredMessage[]): UIMessage[];
 
 /** What a form control can hand over: a field's value, a checkbox's state, a picked date, a list. */
 type RawAnswer = string | number | boolean | Date | null | undefined | readonly RawAnswer[];
@@ -595,102 +596,6 @@ declare function describeTimestamp(createdAt: string | null | undefined): Timest
  */
 declare function formatRelativeTime(date: Date): string;
 
-/** The `ui` frame component a composed tree is pushed under (`GENUI_TREE_COMPONENT` of `@dudousxd/nestjs-agent-core/genui`). */
-declare const GENUI_TREE_COMPONENT = "genui:tree";
-/** One pushed component, normalized from whatever carried it (a transcript block, a `data-ui` part, a stored entry). */
-interface GenerativeUIItem {
-    fallbackText?: string;
-    componentVersions?: Record<string, number>;
-    id: string;
-    component: string;
-    props: Record<string, unknown>;
-    version: number | null;
-    toolCallId: string | null;
-}
-/** A node of a composed tree (`genui:tree` frames): `{ type, props, children? }`. */
-interface GenerativeUIElement {
-    type: string;
-    props: Record<string, unknown>;
-    children?: GenerativeUIElement[];
-}
-/**
- * An app's renderer for one component: it receives the component's props spread, plus `children`
- * when it is a layout node in a tree. Any React component — the library never styles anything.
- */
-type GenuiRenderer<P = any> = ComponentType<P & {
-    children?: ReactNode;
-}>;
-/** Component name → the app's renderer. */
-type GenuiRegistry = Record<string, GenuiRenderer>;
-/**
- * Resolve a component the registry does not have — typically a tenant's own component, fetched for
- * the exact `version` a message was rendered with. Return `null`/`undefined` for "no such
- * component". May be async; results are cached per resolver, name and version.
- */
-type ResolveComponent = (name: string, version: number | null) => GenuiRenderer | null | undefined | Promise<GenuiRenderer | null | undefined>;
-interface GenuiIssueLike {
-    path: (string | number)[];
-    message: string;
-}
-type ValidationLike = {
-    ok: true;
-    value: Record<string, unknown>;
-} | {
-    ok: false;
-    issues: GenuiIssueLike[];
-};
-/**
- * What the renderer needs from a catalog to validate props before drawing them. A `Catalog` from
- * `@dudousxd/nestjs-agent-core/genui` satisfies it; declared structurally so any catalog-shaped
- * object does too.
- */
-interface GenuiCatalogLike {
-    get?(name: string): {
-        version?: number;
-    } | undefined;
-    has(name: string): boolean;
-    validate(name: string, props: unknown): Promise<ValidationLike>;
-    validateSync?(name: string, props: unknown): ValidationLike | undefined;
-}
-interface GenerativeUIOptions {
-    registry: GenuiRegistry;
-    /** Validate props against it before rendering. Components the catalog does not know render unvalidated. */
-    catalog?: GenuiCatalogLike;
-    resolveComponent?: ResolveComponent;
-    /**
-     * Draws a composed tree frame (`genui:tree`) whole — e.g. through json-render (see the
-     * `/genui/json-render` subpath's `GenuiProvider`). Omitted → trees render node by node through
-     * `registry`.
-     */
-    treeRenderer?: GenuiRenderer<{
-        root?: GenerativeUIElement;
-    }>;
-}
-/** Why an item did not render. */
-type GenerativeUIProblem = {
-    reason: 'unknown';
-    item: GenerativeUIItem;
-} | {
-    reason: 'invalid';
-    item: GenerativeUIItem;
-    issues: GenuiIssueLike[];
-} | {
-    reason: 'error';
-    item: GenerativeUIItem;
-    error: unknown;
-};
-type GenerativeUIState = {
-    status: 'ready';
-    item: GenerativeUIItem;
-    Component: GenuiRenderer;
-    props: Record<string, unknown>;
-} | {
-    status: 'loading';
-    item: GenerativeUIItem;
-} | ({
-    status: 'problem';
-} & GenerativeUIProblem);
-
 /** What to draw instead of a component that did not render. Default: nothing. */
 type GenerativeUIFallback = ReactNode | ((problem: GenerativeUIProblem) => ReactNode);
 /**
@@ -764,4 +669,4 @@ interface GenerativeUIProps extends Partial<GenerativeUIOptions> {
  */
 declare function GenerativeUI({ part, registry, catalog, resolveComponent, treeRenderer, fallback: ownFallback, loading: ownLoading, onError: ownOnError, }: GenerativeUIProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
 
-export { type TranscriptQuestion as $, type ApproveOptions as A, type ApprovalBlockOptions as B, type ChatStatus as C, type BuildBlocksOptions as D, type CoercibleQuestion as E, type DescribeToolCallOptions as F, type GenerativeUIItem as G, type ElicitationBlockOptions as H, type GroupToolActivityOptions as I, type RawAnswer as J, type ResolvedReading as K, type ResolvedResultView as L, type MessageUsageInfo as M, type RetrievedPassage as N, type ToolActivityGroup as O, type ToolCallDescription as P, type ToolCallState as Q, type ResolveComponent as R, type SettleAction as S, type TranscriptUiBlock as T, type UsageSummary as U, type ToolCallStatus as V, type TranscriptApproval as W, type TranscriptApprovalStatus as X, type TranscriptElicitationBlock as Y, type TranscriptElicitationOutcome as Z, type TranscriptFilesBlock as _, GENUI_TREE_COMPONENT as a, type TranscriptQuestionOption as a0, type TranscriptReasoningBlock as a1, type TranscriptSettleState as a2, type TranscriptSource as a3, type TranscriptSourcesBlock as a4, type TranscriptTextBlock as a5, type TranscriptToolBlock as a6, type TranscriptToolCall as a7, buildTranscriptBlocks as a8, coerceAnswer as a9, correctedCallIds as aa, describeTimestamp as ab, describeToolCall as ac, describeUsage as ad, extractMessageText as ae, fillTemplate as af, formatRelativeTime as ag, groupToolActivity as ah, inferResultView as ai, isActionCall as aj, phraseFor as ak, proposalNeedsPolling as al, readPath as am, reconcileProposalMessages as an, resolveResultView as ao, toolCallState as ap, toolCatalogFrom as aq, GenerativeUI as b, type GenerativeUIElement as c, type GenerativeUIFallback as d, type GenerativeUIOptions as e, type GenerativeUIProblem as f, type GenerativeUIProps as g, GenerativeUIScope as h, type GenerativeUIScopeProps as i, type GenerativeUIState as j, type GenuiCatalogLike as k, type GenuiIssueLike as l, GenuiProvider as m, type GenuiProviderProps as n, type GenuiProviderValue as o, type GenuiRegistry as p, type GenuiRenderer as q, GenuiTree as r, useGenuiProvider as s, type ApprovalTarget as t, useGenerativeUI as u, type TranscriptBlock as v, type TimestampInfo as w, type TranscriptFile as x, type ToolCatalog as y, type AnyToolUIPart as z };
+export { correctedCallIds as $, type ApproveOptions as A, type BuildBlocksOptions as B, type ChatStatus as C, type DescribeToolCallOptions as D, type ElicitationBlockOptions as E, type TranscriptApproval as F, GenerativeUI as G, type TranscriptApprovalStatus as H, type TranscriptElicitationBlock as I, type TranscriptElicitationOutcome as J, type TranscriptFilesBlock as K, type TranscriptQuestion as L, type MessageUsageInfo as M, type TranscriptQuestionOption as N, type TranscriptReasoningBlock as O, type TranscriptSettleState as P, type TranscriptSource as Q, type RawAnswer as R, type SettleAction as S, type TranscriptUiBlock as T, type UsageSummary as U, type TranscriptSourcesBlock as V, type TranscriptTextBlock as W, type TranscriptToolBlock as X, type TranscriptToolCall as Y, buildTranscriptBlocks as Z, coerceAnswer as _, type GenerativeUIFallback as a, describeTimestamp as a0, describeToolCall as a1, describeUsage as a2, extractMessageText as a3, fillTemplate as a4, formatRelativeTime as a5, groupToolActivity as a6, inferResultView as a7, isActionCall as a8, phraseFor as a9, proposalNeedsPolling as aa, readPath as ab, reconcileProposalMessages as ac, resolveResultView as ad, toolCallState as ae, toolCatalogFrom as af, type GenerativeUIProps as b, GenerativeUIScope as c, type GenerativeUIScopeProps as d, GenuiProvider as e, type GenuiProviderProps as f, type GenuiProviderValue as g, GenuiTree as h, useGenuiProvider as i, type ApprovalTarget as j, type TranscriptBlock as k, type TimestampInfo as l, type TranscriptFile as m, type ToolCatalog as n, type AnyToolUIPart as o, type ApprovalBlockOptions as p, type CoercibleQuestion as q, type GroupToolActivityOptions as r, type ResolvedReading as s, type ResolvedResultView as t, useGenerativeUI as u, type RetrievedPassage as v, type ToolActivityGroup as w, type ToolCallDescription as x, type ToolCallState as y, type ToolCallStatus as z };

package/dist/{generative-ui-DOe2RsoO.d.ts → generative-ui-DdUZPCXX.d.ts}

@@ -1,7 +1,8 @@
 import * as React from 'react';
-import { ComponentType, ReactNode } from 'react';
-import { ActionProposal, StoredMessage, ElicitationQuestion, ElicitationInputType, ToolPresentation, ToolCatalogEntry, ToolResultField, ToolResultView, ToolPresentationTone, ToolConfirmation, ElicitationInput } from '@dudousxd/nestjs-agent-core';
+import { ReactNode } from 'react';
+import { ActionProposalView, StoredMessage, ElicitationQuestion, ElicitationInputType, ToolPresentation, ToolCatalogEntry, ToolResultField, ToolResultView, ToolPresentationTone, ToolConfirmation, ElicitationInput } from '@dudousxd/nestjs-agent-core';
 import { UIMessage, ToolUIPart, DynamicToolUIPart } from 'ai';
+import { c as GenerativeUIOptions, G as GenerativeUIItem, d as GenerativeUIProblem, b as GenerativeUIElement, e as GenerativeUIState } from './types-DZtFsWec.js';
 
 type ApprovalTarget = {
     kind: 'legacy';
@@ -11,9 +12,9 @@ type ApprovalTarget = {
     proposalId: string;
     threadId?: string;
 };
-declare function proposalNeedsPolling(proposal: ActionProposal): boolean;
+declare function proposalNeedsPolling(proposal: ActionProposalView): boolean;
 /** Patch proposal metadata and append outcome facts; never replace live text with stored rows. */
-declare function reconcileProposalMessages(current: UIMessage[], proposals: ActionProposal[], facts: StoredMessage[]): UIMessage[];
+declare function reconcileProposalMessages(current: UIMessage[], proposals: ActionProposalView[], facts: StoredMessage[]): UIMessage[];
 
 /** What a form control can hand over: a field's value, a checkbox's state, a picked date, a list. */
 type RawAnswer = string | number | boolean | Date | null | undefined | readonly RawAnswer[];
@@ -595,102 +596,6 @@ declare function describeTimestamp(createdAt: string | null | undefined): Timest
  */
 declare function formatRelativeTime(date: Date): string;
 
-/** The `ui` frame component a composed tree is pushed under (`GENUI_TREE_COMPONENT` of `@dudousxd/nestjs-agent-core/genui`). */
-declare const GENUI_TREE_COMPONENT = "genui:tree";
-/** One pushed component, normalized from whatever carried it (a transcript block, a `data-ui` part, a stored entry). */
-interface GenerativeUIItem {
-    fallbackText?: string;
-    componentVersions?: Record<string, number>;
-    id: string;
-    component: string;
-    props: Record<string, unknown>;
-    version: number | null;
-    toolCallId: string | null;
-}
-/** A node of a composed tree (`genui:tree` frames): `{ type, props, children? }`. */
-interface GenerativeUIElement {
-    type: string;
-    props: Record<string, unknown>;
-    children?: GenerativeUIElement[];
-}
-/**
- * An app's renderer for one component: it receives the component's props spread, plus `children`
- * when it is a layout node in a tree. Any React component — the library never styles anything.
- */
-type GenuiRenderer<P = any> = ComponentType<P & {
-    children?: ReactNode;
-}>;
-/** Component name → the app's renderer. */
-type GenuiRegistry = Record<string, GenuiRenderer>;
-/**
- * Resolve a component the registry does not have — typically a tenant's own component, fetched for
- * the exact `version` a message was rendered with. Return `null`/`undefined` for "no such
- * component". May be async; results are cached per resolver, name and version.
- */
-type ResolveComponent = (name: string, version: number | null) => GenuiRenderer | null | undefined | Promise<GenuiRenderer | null | undefined>;
-interface GenuiIssueLike {
-    path: (string | number)[];
-    message: string;
-}
-type ValidationLike = {
-    ok: true;
-    value: Record<string, unknown>;
-} | {
-    ok: false;
-    issues: GenuiIssueLike[];
-};
-/**
- * What the renderer needs from a catalog to validate props before drawing them. A `Catalog` from
- * `@dudousxd/nestjs-agent-core/genui` satisfies it; declared structurally so any catalog-shaped
- * object does too.
- */
-interface GenuiCatalogLike {
-    get?(name: string): {
-        version?: number;
-    } | undefined;
-    has(name: string): boolean;
-    validate(name: string, props: unknown): Promise<ValidationLike>;
-    validateSync?(name: string, props: unknown): ValidationLike | undefined;
-}
-interface GenerativeUIOptions {
-    registry: GenuiRegistry;
-    /** Validate props against it before rendering. Components the catalog does not know render unvalidated. */
-    catalog?: GenuiCatalogLike;
-    resolveComponent?: ResolveComponent;
-    /**
-     * Draws a composed tree frame (`genui:tree`) whole — e.g. through json-render (see the
-     * `/genui/json-render` subpath's `GenuiProvider`). Omitted → trees render node by node through
-     * `registry`.
-     */
-    treeRenderer?: GenuiRenderer<{
-        root?: GenerativeUIElement;
-    }>;
-}
-/** Why an item did not render. */
-type GenerativeUIProblem = {
-    reason: 'unknown';
-    item: GenerativeUIItem;
-} | {
-    reason: 'invalid';
-    item: GenerativeUIItem;
-    issues: GenuiIssueLike[];
-} | {
-    reason: 'error';
-    item: GenerativeUIItem;
-    error: unknown;
-};
-type GenerativeUIState = {
-    status: 'ready';
-    item: GenerativeUIItem;
-    Component: GenuiRenderer;
-    props: Record<string, unknown>;
-} | {
-    status: 'loading';
-    item: GenerativeUIItem;
-} | ({
-    status: 'problem';
-} & GenerativeUIProblem);
-
 /** What to draw instead of a component that did not render. Default: nothing. */
 type GenerativeUIFallback = ReactNode | ((problem: GenerativeUIProblem) => ReactNode);
 /**
@@ -764,4 +669,4 @@ interface GenerativeUIProps extends Partial<GenerativeUIOptions> {
  */
 declare function GenerativeUI({ part, registry, catalog, resolveComponent, treeRenderer, fallback: ownFallback, loading: ownLoading, onError: ownOnError, }: GenerativeUIProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
 
-export { type TranscriptQuestion as $, type ApproveOptions as A, type ApprovalBlockOptions as B, type ChatStatus as C, type BuildBlocksOptions as D, type CoercibleQuestion as E, type DescribeToolCallOptions as F, type GenerativeUIItem as G, type ElicitationBlockOptions as H, type GroupToolActivityOptions as I, type RawAnswer as J, type ResolvedReading as K, type ResolvedResultView as L, type MessageUsageInfo as M, type RetrievedPassage as N, type ToolActivityGroup as O, type ToolCallDescription as P, type ToolCallState as Q, type ResolveComponent as R, type SettleAction as S, type TranscriptUiBlock as T, type UsageSummary as U, type ToolCallStatus as V, type TranscriptApproval as W, type TranscriptApprovalStatus as X, type TranscriptElicitationBlock as Y, type TranscriptElicitationOutcome as Z, type TranscriptFilesBlock as _, GENUI_TREE_COMPONENT as a, type TranscriptQuestionOption as a0, type TranscriptReasoningBlock as a1, type TranscriptSettleState as a2, type TranscriptSource as a3, type TranscriptSourcesBlock as a4, type TranscriptTextBlock as a5, type TranscriptToolBlock as a6, type TranscriptToolCall as a7, buildTranscriptBlocks as a8, coerceAnswer as a9, correctedCallIds as aa, describeTimestamp as ab, describeToolCall as ac, describeUsage as ad, extractMessageText as ae, fillTemplate as af, formatRelativeTime as ag, groupToolActivity as ah, inferResultView as ai, isActionCall as aj, phraseFor as ak, proposalNeedsPolling as al, readPath as am, reconcileProposalMessages as an, resolveResultView as ao, toolCallState as ap, toolCatalogFrom as aq, GenerativeUI as b, type GenerativeUIElement as c, type GenerativeUIFallback as d, type GenerativeUIOptions as e, type GenerativeUIProblem as f, type GenerativeUIProps as g, GenerativeUIScope as h, type GenerativeUIScopeProps as i, type GenerativeUIState as j, type GenuiCatalogLike as k, type GenuiIssueLike as l, GenuiProvider as m, type GenuiProviderProps as n, type GenuiProviderValue as o, type GenuiRegistry as p, type GenuiRenderer as q, GenuiTree as r, useGenuiProvider as s, type ApprovalTarget as t, useGenerativeUI as u, type TranscriptBlock as v, type TimestampInfo as w, type TranscriptFile as x, type ToolCatalog as y, type AnyToolUIPart as z };
+export { correctedCallIds as $, type ApproveOptions as A, type BuildBlocksOptions as B, type ChatStatus as C, type DescribeToolCallOptions as D, type ElicitationBlockOptions as E, type TranscriptApproval as F, GenerativeUI as G, type TranscriptApprovalStatus as H, type TranscriptElicitationBlock as I, type TranscriptElicitationOutcome as J, type TranscriptFilesBlock as K, type TranscriptQuestion as L, type MessageUsageInfo as M, type TranscriptQuestionOption as N, type TranscriptReasoningBlock as O, type TranscriptSettleState as P, type TranscriptSource as Q, type RawAnswer as R, type SettleAction as S, type TranscriptUiBlock as T, type UsageSummary as U, type TranscriptSourcesBlock as V, type TranscriptTextBlock as W, type TranscriptToolBlock as X, type TranscriptToolCall as Y, buildTranscriptBlocks as Z, coerceAnswer as _, type GenerativeUIFallback as a, describeTimestamp as a0, describeToolCall as a1, describeUsage as a2, extractMessageText as a3, fillTemplate as a4, formatRelativeTime as a5, groupToolActivity as a6, inferResultView as a7, isActionCall as a8, phraseFor as a9, proposalNeedsPolling as aa, readPath as ab, reconcileProposalMessages as ac, resolveResultView as ad, toolCallState as ae, toolCatalogFrom as af, type GenerativeUIProps as b, GenerativeUIScope as c, type GenerativeUIScopeProps as d, GenuiProvider as e, type GenuiProviderProps as f, type GenuiProviderValue as g, GenuiTree as h, useGenuiProvider as i, type ApprovalTarget as j, type TranscriptBlock as k, type TimestampInfo as l, type TranscriptFile as m, type ToolCatalog as n, type AnyToolUIPart as o, type ApprovalBlockOptions as p, type CoercibleQuestion as q, type GroupToolActivityOptions as r, type ResolvedReading as s, type ResolvedResultView as t, useGenerativeUI as u, type RetrievedPassage as v, type ToolActivityGroup as w, type ToolCallDescription as x, type ToolCallState as y, type ToolCallStatus as z };

package/dist/genui-json-render.d.cts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { ComponentRegistry } from '@json-render/react';
-import { n as GenuiProviderProps$1, c as GenerativeUIElement, q as GenuiRenderer, p as GenuiRegistry } from './generative-ui-DOe2RsoO.cjs';
+import { f as GenuiProviderProps$1 } from './generative-ui-CyHY8Lh1.cjs';
+import { b as GenerativeUIElement, i as GenuiRenderer, h as GenuiRegistry } from './types-DZtFsWec.cjs';
 import '@dudousxd/nestjs-agent-core';
 import 'ai';
 

package/dist/genui-json-render.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { ComponentRegistry } from '@json-render/react';
-import { n as GenuiProviderProps$1, c as GenerativeUIElement, q as GenuiRenderer, p as GenuiRegistry } from './generative-ui-DOe2RsoO.js';
+import { f as GenuiProviderProps$1 } from './generative-ui-DdUZPCXX.js';
+import { b as GenerativeUIElement, i as GenuiRenderer, h as GenuiRegistry } from './types-DZtFsWec.js';
 import '@dudousxd/nestjs-agent-core';
 import 'ai';
 

package/dist/genui-server-playwright.cjs

@@ -0,0 +1,199 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/genui/playwright.ts
+var playwright_exports = {};
+__export(playwright_exports, {
+  createPlaywrightCaptureAdapter: () => createPlaywrightCaptureAdapter
+});
+module.exports = __toCommonJS(playwright_exports);
+
+// src/genui/server.ts
+var import_promises = require("fs/promises");
+var import_react = require("react");
+var import_server = require("react-dom/server");
+function boundedCaptureOptions(options) {
+  const result = {
+    width: options.width ?? 1200,
+    height: options.height ?? 1600,
+    timeoutMs: options.timeoutMs ?? 15e3
+  };
+  for (const [key, value, min, max] of [
+    ["width", result.width, 320, 4096],
+    ["height", result.height, 200, 16384],
+    ["timeoutMs", result.timeoutMs, 100, 6e4]
+  ]) {
+    if (!Number.isInteger(value) || value < min || value > max)
+      throw new RangeError(`genui: ${key} must be ${min}\u2013${max}`);
+  }
+  return result;
+}
+
+// src/genui/playwright.ts
+function createPlaywrightCaptureAdapter(options = {}) {
+  async function withPage(settings, operation) {
+    const limits = boundedCaptureOptions(settings);
+    const browser = options.browser ?? await (await import("playwright-core")).chromium.launch(options.launchOptions);
+    try {
+      const context = await browser.newContext({
+        javaScriptEnabled: false,
+        serviceWorkers: "block",
+        viewport: { width: limits.width, height: limits.height }
+      });
+      try {
+        const page = await context.newPage();
+        try {
+          page.setDefaultTimeout(limits.timeoutMs);
+          await context.route("**/*", async (route) => {
+            try {
+              if (!options.allowAsset?.(route.request().url())) {
+                await route.abort();
+                return;
+              }
+              const response = await route.fetch({ maxRedirects: 0, timeout: limits.timeoutMs });
+              try {
+                if (response.status() >= 300 && response.status() < 400) {
+                  await route.abort();
+                } else {
+                  await route.fulfill({ response });
+                }
+              } finally {
+                await response.dispose();
+              }
+            } catch {
+              await route.abort();
+            }
+          });
+          let timer;
+          try {
+            return await Promise.race([
+              operation(page, limits),
+              new Promise((_, reject) => {
+                timer = setTimeout(
+                  () => reject(new Error("genui: capture timed out")),
+                  limits.timeoutMs
+                );
+              })
+            ]);
+          } finally {
+            clearTimeout(timer);
+          }
+        } finally {
+          await page.close();
+        }
+      } finally {
+        await context.close();
+      }
+    } finally {
+      if (!options.browser) await browser.close();
+    }
+  }
+  function checkPages(html) {
+    if (!html.length || html.length > 100)
+      throw new RangeError("genui: capture requires 1\u2013100 pages");
+  }
+  async function ready(page, html, limits) {
+    await page.setContent(html, { waitUntil: "load", timeout: limits.timeoutMs });
+    await page.evaluate(async (timeoutMs) => {
+      let timer;
+      try {
+        await Promise.race([
+          Promise.all([
+            document.fonts.ready,
+            ...Array.from(
+              document.images,
+              (image) => image.complete ? Promise.resolve() : new Promise((resolve) => {
+                image.addEventListener("load", () => resolve(), { once: true });
+                image.addEventListener("error", () => resolve(), { once: true });
+              })
+            )
+          ]),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("genui: assets timed out")), timeoutMs);
+          })
+        ]);
+      } finally {
+        clearTimeout(timer);
+      }
+    }, limits.timeoutMs);
+    const height = await page.evaluate(
+      () => Math.max(document.body.scrollHeight, document.documentElement.scrollHeight)
+    );
+    if (height > limits.height)
+      throw new RangeError(
+        "genui: content exceeds capture height; reduce rowsPerPage or paginate the component"
+      );
+  }
+  return {
+    async images(html, settings) {
+      checkPages(html);
+      return withPage(settings, async (page, limits) => {
+        const images = [];
+        for (const content of html) {
+          await ready(page, content, limits);
+          images.push(
+            await page.screenshot({ type: "png", fullPage: true, timeout: limits.timeoutMs })
+          );
+        }
+        return images;
+      });
+    },
+    async pdf(html, settings) {
+      checkPages(html);
+      return withPage(settings, async (page, limits) => {
+        const escapeAttribute = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+        const pdfDocument = `<!doctype html><html><head><style>@page { size: ${limits.width}px ${limits.height}px; margin: 0 } body { margin: 0 } iframe { display:block; border:0; width:${limits.width}px; height:${limits.height}px; break-after:page } iframe:last-child { break-after:auto }</style></head><body>${html.map((content) => `<iframe sandbox="allow-same-origin" srcdoc="${escapeAttribute(content)}"></iframe>`).join("")}</body></html>`;
+        await page.setContent(pdfDocument, { waitUntil: "load", timeout: limits.timeoutMs });
+        for (const frame of page.frames().slice(1)) {
+          await frame.evaluate(async () => {
+            await document.fonts.ready;
+            await Promise.all(
+              Array.from(document.images, (image) => image.decode().catch(() => {
+              }))
+            );
+          });
+          const height = await frame.evaluate(() => document.documentElement.scrollHeight);
+          if (height > limits.height)
+            throw new RangeError("genui: content exceeds PDF page height; reduce rowsPerPage");
+        }
+        return page.pdf({
+          width: `${limits.width}px`,
+          height: `${limits.height}px`,
+          printBackground: true,
+          preferCSSPageSize: true
+        });
+      });
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPlaywrightCaptureAdapter
+});
+//# sourceMappingURL=genui-server-playwright.cjs.map