@od-oneapp/ai-platform 0.1.0

package/dist/coordinator-agent-BglqZLwo.d.mts

@@ -0,0 +1,54 @@
+import { Nr as SDKLanguageModel } from "./ai-runtime-DIwOEc6g.mjs";
+import { a as AgentExecutionOptions, c as BaseAgentState, n as AgentConfig, t as Agent } from "./types-DbUfMCnT.mjs";
+import { z } from "zod";
+
+//#region src/agents/coordinator/coordinator-agent.d.ts
+interface Task {
+  id: string;
+  description: string;
+  agentId: string;
+  dependencies?: string[];
+  priority?: number;
+  input?: unknown;
+}
+interface TaskResult {
+  taskId: string;
+  status: 'pending' | 'running' | 'completed' | 'failed';
+  result?: unknown;
+  error?: string;
+  executionTimeMs?: number;
+}
+declare const ExecutionPlanSchema: z.ZodObject<{
+  description: z.ZodString;
+  tasks: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    agentId: z.ZodString;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    priority: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+  estimatedTimeMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type ExecutionPlan = z.infer<typeof ExecutionPlanSchema>;
+interface CoordinatorConfig extends Omit<AgentConfig, 'systemPrompt'> {
+  agents: Map<string, Agent>;
+  maxParallel?: number;
+  taskTimeoutMs?: number;
+  planningPrompt?: string;
+}
+declare function createCoordinatorAgent(config: CoordinatorConfig): {
+  config: AgentConfig;
+  agents: Map<string, Agent>;
+  plan(goal: string, options: {
+    model: SDKLanguageModel;
+    context?: AgentExecutionOptions["context"];
+  }): Promise<ExecutionPlan>;
+  executePlan(plan: ExecutionPlan, options: AgentExecutionOptions): Promise<Map<string, TaskResult>>;
+  execute(prompt: string, options: AgentExecutionOptions): Promise<BaseAgentState & {
+    plan: ExecutionPlan;
+    taskResults: Map<string, TaskResult>;
+  }>;
+};
+//#endregion
+export { TaskResult as a, Task as i, ExecutionPlan as n, createCoordinatorAgent as o, ExecutionPlanSchema as r, CoordinatorConfig as t };
+//# sourceMappingURL=coordinator-agent-BglqZLwo.d.mts.map

package/dist/coordinator-agent-BglqZLwo.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-agent-BglqZLwo.d.mts","names":[],"sources":["../src/agents/coordinator/coordinator-agent.ts"],"mappings":";;;;;UAkBiB,IAAA;EAEf,EAAA;EAEA,WAAA;EAEA,OAAA;EAEA,YAAA;EAEA,QAAA;EAEA,KAAA;AAAA;AAAA,UAMe,UAAA;EAEf,MAAA;EAEA,MAAA;EAEA,MAAA;EAEA,KAAA;EAEA,eAAA;AAAA;AAAA,cAMW,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;;;;;;;;KAiBpB,aAAA,GAAgB,CAAA,CAAE,KAAA,QAAa,mBAAA;AAAA,UAK1B,iBAAA,SAA0B,IAAA,CAAK,WAAA;EAE9C,MAAA,EAAQ,GAAA,SAAY,KAAA;EAEpB,WAAA;EAEA,aAAA;EAEA,cAAA;AAAA;AAAA,iBA4Bc,sBAAA,CAAuB,MAAA,EAAQ,iBAAA;UAWJ,WAAA;;qBAOzB,OAAA;IACD,KAAA,EAAO,gBAAA;IAAkB,OAAA,GAAU,qBAAA;EAAA,IAC7C,OAAA,CAAQ,aAAA;oBAgBH,aAAA,EAAa,OAAA,EACV,qBAAA,GACR,OAAA,CAAQ,GAAA,SAAY,UAAA;0BAkJP,OAAA,EACL,qBAAA,GACR,OAAA,CAAQ,cAAA;IAAmB,IAAA,EAAM,aAAA;IAAe,WAAA,EAAa,GAAA,SAAY,UAAA;EAAA;AAAA"}

package/dist/coordinator-agent-WFWBRL-G.mjs

@@ -0,0 +1,236 @@
+import { $ as generateObject } from "./ai-runtime-CDzQztTt.mjs";
+import { n as createInitialState } from "./factory-DP6VSl8C.mjs";
+import { z } from "zod";
+import { withTimeout } from "@od-oneapp/core-utils/shared/timeout";
+
+//#region src/agents/coordinator/coordinator-agent.ts
+/**
+* @fileoverview Coordinator agent for multi-agent orchestration.
+* @module @od-oneapp/ai-platform/agents/coordinator
+*/
+/**
+* Execution plan schema.
+*/
+const ExecutionPlanSchema = z.object({
+	description: z.string(),
+	tasks: z.array(z.object({
+		id: z.string(),
+		description: z.string(),
+		agentId: z.string(),
+		dependencies: z.array(z.string()).optional(),
+		priority: z.number().optional()
+	})),
+	estimatedTimeMs: z.number().optional()
+});
+/**
+* Creates a coordinator agent that orchestrates multiple agents.
+*
+* @param config - Coordinator configuration
+* @returns Coordinator agent
+*
+* @example
+* ```ts
+* const coordinator = createCoordinatorAgent({
+*   id: 'coordinator',
+*   name: 'Task Coordinator',
+*   description: 'Coordinates multi-agent workflows',
+*   agents: new Map([
+*     ['research', researchAgent],
+*     ['code', codeAgent],
+*     ['review', reviewAgent],
+*   ]),
+*   maxParallel: 3,
+* });
+*
+* const result = await coordinator.execute('Build a todo app with tests', {
+*   model: openai('gpt-4o'),
+* });
+* ```
+*/
+function createCoordinatorAgent(config) {
+	const { agents, maxParallel = 3, taskTimeoutMs = 6e4, planningPrompt } = config;
+	if (maxParallel < 1) throw new Error(`maxParallel must be at least 1, got ${maxParallel}`);
+	const systemPrompt = planningPrompt ?? buildPlanningPrompt(agents);
+	return {
+		config: {
+			...config,
+			systemPrompt
+		},
+		agents,
+		async plan(goal, options) {
+			const { object } = await generateObject({
+				model: options.model,
+				system: systemPrompt,
+				prompt: `Create an execution plan for this goal:\n\n"${goal}"`,
+				schema: ExecutionPlanSchema,
+				abortSignal: options.context?.abortSignal
+			});
+			return object;
+		},
+		async executePlan(plan, options) {
+			const taskIds = plan.tasks.map((t) => t.id);
+			if (new Set(taskIds).size !== taskIds.length) {
+				const duplicates = taskIds.filter((id, idx) => taskIds.indexOf(id) !== idx);
+				throw new Error(`Duplicate task IDs detected: ${[...new Set(duplicates)].join(", ")}`);
+			}
+			const results = /* @__PURE__ */ new Map();
+			const pending = new Set(plan.tasks.map((t) => t.id));
+			const running = /* @__PURE__ */ new Set();
+			const runningPromises = /* @__PURE__ */ new Map();
+			for (const task of plan.tasks) results.set(task.id, {
+				taskId: task.id,
+				status: "pending"
+			});
+			while (pending.size > 0 || running.size > 0) {
+				const availableSlots = maxParallel - running.size;
+				const readyTasks = plan.tasks.filter((task) => {
+					if (!pending.has(task.id)) return false;
+					return (task.dependencies ?? []).every((depId) => {
+						return results.get(depId)?.status === "completed";
+					});
+				}).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0)).slice(0, Math.max(0, availableSlots));
+				if (readyTasks.length === 0 && running.size === 0) {
+					const missingDeps = plan.tasks.filter((task) => pending.has(task.id)).flatMap((task) => {
+						return (task.dependencies ?? []).filter((depId) => !results.has(depId)).map((depId) => ({
+							taskId: task.id,
+							depId
+						}));
+					});
+					if (missingDeps.length > 0) {
+						const missingDep = missingDeps[0];
+						if (missingDep) throw new Error(`Task "${missingDep.taskId}" references non-existent dependency "${missingDep.depId}"`);
+					}
+					if (plan.tasks.some((task) => {
+						if (!pending.has(task.id)) return false;
+						return (task.dependencies ?? []).some((depId) => results.get(depId)?.status === "failed");
+					})) {
+						for (const taskId of pending) results.set(taskId, {
+							taskId,
+							status: "failed",
+							error: "Dependency failed"
+						});
+						break;
+					}
+					throw new Error("Circular dependency detected in task plan");
+				}
+				for (const task of readyTasks) {
+					pending.delete(task.id);
+					running.add(task.id);
+					results.set(task.id, {
+						taskId: task.id,
+						status: "running"
+					});
+					const taskPromise = (async () => {
+						const startTime = Date.now();
+						const agent = agents.get(task.agentId);
+						if (!agent) {
+							results.set(task.id, {
+								taskId: task.id,
+								status: "failed",
+								error: `Agent not found: ${task.agentId}`
+							});
+							running.delete(task.id);
+							runningPromises.delete(task.id);
+							return;
+						}
+						try {
+							const depResults = {};
+							for (const depId of task.dependencies ?? []) depResults[depId] = results.get(depId)?.result;
+							const prompt = buildTaskPrompt(task, depResults);
+							const agentResult = await withTimeout(agent.execute(prompt, options), taskTimeoutMs, { name: `Task ${task.id}` });
+							results.set(task.id, {
+								taskId: task.id,
+								status: "completed",
+								result: agentResult.result,
+								executionTimeMs: Date.now() - startTime
+							});
+						} catch (error) {
+							results.set(task.id, {
+								taskId: task.id,
+								status: "failed",
+								error: error instanceof Error ? error.message : String(error),
+								executionTimeMs: Date.now() - startTime
+							});
+						} finally {
+							running.delete(task.id);
+							runningPromises.delete(task.id);
+						}
+					})();
+					runningPromises.set(task.id, taskPromise);
+				}
+				if (runningPromises.size > 0) await Promise.race(runningPromises.values());
+			}
+			return results;
+		},
+		async execute(prompt, options) {
+			const state = createInitialState(options.messages);
+			try {
+				const plan = await this.plan(prompt, {
+					model: options.model,
+					context: options.context
+				});
+				state.metadata.plan = plan;
+				const taskResults = await this.executePlan(plan, options);
+				const completedTasks = Array.from(taskResults.values()).filter((r) => r.status === "completed");
+				state.isComplete = true;
+				state.result = {
+					plan,
+					taskResults: Object.fromEntries(taskResults),
+					completedCount: completedTasks.length,
+					totalCount: plan.tasks.length
+				};
+				return {
+					...state,
+					plan,
+					taskResults
+				};
+			} catch (error) {
+				state.error = error instanceof Error ? error : new Error(String(error));
+				state.isComplete = true;
+				return {
+					...state,
+					plan: {
+						description: "",
+						tasks: []
+					},
+					taskResults: /* @__PURE__ */ new Map()
+				};
+			}
+		}
+	};
+}
+/**
+* Builds the planning system prompt.
+*/
+function buildPlanningPrompt(agents) {
+	return `You are a task planning coordinator. Your job is to break down complex goals into tasks that can be executed by specialized agents.
+
+Available Agents:
+${Array.from(agents.entries()).map(([id, agent]) => `- ${id}: ${agent.config.description}`).join("\n")}
+
+Instructions:
+1. Analyze the goal to identify required sub-tasks
+2. Assign each task to the most appropriate agent
+3. Define dependencies between tasks (which must complete before others can start)
+4. Prioritize tasks when possible (higher priority = execute first when ready)
+5. Keep tasks focused and atomic
+
+Output your plan in the specified JSON format.`;
+}
+/**
+* Builds a task prompt including dependency results.
+*/
+function buildTaskPrompt(task, depResults) {
+	let prompt = task.description;
+	if (task.input) prompt += `\n\nInput: ${JSON.stringify(task.input)}`;
+	const deps = Object.entries(depResults);
+	if (deps.length > 0) {
+		prompt += "\n\nResults from previous tasks:";
+		for (const [depId, result] of deps) prompt += `\n- ${depId}: ${JSON.stringify(result)}`;
+	}
+	return prompt;
+}
+
+//#endregion
+export { createCoordinatorAgent as n, ExecutionPlanSchema as t };
+//# sourceMappingURL=coordinator-agent-WFWBRL-G.mjs.map

