@kernel.chat/kbot 3.10.0 → 3.11.0

package/dist/a2a-client.d.ts

@@ -0,0 +1,162 @@
+import { delegateTask, listRemoteAgents, removeRemoteAgent, findAgentBySkill, type AgentCard, type A2ATask, type A2ATaskStatus, type A2AMessage, type A2APart, type RemoteAgent } from './a2a.js';
+export type { AgentCard, A2ATask, A2ATaskStatus, A2AMessage, A2APart, RemoteAgent, };
+interface TaskHistoryEntry {
+    id: string;
+    agentUrl: string;
+    agentName?: string;
+    prompt: string;
+    status: A2ATaskStatus['state'];
+    result?: string;
+    createdAt: string;
+    completedAt?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Generate kbot's Agent Card JSON with all specialists as skills.
+ *
+ * @param endpointUrl - The URL where this kbot instance is reachable.
+ *                      Defaults to http://localhost:7437.
+ * @returns A fully populated AgentCard per the A2A v0.3 spec.
+ */
+export declare function generateAgentCard(endpointUrl?: string): AgentCard;
+/**
+ * Discover a remote A2A agent by fetching its Agent Card from
+ * `<url>/.well-known/agent.json`.
+ *
+ * The discovered agent is persisted in the local registry at
+ * `~/.kbot/a2a-registry.json` for future lookups.
+ *
+ * @param url - Base URL of the remote agent (e.g. "http://other-agent:8080")
+ * @returns The agent's card, or null if discovery fails.
+ */
+export declare function discoverAgent(url: string): Promise<AgentCard | null>;
+export interface SendTaskOptions {
+    /** Hint which specialist agent should handle the task */
+    agent?: string;
+    /** Additional metadata to attach to the task */
+    metadata?: Record<string, unknown>;
+    /** Auth token for the remote agent (Bearer) */
+    token?: string;
+    /** Whether to wait for completion (sync) or return immediately (async).
+     *  Defaults to true (synchronous). */
+    sync?: boolean;
+    /** Timeout in milliseconds. Defaults to 120_000 (2 min). */
+    timeoutMs?: number;
+}
+/**
+ * Send a task to a remote A2A agent.
+ *
+ * By default this is synchronous — it waits for the remote agent to complete
+ * the task and returns the result. Set `options.sync = false` to submit
+ * asynchronously (returns immediately with a submitted-state task).
+ *
+ * @param agentUrl - Base URL of the remote agent
+ * @param task - The prompt text or a structured A2AMessage
+ * @param options - Execution options
+ * @returns The task result, including id, status, and response text
+ */
+export declare function sendTask(agentUrl: string, task: string | {
+    prompt: string;
+}, options?: SendTaskOptions): Promise<{
+    id: string;
+    status: A2ATaskStatus['state'];
+    text: string | null;
+    metadata: Record<string, unknown>;
+}>;
+/**
+ * Check the status and result of a previously submitted task.
+ *
+ * @param agentUrl - Base URL of the remote agent
+ * @param taskId - The task ID returned by sendTask
+ * @param options - Optional auth token
+ * @returns Current task state and any available result
+ */
+export declare function getTaskStatus(agentUrl: string, taskId: string, options?: {
+    token?: string;
+}): Promise<{
+    id: string;
+    status: A2ATaskStatus['state'];
+    message?: string;
+    text: string | null;
+    metadata: Record<string, unknown>;
+}>;
+/**
+ * Cancel a running task on a remote agent.
+ *
+ * @param agentUrl - Base URL of the remote agent
+ * @param taskId - The task ID to cancel
+ * @param options - Optional auth token
+ * @returns true if the task was canceled, false if it was already terminal
+ */
+export declare function cancelTask(agentUrl: string, taskId: string, options?: {
+    token?: string;
+}): Promise<boolean>;
+/**
+ * Handle an incoming A2A task received by this kbot instance.
+ *
+ * Routes the task to the appropriate specialist agent based on metadata
+ * hints or automatic intent classification, executes it through kbot's
+ * agent system, and returns the completed task.
+ *
+ * This is used internally by the A2A server but is exported for
+ * programmatic use (e.g., SDK consumers, custom servers).
+ *
+ * @param task - The incoming task with a user message
+ * @returns The task with result populated and status set to completed/failed
+ */
+export declare function handleIncomingTask(task: {
+    message: A2AMessage;
+    metadata?: Record<string, unknown>;
+}): Promise<{
+    id: string;
+    status: A2ATaskStatus['state'];
+    text: string | null;
+    metadata: Record<string, unknown>;
+}>;
+/**
+ * List all discovered remote agents from the local registry.
+ */
+export { listRemoteAgents, removeRemoteAgent, findAgentBySkill };
+/**
+ * Delegate a task to a remote agent (convenience wrapper around sendTask
+ * that matches the existing delegateTask signature in a2a.ts).
+ */
+export { delegateTask };
+/**
+ * Get the local task history (tasks sent to remote agents).
+ */
+export declare function getTaskHistory(): TaskHistoryEntry[];
+/**
+ * Clear the local task history.
+ */
+export declare function clearTaskHistory(): void;
+export interface CollaborationPlan {
+    steps: {
+        agentUrl: string;
+        agentName?: string;
+        prompt: string;
+        dependsOn?: number[];
+    }[];
+}
+/**
+ * Execute a multi-step collaboration plan across multiple A2A agents.
+ *
+ * Steps without dependencies run in parallel. Steps with `dependsOn`
+ * wait for their dependencies to complete and inject their results
+ * into the prompt using `{{step:N}}` placeholders.
+ *
+ * @param plan - The collaboration plan
+ * @param options - Auth tokens keyed by agent URL
+ * @returns Results for each step
+ */
+export declare function collaborate(plan: CollaborationPlan, options?: {
+    tokens?: Record<string, string>;
+}): Promise<{
+    results: {
+        stepIndex: number;
+        agentUrl: string;
+        status: A2ATaskStatus['state'];
+        text: string | null;
+    }[];
+}>;
+//# sourceMappingURL=a2a-client.d.ts.map

package/dist/a2a-client.d.ts.map

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

package/dist/a2a-client.js

@@ -0,0 +1,376 @@
+// kbot A2A Client — Agent-to-Agent protocol client (v0.3)
+//
+// Discovers remote A2A agents, sends tasks, tracks lifecycle, cancels work.
+// Complements a2a.ts which provides the server side + Agent Card generation.
+//
+// Usage:
+//   import { discoverAgent, sendTask, getTaskStatus, cancelTask } from './a2a-client.js'
+//   const card = await discoverAgent('http://other-agent:8080')
+//   const task = await sendTask('http://other-agent:8080', { prompt: 'Summarize this repo' })
+//   const status = await getTaskStatus('http://other-agent:8080', task.id)
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { buildAgentCard, discoverAgent as discoverAgentCore, delegateTask, listRemoteAgents, removeRemoteAgent, findAgentBySkill, } from './a2a.js';
+// ── Constants ──
+const KBOT_DIR = join(homedir(), '.kbot');
+const TASK_HISTORY_PATH = join(KBOT_DIR, 'a2a-task-history.json');
+const DEFAULT_TIMEOUT_MS = 120_000; // 2 minutes
+const DISCOVERY_TIMEOUT_MS = 10_000; // 10 seconds
+function loadTaskHistory() {
+    try {
+        if (!existsSync(TASK_HISTORY_PATH))
+            return [];
+        return JSON.parse(readFileSync(TASK_HISTORY_PATH, 'utf-8'));
+    }
+    catch {
+        return [];
+    }
+}
+function saveTaskHistory(history) {
+    if (!existsSync(KBOT_DIR))
+        mkdirSync(KBOT_DIR, { recursive: true });
+    // Keep last 500 entries
+    const trimmed = history.slice(-500);
+    writeFileSync(TASK_HISTORY_PATH, JSON.stringify(trimmed, null, 2));
+}
+function recordTask(entry) {
+    const history = loadTaskHistory();
+    // Update existing or append
+    const idx = history.findIndex(h => h.id === entry.id);
+    if (idx >= 0) {
+        history[idx] = entry;
+    }
+    else {
+        history.push(entry);
+    }
+    saveTaskHistory(history);
+}
+// ── Agent Card Generator ──
+/**
+ * Generate kbot's Agent Card JSON with all specialists as skills.
+ *
+ * @param endpointUrl - The URL where this kbot instance is reachable.
+ *                      Defaults to http://localhost:7437.
+ * @returns A fully populated AgentCard per the A2A v0.3 spec.
+ */
+export function generateAgentCard(endpointUrl) {
+    return buildAgentCard(endpointUrl);
+}
+// ── Discovery ──
+/**
+ * Discover a remote A2A agent by fetching its Agent Card from
+ * `<url>/.well-known/agent.json`.
+ *
+ * The discovered agent is persisted in the local registry at
+ * `~/.kbot/a2a-registry.json` for future lookups.
+ *
+ * @param url - Base URL of the remote agent (e.g. "http://other-agent:8080")
+ * @returns The agent's card, or null if discovery fails.
+ */
+export async function discoverAgent(url) {
+    return discoverAgentCore(url);
+}
+/**
+ * Send a task to a remote A2A agent.
+ *
+ * By default this is synchronous — it waits for the remote agent to complete
+ * the task and returns the result. Set `options.sync = false` to submit
+ * asynchronously (returns immediately with a submitted-state task).
+ *
+ * @param agentUrl - Base URL of the remote agent
+ * @param task - The prompt text or a structured A2AMessage
+ * @param options - Execution options
+ * @returns The task result, including id, status, and response text
+ */
+export async function sendTask(agentUrl, task, options = {}) {
+    const prompt = typeof task === 'string' ? task : task.prompt;
+    const sync = options.sync !== false;
+    const timeout = options.timeoutMs || DEFAULT_TIMEOUT_MS;
+    const baseUrl = agentUrl.replace(/\/$/, '');
+    const taskUrl = `${baseUrl}/a2a/tasks${sync ? '?sync=true' : ''}`;
+    const body = {
+        message: {
+            role: 'user',
+            parts: [{ type: 'text', text: prompt }],
+        },
+    };
+    if (options.agent || options.metadata) {
+        body.metadata = { ...options.metadata, agent: options.agent };
+    }
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (options.token) {
+        headers['Authorization'] = `Bearer ${options.token}`;
+    }
+    const response = await fetch(taskUrl, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(timeout),
+    });
+    if (!response.ok) {
+        const errText = await response.text().catch(() => 'Unknown error');
+        throw new Error(`A2A task submission failed (${response.status}): ${errText}`);
+    }
+    const result = await response.json();
+    const text = result.result?.parts
+        ?.filter((p) => p.type === 'text')
+        .map(p => p.text)
+        .join('\n') ?? null;
+    // Record in local history
+    recordTask({
+        id: result.id,
+        agentUrl,
+        prompt,
+        status: result.status.state,
+        result: text ?? undefined,
+        createdAt: new Date().toISOString(),
+        completedAt: result.status.state === 'completed' ? new Date().toISOString() : undefined,
+        metadata: result.metadata,
+    });
+    return {
+        id: result.id,
+        status: result.status.state,
+        text,
+        metadata: result.metadata || {},
+    };
+}
+/**
+ * Check the status and result of a previously submitted task.
+ *
+ * @param agentUrl - Base URL of the remote agent
+ * @param taskId - The task ID returned by sendTask
+ * @param options - Optional auth token
+ * @returns Current task state and any available result
+ */
+export async function getTaskStatus(agentUrl, taskId, options = {}) {
+    const baseUrl = agentUrl.replace(/\/$/, '');
+    const url = `${baseUrl}/a2a/tasks/${taskId}`;
+    const headers = {
+        'Accept': 'application/json',
+    };
+    if (options.token) {
+        headers['Authorization'] = `Bearer ${options.token}`;
+    }
+    const response = await fetch(url, {
+        headers,
+        signal: AbortSignal.timeout(DISCOVERY_TIMEOUT_MS),
+    });
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error(`Task ${taskId} not found on ${agentUrl}`);
+        }
+        throw new Error(`Failed to get task status (${response.status})`);
+    }
+    const result = await response.json();
+    const text = result.result?.parts
+        ?.filter((p) => p.type === 'text')
+        .map(p => p.text)
+        .join('\n') ?? null;
+    // Update local history
+    recordTask({
+        id: result.id,
+        agentUrl,
+        prompt: '(status check)',
+        status: result.status.state,
+        result: text ?? undefined,
+        createdAt: new Date().toISOString(),
+        completedAt: result.status.state === 'completed' ? new Date().toISOString() : undefined,
+        metadata: result.metadata,
+    });
+    return {
+        id: result.id,
+        status: result.status.state,
+        message: result.status.message,
+        text,
+        metadata: result.metadata || {},
+    };
+}
+/**
+ * Cancel a running task on a remote agent.
+ *
+ * @param agentUrl - Base URL of the remote agent
+ * @param taskId - The task ID to cancel
+ * @param options - Optional auth token
+ * @returns true if the task was canceled, false if it was already terminal
+ */
+export async function cancelTask(agentUrl, taskId, options = {}) {
+    const baseUrl = agentUrl.replace(/\/$/, '');
+    const url = `${baseUrl}/a2a/tasks/${taskId}/cancel`;
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (options.token) {
+        headers['Authorization'] = `Bearer ${options.token}`;
+    }
+    const response = await fetch(url, {
+        method: 'POST',
+        headers,
+        signal: AbortSignal.timeout(DISCOVERY_TIMEOUT_MS),
+    });
+    if (response.status === 409) {
+        // Task already in terminal state
+        return false;
+    }
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error(`Task ${taskId} not found on ${agentUrl}`);
+        }
+        throw new Error(`Failed to cancel task (${response.status})`);
+    }
+    return true;
+}
+// ── Incoming Task Handling ──
+/**
+ * Handle an incoming A2A task received by this kbot instance.
+ *
+ * Routes the task to the appropriate specialist agent based on metadata
+ * hints or automatic intent classification, executes it through kbot's
+ * agent system, and returns the completed task.
+ *
+ * This is used internally by the A2A server but is exported for
+ * programmatic use (e.g., SDK consumers, custom servers).
+ *
+ * @param task - The incoming task with a user message
+ * @returns The task with result populated and status set to completed/failed
+ */
+export async function handleIncomingTask(task) {
+    const agentModule = await import('./agent.js');
+    const runAgent = agentModule.runAgent;
+    const text = task.message.parts
+        .filter((p) => p.type === 'text')
+        .map(p => p.text)
+        .join('\n');
+    if (!text) {
+        return {
+            id: 'inline-' + Date.now(),
+            status: 'failed',
+            text: null,
+            metadata: { error: 'No text content in message' },
+        };
+    }
+    const agentOpts = {};
+    if (task.metadata?.agent && typeof task.metadata.agent === 'string') {
+        agentOpts.agent = task.metadata.agent;
+    }
+    try {
+        const response = await runAgent(text, agentOpts);
+        return {
+            id: 'inline-' + Date.now(),
+            status: 'completed',
+            text: response.content,
+            metadata: {
+                ...task.metadata,
+                agentUsed: response.agent,
+                model: response.model,
+                toolCalls: response.toolCalls,
+                usage: response.usage,
+            },
+        };
+    }
+    catch (err) {
+        return {
+            id: 'inline-' + Date.now(),
+            status: 'failed',
+            text: null,
+            metadata: {
+                ...task.metadata,
+                error: err instanceof Error ? err.message : 'Task execution failed',
+            },
+        };
+    }
+}
+// ── Convenience / Registry ──
+/**
+ * List all discovered remote agents from the local registry.
+ */
+export { listRemoteAgents, removeRemoteAgent, findAgentBySkill };
+/**
+ * Delegate a task to a remote agent (convenience wrapper around sendTask
+ * that matches the existing delegateTask signature in a2a.ts).
+ */
+export { delegateTask };
+/**
+ * Get the local task history (tasks sent to remote agents).
+ */
+export function getTaskHistory() {
+    return loadTaskHistory();
+}
+/**
+ * Clear the local task history.
+ */
+export function clearTaskHistory() {
+    if (existsSync(TASK_HISTORY_PATH)) {
+        writeFileSync(TASK_HISTORY_PATH, '[]');
+    }
+}
+/**
+ * Execute a multi-step collaboration plan across multiple A2A agents.
+ *
+ * Steps without dependencies run in parallel. Steps with `dependsOn`
+ * wait for their dependencies to complete and inject their results
+ * into the prompt using `{{step:N}}` placeholders.
+ *
+ * @param plan - The collaboration plan
+ * @param options - Auth tokens keyed by agent URL
+ * @returns Results for each step
+ */
+export async function collaborate(plan, options = {}) {
+    const results = new Map();
+    const pending = new Set(plan.steps.map((_, i) => i));
+    while (pending.size > 0) {
+        // Find steps whose dependencies are all resolved
+        const ready = [];
+        for (const idx of pending) {
+            const step = plan.steps[idx];
+            const deps = step.dependsOn || [];
+            if (deps.every(d => results.has(d))) {
+                ready.push(idx);
+            }
+        }
+        if (ready.length === 0) {
+            // Deadlock — remaining steps have unresolvable dependencies
+            for (const idx of pending) {
+                results.set(idx, { status: 'failed', text: 'Deadlock: unresolvable dependencies' });
+            }
+            break;
+        }
+        // Execute ready steps in parallel
+        const executions = ready.map(async (idx) => {
+            const step = plan.steps[idx];
+            pending.delete(idx);
+            // Substitute dependency results into prompt
+            let prompt = step.prompt;
+            for (const depIdx of step.dependsOn || []) {
+                const depResult = results.get(depIdx);
+                const placeholder = `{{step:${depIdx}}}`;
+                prompt = prompt.replace(placeholder, depResult?.text || '(no result)');
+            }
+            try {
+                const result = await sendTask(step.agentUrl, prompt, {
+                    token: options.tokens?.[step.agentUrl],
+                    sync: true,
+                });
+                results.set(idx, { status: result.status, text: result.text });
+            }
+            catch (err) {
+                results.set(idx, {
+                    status: 'failed',
+                    text: err instanceof Error ? err.message : 'Collaboration step failed',
+                });
+            }
+        });
+        await Promise.all(executions);
+    }
+    return {
+        results: plan.steps.map((step, idx) => ({
+            stepIndex: idx,
+            agentUrl: step.agentUrl,
+            status: results.get(idx)?.status || 'failed',
+            text: results.get(idx)?.text || null,
+        })),
+    };
+}
+//# sourceMappingURL=a2a-client.js.map

