@inkeep/agents-core 0.1.0

package/dist/context/ContextConfig.js

@@ -0,0 +1,302 @@
+import { z } from 'zod/v4';
+import { getLogger } from '../utils/logger.js';
+import { ContextConfigApiUpdateSchema } from '../validation/schemas.js';
+const logger = getLogger('context-config');
+// Factory function to create a comprehensive request schema
+export function createRequestSchema(schemas, config) {
+    const schemaConfig = {
+        schemas,
+        optional: config?.optional,
+    };
+    return {
+        schemas,
+        config: schemaConfig,
+        // Convert all schemas to JSON Schema for storage
+        toJsonSchema: () => {
+            const jsonSchemas = {};
+            if (schemas.body) {
+                jsonSchemas.body = convertZodToJsonSchema(schemas.body);
+            }
+            if (schemas.headers) {
+                jsonSchemas.headers = convertZodToJsonSchema(schemas.headers);
+            }
+            if (schemas.query) {
+                jsonSchemas.query = convertZodToJsonSchema(schemas.query);
+            }
+            if (schemas.params) {
+                jsonSchemas.params = convertZodToJsonSchema(schemas.params);
+            }
+            return {
+                schemas: jsonSchemas,
+                optional: schemaConfig.optional,
+            };
+        },
+        // Get the Zod schemas for runtime validation
+        getZodSchemas: () => schemas,
+        // Get the configuration including optional flags
+        getConfig: () => schemaConfig,
+    };
+}
+// Utility function for converting Zod schemas to JSON Schema
+export function convertZodToJsonSchema(zodSchema) {
+    try {
+        return z.toJSONSchema(zodSchema, { target: 'draft-7' });
+    }
+    catch (error) {
+        logger.error({
+            error: error instanceof Error ? error.message : 'Unknown error',
+        }, 'Failed to convert Zod schema to JSON Schema');
+        throw new Error('Failed to convert Zod schema to JSON Schema');
+    }
+}
+export class ContextConfigBuilder {
+    config;
+    baseURL;
+    tenantId;
+    projectId;
+    constructor(options) {
+        this.tenantId = options.tenantId || 'default';
+        this.projectId = options.projectId || 'default';
+        this.baseURL = process.env.INKEEP_MANAGEMENT_API_URL || 'http://localhost:3002';
+        // Convert request schema to JSON schema if provided
+        let requestContextSchema;
+        if (options.requestContextSchema) {
+            logger.info({
+                requestContextSchema: options.requestContextSchema,
+            }, 'Converting request schema to JSON Schema for database storage');
+            // Check if it's a createRequestSchema result or a regular Zod schema
+            if (typeof options.requestContextSchema === 'object' &&
+                'toJsonSchema' in options.requestContextSchema) {
+                // It's a createRequestSchema result
+                requestContextSchema = options.requestContextSchema.toJsonSchema();
+            }
+            else {
+                // It's a regular Zod schema
+                requestContextSchema = convertZodToJsonSchema(options.requestContextSchema);
+            }
+        }
+        this.config = {
+            id: options.id,
+            tenantId: this.tenantId,
+            projectId: this.projectId,
+            name: options.name,
+            description: options.description || '',
+            requestContextSchema,
+            contextVariables: options.contextVariables || {},
+        };
+        logger.info({
+            contextConfigId: this.config.id,
+            tenantId: this.tenantId,
+        }, 'ContextConfig builder initialized');
+    }
+    // Getter methods
+    getId() {
+        if (!this.config.id) {
+            throw new Error('Context config ID is not set');
+        }
+        return this.config.id;
+    }
+    getName() {
+        if (!this.config.name) {
+            throw new Error('Context config name is not set');
+        }
+        return this.config.name;
+    }
+    getDescription() {
+        return this.config.description || '';
+    }
+    getRequestContextSchema() {
+        return this.config.requestContextSchema || null;
+    }
+    getContextVariables() {
+        return this.config.contextVariables || {};
+    }
+    /**
+     * Convert the builder to a plain object for database operations
+     */
+    toObject() {
+        return {
+            id: this.getId(),
+            tenantId: this.tenantId,
+            projectId: this.projectId,
+            name: this.getName(),
+            description: this.getDescription(),
+            requestContextSchema: this.getRequestContextSchema(),
+            contextVariables: this.getContextVariables(),
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    // Builder methods for fluent API
+    withRequestContextSchema(schema) {
+        this.config.requestContextSchema = schema;
+        return this;
+    }
+    withContextVariable(key, definition) {
+        this.config.contextVariables = this.config.contextVariables || {};
+        this.config.contextVariables[key] = definition;
+        return this;
+    }
+    withContextVariables(variables) {
+        this.config.contextVariables = variables;
+        return this;
+    }
+    // Validation method
+    validate() {
+        try {
+            // Validate 'requestContext' key is not used in contextVariables
+            const contextVariables = this.config.contextVariables || {};
+            if ('requestContext' in contextVariables) {
+                return {
+                    valid: false,
+                    errors: [
+                        "The key 'requestContext' is reserved for the request context and cannot be used in contextVariables",
+                    ],
+                };
+            }
+            ContextConfigApiUpdateSchema.parse({
+                id: this.config.id,
+                name: this.config.name,
+                description: this.config.description,
+                requestContextSchema: this.config.requestContextSchema,
+                contextVariables: this.config.contextVariables,
+            });
+            return { valid: true, errors: [] };
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                return {
+                    valid: false,
+                    errors: error.issues.map((e) => `${e.path.join('.')}: ${e.message}`),
+                };
+            }
+            return { valid: false, errors: ['Unknown validation error'] };
+        }
+    }
+    // Initialize and save to database
+    async init() {
+        // Validate the configuration
+        const validation = this.validate();
+        if (!validation.valid) {
+            throw new Error(`Context config validation failed: ${validation.errors.join(', ')}`);
+        }
+        try {
+            await this.upsertContextConfig();
+            logger.info({
+                contextConfigId: this.getId(),
+            }, 'Context config initialized successfully');
+        }
+        catch (error) {
+            logger.error({
+                contextConfigId: this.getId(),
+                error: error instanceof Error ? error.message : 'Unknown error',
+            }, 'Failed to initialize context config');
+            throw error;
+        }
+    }
+    // Private method to upsert context config
+    async upsertContextConfig() {
+        const configData = {
+            id: this.getId(),
+            name: this.getName(),
+            description: this.getDescription(),
+            requestContextSchema: this.getRequestContextSchema(),
+            contextVariables: this.getContextVariables(),
+        };
+        try {
+            // First try to update (in case config exists)
+            const updateResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/context-configs/${this.getId()}`, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(configData),
+            });
+            if (updateResponse.ok) {
+                logger.info({
+                    contextConfigId: this.getId(),
+                }, 'Context config updated successfully');
+                return;
+            }
+            // If update failed with 404, config doesn't exist - create it
+            if (updateResponse.status === 404) {
+                logger.info({
+                    contextConfigId: this.getId(),
+                }, 'Context config not found, creating new config');
+                const createResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/context-configs`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(configData),
+                });
+                if (!createResponse.ok) {
+                    const errorData = await this.parseErrorResponse(createResponse);
+                    throw new Error(`Failed to create context config (${createResponse.status}): ${errorData.message || errorData.error || 'Unknown error'}`);
+                }
+                logger.info({
+                    contextConfigId: this.getId(),
+                }, 'Context config created successfully');
+                return;
+            }
+            // Update failed for some other reason
+            const errorData = await this.parseErrorResponse(updateResponse);
+            throw new Error(`Failed to update context config (${updateResponse.status}): ${errorData.message || errorData.error || 'Unknown error'}`);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error(`Network error while upserting context config: ${String(error)}`);
+        }
+    }
+    // Helper method to parse error responses
+    async parseErrorResponse(response) {
+        try {
+            const contentType = response.headers?.get('content-type');
+            if (contentType?.includes('application/json')) {
+                return await response.json();
+            }
+            const text = await response.text();
+            return { error: text || `HTTP ${response.status} ${response.statusText}` };
+        }
+        catch (error) {
+            return { error: `HTTP ${response.status} ${response.statusText}` };
+        }
+    }
+}
+// Factory function for creating context configs - similar to agent() and agentGraph()
+export function contextConfig(options) {
+    return new ContextConfigBuilder(options);
+}
+// Helper function to create fetch definitions
+export function fetchDefinition(options) {
+    // Handle both the correct FetchDefinition format and the legacy direct format
+    const fetchConfig = options.fetchConfig || {
+        url: options.url,
+        method: options.method,
+        headers: options.headers,
+        body: options.body,
+        transform: options.transform,
+        timeout: options.timeout,
+    };
+    return {
+        id: options.id,
+        name: options.name,
+        trigger: options.trigger,
+        fetchConfig: {
+            url: fetchConfig.url,
+            method: fetchConfig.method,
+            headers: fetchConfig.headers,
+            body: fetchConfig.body,
+            transform: fetchConfig.transform,
+            timeout: fetchConfig.timeout,
+        },
+        responseSchema: options.responseSchema
+            ? convertZodToJsonSchema(options.responseSchema)
+            : undefined,
+        defaultValue: options.defaultValue,
+        credentialReferenceId: options.credential?.id,
+    };
+}
+//# sourceMappingURL=ContextConfig.js.map

