@dudousxd/nestjs-agent-core 0.41.0 → 0.42.1

package/dist/genui/index.d.cts

@@ -1,8 +1,8 @@
-import { a as Catalog, J as JsonSchema, G as GenuiValidation, b as GenuiIssue } from '../catalog-BKS3Yxo6.cjs';
-export { A as AjvLike, c as COMPONENT_NAME, d as CatalogOptions, C as ComponentDefinition, e as JsonSchemaValidator, P as PropsSchema, f as ajvValidator, g as builtinJsonSchemaValidator, h as defineCatalog, i as defineComponent, j as formatIssues, k as isStandardSchema, t as toJsonSchema, l as toSnakeCase, m as toolNameFor, v as validateProps, n as validatePropsSync } from '../catalog-BKS3Yxo6.cjs';
+import { a as Catalog, J as JsonSchema, G as GenuiValidation, b as GenuiIssue } from '../catalog-G8usJpx5.cjs';
+export { A as AjvLike, c as COMPONENT_NAME, d as CatalogOptions, C as ComponentDefinition, e as JsonSchemaValidator, P as PropsSchema, f as ajvValidator, g as builtinJsonSchemaValidator, h as defineCatalog, i as defineComponent, j as flatComponents, k as formatIssues, l as isStandardSchema, t as toJsonSchema, m as toSnakeCase, n as toolNameFor, v as validateProps, o as validatePropsSync } from '../catalog-G8usJpx5.cjs';
 import { StandardSchemaV1, StandardJSONSchemaV1 } from '@standard-schema/spec';
-import { a as Actor, T as ToolSpec, b as ToolHandler, c as ToolPresentation } from '../stream-events-CF-6-Y6L.cjs';
-export { C as ChartProps, d as ComponentFactory, e as ComponentManifest, f as ComponentPresentation, g as ComponentRegistry, h as ComponentRenderer, P as PreparedUiEmission, i as TableCell, j as TableProps, U as UiCapabilities, k as chart, l as createComponent, m as createComponentRegistry, n as negotiateCatalog, p as prepareUiEmission, s as snapshotComponentPresentation, t as table, v as validatePresentationBatch, o as validateUiCapabilities } from '../stream-events-CF-6-Y6L.cjs';
+import { a as Actor, T as ToolSpec, b as ToolHandler, c as ToolPresentation } from '../stream-events-BfxJAckJ.cjs';
+export { C as ChartProps, d as ComponentFactory, e as ComponentManifest, f as ComponentPresentation, g as ComponentRegistry, h as ComponentRenderer, P as PreparedUiEmission, i as TableCell, j as TableProps, U as UiCapabilities, k as chart, l as createComponent, m as createComponentRegistry, n as negotiateCatalog, p as prepareUiEmission, s as snapshotComponentPresentation, t as table, v as validatePresentationBatch, o as validateUiCapabilities } from '../stream-events-BfxJAckJ.cjs';
 
 /**
  * One node of a composed UI: a catalog component, its props, and — for components declared with
@@ -62,7 +62,8 @@ declare function treeToFlatSpec(root: GenuiElement): FlatSpec;
  * Plain text (Slack mrkdwn compatible) for a pushed component: its definition's `fallbackText`, or
  * the props as a JSON block when the catalog has no text for it. A tree frame
  * ({@link GENUI_TREE_COMPONENT}) renders node by node. Never throws — a fallback that fails prints
- * the JSON instead.
+ * the JSON instead. A layout component (`children: true`) whose text comes out empty writes
+ * nothing: it has nothing of its own to say, and its props (`direction`, `gap`) are not content.
  */
 declare function componentToText(catalog: Catalog, component: string, props: Record<string, unknown>): string;
 /** Plain text for a composed tree: each node's text, depth-first, blank-line free. */
