@inkeep/agents-api 0.0.1 → 0.43.0

package/dist/domains/run/agents/ModelFactory.js

@@ -1,194 +0,0 @@
-import { getLogger } from "../../../logger.js";
-import { anthropic, createAnthropic } from "@ai-sdk/anthropic";
-import { createGateway, gateway } from "@ai-sdk/gateway";
-import { createGoogleGenerativeAI, google } from "@ai-sdk/google";
-import { createOpenAI, openai } from "@ai-sdk/openai";
-import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
-import { createOpenRouter, openrouter } from "@openrouter/ai-sdk-provider";
-
-//#region src/domains/run/agents/ModelFactory.ts
-const logger = getLogger("ModelFactory");
-const nimDefault = createOpenAICompatible({
-	name: "nim",
-	baseURL: "https://integrate.api.nvidia.com/v1",
-	headers: { Authorization: `Bearer ${process.env.NIM_API_KEY}` }
-});
-/**
-* Factory for creating AI SDK language models from configuration
-* Supports multiple providers and AI Gateway integration
-*/
-var ModelFactory = class ModelFactory {
-	/**
-	* Create a provider instance with custom configuration
-	* Returns a provider with at least languageModel method
-	*/
-	static createProvider(provider, config) {
-		switch (provider) {
-			case "anthropic": return createAnthropic(config);
-			case "openai": return createOpenAI(config);
-			case "google": return createGoogleGenerativeAI(config);
-			case "openrouter": return createOpenRouter(config);
-			case "gateway": return createGateway(config);
-			case "nim": return createOpenAICompatible({
-				name: "nim",
-				baseURL: "https://integrate.api.nvidia.com/v1",
-				headers: { Authorization: `Bearer ${process.env.NIM_API_KEY}` },
-				...config
-			});
-			case "custom": {
-				if (!config.baseURL && !config.baseUrl) throw new Error("Custom provider requires baseURL. Please provide it in providerOptions.baseURL or providerOptions.baseUrl");
-				const customConfig = {
-					name: "custom",
-					baseURL: config.baseURL || config.baseUrl,
-					headers: {
-						...process.env.CUSTOM_LLM_API_KEY && { Authorization: `Bearer ${process.env.CUSTOM_LLM_API_KEY}` },
-						...config.headers || {}
-					},
-					...config
-				};
-				logger.info({ config: {
-					baseURL: customConfig.baseURL,
-					hasApiKey: !!process.env.CUSTOM_LLM_API_KEY,
-					apiKeyPrefix: `${process.env.CUSTOM_LLM_API_KEY?.substring(0, 10) || ""}...`,
-					headers: Object.keys(customConfig.headers || {})
-				} }, "Creating custom OpenAI-compatible provider");
-				return createOpenAICompatible(customConfig);
-			}
-			default: throw new Error(`Unsupported provider: ${provider}`);
-		}
-	}
-	/**
-	* Extract provider configuration from providerOptions
-	* Only includes settings that go to the provider constructor (baseURL, apiKey, etc.)
-	*/
-	static extractProviderConfig(providerOptions) {
-		if (!providerOptions) return {};
-		const providerConfig = {};
-		if (providerOptions.baseUrl || providerOptions.baseURL) providerConfig.baseURL = providerOptions.baseUrl || providerOptions.baseURL;
-		if (providerOptions.headers) providerConfig.headers = providerOptions.headers;
-		if (providerOptions.gateway) Object.assign(providerConfig, providerOptions.gateway);
-		if (providerOptions.nim) Object.assign(providerConfig, providerOptions.nim);
-		if (providerOptions.custom) Object.assign(providerConfig, providerOptions.custom);
-		return providerConfig;
-	}
-	/**
-	* Create a language model instance from configuration
-	* Throws error if no config provided - models must be configured at project level
-	*/
-	static createModel(config) {
-		if (!config?.model?.trim()) throw new Error("Model configuration is required. Please configure models at the project level.");
-		const modelSettings = config;
-		if (!modelSettings.model) throw new Error("Model configuration is required");
-		const modelString = modelSettings.model.trim();
-		const { provider, modelName } = ModelFactory.parseModelString(modelString);
-		logger.debug({
-			provider,
-			model: modelName,
-			fullModelString: modelSettings.model,
-			hasProviderOptions: !!modelSettings.providerOptions
-		}, "Creating language model from config");
-		const providerConfig = ModelFactory.extractProviderConfig(modelSettings.providerOptions);
-		if (Object.keys(providerConfig).length > 0) {
-			logger.info({ config: providerConfig }, `Applying custom ${provider} provider configuration`);
-			return ModelFactory.createProvider(provider, providerConfig).languageModel(modelName);
-		}
-		switch (provider) {
-			case "anthropic": return anthropic(modelName);
-			case "openai": return openai(modelName);
-			case "google": return google(modelName);
-			case "openrouter": return openrouter(modelName);
-			case "gateway": return gateway(modelName);
-			case "nim": return nimDefault(modelName);
-			case "custom": throw new Error("Custom provider requires configuration. Please provide baseURL in providerOptions.custom.baseURL or providerOptions.baseURL");
-			default: throw new Error(`Unsupported provider: ${provider}. Supported providers are: ${ModelFactory.BUILT_IN_PROVIDERS.join(", ")}. To access other models, use OpenRouter (openrouter/model-id), Vercel AI Gateway (gateway/model-id), NVIDIA NIM (nim/model-id), or Custom OpenAI-compatible (custom/model-id).`);
-		}
-	}
-	/**
-	* Built-in providers that have special handling
-	*/
-	static BUILT_IN_PROVIDERS = [
-		"anthropic",
-		"openai",
-		"google",
-		"openrouter",
-		"gateway",
-		"nim",
-		"custom"
-	];
-	/**
-	* Parse model string to extract provider and model name
-	* Examples: "anthropic/claude-sonnet-4" -> { provider: "anthropic", modelName: "claude-sonnet-4" }
-	*          "openrouter/anthropic/claude-sonnet-4" -> { provider: "openrouter", modelName: "anthropic/claude-sonnet-4" }
-	*          "claude-sonnet-4" -> { provider: "anthropic", modelName: "claude-sonnet-4" } (default to anthropic)
-	*/
-	static parseModelString(modelString) {
-		if (modelString.includes("/")) {
-			const [provider, ...modelParts] = modelString.split("/");
-			const normalizedProvider = provider.toLowerCase();
-			if (!ModelFactory.BUILT_IN_PROVIDERS.includes(normalizedProvider)) throw new Error(`Unsupported provider: ${normalizedProvider}. Supported providers are: ${ModelFactory.BUILT_IN_PROVIDERS.join(", ")}. To access other models, use OpenRouter (openrouter/model-id), Vercel AI Gateway (gateway/model-id), NVIDIA NIM (nim/model-id), or Custom OpenAI-compatible (custom/model-id).`);
-			return {
-				provider: normalizedProvider,
-				modelName: modelParts.join("/")
-			};
-		}
-		throw new Error(`No provider specified in model string: ${modelString}`);
-	}
-	/**
-	* Get generation parameters from provider options
-	* These are parameters that get passed to generateText/streamText calls
-	*/
-	static getGenerationParams(providerOptions) {
-		if (!providerOptions) return {};
-		const excludedKeys = [
-			"apiKey",
-			"baseURL",
-			"baseUrl",
-			"maxDuration",
-			"headers",
-			"gateway",
-			"nim",
-			"custom"
-		];
-		const params = {};
-		for (const [key, value] of Object.entries(providerOptions)) if (!excludedKeys.includes(key) && value !== void 0) params[key] = value;
-		return params;
-	}
-	/**
-	* Prepare complete generation configuration from model settings
-	* Returns model instance and generation parameters ready to spread into generateText/streamText
-	* Includes maxDuration if specified in provider options (in seconds, following Vercel standard)
-	*/
-	static prepareGenerationConfig(modelSettings) {
-		const modelString = modelSettings?.model?.trim();
-		const model = ModelFactory.createModel({
-			model: modelString,
-			providerOptions: modelSettings?.providerOptions
-		});
-		const generationParams = ModelFactory.getGenerationParams(modelSettings?.providerOptions);
-		const maxDuration = modelSettings?.providerOptions?.maxDuration;
-		return {
-			model,
-			...generationParams,
-			...maxDuration !== void 0 && { maxDuration }
-		};
-	}
-	/**
-	* Validate model settingsuration
-	* Basic validation only - let AI SDK handle parameter-specific validation
-	*/
-	static validateConfig(config) {
-		const errors = [];
-		if (!config.model) errors.push("Model name is required");
-		if (config.providerOptions) {
-			if (config.providerOptions.apiKey) errors.push("API keys should not be stored in provider options. Use environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY) or credential store instead.");
-			if (config.providerOptions.maxDuration !== void 0) {
-				const maxDuration = config.providerOptions.maxDuration;
-				if (typeof maxDuration !== "number" || maxDuration <= 0) errors.push("maxDuration must be a positive number (in seconds)");
-			}
-		}
-		return errors;
-	}
-};
-
-//#endregion
-export { ModelFactory };

