@inkeep/agents-run-api 0.0.0-dev-20250919185254 → 0.0.0-dev-20250919185941

package/dist/index.cjs

@@ -14,6 +14,7 @@ var resources = require('@opentelemetry/resources');
 var sdkNode = require('@opentelemetry/sdk-node');
 var sdkTraceBase = require('@opentelemetry/sdk-trace-base');
 var semanticConventions = require('@opentelemetry/semantic-conventions');
+var otel = require('@hono/otel');
 var zodOpenapi = require('@hono/zod-openapi');
 var api = require('@opentelemetry/api');
 var hono = require('hono');
@@ -34,7 +35,6 @@ var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
 var streamableHttp_js = require('@modelcontextprotocol/sdk/server/streamableHttp.js');
 var v3 = require('zod/v3');
 var fetchToNode = require('fetch-to-node');
-var otel = require('@hono/otel');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -6962,7 +6962,10 @@ app.openapi(
       const agent = await getRegisteredAgent(executionContext, credentialStores);
       logger17.info({ agent }, "agent registered: well-known agent.json");
       if (!agent) {
-        return c.json({ error: "Agent not found" }, 404);
+        throw agentsCore.createApiError({
+          code: "not_found",
+          message: "Agent not found"
+        });
       }
       return c.json(agent.agentCard);
     } else {
@@ -6977,7 +6980,10 @@ app.openapi(
       );
       const graph = await getRegisteredGraph(executionContext);
       if (!graph) {
-        return c.json({ error: "Graph not found" }, 404);
+        throw agentsCore.createApiError({
+          code: "not_found",
+          message: "Graph not found"
+        });
       }
       return c.json(graph.agentCard);
     }