@@ -117,7 +118,8 @@ type ResolveGenuiCatalog = (scope: GenuiCatalogScope) => Catalog | Promise<Catal
 interface GenuiToolsOptions {
     /**
      * `per-component` (default): one tool per model-facing component, `ui__show_<snake>`, whose input
-     * IS the component's props. `tree`: a single tool whose input is a nested
+     * IS the component's props — except layout components (`children: true`), which a flat input
+     * cannot fill. `tree`: a single tool whose input is a nested
      * `{ type, props, children }` tree composed from the catalog (json-render's nested shape).
      */
     mode?: 'per-component' | 'tree';

package/dist/genui/index.d.ts

@@ -1,8 +1,8 @@
-import { a as Catalog, J as JsonSchema, G as GenuiValidation, b as GenuiIssue } from '../catalog-BKS3Yxo6.js';
-export { A as AjvLike, c as COMPONENT_NAME, d as CatalogOptions, C as ComponentDefinition, e as JsonSchemaValidator, P as PropsSchema, f as ajvValidator, g as builtinJsonSchemaValidator, h as defineCatalog, i as defineComponent, j as formatIssues, k as isStandardSchema, t as toJsonSchema, l as toSnakeCase, m as toolNameFor, v as validateProps, n as validatePropsSync } from '../catalog-BKS3Yxo6.js';
+import { a as Catalog, J as JsonSchema, G as GenuiValidation, b as GenuiIssue } from '../catalog-G8usJpx5.js';
+export { A as AjvLike, c as COMPONENT_NAME, d as CatalogOptions, C as ComponentDefinition, e as JsonSchemaValidator, P as PropsSchema, f as ajvValidator, g as builtinJsonSchemaValidator, h as defineCatalog, i as defineComponent, j as flatComponents, k as formatIssues, l as isStandardSchema, t as toJsonSchema, m as toSnakeCase, n as toolNameFor, v as validateProps, o as validatePropsSync } from '../catalog-G8usJpx5.js';
 import { StandardSchemaV1, StandardJSONSchemaV1 } from '@standard-schema/spec';
-import { a as Actor, T as ToolSpec, b as ToolHandler, c as ToolPresentation } from '../stream-events-BGKLD6RX.js';
-export { C as ChartProps, d as ComponentFactory, e as ComponentManifest, f as ComponentPresentation, g as ComponentRegistry, h as ComponentRenderer, P as PreparedUiEmission, i as TableCell, j as TableProps, U as UiCapabilities, k as chart, l as createComponent, m as createComponentRegistry, n as negotiateCatalog, p as prepareUiEmission, s as snapshotComponentPresentation, t as table, v as validatePresentationBatch, o as validateUiCapabilities } from '../stream-events-BGKLD6RX.js';
+import { a as Actor, T as ToolSpec, b as ToolHandler, c as ToolPresentation } from '../stream-events-DFa2Do42.js';
+export { C as ChartProps, d as ComponentFactory, e as ComponentManifest, f as ComponentPresentation, g as ComponentRegistry, h as ComponentRenderer, P as PreparedUiEmission, i as TableCell, j as TableProps, U as UiCapabilities, k as chart, l as createComponent, m as createComponentRegistry, n as negotiateCatalog, p as prepareUiEmission, s as snapshotComponentPresentation, t as table, v as validatePresentationBatch, o as validateUiCapabilities } from '../stream-events-DFa2Do42.js';
 
 /**
  * One node of a composed UI: a catalog component, its props, and — for components declared with
@@ -62,7 +62,8 @@ declare function treeToFlatSpec(root: GenuiElement): FlatSpec;
  * Plain text (Slack mrkdwn compatible) for a pushed component: its definition's `fallbackText`, or
  * the props as a JSON block when the catalog has no text for it. A tree frame
  * ({@link GENUI_TREE_COMPONENT}) renders node by node. Never throws — a fallback that fails prints
- * the JSON instead.
+ * the JSON instead. A layout component (`children: true`) whose text comes out empty writes
+ * nothing: it has nothing of its own to say, and its props (`direction`, `gap`) are not content.
  */
 declare function componentToText(catalog: Catalog, component: string, props: Record<string, unknown>): string;
 /** Plain text for a composed tree: each node's text, depth-first, blank-line free. */
@@ -117,7 +118,8 @@ type ResolveGenuiCatalog = (scope: GenuiCatalogScope) => Catalog | Promise<Catal
 interface GenuiToolsOptions {
     /**
      * `per-component` (default): one tool per model-facing component, `ui__show_<snake>`, whose input
-     * IS the component's props. `tree`: a single tool whose input is a nested
+     * IS the component's props — except layout components (`children: true`), which a flat input
+     * cannot fill. `tree`: a single tool whose input is a nested
      * `{ type, props, children }` tree composed from the catalog (json-render's nested shape).
      */
     mode?: 'per-component' | 'tree';

package/dist/genui/index.js

@@ -358,6 +358,10 @@ function defineComponent(definition) {
   return definition;
 }
 __name(defineComponent, "defineComponent");
+function flatComponents(catalog) {
+  return catalog.modelComponents().filter((component) => component.children !== true);
+}
+__name(flatComponents, "flatComponents");
 function defineCatalog(components, options = {}) {
   const byName = /* @__PURE__ */ new Map();
   for (const component of components) {
@@ -660,32 +664,31 @@ function componentToText(catalog, component, props) {
     const root = props.root;
     return root === void 0 ? "" : treeToText(catalog, root);
   }
-  const fallback = catalog.get(component)?.fallbackText;
+  return ownText(catalog, component, props) ?? "";
+}
+__name(componentToText, "componentToText");
+function ownText(catalog, component, props) {
+  const definition = catalog.get(component);
+  const fallback = definition?.fallbackText;
+  let failed = false;
   if (fallback !== void 0) {
     try {
       const text = fallback(props);
       if (typeof text === "string" && text.trim().length > 0) return text;
     } catch {
+      failed = true;
     }
   }
+  if (definition?.children === true && !failed) return void 0;
   return jsonBlock(props);
 }
-__name(componentToText, "componentToText");
+__name(ownText, "ownText");
 function treeToText(catalog, root) {
   const out = [];
   const visit = /* @__PURE__ */ __name((node, depth) => {
     if (depth > 32) return;
-    const definition = catalog.get(node.type);
-    if (definition?.fallbackText !== void 0) {
-      try {
-        const text = definition.fallbackText(node.props);
-        out.push(typeof text === "string" && text.trim().length > 0 ? text : jsonBlock(node.props));
-      } catch {
-        out.push(jsonBlock(node.props));
-      }
-    } else if (definition?.children !== true) {
-      out.push(jsonBlock(node.props));
-    }
+    const text = ownText(catalog, node.type, node.props);
+    if (text !== void 0) out.push(text);
     for (const child of node.children ?? []) visit(child, depth + 1);
   }, "visit");
   visit(root, 0);
@@ -710,7 +713,8 @@ function catalogToModelText(catalog, options = {}) {
   } else {
     lines.push("Components you can show (one tool each):");
   }
-  for (const component of catalog.modelComponents()) {
+  const components = mode === "tree" ? catalog.modelComponents() : flatComponents(catalog);
+  for (const component of components) {
     const schema = toJsonSchema(component.props);
     const head = mode === "per-component" ? `- ${component.name} (tool \`${toolNameFor(component.name, options.namePrefix)}\`)` : `- ${component.name}`;
     lines.push(`${head}: ${component.description}`);
@@ -867,7 +871,7 @@ var GENUI_SHOW_TOOL = "ui__show";
 function genuiTools(catalog, options = {}) {
   const tools = options.mode === "tree" ? [
     treeTool(catalog, options)
-  ] : catalog.modelComponents().map((component) => componentTool(catalog, component, options));
+  ] : flatComponents(catalog).map((component) => componentTool(catalog, component, options));
   if (options.showTool !== void 0 && options.showTool !== false) {
     tools.push(showTool(catalog, options));
   }
@@ -921,7 +925,7 @@ function componentTool(catalog, component, options) {
   const handler = {
     async execute(input, ctx) {
       const resolved = await catalogFor(catalog, options, scopeOf(ctx));
-      const definition = modelComponent(resolved, component.name);
+      const definition = flatComponent(resolved, component.name);
       if (definition === void 0) {
         throw new Error(`component "${component.name}" is not available here`);
       }
@@ -934,7 +938,7 @@ function componentTool(catalog, component, options) {
   };
   handler.describe = async (scope) => {
     const resolved = negotiateCatalog(await catalogFor(catalog, options, scopeOf(scope)), scope.uiCapabilities);
-    const definition = modelComponent(resolved, component.name);
+    const definition = flatComponent(resolved, component.name);
     if (definition === void 0) {
       return {
         available: false,
@@ -1025,7 +1029,7 @@ function showToolJsonSchema(catalog) {
     properties: {
       component: {
         type: "string",
-        enum: catalog.modelComponents().map((component) => component.name),
+        enum: flatComponents(catalog).map((component) => component.name),
         description: "Component name from the catalog"
       },
       props: {
@@ -1066,9 +1070,9 @@ async function validateShow(catalog, input, phase = "input") {
       ]
     };
   }
-  const definition = modelComponent(catalog, component);
+  const definition = flatComponent(catalog, component);
   if (definition === void 0) {
-    const allowed = catalog.modelComponents().map((each) => each.name).join(", ");
+    const allowed = flatComponents(catalog).map((each) => each.name).join(", ");
     return {
       ok: false,
       issues: [
@@ -1131,7 +1135,7 @@ function showTool(catalog, options) {
   handler.describe = async (scope) => {
     const resolved = negotiateCatalog(await catalogFor(catalog, options, scopeOf(scope)), scope.uiCapabilities);
     return {
-      available: resolved.modelComponents().length > 0,
+      available: flatComponents(resolved).length > 0,
       description: describeFor(resolved),
       inputSchema: permissiveSchema(showToolJsonSchema(resolved))
     };
@@ -1159,11 +1163,11 @@ function showTool(catalog, options) {
   };
 }
 __name(showTool, "showTool");
-function modelComponent(catalog, name) {
+function flatComponent(catalog, name) {
   const definition = catalog.get(name);
-  return definition === void 0 || definition.internal === true ? void 0 : definition;
+  return definition === void 0 || definition.internal === true || definition.children === true ? void 0 : definition;
 }
-__name(modelComponent, "modelComponent");
+__name(flatComponent, "flatComponent");
 async function push(ctx, component, props, version) {
   const { id } = await ctx.emitUi(component, props, version !== void 0 ? {
     version
@@ -1408,18 +1412,49 @@ var Chart = defineComponent({
     "series",
     "data"
   ]),
-  fallbackText: /* @__PURE__ */ __name((props) => {
-    const series = props.series ?? [];
-    const data = props.data ?? [];
-    const first = series[0]?.key ?? "";
-    const max = Math.max(0, ...data.map((point) => Math.abs(Number(point[first]) || 0)));
-    const unit = props.unit ? ` ${s(props.unit)}` : "";
-    const lines = data.slice(0, 20).map((point) => `${s(point[props.xKey]).slice(0, 18).padEnd(18)} ${bar(Number(point[first]) || 0, max)} ${s(point[first])}${unit}`);
-    return `${heading(props)}\`\`\`
+  fallbackText: /* @__PURE__ */ __name((props) => chartText(props), "fallbackText")
+});
+function chartText(props) {
+  const series = (props.series ?? []).filter((each) => typeof each?.key === "string");
+  const data = props.data ?? [];
+  const unit = props.unit ? ` ${s(props.unit)}` : "";
+  const labelOf = /* @__PURE__ */ __name((each) => s(each.label) || each.key, "labelOf");
+  if (props.type === "line") {
+    const columns = [
+      {
+        key: s(props.xKey),
+        label: s(props.xKey)
+      },
+      ...series.map((each) => ({
+        key: each.key,
+        label: `${labelOf(each)}${unit}`
+      }))
+    ];
+    return `${heading(props)}${textTable(columns, data, 20)}`;
+  }
+  const max = Math.max(0, ...data.flatMap((point) => series.map((each) => Math.abs(Number(point[each.key]) || 0))));
+  const shown = data.slice(0, 20);
+  const lines = [];
+  if (series.length <= 1) {
+    const key = series[0]?.key ?? "";
+    for (const point of shown) {
+      lines.push(`${s(point[props.xKey]).slice(0, 18).padEnd(18)} ${bar(Number(point[key]) || 0, max)} ${s(point[key])}${unit}`);
+    }
+  } else {
+    const width = Math.min(18, Math.max(...series.map((each) => labelOf(each).length)));
+    for (const point of shown) {
+      lines.push(s(point[props.xKey]).slice(0, 18));
+      for (const each of series) {
+        lines.push(`  ${labelOf(each).slice(0, width).padEnd(width)} ${bar(Number(point[each.key]) || 0, max)} ${s(point[each.key])}${unit}`);
+      }
+    }
+  }
+  if (data.length > shown.length) lines.push(`\u2026 ${data.length - shown.length} more points`);
+  return `${heading(props)}\`\`\`
 ${lines.join("\n")}
 \`\`\``;
-  }, "fallbackText")
-});
+}
+__name(chartText, "chartText");
 var KpiCards = defineComponent({
   name: "KpiCards",
   title: "KPI cards",
@@ -1814,6 +1849,7 @@ export {
   defineCatalog,
   defineComponent,
   fillTemplate,
+  flatComponents,
   formatIssues,
   genuiTools,
   getPath,