@inkeep/agents-core 0.1.0

package/dist/middleware/contextValidation.js

@@ -0,0 +1,469 @@
+import Ajv from 'ajv';
+import { ContextResolver } from '../context/ContextResolver.js';
+import { getAgentGraphWithDefaultAgent } from '../data-access/agentGraphs.js';
+import { getContextConfigById } from '../data-access/contextConfigs.js';
+import { getLogger } from '../utils/logger.js';
+import { getRequestExecutionContext } from '../utils/execution.js';
+const logger = getLogger('context-validation');
+const ajv = new Ajv({ allErrors: true, strict: false });
+// Constants for HTTP request parts
+export const HTTP_REQUEST_PARTS = ['body', 'headers', 'query', 'params'];
+// Schema compilation cache for performance
+const schemaCache = new Map();
+// Type guard for validating HTTP request objects
+export function isValidHttpRequest(obj) {
+    return (obj != null &&
+        typeof obj === 'object' &&
+        !Array.isArray(obj) &&
+        HTTP_REQUEST_PARTS.some((key) => key in obj));
+}
+// Cached schema compilation for performance
+export function getCachedValidator(schema) {
+    const key = JSON.stringify(schema);
+    if (!schemaCache.has(key)) {
+        schemaCache.set(key, ajv.compile(schema));
+    }
+    const validator = schemaCache.get(key);
+    if (!validator) {
+        throw new Error('Failed to compile JSON schema');
+    }
+    return validator;
+}
+// Validation wrapper for testing purposes (now uses cache)
+export function validationHelper(jsonSchema) {
+    return getCachedValidator(jsonSchema);
+}
+export function validateAgainstJsonSchema(jsonSchema, context) {
+    logger.debug({ jsonSchema, context }, 'Validating context against JSON Schema');
+    const validate = validationHelper(jsonSchema);
+    return validate(context);
+}
+/**
+ * Recursively filters data based on JSON schema properties
+ */
+function filterByJsonSchema(data, schema) {
+    if (!schema || data === null || data === undefined) {
+        return data;
+    }
+    // Handle object schemas
+    if (schema.type === 'object' &&
+        schema.properties &&
+        typeof data === 'object' &&
+        !Array.isArray(data)) {
+        const filtered = {};
+        for (const [key, propSchema] of Object.entries(schema.properties)) {
+            if (key in data) {
+                // Recursively filter nested objects
+                filtered[key] = filterByJsonSchema(data[key], propSchema);
+            }
+        }
+        return filtered;
+    }
+    // Handle array schemas
+    if (schema.type === 'array' && schema.items && Array.isArray(data)) {
+        return data.map((item) => filterByJsonSchema(item, schema.items));
+    }
+    // Handle anyOf/oneOf schemas (take the first that might match)
+    if (schema.anyOf && Array.isArray(schema.anyOf)) {
+        // For anyOf, try to find the best matching schema
+        for (const subSchema of schema.anyOf) {
+            if (subSchema.type && typeof data === subSchema.type) {
+                return filterByJsonSchema(data, subSchema);
+            }
+        }
+        // If no specific type match, use the first schema
+        return filterByJsonSchema(data, schema.anyOf[0]);
+    }
+    // For primitive types or schemas without properties, return as-is
+    return data;
+}
+/**
+ * Filters validated context to only include keys defined in the schema
+ * This prevents storing extra keys from .passthrough() schemas in the cache
+ * Now supports recursive filtering of nested objects
+ */
+function filterContextToSchemaKeys(validatedContext, schemas) {
+    const filteredContext = {};
+    for (const part of HTTP_REQUEST_PARTS) {
+        if (validatedContext[part] && schemas[part]) {
+            const schema = schemas[part];
+            const partData = validatedContext[part];
+            // Use recursive filtering
+            const filteredPart = filterByJsonSchema(partData, schema);
+            if (filteredPart !== null && filteredPart !== undefined) {
+                // Only include if the filtered result has content
+                if (typeof filteredPart === 'object' && Object.keys(filteredPart).length > 0) {
+                    filteredContext[part] = filteredPart;
+                }
+                else if (typeof filteredPart !== 'object') {
+                    filteredContext[part] = filteredPart;
+                }
+            }
+        }
+        else if (validatedContext[part]) {
+            // Part exists but no schema - still include for compatibility
+            filteredContext[part] = validatedContext[part];
+        }
+    }
+    return filteredContext;
+}
+/**
+ * Filters legacy context to only include keys defined in the JSON schema
+ * Now supports recursive filtering of nested objects
+ */
+function filterLegacyContextToSchemaKeys(validatedContext, jsonSchema) {
+    return filterByJsonSchema(validatedContext, jsonSchema);
+}
+/**
+ * Checks if the schema is in the new comprehensive request format
+ */
+export function isComprehensiveRequestSchema(schema) {
+    return (schema &&
+        typeof schema === 'object' &&
+        'schemas' in schema &&
+        typeof schema.schemas === 'object');
+}
+/**
+ * Validates HTTP request parts against comprehensive schema
+ */
+export async function validateHttpRequestParts(comprehensiveSchema, httpRequest) {
+    const errors = [];
+    const validatedParts = {};
+    // Type guard validation
+    if (!isValidHttpRequest(httpRequest)) {
+        return {
+            valid: false,
+            errors: [
+                {
+                    field: 'httpRequest',
+                    message: 'Invalid HTTP request format - must contain at least one of: body, headers, query, params',
+                },
+            ],
+        };
+    }
+    try {
+        const { schemas, optional = [] } = comprehensiveSchema;
+        // Validate each part if schema is defined
+        for (const part of HTTP_REQUEST_PARTS) {
+            if (schemas[part] && httpRequest[part] !== undefined) {
+                try {
+                    const partSchema = schemas[part];
+                    const validate = validationHelper(partSchema);
+                    const isValid = validate(httpRequest[part]);
+                    if (isValid) {
+                        validatedParts[part] = httpRequest[part];
+                    }
+                    else {
+                        // Convert AJV errors for this part
+                        if (validate.errors) {
+                            for (const error of validate.errors) {
+                                errors.push({
+                                    field: `${part}.${error.instancePath || 'root'}`,
+                                    message: `${part} ${error.message}`,
+                                    value: error.data,
+                                });
+                            }
+                        }
+                    }
+                }
+                catch (validationError) {
+                    errors.push({
+                        field: part,
+                        message: `Failed to validate ${part}: ${validationError instanceof Error ? validationError.message : 'Unknown error'}`,
+                    });
+                }
+            }
+            else if (schemas[part] && httpRequest[part] === undefined) {
+                // Check if this schema part is marked as optional
+                const isPartOptional = optional.includes(part);
+                if (!isPartOptional) {
+                    // Part is required but missing
+                    errors.push({
+                        field: part,
+                        message: `Required ${part} is missing`,
+                    });
+                }
+                // If optional, we simply skip it (no error, no validation)
+            }
+        }
+        const filteredContext = errors.length === 0 ? filterContextToSchemaKeys(validatedParts, schemas) : undefined;
+        return {
+            valid: errors.length === 0,
+            errors,
+            validatedContext: filteredContext,
+        };
+    }
+    catch (error) {
+        logger.error({ error: error instanceof Error ? error.message : 'Unknown error' }, 'Failed to validate comprehensive request schema');
+        return {
+            valid: false,
+            errors: [
+                {
+                    field: 'schema',
+                    message: 'Failed to validate comprehensive request schema',
+                },
+            ],
+        };
+    }
+}
+/**
+ * Fetches the request context from the context cache if it exists
+ */
+async function fetchExistingRequestContext({ tenantId, projectId, contextConfig, conversationId, dbClient, }) {
+    //If no request context is provided, but this is a continued conversation first try to get the request context from the context cache
+    const contextResolver = new ContextResolver(tenantId, projectId, dbClient);
+    const requestContext = await contextResolver.resolveRequestContext(conversationId, contextConfig.id);
+    if (Object.keys(requestContext).length > 0) {
+        return {
+            valid: true,
+            errors: [],
+            validatedContext: requestContext,
+        };
+    }
+    throw new Error('No request context found in cache. Please provide requestContext in request body.');
+}
+/**
+ * Validates request context against the JSON Schema stored in context configuration
+ * Supports both legacy simple schemas and new comprehensive HTTP request schemas
+ */
+export async function validateRequestContext(tenantId, projectId, graphId, conversationId, parsedRequest, dbClient, legacyRequestContext // legacy request context if it was included in the request body
+) {
+    try {
+        // Get the graph's context config
+        const agentGraph = await getAgentGraphWithDefaultAgent(dbClient)({
+            scopes: { tenantId, projectId },
+            graphId,
+        });
+        if (!agentGraph?.contextConfigId) {
+            // No context config means no validation needed
+            logger.debug({ graphId }, 'No context config found for graph, skipping validation');
+            return {
+                valid: true,
+                errors: [],
+                validatedContext: parsedRequest,
+            };
+        }
+        // Get context configuration
+        const contextConfig = await getContextConfigById(dbClient)({
+            scopes: { tenantId, projectId },
+            id: agentGraph.contextConfigId,
+        });
+        if (!contextConfig) {
+            logger.warn({ contextConfigId: agentGraph.contextConfigId }, 'Context config not found');
+            return {
+                valid: false,
+                errors: [
+                    {
+                        field: 'contextConfig',
+                        message: 'Context configuration not found',
+                    },
+                ],
+            };
+        }
+        // If no request context schema is defined, any context is valid
+        if (!contextConfig.requestContextSchema) {
+            logger.debug({ contextConfigId: contextConfig.id }, 'No request context schema defined, accepting any context');
+            return {
+                valid: true,
+                errors: [],
+                validatedContext: parsedRequest,
+            };
+        }
+        // Validate against the schema - handle both legacy and new formats
+        try {
+            const schema = contextConfig.requestContextSchema;
+            // Check if it's the new comprehensive request schema format
+            if (isComprehensiveRequestSchema(schema)) {
+                logger.debug({ contextConfigId: contextConfig.id }, 'Using comprehensive HTTP request schema validation');
+                // For comprehensive schema, expect the requestContext to have HTTP parts
+                const httpRequest = parsedRequest;
+                const validationResult = await validateHttpRequestParts(schema, httpRequest);
+                if (validationResult.valid) {
+                    return validationResult;
+                }
+                //If the request context is not valid, try to fetch it from the context cache
+                try {
+                    return await fetchExistingRequestContext({
+                        tenantId,
+                        projectId,
+                        contextConfig,
+                        conversationId,
+                        dbClient,
+                    });
+                }
+                catch (_error) {
+                    validationResult.errors.push({
+                        field: 'requestContext',
+                        message: 'Failed to fetch request context from cache',
+                    });
+                    return validationResult;
+                }
+            }
+            else {
+                // Legacy validation - treat as simple JSON Schema
+                logger.debug({ contextConfigId: contextConfig.id }, 'Using legacy JSON schema validation');
+                const jsonSchema = schema;
+                const validate = validationHelper(jsonSchema);
+                // Validate the request context
+                const isValid = validate(legacyRequestContext);
+                if (isValid) {
+                    logger.debug({
+                        contextConfigId: contextConfig.id,
+                        requestContextKeys: Object.keys(legacyRequestContext),
+                    }, 'Request context validation successful');
+                    const filteredContext = filterLegacyContextToSchemaKeys(legacyRequestContext, jsonSchema);
+                    return {
+                        valid: true,
+                        errors: [],
+                        validatedContext: filteredContext,
+                    };
+                }
+                // Convert AJV errors to our format
+                const errors = [];
+                if (validate.errors) {
+                    for (const error of validate.errors) {
+                        errors.push({
+                            field: error.instancePath || error.schemaPath || 'root',
+                            message: `${error.instancePath || 'root'} ${error.message}`,
+                            value: error.data,
+                        });
+                    }
+                }
+                logger.warn({
+                    contextConfigId: contextConfig.id,
+                    legacyRequestContext,
+                    errors,
+                }, 'Legacy request context validation failed, trying cache fallback');
+                // Try to fetch from cache as fallback, same as comprehensive schemas
+                try {
+                    return await fetchExistingRequestContext({
+                        tenantId,
+                        projectId,
+                        contextConfig,
+                        conversationId,
+                        dbClient,
+                    });
+                }
+                catch (error) {
+                    // Cache fallback failed, return original validation errors
+                    errors.push({
+                        field: 'requestContext',
+                        message: 'Failed to fetch request context from cache',
+                    });
+                    return {
+                        valid: false,
+                        errors,
+                    };
+                }
+            }
+        }
+        catch (error) {
+            logger.error({
+                contextConfigId: contextConfig.id,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            }, 'Failed to compile or validate schema');
+            return {
+                valid: false,
+                errors: [
+                    {
+                        field: 'schema',
+                        message: 'Invalid schema definition or validation error',
+                    },
+                ],
+            };
+        }
+    }
+    catch (error) {
+        logger.error({
+            tenantId,
+            graphId,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        }, 'Failed to validate request context');
+        return {
+            valid: false,
+            errors: [
+                {
+                    field: 'validation',
+                    message: 'Context validation failed due to internal error',
+                },
+            ],
+        };
+    }
+}
+/**
+ * Hono middleware for context validation
+ */
+export function contextValidationMiddleware(dbClient) {
+    return async (c, next) => {
+        try {
+            const executionContext = getRequestExecutionContext(c);
+            let { tenantId, projectId, graphId } = executionContext;
+            if (!tenantId || !projectId || !graphId) {
+                // Fallback to path parameters for to handle management api routes
+                tenantId = c.req.param('tenantId');
+                projectId = c.req.param('projectId');
+                graphId = c.req.param('graphId');
+            }
+            if (!tenantId || !projectId || !graphId) {
+                return next(); // Let the main handler deal with missing params
+            }
+            const body = await c.req.json();
+            const conversationId = body.conversationId || '';
+            // Extract HTTP parts from the request for comprehensive validation
+            let url;
+            try {
+                url = new URL(c.req.url);
+            }
+            catch (error) {
+                logger.warn({ error: error instanceof Error ? error.message : 'Unknown error' }, `Invalid URL: ${c.req.url}`);
+                return c.json({ error: 'Invalid request URL' }, 400);
+            }
+            const query = {};
+            for (const [key, value] of url.searchParams) {
+                query[key] = value;
+            }
+            // Get headers
+            const headers = {};
+            c.req.raw.headers.forEach((value, key) => {
+                headers[key.toLowerCase()] = value;
+            });
+            const parsedRequest = {
+                body: body || {},
+                headers,
+                query,
+                params: c.req.param() || {},
+            };
+            // Validate the context
+            const validationResult = await validateRequestContext(tenantId, projectId, graphId, conversationId, parsedRequest, dbClient, body.requestContext);
+            if (!validationResult.valid) {
+                logger.warn({
+                    tenantId,
+                    graphId,
+                    errors: validationResult.errors,
+                }, 'Request context validation failed');
+                return c.json({
+                    error: 'Invalid request context',
+                    details: validationResult.errors,
+                }, 400);
+            }
+            // Store validated context for use in the main handler
+            c.set('validatedContext', validationResult.validatedContext);
+            logger.debug({
+                tenantId,
+                graphId,
+                contextKeys: Object.keys(validationResult.validatedContext || {}),
+            }, 'Request context validation successful');
+            return next();
+        }
+        catch (error) {
+            logger.error({
+                error: error instanceof Error ? error.message : 'Unknown error',
+            }, 'Context validation middleware error');
+            return c.json({
+                error: 'Context validation failed',
+                message: 'Internal validation error',
+            }, 500);
+        }
+    };
+}
+//# sourceMappingURL=contextValidation.js.map

