@aigne/core 1.24.1 → 1.26.0

package/CHANGELOG.md

@@ -12,6 +12,39 @@
   * dependencies
     * @aigne/observability bumped to 0.1.0
 
+## [1.26.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.25.0...core-v1.26.0) (2025-06-30)
+
+
+### Features
+
+* **ux:** polish tracing ux and update docs ([#193](https://github.com/AIGNE-io/aigne-framework/issues/193)) ([f80b63e](https://github.com/AIGNE-io/aigne-framework/commit/f80b63ecb1cfb00daa9b68330026da839d33f8a2))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/observability bumped to 0.3.0
+
+## [1.25.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.24.1...core-v1.25.0) (2025-06-29)
+
+
+### Features
+
+* **observability:** tune trace ux and supoort incremental exporting ([#184](https://github.com/AIGNE-io/aigne-framework/issues/184)) ([d174188](https://github.com/AIGNE-io/aigne-framework/commit/d174188459c77acb09b5ca040972f83abb067587))
+
+
+### Bug Fixes
+
+* **core:** enable proper tracing for agent calls via message queue ([#191](https://github.com/AIGNE-io/aigne-framework/issues/191)) ([f8a4ce5](https://github.com/AIGNE-io/aigne-framework/commit/f8a4ce5fa54e0e01113b31fefcbd248b163980b2))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/observability bumped to 0.2.0
+
 ## [1.24.1](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.24.0...core-v1.24.1) (2025-06-26)
 
 

package/lib/cjs/agents/agent.js

@@ -272,7 +272,7 @@ class Agent {
     }
     async onMessage({ message, context }) {
         try {
-            await context.invoke(this, message);
+            await context.invoke(this, message, { newContext: false });
         }
         catch (error) {
             context.emit("agentFailed", { agent: this, error });
@@ -524,11 +524,15 @@ class Agent {
     }
     async publishToTopics(output, options) {
         const publishTopics = typeof this.publishTopic === "function" ? await this.publishTopic(output) : this.publishTopic;
+        const role = this.constructor.name === "UserAgent" ? "user" : "agent";
         if (publishTopics?.length) {
-            options.context.publish(publishTopics, {
-                role: this.constructor.name === "UserAgent" ? "user" : "agent",
+            const ctx = role === "user" ? options.context.newContext({ reset: true }) : options.context;
+            ctx.publish(publishTopics, {
+                role,
                 source: this.name,
                 message: output,
+            }, {
+                newContext: role !== "user",
             });
         }
     }

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

@@ -49,7 +49,7 @@ class UserAgent extends agent_js_1.Agent {
         }
         const publicTopic = typeof this.publishTopic === "function" ? await this.publishTopic(input) : this.publishTopic;
         if (publicTopic?.length) {
-            options.context.publish(publicTopic, input);
+            options.context.publish(publicTopic, input, { newContext: false });
             if (this.subscribeTopic) {
                 return this.subscribe(this.subscribeTopic).then((res) => res.message);
             }

package/lib/cjs/aigne/context.js

@@ -166,9 +166,10 @@ class AIGNEContext {
             this.memories.push(...options.memories);
             options.memories = undefined;
         }
+        const newContext = options?.newContext === false ? this : this.newContext();
         return this.internal.messageQueue.publish(topic, {
             ...(0, message_queue_js_1.toMessagePayload)(payload),
-            context: this,
+            context: newContext,
         });
     });
     subscribe = ((...args) => {
@@ -205,6 +206,21 @@ class AIGNEContext {
                     span.setAttribute("custom.started_at", b.timestamp);
                     span.setAttribute("input", JSON.stringify(input));
                     span.setAttribute("agentTag", agent.tag ?? "UnknownAgent");
+                    try {
+                        span.setAttribute("userContext", JSON.stringify(this.userContext));
+                    }
+                    catch (_e) {
+                        logger_js_1.logger.error("parse userContext error", _e.message);
+                        span.setAttribute("userContext", JSON.stringify({}));
+                    }
+                    try {
+                        span.setAttribute("memories", JSON.stringify(this.memories));
+                    }
+                    catch (_e) {
+                        logger_js_1.logger.error("parse memories error", _e.message);
+                        span.setAttribute("memories", JSON.stringify([]));
+                    }
+                    await this.observer?.traceExporter?.insertInitialSpan?.(span);
                     break;
                 }
                 case "agentSucceed": {

package/lib/esm/agents/agent.js

@@ -228,7 +228,7 @@ export class Agent {
     }
     async onMessage({ message, context }) {
         try {
-            await context.invoke(this, message);
+            await context.invoke(this, message, { newContext: false });
         }
         catch (error) {
             context.emit("agentFailed", { agent: this, error });
@@ -480,11 +480,15 @@ export class Agent {
     }
     async publishToTopics(output, options) {
         const publishTopics = typeof this.publishTopic === "function" ? await this.publishTopic(output) : this.publishTopic;
+        const role = this.constructor.name === "UserAgent" ? "user" : "agent";
         if (publishTopics?.length) {
-            options.context.publish(publishTopics, {
-                role: this.constructor.name === "UserAgent" ? "user" : "agent",
+            const ctx = role === "user" ? options.context.newContext({ reset: true }) : options.context;
+            ctx.publish(publishTopics, {
+                role,
                 source: this.name,
                 message: output,
+            }, {
+                newContext: role !== "user",
             });
         }
     }

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

@@ -46,7 +46,7 @@ export class UserAgent extends Agent {
         }
         const publicTopic = typeof this.publishTopic === "function" ? await this.publishTopic(input) : this.publishTopic;
         if (publicTopic?.length) {
-            options.context.publish(publicTopic, input);
+            options.context.publish(publicTopic, input, { newContext: false });
             if (this.subscribeTopic) {
                 return this.subscribe(this.subscribeTopic).then((res) => res.message);
             }

package/lib/esm/aigne/context.js

@@ -160,9 +160,10 @@ export class AIGNEContext {
             this.memories.push(...options.memories);
             options.memories = undefined;
         }
+        const newContext = options?.newContext === false ? this : this.newContext();
         return this.internal.messageQueue.publish(topic, {
             ...toMessagePayload(payload),
-            context: this,
+            context: newContext,
         });
     });
     subscribe = ((...args) => {
@@ -199,6 +200,21 @@ export class AIGNEContext {
                     span.setAttribute("custom.started_at", b.timestamp);
                     span.setAttribute("input", JSON.stringify(input));
                     span.setAttribute("agentTag", agent.tag ?? "UnknownAgent");
+                    try {
+                        span.setAttribute("userContext", JSON.stringify(this.userContext));
+                    }
+                    catch (_e) {
+                        logger.error("parse userContext error", _e.message);
+                        span.setAttribute("userContext", JSON.stringify({}));
+                    }
+                    try {
+                        span.setAttribute("memories", JSON.stringify(this.memories));
+                    }
+                    catch (_e) {
+                        logger.error("parse memories error", _e.message);
+                        span.setAttribute("memories", JSON.stringify([]));
+                    }
+                    await this.observer?.traceExporter?.insertInitialSpan?.(span);
                     break;
                 }
                 case "agentSucceed": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.24.1",
+  "version": "1.26.0",
   "description": "AIGNE core library for building AI-powered applications",
   "publishConfig": {
     "access": "public"
@@ -82,7 +82,7 @@
     "zod": "^3.24.4",
     "zod-to-json-schema": "^3.24.5",
     "@aigne/platform-helpers": "^0.1.2",
-    "@aigne/observability": "^0.1.3"
+    "@aigne/observability": "^0.3.0"
   },
   "devDependencies": {
     "@types/bun": "^1.2.12",