@dudousxd/nestjs-agent-core 0.39.0 → 0.40.0

package/dist/genui/index.js

@@ -278,11 +278,11 @@ function check(schema, value, path, root, issues, depth) {
     }
   }
   if (matchesType("object", value)) {
-    const record = value;
+    const record2 = value;
     const properties = typeof s.properties === "object" && s.properties !== null ? s.properties : {};
     if (Array.isArray(s.required)) {
       for (const key of s.required) {
-        if (record[key] === void 0) {
+        if (record2[key] === void 0) {
           issues.push({
             path: [
               ...path,
@@ -293,7 +293,7 @@ function check(schema, value, path, root, issues, depth) {
         }
       }
     }
-    for (const [key, entry] of Object.entries(record)) {
+    for (const [key, entry] of Object.entries(record2)) {
       if (key in properties) {
         if (entry !== void 0) {
           check(properties[key], entry, [
@@ -353,6 +353,8 @@ function defineComponent(definition) {
   if (!COMPONENT_NAME.test(definition.name)) {
     throw new Error(`genui: component name "${definition.name}" must be letters and digits, starting with a letter (e.g. DataTable)`);
   }
+  if (definition.version !== void 0 && (!Number.isSafeInteger(definition.version) || definition.version <= 0)) throw new RangeError("genui: component version must be a positive safe integer");
+  if (definition.fallbackText !== void 0 && typeof definition.fallbackText !== "function") throw new TypeError("genui: fallbackText must be a function");
   return definition;
 }
 __name(defineComponent, "defineComponent");
@@ -661,7 +663,8 @@ function componentToText(catalog, component, props) {
   const fallback = catalog.get(component)?.fallbackText;
   if (fallback !== void 0) {
     try {
-      return fallback(props);
+      const text = fallback(props);
+      if (typeof text === "string" && text.trim().length > 0) return text;
     } catch {
     }
   }
@@ -675,7 +678,8 @@ function treeToText(catalog, root) {
     const definition = catalog.get(node.type);
     if (definition?.fallbackText !== void 0) {
       try {
-        out.push(definition.fallbackText(node.props));
+        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));
       }
@@ -692,7 +696,7 @@ function jsonBlock(props) {
   const title = typeof props.title === "string" && props.title.length > 0 ? `*${props.title}*
 ` : "";
   return `${title}\`\`\`
-${JSON.stringify(props, null, 2).slice(0, 2500)}
+${JSON.stringify(props, null, 2)}
 \`\`\``;
 }
 __name(jsonBlock, "jsonBlock");
@@ -783,6 +787,81 @@ function getPath(source, path) {
 }
 __name(getPath, "getPath");
 
+// src/genui/capabilities.ts
+function validateUiCapabilities(value) {
+  if (!record(value) || Object.keys(value).some((key) => key !== "components") || !Array.isArray(value.components)) throw new TypeError("Invalid UI capabilities");
+  const seen = /* @__PURE__ */ new Set();
+  const components = value.components.map((component) => {
+    if (!record(component) || Object.keys(component).some((key) => key !== "name" && key !== "version") || typeof component.name !== "string" || !COMPONENT_NAME.test(component.name) || !Number.isSafeInteger(component.version) || Number(component.version) <= 0 || seen.has(component.name)) throw new TypeError("Invalid UI component capability");
+    seen.add(component.name);
+    return {
+      name: component.name,
+      version: Number(component.version)
+    };
+  });
+  return {
+    components
+  };
+}
+__name(validateUiCapabilities, "validateUiCapabilities");
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+__name(record, "record");
+function negotiateCatalog(catalog, capabilities) {
+  if (capabilities === void 0) return catalog;
+  const supported = validateUiCapabilities(capabilities).components;
+  return defineCatalog(catalog.components.filter((component) => supported.some((entry) => entry.name === component.name && entry.version === (component.version ?? 1))), {
+    jsonSchemaValidator: catalog.validator
+  });
+}
+__name(negotiateCatalog, "negotiateCatalog");
+async function prepareUiEmission(catalog, capabilities, component, props, version) {
+  const drawable = negotiateCatalog(catalog, capabilities);
+  if (component === GENUI_TREE_COMPONENT) {
+    if (version !== void 0 && version !== 1) throw new Error("Invalid UI tree version");
+    const validated2 = await validateTree(catalog, props.root);
+    if (!validated2.ok) throw new Error(`Invalid UI tree: ${formatIssues(validated2.issues)}`);
+    const supported = /* @__PURE__ */ __name((node) => drawable.has(node.type) && (node.children ?? []).every(supported), "supported");
+    const versions = /* @__PURE__ */ new Map();
+    const collectVersions = /* @__PURE__ */ __name((node) => {
+      versions.set(node.type, catalog.get(node.type)?.version ?? 1);
+      for (const child of node.children ?? []) collectVersions(child);
+    }, "collectVersions");
+    collectVersions(validated2.value);
+    return supported(validated2.value) ? {
+      kind: "ui",
+      component,
+      props: {
+        root: validated2.value
+      },
+      version: 1,
+      fallbackText: treeToText(catalog, validated2.value),
+      componentVersions: Object.fromEntries(versions)
+    } : {
+      kind: "text",
+      text: treeToText(catalog, validated2.value)
+    };
+  }
+  const definition = catalog.get(component);
+  if (definition === void 0) throw new Error(`Unknown UI component "${component}"`);
+  const currentVersion = definition.version ?? 1;
+  if (version !== void 0 && version !== currentVersion) throw new Error(`Invalid UI component version for "${component}"`);
+  const validated = await catalog.validate(component, props);
+  if (!validated.ok) throw new Error(`Invalid UI props: ${formatIssues(validated.issues)}`);
+  return drawable.has(component) ? {
+    kind: "ui",
+    component,
+    props: validated.value,
+    version: currentVersion,
+    fallbackText: componentToText(catalog, component, validated.value)
+  } : {
+    kind: "text",
+    text: componentToText(catalog, component, validated.value)
+  };
+}
+__name(prepareUiEmission, "prepareUiEmission");
+
 // src/genui/tools.ts
 var GENUI_SHOW_TOOL = "ui__show";
 function genuiTools(catalog, options = {}) {
@@ -853,23 +932,22 @@ function componentTool(catalog, component, options) {
       return push(ctx, component.name, validated.value, definition.version);
     }
   };
-  if (dynamic) {
-    handler.describe = async (scope) => {
-      const resolved = await catalogFor(catalog, options, scopeOf(scope));
-      const definition = modelComponent(resolved, component.name);
-      if (definition === void 0) {
-        return {
-          description: `Not available in this conversation \u2014 do not call this tool. (${component.name})`
-        };
-      }
+  handler.describe = async (scope) => {
+    const resolved = negotiateCatalog(await catalogFor(catalog, options, scopeOf(scope)), scope.uiCapabilities);
+    const definition = modelComponent(resolved, component.name);
+    if (definition === void 0) {
       return {
-        description: describeFor(definition),
-        inputSchema: permissiveSchema(toJsonSchema(definition.props) ?? {
-          type: "object"
-        })
+        available: false,
+        description: `Not available in this conversation \u2014 do not call this tool. (${component.name})`
       };
+    }
+    return {
+      description: describeFor(definition),
+      inputSchema: permissiveSchema(toJsonSchema(definition.props) ?? {
+        type: "object"
+      })
     };
-  }
+  };
   return {
     spec: {
       name: toolNameFor(component.name, options.namePrefix),
@@ -913,15 +991,14 @@ function treeTool(catalog, options) {
       });
     }
   };
-  if (dynamic) {
-    handler.describe = async (scope) => {
-      const resolved = await catalogFor(catalog, options, scopeOf(scope));
-      return {
-        description: describeFor(resolved),
-        inputSchema: permissiveSchema(treeJsonSchema(resolved))
-      };
+  handler.describe = async (scope) => {
+    const resolved = negotiateCatalog(await catalogFor(catalog, options, scopeOf(scope)), scope.uiCapabilities);
+    return {
+      available: resolved.modelComponents().length > 0,
+      description: describeFor(resolved),
+      inputSchema: permissiveSchema(treeJsonSchema(resolved))
     };
-  }
+  };
   return {
     spec: {
       name,
@@ -1051,15 +1128,14 @@ function showTool(catalog, options) {
       return push(ctx, result.definition.name, result.props, result.definition.version);
     }
   };
-  if (dynamic) {
-    handler.describe = async (scope) => {
-      const resolved = await catalogFor(catalog, options, scopeOf(scope));
-      return {
-        description: describeFor(resolved),
-        inputSchema: permissiveSchema(showToolJsonSchema(resolved))
-      };
+  handler.describe = async (scope) => {
+    const resolved = negotiateCatalog(await catalogFor(catalog, options, scopeOf(scope)), scope.uiCapabilities);
+    return {
+      available: resolved.modelComponents().length > 0,
+      description: describeFor(resolved),
+      inputSchema: permissiveSchema(showToolJsonSchema(resolved))
     };
-  }
+  };
   return {
     spec: {
       name,
@@ -1160,6 +1236,8 @@ export {
   getPath,
   isStandardSchema,
   jsonStandardSchema,
+  negotiateCatalog,
+  prepareUiEmission,
   showToolJsonSchema,
   summarizeSchema,
   toJsonSchema,
@@ -1170,6 +1248,7 @@ export {
   treeToText,
   validateProps,
   validatePropsSync,
-  validateTree
+  validateTree,
+  validateUiCapabilities
 };
 //# sourceMappingURL=index.js.map