@inkeep/agents-run-api 0.1.0 → 0.1.2

package/dist/app.js

@@ -1,5 +1,4 @@
-import { createRoute } from '@hono/zod-openapi';
-import { OpenApiHonoWithExecutionContext } from '@inkeep/agents-core';
+import { createRoute, OpenAPIHono } from '@hono/zod-openapi';
 import { context as otelContext, propagation } from '@opentelemetry/api';
 import { cors } from 'hono/cors';
 import { HTTPException } from 'hono/http-exception';
@@ -13,182 +12,191 @@ import agentRoutes from './routes/agents.js';
 import chatRoutes from './routes/chat.js';
 import chatDataRoutes from './routes/chatDataStream.js';
 import mcpRoutes from './routes/mcp.js';
-const app = new OpenApiHonoWithExecutionContext();
-// Request ID middleware
-app.use('*', requestId());
-// OpenTelemetry baggage middleware
-app.use('*', async (c, next) => {
-    const reqId = c.get('requestId');
-    let bag = propagation.getBaggage(otelContext.active());
-    if (!bag) {
-        bag = propagation.createBaggage();
-    }
-    bag = bag.setEntry('request.id', { value: String(reqId ?? 'unknown') });
-    const ctxWithBag = propagation.setBaggage(otelContext.active(), bag);
-    return otelContext.with(ctxWithBag, () => next());
-});
-// Baggage middleware for execution API - extracts context from API key authentication
-app.use('*', async (c, next) => {
-    // Get the API key context if available (set by auth middleware)
-    const executionContext = c.get('executionContext');
-    if (!executionContext) {
-        // No API key context, skip baggage setup
-        return next();
-    }
-    const { tenantId, projectId, graphId } = executionContext;
-    // Extract conversation ID from JSON body if present
-    let conversationId;
-    if (c.req.header('content-type')?.includes('application/json')) {
-        try {
-            const body = await c.req.json();
-            conversationId = body?.conversationId;
+function createExecutionHono(serverConfig, credentialStores) {
+    const app = new OpenAPIHono();
+    // Request ID middleware
+    app.use('*', requestId());
+    // OpenTelemetry baggage middleware
+    app.use('*', async (c, next) => {
+        const reqId = c.get('requestId');
+        let bag = propagation.getBaggage(otelContext.active());
+        if (!bag) {
+            bag = propagation.createBaggage();
         }
-        catch (_) {
-            // Silently ignore parse errors for non-JSON bodies
+        bag = bag.setEntry('request.id', { value: String(reqId ?? 'unknown') });
+        const ctxWithBag = propagation.setBaggage(otelContext.active(), bag);
+        return otelContext.with(ctxWithBag, () => next());
+    });
+    // Baggage middleware for execution API - extracts context from API key authentication
+    app.use('*', async (c, next) => {
+        // Get the API key context if available (set by auth middleware)
+        const executionContext = c.get('executionContext');
+        if (!executionContext) {
+            // No API key context, skip baggage setup
+            return next();
         }
-    }
-    const entries = Object.fromEntries(Object.entries({
-        'graph.id': graphId,
-        'tenant.id': tenantId,
-        'project.id': projectId,
-        'conversation.id': conversationId,
-    }).filter((entry) => {
-        const [, v] = entry;
-        return typeof v === 'string' && v.length > 0;
-    }));
-    if (!Object.keys(entries).length) {
-        return next();
-    }
-    const bag = Object.entries(entries).reduce((b, [key, value]) => b.setEntry(key, { value: value || '' }), propagation.getBaggage(otelContext.active()) ?? propagation.createBaggage());
-    const ctxWithBag = propagation.setBaggage(otelContext.active(), bag);
-    return otelContext.with(ctxWithBag, () => next());
-});
-// Logging middleware
-app.use(pinoLogger({
-    pino: getLogger(),
-    http: {
-        onResLevel(c) {
-            if (c.res.status >= 500) {
-                return 'error';
+        const { tenantId, projectId, graphId } = executionContext;
+        // Extract conversation ID from JSON body if present
+        let conversationId;
+        if (c.req.header('content-type')?.includes('application/json')) {
+            try {
+                const body = await c.req.json();
+                conversationId = body?.conversationId;
             }
-            return 'info';
+            catch (_) {
+                // Silently ignore parse errors for non-JSON bodies
+            }
+        }
+        const entries = Object.fromEntries(Object.entries({
+            'graph.id': graphId,
+            'tenant.id': tenantId,
+            'project.id': projectId,
+            'conversation.id': conversationId,
+        }).filter((entry) => {
+            const [, v] = entry;
+            return typeof v === 'string' && v.length > 0;
+        }));
+        if (!Object.keys(entries).length) {
+            return next();
+        }
+        const bag = Object.entries(entries).reduce((b, [key, value]) => b.setEntry(key, { value: value || '' }), propagation.getBaggage(otelContext.active()) ?? propagation.createBaggage());
+        const ctxWithBag = propagation.setBaggage(otelContext.active(), bag);
+        return otelContext.with(ctxWithBag, () => next());
+    });
+    // Server config and credential stores middleware
+    app.use('*', async (c, next) => {
+        c.set('serverConfig', serverConfig);
+        c.set('credentialStores', credentialStores);
+        return next();
+    });
+    // Logging middleware
+    app.use(pinoLogger({
+        pino: getLogger(),
+        http: {
+            onResLevel(c) {
+                if (c.res.status >= 500) {
+                    return 'error';
+                }
+                return 'info';
+            },
         },
-    },
-}));
-// Error handling
-app.onError(async (err, c) => {
-    const isExpectedError = err instanceof HTTPException;
-    const status = isExpectedError ? err.status : 500;
-    const requestId = c.get('requestId') || 'unknown';
-    // Zod validation error detection
-    let zodIssues;
-    if (err && typeof err === 'object') {
-        if (err.cause && Array.isArray(err.cause.issues)) {
-            zodIssues = err.cause.issues;
+    }));
+    // Error handling
+    app.onError(async (err, c) => {
+        const isExpectedError = err instanceof HTTPException;
+        const status = isExpectedError ? err.status : 500;
+        const requestId = c.get('requestId') || 'unknown';
+        // Zod validation error detection
+        let zodIssues;
+        if (err && typeof err === 'object') {
+            if (err.cause && Array.isArray(err.cause.issues)) {
+                zodIssues = err.cause.issues;
+            }
+            else if (Array.isArray(err.issues)) {
+                zodIssues = err.issues;
+            }
         }
-        else if (Array.isArray(err.issues)) {
-            zodIssues = err.issues;
+        if (status === 400 && Array.isArray(zodIssues)) {
+            c.status(400);
+            c.header('Content-Type', 'application/problem+json');
+            c.header('X-Content-Type-Options', 'nosniff');
+            return c.json({
+                type: 'https://docs.inkeep.com/agents-api/errors#bad_request',
+                title: 'Validation Failed',
+                status: 400,
+                detail: 'Request validation failed',
+                errors: zodIssues.map((issue) => ({
+                    detail: issue.message,
+                    pointer: issue.path ? `/${issue.path.join('/')}` : undefined,
+                    name: issue.path ? issue.path.join('.') : undefined,
+                    reason: issue.message,
+                })),
+            });
         }
-    }
-    if (status === 400 && Array.isArray(zodIssues)) {
-        c.status(400);
+        if (status >= 500) {
+            if (!isExpectedError) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                const errorStack = err instanceof Error ? err.stack : undefined;
+                getLogger().error({
+                    error: err,
+                    message: errorMessage,
+                    stack: errorStack,
+                    path: c.req.path,
+                    requestId,
+                }, 'Unexpected server error occurred');
+            }
+            else {
+                getLogger().error({
+                    error: err,
+                    path: c.req.path,
+                    requestId,
+                    status,
+                }, 'Server error occurred');
+            }
+        }
+        if (isExpectedError) {
+            try {
+                const response = err.getResponse();
+                return response;
+            }
+            catch (responseError) {
+                getLogger().error({ error: responseError }, 'Error while handling HTTPException response');
+            }
+        }
+        const { status: respStatus, title, detail, instance } = await handleApiError(err, requestId);
+        c.status(respStatus);
         c.header('Content-Type', 'application/problem+json');
         c.header('X-Content-Type-Options', 'nosniff');
         return c.json({
-            type: 'https://docs.inkeep.com/agents-api/errors#bad_request',
-            title: 'Validation Failed',
-            status: 400,
-            detail: 'Request validation failed',
-            errors: zodIssues.map((issue) => ({
-                detail: issue.message,
-                pointer: issue.path ? `/${issue.path.join('/')}` : undefined,
-                name: issue.path ? issue.path.join('.') : undefined,
-                reason: issue.message,
-            })),
+            type: 'https://docs.inkeep.com/agents-api/errors#internal_server_error',
+            title,
+            status: respStatus,
+            detail,
+            ...(instance && { instance }),
         });
-    }
-    if (status >= 500) {
-        if (!isExpectedError) {
-            const errorMessage = err instanceof Error ? err.message : String(err);
-            const errorStack = err instanceof Error ? err.stack : undefined;
-            getLogger().error({
-                error: err,
-                message: errorMessage,
-                stack: errorStack,
-                path: c.req.path,
-                requestId,
-            }, 'Unexpected server error occurred');
-        }
-        else {
-            getLogger().error({
-                error: err,
-                path: c.req.path,
-                requestId,
-                status,
-            }, 'Server error occurred');
-        }
-    }
-    if (isExpectedError) {
-        try {
-            const response = err.getResponse();
-            return response;
-        }
-        catch (responseError) {
-            getLogger().error({ error: responseError }, 'Error while handling HTTPException response');
-        }
-    }
-    const { status: respStatus, title, detail, instance } = await handleApiError(err, requestId);
-    c.status(respStatus);
-    c.header('Content-Type', 'application/problem+json');
-    c.header('X-Content-Type-Options', 'nosniff');
-    return c.json({
-        type: 'https://docs.inkeep.com/agents-api/errors#internal_server_error',
-        title,
-        status: respStatus,
-        detail,
-        ...(instance && { instance }),
     });
-});
-// CORS middleware
-app.use('*', cors({
-    origin: (origin) => {
-        if (!origin)
-            return origin;
-        return origin.startsWith('http://localhost:') || origin.startsWith('https://localhost:')
-            ? origin
-            : null;
-    },
-    allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
-    allowHeaders: ['*'],
-    exposeHeaders: ['Content-Length'],
-    maxAge: 86400,
-    credentials: true,
-}));
-// Apply API key authentication to all routes except health and docs
-app.use('/tenants/*', apiKeyAuth());
-app.use('/agents/*', apiKeyAuth());
-app.use('/v1/*', apiKeyAuth());
-app.use('/api/*', apiKeyAuth());
-// Health check endpoint (no auth required)
-app.openapi(createRoute({
-    method: 'get',
-    path: '/health',
-    tags: ['health'],
-    summary: 'Health check',
-    description: 'Check if the execution service is healthy',
-    responses: {
-        204: {
-            description: 'Service is healthy',
+    // CORS middleware
+    app.use('*', cors({
+        origin: (origin) => {
+            if (!origin)
+                return origin;
+            return origin.startsWith('http://localhost:') || origin.startsWith('https://localhost:')
+                ? origin
+                : null;
         },
-    },
-}), (c) => {
-    return c.body(null, 204);
-});
-// Mount execution routes - API key provides tenant, project, and graph context
-app.route('/v1/chat', chatRoutes);
-app.route('/api', chatDataRoutes);
-app.route('/v1/mcp', mcpRoutes);
-app.route('/agents', agentRoutes);
-// Setup OpenAPI documentation endpoints (/openapi.json and /docs)
-setupOpenAPIRoutes(app);
-export default app;
+        allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+        allowHeaders: ['*'],
+        exposeHeaders: ['Content-Length'],
+        maxAge: 86400,
+        credentials: true,
+    }));
+    // Apply API key authentication to all routes except health and docs
+    app.use('/tenants/*', apiKeyAuth());
+    app.use('/agents/*', apiKeyAuth());
+    app.use('/v1/*', apiKeyAuth());
+    app.use('/api/*', apiKeyAuth());
+    // Health check endpoint (no auth required)
+    app.openapi(createRoute({
+        method: 'get',
+        path: '/health',
+        tags: ['health'],
+        summary: 'Health check',
+        description: 'Check if the execution service is healthy',
+        responses: {
+            204: {
+                description: 'Service is healthy',
+            },
+        },
+    }), (c) => {
+        return c.body(null, 204);
+    });
+    // Mount execution routes - API key provides tenant, project, and graph context
+    app.route('/v1/chat', chatRoutes);
+    app.route('/api', chatDataRoutes);
+    app.route('/v1/mcp', mcpRoutes);
+    app.route('/agents', agentRoutes);
+    // Setup OpenAPI documentation endpoints (/openapi.json and /docs)
+    setupOpenAPIRoutes(app);
+    return app;
+}
+export { createExecutionHono };

package/dist/data/agents.d.ts

@@ -1,4 +1,4 @@
 import type { RegisteredAgent } from '../a2a/types.js';
-import { ExecutionContext } from '@inkeep/agents-core';
-export declare function getRegisteredAgent(executionContext: ExecutionContext): Promise<RegisteredAgent | null>;
+import { ExecutionContext, CredentialStoreRegistry } from '@inkeep/agents-core';
+export declare function getRegisteredAgent(executionContext: ExecutionContext, credentialStoreRegistry?: CredentialStoreRegistry): Promise<RegisteredAgent | null>;
 //# sourceMappingURL=agents.d.ts.map

package/dist/data/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/data/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,EAEL,gBAAgB,EAIjB,MAAM,qBAAqB,CAAC;AAuE7B,wBAAsB,kBAAkB,CACtC,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiBjC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/data/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,EAEL,gBAAgB,EAIhB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAyE7B,wBAAsB,kBAAkB,CACtC,gBAAgB,EAAE,gBAAgB,EAClC,uBAAuB,CAAC,EAAE,uBAAuB,GAChD,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiBjC"}

package/dist/data/agents.js

@@ -7,7 +7,7 @@ const logger = getLogger('agents');
  * Create a RegisteredAgent from database agent data
  * Hydrates agent directly from database schema using types from schema.ts
  */
-async function hydrateAgent({ dbAgent, graphId, baseUrl, apiKey, }) {
+async function hydrateAgent({ dbAgent, graphId, baseUrl, apiKey, credentialStoreRegistry, }) {
     try {
         // Create task handler for the agent
         const taskHandlerConfig = await createTaskHandlerConfig({
@@ -18,7 +18,7 @@ async function hydrateAgent({ dbAgent, graphId, baseUrl, apiKey, }) {
             baseUrl: baseUrl,
             apiKey: apiKey,
         });
-        const taskHandler = createTaskHandler(taskHandlerConfig);
+        const taskHandler = createTaskHandler(taskHandlerConfig, credentialStoreRegistry);
         // Create AgentCard from database data using schema.ts types
         const agentCard = {
             name: dbAgent.name,
@@ -56,7 +56,7 @@ async function hydrateAgent({ dbAgent, graphId, baseUrl, apiKey, }) {
     }
 }
 // A2A functions that hydrate agents on-demand
-export async function getRegisteredAgent(executionContext) {
+export async function getRegisteredAgent(executionContext, credentialStoreRegistry) {
     const { tenantId, projectId, graphId, agentId, baseUrl } = executionContext;
     if (!agentId) {
         throw new Error('Agent ID is required');
@@ -69,5 +69,5 @@ export async function getRegisteredAgent(executionContext) {
         return null;
     }
     const agentFrameworkBaseUrl = `${baseUrl}/agents`;
-    return hydrateAgent({ dbAgent, graphId, baseUrl: agentFrameworkBaseUrl });
+    return hydrateAgent({ dbAgent, graphId, baseUrl: agentFrameworkBaseUrl, credentialStoreRegistry });
 }

package/dist/env.d.ts

@@ -7,36 +7,38 @@ declare const envSchema: z.ZodObject<{
     }>>;
     ENVIRONMENT: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         development: "development";
-        production: "production";
         pentest: "pentest";
+        production: "production";
         test: "test";
     }>>>;
     DB_FILE_NAME: z.ZodDefault<z.ZodString>;
     PORT: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
     AGENT_BASE_URL: z.ZodOptional<z.ZodString>;
     LOG_LEVEL: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        trace: "trace";
+        error: "error";
         debug: "debug";
         info: "info";
+        trace: "trace";
         warn: "warn";
-        error: "error";
     }>>>;
     NANGO_SECRET_KEY: z.ZodOptional<z.ZodString>;
     OPENAI_API_KEY: z.ZodOptional<z.ZodString>;
     ANTHROPIC_API_KEY: z.ZodString;
     INKEEP_AGENTS_RUN_BYPASS_SECRET: z.ZodOptional<z.ZodString>;
+    OTEL_TRACES_FORCE_FLUSH_ENABLED: z.ZodOptional<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
 }, z.core.$strip>;
 export declare const env: {
-    ENVIRONMENT: "development" | "production" | "pentest" | "test";
+    ENVIRONMENT: "development" | "pentest" | "production" | "test";
     DB_FILE_NAME: string;
     PORT: number;
-    LOG_LEVEL: "trace" | "debug" | "info" | "warn" | "error";
+    LOG_LEVEL: "error" | "debug" | "info" | "trace" | "warn";
     ANTHROPIC_API_KEY: string;
     NODE_ENV?: "development" | "production" | "test" | undefined;
     AGENT_BASE_URL?: string | undefined;
     NANGO_SECRET_KEY?: string | undefined;
     OPENAI_API_KEY?: string | undefined;
     INKEEP_AGENTS_RUN_BYPASS_SECRET?: string | undefined;
+    OTEL_TRACES_FORCE_FLUSH_ENABLED?: boolean | undefined;
 };
 export type Env = z.infer<typeof envSchema>;
 export {};

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiCxB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcb,CAAC;AAuBH,eAAO,MAAM,GAAG;;;;;;;;;;;CAAa,CAAC;AAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiCxB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAeb,CAAC;AAuBH,eAAO,MAAM,GAAG;;;;;;;;;;;;CAAa,CAAC;AAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/env.js

@@ -42,6 +42,7 @@ const envSchema = z.object({
     OPENAI_API_KEY: z.string().optional(),
     ANTHROPIC_API_KEY: z.string(),
     INKEEP_AGENTS_RUN_BYPASS_SECRET: z.string().optional(),
+    OTEL_TRACES_FORCE_FLUSH_ENABLED: z.stringbool().optional(),
 });
 const parseEnv = () => {
     try {

package/dist/handlers/executionHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executionHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/executionHandler.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,UAAU,sBAAsB;IAC9B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,YAAY,CAAC;CACzB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAK;IAEhC;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;CAidxE"}
+{"version":3,"file":"executionHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/executionHandler.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,UAAU,sBAAsB;IAC9B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,YAAY,CAAC;CACzB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAK;IAEhC;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;CA8cxE"}

package/dist/handlers/executionHandler.js

@@ -3,7 +3,7 @@ import { A2AClient } from '../a2a/client.js';
 import { executeTransfer, isTransferResponse } from '../a2a/transfer.js';
 import { createMessage, getActiveAgentForConversation, createTask, getTask, updateTask, getFullGraph, } from '@inkeep/agents-core';
 import { getLogger } from '../logger.js';
-import { agentInitializingOp, agentReadyOp, completionOp, errorOp, } from '../utils/agent-operations.js';
+import { agentInitializingOp, agentReadyOp, agentThinkingOp, completionOp, errorOp, } from '../utils/agent-operations.js';
 import { graphSessionManager } from '../utils/graph-session.js';
 import { MCPStreamHelper } from '../utils/stream-helpers.js';
 import { registerStreamHelper, unregisterStreamHelper } from '../utils/stream-registry.js';
@@ -59,10 +59,7 @@ export class ExecutionHandler {
             await sseHelper.writeOperation(agentInitializingOp(requestId, graphId));
             await sseHelper.writeOperation(agentReadyOp(requestId, graphId));
             // Send agent thinking operation after ready
-            await sseHelper.writeData('data-operation', {
-                type: 'agent_thinking',
-                ctx: { agent: 'system' },
-            });
+            await sseHelper.writeOperation(agentThinkingOp('system'));
             // Check for existing task first to prevent race conditions
             const taskId = `task_${conversationId}-${requestId}`;
             const existingTask = await getTask(dbClient)({ id: taskId });

package/dist/index.d.ts

@@ -1,5 +1,23 @@
 import './instrumentation.js';
-import { AgentExecutionServer } from './AgentExecutionServer.js';
-declare const executionServer: AgentExecutionServer;
-export { executionServer };
+import { createExecutionHono } from './app.js';
+import { CredentialStoreRegistry, type CredentialStore, type ServerConfig } from '@inkeep/agents-core';
+declare const app: import("@hono/zod-openapi").OpenAPIHono<{
+    Variables: {
+        executionContext: import("@inkeep/agents-core").ExecutionContext;
+        serverConfig: ServerConfig;
+        credentialStores: CredentialStoreRegistry;
+    };
+}, {}, "/">;
+export default app;
+export { createExecutionHono };
+export declare function createExecutionApp(config?: {
+    serverConfig?: ServerConfig;
+    credentialStores?: CredentialStore[];
+}): import("@hono/zod-openapi").OpenAPIHono<{
+    Variables: {
+        executionContext: import("@inkeep/agents-core").ExecutionContext;
+        serverConfig: ServerConfig;
+        credentialStores: CredentialStoreRegistry;
+    };
+}, {}, "/">;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAsB,MAAM,2BAA2B,CAAC;AA0BrF,QAAA,MAAM,eAAe,sBAQnB,CAAC;AAiBH,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EACL,uBAAuB,EAEvB,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAiB7B,QAAA,MAAM,GAAG;;;;;;WAAsD,CAAC;AAGhE,eAAe,GAAG,CAAC;AAGnB,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAG/B,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE;IAC1C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;CACtC;;;;;;YAMA"}

package/dist/index.js

@@ -1,43 +1,28 @@
 import './instrumentation.js';
-import { AgentExecutionServer, EXECUTION_API_PORT } from './AgentExecutionServer.js';
-import { InMemoryCredentialStore, createNangoCredentialStore, createKeyChainStore, } from '@inkeep/agents-core';
-import { env } from './env.js';
-import { getLogger } from './logger.js';
-const logger = getLogger('execution-api');
-// Create credential stores
-const credentialStores = [
-    new InMemoryCredentialStore('memory-default'), // In-memory store + env vars
-    // Nango store (only loads if NANGO_SECRET_KEY is set)
-    ...(process.env.NANGO_SECRET_KEY
-        ? [
-            createNangoCredentialStore('nango-default', {
-                apiUrl: process.env.NANGO_HOST || 'https://api.nango.dev',
-                secretKey: process.env.NANGO_SECRET_KEY,
-            }),
-        ]
-        : []),
-    createKeyChainStore('keychain-default'),
-];
-// Initialize Execution Server
-const executionServer = new AgentExecutionServer({
-    port: EXECUTION_API_PORT,
-    credentialStores,
+import { createExecutionHono } from './app.js';
+import { CredentialStoreRegistry, createDefaultCredentialStores, } from '@inkeep/agents-core';
+// Create default configuration
+const defaultConfig = {
+    port: 3003,
     serverOptions: {
         requestTimeout: 120000, // 120 seconds for execution requests
         keepAliveTimeout: 60000,
         keepAlive: true,
     },
-});
-// Start the server only if not in test environment
-if (env.ENVIRONMENT !== 'test') {
-    executionServer
-        .serve()
-        .then(() => {
-        logger.info(`📝 OpenAPI documentation available at http://localhost:${EXECUTION_API_PORT}/openapi.json`);
-    })
-        .catch((error) => {
-        logger.error('Failed to start Execution API server:', error);
-        process.exit(1);
-    });
+};
+// Create default credential stores
+const defaultStores = createDefaultCredentialStores();
+const defaultRegistry = new CredentialStoreRegistry(defaultStores);
+// Create default app instance for simple usage
+const app = createExecutionHono(defaultConfig, defaultRegistry);
+// Export the default app for Vite dev server and simple deployments
+export default app;
+// Also export the factory function for advanced usage
+export { createExecutionHono };
+// Export a helper to create app with custom credential stores - fallsback to default configs
+export function createExecutionApp(config) {
+    const serverConfig = config?.serverConfig ?? defaultConfig;
+    const stores = config?.credentialStores ?? defaultStores;
+    const registry = new CredentialStoreRegistry(stores);
+    return createExecutionHono(serverConfig, registry);
 }
-export { executionServer };

package/dist/routes/agents.d.ts

@@ -1,4 +1,10 @@
 import { OpenAPIHono } from '@hono/zod-openapi';
-declare const app: OpenAPIHono<import("hono").Env, {}, "/">;
+import { type CredentialStoreRegistry } from '@inkeep/agents-core';
+type AppVariables = {
+    credentialStores: CredentialStoreRegistry;
+};
+declare const app: OpenAPIHono<{
+    Variables: AppVariables;
+}, {}, "/">;
 export default app;
 //# sourceMappingURL=agents.d.ts.map

package/dist/routes/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/routes/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAc7D,QAAA,MAAM,GAAG,0CAAoB,CAAC;AAkM9B,eAAe,GAAG,CAAC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/routes/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAI7D,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAM7B,KAAK,YAAY,GAAG;IAClB,gBAAgB,EAAE,uBAAuB,CAAC;CAC3C,CAAC;AAEF,QAAA,MAAM,GAAG;eAAgC,YAAY;WAAK,CAAC;AAqM3D,eAAe,GAAG,CAAC"}

package/dist/routes/agents.js

@@ -61,7 +61,8 @@ app.openapi(createRoute({
             graphId,
             agentId,
         }, 'agent-level well-known agent.json');
-        const agent = await getRegisteredAgent(executionContext);
+        const credentialStores = c.get('credentialStores');
+        const agent = await getRegisteredAgent(executionContext, credentialStores);
         logger.info({ agent }, 'agent registered: well-known agent.json');
         if (!agent) {
             return c.json({ error: 'Agent not found' }, 404);
@@ -108,7 +109,8 @@ app.post('/a2a', async (c) => {
             agentId,
         }, 'agent-level a2a endpoint');
         // Ensure agent is registered (lazy loading)
-        const agent = await getRegisteredAgent(executionContext);
+        const credentialStores = c.get('credentialStores');
+        const agent = await getRegisteredAgent(executionContext, credentialStores);
         if (!agent) {
             return c.json({
                 jsonrpc: '2.0',
@@ -140,7 +142,8 @@ app.post('/a2a', async (c) => {
         }
         executionContext.agentId = graph.defaultAgentId;
         // fetch the default agent and use it as entry point for the graph
-        const defaultAgent = await getRegisteredAgent(executionContext);
+        const credentialStores = c.get('credentialStores');
+        const defaultAgent = await getRegisteredAgent(executionContext, credentialStores);
         if (!defaultAgent) {
             return c.json({
                 jsonrpc: '2.0',