@inkeep/agents-core 0.0.0-dev-20250910233133

package/dist/types/server.d.ts

@@ -0,0 +1,116 @@
+import type { Context } from 'hono';
+/**
+ * Credential store interface for managing different types of credentials
+ */
+export interface CredentialStore {
+    /**
+     * Unique identifier for this credential store
+     */
+    id: string;
+    /**
+     * Type of credential store
+     */
+    type: string;
+    /**
+     * Get a credential by key
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * Set a credential
+     */
+    set(key: string, value: string): Promise<void>;
+    /**
+     * Check if a credential exists
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Delete a credential
+     */
+    delete(key: string): Promise<boolean>;
+}
+/**
+ * Server configuration options for HTTP server behavior
+ * These settings control connection management, timeouts, and server behavior
+ */
+export interface ServerOptions {
+    /**
+     * Server port to listen on
+     * Default: 3000
+     */
+    port?: number;
+    /**
+     * Keep alive timeout in milliseconds
+     * Time to wait for additional data after the last response before closing the connection.
+     * Used for persistent connections to improve performance by reusing connections.
+     * Scenario: Set higher (10-30s) for high-traffic APIs, lower (1-5s) for low-traffic services.
+     * Default: 60000ms (60 seconds)
+     */
+    keepAliveTimeout?: number;
+    /**
+     * Enable keep alive connections
+     * When true, allows connection reuse for multiple requests.
+     * Improves performance but uses more server resources.
+     * Scenario: Enable for APIs with frequent requests, disable for one-off services.
+     * Default: true
+     */
+    keepAlive?: boolean;
+    /**
+     * Request timeout in milliseconds
+     * Maximum time to wait for a complete request from the client.
+     * Helps prevent DoS attacks by limiting resource consumption from slow clients.
+     * Scenario: Set lower (30s) for simple APIs, higher (5-10min) for file upload services.
+     * Default: 60000ms (60 seconds)
+     */
+    requestTimeout?: number;
+}
+/**
+ * CORS configuration compatible with Hono's CORSOptions
+ */
+export interface CorsConfig {
+    /**
+     * Allowed origins - string, array of strings, or function
+     */
+    origin?: string | string[] | ((origin: string, c?: Context) => string | null | undefined);
+    /**
+     * Allowed methods
+     */
+    allowMethods?: string[];
+    /**
+     * Allowed headers
+     */
+    allowHeaders?: string[];
+    /**
+     * Exposed headers
+     */
+    exposeHeaders?: string[];
+    /**
+     * Max age for preflight requests
+     */
+    maxAge?: number;
+    /**
+     * Whether to allow credentials
+     */
+    credentials?: boolean;
+}
+/**
+ * Base server configuration for all Inkeep services
+ */
+export interface ServerConfig {
+    /**
+     * Server port to listen on
+     */
+    port?: number;
+    /**
+     * Server options for HTTP behavior
+     */
+    serverOptions?: ServerOptions;
+    /**
+     * Array of credential stores for managing API keys, tokens, etc.
+     */
+    credentialStores?: CredentialStore[];
+    /**
+     * CORS configuration
+     */
+    cors?: CorsConfig;
+}
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/types/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEzC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAE1F;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IAErC;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB"}

package/dist/types/server.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.js.map

package/dist/types/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/types/server.ts"],"names":[],"mappings":""}

package/dist/types/utility.d.ts

