@aigne/core 1.42.0 → 1.43.1

package/CHANGELOG.md

@@ -12,6 +12,25 @@
   * 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)
+
+
+### Features
+
+* add includeAllStepsOutput option to control TeamAgent sequential streaming behavior ([#305](https://github.com/AIGNE-io/aigne-framework/issues/305)) ([0817475](https://github.com/AIGNE-io/aigne-framework/commit/08174751316b940a70463e71971a19a18b92667b))
+
+
+### Bug Fixes
+
+* **core:** share skills/agents from context ([#309](https://github.com/AIGNE-io/aigne-framework/issues/309)) ([88dd849](https://github.com/AIGNE-io/aigne-framework/commit/88dd849954c6f3fb68df238be22be3371c734e6e))
+
 ## [1.42.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.41.0...core-v1.42.0) (2025-08-01)
 
 

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/agents/team-agent.d.ts

@@ -156,6 +156,13 @@ export interface TeamAgentOptions<I extends Message, O extends Message> extends
      * @default false
      */
     iterateWithPreviousOutput?: boolean;
+    /**
+     * Controls whether to include output from all intermediate steps in sequential processing.
+     *
+     * @see TeamAgent.includeAllStepsOutput for detailed documentation
+     * @default false
+     */
+    includeAllStepsOutput?: boolean;
 }
 /**
  * TeamAgent coordinates a group of agents working together to accomplish tasks.
@@ -230,6 +237,18 @@ export declare class TeamAgent<I extends Message, O extends Message> extends Age
      * @default false
      */
     iterateWithPreviousOutput?: boolean;
+    /**
+     * Controls whether to include output from all intermediate steps in sequential processing.
+     *
+     * When `true`, yields output chunks from every agent in the sequential chain.
+     * When `false`, only yields output from the final agent.
+     *
+     * Only affects sequential processing mode. Useful for debugging and monitoring
+     * multi-step agent workflows.
+     *
+     * @default false
+     */
+    includeAllStepsOutput?: boolean;
     /**
      * Process an input message by routing it through the team's agents.
      *

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

@@ -83,6 +83,7 @@ class TeamAgent extends agent_js_1.Agent {
         };
         this.iterateOn = options.iterateOn;
         this.iterateWithPreviousOutput = options.iterateWithPreviousOutput;
+        this.includeAllStepsOutput = options.includeAllStepsOutput;
     }
     /**
      * The processing mode that determines how agents in the team are executed.
@@ -117,6 +118,18 @@ class TeamAgent extends agent_js_1.Agent {
      * @default false
      */
     iterateWithPreviousOutput;
+    /**
+     * Controls whether to include output from all intermediate steps in sequential processing.
+     *
+     * When `true`, yields output chunks from every agent in the sequential chain.
+     * When `false`, only yields output from the final agent.
+     *
+     * Only affects sequential processing mode. Useful for debugging and monitoring
+     * multi-step agent workflows.
+     *
+     * @default false
+     */
+    includeAllStepsOutput;
     /**
      * Process an input message by routing it through the team's agents.
      *
@@ -212,8 +225,12 @@ class TeamAgent extends agent_js_1.Agent {
         const output = {};
         for (const agent of this.skills) {
             const o = await options.context.invoke(agent, { ...input, ...output }, { ...options, streaming: true });
+            const isLast = agent === this.skills[this.skills.length - 1];
             for await (const chunk of o) {
-                yield chunk;
+                // Only yield the chunk if it is the last agent in the sequence
+                if (this.includeAllStepsOutput || isLast) {
+                    yield chunk;
+                }
                 (0, stream_utils_js_1.mergeAgentResponseChunk)(output, chunk);
             }
         }

package/lib/cjs/aigne/context.d.ts

@@ -73,6 +73,7 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
     rootId: string;
     model?: ChatModel;
     skills?: Agent[];
+    agents: Agent[];
     observer?: AIGNEObserver;
     span?: Span;
     usage: ContextUsage;
@@ -153,6 +154,7 @@ export declare class AIGNEContext implements Context {
     get messageQueue(): MessageQueue;
     get model(): ChatModel | undefined;
     get skills(): Agent<any, any>[] | undefined;
+    get agents(): Agent<any, any>[];
     get observer(): AIGNEObserver | undefined;
     get limits(): ContextLimits | undefined;
     get status(): "normal" | "timeout";
@@ -180,7 +182,7 @@ export declare class AIGNEContext implements Context {
 declare class AIGNEContextShared {
     private readonly parent?;
     spans: Span[];
-    constructor(parent?: (Pick<Context, "model" | "skills" | "limits" | "observer"> & {
+    constructor(parent?: (Pick<Context, "model" | "agents" | "skills" | "limits" | "observer"> & {
         messageQueue?: MessageQueue;
         events?: Emitter<any>;
     }) | undefined);
@@ -188,6 +190,7 @@ declare class AIGNEContextShared {
     readonly events: Emitter<any>;
     get model(): ChatModel | undefined;
     get skills(): Agent<any, any>[] | undefined;
+    get agents(): Agent<any, any>[];
     get observer(): AIGNEObserver | undefined;
     get limits(): ContextLimits | undefined;
     addSpan(span: Span): void;

package/lib/cjs/aigne/context.js

@@ -64,6 +64,9 @@ class AIGNEContext {
     get skills() {
         return this.internal.skills;
     }
+    get agents() {
+        return this.internal.agents;
+    }
     get observer() {
         return this.internal.observer;
     }
@@ -300,6 +303,9 @@ class AIGNEContextShared {
     get skills() {
         return this.parent?.skills;
     }
+    get agents() {
+        return this.parent?.agents ?? [];
+    }
     get observer() {
         return this.parent?.observer;
     }

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/agents/team-agent.d.ts

@@ -156,6 +156,13 @@ export interface TeamAgentOptions<I extends Message, O extends Message> extends
      * @default false
      */
     iterateWithPreviousOutput?: boolean;
+    /**
+     * Controls whether to include output from all intermediate steps in sequential processing.
+     *
+     * @see TeamAgent.includeAllStepsOutput for detailed documentation
+     * @default false
+     */
+    includeAllStepsOutput?: boolean;
 }
 /**
  * TeamAgent coordinates a group of agents working together to accomplish tasks.
@@ -230,6 +237,18 @@ export declare class TeamAgent<I extends Message, O extends Message> extends Age
      * @default false
      */
     iterateWithPreviousOutput?: boolean;
+    /**
+     * Controls whether to include output from all intermediate steps in sequential processing.
+     *
+     * When `true`, yields output chunks from every agent in the sequential chain.
+     * When `false`, only yields output from the final agent.
+     *
+     * Only affects sequential processing mode. Useful for debugging and monitoring
+     * multi-step agent workflows.
+     *
+     * @default false
+     */
+    includeAllStepsOutput?: boolean;
     /**
      * Process an input message by routing it through the team's agents.
      *

package/lib/dts/aigne/context.d.ts

@@ -73,6 +73,7 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
     rootId: string;
     model?: ChatModel;
     skills?: Agent[];
+    agents: Agent[];
     observer?: AIGNEObserver;
     span?: Span;
     usage: ContextUsage;
@@ -153,6 +154,7 @@ export declare class AIGNEContext implements Context {
     get messageQueue(): MessageQueue;
     get model(): ChatModel | undefined;
     get skills(): Agent<any, any>[] | undefined;
+    get agents(): Agent<any, any>[];
     get observer(): AIGNEObserver | undefined;
     get limits(): ContextLimits | undefined;
     get status(): "normal" | "timeout";
@@ -180,7 +182,7 @@ export declare class AIGNEContext implements Context {
 declare class AIGNEContextShared {
     private readonly parent?;
     spans: Span[];
-    constructor(parent?: (Pick<Context, "model" | "skills" | "limits" | "observer"> & {
+    constructor(parent?: (Pick<Context, "model" | "agents" | "skills" | "limits" | "observer"> & {
         messageQueue?: MessageQueue;
         events?: Emitter<any>;
     }) | undefined);
@@ -188,6 +190,7 @@ declare class AIGNEContextShared {
     readonly events: Emitter<any>;
     get model(): ChatModel | undefined;
     get skills(): Agent<any, any>[] | undefined;
+    get agents(): Agent<any, any>[];
     get observer(): AIGNEObserver | undefined;
     get limits(): ContextLimits | undefined;
     addSpan(span: Span): void;

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/agents/team-agent.d.ts

@@ -156,6 +156,13 @@ export interface TeamAgentOptions<I extends Message, O extends Message> extends
      * @default false
      */
     iterateWithPreviousOutput?: boolean;
+    /**
+     * Controls whether to include output from all intermediate steps in sequential processing.
+     *
+     * @see TeamAgent.includeAllStepsOutput for detailed documentation
+     * @default false
+     */
+    includeAllStepsOutput?: boolean;
 }
 /**
  * TeamAgent coordinates a group of agents working together to accomplish tasks.
@@ -230,6 +237,18 @@ export declare class TeamAgent<I extends Message, O extends Message> extends Age
      * @default false
      */
     iterateWithPreviousOutput?: boolean;
+    /**
+     * Controls whether to include output from all intermediate steps in sequential processing.
+     *
+     * When `true`, yields output chunks from every agent in the sequential chain.
+     * When `false`, only yields output from the final agent.
+     *
+     * Only affects sequential processing mode. Useful for debugging and monitoring
+     * multi-step agent workflows.
+     *
+     * @default false
+     */
+    includeAllStepsOutput?: boolean;
     /**
      * Process an input message by routing it through the team's agents.
      *

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

@@ -77,6 +77,7 @@ export class TeamAgent extends Agent {
         };
         this.iterateOn = options.iterateOn;
         this.iterateWithPreviousOutput = options.iterateWithPreviousOutput;
+        this.includeAllStepsOutput = options.includeAllStepsOutput;
     }
     /**
      * The processing mode that determines how agents in the team are executed.
@@ -111,6 +112,18 @@ export class TeamAgent extends Agent {
      * @default false
      */
     iterateWithPreviousOutput;
+    /**
+     * Controls whether to include output from all intermediate steps in sequential processing.
+     *
+     * When `true`, yields output chunks from every agent in the sequential chain.
+     * When `false`, only yields output from the final agent.
+     *
+     * Only affects sequential processing mode. Useful for debugging and monitoring
+     * multi-step agent workflows.
+     *
+     * @default false
+     */
+    includeAllStepsOutput;
     /**
      * Process an input message by routing it through the team's agents.
      *
@@ -206,8 +219,12 @@ export class TeamAgent extends Agent {
         const output = {};
         for (const agent of this.skills) {
             const o = await options.context.invoke(agent, { ...input, ...output }, { ...options, streaming: true });
+            const isLast = agent === this.skills[this.skills.length - 1];
             for await (const chunk of o) {
-                yield chunk;
+                // Only yield the chunk if it is the last agent in the sequence
+                if (this.includeAllStepsOutput || isLast) {
+                    yield chunk;
+                }
                 mergeAgentResponseChunk(output, chunk);
             }
         }

package/lib/esm/aigne/context.d.ts

@@ -73,6 +73,7 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
     rootId: string;
     model?: ChatModel;
     skills?: Agent[];
+    agents: Agent[];
     observer?: AIGNEObserver;
     span?: Span;
     usage: ContextUsage;
@@ -153,6 +154,7 @@ export declare class AIGNEContext implements Context {
     get messageQueue(): MessageQueue;
     get model(): ChatModel | undefined;
     get skills(): Agent<any, any>[] | undefined;
+    get agents(): Agent<any, any>[];
     get observer(): AIGNEObserver | undefined;
     get limits(): ContextLimits | undefined;
     get status(): "normal" | "timeout";
@@ -180,7 +182,7 @@ export declare class AIGNEContext implements Context {
 declare class AIGNEContextShared {
     private readonly parent?;
     spans: Span[];
-    constructor(parent?: (Pick<Context, "model" | "skills" | "limits" | "observer"> & {
+    constructor(parent?: (Pick<Context, "model" | "agents" | "skills" | "limits" | "observer"> & {
         messageQueue?: MessageQueue;
         events?: Emitter<any>;
     }) | undefined);
@@ -188,6 +190,7 @@ declare class AIGNEContextShared {
     readonly events: Emitter<any>;
     get model(): ChatModel | undefined;
     get skills(): Agent<any, any>[] | undefined;
+    get agents(): Agent<any, any>[];
     get observer(): AIGNEObserver | undefined;
     get limits(): ContextLimits | undefined;
     addSpan(span: Span): void;

package/lib/esm/aigne/context.js

@@ -58,6 +58,9 @@ export class AIGNEContext {
     get skills() {
         return this.internal.skills;
     }
+    get agents() {
+        return this.internal.agents;
+    }
     get observer() {
         return this.internal.observer;
     }
@@ -293,6 +296,9 @@ class AIGNEContextShared {
     get skills() {
         return this.parent?.skills;
     }
+    get agents() {
+        return this.parent?.agents ?? [];
+    }
     get observer() {
         return this.parent?.observer;
     }

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.42.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",