@aigne/core 1.60.1 → 1.60.3

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.60.3](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.60.2...core-v1.60.3) (2025-09-18)
+
+
+### Bug Fixes
+
+* **models:** convert local image to base64 for image model ([#517](https://github.com/AIGNE-io/aigne-framework/issues/517)) ([c0bc971](https://github.com/AIGNE-io/aigne-framework/commit/c0bc971087ef6e1caa641a699aed391a24feb40d))
+* **models:** convert local image to base64 for image model ([#517](https://github.com/AIGNE-io/aigne-framework/issues/517)) ([c0bc971](https://github.com/AIGNE-io/aigne-framework/commit/c0bc971087ef6e1caa641a699aed391a24feb40d))
+
+## [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)
 
 

package/lib/cjs/agents/image-model.d.ts

@@ -15,6 +15,7 @@ export declare abstract class ImageModel<I extends ImageModelInput = ImageModelI
     protected preprocess(input: I, options: AgentInvokeOptions): Promise<void>;
     protected postprocess(input: I, output: O, options: AgentInvokeOptions): Promise<void>;
     abstract process(input: I, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
+    protected downloadFile(url: string, timeout?: number): Promise<Response>;
 }
 export interface ImageModelInput extends Message {
     model?: string;

package/lib/cjs/agents/image-model.js

@@ -34,6 +34,21 @@ class ImageModel extends agent_js_1.Agent {
                 options.context.usage.aigneHubCredits += usage.aigneHubCredits;
         }
     }
+    async downloadFile(url, timeout = 30000) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(url, { signal: controller.signal });
+            if (!response.ok) {
+                const text = await response.text().catch(() => null);
+                throw new Error(`Failed to download content from ${url}, ${response.status} ${response.statusText} ${text}`);
+            }
+            return response;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
 }
 exports.ImageModel = ImageModel;
 exports.imageModelInputSchema = zod_1.z.object({

package/lib/cjs/agents/mcp-agent.js

@@ -239,7 +239,7 @@ class ClientWithReconnect extends index_js_2.Client {
         super(info, options);
         this.reconnectOptions = reconnectOptions;
     }
-    shouldReconnect(error) {
+    shouldReconnect({ error }) {
         const { transportCreator, shouldReconnect, maxReconnects } = this.reconnectOptions || {};
         if (!transportCreator || maxReconnects === 0)
             return false;

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/dts/agents/image-model.d.ts

@@ -15,6 +15,7 @@ export declare abstract class ImageModel<I extends ImageModelInput = ImageModelI
     protected preprocess(input: I, options: AgentInvokeOptions): Promise<void>;
     protected postprocess(input: I, output: O, options: AgentInvokeOptions): Promise<void>;
     abstract process(input: I, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
+    protected downloadFile(url: string, timeout?: number): Promise<Response>;
 }
 export interface ImageModelInput extends Message {
     model?: string;

package/lib/esm/agents/image-model.d.ts

@@ -15,6 +15,7 @@ export declare abstract class ImageModel<I extends ImageModelInput = ImageModelI
     protected preprocess(input: I, options: AgentInvokeOptions): Promise<void>;
     protected postprocess(input: I, output: O, options: AgentInvokeOptions): Promise<void>;
     abstract process(input: I, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
+    protected downloadFile(url: string, timeout?: number): Promise<Response>;
 }
 export interface ImageModelInput extends Message {
     model?: string;

package/lib/esm/agents/image-model.js

@@ -31,6 +31,21 @@ export class ImageModel extends Agent {
                 options.context.usage.aigneHubCredits += usage.aigneHubCredits;
         }
     }
+    async downloadFile(url, timeout = 30000) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(url, { signal: controller.signal });
+            if (!response.ok) {
+                const text = await response.text().catch(() => null);
+                throw new Error(`Failed to download content from ${url}, ${response.status} ${response.statusText} ${text}`);
+            }
+            return response;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
 }
 export const imageModelInputSchema = z.object({
     model: z.string().optional(),

package/lib/esm/agents/mcp-agent.js

@@ -202,7 +202,7 @@ class ClientWithReconnect extends Client {
         super(info, options);
         this.reconnectOptions = reconnectOptions;
     }
-    shouldReconnect(error) {
+    shouldReconnect({ error }) {
         const { transportCreator, shouldReconnect, maxReconnects } = this.reconnectOptions || {};
         if (!transportCreator || maxReconnects === 0)
             return 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.1",
+  "version": "1.60.3",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -66,48 +66,48 @@
   },
   "dependencies": {
     "@aigne/json-schema-to-zod": "^1.3.3",
-    "@inquirer/prompts": "^7.8.4",
-    "@modelcontextprotocol/sdk": "^1.15.0",
+    "@inquirer/prompts": "^7.8.6",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/sdk-trace-base": "^2.0.1",
+    "@opentelemetry/sdk-trace-base": "^2.1.0",
     "@types/debug": "^4.1.12",
     "ajv": "^8.17.1",
     "camelize-ts": "^3.0.0",
     "content-type": "^1.0.5",
-    "debug": "^4.4.1",
-    "eventsource-parser": "^3.0.3",
+    "debug": "^4.4.3",
+    "eventsource-parser": "^3.0.6",
     "fast-deep-equal": "^3.1.3",
     "fastq": "^1.19.1",
-    "immer": "^10.1.1",
-    "is-network-error": "^1.1.0",
+    "immer": "^10.1.3",
+    "is-network-error": "^1.2.0",
     "jaison": "^2.0.2",
-    "jsonata": "^2.0.6",
-    "mime": "^4.0.7",
+    "jsonata": "^2.1.0",
+    "mime": "^4.1.0",
     "nunjucks": "^3.2.4",
-    "p-retry": "^6.2.1",
-    "raw-body": "^3.0.0",
+    "p-retry": "^7.0.0",
+    "raw-body": "^3.0.1",
     "strict-event-emitter": "^0.5.1",
     "ufo": "^1.6.1",
-    "uuid": "^11.1.0",
-    "yaml": "^2.8.0",
+    "uuid": "^13.0.0",
+    "yaml": "^2.8.1",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
     "@aigne/observability-api": "^0.10.4",
     "@aigne/platform-helpers": "^0.6.2"
   },
   "devDependencies": {
-    "@types/bun": "^1.2.18",
+    "@types/bun": "^1.2.22",
     "@types/compression": "^1.8.1",
     "@types/content-type": "^1.1.9",
     "@types/express": "^5.0.3",
-    "@types/node": "^24.0.12",
+    "@types/node": "^24.5.1",
     "@types/nunjucks": "^3.2.6",
-    "compression": "^1.8.0",
+    "compression": "^1.8.1",
     "detect-port": "^2.1.0",
     "express": "^5.1.0",
     "npm-run-all": "^4.1.5",
     "rimraf": "^6.0.1",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.2"
   },
   "scripts": {
     "lint": "tsc --noEmit",