@inkeep/agents-core 0.1.0

package/dist/context/ContextResolver.js

@@ -0,0 +1,298 @@
+import crypto from 'node:crypto';
+import { SpanStatusCode } from '@opentelemetry/api';
+import { ContextCache } from './contextCache.js';
+import { createSpanName, getGlobalTracer, handleSpanError, getLogger } from '../utils/index.js';
+import { ContextFetcher } from './ContextFetcher.js';
+const logger = getLogger('context-resolver');
+// Get tracer using centralized utility
+const tracer = getGlobalTracer();
+export class ContextResolver {
+    fetcher;
+    cache;
+    tenantId;
+    projectId;
+    constructor(tenantId, projectId, dbClient, agentFramework) {
+        this.tenantId = tenantId;
+        this.projectId = projectId;
+        this.fetcher = new ContextFetcher(tenantId, projectId, dbClient, agentFramework);
+        this.cache = new ContextCache(tenantId, projectId, dbClient);
+        logger.info({
+            tenantId: this.tenantId,
+            hasCredentialSupport: !!agentFramework,
+        }, 'ContextResolver initialized');
+    }
+    /**
+     * Resolve all contexts for a given configuration and trigger event
+     */
+    async resolve(contextConfig, options) {
+        const startTime = Date.now();
+        logger.info({
+            contextConfigId: contextConfig.id,
+            triggerEvent: options.triggerEvent,
+            conversationId: options.conversationId,
+        }, 'Starting context resolution');
+        // Create parent span for the entire context resolution process
+        return tracer.startActiveSpan(createSpanName('context.resolve'), {
+            attributes: {
+                'context.config_id': contextConfig.id,
+                'context.trigger_event': options.triggerEvent,
+            },
+        }, async (parentSpan) => {
+            try {
+                const result = {
+                    resolvedContext: {},
+                    requestContext: options.requestContext || {},
+                    fetchedDefinitions: [],
+                    cacheHits: [],
+                    cacheMisses: [],
+                    errors: [],
+                    totalDurationMs: 0,
+                };
+                // Include request context in resolved context under the key 'requestContext'
+                result.resolvedContext.requestContext = result.requestContext;
+                const currentRequestContext = await this.cache.get({
+                    conversationId: options.conversationId,
+                    contextConfigId: contextConfig.id,
+                    contextVariableKey: 'requestContext',
+                });
+                if (options.requestContext && Object.keys(options.requestContext).length > 0) {
+                    // Invalidate the current request context
+                    await this.cache.invalidateRequestContext(this.tenantId, this.projectId, options.conversationId, contextConfig.id);
+                    logger.info({
+                        conversationId: options.conversationId,
+                        contextConfigId: contextConfig.id,
+                    }, 'Invalidated request context in cache');
+                    // Push the new request context to the cache
+                    await this.cache.set({
+                        contextConfigId: contextConfig.id,
+                        contextVariableKey: 'requestContext',
+                        conversationId: options.conversationId,
+                        value: options.requestContext,
+                        tenantId: this.tenantId,
+                    });
+                    logger.info({
+                        conversationId: options.conversationId,
+                        contextConfigId: contextConfig.id,
+                    }, 'Request context set in cache');
+                }
+                else if (currentRequestContext) {
+                    result.requestContext = currentRequestContext.value;
+                }
+                else {
+                    result.requestContext = {};
+                }
+                result.resolvedContext.requestContext = result.requestContext;
+                // Get all context variables - we'll handle trigger events through cache invalidation
+                const contextVariables = contextConfig.contextVariables || {};
+                const contextVariableEntries = Object.entries(contextVariables);
+                if (contextVariableEntries.length === 0) {
+                    logger.info({
+                        contextConfigId: contextConfig.id,
+                    }, 'No context variables in context config');
+                    result.totalDurationMs = Date.now() - startTime;
+                    parentSpan.setStatus({ code: SpanStatusCode.OK });
+                    return result;
+                }
+                // Separate definitions by trigger type for cache invalidation logic
+                const initializationDefs = contextVariableEntries.filter(([, def]) => def.trigger === 'initialization');
+                const invocationDefs = contextVariableEntries.filter(([, def]) => def.trigger === 'invocation');
+                // For invocation trigger, invalidate invocation definition cache entries first
+                if (options.triggerEvent === 'invocation' && invocationDefs.length > 0) {
+                    await this.cache.invalidateInvocationDefinitions(this.tenantId, this.projectId, options.conversationId, contextConfig.id, invocationDefs.map(([, def]) => def.id));
+                }
+                // Create request hash for cache invalidation
+                const requestHash = this.createRequestHash(result.requestContext);
+                // Execute all context variables in parallel (no dependencies)
+                const fetchPromises = contextVariableEntries.map(([templateKey, definition]) => this.resolveSingleFetchDefinition(contextConfig, definition, templateKey, options, requestHash, result).catch((error) => {
+                    // Handle individual fetch failures without stopping others
+                    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                    logger.error({
+                        contextConfigId: contextConfig.id,
+                        definitionId: definition.id,
+                        templateKey,
+                        error: errorMessage,
+                    }, 'Failed to resolve context variable');
+                    result.errors.push({
+                        definitionId: definition.id,
+                        error: errorMessage,
+                    });
+                    // Use default value if available
+                    if (definition.defaultValue !== undefined) {
+                        result.resolvedContext[templateKey] = definition.defaultValue;
+                        logger.info({
+                            contextConfigId: contextConfig.id,
+                            definitionId: definition.id,
+                            templateKey,
+                        }, 'Using default value for failed context variable');
+                    }
+                }));
+                // Wait for all fetches to complete
+                await Promise.all(fetchPromises);
+                result.totalDurationMs = Date.now() - startTime;
+                parentSpan.addEvent('context.resolution.completed', {
+                    resolved_keys: Object.keys(result.resolvedContext),
+                    fetched_definitions: result.fetchedDefinitions,
+                });
+                // Check if there were any errors during context resolution
+                if (result.errors.length > 0) {
+                    parentSpan.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: `Context resolution completed with errors`,
+                    });
+                }
+                else {
+                    // Mark span as successful if no errors
+                    parentSpan.setStatus({ code: SpanStatusCode.OK });
+                }
+                logger.info({
+                    contextConfigId: contextConfig.id,
+                    resolvedKeys: Object.keys(result.resolvedContext),
+                    fetchedDefinitions: result.fetchedDefinitions.length,
+                    cacheHits: result.cacheHits.length,
+                    cacheMisses: result.cacheMisses.length,
+                    errors: result.errors.length,
+                    totalDurationMs: result.totalDurationMs,
+                }, 'Context resolution completed');
+                return result;
+            }
+            catch (error) {
+                const durationMs = Date.now() - startTime;
+                // Use helper function for consistent error handling
+                handleSpanError(parentSpan, error);
+                logger.error({
+                    contextConfigId: contextConfig.id,
+                    error: error instanceof Error ? error.message : String(error),
+                    durationMs,
+                }, 'Context resolution failed');
+                throw error;
+            }
+            finally {
+                parentSpan.end();
+            }
+        });
+    }
+    /**
+     * Resolve a single context variable
+     */
+    async resolveSingleFetchDefinition(contextConfig, definition, templateKey, options, requestHash, result) {
+        // Create parent span for individual context variable resolution
+        return tracer.startActiveSpan(createSpanName('context-resolver.resolve_single_fetch_definition'), {
+            attributes: {
+                'context.definition_id': definition.id,
+                'context.template_key': templateKey,
+                'context.url': definition.fetchConfig.url,
+                'context.method': definition.fetchConfig.method,
+                'context.trigger': definition.trigger,
+            },
+        }, async (parentSpan) => {
+            try {
+                // Check cache first
+                const cachedEntry = await this.cache.get({
+                    conversationId: options.conversationId,
+                    contextConfigId: contextConfig.id,
+                    contextVariableKey: templateKey,
+                    requestHash,
+                });
+                if (cachedEntry) {
+                    result.resolvedContext[templateKey] = cachedEntry.value;
+                    result.cacheHits.push(definition.id);
+                    // Mark span as successful (cache hit)
+                    parentSpan.setStatus({ code: SpanStatusCode.OK });
+                    parentSpan.addEvent('context.cache_hit', {
+                        definition_id: definition.id,
+                        template_key: templateKey,
+                    });
+                    logger.debug({
+                        definitionId: definition.id,
+                        templateKey,
+                        conversationId: options.conversationId,
+                    }, 'Cache hit for context variable');
+                    return;
+                }
+                // Cache miss - fetch the data
+                result.cacheMisses.push(definition.id);
+                parentSpan.addEvent('context.cache_miss', {
+                    definition_id: definition.id,
+                    template_key: templateKey,
+                });
+                logger.debug({
+                    definitionId: definition.id,
+                    templateKey,
+                    conversationId: options.conversationId,
+                }, 'Cache miss for context variable, fetching data');
+                // Fetch the data with conversationId in the fetch config
+                const definitionWithConversationId = {
+                    ...definition,
+                    fetchConfig: {
+                        ...definition.fetchConfig,
+                        conversationId: options.conversationId,
+                    },
+                };
+                const fetchedData = await this.fetcher.fetch(definitionWithConversationId, result.resolvedContext);
+                // Store in resolved context
+                result.resolvedContext[templateKey] = fetchedData;
+                result.fetchedDefinitions.push(definition.id);
+                // Cache the result (unified cache)
+                await this.cache.set({
+                    contextConfigId: contextConfig.id,
+                    contextVariableKey: templateKey,
+                    conversationId: options.conversationId,
+                    value: fetchedData,
+                    requestHash,
+                    tenantId: this.tenantId,
+                });
+                // Mark span as successful
+                parentSpan.setStatus({ code: SpanStatusCode.OK });
+                parentSpan.addEvent('context.fetch_success', {
+                    definition_id: definition.id,
+                    template_key: templateKey,
+                    source: definition.fetchConfig.url,
+                });
+                logger.debug({
+                    definitionId: definition.id,
+                    templateKey,
+                    conversationId: options.conversationId,
+                }, 'Context variable resolved and cached');
+            }
+            catch (error) {
+                // Use helper function for consistent error handling
+                handleSpanError(parentSpan, error);
+                throw error;
+            }
+            finally {
+                parentSpan.end();
+            }
+        });
+    }
+    /**
+     * Resolve the request context for a given conversation
+     */
+    async resolveRequestContext(conversationId, contextConfigId) {
+        const cachedEntry = await this.cache.get({
+            conversationId: conversationId,
+            contextConfigId: contextConfigId,
+            contextVariableKey: 'requestContext',
+        });
+        if (cachedEntry) {
+            return cachedEntry.value;
+        }
+        return {};
+    }
+    /**
+     * Create a hash of the request context for cache invalidation
+     */
+    createRequestHash(requestContext) {
+        const contextString = JSON.stringify(requestContext, Object.keys(requestContext).sort());
+        return crypto.createHash('sha256').update(contextString).digest('hex').substring(0, 16);
+    }
+    /**
+     * Clear cache
+     */
+    async clearCache(tenantId, projectId, conversationId) {
+        await this.cache.clearConversation(tenantId, projectId, conversationId);
+        logger.info({
+            conversationId,
+        }, 'Context cache cleared for conversation');
+    }
+}
+//# sourceMappingURL=ContextResolver.js.map