package/dist/coordinator-agent-WFWBRL-G.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-agent-WFWBRL-G.mjs","names":[],"sources":["../src/agents/coordinator/coordinator-agent.ts"],"sourcesContent":["/**\n * @fileoverview Coordinator agent for multi-agent orchestration.\n * @module @od-oneapp/ai-platform/agents/coordinator\n */\n\nimport { withTimeout } from '@repo/core-utils/shared/timeout';\nimport { z } from 'zod';\n\nimport { generateObject } from '../../shared';\nimport { createInitialState } from '../base/factory';\n\nimport type { SDKLanguageModel } from '../../shared';\nimport type { Agent, AgentConfig, BaseAgentState, AgentExecutionOptions } from '../base/types';\n\n\n/**\n * Task definition for coordinator.\n */\nexport interface Task {\n  /** Task ID */\n  id: string;\n  /** Task description */\n  description: string;\n  /** Agent ID to execute task */\n  agentId: string;\n  /** Dependencies (task IDs that must complete first) */\n  dependencies?: string[];\n  /** Priority (higher = more urgent) */\n  priority?: number;\n  /** Input data for the task */\n  input?: unknown;\n}\n\n/**\n * Task result.\n */\nexport interface TaskResult {\n  /** Task ID */\n  taskId: string;\n  /** Task status */\n  status: 'pending' | 'running' | 'completed' | 'failed';\n  /** Result data */\n  result?: unknown;\n  /** Error if failed */\n  error?: string;\n  /** Execution time in ms */\n  executionTimeMs?: number;\n}\n\n/**\n * Execution plan schema.\n */\nexport const ExecutionPlanSchema = z.object({\n  /** Plan description */\n  description: z.string(),\n  /** Tasks to execute */\n  tasks: z.array(\n    z.object({\n      id: z.string(),\n      description: z.string(),\n      agentId: z.string(),\n      dependencies: z.array(z.string()).optional(),\n      priority: z.number().optional(),\n    }),\n  ),\n  /** Estimated total time */\n  estimatedTimeMs: z.number().optional(),\n});\n\nexport type ExecutionPlan = z.infer<typeof ExecutionPlanSchema>;\n\n/**\n * Coordinator agent configuration.\n */\nexport interface CoordinatorConfig extends Omit<AgentConfig, 'systemPrompt'> {\n  /** Available agents */\n  agents: Map<string, Agent>;\n  /** Maximum parallel tasks */\n  maxParallel?: number;\n  /** Task timeout in ms */\n  taskTimeoutMs?: number;\n  /** Custom planning prompt */\n  planningPrompt?: string;\n}\n\n/**\n * Creates a coordinator agent that orchestrates multiple agents.\n *\n * @param config - Coordinator configuration\n * @returns Coordinator agent\n *\n * @example\n * ```ts\n * const coordinator = createCoordinatorAgent({\n *   id: 'coordinator',\n *   name: 'Task Coordinator',\n *   description: 'Coordinates multi-agent workflows',\n *   agents: new Map([\n *     ['research', researchAgent],\n *     ['code', codeAgent],\n *     ['review', reviewAgent],\n *   ]),\n *   maxParallel: 3,\n * });\n *\n * const result = await coordinator.execute('Build a todo app with tests', {\n *   model: openai('gpt-4o'),\n * });\n * ```\n */\nexport function createCoordinatorAgent(config: CoordinatorConfig) {\n  const { agents, maxParallel = 3, taskTimeoutMs = 60000, planningPrompt } = config;\n\n  // Validate maxParallel to avoid misleading failures\n  if (maxParallel < 1) {\n    throw new Error(`maxParallel must be at least 1, got ${maxParallel}`);\n  }\n\n  const systemPrompt = planningPrompt ?? buildPlanningPrompt(agents);\n\n  return {\n    config: { ...config, systemPrompt } as AgentConfig,\n    agents,\n\n    /**\n     * Creates an execution plan for a goal.\n     */\n    async plan(\n      goal: string,\n      options: { model: SDKLanguageModel; context?: AgentExecutionOptions['context'] },\n    ): Promise<ExecutionPlan> {\n      const { object } = await generateObject({\n        model: options.model,\n        system: systemPrompt,\n        prompt: `Create an execution plan for this goal:\\n\\n\"${goal}\"`,\n        schema: ExecutionPlanSchema,\n        abortSignal: options.context?.abortSignal,\n      });\n\n      return object;\n    },\n\n    /**\n     * Executes a plan with dependency management.\n     */\n    async executePlan(\n      plan: ExecutionPlan,\n      options: AgentExecutionOptions,\n    ): Promise<Map<string, TaskResult>> {\n      // Validate unique task IDs to prevent silent task skipping\n      const taskIds = plan.tasks.map(t => t.id);\n      const uniqueIds = new Set(taskIds);\n      if (uniqueIds.size !== taskIds.length) {\n        const duplicates = taskIds.filter((id, idx) => taskIds.indexOf(id) !== idx);\n        throw new Error(`Duplicate task IDs detected: ${[...new Set(duplicates)].join(', ')}`);\n      }\n\n      const results = new Map<string, TaskResult>();\n      const pending = new Set(plan.tasks.map(t => t.id));\n      const running = new Set<string>();\n      const runningPromises = new Map<string, Promise<void>>();\n\n      // Initialize all tasks as pending\n      for (const task of plan.tasks) {\n        results.set(task.id, { taskId: task.id, status: 'pending' });\n      }\n\n      while (pending.size > 0 || running.size > 0) {\n        // Find ready tasks (dependencies completed), sorted by priority descending\n        const availableSlots = maxParallel - running.size;\n        const readyTasks = plan.tasks\n          .filter(task => {\n            if (!pending.has(task.id)) return false;\n\n            const deps = task.dependencies ?? [];\n            return deps.every(depId => {\n              const depResult = results.get(depId);\n              return depResult?.status === 'completed';\n            });\n          })\n          .sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0))\n          .slice(0, Math.max(0, availableSlots));\n\n        if (readyTasks.length === 0 && running.size === 0) {\n          // Check for missing dependencies first\n          const missingDeps = plan.tasks\n            .filter(task => pending.has(task.id))\n            .flatMap(task => {\n              const deps = task.dependencies ?? [];\n              return deps\n                .filter(depId => !results.has(depId))\n                .map(depId => ({ taskId: task.id, depId }));\n            });\n\n          if (missingDeps.length > 0) {\n            const missingDep = missingDeps[0];\n            if (missingDep) {\n              throw new Error(\n                `Task \"${missingDep.taskId}\" references non-existent dependency \"${missingDep.depId}\"`,\n              );\n            }\n          }\n\n          // Check for failed dependencies\n          const hasFailedDeps = plan.tasks.some(task => {\n            if (!pending.has(task.id)) return false;\n            const deps = task.dependencies ?? [];\n            return deps.some(depId => results.get(depId)?.status === 'failed');\n          });\n\n          if (hasFailedDeps) {\n            // Mark remaining tasks as failed due to dependency failure\n            for (const taskId of pending) {\n              results.set(taskId, {\n                taskId,\n                status: 'failed',\n                error: 'Dependency failed',\n              });\n            }\n            break;\n          }\n\n          // Circular dependency\n          throw new Error('Circular dependency detected in task plan');\n        }\n\n        // Start ready tasks\n        for (const task of readyTasks) {\n          pending.delete(task.id);\n          running.add(task.id);\n          results.set(task.id, { taskId: task.id, status: 'running' });\n\n          const taskPromise = (async () => {\n            const startTime = Date.now();\n            const agent = agents.get(task.agentId);\n\n            if (!agent) {\n              results.set(task.id, {\n                taskId: task.id,\n                status: 'failed',\n                error: `Agent not found: ${task.agentId}`,\n              });\n              running.delete(task.id);\n              runningPromises.delete(task.id);\n              return;\n            }\n\n            try {\n              // Build context with dependency results\n              const depResults: Record<string, unknown> = {};\n              for (const depId of task.dependencies ?? []) {\n                depResults[depId] = results.get(depId)?.result;\n              }\n\n              const prompt = buildTaskPrompt(task, depResults);\n              const agentResult = await withTimeout(agent.execute(prompt, options), taskTimeoutMs, {\n                name: `Task ${task.id}`,\n              });\n\n              results.set(task.id, {\n                taskId: task.id,\n                status: 'completed',\n                result: agentResult.result,\n                executionTimeMs: Date.now() - startTime,\n              });\n            } catch (error) {\n              results.set(task.id, {\n                taskId: task.id,\n                status: 'failed',\n                error: error instanceof Error ? error.message : String(error),\n                executionTimeMs: Date.now() - startTime,\n              });\n            } finally {\n              running.delete(task.id);\n              runningPromises.delete(task.id);\n            }\n          })();\n\n          runningPromises.set(task.id, taskPromise);\n        }\n\n        // Wait for at least one task to complete if there are any running\n        if (runningPromises.size > 0) {\n          await Promise.race(runningPromises.values());\n        }\n      }\n\n      return results;\n    },\n\n    /**\n     * Full execution: plan + execute.\n     */\n    async execute(\n      prompt: string,\n      options: AgentExecutionOptions,\n    ): Promise<BaseAgentState & { plan: ExecutionPlan; taskResults: Map<string, TaskResult> }> {\n      const state = createInitialState(options.messages);\n\n      try {\n        // Create plan\n        const plan = await this.plan(prompt, {\n          model: options.model,\n          context: options.context,\n        });\n\n        state.metadata.plan = plan;\n\n        // Execute plan\n        const taskResults = await this.executePlan(plan, options);\n\n        // Aggregate results\n        const completedTasks = Array.from(taskResults.values()).filter(\n          r => r.status === 'completed',\n        );\n\n        state.isComplete = true;\n        state.result = {\n          plan,\n          taskResults: Object.fromEntries(taskResults),\n          completedCount: completedTasks.length,\n          totalCount: plan.tasks.length,\n        };\n\n        return { ...state, plan, taskResults };\n      } catch (error) {\n        state.error = error instanceof Error ? error : new Error(String(error));\n        state.isComplete = true;\n        return {\n          ...state,\n          plan: { description: '', tasks: [] },\n          taskResults: new Map(),\n        };\n      }\n    },\n  };\n}\n\n/**\n * Builds the planning system prompt.\n */\nfunction buildPlanningPrompt(agents: Map<string, Agent>): string {\n  const agentList = Array.from(agents.entries())\n    .map(([id, agent]) => `- ${id}: ${agent.config.description}`)\n    .join('\\n');\n\n  return `You are a task planning coordinator. Your job is to break down complex goals into tasks that can be executed by specialized agents.\n\nAvailable Agents:\n${agentList}\n\nInstructions:\n1. Analyze the goal to identify required sub-tasks\n2. Assign each task to the most appropriate agent\n3. Define dependencies between tasks (which must complete before others can start)\n4. Prioritize tasks when possible (higher priority = execute first when ready)\n5. Keep tasks focused and atomic\n\nOutput your plan in the specified JSON format.`;\n}\n\n/**\n * Builds a task prompt including dependency results.\n */\nfunction buildTaskPrompt(task: Task, depResults: Record<string, unknown>): string {\n  let prompt = task.description;\n\n  if (task.input) {\n    prompt += `\\n\\nInput: ${JSON.stringify(task.input)}`;\n  }\n\n  const deps = Object.entries(depResults);\n  if (deps.length > 0) {\n    prompt += '\\n\\nResults from previous tasks:';\n    for (const [depId, result] of deps) {\n      prompt += `\\n- ${depId}: ${JSON.stringify(result)}`;\n    }\n  }\n\n  return prompt;\n}\n"],"mappings":"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"}

package/dist/crypto-8ABhc3TD.mjs

@@ -0,0 +1,40 @@
+import { createHash, createHmac } from "node:crypto";
+
+//#region src/server/cache/crypto.ts
+/**
+* @fileoverview Cryptographic helper functions for audit logging and data integrity
+* Provides hashing and signature generation for security-critical operations
+*/
+/**
+* Generate a hash of the input data using SHA-256
+* @param input - Data to hash (string or object)
+* @returns Hex-encoded hash
+*/
+function hashInput(input) {
+	const data = typeof input === "string" ? input : JSON.stringify(input);
+	return createHash("sha256").update(data).digest("hex");
+}
+/**
+* Generate an HMAC signature for the input data
+* @param input - Data to sign
+* @param secret - Secret key for HMAC (defaults to env var or empty string)
+* @returns Hex-encoded HMAC signature
+*/
+function generateSignature(input, secret) {
+	const data = typeof input === "string" ? input : JSON.stringify(input);
+	return createHmac("sha256", secret || process.env.AUDIT_SECRET_KEY || "").update(data).digest("hex");
+}
+/**
+* Verify an HMAC signature
+* @param input - Original data that was signed
+* @param signature - Signature to verify
+* @param secret - Secret key for HMAC (defaults to env var or empty string)
+* @returns True if signature is valid
+*/
+function verifySignature(input, signature, secret) {
+	return generateSignature(input, secret) === signature;
+}
+
+//#endregion
+export { hashInput as n, verifySignature as r, generateSignature as t };
+//# sourceMappingURL=crypto-8ABhc3TD.mjs.map

package/dist/crypto-8ABhc3TD.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-8ABhc3TD.mjs","names":[],"sources":["../src/server/cache/crypto.ts"],"sourcesContent":["/**\n * @fileoverview Cryptographic helper functions for audit logging and data integrity\n * Provides hashing and signature generation for security-critical operations\n */\n\nimport { createHash, createHmac } from 'node:crypto';\n\n/**\n * Generate a hash of the input data using SHA-256\n * @param input - Data to hash (string or object)\n * @returns Hex-encoded hash\n */\nexport function hashInput(input: string | Record<string, unknown>): string {\n  const data = typeof input === 'string' ? input : JSON.stringify(input);\n  return createHash('sha256').update(data).digest('hex');\n}\n\n/**\n * Generate an HMAC signature for the input data\n * @param input - Data to sign\n * @param secret - Secret key for HMAC (defaults to env var or empty string)\n * @returns Hex-encoded HMAC signature\n */\nexport function generateSignature(\n  input: string | Record<string, unknown>,\n  secret?: string,\n): string {\n  const data = typeof input === 'string' ? input : JSON.stringify(input);\n  const key = secret || process.env.AUDIT_SECRET_KEY || '';\n  return createHmac('sha256', key).update(data).digest('hex');\n}\n\n/**\n * Verify an HMAC signature\n * @param input - Original data that was signed\n * @param signature - Signature to verify\n * @param secret - Secret key for HMAC (defaults to env var or empty string)\n * @returns True if signature is valid\n */\nexport function verifySignature(\n  input: string | Record<string, unknown>,\n  signature: string,\n  secret?: string,\n): boolean {\n  const expected = generateSignature(input, secret);\n  return expected === signature;\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,UAAU,OAAiD;CACzE,MAAM,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,MAAM;AACtE,QAAO,WAAW,SAAS,CAAC,OAAO,KAAK,CAAC,OAAO,MAAM;;;;;;;;AASxD,SAAgB,kBACd,OACA,QACQ;CACR,MAAM,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,MAAM;AAEtE,QAAO,WAAW,UADN,UAAU,QAAQ,IAAI,oBAAoB,GACtB,CAAC,OAAO,KAAK,CAAC,OAAO,MAAM;;;;;;;;;AAU7D,SAAgB,gBACd,OACA,WACA,QACS;AAET,QADiB,kBAAkB,OAAO,OAAO,KAC7B"}

package/dist/environment-CSoJb0SW.mjs

@@ -0,0 +1,255 @@
+import { t as __exportAll } from "./chunk-CkzbjWQW.mjs";
+import { logWarn } from "@od-oneapp/shared/logs";
+
+//#region src/tools/mcp/transports.ts
+/**
+* Pre-configured MCP transports for common use cases
+*/
+const mcpTransports = {
+	filesystem: (rootPath = process.cwd()) => ({
+		name: "filesystem",
+		transport: {
+			type: "stdio",
+			command: "npx",
+			args: [
+				"-y",
+				"@modelcontextprotocol/server-filesystem",
+				rootPath
+			]
+		}
+	}),
+	sqlite: (dbPath) => ({
+		name: "sqlite",
+		transport: {
+			type: "stdio",
+			command: "npx",
+			args: [
+				"-y",
+				"@modelcontextprotocol/server-sqlite",
+				dbPath
+			]
+		}
+	}),
+	git: (repoPath = process.cwd()) => ({
+		name: "git",
+		transport: {
+			type: "stdio",
+			command: "npx",
+			args: [
+				"-y",
+				"@modelcontextprotocol/server-git",
+				repoPath
+			]
+		}
+	}),
+	sse: (name, url) => ({
+		name,
+		transport: {
+			type: "sse",
+			url
+		}
+	}),
+	stdio: (name, command, args = []) => ({
+		name,
+		transport: {
+			type: "stdio",
+			command,
+			args
+		}
+	}),
+	http: (name, httpUrl, sessionId) => ({
+		name,
+		transport: {
+			type: "http",
+			url: httpUrl,
+			sessionId
+		}
+	}),
+	perplexityAsk: () => ({
+		name: "perplexity-ask",
+		transport: {
+			type: "stdio",
+			command: "npx",
+			args: ["-y", "server-perplexity-ask"]
+		}
+	})
+};
+
+//#endregion
+//#region src/tools/mcp/environment.ts
+/**
+* @fileoverview environment.ts
+*/
+var environment_exports = /* @__PURE__ */ __exportAll({
+	discoverMCPServersFromEnvironment: () => discoverMCPServersFromEnvironment,
+	getMCPServers: () => getMCPServers,
+	validateMCPEnvironment: () => validateMCPEnvironment
+});
+/**
+* Discover MCP servers from environment variables
+*
+* Environment variable format:
+* - MCP_SERVERS=filesystem,git,perplexity  # Enable specific servers
+* - MCP_FILESYSTEM_PATH=/workspace         # Configure filesystem path
+* - MCP_CUSTOM_SQLITE_DB=/data/app.db      # Configure sqlite database
+* - MCP_CUSTOM_SSE_URL=http://example.com  # Configure SSE server
+* - MCP_CUSTOM_HTTP_URL=http://example.com # Configure HTTP server
+*/
+function discoverMCPServersFromEnvironment(config = {}) {
+	const { prefix = "MCP_", includeDefaults = true, basePath = process.cwd() } = config;
+	const allowDefaults = !(process.env.NODE_ENV === "production") || process.env[`${prefix}ALLOW_DEFAULTS`] === "true";
+	const servers = [];
+	const enabledServers = getEnabledServers(prefix);
+	if (includeDefaults && !allowDefaults) logWarn("MCP default servers are disabled in production unless MCP_ALLOW_DEFAULTS=true", { operation: "mcp_default_servers_blocked" });
+	if (includeDefaults && allowDefaults) {
+		if (enabledServers.includes("filesystem")) {
+			const fsPath = process.env[`${prefix}FILESYSTEM_PATH`] || basePath;
+			servers.push(mcpTransports.filesystem(fsPath));
+		}
+		if (enabledServers.includes("git")) {
+			const gitPath = process.env[`${prefix}GIT_PATH`] || basePath;
+			servers.push(mcpTransports.git(gitPath));
+		}
+		if (enabledServers.includes("perplexity") && process.env.PERPLEXITY_API_KEY) servers.push(mcpTransports.perplexityAsk());
+		if (enabledServers.includes("sqlite")) {
+			const dbPath = process.env[`${prefix}SQLITE_DB`];
+			if (dbPath) servers.push(mcpTransports.sqlite(dbPath));
+		}
+	}
+	const customServers = discoverCustomServers(prefix, enabledServers);
+	servers.push(...customServers);
+	return servers;
+}
+/**
+* Get list of enabled servers from environment
+*/
+function getEnabledServers(prefix) {
+	const serversEnv = process.env[`${prefix}SERVERS`];
+	if (!serversEnv) return [];
+	return serversEnv.split(",").map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
+}
+/**
+* Discover custom MCP servers from environment variables
+*/
+function discoverCustomServers(prefix, enabledServers) {
+	const servers = [];
+	const processed = /* @__PURE__ */ new Set();
+	for (const [envKey, envValue] of Object.entries(process.env)) {
+		if (!envKey.startsWith(prefix) || !envValue) continue;
+		const match = envKey.match(new RegExp(`^${prefix}CUSTOM_(.+)_(URL|COMMAND|DB)$`));
+		if (!match) continue;
+		const [, serverName, configType] = match;
+		if (!serverName || !configType) continue;
+		const name = serverName.toLowerCase();
+		if (!enabledServers.includes(name) && !enabledServers.includes("*")) continue;
+		if (processed.has(name)) continue;
+		processed.add(name);
+		const server = createCustomServer(prefix, name, configType.toLowerCase(), envValue);
+		if (server) servers.push(server);
+	}
+	return servers;
+}
+/**
+* Create custom server configuration
+*/
+function createCustomServer(prefix, name, type, value) {
+	const envPrefix = `${prefix}CUSTOM_${name.toUpperCase()}_`;
+	switch (type) {
+		case "url": if (process.env[`${envPrefix}TYPE`]?.toLowerCase() === "sse" || value.includes("/sse")) return {
+			name: `custom-${name}`,
+			transport: {
+				type: "sse",
+				url: value,
+				headers: parseHeaders(process.env[`${envPrefix}HEADERS`])
+			}
+		};
+		else {
+			const sessionId = process.env[`${envPrefix}SESSION_ID`];
+			return {
+				name: `custom-${name}`,
+				transport: {
+					type: "http",
+					url: value,
+					sessionId
+				}
+			};
+		}
+		case "command": {
+			const args = process.env[`${envPrefix}ARGS`];
+			return {
+				name: `custom-${name}`,
+				transport: {
+					type: "stdio",
+					command: value,
+					args: args ? args.split(",").map((arg) => arg.trim()) : []
+				}
+			};
+		}
+		case "db": return mcpTransports.sqlite(value);
+		default:
+			logWarn(`Unknown custom server type: ${type} for server: ${name}`, {
+				serverType: type,
+				serverName: name,
+				operation: "mcp_environment_config"
+			});
+			return null;
+	}
+}
+/**
+* Parse headers from environment variable
+*/
+function parseHeaders(headersStr) {
+	if (!headersStr) return void 0;
+	try {
+		return JSON.parse(headersStr);
+	} catch {
+		const headers = {};
+		for (const pair of headersStr.split(",")) {
+			const [key, value] = pair.split("=").map((s) => s.trim());
+			if (key && value) headers[key] = value;
+		}
+		return Object.keys(headers).length > 0 ? headers : void 0;
+	}
+}
+/**
+* Get MCP server configurations with environment discovery
+* This combines explicit configs with environment-discovered servers
+*/
+function getMCPServers(explicitConfigs = [], envConfig = {}) {
+	const discoveredConfigs = discoverMCPServersFromEnvironment(envConfig);
+	const allConfigs = [...explicitConfigs];
+	const explicitNames = new Set(explicitConfigs.map((c) => c.name));
+	for (const discovered of discoveredConfigs) if (!explicitNames.has(discovered.name)) allConfigs.push(discovered);
+	return allConfigs;
+}
+/**
+* Validate environment configuration and provide helpful error messages
+*/
+async function validateMCPEnvironment() {
+	const errors = [];
+	const warnings = [];
+	const recommendations = [];
+	const enabledServers = getEnabledServers("MCP_");
+	if (enabledServers.includes("perplexity") && !process.env.PERPLEXITY_API_KEY) errors.push("Perplexity server enabled but PERPLEXITY_API_KEY not set");
+	if (enabledServers.includes("sqlite") && !process.env.MCP_SQLITE_DB) warnings.push("SQLite server enabled but MCP_SQLITE_DB not set");
+	if (enabledServers.includes("filesystem")) {
+		const fsPath = process.env.MCP_FILESYSTEM_PATH || process.cwd();
+		try {
+			(await import("node:fs")).accessSync(fsPath);
+		} catch {
+			errors.push(`Filesystem server enabled but path not accessible: ${fsPath}`);
+		}
+	}
+	if (enabledServers.length === 0) recommendations.push("Consider enabling at least one MCP server via MCP_SERVERS environment variable");
+	if (!process.env.MCP_SERVERS) recommendations.push("Set MCP_SERVERS to control which servers are enabled (e.g., MCP_SERVERS=filesystem,git)");
+	return {
+		isValid: errors.length === 0,
+		errors,
+		warnings,
+		recommendations
+	};
+}
+
+//#endregion
+export { mcpTransports as a, validateMCPEnvironment as i, environment_exports as n, getMCPServers as r, discoverMCPServersFromEnvironment as t };
+//# sourceMappingURL=environment-CSoJb0SW.mjs.map

package/dist/environment-CSoJb0SW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-CSoJb0SW.mjs","names":[],"sources":["../src/tools/mcp/transports.ts","../src/tools/mcp/environment.ts"],"sourcesContent":["/**\n * @fileoverview transports.ts\n */\n\nimport type { MCPClientConfig } from './client';\n\n/**\n * Pre-configured MCP transports for common use cases\n */\nexport const mcpTransports = {\n  /**\n   * Filesystem MCP server\n   * Allows AI to read/write files in specified directory\n   */\n  filesystem: (rootPath: string = process.cwd()): MCPClientConfig => ({\n    name: 'filesystem',\n    transport: {\n      type: 'stdio',\n      command: 'npx',\n      args: ['-y', '@modelcontextprotocol/server-filesystem', rootPath],\n    },\n  }),\n\n  /**\n   * SQLite MCP server\n   * Allows AI to query SQLite databases\n   */\n  sqlite: (dbPath: string): MCPClientConfig => ({\n    name: 'sqlite',\n    transport: {\n      type: 'stdio',\n      command: 'npx',\n      args: ['-y', '@modelcontextprotocol/server-sqlite', dbPath],\n    },\n  }),\n\n  /**\n   * Git MCP server\n   * Allows AI to read git repository information\n   */\n  git: (repoPath: string = process.cwd()): MCPClientConfig => ({\n    name: 'git',\n    transport: {\n      type: 'stdio',\n      command: 'npx',\n      args: ['-y', '@modelcontextprotocol/server-git', repoPath],\n    },\n  }),\n\n  /**\n   * Custom SSE transport\n   */\n  sse: (name: string, url: string): MCPClientConfig => ({\n    name,\n    transport: {\n      type: 'sse',\n      url,\n    },\n  }),\n\n  /**\n   * Custom stdio transport\n   */\n  stdio: (name: string, command: string, args: string[] = []): MCPClientConfig => ({\n    name,\n    transport: {\n      type: 'stdio',\n      command,\n      args,\n    },\n  }),\n\n  /**\n   * HTTP transport using StreamableHTTPClientTransport\n   */\n  http: (name: string, httpUrl: string, sessionId?: string): MCPClientConfig => ({\n    name,\n    transport: {\n      type: 'http',\n      url: httpUrl,\n      sessionId,\n    },\n  }),\n\n  /**\n   * Perplexity Ask MCP server\n   * Allows AI to perform live web searches using Perplexity's Sonar API\n   * Requires PERPLEXITY_API_KEY environment variable\n   */\n  perplexityAsk: (): MCPClientConfig => ({\n    name: 'perplexity-ask',\n    transport: {\n      type: 'stdio',\n      command: 'npx',\n      // Use locally installed package if available, otherwise download with -y flag\n      args: ['-y', 'server-perplexity-ask'],\n    },\n  }),\n};\n","/**\n * @fileoverview environment.ts\n */\n\nimport { logWarn } from '@repo/shared/logs';\n\nimport { mcpTransports } from './transports';\n\nimport type { MCPClientConfig } from './client';\n\n/**\n * Environment variable patterns for MCP server discovery\n */\nexport interface MCPEnvironmentConfig {\n  /** Environment variable prefix for MCP servers (default: 'MCP_') */\n  prefix?: string;\n  /** Whether to include default servers (filesystem, git, etc.) */\n  includeDefaults?: boolean;\n  /** Base path for filesystem server (default: process.cwd()) */\n  basePath?: string;\n}\n\n/**\n * Parsed MCP server configuration from environment\n */\nexport interface ParsedMCPServer {\n  name: string;\n  type: 'stdio' | 'sse' | 'http';\n  url?: string;\n  command?: string;\n  args?: string[];\n  enabled: boolean;\n}\n\n/**\n * Discover MCP servers from environment variables\n *\n * Environment variable format:\n * - MCP_SERVERS=filesystem,git,perplexity  # Enable specific servers\n * - MCP_FILESYSTEM_PATH=/workspace         # Configure filesystem path\n * - MCP_CUSTOM_SQLITE_DB=/data/app.db      # Configure sqlite database\n * - MCP_CUSTOM_SSE_URL=http://example.com  # Configure SSE server\n * - MCP_CUSTOM_HTTP_URL=http://example.com # Configure HTTP server\n */\nexport function discoverMCPServersFromEnvironment(\n  config: MCPEnvironmentConfig = {},\n): MCPClientConfig[] {\n  const { prefix = 'MCP_', includeDefaults = true, basePath = process.cwd() } = config;\n  const isProduction = process.env.NODE_ENV === 'production';\n  const allowDefaults = !isProduction || process.env[`${prefix}ALLOW_DEFAULTS`] === 'true';\n\n  const servers: MCPClientConfig[] = [];\n  const enabledServers = getEnabledServers(prefix);\n\n  // Add default servers if enabled\n  if (includeDefaults && !allowDefaults) {\n    logWarn('MCP default servers are disabled in production unless MCP_ALLOW_DEFAULTS=true', {\n      operation: 'mcp_default_servers_blocked',\n    });\n  }\n\n  if (includeDefaults && allowDefaults) {\n    if (enabledServers.includes('filesystem')) {\n      const fsPath = process.env[`${prefix}FILESYSTEM_PATH`] || basePath;\n      servers.push(mcpTransports.filesystem(fsPath));\n    }\n\n    if (enabledServers.includes('git')) {\n      const gitPath = process.env[`${prefix}GIT_PATH`] || basePath;\n      servers.push(mcpTransports.git(gitPath));\n    }\n\n    if (enabledServers.includes('perplexity') && process.env.PERPLEXITY_API_KEY) {\n      servers.push(mcpTransports.perplexityAsk());\n    }\n\n    if (enabledServers.includes('sqlite')) {\n      const dbPath = process.env[`${prefix}SQLITE_DB`];\n      if (dbPath) {\n        servers.push(mcpTransports.sqlite(dbPath));\n      }\n    }\n  }\n\n  // Discover custom servers from environment\n  const customServers = discoverCustomServers(prefix, enabledServers);\n  servers.push(...customServers);\n\n  return servers;\n}\n\n/**\n * Get list of enabled servers from environment\n */\nfunction getEnabledServers(prefix: string): string[] {\n  const serversEnv = process.env[`${prefix}SERVERS`];\n  if (!serversEnv) {\n    return [];\n  }\n\n  return serversEnv\n    .split(',')\n    .map(s => s.trim().toLowerCase())\n    .filter(s => s.length > 0);\n}\n\n/**\n * Discover custom MCP servers from environment variables\n */\nfunction discoverCustomServers(prefix: string, enabledServers: string[]): MCPClientConfig[] {\n  const servers: MCPClientConfig[] = [];\n  const processed = new Set<string>();\n\n  // Look for custom server definitions\n  for (const [envKey, envValue] of Object.entries(process.env)) {\n    if (!envKey.startsWith(prefix) || !envValue) continue;\n\n    // Parse pattern: MCP_CUSTOM_<NAME>_<TYPE>\n\n    const match = envKey.match(new RegExp(`^${prefix}CUSTOM_(.+)_(URL|COMMAND|DB)$`));\n    if (!match) continue;\n\n    const [, serverName, configType] = match;\n    if (!serverName || !configType) continue;\n    const name = serverName.toLowerCase();\n\n    // Skip if not enabled\n    if (!enabledServers.includes(name) && !enabledServers.includes('*')) {\n      continue;\n    }\n\n    // Skip if already processed\n    if (processed.has(name)) continue;\n    processed.add(name);\n\n    const server = createCustomServer(prefix, name, configType.toLowerCase(), envValue);\n    if (server) {\n      servers.push(server);\n    }\n  }\n\n  return servers;\n}\n\n/**\n * Create custom server configuration\n */\nfunction createCustomServer(\n  prefix: string,\n  name: string,\n  type: string,\n  value: string,\n): MCPClientConfig | null {\n  const envPrefix = `${prefix}CUSTOM_${name.toUpperCase()}_`;\n\n  switch (type) {\n    case 'url': {\n      // Determine if SSE or HTTP based on URL or explicit type\n      const transportType = process.env[`${envPrefix}TYPE`]?.toLowerCase();\n\n      if (transportType === 'sse' || value.includes('/sse')) {\n        return {\n          name: `custom-${name}`,\n          transport: {\n            type: 'sse',\n            url: value,\n            headers: parseHeaders(process.env[`${envPrefix}HEADERS`]),\n          },\n        };\n      } else {\n        // Default to HTTP transport\n        const sessionId = process.env[`${envPrefix}SESSION_ID`];\n        return {\n          name: `custom-${name}`,\n          transport: {\n            type: 'http',\n            url: value,\n            sessionId,\n          },\n        };\n      }\n    }\n\n    case 'command': {\n      const args = process.env[`${envPrefix}ARGS`];\n      return {\n        name: `custom-${name}`,\n        transport: {\n          type: 'stdio',\n          command: value,\n          args: args ? args.split(',').map(arg => arg.trim()) : [],\n        },\n      };\n    }\n\n    case 'db': {\n      // Assume SQLite for database paths\n      return mcpTransports.sqlite(value);\n    }\n\n    default:\n      logWarn(`Unknown custom server type: ${type} for server: ${name}`, {\n        serverType: type,\n        serverName: name,\n        operation: 'mcp_environment_config',\n      });\n      return null;\n  }\n}\n\n/**\n * Parse headers from environment variable\n */\nfunction parseHeaders(headersStr?: string): Record<string, string> | undefined {\n  if (!headersStr) return undefined;\n\n  try {\n    return JSON.parse(headersStr);\n  } catch {\n    // Try simple key=value,key=value format\n    const headers: Record<string, string> = {};\n    for (const pair of headersStr.split(',')) {\n      const [key, value] = pair.split('=').map(s => s.trim());\n      if (key && value) {\n        headers[key] = value;\n      }\n    }\n    return Object.keys(headers).length > 0 ? headers : undefined;\n  }\n}\n\n/**\n * Get MCP server configurations with environment discovery\n * This combines explicit configs with environment-discovered servers\n */\nexport function getMCPServers(\n  explicitConfigs: MCPClientConfig[] = [],\n  envConfig: MCPEnvironmentConfig = {},\n): MCPClientConfig[] {\n  const discoveredConfigs = discoverMCPServersFromEnvironment(envConfig);\n\n  // Merge explicit and discovered configs, with explicit taking precedence\n  const allConfigs = [...explicitConfigs];\n  const explicitNames = new Set(explicitConfigs.map(c => c.name));\n\n  for (const discovered of discoveredConfigs) {\n    if (!explicitNames.has(discovered.name)) {\n      allConfigs.push(discovered);\n    }\n  }\n\n  return allConfigs;\n}\n\n/**\n * Validate environment configuration and provide helpful error messages\n */\nexport async function validateMCPEnvironment(): Promise<{\n  isValid: boolean;\n  errors: string[];\n  warnings: string[];\n  recommendations: string[];\n}> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const recommendations: string[] = [];\n\n  // Check for required environment variables\n  const enabledServers = getEnabledServers('MCP_');\n\n  if (enabledServers.includes('perplexity') && !process.env.PERPLEXITY_API_KEY) {\n    errors.push('Perplexity server enabled but PERPLEXITY_API_KEY not set');\n  }\n\n  if (enabledServers.includes('sqlite') && !process.env.MCP_SQLITE_DB) {\n    warnings.push('SQLite server enabled but MCP_SQLITE_DB not set');\n  }\n\n  // Check for filesystem access\n  if (enabledServers.includes('filesystem')) {\n    const fsPath = process.env.MCP_FILESYSTEM_PATH || process.cwd();\n    try {\n      // Use dynamic import for Node.js 22 async compatibility\n      const fs = await import('node:fs');\n      fs.accessSync(fsPath);\n    } catch {\n      errors.push(`Filesystem server enabled but path not accessible: ${fsPath}`);\n    }\n  }\n\n  // Provide recommendations\n  if (enabledServers.length === 0) {\n    recommendations.push(\n      'Consider enabling at least one MCP server via MCP_SERVERS environment variable',\n    );\n  }\n\n  if (!process.env.MCP_SERVERS) {\n    recommendations.push(\n      'Set MCP_SERVERS to control which servers are enabled (e.g., MCP_SERVERS=filesystem,git)',\n    );\n  }\n\n  return {\n    isValid: errors.length === 0,\n    errors,\n    warnings,\n    recommendations,\n  };\n}\n"],"mappings":";;;;;;;AASA,MAAa,gBAAgB;CAK3B,aAAa,WAAmB,QAAQ,KAAK,MAAuB;EAClE,MAAM;EACN,WAAW;GACT,MAAM;GACN,SAAS;GACT,MAAM;IAAC;IAAM;IAA2C;IAAS;GAClE;EACF;CAMD,SAAS,YAAqC;EAC5C,MAAM;EACN,WAAW;GACT,MAAM;GACN,SAAS;GACT,MAAM;IAAC;IAAM;IAAuC;IAAO;GAC5D;EACF;CAMD,MAAM,WAAmB,QAAQ,KAAK,MAAuB;EAC3D,MAAM;EACN,WAAW;GACT,MAAM;GACN,SAAS;GACT,MAAM;IAAC;IAAM;IAAoC;IAAS;GAC3D;EACF;CAKD,MAAM,MAAc,SAAkC;EACpD;EACA,WAAW;GACT,MAAM;GACN;GACD;EACF;CAKD,QAAQ,MAAc,SAAiB,OAAiB,EAAE,MAAuB;EAC/E;EACA,WAAW;GACT,MAAM;GACN;GACA;GACD;EACF;CAKD,OAAO,MAAc,SAAiB,eAAyC;EAC7E;EACA,WAAW;GACT,MAAM;GACN,KAAK;GACL;GACD;EACF;CAOD,sBAAuC;EACrC,MAAM;EACN,WAAW;GACT,MAAM;GACN,SAAS;GAET,MAAM,CAAC,MAAM,wBAAwB;GACtC;EACF;CACF;;;;;;;;;;;;;;;;;;;;;;ACtDD,SAAgB,kCACd,SAA+B,EAAE,EACd;CACnB,MAAM,EAAE,SAAS,QAAQ,kBAAkB,MAAM,WAAW,QAAQ,KAAK,KAAK;CAE9E,MAAM,gBAAgB,EADD,QAAQ,IAAI,aAAa,iBACP,QAAQ,IAAI,GAAG,OAAO,qBAAqB;CAElF,MAAM,UAA6B,EAAE;CACrC,MAAM,iBAAiB,kBAAkB,OAAO;AAGhD,KAAI,mBAAmB,CAAC,cACtB,SAAQ,iFAAiF,EACvF,WAAW,+BACZ,CAAC;AAGJ,KAAI,mBAAmB,eAAe;AACpC,MAAI,eAAe,SAAS,aAAa,EAAE;GACzC,MAAM,SAAS,QAAQ,IAAI,GAAG,OAAO,qBAAqB;AAC1D,WAAQ,KAAK,cAAc,WAAW,OAAO,CAAC;;AAGhD,MAAI,eAAe,SAAS,MAAM,EAAE;GAClC,MAAM,UAAU,QAAQ,IAAI,GAAG,OAAO,cAAc;AACpD,WAAQ,KAAK,cAAc,IAAI,QAAQ,CAAC;;AAG1C,MAAI,eAAe,SAAS,aAAa,IAAI,QAAQ,IAAI,mBACvD,SAAQ,KAAK,cAAc,eAAe,CAAC;AAG7C,MAAI,eAAe,SAAS,SAAS,EAAE;GACrC,MAAM,SAAS,QAAQ,IAAI,GAAG,OAAO;AACrC,OAAI,OACF,SAAQ,KAAK,cAAc,OAAO,OAAO,CAAC;;;CAMhD,MAAM,gBAAgB,sBAAsB,QAAQ,eAAe;AACnE,SAAQ,KAAK,GAAG,cAAc;AAE9B,QAAO;;;;;AAMT,SAAS,kBAAkB,QAA0B;CACnD,MAAM,aAAa,QAAQ,IAAI,GAAG,OAAO;AACzC,KAAI,CAAC,WACH,QAAO,EAAE;AAGX,QAAO,WACJ,MAAM,IAAI,CACV,KAAI,MAAK,EAAE,MAAM,CAAC,aAAa,CAAC,CAChC,QAAO,MAAK,EAAE,SAAS,EAAE;;;;;AAM9B,SAAS,sBAAsB,QAAgB,gBAA6C;CAC1F,MAAM,UAA6B,EAAE;CACrC,MAAM,4BAAY,IAAI,KAAa;AAGnC,MAAK,MAAM,CAAC,QAAQ,aAAa,OAAO,QAAQ,QAAQ,IAAI,EAAE;AAC5D,MAAI,CAAC,OAAO,WAAW,OAAO,IAAI,CAAC,SAAU;EAI7C,MAAM,QAAQ,OAAO,MAAM,IAAI,OAAO,IAAI,OAAO,+BAA+B,CAAC;AACjF,MAAI,CAAC,MAAO;EAEZ,MAAM,GAAG,YAAY,cAAc;AACnC,MAAI,CAAC,cAAc,CAAC,WAAY;EAChC,MAAM,OAAO,WAAW,aAAa;AAGrC,MAAI,CAAC,eAAe,SAAS,KAAK,IAAI,CAAC,eAAe,SAAS,IAAI,CACjE;AAIF,MAAI,UAAU,IAAI,KAAK,CAAE;AACzB,YAAU,IAAI,KAAK;EAEnB,MAAM,SAAS,mBAAmB,QAAQ,MAAM,WAAW,aAAa,EAAE,SAAS;AACnF,MAAI,OACF,SAAQ,KAAK,OAAO;;AAIxB,QAAO;;;;;AAMT,SAAS,mBACP,QACA,MACA,MACA,OACwB;CACxB,MAAM,YAAY,GAAG,OAAO,SAAS,KAAK,aAAa,CAAC;AAExD,SAAQ,MAAR;EACE,KAAK,MAIH,KAFsB,QAAQ,IAAI,GAAG,UAAU,QAAQ,aAAa,KAE9C,SAAS,MAAM,SAAS,OAAO,CACnD,QAAO;GACL,MAAM,UAAU;GAChB,WAAW;IACT,MAAM;IACN,KAAK;IACL,SAAS,aAAa,QAAQ,IAAI,GAAG,UAAU,UAAU;IAC1D;GACF;OACI;GAEL,MAAM,YAAY,QAAQ,IAAI,GAAG,UAAU;AAC3C,UAAO;IACL,MAAM,UAAU;IAChB,WAAW;KACT,MAAM;KACN,KAAK;KACL;KACD;IACF;;EAIL,KAAK,WAAW;GACd,MAAM,OAAO,QAAQ,IAAI,GAAG,UAAU;AACtC,UAAO;IACL,MAAM,UAAU;IAChB,WAAW;KACT,MAAM;KACN,SAAS;KACT,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC,KAAI,QAAO,IAAI,MAAM,CAAC,GAAG,EAAE;KACzD;IACF;;EAGH,KAAK,KAEH,QAAO,cAAc,OAAO,MAAM;EAGpC;AACE,WAAQ,+BAA+B,KAAK,eAAe,QAAQ;IACjE,YAAY;IACZ,YAAY;IACZ,WAAW;IACZ,CAAC;AACF,UAAO;;;;;;AAOb,SAAS,aAAa,YAAyD;AAC7E,KAAI,CAAC,WAAY,QAAO;AAExB,KAAI;AACF,SAAO,KAAK,MAAM,WAAW;SACvB;EAEN,MAAM,UAAkC,EAAE;AAC1C,OAAK,MAAM,QAAQ,WAAW,MAAM,IAAI,EAAE;GACxC,MAAM,CAAC,KAAK,SAAS,KAAK,MAAM,IAAI,CAAC,KAAI,MAAK,EAAE,MAAM,CAAC;AACvD,OAAI,OAAO,MACT,SAAQ,OAAO;;AAGnB,SAAO,OAAO,KAAK,QAAQ,CAAC,SAAS,IAAI,UAAU;;;;;;;AAQvD,SAAgB,cACd,kBAAqC,EAAE,EACvC,YAAkC,EAAE,EACjB;CACnB,MAAM,oBAAoB,kCAAkC,UAAU;CAGtE,MAAM,aAAa,CAAC,GAAG,gBAAgB;CACvC,MAAM,gBAAgB,IAAI,IAAI,gBAAgB,KAAI,MAAK,EAAE,KAAK,CAAC;AAE/D,MAAK,MAAM,cAAc,kBACvB,KAAI,CAAC,cAAc,IAAI,WAAW,KAAK,CACrC,YAAW,KAAK,WAAW;AAI/B,QAAO;;;;;AAMT,eAAsB,yBAKnB;CACD,MAAM,SAAmB,EAAE;CAC3B,MAAM,WAAqB,EAAE;CAC7B,MAAM,kBAA4B,EAAE;CAGpC,MAAM,iBAAiB,kBAAkB,OAAO;AAEhD,KAAI,eAAe,SAAS,aAAa,IAAI,CAAC,QAAQ,IAAI,mBACxD,QAAO,KAAK,2DAA2D;AAGzE,KAAI,eAAe,SAAS,SAAS,IAAI,CAAC,QAAQ,IAAI,cACpD,UAAS,KAAK,kDAAkD;AAIlE,KAAI,eAAe,SAAS,aAAa,EAAE;EACzC,MAAM,SAAS,QAAQ,IAAI,uBAAuB,QAAQ,KAAK;AAC/D,MAAI;AAGF,IADW,MAAM,OAAO,YACrB,WAAW,OAAO;UACf;AACN,UAAO,KAAK,sDAAsD,SAAS;;;AAK/E,KAAI,eAAe,WAAW,EAC5B,iBAAgB,KACd,iFACD;AAGH,KAAI,CAAC,QAAQ,IAAI,YACf,iBAAgB,KACd,0FACD;AAGH,QAAO;EACL,SAAS,OAAO,WAAW;EAC3B;EACA;EACA;EACD"}