agent-nuvira 1.14.0

package/dist/agents/agents/writer.js

@@ -0,0 +1,384 @@
+/**
+ * WriterAgent — Proposes code changes based on the task plan and gathered context.
+ *
+ * For each "writer" step in the execution plan, this agent:
+ * 1. Reads the relevant source files (from artifacts in the context bus)
+ * 2. Generates modified versions using the LLM
+ * 3. Stores FileChange objects in the context bus for the orchestrator to apply
+ *
+ * The agent does NOT write to disk — it only proposes changes.
+ * The orchestrator decides whether to apply them (based on dry-run mode).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { Agent } from '../agent.js';
+import { logger } from '../../utils/logger.js';
+const WRITER_SYSTEM_PROMPT = `You are an expert software engineer implementing changes to a codebase.
+
+Given file contents and an implementation task, you will:
+1. Read the current file content carefully
+2. Implement the requested changes
+3. Return the COMPLETE updated file content for EACH modified file
+
+## Output Format (MANDATORY)
+
+Wrap EACH file you modify in its own code block. The file path MUST go right after the opening backticks with the prefix "filepath:".
+
+CORRECT (use this format):
+\`\`\`filepath:path/to/file.ts
+// FULL updated file content here
+\`\`\`
+
+INCORRECT (do NOT use these):
+- ❌ \`\`\`typescript\n...\n\`\`\` (missing filepath)
+- ❌ \`\`\`\n...\n\`\`\` (missing language and filepath)
+- ❌ Just describing the changes instead of returning the file
+
+## Rules
+- Return the FULL file content, not just the changed parts
+- Preserve existing code style and conventions
+- Add appropriate error handling
+- Write clean, well-documented code
+- If you modify multiple files, return ONE code block per file
+`;
+/** Maximum files to include in a single writer prompt */
+const MAX_CONTEXT_FILES = 10;
+/**
+ * Maximum total characters across all files sent to the LLM.
+ * 16,000 chars ≈ 4,000 tokens — leaves room for the rest of the prompt and response.
+ * Files are prioritized: smaller files first, larger files are trunkated if over budget.
+ */
+const MAX_CONTEXT_CHARS = 16_000;
+/** Maximum number of API retry attempts for transient LLM failures (rate limits, timeouts, etc.) */
+const MAX_API_RETRIES = 2;
+/** Base delay for exponential backoff in milliseconds (doubles each retry: 5s, 10s) */
+const BASE_RETRY_DELAY_MS = 5000;
+/**
+ * Threshold above which we consider a rate-limit wait "long" and prompt the user.
+ * Short waits (< 3s) are auto-retried silently. Long waits prompt the user.
+ */
+const LONG_WAIT_THRESHOLD_MS = 3000;
+/**
+ * Parse the "try again in Xs" hint from a rate-limit error response.
+ * Supports formats: "try again in 10.49s", "try again in 5000ms"
+ * Returns the suggested wait time in ms, or null if not found.
+ */
+function parseRetryAfterHint(errorMessage) {
+    // Match patterns like: "try again in 10.49s" or "try again in 5000ms"
+    const secondMatch = errorMessage.match(/try again in ([\d.]+)s/i);
+    if (secondMatch) {
+        const seconds = parseFloat(secondMatch[1]);
+        if (!isNaN(seconds) && seconds > 0) {
+            return Math.ceil(seconds * 1000);
+        }
+    }
+    const msMatch = errorMessage.match(/try again in (\d+)ms/i);
+    if (msMatch) {
+        const ms = parseInt(msMatch[1], 10);
+        if (!isNaN(ms) && ms > 0) {
+            return ms;
+        }
+    }
+    return null;
+}
+/**
+ * Extract the model name from a rate-limit error message.
+ * Matches patterns like: "Rate limit reached for model `qwen/qwen3-32b`"
+ */
+function parseModelName(errorMessage) {
+    const match = errorMessage.match(/model\s+`([^`]+)`|model\s+'([^']+)'|model\s+([^\s]+)/i);
+    return match?.[1] || match?.[2] || match?.[3] || undefined;
+}
+/**
+ * Check if an error message indicates a rate-limit (429) error.
+ */
+function isRateLimitError(errorMessage) {
+    return /rate\s*limit|429|too many requests|try again in/i.test(errorMessage);
+}
+/**
+ * Calculate the retry delay for a given attempt.
+ * If the error message contains a "try again in Xs" hint, use that.
+ * Otherwise, fall back to exponential backoff with BASE_RETRY_DELAY_MS.
+ */
+function calculateRetryDelay(attempt, errorMessage) {
+    const hintDelay = parseRetryAfterHint(errorMessage);
+    if (hintDelay !== null) {
+        return hintDelay;
+    }
+    // Fallback: exponential backoff (5s, 10s, 20s...)
+    return BASE_RETRY_DELAY_MS * Math.pow(2, attempt);
+}
+/**
+ * WriterAgent — Proposes code changes by reading files, generating new versions
+ * via the LLM, and storing FileChange objects in the shared context.
+ * Does NOT write to disk directly; the orchestrator handles that.
+ *
+ * Retry strategy:
+ * 1. Rate-limit (429) errors with LONG wait (>3s): invokes onRateLimit callback
+ *    (if available) to let the user choose: wait, switch model, skip, or abort.
+ * 2. Rate-limit errors with SHORT wait (<=3s): auto-retry with smart delay.
+ * 3. Other transient errors (timeouts, network): auto-retry with backoff.
+ * 4. Empty parse results (format issue): retry once with stricter prompt.
+ */
+export class WriterAgent extends Agent {
+    name = 'Writer';
+    description = 'Generates code changes based on the plan and context';
+    async execute(context, callLLM) {
+        let lastError;
+        let latestCallLLM = callLLM;
+        // Outer retry loop: handles transient API errors (rate limits, timeouts)
+        for (let attempt = 0; attempt <= MAX_API_RETRIES; attempt++) {
+            try {
+                const result = await this.attemptWrite(context, latestCallLLM);
+                // Inner retry: handles empty parse results (format issue)
+                // This runs on EVERY API attempt — API errors and format issues are independent.
+                // The format retry always returns (success or note), so no infinite loop risk.
+                if (result.success && result.summary === 'No files needed changes') {
+                    // Retry once with stricter format instructions
+                    const retryResult = await this.attemptWrite(context, latestCallLLM, true);
+                    if (retryResult.success && retryResult.summary !== 'No files needed changes') {
+                        return retryResult;
+                    }
+                    return {
+                        success: true,
+                        summary: result.summary,
+                        details: `${result.details}\n(Retried once with explicit format instructions — still no parseable output)`,
+                    };
+                }
+                return result;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err.message : String(err);
+                // ── Rate limit handling with user prompt ─────────────────────
+                if (isRateLimitError(lastError) && context.onRateLimit) {
+                    const retryAfterMs = parseRetryAfterHint(lastError) || BASE_RETRY_DELAY_MS;
+                    if (retryAfterMs >= LONG_WAIT_THRESHOLD_MS) {
+                        const modelName = parseModelName(lastError);
+                        const action = await context.onRateLimit({
+                            retryAfterMs,
+                            modelName,
+                            agentName: this.name,
+                            errorMessage: lastError.slice(0, 300),
+                        });
+                        if (action.action === 'abort') {
+                            logger.error(`Writer aborted by user: ${lastError}`);
+                            return {
+                                success: false,
+                                summary: 'Writer aborted by user due to rate limit',
+                                error: lastError,
+                            };
+                        }
+                        if (action.action === 'skip') {
+                            logger.info('Writer step skipped by user');
+                            return {
+                                success: true,
+                                summary: 'Skipped by user (rate limit)',
+                                details: 'The writer step was skipped because the API rate limit was exceeded.',
+                            };
+                        }
+                        if (action.action === 'switch-model') {
+                            logger.info('Switching model per user request...');
+                            latestCallLLM = action.callLLM;
+                            // Continue the retry loop with the new callLLM
+                            await new Promise((resolve) => setTimeout(resolve, 500)); // Brief pause before retry
+                            continue;
+                        }
+                        // 'retry': fall through to wait and retry below
+                        logger.warn(`Writer rate limited. Waiting ${(retryAfterMs / 1000).toFixed(1)}s as chosen by user...`);
+                        await new Promise((resolve) => setTimeout(resolve, retryAfterMs));
+                        continue;
+                    }
+                    // Short wait: auto-retry (fall through to standard retry logic below)
+                }
+                // ── Standard retry for transient errors ──────────────────────
+                if (attempt < MAX_API_RETRIES) {
+                    if (isRateLimitError(lastError)) {
+                        // Short wait rate limit: auto-retry with smart delay
+                        const delayMs = calculateRetryDelay(attempt, lastError);
+                        logger.warn(`Writer API error (attempt ${attempt + 1}/${MAX_API_RETRIES + 1}): ` +
+                            `${lastError.slice(0, 200)}. Waiting ${(delayMs / 1000).toFixed(1)}s...`);
+                        await new Promise((resolve) => setTimeout(resolve, delayMs));
+                    }
+                    else {
+                        // Other transient errors (timeout, network): standard exponential backoff
+                        const delayMs = BASE_RETRY_DELAY_MS * Math.pow(2, attempt);
+                        logger.warn(`Writer API error (attempt ${attempt + 1}/${MAX_API_RETRIES + 1}): ` +
+                            `${lastError.slice(0, 200)}. Retrying in ${(delayMs / 1000).toFixed(1)}s...`);
+                        await new Promise((resolve) => setTimeout(resolve, delayMs));
+                    }
+                    continue;
+                }
+                // All attempts exhausted
+                logger.error(`Writer failed after ${MAX_API_RETRIES + 1} API attempts: ${lastError}`);
+                return {
+                    success: false,
+                    summary: 'Writer failed to generate changes',
+                    error: lastError,
+                };
+            }
+        }
+        // TypeScript safety — unreachable due to return in catch/finally
+        return {
+            success: false,
+            summary: 'Writer failed to generate changes',
+            error: lastError || 'Unknown error',
+        };
+    }
+    /**
+     * Perform a single write attempt.
+     * Optionally uses a stricter retry prompt.
+     */
+    async attemptWrite(context, callLLM, isRetry = false) {
+        const prompt = this.buildPrompt(context, isRetry);
+        // Log prompt size for debugging token limit issues
+        const label = isRetry ? 'Retry' : 'Initial';
+        logger.debug(`[Writer ${label}] Prompt size: ${prompt.length} chars, ~${Math.ceil(prompt.length / 4)} tokens`);
+        const response = await callLLM(prompt, {
+            temperature: isRetry ? 0.1 : 0.3, // Lower temperature for retry
+            maxTokens: 2048,
+        });
+        // ── Verbose logging: capture what the LLM actually returned ──────
+        logger.debug(`[Writer ${label}] LLM response length: ${response.length} chars`);
+        logger.debug(`[Writer ${label}] LLM response preview (first 600 chars):`);
+        logger.debug(response.slice(0, 600));
+        if (response.length > 600) {
+            logger.debug(`[Writer ${label}] ... (${response.length - 600} more chars truncated)`);
+        }
+        // Extract file changes from the response
+        const fileChanges = this.parseFileChanges(response, context.workingDirectory);
+        logger.debug(`[Writer ${label}] Parsed ${fileChanges.length} file change(s)`);
+        for (const fc of fileChanges) {
+            logger.debug(`[Writer ${label}]   ${fc.status === 'created' ? '\u{1F4C4}' : '\u{270F}\u{FE0F}'} ${fc.path} (${(fc.newContent || '').length} chars)`);
+        }
+        // Store changes in the shared context
+        for (const change of fileChanges) {
+            const existing = context.fileChanges.findIndex((c) => c.path === change.path);
+            if (existing >= 0) {
+                context.fileChanges[existing] = change;
+            }
+            else {
+                context.fileChanges.push(change);
+            }
+        }
+        const count = fileChanges.length;
+        if (count === 0) {
+            const excerpt = response.slice(0, 300).replace(/\n/g, '\\n');
+            logger.debug(`[Writer ${label}] No files parsed. Response starts with: ${excerpt.slice(0, 200)}...`);
+            return {
+                success: true,
+                summary: 'No files needed changes',
+                details: `Response preview: ${excerpt}...`,
+            };
+        }
+        return {
+            success: true,
+            summary: `Proposed changes to ${count} file${count !== 1 ? 's' : ''}`,
+            details: fileChanges
+                .map((c) => {
+                const icon = c.status === 'created' ? '\u{1F4C4}' : '\u{270F}\u{FE0F}';
+                return `  ${icon} ${c.path} (${c.status})`;
+            })
+                .join('\n'),
+        };
+    }
+    /**
+     * Build the prompt for the writer agent from the shared context.
+     * Limits the number of files sent to avoid token budget issues.
+     * When isRetry is true, uses a more explicit prompt.
+     */
+    buildPrompt(context, isRetry = false) {
+        // Find the writer tasks in the plan
+        const writerTask = context.taskPlan.find((s) => s.agentType === 'writer' && s.status === 'running');
+        const taskDescription = writerTask?.description || context.goal;
+        // Use token-budget-aware file selection: show as many files as possible
+        // within MAX_CONTEXT_CHARS, prioritizing smaller files to max context.
+        const filesToSend = this.selectFilesWithinBudget(context.artifacts, MAX_CONTEXT_CHARS);
+        const fileContext = filesToSend.length > 0
+            ? filesToSend
+                .map(({ artifact, truncated }) => `--- ${artifact.path} ---${truncated ? ` (truncated, ${artifact.content.length}\u2192${truncated.length} chars)` : ''}\n${truncated || artifact.content}`)
+                .join('\n\n') +
+                (context.artifacts.length > filesToSend.length
+                    ? `\n\n... and ${context.artifacts.length - filesToSend.length} more files in the project (excluded to fit token budget)`
+                    : '')
+            : '(No files found in context — you may need to create new files)';
+        const instructions = isRetry
+            ? `\n## CRITICAL — Read This Carefully\nThe previous response could not be parsed because the files were not wrapped in correctly formatted code blocks.\n\nYou MUST follow this format EXACTLY for EACH file you modify:\n\n\`\`\`filepath:src/example.ts\n// THE COMPLETE UPDATED FILE CONTENT GOES HERE (every line, full file)\n\`\`\`\n\nIMPORTANT:\n- The filepath: prefix is REQUIRED after the opening backticks\n- Return the FULL file, not a diff or snippet\n- If you modify 2 files, return 2 separate code blocks in this format`
+            : `\n## Instructions\nImplement the changes described in the task. Return the complete updated file content for each file you modify. Remember: each file must be wrapped in \`\`\`filepath:...\n\`\`\` format.`;
+        return `${WRITER_SYSTEM_PROMPT}\n\n## Task Description\n${taskDescription}\n\n## Current File Content\n${fileContext}\n${instructions}`;
+    }
+    /**
+     * Parse the LLM response to extract file changes.
+     */
+    parseFileChanges(response, workingDir) {
+        const changes = [];
+        // Match code blocks containing a real file path.
+        const blockRegex = /```(?:[a-zA-Z0-9+#]*\s+)?(?:filepath:)?([^\n`]+(?:\.[a-zA-Z0-9]+|\/[^\n`]+))\n([\s\S]*?)```/g;
+        let match;
+        while ((match = blockRegex.exec(response)) !== null) {
+            let filePath = match[1].trim();
+            const content = match[2].trim();
+            // Clean up the file path (remove leading/trailing quotes, whitespace)
+            filePath = filePath.replace(/^['"]|['"]$/g, '').trim();
+            if (!filePath || !content)
+                continue;
+            this.addFileChange(changes, filePath, content, workingDir);
+        }
+        return changes;
+    }
+    /**
+     * Select files within the given character budget.
+     * Prioritizes smaller files first so the LLM sees as much complete context as possible.
+     */
+    selectFilesWithinBudget(artifacts, budget) {
+        const sorted = [...artifacts]
+            .map((a) => ({ artifact: a, size: a.content.length }))
+            .sort((a, b) => a.size - b.size);
+        const result = [];
+        let used = 0;
+        const OVERHEAD_PER_FILE = 50;
+        for (const { artifact, size } of sorted) {
+            if (result.length >= MAX_CONTEXT_FILES)
+                break;
+            const totalNeeded = size + OVERHEAD_PER_FILE;
+            if (used + totalNeeded <= budget) {
+                result.push({ artifact, truncated: null });
+                used += totalNeeded;
+            }
+            else if (used + OVERHEAD_PER_FILE < budget) {
+                const remaining = budget - used - OVERHEAD_PER_FILE;
+                if (remaining > 200) {
+                    const truncated = artifact.content.slice(0, remaining);
+                    result.push({ artifact, truncated });
+                    used = budget;
+                }
+                break;
+            }
+            else {
+                break;
+            }
+        }
+        return result;
+    }
+    addFileChange(changes, filePath, content, workingDir) {
+        const absolutePath = isAbsolute(filePath) ? filePath : join(workingDir, filePath);
+        if (existsSync(absolutePath)) {
+            const originalContent = readFileSync(absolutePath, 'utf-8');
+            if (originalContent.trim() !== content.trim()) {
+                changes.push({
+                    path: filePath,
+                    originalContent,
+                    newContent: content,
+                    status: 'modified',
+                });
+            }
+        }
+        else {
+            changes.push({
+                path: filePath,
+                newContent: content,
+                status: 'created',
+            });
+        }
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/agents/agents/writer.js.map

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

package/dist/agents/context-vault.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ContextVault — The shared in-memory context bus for inter-agent communication.
+ *
+ * All agents read from and write to this vault. The orchestrator creates one
+ * per execution session and passes references to every agent.
+ *
+ * This is deliberately a simple class wrapping a plain object so that
+ * it can be serialized/deserialized in Phase 2 (persistent memory).
+ */
+import type { AgentContext, TaskStep, Artifact, FileChange } from './agent.js';
+/**
+ * Shared, mutable context bus for a single orchestration session.
+ */
+export declare class ContextVault {
+    /** The underlying shared context */
+    readonly context: AgentContext;
+    constructor(goal: string, workingDirectory: string);
+    /** Replace the full task plan */
+    setTaskPlan(steps: TaskStep[]): void;
+    /** Update status for a single task step */
+    updateTaskStatus(taskId: string, status: TaskStep['status'], result?: string): void;
+    /** Get pending tasks whose dependencies are all completed */
+    getRunnableTasks(): TaskStep[];
+    /** Check if all tasks are completed or failed */
+    get isComplete(): boolean;
+    /** Check if any task has failed */
+    get hasFailedTasks(): boolean;
+    /** Add one or more file artifacts */
+    addArtifacts(artifacts: Artifact[]): void;
+    /** Get all artifacts (optionally filtered by path match) */
+    getArtifacts(pathPattern?: string): Artifact[];
+    /** Log an agent-to-agent message */
+    addMessage(from: string, to: string, content: string): void;
+    /** Get conversation history formatted for LLM context */
+    getConversationLog(): string;
+    /** Record a file change */
+    addFileChange(change: FileChange): void;
+    /** Get all file changes */
+    getFileChanges(): FileChange[];
+    /** Get a formatted diff summary for display */
+    getDiffSummary(): string;
+    /** Store a metadata value */
+    setMeta(key: string, value: unknown): void;
+    /** Retrieve a metadata value */
+    getMeta<T = unknown>(key: string): T | undefined;
+    /** Get a serialisable snapshot (handy for logging / Phase 2 persistence) */
+    snapshot(): AgentContext;
+}
+//# sourceMappingURL=context-vault.d.ts.map

package/dist/agents/context-vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-vault.d.ts","sourceRoot":"","sources":["../../src/agents/context-vault.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAgB,UAAU,EAAE,MAAM,YAAY,CAAC;AAe7F;;GAEG;AACH,qBAAa,YAAY;IACvB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;gBAEnB,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM;IAMlD,iCAAiC;IACjC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAIpC,2CAA2C;IAC3C,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAUnF,6DAA6D;IAC7D,gBAAgB,IAAI,QAAQ,EAAE;IAU9B,iDAAiD;IACjD,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,mCAAmC;IACnC,IAAI,cAAc,IAAI,OAAO,CAE5B;IAID,qCAAqC;IACrC,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI;IAIzC,4DAA4D;IAC5D,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE;IAO9C,oCAAoC;IACpC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAS3D,yDAAyD;IACzD,kBAAkB,IAAI,MAAM;IAQ5B,2BAA2B;IAC3B,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAUvC,2BAA2B;IAC3B,cAAc,IAAI,UAAU,EAAE;IAI9B,+CAA+C;IAC/C,cAAc,IAAI,MAAM;IAYxB,6BAA6B;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI1C,gCAAgC;IAChC,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAMhD,4EAA4E;IAC5E,QAAQ,IAAI,YAAY;CAGzB"}

package/dist/agents/context-vault.js

@@ -0,0 +1,134 @@
+/**
+ * ContextVault — The shared in-memory context bus for inter-agent communication.
+ *
+ * All agents read from and write to this vault. The orchestrator creates one
+ * per execution session and passes references to every agent.
+ *
+ * This is deliberately a simple class wrapping a plain object so that
+ * it can be serialized/deserialized in Phase 2 (persistent memory).
+ */
+/** Default empty context */
+function createEmptyContext(goal, workingDirectory) {
+    return {
+        goal,
+        workingDirectory,
+        taskPlan: [],
+        artifacts: [],
+        conversations: [],
+        fileChanges: [],
+        metadata: {},
+    };
+}
+/**
+ * Shared, mutable context bus for a single orchestration session.
+ */
+export class ContextVault {
+    /** The underlying shared context */
+    context;
+    constructor(goal, workingDirectory) {
+        this.context = createEmptyContext(goal, workingDirectory);
+    }
+    // ─── Task Plan ──────────────────────────────────────────────────────────
+    /** Replace the full task plan */
+    setTaskPlan(steps) {
+        this.context.taskPlan = steps;
+    }
+    /** Update status for a single task step */
+    updateTaskStatus(taskId, status, result) {
+        const step = this.context.taskPlan.find((s) => s.id === taskId);
+        if (step) {
+            step.status = status;
+            if (result !== undefined) {
+                step.result = result;
+            }
+        }
+    }
+    /** Get pending tasks whose dependencies are all completed */
+    getRunnableTasks() {
+        return this.context.taskPlan.filter((step) => {
+            if (step.status !== 'pending')
+                return false;
+            return step.dependsOn.every((depId) => {
+                const dep = this.context.taskPlan.find((s) => s.id === depId);
+                return dep?.status === 'completed';
+            });
+        });
+    }
+    /** Check if all tasks are completed or failed */
+    get isComplete() {
+        return this.context.taskPlan.every((s) => s.status === 'completed' || s.status === 'failed');
+    }
+    /** Check if any task has failed */
+    get hasFailedTasks() {
+        return this.context.taskPlan.some((s) => s.status === 'failed');
+    }
+    // ─── Artifacts ──────────────────────────────────────────────────────────
+    /** Add one or more file artifacts */
+    addArtifacts(artifacts) {
+        this.context.artifacts.push(...artifacts);
+    }
+    /** Get all artifacts (optionally filtered by path match) */
+    getArtifacts(pathPattern) {
+        if (!pathPattern)
+            return [...this.context.artifacts];
+        return this.context.artifacts.filter((a) => a.path.includes(pathPattern));
+    }
+    // ─── Conversations ──────────────────────────────────────────────────────
+    /** Log an agent-to-agent message */
+    addMessage(from, to, content) {
+        this.context.conversations.push({
+            from,
+            to,
+            content,
+            timestamp: Date.now(),
+        });
+    }
+    /** Get conversation history formatted for LLM context */
+    getConversationLog() {
+        return this.context.conversations
+            .map((m) => `[${m.from} → ${m.to}]: ${m.content}`)
+            .join('\n');
+    }
+    // ─── File Changes ───────────────────────────────────────────────────────
+    /** Record a file change */
+    addFileChange(change) {
+        // Replace existing entry for same path if present
+        const existing = this.context.fileChanges.findIndex((c) => c.path === change.path);
+        if (existing >= 0) {
+            this.context.fileChanges[existing] = change;
+        }
+        else {
+            this.context.fileChanges.push(change);
+        }
+    }
+    /** Get all file changes */
+    getFileChanges() {
+        return [...this.context.fileChanges];
+    }
+    /** Get a formatted diff summary for display */
+    getDiffSummary() {
+        if (this.context.fileChanges.length === 0)
+            return 'No files changed.';
+        return this.context.fileChanges
+            .map((c) => {
+            const icon = c.status === 'created' ? '📄' : c.status === 'deleted' ? '🗑️' : '✏️';
+            return `  ${icon} ${c.path} (${c.status})`;
+        })
+            .join('\n');
+    }
+    // ─── Metadata ───────────────────────────────────────────────────────────
+    /** Store a metadata value */
+    setMeta(key, value) {
+        this.context.metadata[key] = value;
+    }
+    /** Retrieve a metadata value */
+    getMeta(key) {
+        return this.context.metadata[key];
+    }
+    // ─── Snapshot ───────────────────────────────────────────────────────────
+    /** Get a serialisable snapshot (handy for logging / Phase 2 persistence) */
+    snapshot() {
+        return structuredClone(this.context);
+    }
+}
+//# sourceMappingURL=context-vault.js.map

package/dist/agents/context-vault.js.map

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