package/dist/middleware/contextValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextValidation.js","sourceRoot":"","sources":["../../src/middleware/contextValidation.ts"],"names":[],"mappings":"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"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,2 @@
+export * from './contextValidation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,2 @@
+export * from './contextValidation.js';
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/server/BaseServer.d.ts

@@ -0,0 +1,83 @@
+import type { Server as HttpServer } from 'node:http';
+import type { Http2Server } from 'node:http2';
+import { OpenAPIHono } from '@hono/zod-openapi';
+import type { CredentialStore, AgentFrameworkServerConfig, ServerOptions } from '../types/server.js';
+import type { ExecutionContext } from '../types/utility.js';
+/**
+ * OpenAPIHono instance pre-configured with ExecutionContext variables
+ * Usage: const app = new OpenApiHonoScoped()
+ */
+export declare class OpenApiHonoWithExecutionContext extends OpenAPIHono<{
+    Variables: {
+        executionContext: ExecutionContext;
+    };
+}> {
+    constructor();
+}
+/**
+ * Base server class providing common functionality for all Inkeep services
+ * Handles credential stores, server lifecycle, graceful shutdown, and error handling
+ */
+export declare abstract class BaseServer {
+    protected config: AgentFrameworkServerConfig;
+    protected app: OpenApiHonoWithExecutionContext | null;
+    protected credentialStores: Map<string, CredentialStore>;
+    protected server: HttpServer | Http2Server | null;
+    protected isShuttingDown: boolean;
+    protected logger: any;
+    constructor(config: AgentFrameworkServerConfig | undefined, logger: any);
+    /**
+     * Get a credential store by ID
+     */
+    getCredentialStore(id: string): CredentialStore | undefined;
+    /**
+     * Add a credential store
+     */
+    addCredentialStore(store: CredentialStore): void;
+    /**
+     * Get all credential stores
+     */
+    getCredentialStores(): CredentialStore[];
+    /**
+     * Abstract method to initialize the application
+     * Each service implements this to load their specific app
+     */
+    protected abstract initialize(): Promise<void>;
+    /**
+     * Get default server options - can be overridden by subclasses
+     */
+    protected getServerOptions(): ServerOptions;
+    /**
+     * Start the server
+     */
+    serve(): Promise<void>;
+    /**
+     * Setup graceful shutdown handlers for various signals
+     */
+    protected setupGracefulShutdown(): void;
+    /**
+     * Perform graceful shutdown - can be overridden by subclasses for custom cleanup
+     */
+    protected gracefulShutdown(): Promise<void>;
+    /**
+     * Hook for subclasses to perform cleanup before shutdown
+     */
+    protected beforeShutdown(): Promise<void>;
+    /**
+     * Stop the server gracefully
+     */
+    stop(): Promise<void>;
+    /**
+     * Get the Hono app instance (for testing or advanced usage)
+     */
+    getApp(): OpenApiHonoWithExecutionContext | null;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): AgentFrameworkServerConfig;
+    /**
+     * Check if the server is currently shutting down
+     */
+    isShuttingDownStatus(): boolean;
+}
+//# sourceMappingURL=BaseServer.d.ts.map