package/dist/context/ContextConfig.js.map

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

package/dist/context/ContextFetcher.d.ts

@@ -0,0 +1,64 @@
+import type { BaseServer } from '../server/BaseServer.js';
+import type { ContextFetchDefinition } from '../types/utility.js';
+import { type TemplateContext } from './TemplateEngine.js';
+import type { DatabaseClient } from '../db/client.js';
+export interface FetchResult {
+    data: unknown;
+    source: string;
+    durationMs: number;
+}
+export declare class ContextFetcher {
+    private tenantId;
+    private projectId;
+    private defaultTimeout;
+    private agentFramework?;
+    private credentialStuffer?;
+    private dbClient;
+    constructor(tenantId: string, projectId: string, dbClient: DatabaseClient, agentFramework?: BaseServer, defaultTimeout?: number);
+    /**
+     * Fetch data according to a fetch definition
+     */
+    fetch(definition: ContextFetchDefinition, context: TemplateContext): Promise<unknown>;
+    private getCredential;
+    /**
+     * Resolve template variables in fetch configuration and inject credential headers
+     */
+    private resolveTemplateVariables;
+    /**
+     * Interpolate template variables in a string using TemplateEngine
+     */
+    private interpolateTemplate;
+    /**
+     * Interpolate template variables in an object recursively using TemplateEngine
+     */
+    private interpolateObjectTemplates;
+    /**
+     * Perform HTTP request
+     */
+    private performRequest;
+    /**
+     * Transform response data using JMESPath
+     */
+    private transformResponse;
+    /**
+     * Validate response against JSON Schema
+     */
+    private validateResponseWithJsonSchema;
+    /**
+     * Test a fetch definition without caching
+     */
+    test(definition: ContextFetchDefinition, context: TemplateContext): Promise<{
+        success: boolean;
+        data?: unknown;
+        error?: string;
+        durationMs: number;
+    }>;
+    /**
+     * Get fetcher statistics
+     */
+    getStats(): {
+        tenantId: string;
+        defaultTimeout: number;
+    };
+}
+//# sourceMappingURL=ContextFetcher.d.ts.map

package/dist/context/ContextFetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextFetcher.d.ts","sourceRoot":"","sources":["../../src/context/ContextFetcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AA4BtD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAa;IACpC,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAiB;gBAG/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,EACxB,cAAc,CAAC,EAAE,UAAU,EAC3B,cAAc,SAAQ;IAqBxB;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;YAmE7E,aAAa;IAwC3B;;OAEG;YACW,wBAAwB;IA0DtC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAmBlC;;OAEG;YACW,cAAc;IAiE5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAmCtC;;OAEG;IACG,IAAI,CACR,UAAU,EAAE,sBAAsB,EAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAmBF;;OAEG;IACH,QAAQ,IAAI;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB;CAMF"}