@kernel.chat/kbot 2.22.3 → 2.23.0

package/dist/handoffs.js

@@ -0,0 +1,257 @@
+// K:BOT Handoff System — Inter-agent routing and context transfer
+//
+// When a specialist agent detects that a query falls outside its domain,
+// it can hand off to a more appropriate specialist. The handoff system:
+//
+//   1. Detects when a handoff is needed (keyword + confidence signals)
+//   2. Builds context for the receiving agent
+//   3. Executes the handoff (calls runAgent with the target agent)
+//   4. Tracks the handoff chain to prevent infinite loops
+//
+// Maximum chain depth: 3 (source → handoff-1 → handoff-2 → handoff-3)
+// Beyond that, the last agent must produce a final response.
+import { SPECIALISTS } from './agents/specialists.js';
+import { printInfo, printWarn } from './ui.js';
+/** Built-in handoff rules — each defines when agent `from` should hand off to agent `to` */
+const HANDOFF_RULES = [
+    // coder → guardian: security concerns in code
+    {
+        from: 'coder',
+        to: 'guardian',
+        triggers: [
+            /\b(vulnerab|exploit|injection|xss|csrf|auth bypass|privilege escalat|security\s+(?:issue|flaw|hole|risk|concern|review|audit))\b/i,
+            /\b(CVE-\d{4}|OWASP|sql\s*inject|command\s*inject|insecure|unsafe\s+deserializ)\b/i,
+            /\b(hardcoded\s+(?:password|secret|key|token|credential))\b/i,
+        ],
+        description: 'Security concern detected in code context',
+    },
+    // coder → aesthete: design / UI questions
+    {
+        from: 'coder',
+        to: 'aesthete',
+        triggers: [
+            /\b(design|layout|UX|UI|user\s*experience|user\s*interface|accessib|a11y)\b/i,
+            /\b(visual|aesthetic|typography|color\s*(?:scheme|palette)|spacing|responsive)\b/i,
+            /\b(animation|transition|hover\s*state|interaction\s*design|wireframe|mockup)\b/i,
+        ],
+        description: 'Design or UI/UX question detected',
+    },
+    // researcher → analyst: data needs strategic interpretation
+    {
+        from: 'researcher',
+        to: 'analyst',
+        triggers: [
+            /\b(strategic|strategy|evaluate|assessment|trade-?off|comparison|pros?\s+(?:and|&|vs)\s+cons?)\b/i,
+            /\b(recommend|decision|choose\s+between|which\s+(?:is|should|would)|cost-?benefit)\b/i,
+            /\b(business\s+impact|ROI|market\s+(?:analysis|position|opportunity))\b/i,
+        ],
+        description: 'Research findings need strategic interpretation',
+    },
+    // any → coder: when response requires code implementation
+    {
+        from: '*',
+        to: 'coder',
+        triggers: [
+            /\b(implement|code\s+(?:this|that|it|up)|write\s+(?:a |the )?(?:function|class|module|component|script))\b/i,
+            /\b(build\s+(?:a |the )?(?:feature|system|api|endpoint|service))\b/i,
+            /\b(fix\s+(?:the |this )?(?:bug|error|issue|crash)|debug|refactor|patch)\b/i,
+            /\b(create\s+(?:a |the )?(?:file|test|migration|hook|util))\b/i,
+        ],
+        description: 'Task requires code implementation',
+    },
+    // any → researcher: when response needs fact-checking or citations
+    {
+        from: '*',
+        to: 'researcher',
+        triggers: [
+            /\b(research|find\s+(?:out|information)|look\s+(?:up|into)|investigate|fact.?check)\b/i,
+            /\b(what\s+(?:is|are|does|do)\s+.{3,}\??|source|citation|reference|evidence)\b/i,
+            /\b(latest|current|recent|up.?to.?date|state\s+of\s+the\s+art)\b/i,
+        ],
+        description: 'Task requires research or fact-checking',
+    },
+    // any → guardian: explicit security requests
+    {
+        from: '*',
+        to: 'guardian',
+        triggers: [
+            /\b(security\s+(?:audit|review|scan|check)|pen\s*test|threat\s+model)\b/i,
+            /\b(harden|secure\s+(?:this|the)|check\s+for\s+vulnerab)\b/i,
+        ],
+        description: 'Explicit security review requested',
+    },
+    // any → writer: content creation requests
+    {
+        from: '*',
+        to: 'writer',
+        triggers: [
+            /\b(write\s+(?:a |the )?(?:blog|article|post|email|newsletter|docs|readme|changelog))\b/i,
+            /\b(draft|compose|summarize|paraphrase|rewrite\s+(?:this|the))\b/i,
+        ],
+        description: 'Content writing task detected',
+    },
+    // any → infrastructure: deployment / DevOps requests
+    {
+        from: '*',
+        to: 'infrastructure',
+        triggers: [
+            /\b(deploy|CI\s*\/?\s*CD|pipeline|docker|kubernetes|k8s|terraform|helm)\b/i,
+            /\b(infrastructure|infra|devops|monitoring|alerting|scaling|load\s*balanc)\b/i,
+        ],
+        description: 'Infrastructure or deployment task detected',
+    },
+];
+/** Maximum depth of handoff chain to prevent infinite loops */
+const MAX_HANDOFF_DEPTH = 3;
+// ── Detection ──
+/**
+ * Analyze if the current agent should hand off to another specialist.
+ * Checks the response and original query against handoff rules.
+ *
+ * Returns a Handoff object if a handoff is recommended, null otherwise.
+ */
+export function detectHandoff(agentId, response, query) {
+    // Combine response and query for analysis
+    const combined = `${query}\n${response}`;
+    // Find matching rules (agent-specific first, then wildcard)
+    let bestMatch = null;
+    for (const rule of HANDOFF_RULES) {
+        // Skip rules that don't apply to this agent
+        if (rule.from !== '*' && rule.from !== agentId)
+            continue;
+        // Don't hand off to yourself
+        if (rule.to === agentId)
+            continue;
+        // Don't hand off to an agent that doesn't exist
+        if (!SPECIALISTS[rule.to])
+            continue;
+        // Count trigger matches
+        const matchCount = rule.triggers.filter(t => t.test(combined)).length;
+        if (matchCount === 0)
+            continue;
+        // Prefer agent-specific rules over wildcards
+        const priority = rule.from === '*' ? matchCount : matchCount + 2;
+        if (!bestMatch || priority > bestMatch.matchCount) {
+            bestMatch = { rule, matchCount: priority };
+        }
+    }
+    // Require at least 1 trigger match for agent-specific rules,
+    // or 2 trigger matches for wildcard rules
+    if (!bestMatch)
+        return null;
+    const isWildcard = bestMatch.rule.from === '*';
+    if (isWildcard && bestMatch.matchCount < 2)
+        return null;
+    return {
+        from: agentId,
+        to: bestMatch.rule.to,
+        reason: bestMatch.rule.description,
+        context: buildHandoffContext('', {
+            from: agentId,
+            to: bestMatch.rule.to,
+            reason: bestMatch.rule.description,
+            context: query,
+            preserveHistory: true,
+        }),
+        preserveHistory: true,
+    };
+}
+// ── Context building ──
+/**
+ * Build the context string for the receiving agent.
+ * Includes a handoff header, the accumulated context, and the reason.
+ */
+export function buildHandoffContext(currentContext, handoff) {
+    const fromAgent = SPECIALISTS[handoff.from];
+    const fromName = fromAgent ? fromAgent.name : handoff.from;
+    const parts = [];
+    parts.push(`[Handoff from ${fromName}]`);
+    parts.push(`Reason: ${handoff.reason}`);
+    if (currentContext) {
+        parts.push('');
+        parts.push('Previous context:');
+        parts.push(currentContext);
+    }
+    if (handoff.context) {
+        parts.push('');
+        parts.push('Handoff context:');
+        parts.push(handoff.context);
+    }
+    return parts.join('\n');
+}
+// ── Execution ──
+/**
+ * Execute a handoff: call runAgent with the target agent and built context.
+ * Tracks the handoff chain and enforces maximum depth.
+ *
+ * The runAgent function is passed as a parameter to avoid circular imports
+ * (agent.ts imports from many modules, and those modules should not import agent.ts).
+ */
+export async function executeHandoff(handoff, query, runAgentFn, chain = []) {
+    // Enforce max depth
+    // chain contains [from, to, from, to, ...] — each handoff adds 2 entries
+    const handoffCount = Math.floor(chain.length / 2);
+    if (handoffCount >= MAX_HANDOFF_DEPTH) {
+        printWarn(`[handoff] Maximum chain depth (${MAX_HANDOFF_DEPTH}) reached: ${chain.join(' -> ')}. ` +
+            `Stopping at ${chain[chain.length - 1]}.`);
+        return {
+            agent: chain[chain.length - 1] || handoff.from,
+            response: `Handoff chain limit reached. The last agent in the chain should provide the final response.`,
+            handoffChain: chain,
+        };
+    }
+    const newChain = [...chain, handoff.from, handoff.to];
+    const toAgent = SPECIALISTS[handoff.to];
+    const toName = toAgent ? toAgent.name : handoff.to;
+    printInfo(`[handoff] ${SPECIALISTS[handoff.from]?.name || handoff.from} -> ${toName}: ${handoff.reason}`);
+    try {
+        // Build prefixed query with handoff context
+        const contextualQuery = handoff.preserveHistory
+            ? `${handoff.context}\n\nUser query: ${query}`
+            : query;
+        const result = await runAgentFn(contextualQuery, {
+            agent: handoff.to,
+        });
+        // Check if the receiving agent also wants to hand off
+        const nextHandoff = detectHandoff(handoff.to, result.content, query);
+        const newHandoffCount = Math.floor(newChain.length / 2);
+        if (nextHandoff && newHandoffCount < MAX_HANDOFF_DEPTH) {
+            // Prevent cycles: don't hand off back to an agent already in the chain
+            if (newChain.includes(nextHandoff.to)) {
+                printInfo(`[handoff] Cycle detected (${nextHandoff.to} already in chain). Stopping.`);
+                return {
+                    agent: handoff.to,
+                    response: result.content,
+                    handoffChain: newChain,
+                };
+            }
+            return executeHandoff(nextHandoff, query, runAgentFn, newChain);
+        }
+        return {
+            agent: handoff.to,
+            response: result.content,
+            handoffChain: newChain,
+        };
+    }
+    catch (err) {
+        printWarn(`[handoff] Failed to hand off to ${toName}: ${err instanceof Error ? err.message : String(err)}`);
+        return {
+            agent: handoff.from,
+            response: `Handoff to ${toName} failed. Continuing with ${SPECIALISTS[handoff.from]?.name || handoff.from}.`,
+            handoffChain: [...chain, handoff.from],
+        };
+    }
+}
+/**
+ * Get all available handoff rules (for diagnostics / UI).
+ */
+export function getHandoffRules() {
+    return HANDOFF_RULES;
+}
+/**
+ * Check if an agent ID is a valid specialist that can participate in handoffs.
+ */
+export function isHandoffTarget(agentId) {
+    return agentId in SPECIALISTS;
+}
+//# sourceMappingURL=handoffs.js.map

