@dudousxd/nestjs-agent-react 0.34.5 → 0.35.1

package/dist/index.d.cts

@@ -8,9 +8,9 @@ import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
 import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
 export { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
-import { g as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, j as ApprovalTarget, k as TranscriptBlock, U as UsageSummary, l as TimestampInfo, C as ChatStatus, m as TranscriptFile, M as MessageUsageInfo, n as ToolCatalog, o as AnyToolUIPart } from './generative-ui-CyHY8Lh1.cjs';
-export { p as ApprovalBlockOptions, B as BuildBlocksOptions, q as CoercibleQuestion, D as DescribeToolCallOptions, E as ElicitationBlockOptions, r as GroupToolActivityOptions, R as RawAnswer, s as ResolvedReading, t as ResolvedResultView, v as RetrievedPassage, S as SettleAction, w as ToolActivityGroup, x as ToolCallDescription, y as ToolCallState, z as ToolCallStatus, F as TranscriptApproval, H as TranscriptApprovalStatus, I as TranscriptElicitationBlock, J as TranscriptElicitationOutcome, K as TranscriptFilesBlock, L as TranscriptQuestion, N as TranscriptQuestionOption, O as TranscriptReasoningBlock, P as TranscriptSettleState, Q as TranscriptSource, V as TranscriptSourcesBlock, W as TranscriptTextBlock, X as TranscriptToolBlock, Y as TranscriptToolCall, Z as buildTranscriptBlocks, _ as coerceAnswer, $ as correctedCallIds, a0 as describeTimestamp, a1 as describeToolCall, a2 as describeUsage, a3 as extractMessageText, a4 as fillTemplate, a5 as formatRelativeTime, a6 as groupToolActivity, a7 as inferResultView, a8 as isActionCall, a9 as phraseFor, aa as proposalNeedsPolling, ab as readPath, ac as reconcileProposalMessages, ad as resolveResultView, ae as toolCallState, af as toolCatalogFrom } from './generative-ui-CyHY8Lh1.cjs';
-import './types-DZtFsWec.cjs';
+import { g as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, k as ApprovalTarget, l as TranscriptBlock, U as UsageSummary, m as TimestampInfo, C as ChatStatus, n as TranscriptFile, M as MessageUsageInfo, o as ToolCatalog, p as AnyToolUIPart } from './generative-ui-ClYT7OgL.cjs';
+export { q as ApprovalBlockOptions, B as BuildBlocksOptions, r as CoercibleQuestion, D as DescribeToolCallOptions, E as ElicitationBlockOptions, s as GroupToolActivityOptions, R as RawAnswer, t as ResolvedReading, v as ResolvedResultView, w as RetrievedPassage, S as SettleAction, x as ToolActivityGroup, y as ToolCallDescription, z as ToolCallState, F as ToolCallStatus, H as TranscriptApproval, I as TranscriptApprovalStatus, J as TranscriptElicitationBlock, K as TranscriptElicitationOutcome, L as TranscriptFilesBlock, N as TranscriptQuestion, O as TranscriptQuestionOption, P as TranscriptReasoningBlock, Q as TranscriptSettleState, V as TranscriptSource, W as TranscriptSourcesBlock, X as TranscriptTextBlock, Y as TranscriptToolBlock, Z as TranscriptToolCall, _ as buildTranscriptBlocks, $ as coerceAnswer, a0 as correctedCallIds, a1 as describeTimestamp, a2 as describeToolCall, a3 as describeUsage, a4 as extractMessageText, a5 as fillTemplate, a6 as formatRelativeTime, a7 as groupToolActivity, a8 as inferResultView, a9 as isActionCall, aa as phraseFor, ab as proposalNeedsPolling, ac as readPath, ad as reconcileProposalMessages, ae as resolveResultView, af as toolCallState, ag as toolCatalogFrom } from './generative-ui-ClYT7OgL.cjs';
+import './types-COuArD3c.cjs';
 
 /**
  * The `code`s this library's own loop closes a failed run's stream with (`event: error`). A client

package/dist/index.d.ts

@@ -8,9 +8,9 @@ import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
 import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
 export { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
-import { g as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, j as ApprovalTarget, k as TranscriptBlock, U as UsageSummary, l as TimestampInfo, C as ChatStatus, m as TranscriptFile, M as MessageUsageInfo, n as ToolCatalog, o as AnyToolUIPart } from './generative-ui-DdUZPCXX.js';
-export { p as ApprovalBlockOptions, B as BuildBlocksOptions, q as CoercibleQuestion, D as DescribeToolCallOptions, E as ElicitationBlockOptions, r as GroupToolActivityOptions, R as RawAnswer, s as ResolvedReading, t as ResolvedResultView, v as RetrievedPassage, S as SettleAction, w as ToolActivityGroup, x as ToolCallDescription, y as ToolCallState, z as ToolCallStatus, F as TranscriptApproval, H as TranscriptApprovalStatus, I as TranscriptElicitationBlock, J as TranscriptElicitationOutcome, K as TranscriptFilesBlock, L as TranscriptQuestion, N as TranscriptQuestionOption, O as TranscriptReasoningBlock, P as TranscriptSettleState, Q as TranscriptSource, V as TranscriptSourcesBlock, W as TranscriptTextBlock, X as TranscriptToolBlock, Y as TranscriptToolCall, Z as buildTranscriptBlocks, _ as coerceAnswer, $ as correctedCallIds, a0 as describeTimestamp, a1 as describeToolCall, a2 as describeUsage, a3 as extractMessageText, a4 as fillTemplate, a5 as formatRelativeTime, a6 as groupToolActivity, a7 as inferResultView, a8 as isActionCall, a9 as phraseFor, aa as proposalNeedsPolling, ab as readPath, ac as reconcileProposalMessages, ad as resolveResultView, ae as toolCallState, af as toolCatalogFrom } from './generative-ui-DdUZPCXX.js';
-import './types-DZtFsWec.js';
+import { g as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, k as ApprovalTarget, l as TranscriptBlock, U as UsageSummary, m as TimestampInfo, C as ChatStatus, n as TranscriptFile, M as MessageUsageInfo, o as ToolCatalog, p as AnyToolUIPart } from './generative-ui-D1efzu_K.js';
+export { q as ApprovalBlockOptions, B as BuildBlocksOptions, r as CoercibleQuestion, D as DescribeToolCallOptions, E as ElicitationBlockOptions, s as GroupToolActivityOptions, R as RawAnswer, t as ResolvedReading, v as ResolvedResultView, w as RetrievedPassage, S as SettleAction, x as ToolActivityGroup, y as ToolCallDescription, z as ToolCallState, F as ToolCallStatus, H as TranscriptApproval, I as TranscriptApprovalStatus, J as TranscriptElicitationBlock, K as TranscriptElicitationOutcome, L as TranscriptFilesBlock, N as TranscriptQuestion, O as TranscriptQuestionOption, P as TranscriptReasoningBlock, Q as TranscriptSettleState, V as TranscriptSource, W as TranscriptSourcesBlock, X as TranscriptTextBlock, Y as TranscriptToolBlock, Z as TranscriptToolCall, _ as buildTranscriptBlocks, $ as coerceAnswer, a0 as correctedCallIds, a1 as describeTimestamp, a2 as describeToolCall, a3 as describeUsage, a4 as extractMessageText, a5 as fillTemplate, a6 as formatRelativeTime, a7 as groupToolActivity, a8 as inferResultView, a9 as isActionCall, aa as phraseFor, ab as proposalNeedsPolling, ac as readPath, ad as reconcileProposalMessages, ae as resolveResultView, af as toolCallState, ag as toolCatalogFrom } from './generative-ui-D1efzu_K.js';
+import './types-COuArD3c.js';
 
 /**
  * The `code`s this library's own loop closes a failed run's stream with (`event: error`). A client

package/dist/index.js

@@ -932,7 +932,10 @@ var AgentChatTransport = class {
                   component: event.component,
                   props: event.props,
                   ...event.version !== void 0 ? { version: event.version } : {},
-                  ...event.toolCallId !== void 0 ? { toolCallId: event.toolCallId } : {}
+                  ...event.toolCallId !== void 0 ? { toolCallId: event.toolCallId } : {},
+                  // A preview of a layout the model is still writing: the final push (same id)
+                  // replaces this part in place.
+                  ...event.partial === true ? { partial: true } : {}
                 }
               });
               break;
@@ -1292,7 +1295,8 @@ function toGenerativeUIItem(part) {
     ...typeof source.fallbackText === "string" ? { fallbackText: source.fallbackText } : {},
     props: isRecord(source.props) ? source.props : {},
     version: typeof source.version === "number" ? source.version : null,
-    toolCallId: typeof source.toolCallId === "string" ? source.toolCallId : null
+    toolCallId: typeof source.toolCallId === "string" ? source.toolCallId : null,
+    ...source.partial === true ? { partial: true } : {}
   };
 }
 var resolverCaches = /* @__PURE__ */ new WeakMap();
@@ -1411,6 +1415,7 @@ function useGenerativeUIState(part, options, fallbackTree) {
     item?.props ?? empty
   );
   if (item === null) return null;
+  if (item.partial === true && Object.keys(item.props).length === 0) return null;
   if (name === GENUI_TREE_COMPONENT && item.fallbackText !== void 0 && (!isRecord(item.props.root) || typeof item.props.root.type !== "string"))
     return {
       status: "problem",
@@ -1433,6 +1438,14 @@ function useGenerativeUIState(part, options, fallbackTree) {
 // src/genui/generative-ui.tsx
 import { jsx } from "react/jsx-runtime";
 var TreeScopeContext = createContext2(null);
+var GenuiNodeContext = sharedContext(
+  "@dudousxd/nestjs-agent-react:genui-node"
+);
+function renderPlaceholder(scope, node) {
+  const { placeholder } = scope;
+  if (typeof placeholder === "function") return placeholder(node);
+  return placeholder !== void 0 ? placeholder : scope.loading;
+}
 function renderFallback(fallback2, problem) {
   if (typeof fallback2 === "function") return fallback2(problem);
   if (fallback2 !== void 0) return fallback2;
@@ -1468,6 +1481,12 @@ function nodeItem(node, id) {
 function TreeNode({ node, id }) {
   const scope = useContext2(TreeScopeContext);
   const item = useMemo2(() => nodeItem(node, id), [node, id]);
+  const incomplete = node.incomplete === true;
+  const held = node.held === true;
+  const state = useMemo2(
+    () => ({ id, type: node.type, incomplete, held }),
+    [id, node.type, incomplete, held]
+  );
   const storedVersion = scope?.componentVersions?.[node.type];
   const definition = scope?.options.catalog?.get?.(node.type);
   const incompatible = storedVersion !== void 0 && definition !== void 0 && storedVersion !== (definition.version ?? 1);
@@ -1478,11 +1497,14 @@ function TreeNode({ node, id }) {
     scope?.options.resolveComponent
   );
   const validation = useValidatedProps(
-    incompatible ? void 0 : scope?.options.catalog,
+    incompatible || incomplete ? void 0 : scope?.options.catalog,
     node.type,
     item.props
   );
   if (scope === null) return null;
+  if (held) {
+    return /* @__PURE__ */ jsx(GenuiNodeContext.Provider, { value: state, children: renderPlaceholder(scope, state) });
+  }
   if (resolution.status === "loading" || validation.status === "pending") return scope.loading;
   if (resolution.status === "unknown") {
     if (scope.fallback === void 0 && scope.fallbackText !== void 0)
@@ -1500,7 +1522,7 @@ function TreeNode({ node, id }) {
   }
   const Renderer = resolution.Component;
   const children = Array.isArray(node.children) ? node.children : [];
-  return /* @__PURE__ */ jsx(Renderer, { ...validation.props, children: children.length > 0 ? children.map((child, index) => {
+  return /* @__PURE__ */ jsx(GenuiNodeContext.Provider, { value: state, children: /* @__PURE__ */ jsx(Renderer, { ...validation.props, children: children.length > 0 ? children.map((child, index) => {
     const childId = `${id}.${index}`;
     if (scope.fallback === void 0 && scope.fallbackText !== void 0)
       return /* @__PURE__ */ jsx(TreeNode, { node: child, id: childId }, childId);
@@ -1514,7 +1536,7 @@ function TreeNode({ node, id }) {
       },
       childId
     );
-  }) : void 0 });
+  }) : void 0 }) });
 }
 function GenuiTree({ root }) {
   if (root === void 0 || root === null || typeof root.type !== "string") return null;
@@ -1528,6 +1550,7 @@ function GenerativeUIScope({
   fallbackText,
   componentVersions,
   loading = null,
+  placeholder,
   onError,
   children
 }) {
@@ -1542,6 +1565,7 @@ function GenerativeUIScope({
       ...componentVersions !== void 0 ? { componentVersions } : {},
       ...fallbackText !== void 0 ? { fallbackText } : {},
       loading,
+      placeholder,
       onError
     }),
     [
@@ -1552,6 +1576,7 @@ function GenerativeUIScope({
       fallbackText,
       componentVersions,
       loading,
+      placeholder,
       onError
     ]
   );
@@ -1567,6 +1592,7 @@ function GenuiProvider({
   treeRenderer,
   fallback: fallback2,
   loading,
+  placeholder,
   onError,
   children
 }) {
@@ -1578,9 +1604,10 @@ function GenuiProvider({
       ...treeRenderer !== void 0 ? { treeRenderer } : {},
       ...fallback2 !== void 0 ? { fallback: fallback2 } : {},
       ...loading !== void 0 ? { loading } : {},
+      ...placeholder !== void 0 ? { placeholder } : {},
       ...onError !== void 0 ? { onError } : {}
     }),
-    [registry, catalog, resolveComponent, treeRenderer, fallback2, loading, onError]
+    [registry, catalog, resolveComponent, treeRenderer, fallback2, loading, placeholder, onError]
   );
   const renderUi = useCallback((block) => /* @__PURE__ */ jsx(GenerativeUI, { part: block }), []);
   return /* @__PURE__ */ jsx(GenuiContext.Provider, { value, children: /* @__PURE__ */ jsx(AmbientRenderUiContext.Provider, { value: renderUi, children }) });
@@ -1610,11 +1637,13 @@ function GenerativeUI({
   treeRenderer,
   fallback: ownFallback,
   loading: ownLoading,
+  placeholder: ownPlaceholder,
   onError: ownOnError
 }) {
   const provided = useContext2(GenuiContext);
   const fallback2 = ownFallback !== void 0 ? ownFallback : provided?.fallback;
   const loading = ownLoading ?? provided?.loading ?? null;
+  const placeholder = ownPlaceholder !== void 0 ? ownPlaceholder : provided?.placeholder;
   const onError = ownOnError ?? provided?.onError;
   const options = useMergedOptions({
     ...registry !== void 0 ? { registry } : {},
@@ -1642,6 +1671,7 @@ function GenerativeUI({
       ...state.item.fallbackText !== void 0 ? { fallbackText: state.item.fallbackText } : {},
       fallback: fallback2,
       loading,
+      ...placeholder !== void 0 ? { placeholder } : {},
       ...onError !== void 0 ? { onError } : {},
       children: /* @__PURE__ */ jsx(ItemBoundary, { item: state.item, fallback: fallback2, onError, children: /* @__PURE__ */ jsx(Renderer, { ...state.props }) })
     }
@@ -3332,6 +3362,12 @@ function buildTranscriptBlocks(message, options) {
     flushSources();
     flushFiles();
   }
+  const settledCalls = /* @__PURE__ */ new Set();
+  for (const part of message.parts ?? []) {
+    if (isToolUIPart(part) && (part.state === "output-available" || part.state === "output-error" || part.state === "output-denied")) {
+      settledCalls.add(part.toolCallId);
+    }
+  }
   for (const part of message.parts ?? []) {
     if (isToolUIPart(part)) {
       const elicitation = options.elicitation;
@@ -3372,6 +3408,9 @@ function buildTranscriptBlocks(message, options) {
     flushAll();
     if (isDataUIPart(part)) {
       const ui = part.type === UI_PART ? readUiComponent(part) : null;
+      if (ui?.partial === true && (Object.keys(ui.props).length === 0 || ui.toolCallId !== null && settledCalls.has(ui.toolCallId))) {
+        continue;
+      }
       if (ui !== null) {
         blocks.push({ kind: "ui", key: `${message.id}-ui-${ui.id}`, ...ui });
       }
@@ -3780,7 +3819,8 @@ function readUiComponent(part) {
       (version) => typeof version === "number" && Number.isSafeInteger(version) && version > 0
     ) ? { componentVersions: { ...data.componentVersions } } : {},
     ...typeof data.fallbackText === "string" ? { fallbackText: data.fallbackText } : {},
-    toolCallId: typeof data.toolCallId === "string" ? data.toolCallId : null
+    toolCallId: typeof data.toolCallId === "string" ? data.toolCallId : null,
+    ...data.partial === true ? { partial: true } : {}
   };
 }
 function isRecord4(value) {