package/dist/a2a-client.js.map

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

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,YAAY,EAIb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAe1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAA8E,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAChI,OAAO,EAAiD,cAAc,EAAoB,MAAM,gBAAgB,CAAA;AAUhH,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAsElF,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+EAA+E;IAC/E,EAAE,CAAC,EAAE,SAAS,CAAA;IACd,uFAAuF;IACvF,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1E;AA+qBD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CA22BxB;AAGD,6CAA6C;AAC7C,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAkEf;AAGD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAgCxB"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,YAAY,EAIb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAe1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAA8E,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAChI,OAAO,EAAiD,cAAc,EAAoB,MAAM,gBAAgB,CAAA;AAUhH,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAuElF,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+EAA+E;IAC/E,EAAE,CAAC,EAAE,SAAS,CAAA;IACd,uFAAuF;IACvF,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1E;AA+qBD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CA44BxB;AAGD,6CAA6C;AAC7C,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAkEf;AAGD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAgCxB"}

package/dist/agent.js

@@ -47,6 +47,7 @@ import { StrangeLoopDetector } from './strange-loops.js';
 import { IntegrationMeter } from './integrated-information.js';
 import { generateReflections, getRelevantReflections, formatReflectionsForPrompt, isUserRejection } from './reflection.js';
 import { getSynthesisContext } from './memory-synthesis.js';
