@inkeep/agents-run-api 0.1.0

package/dist/agents/versions/V1Config.d.ts

@@ -0,0 +1,21 @@
+import type { McpTool } from '@inkeep/agents-core';
+import type { SystemPromptV1, ToolData, VersionConfig } from '../types.js';
+export declare class V1Config implements VersionConfig<SystemPromptV1> {
+    readonly templateFiles: string[];
+    static convertMcpToolsToToolData(mcpTools: McpTool[] | undefined): ToolData[];
+    private isToolDataArray;
+    assemble(templates: Map<string, string>, config: SystemPromptV1): string;
+    private generateGraphContextSection;
+    private generateThinkingPreparationSection;
+    private generateTransferInstructions;
+    private generateDelegationInstructions;
+    private getArtifactReferencingRules;
+    private generateArtifactsSection;
+    private generateArtifactXml;
+    private generateToolsSection;
+    private generateToolXml;
+    private generateDataComponentsSection;
+    private generateDataComponentXml;
+    private generateParametersXml;
+}
+//# sourceMappingURL=V1Config.d.ts.map

package/dist/agents/versions/V1Config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1Config.d.ts","sourceRoot":"","sources":["../../../src/agents/versions/V1Config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,OAAO,EAAY,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3E,qBAAa,QAAS,YAAW,aAAa,CAAC,cAAc,CAAC;IAC5D,QAAQ,CAAC,aAAa,WAMpB;IAEF,MAAM,CAAC,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE;IAoB7E,OAAO,CAAC,eAAe;IAOvB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM;IAwDxE,OAAO,CAAC,2BAA2B;IAWnC,OAAO,CAAC,kCAAkC;IAgB1C,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,8BAA8B;IAQtC,OAAO,CAAC,2BAA2B;IAqEnC,OAAO,CAAC,wBAAwB;IA4BhC,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,6BAA6B;IAiCrC,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,qBAAqB;CAqB9B"}

package/dist/agents/versions/V1Config.js