package/dist/domains/run/data/agent.d.ts

@@ -1,7 +0,0 @@
-import { RegisteredAgent } from "../a2a/types.js";
-import { FullExecutionContext } from "@inkeep/agents-core";
-
-//#region src/domains/run/data/agent.d.ts
-declare function getRegisteredAgent(executionContext: FullExecutionContext): Promise<RegisteredAgent | null>;
-//#endregion
-export { getRegisteredAgent };

package/dist/domains/run/data/agent.js

@@ -1,67 +0,0 @@
-import { getAgentFromProject, getSubAgentFromProject } from "../utils/project.js";
-import { createTaskHandler, createTaskHandlerConfig } from "../agents/generateTaskHandler.js";
-
-//#region src/domains/run/data/agent.ts
-async function hydrateAgent({ dbAgent, executionContext, baseUrl }) {
-	const { tenantId, projectId, agentId, project, apiKey } = executionContext;
-	try {
-		if (!dbAgent.defaultSubAgentId) throw new Error(`Agent ${dbAgent.id} does not have a default agent configured`);
-		const subAgentId = dbAgent.defaultSubAgentId;
-		if (!getSubAgentFromProject({
-			project,
-			agentId,
-			subAgentId
-		})) throw new Error(`Default agent ${dbAgent.defaultSubAgentId} not found for agent ${dbAgent.id}`);
-		const taskHandler = createTaskHandler(await createTaskHandlerConfig({
-			executionContext,
-			subAgentId: dbAgent.defaultSubAgentId,
-			baseUrl,
-			apiKey
-		}));
-		const agentCard = {
-			name: dbAgent.name,
-			description: dbAgent.description || `Agent: ${dbAgent.name}`,
-			url: baseUrl ? `${baseUrl}/a2a` : "",
-			version: "1.0.0",
-			capabilities: {
-				streaming: true,
-				pushNotifications: false,
-				stateTransitionHistory: false
-			},
-			defaultInputModes: ["text", "text/plain"],
-			defaultOutputModes: ["text", "text/plain"],
-			skills: [],
-			...baseUrl && { provider: {
-				organization: "Inkeep",
-				url: baseUrl
-			} }
-		};
-		return {
-			subAgentId: dbAgent.id,
-			tenantId,
-			projectId,
-			agentId: dbAgent.id,
-			agentCard,
-			taskHandler
-		};
-	} catch (error) {
-		console.error(`❌ Failed to hydrate agent ${dbAgent.id}:`, error);
-		throw error;
-	}
-}
-async function getRegisteredAgent(executionContext) {
-	const { project, agentId, baseUrl } = executionContext;
-	const dbAgent = getAgentFromProject({
-		project,
-		agentId
-	});
-	if (!dbAgent) return null;
-	return hydrateAgent({
-		dbAgent,
-		executionContext,
-		baseUrl: `${baseUrl}/run/agents`
-	});
-}
-
-//#endregion
-export { getRegisteredAgent };

