@aigne/core 1.66.0 → 1.67.0-beta

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [1.67.0-beta](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.66.0...core-v1.67.0-beta) (2025-11-11)
+
+
+### Features
+
+* **core:** add tson.stringify filter for prompt template ([#725](https://github.com/AIGNE-io/aigne-framework/issues/725)) ([c88e71c](https://github.com/AIGNE-io/aigne-framework/commit/c88e71c245a3eaa8a2d60f25c75368bced35fde2))
+
+
+### Bug Fixes
+
+* **core:** improve checkArguments error messages and refactor optional schemas ([#726](https://github.com/AIGNE-io/aigne-framework/issues/726)) ([8680f43](https://github.com/AIGNE-io/aigne-framework/commit/8680f43e6ad224eb84948b056c51e80ef8c47e06))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/observability-api bumped to 0.11.6-beta
+
 ## [1.66.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.66.0-beta.5...core-v1.66.0) (2025-11-07)
 
 

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

@@ -486,7 +486,7 @@ export interface ChatModelOutputUsage {
 export declare const chatModelOutputUsageSchema: z.ZodObject<{
     inputTokens: z.ZodNumber;
     outputTokens: z.ZodNumber;
-    aigneHubCredits: z.ZodOptional<z.ZodNumber>;
+    aigneHubCredits: z.ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
 }, "strip", z.ZodTypeAny, {
     inputTokens: number;
     outputTokens: number;

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

@@ -37,6 +37,7 @@ exports.chatModelOutputUsageSchema = exports.unionContentSchema = exports.textCo
 const index_js_1 = require("@aigne/platform-helpers/nodejs/index.js");
 const zod_1 = require("zod");
 const zod_from_json_schema_1 = require("zod-from-json-schema");
+const schema_js_1 = require("../loader/schema.js");
 const json_schema_js_1 = require("../utils/json-schema.js");
 const logger_js_1 = require("../utils/logger.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
@@ -310,19 +311,17 @@ exports.unionContentSchema = zod_1.z.discriminatedUnion("type", [
 ]);
 const chatModelInputMessageSchema = zod_1.z.object({
     role: zod_1.z.union([zod_1.z.literal("system"), zod_1.z.literal("user"), zod_1.z.literal("agent"), zod_1.z.literal("tool")]),
-    content: zod_1.z.union([zod_1.z.string(), zod_1.z.array(exports.unionContentSchema)]).optional(),
-    toolCalls: zod_1.z
-        .array(zod_1.z.object({
+    content: (0, schema_js_1.optionalize)(zod_1.z.union([zod_1.z.string(), zod_1.z.array(exports.unionContentSchema)])),
+    toolCalls: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.object({
         id: zod_1.z.string(),
         type: zod_1.z.literal("function"),
         function: zod_1.z.object({
             name: zod_1.z.string(),
             arguments: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
         }),
-    }))
-        .optional(),
-    toolCallId: zod_1.z.string().optional(),
-    name: zod_1.z.string().optional(),
+    }))),
+    toolCallId: (0, schema_js_1.optionalize)(zod_1.z.string()),
+    name: (0, schema_js_1.optionalize)(zod_1.z.string()),
 });
 const chatModelInputResponseFormatSchema = zod_1.z.discriminatedUnion("type", [
     zod_1.z.object({ type: zod_1.z.literal("text") }),
@@ -330,9 +329,9 @@ const chatModelInputResponseFormatSchema = zod_1.z.discriminatedUnion("type", [
         type: zod_1.z.literal("json_schema"),
         jsonSchema: zod_1.z.object({
             name: zod_1.z.string(),
-            description: zod_1.z.string().optional(),
+            description: (0, schema_js_1.optionalize)(zod_1.z.string()),
             schema: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
-            strict: zod_1.z.boolean().optional(),
+            strict: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
         }),
     }),
 ]);
@@ -340,7 +339,7 @@ const chatModelInputToolSchema = zod_1.z.object({
     type: zod_1.z.literal("function"),
     function: zod_1.z.object({
         name: zod_1.z.string(),
-        description: zod_1.z.string().optional(),
+        description: (0, schema_js_1.optionalize)(zod_1.z.string()),
         parameters: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
     }),
 });
@@ -351,31 +350,31 @@ const chatModelInputToolChoiceSchema = zod_1.z.union([
     chatModelInputToolSchema,
 ]);
 const modelOptionsSchema = zod_1.z.object({
-    model: (0, agent_js_1.getterSchema)(zod_1.z.string()).optional(),
-    temperature: (0, agent_js_1.getterSchema)(zod_1.z.number()).optional(),
-    topP: (0, agent_js_1.getterSchema)(zod_1.z.number()).optional(),
-    frequencyPenalty: (0, agent_js_1.getterSchema)(zod_1.z.number()).optional(),
-    presencePenalty: (0, agent_js_1.getterSchema)(zod_1.z.number()).optional(),
-    parallelToolCalls: (0, agent_js_1.getterSchema)(zod_1.z.boolean()).optional().default(true),
-    modalities: (0, agent_js_1.getterSchema)(zod_1.z.array(zod_1.z.enum(["text", "image", "audio"]))).optional(),
-    reasoningEffort: (0, agent_js_1.getterSchema)(zod_1.z.union([
+    model: (0, schema_js_1.optionalize)((0, agent_js_1.getterSchema)(zod_1.z.string())),
+    temperature: (0, schema_js_1.optionalize)((0, agent_js_1.getterSchema)(zod_1.z.number())),
+    topP: (0, schema_js_1.optionalize)((0, agent_js_1.getterSchema)(zod_1.z.number())),
+    frequencyPenalty: (0, schema_js_1.optionalize)((0, agent_js_1.getterSchema)(zod_1.z.number())),
+    presencePenalty: (0, schema_js_1.optionalize)((0, agent_js_1.getterSchema)(zod_1.z.number())),
+    parallelToolCalls: (0, schema_js_1.optionalize)((0, agent_js_1.getterSchema)(zod_1.z.boolean())).default(true),
+    modalities: (0, schema_js_1.optionalize)((0, agent_js_1.getterSchema)(zod_1.z.array(zod_1.z.enum(["text", "image", "audio"])))),
+    reasoningEffort: (0, schema_js_1.optionalize)((0, agent_js_1.getterSchema)(zod_1.z.union([
         zod_1.z.number(),
         zod_1.z.literal("minimal"),
         zod_1.z.literal("low"),
         zod_1.z.literal("medium"),
         zod_1.z.literal("high"),
-    ])).optional(),
+    ]))),
 });
 const chatModelOptionsSchema = agent_js_1.agentOptionsSchema.extend({
-    model: zod_1.z.string().optional(),
-    modelOptions: modelOptionsSchema.optional(),
+    model: (0, schema_js_1.optionalize)(zod_1.z.string()),
+    modelOptions: (0, schema_js_1.optionalize)(modelOptionsSchema),
 });
 const chatModelInputSchema = zod_1.z.object({
     messages: zod_1.z.array(chatModelInputMessageSchema),
-    responseFormat: chatModelInputResponseFormatSchema.optional(),
-    tools: zod_1.z.array(chatModelInputToolSchema).optional(),
-    toolChoice: chatModelInputToolChoiceSchema.optional(),
-    modelOptions: modelOptionsSchema.optional(),
+    responseFormat: (0, schema_js_1.optionalize)(chatModelInputResponseFormatSchema),
+    tools: (0, schema_js_1.optionalize)(zod_1.z.array(chatModelInputToolSchema)),
+    toolChoice: (0, schema_js_1.optionalize)(chatModelInputToolChoiceSchema),
+    modelOptions: (0, schema_js_1.optionalize)(modelOptionsSchema),
 });
 const chatModelOutputToolCallSchema = zod_1.z.object({
     id: zod_1.z.string(),
@@ -388,14 +387,14 @@ const chatModelOutputToolCallSchema = zod_1.z.object({
 exports.chatModelOutputUsageSchema = zod_1.z.object({
     inputTokens: zod_1.z.number(),
     outputTokens: zod_1.z.number(),
-    aigneHubCredits: zod_1.z.number().optional(),
+    aigneHubCredits: (0, schema_js_1.optionalize)(zod_1.z.number()),
 });
 const chatModelOutputSchema = zod_1.z.object({
-    text: zod_1.z.string().optional(),
-    thoughts: zod_1.z.string().optional(),
-    json: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-    toolCalls: zod_1.z.array(chatModelOutputToolCallSchema).optional(),
-    usage: exports.chatModelOutputUsageSchema.optional(),
-    model: zod_1.z.string().optional(),
-    files: zod_1.z.array(model_js_1.fileUnionContentSchema).optional(),
+    text: (0, schema_js_1.optionalize)(zod_1.z.string()),
+    thoughts: (0, schema_js_1.optionalize)(zod_1.z.string()),
+    json: (0, schema_js_1.optionalize)(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())),
+    toolCalls: (0, schema_js_1.optionalize)(zod_1.z.array(chatModelOutputToolCallSchema)),
+    usage: (0, schema_js_1.optionalize)(exports.chatModelOutputUsageSchema),
+    model: (0, schema_js_1.optionalize)(zod_1.z.string()),
+    files: (0, schema_js_1.optionalize)(zod_1.z.array(model_js_1.fileUnionContentSchema)),
 });

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

@@ -195,7 +195,7 @@ export declare const imageModelOutputSchema: z.ZodObject<{
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
-        aigneHubCredits: z.ZodOptional<z.ZodNumber>;
+        aigneHubCredits: ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
     }, "strip", z.ZodTypeAny, {
         inputTokens: number;
         outputTokens: number;

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

@@ -202,7 +202,7 @@ export declare const videoModelOutputSchema: z.ZodObject<{
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
-        aigneHubCredits: z.ZodOptional<z.ZodNumber>;
+        aigneHubCredits: ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
     }, "strip", z.ZodTypeAny, {
         inputTokens: number;
         outputTokens: number;

package/lib/cjs/prompt/filters/index.js

@@ -1,6 +1,40 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupFilters = setupFilters;
+const tson = __importStar(require("@zenoaihq/tson"));
 const yaml_1 = require("yaml");
 function setupFilters(env) {
     env.addFilter("yaml.stringify", (obj) => {
@@ -9,4 +43,7 @@ function setupFilters(env) {
     env.addFilter("json.stringify", (obj, ...args) => {
         return JSON.stringify(obj, ...args);
     });
+    env.addFilter("tson.stringify", (obj) => {
+        return tson.dumps(obj);
+    });
 }

package/lib/cjs/utils/type-utils.d.ts

@@ -15,6 +15,7 @@ export declare function isNotEmpty<T>(arr: T[]): arr is [T, ...T[]];
 export declare function duplicates<T>(arr: T[], key?: (item: T) => unknown): T[];
 export declare function remove<T>(arr: T[], remove: T[] | ((item: T) => boolean)): T[];
 export declare function unique<T>(arr: T[], key?: (item: T) => unknown): T[];
+export declare function get(obj: any, path: (string | number | symbol)[]): any;
 export declare function pick<T extends object, K extends keyof T>(obj: T, ...keys: (K | K[])[]): Pick<T, K>;
 export declare function omit<T extends object, K extends keyof T>(obj: T, ...keys: (K | K[])[]): Omit<T, K>;
 export declare function omitDeep<T, K>(obj: T, ...keys: (K | K[])[]): unknown;

package/lib/cjs/utils/type-utils.js

@@ -8,6 +8,7 @@ exports.isNotEmpty = isNotEmpty;
 exports.duplicates = duplicates;
 exports.remove = remove;
 exports.unique = unique;
+exports.get = get;
 exports.pick = pick;
 exports.omit = omit;
 exports.omitDeep = omitDeep;
@@ -78,6 +79,9 @@ function unique(arr, key = (item) => item) {
         return true;
     });
 }
+function get(obj, path) {
+    return path.reduce((acc, key) => (isRecord(acc) ? Reflect.get(acc, key) : undefined), obj);
+}
 function pick(obj, ...keys) {
     const flattenedKeys = new Set(keys.flat());
     return Object.fromEntries(Object.entries(obj).filter(([key]) => flattenedKeys.has(key)));
@@ -132,46 +136,33 @@ function createAccessorArray(array, accessor) {
 }
 function checkArguments(prefix, schema, args) {
     try {
-        return schema.parse(args, {
-            errorMap: (issue, ctx) => {
-                if (issue.code === "invalid_union") {
-                    // handle all issues that are not invalid_type
-                    const otherQuestions = issue.unionErrors
-                        .map(({ issues: [issue] }) => {
-                        if (issue && issue.code !== "invalid_type") {
-                            return issue.message || zod_1.z.defaultErrorMap(issue, ctx).message;
-                        }
-                    })
-                        .filter(isNonNullable);
-                    if (otherQuestions.length) {
-                        return { message: otherQuestions.join(", ") };
-                    }
-                    // handle invalid_type issues
-                    const expected = issue.unionErrors
-                        .map(({ issues: [issue] }) => {
-                        if (issue?.code === "invalid_type") {
-                            return issue;
-                        }
-                    })
-                        .filter(isNonNullable);
-                    if (expected.length) {
-                        return {
-                            message: `Expected ${expected.map((i) => i.expected).join(" or ")}, received ${expected[0]?.received}`,
-                        };
-                    }
-                }
-                return { message: ctx.defaultError };
-            },
-        });
+        return schema.parse(args);
     }
     catch (error) {
         if (error instanceof zod_1.z.ZodError) {
-            const message = error.issues.map((i) => `${i.path}: ${i.message}`).join(", ");
+            const message = error.issues
+                .map((i) => {
+                const msg = i.code === "invalid_union"
+                    ? `${i.message} expect ${getExpectedTypes(i)} got ${get(args, i.path)}`
+                    : i.message;
+                return `${i.path}: ${msg}`;
+            })
+                .join(", ");
             throw new Error(`${prefix} check arguments error: ${message}`);
         }
         throw error;
     }
 }
+function getExpectedTypes(issue) {
+    if (Array.isArray(issue))
+        return issue.flatMap((issue) => getExpectedTypes(issue));
+    if ("expected" in issue)
+        return [String(issue.expected)];
+    if (issue.code === "invalid_union") {
+        return issue.unionErrors.flatMap((e) => getExpectedTypes(e.issues));
+    }
+    return [];
+}
 function tryOrThrow(fn, error) {
     const createError = (e) => {
         return typeof error === "function"

package/lib/dts/agents/chat-model.d.ts

@@ -486,7 +486,7 @@ export interface ChatModelOutputUsage {
 export declare const chatModelOutputUsageSchema: z.ZodObject<{
     inputTokens: z.ZodNumber;
     outputTokens: z.ZodNumber;
-    aigneHubCredits: z.ZodOptional<z.ZodNumber>;
+    aigneHubCredits: z.ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
 }, "strip", z.ZodTypeAny, {
     inputTokens: number;
     outputTokens: number;

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

@@ -195,7 +195,7 @@ export declare const imageModelOutputSchema: z.ZodObject<{
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
-        aigneHubCredits: z.ZodOptional<z.ZodNumber>;
+        aigneHubCredits: ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
     }, "strip", z.ZodTypeAny, {
         inputTokens: number;
         outputTokens: number;

package/lib/dts/agents/video-model.d.ts

@@ -202,7 +202,7 @@ export declare const videoModelOutputSchema: z.ZodObject<{
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
-        aigneHubCredits: z.ZodOptional<z.ZodNumber>;
+        aigneHubCredits: ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
     }, "strip", z.ZodTypeAny, {
         inputTokens: number;
         outputTokens: number;

package/lib/dts/utils/type-utils.d.ts

@@ -15,6 +15,7 @@ export declare function isNotEmpty<T>(arr: T[]): arr is [T, ...T[]];
 export declare function duplicates<T>(arr: T[], key?: (item: T) => unknown): T[];
 export declare function remove<T>(arr: T[], remove: T[] | ((item: T) => boolean)): T[];
 export declare function unique<T>(arr: T[], key?: (item: T) => unknown): T[];
+export declare function get(obj: any, path: (string | number | symbol)[]): any;
 export declare function pick<T extends object, K extends keyof T>(obj: T, ...keys: (K | K[])[]): Pick<T, K>;
 export declare function omit<T extends object, K extends keyof T>(obj: T, ...keys: (K | K[])[]): Omit<T, K>;
 export declare function omitDeep<T, K>(obj: T, ...keys: (K | K[])[]): unknown;

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

@@ -486,7 +486,7 @@ export interface ChatModelOutputUsage {
 export declare const chatModelOutputUsageSchema: z.ZodObject<{
     inputTokens: z.ZodNumber;
     outputTokens: z.ZodNumber;
-    aigneHubCredits: z.ZodOptional<z.ZodNumber>;
+    aigneHubCredits: z.ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
 }, "strip", z.ZodTypeAny, {
     inputTokens: number;
     outputTokens: number;

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

@@ -1,6 +1,7 @@
 import { nodejs } from "@aigne/platform-helpers/nodejs/index.js";
 import { z } from "zod";
 import { convertJsonSchemaToZod } from "zod-from-json-schema";
+import { optionalize } from "../loader/schema.js";
 import { wrapAutoParseJsonSchema } from "../utils/json-schema.js";
 import { logger } from "../utils/logger.js";
 import { checkArguments, isNil, omitByDeep } from "../utils/type-utils.js";
@@ -272,19 +273,17 @@ export const unionContentSchema = z.discriminatedUnion("type", [
 ]);
 const chatModelInputMessageSchema = z.object({
     role: z.union([z.literal("system"), z.literal("user"), z.literal("agent"), z.literal("tool")]),
-    content: z.union([z.string(), z.array(unionContentSchema)]).optional(),
-    toolCalls: z
-        .array(z.object({
+    content: optionalize(z.union([z.string(), z.array(unionContentSchema)])),
+    toolCalls: optionalize(z.array(z.object({
         id: z.string(),
         type: z.literal("function"),
         function: z.object({
             name: z.string(),
             arguments: z.record(z.string(), z.unknown()),
         }),
-    }))
-        .optional(),
-    toolCallId: z.string().optional(),
-    name: z.string().optional(),
+    }))),
+    toolCallId: optionalize(z.string()),
+    name: optionalize(z.string()),
 });
 const chatModelInputResponseFormatSchema = z.discriminatedUnion("type", [
     z.object({ type: z.literal("text") }),
@@ -292,9 +291,9 @@ const chatModelInputResponseFormatSchema = z.discriminatedUnion("type", [
         type: z.literal("json_schema"),
         jsonSchema: z.object({
             name: z.string(),
-            description: z.string().optional(),
+            description: optionalize(z.string()),
             schema: z.record(z.string(), z.unknown()),
-            strict: z.boolean().optional(),
+            strict: optionalize(z.boolean()),
         }),
     }),
 ]);
@@ -302,7 +301,7 @@ const chatModelInputToolSchema = z.object({
     type: z.literal("function"),
     function: z.object({
         name: z.string(),
-        description: z.string().optional(),
+        description: optionalize(z.string()),
         parameters: z.record(z.string(), z.unknown()),
     }),
 });
@@ -313,31 +312,31 @@ const chatModelInputToolChoiceSchema = z.union([
     chatModelInputToolSchema,
 ]);
 const modelOptionsSchema = z.object({
-    model: getterSchema(z.string()).optional(),
-    temperature: getterSchema(z.number()).optional(),
-    topP: getterSchema(z.number()).optional(),
-    frequencyPenalty: getterSchema(z.number()).optional(),
-    presencePenalty: getterSchema(z.number()).optional(),
-    parallelToolCalls: getterSchema(z.boolean()).optional().default(true),
-    modalities: getterSchema(z.array(z.enum(["text", "image", "audio"]))).optional(),
-    reasoningEffort: getterSchema(z.union([
+    model: optionalize(getterSchema(z.string())),
+    temperature: optionalize(getterSchema(z.number())),
+    topP: optionalize(getterSchema(z.number())),
+    frequencyPenalty: optionalize(getterSchema(z.number())),
+    presencePenalty: optionalize(getterSchema(z.number())),
+    parallelToolCalls: optionalize(getterSchema(z.boolean())).default(true),
+    modalities: optionalize(getterSchema(z.array(z.enum(["text", "image", "audio"])))),
+    reasoningEffort: optionalize(getterSchema(z.union([
         z.number(),
         z.literal("minimal"),
         z.literal("low"),
         z.literal("medium"),
         z.literal("high"),
-    ])).optional(),
+    ]))),
 });
 const chatModelOptionsSchema = agentOptionsSchema.extend({
-    model: z.string().optional(),
-    modelOptions: modelOptionsSchema.optional(),
+    model: optionalize(z.string()),
+    modelOptions: optionalize(modelOptionsSchema),
 });
 const chatModelInputSchema = z.object({
     messages: z.array(chatModelInputMessageSchema),
-    responseFormat: chatModelInputResponseFormatSchema.optional(),
-    tools: z.array(chatModelInputToolSchema).optional(),
-    toolChoice: chatModelInputToolChoiceSchema.optional(),
-    modelOptions: modelOptionsSchema.optional(),
+    responseFormat: optionalize(chatModelInputResponseFormatSchema),
+    tools: optionalize(z.array(chatModelInputToolSchema)),
+    toolChoice: optionalize(chatModelInputToolChoiceSchema),
+    modelOptions: optionalize(modelOptionsSchema),
 });
 const chatModelOutputToolCallSchema = z.object({
     id: z.string(),
@@ -350,14 +349,14 @@ const chatModelOutputToolCallSchema = z.object({
 export const chatModelOutputUsageSchema = z.object({
     inputTokens: z.number(),
     outputTokens: z.number(),
-    aigneHubCredits: z.number().optional(),
+    aigneHubCredits: optionalize(z.number()),
 });
 const chatModelOutputSchema = z.object({
-    text: z.string().optional(),
-    thoughts: z.string().optional(),
-    json: z.record(z.string(), z.unknown()).optional(),
-    toolCalls: z.array(chatModelOutputToolCallSchema).optional(),
-    usage: chatModelOutputUsageSchema.optional(),
-    model: z.string().optional(),
-    files: z.array(fileUnionContentSchema).optional(),
+    text: optionalize(z.string()),
+    thoughts: optionalize(z.string()),
+    json: optionalize(z.record(z.string(), z.unknown())),
+    toolCalls: optionalize(z.array(chatModelOutputToolCallSchema)),
+    usage: optionalize(chatModelOutputUsageSchema),
+    model: optionalize(z.string()),
+    files: optionalize(z.array(fileUnionContentSchema)),
 });

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

@@ -195,7 +195,7 @@ export declare const imageModelOutputSchema: z.ZodObject<{
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
-        aigneHubCredits: z.ZodOptional<z.ZodNumber>;
+        aigneHubCredits: ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
     }, "strip", z.ZodTypeAny, {
         inputTokens: number;
         outputTokens: number;

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

@@ -202,7 +202,7 @@ export declare const videoModelOutputSchema: z.ZodObject<{
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
-        aigneHubCredits: z.ZodOptional<z.ZodNumber>;
+        aigneHubCredits: ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
     }, "strip", z.ZodTypeAny, {
         inputTokens: number;
         outputTokens: number;

package/lib/esm/prompt/filters/index.js

@@ -1,3 +1,4 @@
+import * as tson from "@zenoaihq/tson";
 import { stringify } from "yaml";
 export function setupFilters(env) {
     env.addFilter("yaml.stringify", (obj) => {
@@ -6,4 +7,7 @@ export function setupFilters(env) {
     env.addFilter("json.stringify", (obj, ...args) => {
         return JSON.stringify(obj, ...args);
     });
+    env.addFilter("tson.stringify", (obj) => {
+        return tson.dumps(obj);
+    });
 }

package/lib/esm/utils/type-utils.d.ts

@@ -15,6 +15,7 @@ export declare function isNotEmpty<T>(arr: T[]): arr is [T, ...T[]];
 export declare function duplicates<T>(arr: T[], key?: (item: T) => unknown): T[];
 export declare function remove<T>(arr: T[], remove: T[] | ((item: T) => boolean)): T[];
 export declare function unique<T>(arr: T[], key?: (item: T) => unknown): T[];
+export declare function get(obj: any, path: (string | number | symbol)[]): any;
 export declare function pick<T extends object, K extends keyof T>(obj: T, ...keys: (K | K[])[]): Pick<T, K>;
 export declare function omit<T extends object, K extends keyof T>(obj: T, ...keys: (K | K[])[]): Omit<T, K>;
 export declare function omitDeep<T, K>(obj: T, ...keys: (K | K[])[]): unknown;

package/lib/esm/utils/type-utils.js

@@ -58,6 +58,9 @@ export function unique(arr, key = (item) => item) {
         return true;
     });
 }
+export function get(obj, path) {
+    return path.reduce((acc, key) => (isRecord(acc) ? Reflect.get(acc, key) : undefined), obj);
+}
 export function pick(obj, ...keys) {
     const flattenedKeys = new Set(keys.flat());
     return Object.fromEntries(Object.entries(obj).filter(([key]) => flattenedKeys.has(key)));
@@ -112,46 +115,33 @@ export function createAccessorArray(array, accessor) {
 }
 export function checkArguments(prefix, schema, args) {
     try {
-        return schema.parse(args, {
-            errorMap: (issue, ctx) => {
-                if (issue.code === "invalid_union") {
-                    // handle all issues that are not invalid_type
-                    const otherQuestions = issue.unionErrors
-                        .map(({ issues: [issue] }) => {
-                        if (issue && issue.code !== "invalid_type") {
-                            return issue.message || z.defaultErrorMap(issue, ctx).message;
-                        }
-                    })
-                        .filter(isNonNullable);
-                    if (otherQuestions.length) {
-                        return { message: otherQuestions.join(", ") };
-                    }
-                    // handle invalid_type issues
-                    const expected = issue.unionErrors
-                        .map(({ issues: [issue] }) => {
-                        if (issue?.code === "invalid_type") {
-                            return issue;
-                        }
-                    })
-                        .filter(isNonNullable);
-                    if (expected.length) {
-                        return {
-                            message: `Expected ${expected.map((i) => i.expected).join(" or ")}, received ${expected[0]?.received}`,
-                        };
-                    }
-                }
-                return { message: ctx.defaultError };
-            },
-        });
+        return schema.parse(args);
     }
     catch (error) {
         if (error instanceof z.ZodError) {
-            const message = error.issues.map((i) => `${i.path}: ${i.message}`).join(", ");
+            const message = error.issues
+                .map((i) => {
+                const msg = i.code === "invalid_union"
+                    ? `${i.message} expect ${getExpectedTypes(i)} got ${get(args, i.path)}`
+                    : i.message;
+                return `${i.path}: ${msg}`;
+            })
+                .join(", ");
             throw new Error(`${prefix} check arguments error: ${message}`);
         }
         throw error;
     }
 }
+function getExpectedTypes(issue) {
+    if (Array.isArray(issue))
+        return issue.flatMap((issue) => getExpectedTypes(issue));
+    if ("expected" in issue)
+        return [String(issue.expected)];
+    if (issue.code === "invalid_union") {
+        return issue.unionErrors.flatMap((e) => getExpectedTypes(e.issues));
+    }
+    return [];
+}
 export function tryOrThrow(fn, error) {
     const createError = (e) => {
         return typeof error === "function"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.66.0",
+  "version": "1.67.0-beta",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -72,6 +72,7 @@
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/sdk-trace-base": "^2.1.0",
     "@types/debug": "^4.1.12",
+    "@zenoaihq/tson": "^1.0.0",
     "camelize-ts": "^3.0.0",
     "content-type": "^1.0.5",
     "debug": "^4.4.3",
@@ -91,7 +92,7 @@
     "zod": "^3.25.67",
     "zod-from-json-schema": "^0.0.5",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/observability-api": "^0.11.5",
+    "@aigne/observability-api": "^0.11.6-beta",
     "@aigne/platform-helpers": "^0.6.3",
     "@aigne/afs": "^1.1.1"
   },