@@ -0,0 +1,285 @@
+export class V1Config {
+    templateFiles = [
+        'system-prompt.xml',
+        'tool.xml',
+        'data-component.xml',
+        'artifact.xml',
+        'thinking-preparation.xml',
+    ];
+    static convertMcpToolsToToolData(mcpTools) {
+        if (!mcpTools || mcpTools.length === 0) {
+            return [];
+        }
+        const toolData = [];
+        for (const mcpTool of mcpTools) {
+            if (mcpTool.availableTools) {
+                for (const toolDef of mcpTool.availableTools) {
+                    toolData.push({
+                        name: toolDef.name,
+                        description: toolDef.description || 'No description available',
+                        inputSchema: toolDef.inputSchema || {},
+                        usageGuidelines: `Use this tool from ${mcpTool.name} server when appropriate.`,
+                    });
+                }
+            }
+        }
+        return toolData;
+    }
+    isToolDataArray(tools) {
+        if (!tools || tools.length === 0)
+            return true; // Default to ToolData[] for empty arrays
+        // Check if the first item has properties of ToolData vs McpTool
+        const firstItem = tools[0];
+        return 'usageGuidelines' in firstItem && !('config' in firstItem);
+    }
+    assemble(templates, config) {
+        const systemPromptTemplate = templates.get('system-prompt');
+        if (!systemPromptTemplate) {
+            throw new Error('System prompt template not loaded');
+        }
+        let systemPrompt = systemPromptTemplate;
+        // Replace core prompt
+        systemPrompt = systemPrompt.replace('{{CORE_INSTRUCTIONS}}', config.corePrompt);
+        // Replace graph context section
+        const graphContextSection = this.generateGraphContextSection(config.graphPrompt);
+        systemPrompt = systemPrompt.replace('{{GRAPH_CONTEXT_SECTION}}', graphContextSection);
+        // Handle both McpTool[] and ToolData[] formats
+        const toolData = this.isToolDataArray(config.tools)
+            ? config.tools
+            : V1Config.convertMcpToolsToToolData(config.tools);
+        const hasDataComponents = config.dataComponents && config.dataComponents.length > 0;
+        const artifactsSection = this.generateArtifactsSection(templates, config.artifacts, hasDataComponents);
+        systemPrompt = systemPrompt.replace('{{ARTIFACTS_SECTION}}', artifactsSection);
+        const toolsSection = this.generateToolsSection(templates, toolData);
+        systemPrompt = systemPrompt.replace('{{TOOLS_SECTION}}', toolsSection);
+        const dataComponentsSection = this.generateDataComponentsSection(templates, config.dataComponents);
+        systemPrompt = systemPrompt.replace('{{DATA_COMPONENTS_SECTION}}', dataComponentsSection);
+        const thinkingPreparationSection = this.generateThinkingPreparationSection(templates, config.isThinkingPreparation);
+        systemPrompt = systemPrompt.replace('{{THINKING_PREPARATION_INSTRUCTIONS}}', thinkingPreparationSection);
+        // Generate agent relation instructions based on configuration
+        const transferSection = this.generateTransferInstructions(config.hasTransferRelations);
+        systemPrompt = systemPrompt.replace('{{TRANSFER_INSTRUCTIONS}}', transferSection);
+        const delegationSection = this.generateDelegationInstructions(config.hasDelegateRelations);
+        systemPrompt = systemPrompt.replace('{{DELEGATION_INSTRUCTIONS}}', delegationSection);
+        return systemPrompt;
+    }
+    generateGraphContextSection(graphPrompt) {
+        if (!graphPrompt) {
+            return '';
+        }
+        return `
+  <graph_context>
+    ${graphPrompt}
+  </graph_context>`;
+    }
+    generateThinkingPreparationSection(templates, isThinkingPreparation) {
+        if (!isThinkingPreparation) {
+            return '';
+        }
+        const thinkingPreparationTemplate = templates.get('thinking-preparation');
+        if (!thinkingPreparationTemplate) {
+            throw new Error('Thinking preparation template not loaded');
+        }
+        return thinkingPreparationTemplate;
+    }
+    generateTransferInstructions(hasTransferRelations) {
+        if (!hasTransferRelations) {
+            return '';
+        }
+        return '- A transfer entails you passing control of the conversation to another agent that may be better suited to handle the task at hand.';
+    }
+    generateDelegationInstructions(hasDelegateRelations) {
+        if (!hasDelegateRelations) {
+            return '';
+        }
+        return '- A delegation means asking another agent to complete a specific task and return the result to you.';
+    }
+    getArtifactReferencingRules(hasDataComponents = false) {
+        if (hasDataComponents) {
+            return `CRITICAL ARTIFACT REFERENCING RULES - MUST ALWAYS FOLLOW:
+
+***GROUNDING REQUIREMENT - ABSOLUTELY MANDATORY***:
+- EVERY response MUST be GROUNDED in artifacts when information comes from sources
+- ALWAYS try to reference artifacts - this is ESSENTIAL for credible, traceable responses  
+- You can NEVER overuse artifact references but you can very easily underuse them
+- Artifact references provide the foundation of trust and verifiability for all information
+
+🚨 INDIVIDUAL ARTIFACT PRINCIPLE 🚨:
+- Each artifact represents ONE SPECIFIC, IMPORTANT, and UNIQUE document or data item
+- Reference artifacts individually by their specific relevance
+- Multiple separate artifacts are better than one generic collection
+- Think: "What specific document/item am I referencing here?"
+
+FOR STRUCTURED DATA COMPONENT RESPONSES:
+
+🚨 CRITICAL: COPY EXACT IDs FROM TOOL OUTPUT 🚨
+
+1. MIX Artifact components throughout your dataComponents array - NEVER group them at the end
+2. PATTERN: Present information → Immediately follow with supporting Artifact → Next information → Next Artifact
+3. **LOOK AT THE TOOL OUTPUT**: Find the save_tool_result output and copy the EXACT artifact_id and task_id
+4. **NEVER MAKE UP IDs**: Do not invent, guess, or modify the IDs - copy them EXACTLY as shown in tool results
+5. ALL artifact references MUST use exact artifact_id and task_id - NEVER reference by name or description
+6. Use Artifact components liberally and frequently - INTERSPERSE them after EVERY claim or fact from sources
+7. Reference individual, specific artifacts that directly support each adjacent piece of information
+
+MANDATORY FORMAT WITH EXACT IDs FROM TOOL OUTPUT:
+- Data Component: {"artifact_id": "art_founder_abc123", "task_id": "task_search_def456"}
+- NEVER: {"artifact_name": "some name"} or {"description": "some description"}
+- NEVER: {"artifact_id": "made_up_id"} - ALWAYS copy from tool output
+
+⚠️ WRONG IDs = BROKEN REFERENCES! Always copy from save_tool_result output! ⚠️`;
+        }
+        else {
+            return `CRITICAL ARTIFACT REFERENCING RULES - MUST ALWAYS FOLLOW:
+
+***GROUNDING REQUIREMENT - ABSOLUTELY MANDATORY***:
+- EVERY response MUST be GROUNDED in artifacts when information comes from sources
+- ALWAYS try to reference artifacts - this is ESSENTIAL for credible, traceable responses
+- You can NEVER overuse artifact references but you can very easily underuse them  
+- Artifact references provide the foundation of trust and verifiability for all information
+
+🚨 INDIVIDUAL ARTIFACT PRINCIPLE 🚨:
+- Each artifact represents ONE SPECIFIC, IMPORTANT, and UNIQUE document or data item
+- Reference artifacts individually by their specific relevance  
+- Multiple separate artifacts are better than one generic collection
+- Think: "What specific document/item am I referencing here?"
+
+FOR PLAIN TEXT RESPONSES (when data components are NOT available):
+
+🚨 CRITICAL: COPY EXACT IDs FROM TOOL OUTPUT 🚨
+
+1. When referencing ANY artifact in flowing text, ALWAYS use this exact format: <artifact:ref id="{{artifact_id}}" task="{{task_id}}" />
+2. **LOOK AT THE TOOL OUTPUT**: Find the save_tool_result output and copy the EXACT artifact_id and task_id
+3. **NEVER MAKE UP IDs**: Do not invent, guess, or modify the IDs - copy them EXACTLY as shown in tool results
+4. NEVER reference artifacts by name or description alone - IDs are MANDATORY
+5. This format is MANDATORY for text content, delegation messages, and all responses
+6. These markers are automatically converted to interactive references
+7. Reference individual, specific artifacts that directly support each piece of information
+
+EXAMPLES WITH EXACT IDs FROM TOOL OUTPUT:
+- Plain Text: "Based on the Nick Gomez profile <artifact:ref id="art_founder_abc123" task="task_search_def456" /> you can..."
+- Delegation: "Delegating to agent with founder information <artifact:ref id="art_profile_xyz789" task="task_analysis_uvw012" />"
+
+⚠️ WRONG IDs = BROKEN REFERENCES! Always copy from save_tool_result output! ⚠️`;
+        }
+    }
+    generateArtifactsSection(templates, artifacts, hasDataComponents = false) {
+        const rules = this.getArtifactReferencingRules(hasDataComponents);
+        if (artifacts.length === 0) {
+            return `<available_artifacts description="No artifacts are currently available, but you may create them during execution.
+
+${rules}
+
+"></available_artifacts>`;
+        }
+        const artifactsXml = artifacts
+            .map((artifact) => this.generateArtifactXml(templates, artifact))
+            .join('\n  ');
+        return `<available_artifacts description="These are the artifacts available for you to use in generating responses.
+
+${rules}
+
+">
+  ${artifactsXml}
+</available_artifacts>`;
+    }
+    generateArtifactXml(templates, artifact) {
+        const artifactTemplate = templates.get('artifact');
+        if (!artifactTemplate) {
+            throw new Error('Artifact template not loaded');
+        }
+        let artifactXml = artifactTemplate;
+        // Extract summary data from artifact parts for context
+        const summaryData = artifact.parts?.map((part) => part.data?.summary).filter(Boolean) || [];
+        const artifactSummary = summaryData.length > 0 ? JSON.stringify(summaryData, null, 2) : 'No summary data available';
+        // Replace artifact variables
+        artifactXml = artifactXml.replace('{{ARTIFACT_NAME}}', artifact.name || '');
+        artifactXml = artifactXml.replace('{{ARTIFACT_DESCRIPTION}}', artifact.description || '');
+        artifactXml = artifactXml.replace('{{TASK_ID}}', artifact.taskId || '');
+        artifactXml = artifactXml.replace('{{ARTIFACT_ID}}', artifact.artifactId || '');
+        artifactXml = artifactXml.replace('{{ARTIFACT_SUMMARY}}', artifactSummary);
+        return artifactXml;
+    }
+    generateToolsSection(templates, tools) {
+        if (tools.length === 0) {
+            return '<available_tools description="No tools are currently available"></available_tools>';
+        }
+        const toolsXml = tools.map((tool) => this.generateToolXml(templates, tool)).join('\n  ');
+        return `<available_tools description="These are the tools available for you to use to accomplish tasks">
+  ${toolsXml}
+</available_tools>`;
+    }
+    generateToolXml(templates, tool) {
+        const toolTemplate = templates.get('tool');
+        if (!toolTemplate) {
+            throw new Error('Tool template not loaded');
+        }
+        let toolXml = toolTemplate;
+        // Replace tool variables
+        toolXml = toolXml.replace('{{TOOL_NAME}}', tool.name);
+        toolXml = toolXml.replace('{{TOOL_DESCRIPTION}}', tool.description || 'No description available');
+        toolXml = toolXml.replace('{{TOOL_USAGE_GUIDELINES}}', tool.usageGuidelines || 'Use this tool when appropriate.');
+        // Convert parameters to XML format
+        const parametersXml = this.generateParametersXml(tool.inputSchema);
+        toolXml = toolXml.replace('{{TOOL_PARAMETERS_SCHEMA}}', parametersXml);
+        return toolXml;
+    }
+    generateDataComponentsSection(templates, dataComponents) {
+        if (dataComponents.length === 0) {
+            return '';
+        }
+        const dataComponentsXml = dataComponents
+            .map((dataComponent) => this.generateDataComponentXml(templates, dataComponent))
+            .join('\n  ');
+        return `<available_data_components description="These are the data components available for you to use in generating responses. Each component represents a single structured piece of information. You can create multiple instances of the same component type when needed.
+
+***MANDATORY JSON RESPONSE FORMAT - ABSOLUTELY CRITICAL***:
+- WHEN DATA COMPONENTS ARE AVAILABLE, YOU MUST RESPOND IN JSON FORMAT ONLY
+- DO NOT respond with plain text when data components are defined
+- YOUR RESPONSE MUST BE STRUCTURED JSON WITH dataComponents ARRAY
+- THIS IS NON-NEGOTIABLE - JSON FORMAT IS REQUIRED
+
+CRITICAL JSON FORMATTING RULES - MUST FOLLOW EXACTLY:
+1. Each data component must include id, name, and props fields
+2. The id and name should match the exact component definition
+3. The props field contains the actual component data using exact property names from the schema
+4. NEVER omit the id and name fields
+
+CORRECT: [{\"id\": \"component1\", \"name\": \"Component1\", \"props\": {\"field1\": \"value1\", \"field2\": \"value2\"}}, {\"id\": \"component2\", \"name\": \"Component2\", \"props\": {\"field3\": \"value3\"}}]
+WRONG: [{\"field1\": \"value1\", \"field2\": \"value2\"}, {\"field3\": \"value3\"}]
+
+">
+  ${dataComponentsXml}
+</available_data_components>`;
+    }
+    generateDataComponentXml(templates, dataComponent) {
+        const dataComponentTemplate = templates.get('data-component');
+        if (!dataComponentTemplate) {
+            throw new Error('Data component template not loaded');
+        }
+        let dataComponentXml = dataComponentTemplate;
+        // Replace data component variables
+        dataComponentXml = dataComponentXml.replace('{{COMPONENT_NAME}}', dataComponent.name);
+        dataComponentXml = dataComponentXml.replace('{{COMPONENT_DESCRIPTION}}', dataComponent.description);
+        dataComponentXml = dataComponentXml.replace('{{COMPONENT_PROPS_SCHEMA}}', this.generateParametersXml(dataComponent.props));
+        return dataComponentXml;
+    }
+    generateParametersXml(inputSchema) {
+        if (!inputSchema) {
+            return '<type>object</type>\n      <properties>\n      </properties>\n      <required>[]</required>';
+        }
+        const schemaType = inputSchema.type || 'object';
+        const properties = inputSchema.properties || {};
+        const required = inputSchema.required || [];
+        // Convert JSON schema properties to XML representation
+        const propertiesXml = Object.entries(properties)
+            .map(([key, value]) => {
+            const isRequired = required.includes(key);
+            const propType = value?.type || 'string';
+            const propDescription = value?.description || 'No description';
+            return `        ${key}: {\n          "type": "${propType}",\n          "description": "${propDescription}",\n          "required": ${isRequired}\n        }`;
+        })
+            .join('\n');
+        return `<type>${schemaType}</type>\n      <properties>\n${propertiesXml}\n      </properties>\n      <required>${JSON.stringify(required)}</required>`;
+    }
+}