+import { recordTrace, shouldEvolve, evolvePrompt, getPromptAmendment, updateMutationScore } from './prompt-evolution.js';
 const MAX_TOOL_LOOPS = 75;
 /** Maximum cumulative cost (USD) before auto-stopping tool loops */
 const MAX_COST_CEILING = 1.00;
@@ -934,6 +935,12 @@ Always quote file paths that contain spaces. Never reference internal system nam
     });
     const provider = byokProvider || 'anthropic';
     let { text: systemContext } = buildCacheablePrompt(promptSections, provider);
+    // Prompt evolution: inject evolved instructions for this agent (GEPA)
+    const activeAgent = options.agent || 'kernel';
+    const promptAmendment = getPromptAmendment(activeAgent);
+    if (promptAmendment) {
+        systemContext += promptAmendment;
+    }
     // Plan mode: append read-only instruction to system prompt
     if (options.plan) {
         systemContext += '\n\n## PLAN MODE\n\nYou are in PLAN MODE. You can read, search, and analyze — but you CANNOT write files, execute commands, or make changes. Your job is to understand the problem and propose a plan. Output a numbered list of steps.';
@@ -1326,6 +1333,30 @@ Always quote file paths that contain spaces. Never reference internal system nam
                             }
                             catch { /* silent */ }
                         }
+                        // ── Prompt Evolution (GEPA): record trace and evolve if threshold met ──
+                        try {
+                            const traceAgent = lastResponse.agent || 'kernel';
+                            recordTrace({
+                                agent: traceAgent,
+                                taskType: classifyTask(originalMessage),
+                                toolsUsed: [...toolSequenceLog],
+                                evalScore: selfEvalScore ?? 0.7,
+                                success: true,
+                                messageLength: content.length,
+                                timestamp: new Date().toISOString(),
+                            });
+                            // Check if we should evolve this agent's prompt
+                            if (shouldEvolve(traceAgent)) {
+                                const mutation = evolvePrompt(traceAgent);
+                                if (mutation) {
+                                    // Log evolution event (non-blocking, info-level)
+                                    process.stderr.write(`\n  \x1b[2m[prompt-evolution] ${traceAgent} evolved: ${mutation.reason}\x1b[0m\n`);
+                                }
+                            }
+                            // Update scoreAfter for recent mutations (needs 10+ post-mutation traces)
+                            updateMutationScore(traceAgent);
+                        }
+                        catch { /* prompt evolution is non-critical */ }
                         // ── Post-execution cognitive updates (v3.6.2) ──
                         try {
                             // Free energy — update beliefs based on tool results