@chaaskit/server 0.1.0

package/dist/services/agents.js

@@ -0,0 +1,194 @@
+import { getConfig } from '../config/loader.js';
+import { getNativeToolsForAgent } from '../tools/index.js';
+/**
+ * Check if config is multi-agent (has 'agents' array)
+ */
+function isMultiAgentConfig(config) {
+    return 'agents' in config && Array.isArray(config.agents);
+}
+/**
+ * Check if agent definition is external type
+ */
+export function isExternalAgent(agent) {
+    return 'type' in agent && agent.type === 'external';
+}
+/**
+ * Check if agent definition is built-in type
+ */
+export function isBuiltInAgent(agent) {
+    return !('type' in agent) || agent.type !== 'external';
+}
+/**
+ * Normalize configuration to always return array of AgentDefinitions.
+ * Handles both legacy single-agent config and new multi-agent config.
+ */
+export function getAgentDefinitions() {
+    const config = getConfig().agent;
+    // Multi-agent config
+    if (isMultiAgentConfig(config)) {
+        return config.agents;
+    }
+    // Legacy single-agent: built-in
+    if (config.type === 'built-in') {
+        return [
+            {
+                id: 'default',
+                name: 'AI Assistant',
+                provider: config.provider,
+                model: config.model,
+                systemPrompt: config.systemPrompt,
+                maxTokens: config.maxTokens,
+                isDefault: true,
+            },
+        ];
+    }
+    // Legacy single-agent: external
+    if (config.type === 'external') {
+        return [
+            {
+                id: 'default',
+                name: 'AI Assistant',
+                type: 'external',
+                endpoint: config.endpoint,
+                headers: config.headers,
+                isDefault: true,
+            },
+        ];
+    }
+    // Fallback - should not happen with proper TypeScript types
+    throw new Error('Invalid agent configuration');
+}
+/**
+ * Get a specific agent by ID.
+ * Returns default agent if ID is null/undefined.
+ */
+export function getAgentById(agentId) {
+    const agents = getAgentDefinitions();
+    if (!agentId) {
+        // Return the default agent
+        const defaultAgent = agents.find((a) => a.isDefault);
+        return defaultAgent || agents[0];
+    }
+    return agents.find((a) => a.id === agentId);
+}
+/**
+ * Get the default agent.
+ */
+export function getDefaultAgent() {
+    const agents = getAgentDefinitions();
+    const defaultAgent = agents.find((a) => a.isDefault);
+    return defaultAgent || agents[0];
+}
+/**
+ * Get agents available for a user's plan.
+ * If agent has no plans restriction, it's available to all.
+ */
+export function getAgentsForPlan(userPlan) {
+    const agents = getAgentDefinitions();
+    const plan = userPlan || 'free';
+    return agents.filter((agent) => {
+        // No plans restriction = available to all
+        if (!agent.plans || agent.plans.length === 0) {
+            return true;
+        }
+        // Check if user's plan is in allowed plans
+        return agent.plans.includes(plan);
+    });
+}
+/**
+ * Check if a user can access a specific agent based on their plan.
+ */
+export function canAccessAgent(agentId, userPlan) {
+    const agent = getAgentById(agentId);
+    if (!agent)
+        return false;
+    // No plans restriction = available to all
+    if (!agent.plans || agent.plans.length === 0) {
+        return true;
+    }
+    const plan = userPlan || 'free';
+    return agent.plans.includes(plan);
+}
+/**
+ * Check if a tool matches an allowed pattern.
+ *
+ * Pattern syntax:
+ * - 'server:*' - All tools from a server (including 'native:*')
+ * - 'server:tool-name' - Specific tool (e.g., 'native:web-scrape')
+ */
+function toolMatchesPattern(tool, pattern) {
+    const toolId = `${tool.serverId}:${tool.name}`;
+    // Wildcard pattern: 'server:*'
+    if (pattern.endsWith(':*')) {
+        const serverId = pattern.slice(0, -2);
+        return tool.serverId === serverId;
+    }
+    // Exact match: 'server:tool-name'
+    return pattern === toolId;
+}
+/**
+ * Filter tools (MCP or native) based on agent's allowedTools configuration.
+ *
+ * Tool pattern syntax:
+ * - 'server:*' - All tools from a server (e.g., 'native:*' for all native tools)
+ * - 'server:tool-name' - Specific tool (e.g., 'native:web-scrape')
+ * - No allowedTools = no tools available (opt-in model)
+ */
+export function filterToolsForAgent(agentId, tools) {
+    const agent = getAgentById(agentId);
+    // No agent found or no tool restrictions - return empty (opt-in model)
+    if (!agent?.allowedTools || agent.allowedTools.length === 0) {
+        // For backward compatibility: if no allowedTools specified, allow all MCP tools but no native tools
+        return tools.filter((tool) => tool.serverId !== 'native');
+    }
+    return tools.filter((tool) => {
+        return agent.allowedTools.some((pattern) => toolMatchesPattern(tool, pattern));
+    });
+}
+/**
+ * Get native tools available for an agent based on allowedTools config.
+ * Native tools are opt-in: only available if explicitly listed.
+ */
+export function getNativeToolsForAgentFiltered(agentId) {
+    const agent = getAgentById(agentId);
+    const allNativeTools = getNativeToolsForAgent();
+    // No allowedTools = no native tools (opt-in model)
+    if (!agent?.allowedTools || agent.allowedTools.length === 0) {
+        return [];
+    }
+    return allNativeTools.filter((tool) => {
+        return agent.allowedTools.some((pattern) => toolMatchesPattern(tool, pattern));
+    });
+}
+/**
+ * Convert an AgentDefinition to the legacy AgentConfig format
+ * for use with createAgentService.
+ */
+export function toAgentConfig(agent) {
+    if (isExternalAgent(agent)) {
+        return {
+            type: 'external',
+            endpoint: agent.endpoint,
+            headers: agent.headers,
+        };
+    }
+    // Built-in agent
+    return {
+        type: 'built-in',
+        provider: agent.provider,
+        model: agent.model,
+        systemPrompt: agent.systemPrompt,
+        maxTokens: agent.maxTokens,
+    };
+}
+/**
+ * Get agent info suitable for client response (excludes sensitive data).
+ */
+export function getAgentClientInfo(agent) {
+    return {
+        id: agent.id,
+        name: agent.name,
+        isDefault: agent.isDefault,
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/services/agents.js.map

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