package/dist/domains/run/services/evaluationRunConfigMatcher.d.ts

@@ -1,4 +0,0 @@
-//#region src/domains/run/services/evaluationRunConfigMatcher.d.ts
-declare function evaluationRunConfigMatchesConversation(): Promise<boolean>;
-//#endregion
-export { evaluationRunConfigMatchesConversation };

package/dist/domains/run/services/evaluationRunConfigMatcher.js

@@ -1,7 +0,0 @@
-//#region src/domains/run/services/evaluationRunConfigMatcher.ts
-async function evaluationRunConfigMatchesConversation() {
-	return true;
-}
-
-//#endregion
-export { evaluationRunConfigMatchesConversation };

package/dist/domains/run/utils/cleanup.d.ts

@@ -1,21 +0,0 @@
-//#region src/domains/run/utils/cleanup.d.ts
-/**
- * Cleanup utilities for gracefully shutting down resources
- * Helps prevent Node.js processes from hanging
- */
-/**
- * Gracefully exit the process after cleaning up resources
- */
-declare function gracefulExit(code?: number, delayMs?: number, message?: string): void;
-/**
- * Setup signal handlers for graceful shutdown
- */
-declare function setupGracefulShutdown(cleanupFn?: () => Promise<void> | void, exitDelayMs?: number): void;
-/**
- * Stop all tools associated with agents
- */
-declare function stopAllAgentTools(agents: Array<{
-  getTools: () => Record<string, any>;
-}>): Promise<void>;
-//#endregion
-export { gracefulExit, setupGracefulShutdown, stopAllAgentTools };

