@aigne/core 1.43.0 → 1.43.1

package/CHANGELOG.md

@@ -12,6 +12,13 @@
   * dependencies
     * @aigne/observability bumped to 0.1.0
 
+## [1.43.1](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.43.0...core-v1.43.1) (2025-08-05)
+
+
+### Bug Fixes
+
+* **core:** filter empty memory content ([#312](https://github.com/AIGNE-io/aigne-framework/issues/312)) ([39dd77a](https://github.com/AIGNE-io/aigne-framework/commit/39dd77a68154d51c7a132adccd9f21b8bc461be0))
+
 ## [1.43.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.42.0...core-v1.43.0) (2025-08-04)
 
 

package/README.md

@@ -1,5 +1,13 @@
 # @aigne/core
 
+<p align="center">
+  <picture>
+    <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/logo-dark.svg" media="(prefers-color-scheme: dark)">
+    <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/logo.svg" media="(prefers-color-scheme: light)">
+    <img src="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/logo.svg" alt="AIGNE Logo" width="400" />
+  </picture>
+</p>
+
 [![GitHub star chart](https://img.shields.io/github/stars/AIGNE-io/aigne-framework?style=flat-square)](https://star-history.com/#AIGNE-io/aigne-framework)
 [![Open Issues](https://img.shields.io/github/issues-raw/AIGNE-io/aigne-framework?style=flat-square)](https://github.com/AIGNE-io/aigne-framework/issues)
 [![codecov](https://codecov.io/gh/AIGNE-io/aigne-framework/graph/badge.svg?token=DO07834RQL)](https://codecov.io/gh/AIGNE-io/aigne-framework)

package/lib/cjs/index.d.ts

@@ -11,4 +11,6 @@ export * from "./aigne/index.js";
 export * from "./memory/index.js";
 export * from "./prompt/prompt-builder.js";
 export * from "./prompt/template.js";
+export * from "./utils/json-utils.js";
+export * from "./utils/role-utils.js";
 export * from "./utils/stream-utils.js";

package/lib/cjs/index.js

@@ -27,4 +27,6 @@ __exportStar(require("./aigne/index.js"), exports);
 __exportStar(require("./memory/index.js"), exports);
 __exportStar(require("./prompt/prompt-builder.js"), exports);
 __exportStar(require("./prompt/template.js"), exports);
+__exportStar(require("./utils/json-utils.js"), exports);
+__exportStar(require("./utils/role-utils.js"), exports);
 __exportStar(require("./utils/stream-utils.js"), exports);

package/lib/cjs/prompt/prompt-builder.js

@@ -110,7 +110,12 @@ class PromptBuilder {
         const stringOrStringify = (value) => typeof value === "string" ? value : (0, yaml_1.stringify)(value);
         for (const { content } of memories) {
             if ((0, type_utils_js_1.isRecord)(content) && "input" in content && "output" in content) {
-                messages.push({ role: "user", content: stringOrStringify(content.input) }, { role: "agent", content: stringOrStringify(content.output) });
+                if (!(0, type_utils_js_1.isNil)(content.input) && content.input !== "") {
+                    messages.push({ role: "user", content: stringOrStringify(content.input) });
+                }
+                if (!(0, type_utils_js_1.isNil)(content.output) && content.output !== "") {
+                    messages.push({ role: "agent", content: stringOrStringify(content.output) });
+                }
             }
             else {
                 other.push(content);

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

@@ -0,0 +1,24 @@
+/**
+ * Safely parses JSON text using jaison library which handles malformed JSON better than JSON.parse
+ *
+ * @param text - The text to parse as JSON
+ * @returns Parsed JSON object or null if parsing fails
+ *
+ * @example
+ * ```typescript
+ * const result = safeParseJSON('{"key": "value"}');
+ * console.log(result); // { key: "value" }
+ *
+ * const malformed = safeParseJSON('{"key": "value"'); // Missing closing brace
+ * console.log(malformed); // null
+ * ```
+ */
+export declare function safeParseJSON(text: string): any;
+/**
+ * Safely stringifies a value to JSON, handling errors gracefully
+ *
+ * @param value - The value to stringify
+ * @param space - Optional spacing for pretty printing
+ * @returns JSON string or null if stringification fails
+ */
+export declare function safeStringifyJSON(value: any, space?: number): string | null;

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

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeParseJSON = safeParseJSON;
+exports.safeStringifyJSON = safeStringifyJSON;
+const jaison_1 = __importDefault(require("jaison"));
+/**
+ * Safely parses JSON text using jaison library which handles malformed JSON better than JSON.parse
+ *
+ * @param text - The text to parse as JSON
+ * @returns Parsed JSON object or null if parsing fails
+ *
+ * @example
+ * ```typescript
+ * const result = safeParseJSON('{"key": "value"}');
+ * console.log(result); // { key: "value" }
+ *
+ * const malformed = safeParseJSON('{"key": "value"'); // Missing closing brace
+ * console.log(malformed); // null
+ * ```
+ */
+function safeParseJSON(text) {
+    if (!text)
+        return null;
+    try {
+        return (0, jaison_1.default)(text);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Safely stringifies a value to JSON, handling errors gracefully
+ *
+ * @param value - The value to stringify
+ * @param space - Optional spacing for pretty printing
+ * @returns JSON string or null if stringification fails
+ */
+function safeStringifyJSON(value, space) {
+    try {
+        return JSON.stringify(value, null, space);
+    }
+    catch {
+        return null;
+    }
+}

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

@@ -0,0 +1,31 @@
+import type { Role } from "../agents/chat-model.js";
+/**
+ * Standard role mapping for most chat model providers
+ * Maps AIGNE framework roles to common provider role names
+ */
+export declare const STANDARD_ROLE_MAP: {
+    [key in Role]: string;
+};
+/**
+ * Creates a role mapper function for a specific provider
+ *
+ * @param roleMap - Custom role mapping for the provider
+ * @returns Function that maps AIGNE roles to provider roles
+ *
+ * @example
+ * ```typescript
+ * // For standard providers (OpenAI, Anthropic, etc.)
+ * const mapRole = createRoleMapper(STANDARD_ROLE_MAP);
+ *
+ * // For providers with different role names
+ * const customMap = { ...STANDARD_ROLE_MAP, agent: "bot" };
+ * const customMapper = createRoleMapper(customMap);
+ * ```
+ */
+export declare function createRoleMapper<T extends string>(roleMap: {
+    [key in Role]: T;
+}): (role: Role) => T;
+/**
+ * Standard role mapper using the default role mapping
+ */
+export declare const mapStandardRole: (role: Role) => string;

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

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapStandardRole = exports.STANDARD_ROLE_MAP = void 0;
+exports.createRoleMapper = createRoleMapper;
+/**
+ * Standard role mapping for most chat model providers
+ * Maps AIGNE framework roles to common provider role names
+ */
+exports.STANDARD_ROLE_MAP = {
+    system: "system",
+    user: "user",
+    agent: "assistant",
+    tool: "tool",
+};
+/**
+ * Creates a role mapper function for a specific provider
+ *
+ * @param roleMap - Custom role mapping for the provider
+ * @returns Function that maps AIGNE roles to provider roles
+ *
+ * @example
+ * ```typescript
+ * // For standard providers (OpenAI, Anthropic, etc.)
+ * const mapRole = createRoleMapper(STANDARD_ROLE_MAP);
+ *
+ * // For providers with different role names
+ * const customMap = { ...STANDARD_ROLE_MAP, agent: "bot" };
+ * const customMapper = createRoleMapper(customMap);
+ * ```
+ */
+function createRoleMapper(roleMap) {
+    return (role) => roleMap[role];
+}
+/**
+ * Standard role mapper using the default role mapping
+ */
+exports.mapStandardRole = createRoleMapper(exports.STANDARD_ROLE_MAP);

package/lib/dts/index.d.ts

@@ -11,4 +11,6 @@ export * from "./aigne/index.js";
 export * from "./memory/index.js";
 export * from "./prompt/prompt-builder.js";
 export * from "./prompt/template.js";
+export * from "./utils/json-utils.js";
+export * from "./utils/role-utils.js";
 export * from "./utils/stream-utils.js";

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

@@ -0,0 +1,24 @@
+/**
+ * Safely parses JSON text using jaison library which handles malformed JSON better than JSON.parse
+ *
+ * @param text - The text to parse as JSON
+ * @returns Parsed JSON object or null if parsing fails
+ *
+ * @example
+ * ```typescript
+ * const result = safeParseJSON('{"key": "value"}');
+ * console.log(result); // { key: "value" }
+ *
+ * const malformed = safeParseJSON('{"key": "value"'); // Missing closing brace
+ * console.log(malformed); // null
+ * ```
+ */
+export declare function safeParseJSON(text: string): any;
+/**
+ * Safely stringifies a value to JSON, handling errors gracefully
+ *
+ * @param value - The value to stringify
+ * @param space - Optional spacing for pretty printing
+ * @returns JSON string or null if stringification fails
+ */
+export declare function safeStringifyJSON(value: any, space?: number): string | null;

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

@@ -0,0 +1,31 @@
+import type { Role } from "../agents/chat-model.js";
+/**
+ * Standard role mapping for most chat model providers
+ * Maps AIGNE framework roles to common provider role names
+ */
+export declare const STANDARD_ROLE_MAP: {
+    [key in Role]: string;
+};
+/**
+ * Creates a role mapper function for a specific provider
+ *
+ * @param roleMap - Custom role mapping for the provider
+ * @returns Function that maps AIGNE roles to provider roles
+ *
+ * @example
+ * ```typescript
+ * // For standard providers (OpenAI, Anthropic, etc.)
+ * const mapRole = createRoleMapper(STANDARD_ROLE_MAP);
+ *
+ * // For providers with different role names
+ * const customMap = { ...STANDARD_ROLE_MAP, agent: "bot" };
+ * const customMapper = createRoleMapper(customMap);
+ * ```
+ */
+export declare function createRoleMapper<T extends string>(roleMap: {
+    [key in Role]: T;
+}): (role: Role) => T;
+/**
+ * Standard role mapper using the default role mapping
+ */
+export declare const mapStandardRole: (role: Role) => string;

package/lib/esm/index.d.ts

@@ -11,4 +11,6 @@ export * from "./aigne/index.js";
 export * from "./memory/index.js";
 export * from "./prompt/prompt-builder.js";
 export * from "./prompt/template.js";
+export * from "./utils/json-utils.js";
+export * from "./utils/role-utils.js";
 export * from "./utils/stream-utils.js";

package/lib/esm/index.js

@@ -11,4 +11,6 @@ export * from "./aigne/index.js";
 export * from "./memory/index.js";
 export * from "./prompt/prompt-builder.js";
 export * from "./prompt/template.js";
+export * from "./utils/json-utils.js";
+export * from "./utils/role-utils.js";
 export * from "./utils/stream-utils.js";

package/lib/esm/prompt/prompt-builder.js

@@ -4,7 +4,7 @@ import { ZodObject } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { Agent } from "../agents/agent.js";
 import { outputSchemaToResponseFormatSchema } from "../utils/json-schema.js";
-import { isRecord, unique } from "../utils/type-utils.js";
+import { isNil, isRecord, unique } from "../utils/type-utils.js";
 import { MEMORY_MESSAGE_TEMPLATE } from "./prompts/memory-message-template.js";
 import { STRUCTURED_STREAM_INSTRUCTIONS } from "./prompts/structured-stream-instructions.js";
 import { AgentMessageTemplate, ChatMessagesTemplate, PromptTemplate, SystemMessageTemplate, UserMessageTemplate, } from "./template.js";
@@ -107,7 +107,12 @@ export class PromptBuilder {
         const stringOrStringify = (value) => typeof value === "string" ? value : stringify(value);
         for (const { content } of memories) {
             if (isRecord(content) && "input" in content && "output" in content) {
-                messages.push({ role: "user", content: stringOrStringify(content.input) }, { role: "agent", content: stringOrStringify(content.output) });
+                if (!isNil(content.input) && content.input !== "") {
+                    messages.push({ role: "user", content: stringOrStringify(content.input) });
+                }
+                if (!isNil(content.output) && content.output !== "") {
+                    messages.push({ role: "agent", content: stringOrStringify(content.output) });
+                }
             }
             else {
                 other.push(content);

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

@@ -0,0 +1,24 @@
+/**
+ * Safely parses JSON text using jaison library which handles malformed JSON better than JSON.parse
+ *
+ * @param text - The text to parse as JSON
+ * @returns Parsed JSON object or null if parsing fails
+ *
+ * @example
+ * ```typescript
+ * const result = safeParseJSON('{"key": "value"}');
+ * console.log(result); // { key: "value" }
+ *
+ * const malformed = safeParseJSON('{"key": "value"'); // Missing closing brace
+ * console.log(malformed); // null
+ * ```
+ */
+export declare function safeParseJSON(text: string): any;
+/**
+ * Safely stringifies a value to JSON, handling errors gracefully
+ *
+ * @param value - The value to stringify
+ * @param space - Optional spacing for pretty printing
+ * @returns JSON string or null if stringification fails
+ */
+export declare function safeStringifyJSON(value: any, space?: number): string | null;

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

@@ -0,0 +1,41 @@
+import jaison from "jaison";
+/**
+ * Safely parses JSON text using jaison library which handles malformed JSON better than JSON.parse
+ *
+ * @param text - The text to parse as JSON
+ * @returns Parsed JSON object or null if parsing fails
+ *
+ * @example
+ * ```typescript
+ * const result = safeParseJSON('{"key": "value"}');
+ * console.log(result); // { key: "value" }
+ *
+ * const malformed = safeParseJSON('{"key": "value"'); // Missing closing brace
+ * console.log(malformed); // null
+ * ```
+ */
+export function safeParseJSON(text) {
+    if (!text)
+        return null;
+    try {
+        return jaison(text);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Safely stringifies a value to JSON, handling errors gracefully
+ *
+ * @param value - The value to stringify
+ * @param space - Optional spacing for pretty printing
+ * @returns JSON string or null if stringification fails
+ */
+export function safeStringifyJSON(value, space) {
+    try {
+        return JSON.stringify(value, null, space);
+    }
+    catch {
+        return null;
+    }
+}

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

@@ -0,0 +1,31 @@
+import type { Role } from "../agents/chat-model.js";
+/**
+ * Standard role mapping for most chat model providers
+ * Maps AIGNE framework roles to common provider role names
+ */
+export declare const STANDARD_ROLE_MAP: {
+    [key in Role]: string;
+};
+/**
+ * Creates a role mapper function for a specific provider
+ *
+ * @param roleMap - Custom role mapping for the provider
+ * @returns Function that maps AIGNE roles to provider roles
+ *
+ * @example
+ * ```typescript
+ * // For standard providers (OpenAI, Anthropic, etc.)
+ * const mapRole = createRoleMapper(STANDARD_ROLE_MAP);
+ *
+ * // For providers with different role names
+ * const customMap = { ...STANDARD_ROLE_MAP, agent: "bot" };
+ * const customMapper = createRoleMapper(customMap);
+ * ```
+ */
+export declare function createRoleMapper<T extends string>(roleMap: {
+    [key in Role]: T;
+}): (role: Role) => T;
+/**
+ * Standard role mapper using the default role mapping
+ */
+export declare const mapStandardRole: (role: Role) => string;

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

@@ -0,0 +1,33 @@
+/**
+ * Standard role mapping for most chat model providers
+ * Maps AIGNE framework roles to common provider role names
+ */
+export const STANDARD_ROLE_MAP = {
+    system: "system",
+    user: "user",
+    agent: "assistant",
+    tool: "tool",
+};
+/**
+ * Creates a role mapper function for a specific provider
+ *
+ * @param roleMap - Custom role mapping for the provider
+ * @returns Function that maps AIGNE roles to provider roles
+ *
+ * @example
+ * ```typescript
+ * // For standard providers (OpenAI, Anthropic, etc.)
+ * const mapRole = createRoleMapper(STANDARD_ROLE_MAP);
+ *
+ * // For providers with different role names
+ * const customMap = { ...STANDARD_ROLE_MAP, agent: "bot" };
+ * const customMapper = createRoleMapper(customMap);
+ * ```
+ */
+export function createRoleMapper(roleMap) {
+    return (role) => roleMap[role];
+}
+/**
+ * Standard role mapper using the default role mapping
+ */
+export const mapStandardRole = createRoleMapper(STANDARD_ROLE_MAP);

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@aigne/core",
-  "version": "1.43.0",
+  "version": "1.43.1",
   "description": "AIGNE core library for building AI-powered applications",
   "publishConfig": {
     "access": "public"
   },
   "author": "Arcblock <blocklet@arcblock.io> https://github.com/blocklet",
-  "homepage": "https://github.com/AIGNE-io/aigne-framework",
+  "homepage": "https://www.aigne.io/framework",
   "license": "Elastic-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AIGNE-io/aigne-framework"
   },
+  "bugs": {
+    "url": "https://github.com/AIGNE-io/aigne-framework/issues"
+  },
   "files": [
     "lib/cjs",
     "lib/dts",
@@ -74,6 +77,7 @@
     "eventsource-parser": "^3.0.3",
     "fast-deep-equal": "^3.1.3",
     "immer": "^10.1.1",
+    "jaison": "^2.0.2",
     "jsonata": "^2.0.6",
     "mustache": "^4.2.0",
     "nanoid": "^5.1.5",