@inkeep/agents-run-api 0.14.15 → 0.15.0

package/dist/index.cjs

@@ -2524,7 +2524,7 @@ var ArtifactParser = _ArtifactParser;
 // src/services/GraphSession.ts
 var logger9 = agentsCore.getLogger("GraphSession");
 var GraphSession = class {
-  // Session-scoped ArtifactParser instance
+  // Whether to send data operations
   constructor(sessionId, messageId, graphId, tenantId, projectId, contextId) {
     this.sessionId = sessionId;
     this.messageId = messageId;
@@ -2553,6 +2553,8 @@ var GraphSession = class {
     __publicField(this, "artifactService");
     // Session-scoped ArtifactService instance
     __publicField(this, "artifactParser");
+    // Session-scoped ArtifactParser instance
+    __publicField(this, "isEmitOperations", false);
     logger9.debug({ sessionId, messageId, graphId }, "GraphSession created");
     if (tenantId && projectId) {
       toolSessionManager.createSessionWithId(
@@ -2581,6 +2583,78 @@ var GraphSession = class {
       });
     }
   }
+  /**
+   * Enable emit operations to send data operations
+   */
+  enableEmitOperations() {
+    this.isEmitOperations = true;
+    logger9.info(
+      { sessionId: this.sessionId },
+      "\u{1F50D} DEBUG: Emit operations enabled for GraphSession"
+    );
+  }
+  /**
+   * Send data operation to stream when emit operations is enabled
+   */
+  async sendDataOperation(event) {
+    try {
+      const streamHelper = getStreamHelper(this.sessionId);
+      if (streamHelper) {
+        const formattedOperation = {
+          type: event.eventType,
+          label: this.generateEventLabel(event),
+          details: {
+            timestamp: event.timestamp,
+            agentId: event.agentId,
+            data: event.data
+          }
+        };
+        await streamHelper.writeOperation(formattedOperation);
+      }
+    } catch (error) {
+      logger9.error(
+        {
+          sessionId: this.sessionId,
+          eventType: event.eventType,
+          error: error instanceof Error ? error.message : error
+        },
+        "\u274C DEBUG: Failed to send data operation"
+      );
+    }
+  }
+  /**
+   * Generate human-readable labels for events
+   */
+  generateEventLabel(event) {
+    switch (event.eventType) {
+      case "agent_generate":
+        return `Agent ${event.agentId} generating response`;
+      case "agent_reasoning":
+        return `Agent ${event.agentId} reasoning through request`;
+      case "tool_execution": {
+        const toolData = event.data;
+        return `Tool execution: ${toolData.toolName || "unknown"}`;
+      }
+      case "transfer": {
+        const transferData = event.data;
+        return `Agent transfer: ${transferData.fromAgent} \u2192 ${transferData.targetAgent}`;
+      }
+      case "delegation_sent": {
+        const delegationData = event.data;
+        return `Task delegated: ${delegationData.fromAgent} \u2192 ${delegationData.targetAgent}`;
+      }
+      case "delegation_returned": {
+        const returnData = event.data;
+        return `Task completed: ${returnData.targetAgent} \u2192 ${returnData.fromAgent}`;
+      }
+      case "artifact_saved": {
+        const artifactData = event.data;
+        return `Artifact saved: ${artifactData.artifactType || "unknown type"}`;
+      }
+      default:
+        return `${event.eventType} event`;
+    }
+  }
   /**
    * Initialize status updates for this session
    */
@@ -2626,6 +2700,14 @@ var GraphSession = class {
    * Record an event in the session and trigger status updates if configured
    */
   recordEvent(eventType, agentId, data) {
+    if (this.isEmitOperations) {
+      this.sendDataOperation({
+        timestamp: Date.now(),
+        eventType,
+        agentId,
+        data
+      });
+    }
     if (this.isEnded) {
       logger9.debug(
         {
@@ -3509,7 +3591,10 @@ Make it specific and relevant.`;
                     }
                   }
                 }
-                agentsCore.setSpanWithError(generationSpan, lastError instanceof Error ? lastError : new Error(String(lastError)));
+                agentsCore.setSpanWithError(
+                  generationSpan,
+                  lastError instanceof Error ? lastError : new Error(String(lastError))
+                );
                 throw new Error(
                   `Artifact name/description generation failed after ${maxRetries} attempts: ${lastError?.message}`
                 );
@@ -3670,6 +3755,23 @@ var GraphSessionManager = class {
       );
     }
   }
+  /**
+   * Enable emit operations for a session to send data operations
+   */
+  enableEmitOperations(sessionId) {
+    const session = this.sessions.get(sessionId);
+    if (session) {
+      session.enableEmitOperations();
+    } else {
+      logger9.error(
+        {
+          sessionId,
+          availableSessions: Array.from(this.sessions.keys())
+        },
+        "Session not found for emit operations enablement"
+      );
+    }
+  }
   /**
    * Get an existing session
    */
@@ -4255,7 +4357,7 @@ var ResponseFormatter = class {
 function agentInitializingOp(sessionId, graphId) {
   return {
     type: "agent_initializing",
-    ctx: {
+    details: {
       sessionId,
       graphId
     }
@@ -4264,7 +4366,7 @@ function agentInitializingOp(sessionId, graphId) {
 function completionOp(agentId, iterations) {
   return {
     type: "completion",
-    ctx: {
+    details: {
       agent: agentId,
       iteration: iterations
     }
@@ -7128,7 +7230,11 @@ var Agent = class {
         return null;
       }
       const contextConfig = await agentsCore.getContextConfigById(dbClient_default)({
-        scopes: { tenantId: this.config.tenantId, projectId: this.config.projectId },
+        scopes: {
+          tenantId: this.config.tenantId,
+          projectId: this.config.projectId,
+          graphId: this.config.graphId
+        },
         id: this.config.contextConfigId
       });
       if (!contextConfig) {
@@ -9392,12 +9498,23 @@ var ExecutionHandler = class {
    * @returns
    */
   async execute(params) {
-    const { executionContext, conversationId, userMessage, initialAgentId, requestId: requestId2, sseHelper } = params;
+    const {
+      executionContext,
+      conversationId,
+      userMessage,
+      initialAgentId,
+      requestId: requestId2,
+      sseHelper,
+      emitOperations
+    } = params;
     const { tenantId, projectId, graphId, apiKey, baseUrl } = executionContext;
     registerStreamHelper(requestId2, sseHelper);
     graphSessionManager.createSession(requestId2, graphId, tenantId, projectId, conversationId);
+    if (emitOperations) {
+      graphSessionManager.enableEmitOperations(requestId2);
+    }
     logger21.info(
-      { sessionId: requestId2, graphId, conversationId },
+      { sessionId: requestId2, graphId, conversationId, emitOperations },
       "Created GraphSession for message execution"
     );
     let graphConfig = null;
@@ -10024,6 +10141,8 @@ app2.openapi(chatCompletionsRoute, async (c) => {
         const sseHelper = createSSEStreamHelper(stream2, requestId2, timestamp);
         await sseHelper.writeRole();
         logger22.info({ agentId }, "Starting execution");
+        const emitOperationsHeader = c.req.header("x-emit-operations");
+        const emitOperations = emitOperationsHeader === "true";
         const executionHandler = new ExecutionHandler();
         const result = await executionHandler.execute({
           executionContext,
@@ -10031,7 +10150,8 @@ app2.openapi(chatCompletionsRoute, async (c) => {
           userMessage,
           initialAgentId: agentId,
           requestId: requestId2,
-          sseHelper
+          sseHelper,
+          emitOperations
         });
         logger22.info(
           { result },
@@ -10243,6 +10363,8 @@ app3.openapi(chatDataStreamRoute, async (c) => {
       execute: async ({ writer }) => {
         const streamHelper = createVercelStreamHelper(writer);
         try {
+          const emitOperationsHeader = c.req.header("x-emit-operations");
+          const emitOperations = emitOperationsHeader === "true";
           const executionHandler = new ExecutionHandler();
           const result = await executionHandler.execute({
             executionContext,
@@ -10250,7 +10372,8 @@ app3.openapi(chatDataStreamRoute, async (c) => {
             userMessage: userText,
             initialAgentId: agentId,
             requestId: `chatds-${Date.now()}`,
-            sseHelper: streamHelper
+            sseHelper: streamHelper,
+            emitOperations
           });
           if (!result.success) {
             await streamHelper.writeOperation(errorOp("Unable to process request", "system"));

package/dist/index.js

@@ -2048,7 +2048,7 @@ var ArtifactParser = _ArtifactParser;
 // src/services/GraphSession.ts
 var logger8 = getLogger("GraphSession");
 var GraphSession = class {
-  // Session-scoped ArtifactParser instance
+  // Whether to send data operations
   constructor(sessionId, messageId, graphId, tenantId, projectId, contextId) {
     this.sessionId = sessionId;
     this.messageId = messageId;
@@ -2077,6 +2077,8 @@ var GraphSession = class {
     __publicField(this, "artifactService");
     // Session-scoped ArtifactService instance
     __publicField(this, "artifactParser");
+    // Session-scoped ArtifactParser instance
+    __publicField(this, "isEmitOperations", false);
     logger8.debug({ sessionId, messageId, graphId }, "GraphSession created");
     if (tenantId && projectId) {
       toolSessionManager.createSessionWithId(
@@ -2105,6 +2107,78 @@ var GraphSession = class {
       });
     }
   }
+  /**
+   * Enable emit operations to send data operations
+   */
+  enableEmitOperations() {
+    this.isEmitOperations = true;
+    logger8.info(
+      { sessionId: this.sessionId },
+      "\u{1F50D} DEBUG: Emit operations enabled for GraphSession"
+    );
+  }
+  /**
+   * Send data operation to stream when emit operations is enabled
+   */
+  async sendDataOperation(event) {
+    try {
+      const streamHelper = getStreamHelper(this.sessionId);
+      if (streamHelper) {
+        const formattedOperation = {
+          type: event.eventType,
+          label: this.generateEventLabel(event),
+          details: {
+            timestamp: event.timestamp,
+            agentId: event.agentId,
+            data: event.data
+          }
+        };
+        await streamHelper.writeOperation(formattedOperation);
+      }
+    } catch (error) {
+      logger8.error(
+        {
+          sessionId: this.sessionId,
+          eventType: event.eventType,
+          error: error instanceof Error ? error.message : error
+        },
+        "\u274C DEBUG: Failed to send data operation"
+      );
+    }
+  }
+  /**
+   * Generate human-readable labels for events
+   */
+  generateEventLabel(event) {
+    switch (event.eventType) {
+      case "agent_generate":
+        return `Agent ${event.agentId} generating response`;
+      case "agent_reasoning":
+        return `Agent ${event.agentId} reasoning through request`;
+      case "tool_execution": {
+        const toolData = event.data;
+        return `Tool execution: ${toolData.toolName || "unknown"}`;
+      }
+      case "transfer": {
+        const transferData = event.data;
+        return `Agent transfer: ${transferData.fromAgent} \u2192 ${transferData.targetAgent}`;
+      }
+      case "delegation_sent": {
+        const delegationData = event.data;
+        return `Task delegated: ${delegationData.fromAgent} \u2192 ${delegationData.targetAgent}`;
+      }
+      case "delegation_returned": {
+        const returnData = event.data;
+        return `Task completed: ${returnData.targetAgent} \u2192 ${returnData.fromAgent}`;
+      }
+      case "artifact_saved": {
+        const artifactData = event.data;
+        return `Artifact saved: ${artifactData.artifactType || "unknown type"}`;
+      }
+      default:
+        return `${event.eventType} event`;
+    }
+  }
   /**
    * Initialize status updates for this session
    */
@@ -2150,6 +2224,14 @@ var GraphSession = class {
    * Record an event in the session and trigger status updates if configured
    */
   recordEvent(eventType, agentId, data) {
+    if (this.isEmitOperations) {
+      this.sendDataOperation({
+        timestamp: Date.now(),
+        eventType,
+        agentId,
+        data
+      });
+    }
     if (this.isEnded) {
       logger8.debug(
         {
@@ -3033,7 +3115,10 @@ Make it specific and relevant.`;
                     }
                   }
                 }
-                setSpanWithError(generationSpan, lastError instanceof Error ? lastError : new Error(String(lastError)));
+                setSpanWithError(
+                  generationSpan,
+                  lastError instanceof Error ? lastError : new Error(String(lastError))
+                );
                 throw new Error(
                   `Artifact name/description generation failed after ${maxRetries} attempts: ${lastError?.message}`
                 );
@@ -3194,6 +3279,23 @@ var GraphSessionManager = class {
       );
     }
   }
+  /**
+   * Enable emit operations for a session to send data operations
+   */
+  enableEmitOperations(sessionId) {
+    const session = this.sessions.get(sessionId);
+    if (session) {
+      session.enableEmitOperations();
+    } else {
+      logger8.error(
+        {
+          sessionId,
+          availableSessions: Array.from(this.sessions.keys())
+        },
+        "Session not found for emit operations enablement"
+      );
+    }
+  }
   /**
    * Get an existing session
    */
@@ -3777,7 +3879,7 @@ var ResponseFormatter = class {
 function agentInitializingOp(sessionId, graphId) {
   return {
     type: "agent_initializing",
-    ctx: {
+    details: {
       sessionId,
       graphId
     }
@@ -3786,7 +3888,7 @@ function agentInitializingOp(sessionId, graphId) {
 function completionOp(agentId, iterations) {
   return {
     type: "completion",
-    ctx: {
+    details: {
       agent: agentId,
       iteration: iterations
     }
@@ -6635,7 +6737,11 @@ var Agent = class {
         return null;
       }
       const contextConfig = await getContextConfigById(dbClient_default)({
-        scopes: { tenantId: this.config.tenantId, projectId: this.config.projectId },
+        scopes: {
+          tenantId: this.config.tenantId,
+          projectId: this.config.projectId,
+          graphId: this.config.graphId
+        },
         id: this.config.contextConfigId
       });
       if (!contextConfig) {
@@ -8885,12 +8991,23 @@ var ExecutionHandler = class {
    * @returns
    */
   async execute(params) {
-    const { executionContext, conversationId, userMessage, initialAgentId, requestId: requestId2, sseHelper } = params;
+    const {
+      executionContext,
+      conversationId,
+      userMessage,
+      initialAgentId,
+      requestId: requestId2,
+      sseHelper,
+      emitOperations
+    } = params;
     const { tenantId, projectId, graphId, apiKey, baseUrl } = executionContext;
     registerStreamHelper(requestId2, sseHelper);
     graphSessionManager.createSession(requestId2, graphId, tenantId, projectId, conversationId);
+    if (emitOperations) {
+      graphSessionManager.enableEmitOperations(requestId2);
+    }
     logger20.info(
-      { sessionId: requestId2, graphId, conversationId },
+      { sessionId: requestId2, graphId, conversationId, emitOperations },
       "Created GraphSession for message execution"
     );
     let graphConfig = null;
@@ -9516,6 +9633,8 @@ app2.openapi(chatCompletionsRoute, async (c) => {
         const sseHelper = createSSEStreamHelper(stream2, requestId2, timestamp);
         await sseHelper.writeRole();
         logger21.info({ agentId }, "Starting execution");
+        const emitOperationsHeader = c.req.header("x-emit-operations");
+        const emitOperations = emitOperationsHeader === "true";
         const executionHandler = new ExecutionHandler();
         const result = await executionHandler.execute({
           executionContext,
@@ -9523,7 +9642,8 @@ app2.openapi(chatCompletionsRoute, async (c) => {
           userMessage,
           initialAgentId: agentId,
           requestId: requestId2,
-          sseHelper
+          sseHelper,
+          emitOperations
         });
         logger21.info(
           { result },
@@ -9731,6 +9851,8 @@ app3.openapi(chatDataStreamRoute, async (c) => {
       execute: async ({ writer }) => {
         const streamHelper = createVercelStreamHelper(writer);
         try {
+          const emitOperationsHeader = c.req.header("x-emit-operations");
+          const emitOperations = emitOperationsHeader === "true";
           const executionHandler = new ExecutionHandler();
           const result = await executionHandler.execute({
             executionContext,
@@ -9738,7 +9860,8 @@ app3.openapi(chatDataStreamRoute, async (c) => {
             userMessage: userText,
             initialAgentId: agentId,
             requestId: `chatds-${Date.now()}`,
-            sseHelper: streamHelper
+            sseHelper: streamHelper,
+            emitOperations
           });
           if (!result.success) {
             await streamHelper.writeOperation(errorOp("Unable to process request", "system"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-run-api",
-  "version": "0.14.15",
+  "version": "0.15.0",
   "description": "Agents Run API for Inkeep Agent Framework - handles chat, agent execution, and streaming",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -51,7 +51,7 @@
     "traverse": "^0.6.11",
     "ts-pattern": "^5.7.1",
     "zod": "^4.1.11",
-    "@inkeep/agents-core": "^0.14.15"
+    "@inkeep/agents-core": "^0.15.0"
   },
   "optionalDependencies": {
     "keytar": "^7.9.0"