package/dist/domains/run/utils/cleanup.js

@@ -1,59 +0,0 @@
-import { getLogger } from "../../../logger.js";
-
-//#region src/domains/run/utils/cleanup.ts
-/**
-* Cleanup utilities for gracefully shutting down resources
-* Helps prevent Node.js processes from hanging
-*/
-const logger = getLogger("cleanup");
-/**
-* Gracefully exit the process after cleaning up resources
-*/
-function gracefulExit(code = 0, delayMs = 1e3, message) {
-	if (message) logger.info({}, message);
-	setTimeout(() => {
-		logger.debug({}, "Forcing process exit after cleanup delay");
-		process.exit(code);
-	}, delayMs);
-}
-/**
-* Setup signal handlers for graceful shutdown
-*/
-function setupGracefulShutdown(cleanupFn, exitDelayMs = 2e3) {
-	const signals = ["SIGTERM", "SIGINT"];
-	let isShuttingDown = false;
-	for (const signal of signals) process.on(signal, async () => {
-		if (isShuttingDown) {
-			logger.warn({}, `Received ${signal} during shutdown, forcing exit`);
-			process.exit(1);
-		}
-		logger.info({}, `Received ${signal}, starting graceful shutdown`);
-		isShuttingDown = true;
-		try {
-			if (cleanupFn) await cleanupFn();
-		} catch (error) {
-			logger.error({ error }, "Error during cleanup");
-		}
-		gracefulExit(0, exitDelayMs, "🚪 Graceful shutdown complete");
-	});
-}
-/**
-* Stop all tools associated with agents
-*/
-async function stopAllAgentTools(agents) {
-	logger.info({}, "Stopping all agent tools...");
-	for (const agent of agents) {
-		const tools = agent.getTools();
-		for (const toolInstance of Object.values(tools)) if (toolInstance && typeof toolInstance.stop === "function") try {
-			await toolInstance.stop();
-			const toolName = toolInstance.config?.name || "unknown";
-			logger.debug({}, `Stopped tool: ${toolName}`);
-		} catch (error) {
-			logger.warn({}, `Failed to stop tool: ${error instanceof Error ? error.message : "Unknown error"}`);
-		}
-	}
-	logger.info({}, "All agent tools stopped");
-}
-
-//#endregion
-export { gracefulExit, setupGracefulShutdown, stopAllAgentTools };

package/dist/utils/tempApiKeys.d.ts

@@ -1,17 +0,0 @@
-import { AgentsRunDatabaseClient } from "@inkeep/agents-core";
-
-//#region src/utils/tempApiKeys.d.ts
-interface CreateTempApiKeyParams {
-  tenantId: string;
-  projectId: string;
-  agentId: string;
-  userId: string;
-  expiryHours?: number;
-}
-interface TempApiKeyResult {
-  apiKey: string;
-  expiresAt: string;
-}
-declare function createTempApiKey(db: AgentsRunDatabaseClient, params: CreateTempApiKeyParams): Promise<TempApiKeyResult>;
-//#endregion
-export { CreateTempApiKeyParams, TempApiKeyResult, createTempApiKey };

package/dist/utils/tempApiKeys.js

@@ -1,26 +0,0 @@
-import { createApiKey, generateApiKey } from "@inkeep/agents-core";
-
-//#region src/utils/tempApiKeys.ts
-async function createTempApiKey(db, params) {
-	const expiryHours = params.expiryHours || 1;
-	const expiresAt = new Date(Date.now() + expiryHours * 60 * 60 * 1e3);
-	const keyData = await generateApiKey();
-	await createApiKey(db)({
-		id: keyData.id,
-		publicId: keyData.publicId,
-		keyHash: keyData.keyHash,
-		keyPrefix: keyData.keyPrefix,
-		name: `playground-temp-${params.userId}`,
-		tenantId: params.tenantId,
-		projectId: params.projectId,
-		agentId: params.agentId,
-		expiresAt: expiresAt.toISOString()
-	});
-	return {
-		apiKey: keyData.key,
-		expiresAt: expiresAt.toISOString()
-	};
-}
-
-//#endregion
-export { createTempApiKey };

package/dist/utils/workflowApiHelpers.d.ts

@@ -1 +0,0 @@
-export { };

package/dist/utils/workflowApiHelpers.js

@@ -1 +0,0 @@
-export {  };