package/dist/context/ContextResolver.js.map

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

package/dist/context/TemplateEngine.d.ts

@@ -0,0 +1,46 @@
+export interface TemplateContext {
+    [key: string]: unknown;
+}
+export interface TemplateRenderOptions {
+    strict?: boolean;
+    preserveUnresolved?: boolean;
+}
+export declare class TemplateEngine {
+    private static readonly DEFAULT_OPTIONS;
+    /**
+     * Render a template string with context data using JMESPath
+     */
+    static render(template: string, context: TemplateContext, options?: TemplateRenderOptions): string;
+    /**
+     * Process variable substitutions {{variable.path}} using JMESPath
+     */
+    private static processVariables;
+    /**
+     * Process built-in variables like $now, $env, etc.
+     */
+    private static processBuiltinVariable;
+    /**
+     * Check if template contains template variables
+     */
+    private static hasTemplateVariables;
+    /**
+     * Extract all template variables from a template
+     */
+    private static extractTemplateVariables;
+    /**
+     * Validate template syntax
+     */
+    static validateTemplate(template: string): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Preview template rendering with sample context
+     */
+    static preview(template: string, sampleContext: TemplateContext, options?: TemplateRenderOptions): {
+        rendered: string;
+        variables: string[];
+        errors: string[];
+    };
+}
+//# sourceMappingURL=TemplateEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.d.ts","sourceRoot":"","sources":["../../src/context/TemplateEngine.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAGrC;IAEF;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,qBAA0B,GAClC,MAAM;IA2BT;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA8D/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA2BrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAInC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAavC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA+B/E;;OAEG;IACH,MAAM,CAAC,OAAO,CACZ,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,eAAe,EAC9B,OAAO,GAAE,qBAA0B,GAClC;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;CAkBF"}