package/dist/app.d.ts

@@ -0,0 +1,4 @@
+import { OpenApiHonoWithExecutionContext } from '@inkeep/agents-core';
+declare const app: OpenApiHonoWithExecutionContext;
+export default app;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAgBtE,QAAA,MAAM,GAAG,iCAAwC,CAAC;AAuNlD,eAAe,GAAG,CAAC"}

package/dist/app.js

@@ -0,0 +1,194 @@
+import { createRoute } from '@hono/zod-openapi';
+import { OpenApiHonoWithExecutionContext } from '@inkeep/agents-core';
+import { context as otelContext, propagation } from '@opentelemetry/api';
+import { cors } from 'hono/cors';
+import { HTTPException } from 'hono/http-exception';
+import { requestId } from 'hono/request-id';
+import { pinoLogger } from 'hono-pino';
+import { handleApiError } from '@inkeep/agents-core';
+import { getLogger } from './logger.js';
+import { apiKeyAuth } from './middleware/api-key-auth.js';
+import { setupOpenAPIRoutes } from './openapi.js';
+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;
+        }
+        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());
+});
+// 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;
+        }
+        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 >= 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',
+        },
+    },
+}), (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;

package/dist/data/agentGraph.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentGraph.d.ts","sourceRoot":"","sources":["../../src/data/agentGraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA6EvE,wBAAsB,kBAAkB,CACtC,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAUjC"}

package/dist/data/agentGraph.js

@@ -0,0 +1,73 @@
+import { createTaskHandler, createTaskHandlerConfig } from '../agents/generateTaskHandler.js';
+import { getAgentById, getAgentGraph } from '@inkeep/agents-core';
+import dbClient from './db/dbClient.js';
+// Hydrate graph function
+async function hydrateGraph({ dbGraph, baseUrl, apiKey, }) {
+    try {
+        // Get the default agent for this graph to create the task handler
+        const defaultAgent = await getAgentById(dbClient)({
+            scopes: {
+                tenantId: dbGraph.tenantId,
+                projectId: dbGraph.projectId,
+            },
+            agentId: dbGraph.defaultAgentId,
+        });
+        if (!defaultAgent) {
+            throw new Error(`Default agent ${dbGraph.defaultAgentId} not found for graph ${dbGraph.id}`);
+        }
+        // Create task handler for the default agent
+        const taskHandlerConfig = await createTaskHandlerConfig({
+            tenantId: dbGraph.tenantId,
+            projectId: dbGraph.projectId,
+            graphId: dbGraph.id,
+            agentId: dbGraph.defaultAgentId,
+            baseUrl: baseUrl,
+            apiKey: apiKey,
+        });
+        const taskHandler = createTaskHandler(taskHandlerConfig);
+        // Create AgentCard for the graph (representing it as a single agent)
+        const agentCard = {
+            name: dbGraph.name,
+            description: dbGraph.description || `Agent graph: ${dbGraph.name}`,
+            url: baseUrl ? `${baseUrl}/a2a` : '',
+            version: '1.0.0',
+            capabilities: {
+                streaming: true, // Enable streaming for A2A compliance
+                pushNotifications: false,
+                stateTransitionHistory: false,
+            },
+            defaultInputModes: ['text', 'text/plain'],
+            defaultOutputModes: ['text', 'text/plain'],
+            skills: [], // TODO: Could aggregate skills from all agents in the graph
+            // Add provider info if available
+            ...(baseUrl && {
+                provider: {
+                    organization: 'Inkeep',
+                    url: baseUrl,
+                },
+            }),
+        };
+        return {
+            agentId: dbGraph.id, // Use graph ID as agent ID for A2A purposes
+            tenantId: dbGraph.tenantId,
+            projectId: dbGraph.projectId,
+            graphId: dbGraph.id,
+            agentCard,
+            taskHandler,
+        };
+    }
+    catch (error) {
+        console.error(`❌ Failed to hydrate graph ${dbGraph.id}:`, error);
+        throw error;
+    }
+}
+// A2A functions that hydrate graphs on-demand
+export async function getRegisteredGraph(executionContext) {
+    const { tenantId, projectId, graphId, baseUrl, apiKey } = executionContext;
+    const dbGraph = await getAgentGraph(dbClient)({ scopes: { tenantId, projectId }, graphId });
+    if (!dbGraph) {
+        return null;
+    }
+    const agentFrameworkBaseUrl = `${baseUrl}/agents`;
+    return hydrateGraph({ dbGraph, baseUrl: agentFrameworkBaseUrl, apiKey });
+}

package/dist/data/agents.d.ts

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

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

@@ -0,0 +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"}