@@ -0,0 +1,213 @@
+import type { z } from 'zod';
+import type { ApiKeySelect } from '../index';
+import type { McpTransportConfigSchema, ModelSchema, StatusComponentSchema, StatusUpdateSchema } from '../validation/schemas';
+export type MessageVisibility = 'user-facing' | 'internal' | 'system' | 'external';
+export type MessageType = 'chat' | 'a2a-request' | 'a2a-response' | 'task-update' | 'tool-call';
+export type MessageRole = 'user' | 'agent' | 'system';
+export type MessageMode = 'full' | 'scoped' | 'none';
+export type Models = z.infer<typeof ModelSchema>;
+export type ModelSettings = {
+    model?: string;
+    providerOptions?: Record<string, unknown>;
+};
+export type StatusUpdateSettings = z.infer<typeof StatusUpdateSchema>;
+export type StatusComponent = z.infer<typeof StatusComponentSchema>;
+export type PaginationConfig = {
+    page?: number;
+    limit?: number;
+};
+export type PaginationResult = {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+};
+export type ScopeConfig = {
+    tenantId: string;
+    projectId: string;
+};
+export interface ConversationScopeOptions {
+    taskId?: string;
+    agentId?: string;
+}
+export type ConversationHistoryConfig = {
+    mode?: 'full' | 'scoped' | 'none';
+    limit?: number;
+    maxOutputTokens?: number;
+    includeInternal?: boolean;
+    messageTypes?: MessageType[];
+};
+export interface AgentConversationHistoryConfig extends ConversationHistoryConfig {
+    mode: 'full' | 'scoped' | 'none';
+}
+export type ConversationMetadata = {
+    userContext?: Record<string, unknown>;
+    preferences?: Record<string, unknown>;
+    sessionData?: Record<string, unknown>;
+};
+export type MessageContent = {
+    text?: string;
+    parts?: Array<{
+        kind: string;
+        text?: string;
+        data?: string | Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+    }>;
+    tool_calls?: Array<{
+        id: string;
+        type: string;
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    tool_call_id?: string;
+    name?: string;
+};
+export type MessageMetadata = {
+    openai_model?: string;
+    finish_reason?: string;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+    a2a_metadata?: Record<string, unknown>;
+    processing_time_ms?: number;
+    error_details?: Record<string, unknown>;
+};
+export type ContextFetchDefinition = {
+    id: string;
+    name?: string;
+    trigger: 'initialization' | 'invocation';
+    fetchConfig: {
+        url: string;
+        method?: string;
+        headers?: Record<string, string>;
+        body?: Record<string, unknown>;
+        transform?: string;
+        timeout?: number;
+    };
+    responseSchema?: Record<string, unknown>;
+    defaultValue?: unknown;
+    credentialReferenceId?: string;
+};
+export type ContextCacheEntry = {
+    id: string;
+    tenantId: string;
+    projectId: string;
+    conversationId: string;
+    contextConfigId: string;
+    contextVariableKey: string;
+    value: unknown;
+    requestHash?: string;
+    fetchedAt: Date;
+    fetchSource?: string;
+    fetchDurationMs?: number;
+    createdAt: Date;
+    updatedAt: Date;
+};
+export type McpTranportType = 'streamable_http' | 'sse';
+export type McpAuthType = 'bearer' | 'basic' | 'api_key' | 'none';
+export type McpServerAuth = {
+    type: McpAuthType;
+    token?: string;
+    username?: string;
+    password?: string;
+    apiKey?: string;
+    headerName?: string;
+};
+export type McpTransportConfig = z.infer<typeof McpTransportConfigSchema>;
+export type McpServerCapabilities = {
+    tools?: boolean;
+    resources?: boolean;
+    prompts?: boolean;
+    logging?: boolean;
+};
+export type McpToolDefinition = {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+};
+export type ToolMcpConfig = {
+    server: {
+        url: string;
+        timeout?: number;
+        headers?: Record<string, string>;
+    };
+    transport?: McpTransportConfig;
+    activeTools?: string[];
+};
+export type ToolServerCapabilities = {
+    tools?: boolean;
+    resources?: boolean;
+    prompts?: boolean;
+    logging?: boolean;
+    streaming?: boolean;
+};
+export type TaskMetadataConfig = {
+    conversation_id: string;
+    message_id: string;
+    created_at: string;
+    updated_at: string;
+    root_agent_id?: string;
+    agent_id?: string;
+    tool_id?: string;
+    graph_id?: string;
+    stream_request_id?: string;
+};
+export interface ProjectInfo {
+    projectId: string;
+}
+export interface ProjectResourceCounts {
+    agents: number;
+    agentGraphs: number;
+    tools: number;
+    contextConfigs: number;
+    externalAgents: number;
+}
+export interface RequestSchemaDefinition {
+    body?: z.ZodSchema<any>;
+    headers?: z.ZodSchema<any>;
+    query?: z.ZodSchema<any>;
+    params?: z.ZodSchema<any>;
+}
+export interface RequestSchemaConfig {
+    schemas: RequestSchemaDefinition;
+    optional?: ('body' | 'headers' | 'query' | 'params')[];
+}
+export type toolStatus = 'healthy' | 'unhealthy' | 'unknown';
+export declare const TOOL_STATUS_VALUES: readonly ["healthy", "unhealthy", "unknown", "disabled", "needs_auth"];
+export declare const VALID_RELATION_TYPES: readonly ["transfer", "delegate"];
+export type McpToolStatus = (typeof TOOL_STATUS_VALUES)[number];
+export interface CreateApiKeyParams {
+    tenantId: string;
+    projectId: string;
+    graphId: string;
+    expiresAt?: string;
+}
+export interface ApiKeyCreateResult {
+    apiKey: ApiKeySelect;
+    key: string;
+}
+/**
+ * Execution context that gets propagated through agent calls
+ * Contains authentication and routing information for internal API calls
+ */
+export interface ExecutionContext {
+    /** The original API key from the client request */
+    apiKey: string;
+    /** Tenant ID extracted from API key */
+    tenantId: string;
+    /** Project ID extracted from API key */
+    projectId: string;
+    /** Graph ID extracted from API key */
+    graphId: string;
+    /** Base URL for internal API calls */
+    baseUrl: string;
+    /** API key ID for tracking */
+    apiKeyId: string;
+    /** Agent ID extracted from request headers (only for internal A2A calls) */
+    agentId?: string;
+}
+//# sourceMappingURL=utility.d.ts.map

package/dist/types/utility.d.ts.map

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

package/dist/types/utility.js

@@ -0,0 +1,9 @@
+export const TOOL_STATUS_VALUES = [
+    'healthy',
+    'unhealthy',
+    'unknown',
+    'disabled',
+    'needs_auth',
+];
+export const VALID_RELATION_TYPES = ['transfer', 'delegate'];
+//# sourceMappingURL=utility.js.map

package/dist/types/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../src/types/utility.ts"],"names":[],"mappings":"AA6NA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS;IACT,WAAW;IACX,SAAS;IACT,UAAU;IACV,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,UAAU,CAAU,CAAC"}

package/dist/utils/apiKeys.d.ts

@@ -0,0 +1,32 @@
+export type ApiKeyGenerationResult = {
+    id: string;
+    publicId: string;
+    key: string;
+    keyHash: string;
+    keyPrefix: string;
+};
+/**
+ * Generate a new API key with secure random bytes
+ */
+export declare function generateApiKey(): Promise<ApiKeyGenerationResult>;
+/**
+ * Hash an API key using scrypt
+ */
+export declare function hashApiKey(key: string): Promise<string>;
+/**
+ * Validate an API key against its hash
+ */
+export declare function validateApiKey(key: string, storedHash: string): Promise<boolean>;
+/**
+ * Check if an API key has expired
+ */
+export declare function isApiKeyExpired(expiresAt?: string | null): boolean;
+/**
+ * Extract the publicId from an API key
+ */
+export declare function extractPublicId(key: string): string | null;
+/**
+ * Mask an API key for display (show only prefix and last 4 chars)
+ */
+export declare function maskApiKey(keyPrefix: string): string;
+//# sourceMappingURL=apiKeys.d.ts.map

package/dist/utils/apiKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiKeys.d.ts","sourceRoot":"","sources":["../../src/utils/apiKeys.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,sBAAsB,CAAC,CA0BtE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY7D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBtF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CASlE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2B1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/utils/apiKeys.js

@@ -0,0 +1,117 @@
+import { randomBytes, scrypt, timingSafeEqual } from 'node:crypto';
+import { promisify } from 'node:util';
+import { customAlphabet, nanoid } from 'nanoid';
+import { getLogger } from './logger';
+const scryptAsync = promisify(scrypt);
+const logger = getLogger('api-key');
+// API key configuration
+const API_KEY_LENGTH = 32; // Length of random bytes
+const SALT_LENGTH = 32; // Length of salt for hashing
+const KEY_LENGTH = 64; // Length of derived key from scrypt
+const PUBLIC_ID_LENGTH = 12;
+// Custom alphabet excluding underscores and dots
+const PUBLIC_ID_ALPHABET = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ-';
+const generatePublicId = customAlphabet(PUBLIC_ID_ALPHABET, PUBLIC_ID_LENGTH);
+/**
+ * Generate a new API key with secure random bytes
+ */
+export async function generateApiKey() {
+    const publicId = generatePublicId();
+    // Generate secret part (random bytes)
+    const secretBytes = randomBytes(API_KEY_LENGTH);
+    const secret = secretBytes.toString('base64url');
+    // Create key in format: sk_<env>_<publicId>.<secret>
+    const key = `sk_${publicId}.${secret}`;
+    // Extract prefix for identification (first 12 chars)
+    const keyPrefix = key.substring(0, 12);
+    // Hash the entire key for storage
+    const keyHash = await hashApiKey(key);
+    // Generate unique ID for database record
+    const id = nanoid();
+    return {
+        id,
+        publicId,
+        key,
+        keyHash,
+        keyPrefix,
+    };
+}
+/**
+ * Hash an API key using scrypt
+ */
+export async function hashApiKey(key) {
+    // Generate a random salt
+    const salt = randomBytes(SALT_LENGTH);
+    // Hash the key with scrypt
+    const hashedBuffer = (await scryptAsync(key, salt, KEY_LENGTH));
+    // Combine salt and hash for storage
+    const combined = Buffer.concat([salt, hashedBuffer]);
+    // Return as base64 string
+    return combined.toString('base64');
+}
+/**
+ * Validate an API key against its hash
+ */
+export async function validateApiKey(key, storedHash) {
+    try {
+        // Decode the stored hash
+        const combined = Buffer.from(storedHash, 'base64');
+        // Extract salt and hash
+        const salt = combined.subarray(0, SALT_LENGTH);
+        const storedHashBuffer = combined.subarray(SALT_LENGTH);
+        // Hash the provided key with the same salt
+        const hashedBuffer = (await scryptAsync(key, salt, KEY_LENGTH));
+        // Use timing-safe comparison to prevent timing attacks
+        return timingSafeEqual(storedHashBuffer, hashedBuffer);
+    }
+    catch (error) {
+        logger.error({ error }, 'Error validating API key');
+        // Return false for any errors (invalid format, etc.)
+        return false;
+    }
+}
+/**
+ * Check if an API key has expired
+ */
+export function isApiKeyExpired(expiresAt) {
+    if (!expiresAt) {
+        return false; // No expiration set
+    }
+    const expirationDate = new Date(expiresAt);
+    const now = new Date();
+    return now > expirationDate;
+}
+/**
+ * Extract the publicId from an API key
+ */
+export function extractPublicId(key) {
+    try {
+        // Expected format: sk_<env>_<publicId>.<secret> or sk_<publicId>.<secret>
+        const parts = key.split('.');
+        if (parts.length !== 2) {
+            return null;
+        }
+        const prefixPart = parts[0]; // e.g., "sk_test_abc123def456" or "sk_abc123def456"
+        const segments = prefixPart.split('_');
+        if (segments.length < 2) {
+            return null;
+        }
+        // Get the last segment which should be the publicId
+        const publicId = segments[segments.length - 1];
+        // Validate publicId length (should be 12 chars)
+        if (publicId.length !== 12) {
+            return null;
+        }
+        return publicId;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Mask an API key for display (show only prefix and last 4 chars)
+ */
+export function maskApiKey(keyPrefix) {
+    return `${keyPrefix}...`;
+}
+//# sourceMappingURL=apiKeys.js.map

package/dist/utils/apiKeys.js.map

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

package/dist/utils/auth-detection.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Centralized authentication detection utilities for MCP tools
+ */
+import type { McpTool } from '../types/entities';
+import type { Logger } from './logging';
+/**
+ * OAuth configuration interface
+ */
+export interface OAuthConfig {
+    authorizationUrl: string;
+    tokenUrl: string;
+    registrationUrl?: string;
+    supportsDynamicRegistration: boolean;
+}
+/**
+ * Full OAuth endpoint discovery with complete configuration
+ */
+export declare const discoverOAuthEndpoints: (serverUrl: string, logger?: Logger) => Promise<OAuthConfig | null>;
+/**
+ * Detect if OAuth 2.1/PKCE authentication is specifically required for a tool
+ */
+export declare const detectAuthenticationRequired: (tool: McpTool, error: Error, logger?: Logger) => Promise<boolean>;
+//# sourceMappingURL=auth-detection.d.ts.map

package/dist/utils/auth-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-detection.d.ts","sourceRoot":"","sources":["../../src/utils/auth-detection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B,EAAE,OAAO,CAAC;CACtC;AA6DD;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,EACjB,SAAS,MAAM,KACd,OAAO,CAAC,WAAW,GAAG,IAAI,CAkC5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,OAAO,EACb,OAAO,KAAK,EACZ,SAAS,MAAM,KACd,OAAO,CAAC,OAAO,CAsEjB,CAAC"}