package/dist/handoffs.js.map

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

package/dist/marketplace.d.ts

@@ -1,3 +1,4 @@
+import { type MatrixAgent } from './matrix.js';
 export interface RegistryEntry {
     name: string;
     description: string;
@@ -22,4 +23,58 @@ export declare function listInstalled(): InstalledPlugin[];
 export declare function updatePlugin(name: string): Promise<InstalledPlugin | null>;
 export declare function formatRegistryResults(entries: RegistryEntry[]): string;
 export declare function formatInstalledList(plugins: InstalledPlugin[]): string;
+export interface MarketplaceAgentConfig {
+    name: string;
+    icon: string;
+    color: string;
+    systemPrompt: string;
+}
+export interface MarketplaceAgent {
+    id: string;
+    name: string;
+    description: string;
+    author: string;
+    version: string;
+    downloads: number;
+    rating: number;
+    tags: string[];
+    agentConfig: MarketplaceAgentConfig;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface MarketplaceManifest {
+    agents: MarketplaceAgent[];
+    lastUpdated: string;
+}
+export interface InstalledMarketplaceAgent {
+    id: string;
+    name: string;
+    version: string;
+    author: string;
+    installedAt: string;
+}
+/** Fetch the agent marketplace registry. Uses cached version if within TTL, falls back to bundled agents. */
+export declare function fetchRegistry(): Promise<MarketplaceManifest>;
+/** Search marketplace agents by name, description, or tags. */
+export declare function searchMarketplace(query: string): Promise<MarketplaceAgent[]>;
+/** Install a marketplace agent into the local matrix. */
+export declare function installAgent(agentId: string): Promise<MatrixAgent>;
+/** Package a local matrix agent for publishing to the marketplace. Outputs JSON for the user to submit as a PR. */
+export declare function publishAgent(agent: MatrixAgent, opts: {
+    description: string;
+    author: string;
+    version?: string;
+    tags?: string[];
+}): {
+    json: string;
+    filePath: string;
+};
+/** List all marketplace agents installed locally. */
+export declare function listInstalledAgents(): InstalledMarketplaceAgent[];
+/** Uninstall a marketplace agent. Removes from local tracking and the matrix. */
+export declare function uninstallAgent(agentId: string): boolean;
+export declare function formatMarketplaceResults(agents: MarketplaceAgent[]): string;
+export declare function formatInstalledAgentsList(agents: InstalledMarketplaceAgent[]): string;
+/** Register marketplace tools so the agent can search and install marketplace agents during conversations. */
+export declare function registerMarketplaceTools(): void;
 //# sourceMappingURL=marketplace.d.ts.map

package/dist/marketplace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../src/marketplace.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb;AA6CD,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAqB3E;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAU/E;AAwGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA6BrD;AAED,wBAAgB,aAAa,IAAI,eAAe,EAAE,CAEjD;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAoFhF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAuBtE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAgCtE"}
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../src/marketplace.ts"],"names":[],"mappings":"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"}