@aigne/core 1.60.0 → 1.60.2

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [1.60.2](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.60.1...core-v1.60.2) (2025-09-11)
+
+
+### Bug Fixes
+
+* **core:** add nullish or nullable support for output schema ([#482](https://github.com/AIGNE-io/aigne-framework/issues/482)) ([bf80c29](https://github.com/AIGNE-io/aigne-framework/commit/bf80c29e10d3fef654c830df8dc7f3b7939fa58d))
+
+## [1.60.1](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.60.0...core-v1.60.1) (2025-09-11)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/observability-api bumped to 0.10.4
+
 ## [1.60.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.59.0...core-v1.60.0) (2025-09-10)
 
 

package/lib/cjs/utils/json-schema.js

@@ -6,8 +6,9 @@ exports.ensureZodUnionArray = ensureZodUnionArray;
 exports.isZodSchema = isZodSchema;
 const zod_to_json_schema_1 = require("zod-to-json-schema");
 const logger_js_1 = require("./logger.js");
+const type_utils_js_1 = require("./type-utils.js");
 function outputSchemaToResponseFormatSchema(agentOutput) {
-    return setAdditionPropertiesDeep((0, zod_to_json_schema_1.zodToJsonSchema)(agentOutput), false);
+    return convertNullableToOptional(setAdditionPropertiesDeep((0, zod_to_json_schema_1.zodToJsonSchema)(agentOutput), false))[0];
 }
 function setAdditionPropertiesDeep(schema, additionalProperties) {
     if (Array.isArray(schema)) {
@@ -51,3 +52,41 @@ function isZodSchema(schema) {
         return false;
     return typeof schema.parse === "function" && typeof schema.safeParse === "function";
 }
+function convertNullableToOptional(schema) {
+    if (!(0, type_utils_js_1.isRecord)(schema))
+        return [schema, false];
+    if (schema.type === "object" && "properties" in schema && (0, type_utils_js_1.isRecord)(schema.properties)) {
+        const optionalProperties = [];
+        const properties = Object.fromEntries(Object.entries(schema.properties).map(([key, value]) => {
+            const [property, optional] = convertNullableToOptional(value);
+            if (optional)
+                optionalProperties.push(key);
+            return [key, property];
+        }));
+        const currentRequired = "required" in schema && Array.isArray(schema.required) ? schema.required : [];
+        const required = currentRequired.filter((key) => !optionalProperties.includes(key));
+        return [{ ...schema, properties, required }, false];
+    }
+    if (schema.type === "array" && "items" in schema && (0, type_utils_js_1.isRecord)(schema.items)) {
+        const [items, _] = convertNullableToOptional(schema.items);
+        return [{ ...schema, items }, false];
+    }
+    if (Array.isArray(schema.type)) {
+        if (schema.type.includes("null") && schema.type.length === 2) {
+            return [
+                {
+                    ...schema,
+                    type: schema.type.filter((t) => t !== "null")[0],
+                },
+                true,
+            ];
+        }
+    }
+    if (Array.isArray(schema.anyOf)) {
+        const anyOf = schema.anyOf.filter((i) => (0, type_utils_js_1.isRecord)(i) && i.type !== "null" && !("not" in i && (0, type_utils_js_1.isEmpty)(i.not)));
+        const optional = anyOf.length !== schema.anyOf.length;
+        if (anyOf.length === 1)
+            return [convertNullableToOptional(anyOf[0])[0], optional];
+    }
+    return [schema, false];
+}

package/lib/esm/utils/json-schema.js

@@ -1,7 +1,8 @@
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { logger } from "./logger.js";
+import { isEmpty, isRecord } from "./type-utils.js";
 export function outputSchemaToResponseFormatSchema(agentOutput) {
-    return setAdditionPropertiesDeep(zodToJsonSchema(agentOutput), false);
+    return convertNullableToOptional(setAdditionPropertiesDeep(zodToJsonSchema(agentOutput), false))[0];
 }
 function setAdditionPropertiesDeep(schema, additionalProperties) {
     if (Array.isArray(schema)) {
@@ -45,3 +46,41 @@ export function isZodSchema(schema) {
         return false;
     return typeof schema.parse === "function" && typeof schema.safeParse === "function";
 }
+function convertNullableToOptional(schema) {
+    if (!isRecord(schema))
+        return [schema, false];
+    if (schema.type === "object" && "properties" in schema && isRecord(schema.properties)) {
+        const optionalProperties = [];
+        const properties = Object.fromEntries(Object.entries(schema.properties).map(([key, value]) => {
+            const [property, optional] = convertNullableToOptional(value);
+            if (optional)
+                optionalProperties.push(key);
+            return [key, property];
+        }));
+        const currentRequired = "required" in schema && Array.isArray(schema.required) ? schema.required : [];
+        const required = currentRequired.filter((key) => !optionalProperties.includes(key));
+        return [{ ...schema, properties, required }, false];
+    }
+    if (schema.type === "array" && "items" in schema && isRecord(schema.items)) {
+        const [items, _] = convertNullableToOptional(schema.items);
+        return [{ ...schema, items }, false];
+    }
+    if (Array.isArray(schema.type)) {
+        if (schema.type.includes("null") && schema.type.length === 2) {
+            return [
+                {
+                    ...schema,
+                    type: schema.type.filter((t) => t !== "null")[0],
+                },
+                true,
+            ];
+        }
+    }
+    if (Array.isArray(schema.anyOf)) {
+        const anyOf = schema.anyOf.filter((i) => isRecord(i) && i.type !== "null" && !("not" in i && isEmpty(i.not)));
+        const optional = anyOf.length !== schema.anyOf.length;
+        if (anyOf.length === 1)
+            return [convertNullableToOptional(anyOf[0])[0], optional];
+    }
+    return [schema, false];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.60.0",
+  "version": "1.60.2",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -92,8 +92,8 @@
     "yaml": "^2.8.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/observability-api": "^0.10.3",
-    "@aigne/platform-helpers": "^0.6.2"
+    "@aigne/platform-helpers": "^0.6.2",
+    "@aigne/observability-api": "^0.10.4"
   },
   "devDependencies": {
     "@types/bun": "^1.2.18",