@@ -8216,12 +8222,18 @@ app2.openapi(chatCompletionsRoute, async (c) => {
         scopes: { tenantId, projectId, graphId }
       });
       if (!agentGraph) {
-        return c.json({ error: "Agent graph not found" }, 404);
+        throw agentsCore.createApiError({
+          code: "not_found",
+          message: "Agent graph not found"
+        });
       }
       defaultAgentId = agentGraph.defaultAgentId || "";
     }
     if (!defaultAgentId) {
-      return c.json({ error: "No default agent found in graph" }, 404);
+      throw agentsCore.createApiError({
+        code: "not_found",
+        message: "No default agent found in graph"
+      });
     }
     await agentsCore.createOrGetConversation(dbClient_default)({
       tenantId,
@@ -8246,7 +8258,10 @@ app2.openapi(chatCompletionsRoute, async (c) => {
       agentId
     });
     if (!agentInfo) {
-      return c.json({ error: "Agent not found" }, 404);
+      throw agentsCore.createApiError({
+        code: "not_found",
+        message: "Agent not found"
+      });
     }
     const validatedContext = c.get("validatedContext") || body.requestContext || {};
     const credentialStores = c.get("credentialStores");
@@ -8304,41 +8319,69 @@ app2.openapi(chatCompletionsRoute, async (c) => {
       });
     }
     return streaming.streamSSE(c, async (stream2) => {
-      const sseHelper = createSSEStreamHelper(stream2, requestId2, timestamp);
-      await sseHelper.writeRole();
-      logger20.info({ agentId }, "Starting execution");
-      const executionHandler = new ExecutionHandler();
-      const result = await executionHandler.execute({
-        executionContext,
-        conversationId,
-        userMessage,
-        initialAgentId: agentId,
-        requestId: requestId2,
-        sseHelper
-      });
-      logger20.info(
-        { result },
-        `Execution completed: ${result.success ? "success" : "failed"} after ${result.iterations} iterations`
-      );
-      if (!result.success) {
-        await sseHelper.writeOperation(
-          errorOp("Sorry, I was unable to process your request at this time. Please try again.", "system")
+      try {
+        const sseHelper = createSSEStreamHelper(stream2, requestId2, timestamp);
+        await sseHelper.writeRole();
+        logger20.info({ agentId }, "Starting execution");
+        const executionHandler = new ExecutionHandler();
+        const result = await executionHandler.execute({
+          executionContext,
+          conversationId,
+          userMessage,
+          initialAgentId: agentId,
+          requestId: requestId2,
+          sseHelper
+        });
+        logger20.info(
+          { result },
+          `Execution completed: ${result.success ? "success" : "failed"} after ${result.iterations} iterations`
+        );
+        if (!result.success) {
+          await sseHelper.writeOperation(
+            errorOp(
+              "Sorry, I was unable to process your request at this time. Please try again.",
+              "system"
+            )
+          );
+        }
+        await sseHelper.complete();
+      } catch (error) {
+        logger20.error(
+          {
+            error: error instanceof Error ? error.message : error,
+            stack: error instanceof Error ? error.stack : void 0
+          },
+          "Error during streaming execution"
         );
+        try {
+          const sseHelper = createSSEStreamHelper(stream2, requestId2, timestamp);
+          await sseHelper.writeOperation(
+            errorOp(
+              "Sorry, I was unable to process your request at this time. Please try again.",
+              "system"
+            )
+          );
+          await sseHelper.complete();
+        } catch (streamError) {
+          logger20.error({ streamError }, "Failed to write error to stream");
+        }
       }
-      await sseHelper.complete();
     });
   } catch (error) {
-    console.error("\u274C Error in chat completions endpoint:", {
-      error: error instanceof Error ? error.message : error,
-      stack: error instanceof Error ? error.stack : void 0
-    });
-    return c.json(
+    logger20.error(
       {
-        error: "Failed to process chat completion",
-        message: error instanceof Error ? error.message : "Unknown error"
+        error: error instanceof Error ? error.message : error,
+        stack: error instanceof Error ? error.stack : void 0
       },
-      500
+      "Error in chat completions endpoint before streaming"
     );
+    if (error && typeof error === "object" && "status" in error) {
+      throw error;
+    }
+    throw agentsCore.createApiError({
+      code: "internal_server_error",
+      message: error instanceof Error ? error.message : "Failed to process chat completion"
+    });
   }
 });
 var getMessageText = (content) => {
@@ -8421,12 +8464,18 @@ app3.openapi(chatDataStreamRoute, async (c) => {
       scopes: { tenantId, projectId, graphId }
     });
     if (!agentGraph) {
-      return c.json({ error: "Agent graph not found" }, 404);
+      throw agentsCore.createApiError({
+        code: "not_found",
+        message: "Agent graph not found"
+      });
     }
     const defaultAgentId = agentGraph.defaultAgentId;
     const graphName = agentGraph.name;
     if (!defaultAgentId) {
-      return c.json({ error: "Graph does not have a default agent configured" }, 400);
+      throw agentsCore.createApiError({
+        code: "bad_request",
+        message: "Graph does not have a default agent configured"
+      });
     }
     const activeAgent = await agentsCore.getActiveAgentForConversation(dbClient_default)({
       scopes: { tenantId, projectId },
@@ -8445,7 +8494,10 @@ app3.openapi(chatDataStreamRoute, async (c) => {
       agentId
     });
     if (!agentInfo) {
-      return c.json({ error: "Agent not found" }, 404);
+      throw agentsCore.createApiError({
+        code: "not_found",
+        message: "Agent not found"
+      });
     }
     const validatedContext = c.get("validatedContext") || body.requestContext || {};
     const credentialStores = c.get("credentialStores");
@@ -8524,7 +8576,10 @@ app3.openapi(chatDataStreamRoute, async (c) => {
     );
   } catch (error) {
     logger21.error({ error }, "chatDataStream error");
-    return c.json({ error: "Failed to process chat completion" }, 500);
+    throw agentsCore.createApiError({
+      code: "internal_server_error",
+      message: "Failed to process chat completion"
+    });
   }
 });
 var chatDataStream_default = app3;
@@ -9068,6 +9123,8 @@ app4.delete("/", async (c) => {
   );
 });
 var mcp_default = app4;
+
+// src/app.ts
 var logger23 = agentsCore.getLogger("agents-run-api");
 function createExecutionHono(serverConfig, credentialStores) {
   const app6 = new zodOpenapi.OpenAPIHono();

package/dist/index.js

@@ -8,7 +8,8 @@ import { resourceFromAttributes } from '@opentelemetry/resources';
 import { NodeSDK } from '@opentelemetry/sdk-node';
 import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
 import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';
-import { getLogger, getTracer, HeadersScopeSchema, getRequestExecutionContext, getAgentGraphWithDefaultAgent, contextValidationMiddleware, getFullGraph, createOrGetConversation, getActiveAgentForConversation, setActiveAgentForConversation, getAgentById, handleContextResolution, createMessage, commonGetErrorResponses, loggerFactory, createDefaultCredentialStores, CredentialStoreRegistry, listTaskIdsByContextId, getTask, getLedgerArtifacts, getAgentGraphById, createTask, updateTask, setSpanWithError, updateConversation, handleApiError, TaskState, setActiveAgentForThread, getConversation, getRelatedAgentsForGraph, getToolsForAgent, getDataComponentsForAgent, getArtifactComponentsForAgent, validateAndGetApiKey, getProject, ContextResolver, CredentialStuffer, MCPServerType, getCredentialReference, McpClient, getContextConfigById, getFullGraphDefinition, TemplateEngine, graphHasArtifactComponents, MCPTransportType, getExternalAgent } from '@inkeep/agents-core';
+import { getLogger, getTracer, HeadersScopeSchema, getRequestExecutionContext, createApiError, getAgentGraphWithDefaultAgent, contextValidationMiddleware, getFullGraph, createOrGetConversation, getActiveAgentForConversation, setActiveAgentForConversation, getAgentById, handleContextResolution, createMessage, commonGetErrorResponses, loggerFactory, createDefaultCredentialStores, CredentialStoreRegistry, listTaskIdsByContextId, getTask, getLedgerArtifacts, getAgentGraphById, createTask, updateTask, setSpanWithError, updateConversation, handleApiError, TaskState, setActiveAgentForThread, getConversation, getRelatedAgentsForGraph, getToolsForAgent, getDataComponentsForAgent, getArtifactComponentsForAgent, validateAndGetApiKey, getProject, ContextResolver, CredentialStuffer, MCPServerType, getCredentialReference, McpClient, getContextConfigById, getFullGraphDefinition, TemplateEngine, graphHasArtifactComponents, MCPTransportType, getExternalAgent } from '@inkeep/agents-core';
+import { otel } from '@hono/otel';
 import { OpenAPIHono, createRoute, z as z$1 } from '@hono/zod-openapi';
 import { trace, propagation, context, SpanStatusCode } from '@opentelemetry/api';
 import { Hono } from 'hono';
@@ -31,7 +32,6 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { z as z$2 } from 'zod/v3';
 import { toReqRes, toFetchResponse } from 'fetch-to-node';
-import { otel } from '@hono/otel';
 
 var maxExportBatchSize = env.OTEL_MAX_EXPORT_BATCH_SIZE ?? (env.ENVIRONMENT === "development" ? 1 : 512);
 var otlpExporter = new OTLPTraceExporter();
@@ -6680,7 +6680,10 @@ app.openapi(
       const agent = await getRegisteredAgent(executionContext, credentialStores);
       logger17.info({ agent }, "agent registered: well-known agent.json");
       if (!agent) {
-        return c.json({ error: "Agent not found" }, 404);
+        throw createApiError({
+          code: "not_found",
+          message: "Agent not found"
+        });
       }
       return c.json(agent.agentCard);
     } else {
@@ -6695,7 +6698,10 @@ app.openapi(
       );
       const graph = await getRegisteredGraph(executionContext);
       if (!graph) {
-        return c.json({ error: "Graph not found" }, 404);
+        throw createApiError({
+          code: "not_found",
+          message: "Graph not found"
+        });
       }
       return c.json(graph.agentCard);
     }
@@ -7925,12 +7931,18 @@ app2.openapi(chatCompletionsRoute, async (c) => {
         scopes: { tenantId, projectId, graphId }
       });
       if (!agentGraph) {
-        return c.json({ error: "Agent graph not found" }, 404);
+        throw createApiError({
+          code: "not_found",
+          message: "Agent graph not found"
+        });
       }
       defaultAgentId = agentGraph.defaultAgentId || "";
     }
     if (!defaultAgentId) {
-      return c.json({ error: "No default agent found in graph" }, 404);
+      throw createApiError({
+        code: "not_found",
+        message: "No default agent found in graph"
+      });
     }
     await createOrGetConversation(dbClient_default)({
       tenantId,
@@ -7955,7 +7967,10 @@ app2.openapi(chatCompletionsRoute, async (c) => {
       agentId
     });
     if (!agentInfo) {
-      return c.json({ error: "Agent not found" }, 404);
+      throw createApiError({
+        code: "not_found",
+        message: "Agent not found"
+      });
     }
     const validatedContext = c.get("validatedContext") || body.requestContext || {};
     const credentialStores = c.get("credentialStores");
@@ -8013,41 +8028,69 @@ app2.openapi(chatCompletionsRoute, async (c) => {
       });
     }
     return streamSSE(c, async (stream2) => {
-      const sseHelper = createSSEStreamHelper(stream2, requestId2, timestamp);
-      await sseHelper.writeRole();
-      logger20.info({ agentId }, "Starting execution");
-      const executionHandler = new ExecutionHandler();
-      const result = await executionHandler.execute({
-        executionContext,
-        conversationId,
-        userMessage,
-        initialAgentId: agentId,
-        requestId: requestId2,
-        sseHelper
-      });
-      logger20.info(
-        { result },
-        `Execution completed: ${result.success ? "success" : "failed"} after ${result.iterations} iterations`
-      );
-      if (!result.success) {
-        await sseHelper.writeOperation(
-          errorOp("Sorry, I was unable to process your request at this time. Please try again.", "system")
+      try {
+        const sseHelper = createSSEStreamHelper(stream2, requestId2, timestamp);
+        await sseHelper.writeRole();
+        logger20.info({ agentId }, "Starting execution");
+        const executionHandler = new ExecutionHandler();
+        const result = await executionHandler.execute({
+          executionContext,
+          conversationId,
+          userMessage,
+          initialAgentId: agentId,
+          requestId: requestId2,
+          sseHelper
+        });
+        logger20.info(
+          { result },
+          `Execution completed: ${result.success ? "success" : "failed"} after ${result.iterations} iterations`
+        );
+        if (!result.success) {
+          await sseHelper.writeOperation(
+            errorOp(
+              "Sorry, I was unable to process your request at this time. Please try again.",
+              "system"
+            )
+          );
+        }
+        await sseHelper.complete();
+      } catch (error) {
+        logger20.error(
+          {
+            error: error instanceof Error ? error.message : error,
+            stack: error instanceof Error ? error.stack : void 0
+          },
+          "Error during streaming execution"
         );
+        try {
+          const sseHelper = createSSEStreamHelper(stream2, requestId2, timestamp);
+          await sseHelper.writeOperation(
+            errorOp(
+              "Sorry, I was unable to process your request at this time. Please try again.",
+              "system"
+            )
+          );
+          await sseHelper.complete();
+        } catch (streamError) {
+          logger20.error({ streamError }, "Failed to write error to stream");
+        }
       }
-      await sseHelper.complete();
     });
   } catch (error) {
-    console.error("\u274C Error in chat completions endpoint:", {
-      error: error instanceof Error ? error.message : error,
-      stack: error instanceof Error ? error.stack : void 0
-    });
-    return c.json(
+    logger20.error(
       {
-        error: "Failed to process chat completion",
-        message: error instanceof Error ? error.message : "Unknown error"
+        error: error instanceof Error ? error.message : error,
+        stack: error instanceof Error ? error.stack : void 0
       },
-      500
+      "Error in chat completions endpoint before streaming"
     );
+    if (error && typeof error === "object" && "status" in error) {
+      throw error;
+    }
+    throw createApiError({
+      code: "internal_server_error",
+      message: error instanceof Error ? error.message : "Failed to process chat completion"
+    });
   }
 });
 var getMessageText = (content) => {
@@ -8127,12 +8170,18 @@ app3.openapi(chatDataStreamRoute, async (c) => {
       scopes: { tenantId, projectId, graphId }
     });
     if (!agentGraph) {
-      return c.json({ error: "Agent graph not found" }, 404);
+      throw createApiError({
+        code: "not_found",
+        message: "Agent graph not found"
+      });
     }
     const defaultAgentId = agentGraph.defaultAgentId;
     const graphName = agentGraph.name;
     if (!defaultAgentId) {
-      return c.json({ error: "Graph does not have a default agent configured" }, 400);
+      throw createApiError({
+        code: "bad_request",
+        message: "Graph does not have a default agent configured"
+      });
     }
     const activeAgent = await getActiveAgentForConversation(dbClient_default)({
       scopes: { tenantId, projectId },
@@ -8151,7 +8200,10 @@ app3.openapi(chatDataStreamRoute, async (c) => {
       agentId
     });
     if (!agentInfo) {
-      return c.json({ error: "Agent not found" }, 404);
+      throw createApiError({
+        code: "not_found",
+        message: "Agent not found"
+      });
     }
     const validatedContext = c.get("validatedContext") || body.requestContext || {};
     const credentialStores = c.get("credentialStores");
@@ -8230,7 +8282,10 @@ app3.openapi(chatDataStreamRoute, async (c) => {
     );
   } catch (error) {
     logger21.error({ error }, "chatDataStream error");
-    return c.json({ error: "Failed to process chat completion" }, 500);
+    throw createApiError({
+      code: "internal_server_error",
+      message: "Failed to process chat completion"
+    });
   }
 });
 var chatDataStream_default = app3;
@@ -8771,6 +8826,8 @@ app4.delete("/", async (c) => {
   );
 });
 var mcp_default = app4;
+
+// src/app.ts
 var logger23 = getLogger("agents-run-api");
 function createExecutionHono(serverConfig, credentialStores) {
   const app6 = new OpenAPIHono();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-run-api",
-  "version": "0.0.0-dev-20250919185254",
+  "version": "0.0.0-dev-20250919185941",
   "description": "Agents Run API for Inkeep Agent Framework - handles chat, agent execution, and streaming",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,7 +45,7 @@
     "traverse": "^0.6.11",
     "ts-pattern": "^5.7.1",
     "zod": "^4.1.5",
-    "@inkeep/agents-core": "^0.0.0-dev-20250919185254"
+    "@inkeep/agents-core": "^0.0.0-dev-20250919185941"
   },
   "devDependencies": {
     "@hono/vite-dev-server": "^0.20.1",