package/dist/server/BaseServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseServer.d.ts","sourceRoot":"","sources":["../../src/server/BaseServer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,eAAe,EACf,0BAA0B,EAC1B,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;GAGG;AACH,qBAAa,+BAAgC,SAAQ,WAAW,CAAC;IAC/D,SAAS,EAAE;QACT,gBAAgB,EAAE,gBAAgB,CAAC;KACpC,CAAC;CACH,CAAC;;CAID;AAID;;;GAGG;AACH,8BAAsB,UAAU;IAC9B,SAAS,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC7C,SAAS,CAAC,GAAG,EAAE,+BAA+B,GAAG,IAAI,CAAQ;IAC7D,SAAS,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAa;IACrE,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAAQ;IACzD,SAAS,CAAC,cAAc,UAAS;IACjC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC;gBAEV,MAAM,EAAE,0BAA0B,YAAK,EAAE,MAAM,EAAE,GAAG;IAYhE;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI3D;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAIhD;;OAEG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAIxC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9C;;OAEG;IACH,SAAS,CAAC,gBAAgB,IAAI,aAAa;IAU3C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B;;OAEG;IACH,SAAS,CAAC,qBAAqB,IAAI,IAAI;IA2BvC;;OAEG;cACa,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BjD;;OAEG;cACa,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0D3B;;OAEG;IACH,MAAM,IAAI,+BAA+B,GAAG,IAAI;IAIhD;;OAEG;IACH,SAAS,IAAI,0BAA0B;IAIvC;;OAEG;IACH,oBAAoB,IAAI,OAAO;CAGhC"}