package/dist/context/TemplateEngine.js

@@ -0,0 +1,175 @@
+import jmespath from 'jmespath';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('template-engine');
+export class TemplateEngine {
+    static DEFAULT_OPTIONS = {
+        strict: false,
+        preserveUnresolved: false,
+    };
+    /**
+     * Render a template string with context data using JMESPath
+     */
+    static render(template, context, options = {}) {
+        const opts = { ...TemplateEngine.DEFAULT_OPTIONS, ...options };
+        try {
+            // Process template variables using JMESPath
+            const rendered = TemplateEngine.processVariables(template, context, opts);
+            // Check for unresolved variables if strict mode
+            if (opts.strict && TemplateEngine.hasTemplateVariables(rendered)) {
+                const unresolvedVars = TemplateEngine.extractTemplateVariables(rendered);
+                throw new Error(`Unresolved template variables: ${unresolvedVars.join(', ')}`);
+            }
+            return rendered;
+        }
+        catch (error) {
+            logger.error({
+                template: template.substring(0, 100) + (template.length > 100 ? '...' : ''),
+                contextKeys: Object.keys(context),
+                error: error instanceof Error ? error.message : 'Unknown error',
+            }, 'Template rendering failed');
+            throw error;
+        }
+    }
+    /**
+     * Process variable substitutions {{variable.path}} using JMESPath
+     */
+    static processVariables(template, context, options) {
+        return template.replace(/\{\{([^}]+)\}\}/g, (match, path) => {
+            const trimmedPath = path.trim();
+            try {
+                // Handle special built-in variables
+                if (trimmedPath.startsWith('$')) {
+                    return TemplateEngine.processBuiltinVariable(trimmedPath);
+                }
+                // Use JMESPath to extract value from context
+                const result = jmespath.search(context, trimmedPath);
+                if (result === undefined || result === null) {
+                    if (options.strict) {
+                        throw new Error(`Template variable '${trimmedPath}' not found in context`);
+                    }
+                    if (options.preserveUnresolved) {
+                        return match; // Keep original template
+                    }
+                    logger.warn({
+                        variable: trimmedPath,
+                        availableKeys: Object.keys(context),
+                    }, 'Template variable not found in context');
+                    return ''; // Replace with empty string
+                }
+                // Handle different types of values
+                if (typeof result === 'object') {
+                    return JSON.stringify(result);
+                }
+                return String(result);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                if (options.strict) {
+                    throw new Error(`Failed to resolve template variable '${trimmedPath}': ${errorMessage}`);
+                }
+                logger.error({
+                    variable: trimmedPath,
+                    error: errorMessage,
+                }, 'Failed to resolve template variable');
+                return options.preserveUnresolved ? match : '';
+            }
+        });
+    }
+    /**
+     * Process built-in variables like $now, $env, etc.
+     */
+    static processBuiltinVariable(variable) {
+        switch (variable) {
+            case '$now':
+                return new Date().toISOString();
+            case '$timestamp':
+                return Date.now().toString();
+            case '$date':
+                return new Date().toDateString();
+            case '$time':
+                return new Date().toTimeString();
+            default:
+                // Check for environment variables like $env.NODE_ENV
+                if (variable.startsWith('$env.')) {
+                    const envVar = variable.substring(5);
+                    return process.env[envVar] || '';
+                }
+                logger.warn({
+                    variable,
+                }, 'Unknown built-in variable');
+                return '';
+        }
+    }
+    /**
+     * Check if template contains template variables
+     */
+    static hasTemplateVariables(template) {
+        return /\{\{[^}]+\}\}/.test(template);
+    }
+    /**
+     * Extract all template variables from a template
+     */
+    static extractTemplateVariables(template) {
+        const variables = [];
+        const regex = /\{\{([^}]+)\}\}/g;
+        const matches = template.matchAll(regex);
+        for (const match of matches) {
+            if (!match[1]) {
+                continue;
+            }
+            variables.push(match[1].trim());
+        }
+        return [...new Set(variables)]; // Remove duplicates
+    }
+    /**
+     * Validate template syntax
+     */
+    static validateTemplate(template) {
+        const errors = [];
+        try {
+            // Check for balanced braces
+            const openBraces = (template.match(/\{\{/g) || []).length;
+            const closeBraces = (template.match(/\}\}/g) || []).length;
+            if (openBraces !== closeBraces) {
+                errors.push(`Unbalanced template braces: ${openBraces} opening, ${closeBraces} closing`);
+            }
+            // Extract and validate variable paths
+            const variables = TemplateEngine.extractTemplateVariables(template);
+            for (const variable of variables) {
+                if (variable.includes('{{') || variable.includes('}}')) {
+                    errors.push(`Nested template syntax in variable: ${variable}`);
+                }
+            }
+            return { valid: errors.length === 0, errors };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                errors: [
+                    `Template validation error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                ],
+            };
+        }
+    }
+    /**
+     * Preview template rendering with sample context
+     */
+    static preview(template, sampleContext, options = {}) {
+        const variables = TemplateEngine.extractTemplateVariables(template);
+        const errors = [];
+        let rendered = '';
+        try {
+            rendered = TemplateEngine.render(template, sampleContext, options);
+        }
+        catch (error) {
+            errors.push(error instanceof Error ? error.message : 'Unknown rendering error');
+            rendered = template; // Return original template on error
+        }
+        return {
+            rendered,
+            variables,
+            errors,
+        };
+    }
+}
+//# sourceMappingURL=TemplateEngine.js.map

package/dist/context/TemplateEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.js","sourceRoot":"","sources":["../../src/context/TemplateEngine.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,MAAM,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;AAW5C,MAAM,OAAO,cAAc;IACjB,MAAM,CAAU,eAAe,GAAoC;QACzE,MAAM,EAAE,KAAK;QACb,kBAAkB,EAAE,KAAK;KAC1B,CAAC;IAEF;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,QAAgB,EAChB,OAAwB,EACxB,UAAiC,EAAE;QAEnC,MAAM,IAAI,GAAG,EAAE,GAAG,cAAc,CAAC,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;QAE/D,IAAI,CAAC;YACH,4CAA4C;YAC5C,MAAM,QAAQ,GAAG,cAAc,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YAE1E,gDAAgD;YAChD,IAAI,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjE,MAAM,cAAc,GAAG,cAAc,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;gBACzE,MAAM,IAAI,KAAK,CAAC,kCAAkC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV;gBACE,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3E,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;gBACjC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,EACD,2BAA2B,CAC5B,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,gBAAgB,CAC7B,QAAgB,EAChB,OAAwB,EACxB,OAAwC;QAExC,OAAO,QAAQ,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAEhC,IAAI,CAAC;gBACH,oCAAoC;gBACpC,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChC,OAAO,cAAc,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;gBAC5D,CAAC;gBAED,6CAA6C;gBAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBAErD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBAC5C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;wBACnB,MAAM,IAAI,KAAK,CAAC,sBAAsB,WAAW,wBAAwB,CAAC,CAAC;oBAC7E,CAAC;oBAED,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;wBAC/B,OAAO,KAAK,CAAC,CAAC,yBAAyB;oBACzC,CAAC;oBAED,MAAM,CAAC,IAAI,CACT;wBACE,QAAQ,EAAE,WAAW;wBACrB,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;qBACpC,EACD,wCAAwC,CACzC,CAAC;oBACF,OAAO,EAAE,CAAC,CAAC,4BAA4B;gBACzC,CAAC;gBAED,mCAAmC;gBACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAChC,CAAC;gBAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;gBAE9E,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,wCAAwC,WAAW,MAAM,YAAY,EAAE,CAAC,CAAC;gBAC3F,CAAC;gBAED,MAAM,CAAC,KAAK,CACV;oBACE,QAAQ,EAAE,WAAW;oBACrB,KAAK,EAAE,YAAY;iBACpB,EACD,qCAAqC,CACtC,CAAC;gBAEF,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,sBAAsB,CAAC,QAAgB;QACpD,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,MAAM;gBACT,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAClC,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;YAC/B,KAAK,OAAO;gBACV,OAAO,IAAI,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;YACnC,KAAK,OAAO;gBACV,OAAO,IAAI,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;YACnC;gBACE,qDAAqD;gBACrD,IAAI,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;oBACrC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACnC,CAAC;gBAED,MAAM,CAAC,IAAI,CACT;oBACE,QAAQ;iBACT,EACD,2BAA2B,CAC5B,CAAC;gBACF,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,oBAAoB,CAAC,QAAgB;QAClD,OAAO,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,wBAAwB,CAAC,QAAgB;QACtD,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,kBAAkB,CAAC;QACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,oBAAoB;IACtD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QACtC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC;YACH,4BAA4B;YAC5B,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAC1D,MAAM,WAAW,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAE3D,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,+BAA+B,UAAU,aAAa,WAAW,UAAU,CAAC,CAAC;YAC3F,CAAC;YAED,sCAAsC;YACtC,MAAM,SAAS,GAAG,cAAc,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;YACpE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvD,MAAM,CAAC,IAAI,CAAC,uCAAuC,QAAQ,EAAE,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE;oBACN,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;iBACzF;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CACZ,QAAgB,EAChB,aAA8B,EAC9B,UAAiC,EAAE;QAMnC,MAAM,SAAS,GAAG,cAAc,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QACpE,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;YAChF,QAAQ,GAAG,QAAQ,CAAC,CAAC,oCAAoC;QAC3D,CAAC;QAED,OAAO;YACL,QAAQ;YACR,SAAS;YACT,MAAM;SACP,CAAC;IACJ,CAAC"}

package/dist/context/context.d.ts

@@ -0,0 +1,7 @@
+import { type ResolvedContext } from './ContextResolver.js';
+import { type DatabaseClient } from '@inkeep/agents-core';
+declare function determineContextTrigger(tenantId: string, projectId: string, conversationId: string, dbClient: DatabaseClient): Promise<'initialization' | 'invocation'>;
+declare function handleContextConfigChange(tenantId: string, projectId: string, conversationId: string, graphId: string, newContextConfigId: string, dbClient: DatabaseClient): Promise<void>;
+declare function handleContextResolution(tenantId: string, projectId: string, conversationId: string, graphId: string, requestContext: Record<string, unknown>, dbClient: DatabaseClient): Promise<ResolvedContext | null>;
+export { handleContextResolution, determineContextTrigger, handleContextConfigChange };
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAQ7B,iBAAe,uBAAuB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,GAAG,YAAY,CAAC,CAa1C;AAGD,iBAAe,yBAAyB,CACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,MAAM,EAC1B,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAGD,iBAAe,uBAAuB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAsJjC;AAED,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,CAAC"}