Files
waggle-os/packages/agent/src/capability-router.ts
Oleg Maslov 0c3e2ead3b
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled
moving
2026-09-02 10:10:29 +02:00

187 lines
6.3 KiB
TypeScript

export type CapabilitySource = 'native' | 'skill' | 'plugin' | 'mcp' | 'subagent' | 'connector' | 'missing';
export interface CapabilityRoute {
source: CapabilitySource;
name: string;
confidence: number;
description: string;
available: boolean;
suggestion?: string;
}
export interface ConnectorInfo {
id: string;
name: string;
service: string;
connected: boolean;
actions: string[];
}
export interface CapabilityRouterDeps {
/** Currently registered tool names */
toolNames: string[];
/** Installed skill names and their content (for keyword matching) */
skills: Array<{ name: string; content: string }>;
/** Installed plugin manifests */
plugins: Array<{
name: string;
description: string;
skills?: string[];
mcpServers?: Array<{ name: string }>;
}>;
/** Configured MCP server names */
mcpServers: string[];
/** Available sub-agent role presets */
subAgentRoles: string[];
/** Optional MCP runtime for health-aware resolution */
mcpRuntime?: { isServerHealthy(name: string): boolean };
/** Registered connectors with connection status */
connectors?: ConnectorInfo[];
}
const ROLE_KEYWORDS: Record<string, string[]> = {
researcher: ['research', 'investigate', 'find', 'lookup', 'search'],
writer: ['write', 'draft', 'compose', 'author', 'document'],
coder: ['code', 'implement', 'program', 'develop', 'build'],
analyst: ['analyze', 'data', 'statistics', 'metrics', 'report'],
reviewer: ['review', 'audit', 'check', 'inspect', 'evaluate'],
planner: ['plan', 'strategy', 'roadmap', 'schedule', 'organize'],
};
export class CapabilityRouter {
private deps: CapabilityRouterDeps;
constructor(deps: CapabilityRouterDeps) {
this.deps = deps;
}
resolve(query: string): CapabilityRoute[] {
const routes: CapabilityRoute[] = [];
const q = query.toLowerCase();
// 1. Native tools — exact or partial match
for (const toolName of this.deps.toolNames) {
const tl = toolName.toLowerCase();
if (tl === q) {
routes.push({
source: 'native',
name: toolName,
confidence: 1.0,
description: `Native tool "${toolName}" (exact match)`,
available: true,
});
} else if (tl.includes(q) || q.includes(tl)) {
routes.push({
source: 'native',
name: toolName,
confidence: 0.8,
description: `Native tool "${toolName}" (partial match)`,
available: true,
});
}
}
// 1.5. Connectors — service, ID, or action name match (confidence 0.75)
if (this.deps.connectors) {
for (const connector of this.deps.connectors) {
const idLower = connector.id.toLowerCase();
const serviceLower = connector.service.toLowerCase();
const nameLower = connector.name.toLowerCase();
const nameMatch = q.includes(idLower) || q.includes(serviceLower) || q.includes(nameLower);
const actionMatch = connector.actions.some(a => q.includes(a.toLowerCase().replace(/_/g, ' ')));
if (nameMatch || actionMatch) {
routes.push({
source: 'connector',
name: connector.id,
confidence: 0.75,
description: `Connector "${connector.name}" (${connector.service})`,
available: connector.connected,
suggestion: connector.connected
? undefined
: `${connector.name} connector is available but not connected. Add your credentials in Cockpit > Connectors to enable it.`,
});
}
}
}
// 2. Skills — name or content keyword match
for (const skill of this.deps.skills) {
const nameMatch = skill.name.toLowerCase().includes(q) || q.includes(skill.name.toLowerCase());
const contentMatch = skill.content.toLowerCase().includes(q);
if (nameMatch || contentMatch) {
routes.push({
source: 'skill',
name: skill.name,
confidence: nameMatch ? 0.7 : 0.5,
description: `Skill "${skill.name}" ${nameMatch ? '(name match)' : '(content match)'}`,
available: true,
});
}
}
// 3. Plugins — description or skill list match
for (const plugin of this.deps.plugins) {
const descMatch = plugin.description.toLowerCase().includes(q);
const skillMatch = plugin.skills?.some(s => s.toLowerCase().includes(q) || q.includes(s.toLowerCase()));
if (descMatch || skillMatch) {
routes.push({
source: 'plugin',
name: plugin.name,
confidence: 0.6,
description: `Plugin "${plugin.name}" — ${plugin.description}`,
available: true,
});
}
}
// 4. MCP servers — name match (health-aware when runtime is available)
for (const server of this.deps.mcpServers) {
if (server.toLowerCase().includes(q) || q.includes(server.toLowerCase())) {
const healthy = this.deps.mcpRuntime
? this.deps.mcpRuntime.isServerHealthy(server)
: true; // assume available when no runtime to check
routes.push({
source: 'mcp',
name: server,
confidence: 0.45,
description: `MCP server "${server}" ${healthy ? 'may provide this capability' : '(not healthy)'}`,
available: healthy,
});
}
}
// 5. Sub-agent roles — keyword mapping
for (const role of this.deps.subAgentRoles) {
const keywords = ROLE_KEYWORDS[role.toLowerCase()] ?? [];
const roleMatches = keywords.some(kw => q.includes(kw)) || q.includes(role.toLowerCase());
if (roleMatches) {
routes.push({
source: 'subagent',
name: role,
confidence: 0.4,
description: `Sub-agent role "${role}" can handle this type of task`,
available: true,
});
}
}
// Sort by confidence descending
routes.sort((a, b) => b.confidence - a.confidence);
// 6. If nothing matched, return missing
if (routes.length === 0) {
routes.push({
source: 'missing',
name: query,
confidence: 0,
description: `No capability found for "${query}"`,
available: false,
suggestion: `Consider creating a skill for "${query}", connecting a service in Cockpit > Connectors, or searching the marketplace for a plugin.`,
});
}
return routes;
}
}