titan-agent 6.4.4 → 6.5.1

package/dist/agent/agentLessons.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent/agentLessons.ts"],"sourcesContent":["/**\n * TITAN — Per-agent lessons.md (Reflexion-style failure memory).\n *\n * Why this exists\n * ---------------\n * The audit of TITAN's Command Post (2026-05-11) found that retrospectives\n * were computed in-memory per goal but never persisted as a per-agent\n * lookup. That meant the next time the same agent took on similar work,\n * it walked into the same failure modes blind.\n *\n * This module is the persistence layer for the Reflexion pattern as\n * documented in awesome-agent-harness pattern #6:\n *\n *   \"When a step fails, a separate critic LLM writes a 1-3 sentence\n *    verbal lesson ('I forgot to check the schema before inserting')\n *    into lessons.md. Future planner turns read this file first.\"\n *\n * One file per agent at `~/.titan/agents/<agentId>/lessons.md`. Append-only\n * + dedup-on-content. The top-N most recent / highest-relevance entries\n * are injected into that agent's system prompt at the start of every run\n * via {@link renderAgentLessonsForPrompt}.\n *\n * Reference:\n *   - Shinn et al. \"Reflexion: Language agents with verbal reinforcement\n *     learning\" (NeurIPS 2023) — https://arxiv.org/abs/2303.11366\n *   - Picrew/awesome-agent-harness pattern #6\n *   - ~/.claude/projects/-Users-michaelelliott/memory/titan-v6-living-canvas.md\n */\nimport { existsSync, readFileSync, writeFileSync, mkdirSync, appendFileSync, unlinkSync } from 'fs';\nimport { join } from 'path';\nimport { homedir } from 'os';\nimport logger from '../utils/logger.js';\nimport { recordJournalEvent } from './durableJournal.js';\n\nconst COMPONENT = 'AgentLessons';\n\n/** Lazy path resolution so tests can swap HOME / TITAN_HOME. */\nfunction titanHome(): string {\n    const env = process.env.TITAN_HOME;\n    if (env) return env.startsWith('~/') ? join(homedir(), env.slice(2)) : env;\n    return join(homedir(), '.titan');\n}\nfunction lessonsPath(agentId: string): string {\n    return join(titanHome(), 'agents', agentId, 'lessons.md');\n}\n\n/** A single lesson the agent has learned from a past failure or success. */\nexport interface AgentLesson {\n    /** Short, verbal — the lesson the agent took away (1–3 sentences). */\n    text: string;\n    /** \"fail\" lessons come from things that went wrong; \"win\" lessons from\n     *  things that worked surprisingly well. Both are useful. Default fail. */\n    kind?: 'fail' | 'win';\n    /** Free-form context tag — what kind of task this was about (e.g.\n     *  \"merge-conflict\", \"json-extract\", \"vram-acquire\"). Used for fuzzy\n     *  lookup later. Optional. */\n    topic?: string;\n    /** Optional sessionId for traceback. */\n    sessionId?: string;\n    /** Optional goalId — when set, the lesson is also written into the\n     *  goal's durable journal so a resuming process can see it. */\n    goalId?: string;\n}\n\n/** Cap on lesson count per agent. Older entries roll off the head. */\nconst LESSONS_PER_AGENT_CAP = 200;\n/** Cap on lessons rendered into the system prompt at run time. */\nconst PROMPT_RENDER_CAP = 12;\n\n/**\n * Append a lesson to the agent's lessons.md. Idempotent on near-duplicate\n * text (lowercased, whitespace-collapsed match) so the same lesson written\n * twice in close succession doesn't pollute the file.\n */\nexport function recordLesson(agentId: string, lesson: AgentLesson): void {\n    if (!agentId || !lesson?.text || !lesson.text.trim()) return;\n    try {\n        const path = lessonsPath(agentId);\n        try { mkdirSync(join(path, '..'), { recursive: true }); } catch { /* exists */ }\n\n        const norm = (s: string) => s.toLowerCase().replace(/\\s+/g, ' ').trim();\n        const incomingNorm = norm(lesson.text);\n\n        // Read existing entries to dedup against recent ones.\n        const existingRaw = existsSync(path) ? readFileSync(path, 'utf-8') : '';\n        const recentNorms = parseLessonTexts(existingRaw)\n            .slice(-20) // only dedup against last 20 — older content fades\n            .map(norm);\n        if (recentNorms.includes(incomingNorm)) {\n            return; // already learned this lesson recently\n        }\n\n        // Append one entry in the documented format.\n        const ts = new Date().toISOString();\n        const kind = lesson.kind ?? 'fail';\n        const topic = lesson.topic ? ` topic=\"${escapeAttr(lesson.topic)}\"` : '';\n        const session = lesson.sessionId ? ` session=\"${escapeAttr(lesson.sessionId)}\"` : '';\n        const block = `\\n- [${ts}] **${kind}**${topic}${session} — ${lesson.text.trim()}\\n`;\n\n        // Make sure the file has a header on first write.\n        if (!existsSync(path)) {\n            writeFileSync(path, lessonsHeader(agentId), 'utf-8');\n        }\n        appendFileSync(path, block, 'utf-8');\n\n        // Trim to cap if exceeded.\n        trimIfOverCap(path);\n\n        logger.info(COMPONENT, `Recorded ${kind}-lesson for ${agentId}${topic} — \"${lesson.text.slice(0, 80)}\"`);\n\n        // v6.0 CP upgrade #4 — durable journal: surface lessons in the\n        // per-context replay so resuming agents can see what was learned.\n        recordJournalEvent(\n            { agentId, goalId: lesson.goalId, sessionId: lesson.sessionId },\n            'lesson_recorded',\n            { text: lesson.text.trim(), kind, topic: lesson.topic },\n        );\n    } catch (err) {\n        logger.warn(COMPONENT, `Failed to write lesson for ${agentId}: ${(err as Error).message}`);\n    }\n}\n\nfunction lessonsHeader(agentId: string): string {\n    return [\n        `# Lessons — ${agentId}`,\n        ``,\n        `Append-only verbal-reinforcement journal. Each entry is one lesson the`,\n        `agent learned from a past attempt (failure or surprising win). The top`,\n        `~${PROMPT_RENDER_CAP} most recent entries are injected into this agent's system`,\n        `prompt at the start of every run.`,\n        ``,\n        `Format: \\`- [iso-ts] **kind** [topic=\"…\"] [session=\"…\"] — verbal lesson\\``,\n        ``,\n        `---`,\n        ``,\n    ].join('\\n');\n}\n\nfunction escapeAttr(s: string): string {\n    return s.replace(/[\\\\\"\\n\\r]/g, c => c === '\\n' ? ' ' : c === '\\r' ? ' ' : '\\\\' + c).slice(0, 80);\n}\n\n/** Parse the lesson lines from the raw markdown. Returns text content only. */\nfunction parseLessonTexts(raw: string): string[] {\n    const lines = raw.split(/\\r?\\n/);\n    const out: string[] = [];\n    for (const l of lines) {\n        // Match the documented format. Capture everything after the trailing \" — \".\n        const m = l.match(/^- \\[[^\\]]+\\]\\s+\\*\\*(fail|win)\\*\\*(?:[^—]*)—\\s+(.+)$/);\n        if (m && m[2]) out.push(m[2]);\n    }\n    return out;\n}\n\nfunction trimIfOverCap(path: string): void {\n    try {\n        const raw = readFileSync(path, 'utf-8');\n        const lines = raw.split(/\\r?\\n/);\n        // Find the entries (lines starting with \"- [\")\n        const entryIdx: number[] = [];\n        for (let i = 0; i < lines.length; i++) {\n            if (lines[i].startsWith('- [')) entryIdx.push(i);\n        }\n        if (entryIdx.length <= LESSONS_PER_AGENT_CAP) return;\n        // Drop the oldest (LESSONS_PER_AGENT_CAP / 4) when we tip over.\n        const dropCount = Math.max(1, Math.floor(LESSONS_PER_AGENT_CAP / 4));\n        const cutAt = entryIdx[dropCount] ?? entryIdx[0];\n        // Header ends at first \"---\" line.\n        const headerEnd = lines.findIndex(l => l.trim() === '---');\n        const header = headerEnd >= 0 ? lines.slice(0, headerEnd + 2).join('\\n') : '';\n        const kept = lines.slice(cutAt).join('\\n');\n        writeFileSync(path, header + '\\n' + kept, 'utf-8');\n        logger.info(COMPONENT, `Trimmed ${dropCount} oldest lessons from ${path}`);\n    } catch { /* best-effort */ }\n}\n\n/**\n * Render the most relevant lessons for `agentId` as a prompt-ready block.\n * If `topic` is supplied, lessons matching that topic float to the top.\n * Returns empty string when there are no lessons yet (don't add a\n * prompt section with no content).\n */\nexport function renderAgentLessonsForPrompt(agentId: string, topic?: string): string {\n    if (!agentId) return '';\n    const path = lessonsPath(agentId);\n    if (!existsSync(path)) return '';\n    try {\n        const raw = readFileSync(path, 'utf-8');\n        const lines = raw.split(/\\r?\\n/);\n        // Parse structured entries: kind + topic + text. Preserve source order so\n        // lessons written within the same millisecond still render newest-first.\n        const entries: Array<{ kind: string; topic: string; text: string; ts: string; index: number }> = [];\n        for (let index = 0; index < lines.length; index++) {\n            const l = lines[index];\n            const m = l.match(/^- \\[([^\\]]+)\\]\\s+\\*\\*(fail|win)\\*\\*(?:\\s+topic=\"([^\"]+)\")?(?:[^—]*)—\\s+(.+)$/);\n            if (m) entries.push({ ts: m[1], kind: m[2], topic: m[3] || '', text: m[4], index });\n        }\n        if (entries.length === 0) return '';\n\n        // Sort: most recent first, with topic match boost.\n        const wantsTopic = (topic || '').toLowerCase();\n        const scored = entries.map(e => ({\n            e,\n            score: (wantsTopic && e.topic.toLowerCase() === wantsTopic ? 1 : 0)\n                 + (wantsTopic && e.topic.toLowerCase().includes(wantsTopic) ? 0.5 : 0),\n        }));\n        scored.sort((a, b) => b.score - a.score || b.e.ts.localeCompare(a.e.ts) || b.e.index - a.e.index);\n\n        const top = scored.slice(0, PROMPT_RENDER_CAP).map(s => s.e);\n        if (top.length === 0) return '';\n\n        const out: string[] = [`## Lessons you've learned (top ${top.length})`];\n        for (const e of top) {\n            const tag = e.topic ? ` *(${e.topic})*` : '';\n            out.push(`- **${e.kind}**${tag} — ${e.text}`);\n        }\n        return out.join('\\n');\n    } catch {\n        return '';\n    }\n}\n\n/** Convenience helper — read raw lessons.md content (used by tests + UI). */\nexport function readLessonsMarkdown(agentId: string): string {\n    const path = lessonsPath(agentId);\n    return existsSync(path) ? readFileSync(path, 'utf-8') : '';\n}\n\n/** Test helper — wipe an agent's lessons file. */\nexport function __resetLessonsForTests(agentId: string): void {\n    const path = lessonsPath(agentId);\n    if (existsSync(path)) {\n        try { unlinkSync(path); } catch { /* fine */ }\n    }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/agent/agentLessons.ts"],"sourcesContent":["/**\n * TITAN — Per-agent lessons.md (Reflexion-style failure memory).\n *\n * Why this exists\n * ---------------\n * The audit of TITAN's Command Post (2026-05-11) found that retrospectives\n * were computed in-memory per goal but never persisted as a per-agent\n * lookup. That meant the next time the same agent took on similar work,\n * it walked into the same failure modes blind.\n *\n * This module is the persistence layer for the Reflexion pattern as\n * documented in awesome-agent-harness pattern #6:\n *\n *   \"When a step fails, a separate critic LLM writes a 1-3 sentence\n *    verbal lesson ('I forgot to check the schema before inserting')\n *    into lessons.md. Future planner turns read this file first.\"\n *\n * One file per agent at `~/.titan/agents/<agentId>/lessons.md`. Append-only\n * + dedup-on-content. The top-N most recent / highest-relevance entries\n * are injected into that agent's system prompt at the start of every run\n * via {@link renderAgentLessonsForPrompt}.\n *\n * Reference:\n *   - Shinn et al. \"Reflexion: Language agents with verbal reinforcement\n *     learning\" (NeurIPS 2023) — https://arxiv.org/abs/2303.11366\n *   - Picrew/awesome-agent-harness pattern #6\n *   - ~/.claude/projects/-Users-localuser/memory/titan-v6-living-canvas.md\n */\nimport { existsSync, readFileSync, writeFileSync, mkdirSync, appendFileSync, unlinkSync } from 'fs';\nimport { join } from 'path';\nimport { homedir } from 'os';\nimport logger from '../utils/logger.js';\nimport { recordJournalEvent } from './durableJournal.js';\n\nconst COMPONENT = 'AgentLessons';\n\n/** Lazy path resolution so tests can swap HOME / TITAN_HOME. */\nfunction titanHome(): string {\n    const env = process.env.TITAN_HOME;\n    if (env) return env.startsWith('~/') ? join(homedir(), env.slice(2)) : env;\n    return join(homedir(), '.titan');\n}\nfunction lessonsPath(agentId: string): string {\n    return join(titanHome(), 'agents', agentId, 'lessons.md');\n}\n\n/** A single lesson the agent has learned from a past failure or success. */\nexport interface AgentLesson {\n    /** Short, verbal — the lesson the agent took away (1–3 sentences). */\n    text: string;\n    /** \"fail\" lessons come from things that went wrong; \"win\" lessons from\n     *  things that worked surprisingly well. Both are useful. Default fail. */\n    kind?: 'fail' | 'win';\n    /** Free-form context tag — what kind of task this was about (e.g.\n     *  \"merge-conflict\", \"json-extract\", \"vram-acquire\"). Used for fuzzy\n     *  lookup later. Optional. */\n    topic?: string;\n    /** Optional sessionId for traceback. */\n    sessionId?: string;\n    /** Optional goalId — when set, the lesson is also written into the\n     *  goal's durable journal so a resuming process can see it. */\n    goalId?: string;\n}\n\n/** Cap on lesson count per agent. Older entries roll off the head. */\nconst LESSONS_PER_AGENT_CAP = 200;\n/** Cap on lessons rendered into the system prompt at run time. */\nconst PROMPT_RENDER_CAP = 12;\n\n/**\n * Append a lesson to the agent's lessons.md. Idempotent on near-duplicate\n * text (lowercased, whitespace-collapsed match) so the same lesson written\n * twice in close succession doesn't pollute the file.\n */\nexport function recordLesson(agentId: string, lesson: AgentLesson): void {\n    if (!agentId || !lesson?.text || !lesson.text.trim()) return;\n    try {\n        const path = lessonsPath(agentId);\n        try { mkdirSync(join(path, '..'), { recursive: true }); } catch { /* exists */ }\n\n        const norm = (s: string) => s.toLowerCase().replace(/\\s+/g, ' ').trim();\n        const incomingNorm = norm(lesson.text);\n\n        // Read existing entries to dedup against recent ones.\n        const existingRaw = existsSync(path) ? readFileSync(path, 'utf-8') : '';\n        const recentNorms = parseLessonTexts(existingRaw)\n            .slice(-20) // only dedup against last 20 — older content fades\n            .map(norm);\n        if (recentNorms.includes(incomingNorm)) {\n            return; // already learned this lesson recently\n        }\n\n        // Append one entry in the documented format.\n        const ts = new Date().toISOString();\n        const kind = lesson.kind ?? 'fail';\n        const topic = lesson.topic ? ` topic=\"${escapeAttr(lesson.topic)}\"` : '';\n        const session = lesson.sessionId ? ` session=\"${escapeAttr(lesson.sessionId)}\"` : '';\n        const block = `\\n- [${ts}] **${kind}**${topic}${session} — ${lesson.text.trim()}\\n`;\n\n        // Make sure the file has a header on first write.\n        if (!existsSync(path)) {\n            writeFileSync(path, lessonsHeader(agentId), 'utf-8');\n        }\n        appendFileSync(path, block, 'utf-8');\n\n        // Trim to cap if exceeded.\n        trimIfOverCap(path);\n\n        logger.info(COMPONENT, `Recorded ${kind}-lesson for ${agentId}${topic} — \"${lesson.text.slice(0, 80)}\"`);\n\n        // v6.0 CP upgrade #4 — durable journal: surface lessons in the\n        // per-context replay so resuming agents can see what was learned.\n        recordJournalEvent(\n            { agentId, goalId: lesson.goalId, sessionId: lesson.sessionId },\n            'lesson_recorded',\n            { text: lesson.text.trim(), kind, topic: lesson.topic },\n        );\n    } catch (err) {\n        logger.warn(COMPONENT, `Failed to write lesson for ${agentId}: ${(err as Error).message}`);\n    }\n}\n\nfunction lessonsHeader(agentId: string): string {\n    return [\n        `# Lessons — ${agentId}`,\n        ``,\n        `Append-only verbal-reinforcement journal. Each entry is one lesson the`,\n        `agent learned from a past attempt (failure or surprising win). The top`,\n        `~${PROMPT_RENDER_CAP} most recent entries are injected into this agent's system`,\n        `prompt at the start of every run.`,\n        ``,\n        `Format: \\`- [iso-ts] **kind** [topic=\"…\"] [session=\"…\"] — verbal lesson\\``,\n        ``,\n        `---`,\n        ``,\n    ].join('\\n');\n}\n\nfunction escapeAttr(s: string): string {\n    return s.replace(/[\\\\\"\\n\\r]/g, c => c === '\\n' ? ' ' : c === '\\r' ? ' ' : '\\\\' + c).slice(0, 80);\n}\n\n/** Parse the lesson lines from the raw markdown. Returns text content only. */\nfunction parseLessonTexts(raw: string): string[] {\n    const lines = raw.split(/\\r?\\n/);\n    const out: string[] = [];\n    for (const l of lines) {\n        // Match the documented format. Capture everything after the trailing \" — \".\n        const m = l.match(/^- \\[[^\\]]+\\]\\s+\\*\\*(fail|win)\\*\\*(?:[^—]*)—\\s+(.+)$/);\n        if (m && m[2]) out.push(m[2]);\n    }\n    return out;\n}\n\nfunction trimIfOverCap(path: string): void {\n    try {\n        const raw = readFileSync(path, 'utf-8');\n        const lines = raw.split(/\\r?\\n/);\n        // Find the entries (lines starting with \"- [\")\n        const entryIdx: number[] = [];\n        for (let i = 0; i < lines.length; i++) {\n            if (lines[i].startsWith('- [')) entryIdx.push(i);\n        }\n        if (entryIdx.length <= LESSONS_PER_AGENT_CAP) return;\n        // Drop the oldest (LESSONS_PER_AGENT_CAP / 4) when we tip over.\n        const dropCount = Math.max(1, Math.floor(LESSONS_PER_AGENT_CAP / 4));\n        const cutAt = entryIdx[dropCount] ?? entryIdx[0];\n        // Header ends at first \"---\" line.\n        const headerEnd = lines.findIndex(l => l.trim() === '---');\n        const header = headerEnd >= 0 ? lines.slice(0, headerEnd + 2).join('\\n') : '';\n        const kept = lines.slice(cutAt).join('\\n');\n        writeFileSync(path, header + '\\n' + kept, 'utf-8');\n        logger.info(COMPONENT, `Trimmed ${dropCount} oldest lessons from ${path}`);\n    } catch { /* best-effort */ }\n}\n\n/**\n * Render the most relevant lessons for `agentId` as a prompt-ready block.\n * If `topic` is supplied, lessons matching that topic float to the top.\n * Returns empty string when there are no lessons yet (don't add a\n * prompt section with no content).\n */\nexport function renderAgentLessonsForPrompt(agentId: string, topic?: string): string {\n    if (!agentId) return '';\n    const path = lessonsPath(agentId);\n    if (!existsSync(path)) return '';\n    try {\n        const raw = readFileSync(path, 'utf-8');\n        const lines = raw.split(/\\r?\\n/);\n        // Parse structured entries: kind + topic + text. Preserve source order so\n        // lessons written within the same millisecond still render newest-first.\n        const entries: Array<{ kind: string; topic: string; text: string; ts: string; index: number }> = [];\n        for (let index = 0; index < lines.length; index++) {\n            const l = lines[index];\n            const m = l.match(/^- \\[([^\\]]+)\\]\\s+\\*\\*(fail|win)\\*\\*(?:\\s+topic=\"([^\"]+)\")?(?:[^—]*)—\\s+(.+)$/);\n            if (m) entries.push({ ts: m[1], kind: m[2], topic: m[3] || '', text: m[4], index });\n        }\n        if (entries.length === 0) return '';\n\n        // Sort: most recent first, with topic match boost.\n        const wantsTopic = (topic || '').toLowerCase();\n        const scored = entries.map(e => ({\n            e,\n            score: (wantsTopic && e.topic.toLowerCase() === wantsTopic ? 1 : 0)\n                 + (wantsTopic && e.topic.toLowerCase().includes(wantsTopic) ? 0.5 : 0),\n        }));\n        scored.sort((a, b) => b.score - a.score || b.e.ts.localeCompare(a.e.ts) || b.e.index - a.e.index);\n\n        const top = scored.slice(0, PROMPT_RENDER_CAP).map(s => s.e);\n        if (top.length === 0) return '';\n\n        const out: string[] = [`## Lessons you've learned (top ${top.length})`];\n        for (const e of top) {\n            const tag = e.topic ? ` *(${e.topic})*` : '';\n            out.push(`- **${e.kind}**${tag} — ${e.text}`);\n        }\n        return out.join('\\n');\n    } catch {\n        return '';\n    }\n}\n\n/** Convenience helper — read raw lessons.md content (used by tests + UI). */\nexport function readLessonsMarkdown(agentId: string): string {\n    const path = lessonsPath(agentId);\n    return existsSync(path) ? readFileSync(path, 'utf-8') : '';\n}\n\n/** Test helper — wipe an agent's lessons file. */\nexport function __resetLessonsForTests(agentId: string): void {\n    const path = lessonsPath(agentId);\n    if (existsSync(path)) {\n        try { unlinkSync(path); } catch { /* fine */ }\n    }\n}\n"],"mappings":";AA4BA,SAAS,YAAY,cAAc,eAAe,WAAW,gBAAgB,kBAAkB;AAC/F,SAAS,YAAY;AACrB,SAAS,eAAe;AACxB,OAAO,YAAY;AACnB,SAAS,0BAA0B;AAEnC,MAAM,YAAY;AAGlB,SAAS,YAAoB;AACzB,QAAM,MAAM,QAAQ,IAAI;AACxB,MAAI,IAAK,QAAO,IAAI,WAAW,IAAI,IAAI,KAAK,QAAQ,GAAG,IAAI,MAAM,CAAC,CAAC,IAAI;AACvE,SAAO,KAAK,QAAQ,GAAG,QAAQ;AACnC;AACA,SAAS,YAAY,SAAyB;AAC1C,SAAO,KAAK,UAAU,GAAG,UAAU,SAAS,YAAY;AAC5D;AAqBA,MAAM,wBAAwB;AAE9B,MAAM,oBAAoB;AAOnB,SAAS,aAAa,SAAiB,QAA2B;AACrE,MAAI,CAAC,WAAW,CAAC,QAAQ,QAAQ,CAAC,OAAO,KAAK,KAAK,EAAG;AACtD,MAAI;AACA,UAAM,OAAO,YAAY,OAAO;AAChC,QAAI;AAAE,gBAAU,KAAK,MAAM,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AAAA,IAAG,QAAQ;AAAA,IAAe;AAE/E,UAAM,OAAO,CAAC,MAAc,EAAE,YAAY,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACtE,UAAM,eAAe,KAAK,OAAO,IAAI;AAGrC,UAAM,cAAc,WAAW,IAAI,IAAI,aAAa,MAAM,OAAO,IAAI;AACrE,UAAM,cAAc,iBAAiB,WAAW,EAC3C,MAAM,GAAG,EACT,IAAI,IAAI;AACb,QAAI,YAAY,SAAS,YAAY,GAAG;AACpC;AAAA,IACJ;AAGA,UAAM,MAAK,oBAAI,KAAK,GAAE,YAAY;AAClC,UAAM,OAAO,OAAO,QAAQ;AAC5B,UAAM,QAAQ,OAAO,QAAQ,WAAW,WAAW,OAAO,KAAK,CAAC,MAAM;AACtE,UAAM,UAAU,OAAO,YAAY,aAAa,WAAW,OAAO,SAAS,CAAC,MAAM;AAClF,UAAM,QAAQ;AAAA,KAAQ,EAAE,OAAO,IAAI,KAAK,KAAK,GAAG,OAAO,WAAM,OAAO,KAAK,KAAK,CAAC;AAAA;AAG/E,QAAI,CAAC,WAAW,IAAI,GAAG;AACnB,oBAAc,MAAM,cAAc,OAAO,GAAG,OAAO;AAAA,IACvD;AACA,mBAAe,MAAM,OAAO,OAAO;AAGnC,kBAAc,IAAI;AAElB,WAAO,KAAK,WAAW,YAAY,IAAI,eAAe,OAAO,GAAG,KAAK,YAAO,OAAO,KAAK,MAAM,GAAG,EAAE,CAAC,GAAG;AAIvG;AAAA,MACI,EAAE,SAAS,QAAQ,OAAO,QAAQ,WAAW,OAAO,UAAU;AAAA,MAC9D;AAAA,MACA,EAAE,MAAM,OAAO,KAAK,KAAK,GAAG,MAAM,OAAO,OAAO,MAAM;AAAA,IAC1D;AAAA,EACJ,SAAS,KAAK;AACV,WAAO,KAAK,WAAW,8BAA8B,OAAO,KAAM,IAAc,OAAO,EAAE;AAAA,EAC7F;AACJ;AAEA,SAAS,cAAc,SAAyB;AAC5C,SAAO;AAAA,IACH,oBAAe,OAAO;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA,IAAI,iBAAiB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACJ,EAAE,KAAK,IAAI;AACf;AAEA,SAAS,WAAW,GAAmB;AACnC,SAAO,EAAE,QAAQ,cAAc,OAAK,MAAM,OAAO,MAAM,MAAM,OAAO,MAAM,OAAO,CAAC,EAAE,MAAM,GAAG,EAAE;AACnG;AAGA,SAAS,iBAAiB,KAAuB;AAC7C,QAAM,QAAQ,IAAI,MAAM,OAAO;AAC/B,QAAM,MAAgB,CAAC;AACvB,aAAW,KAAK,OAAO;AAEnB,UAAM,IAAI,EAAE,MAAM,sDAAsD;AACxE,QAAI,KAAK,EAAE,CAAC,EAAG,KAAI,KAAK,EAAE,CAAC,CAAC;AAAA,EAChC;AACA,SAAO;AACX;AAEA,SAAS,cAAc,MAAoB;AACvC,MAAI;AACA,UAAM,MAAM,aAAa,MAAM,OAAO;AACtC,UAAM,QAAQ,IAAI,MAAM,OAAO;AAE/B,UAAM,WAAqB,CAAC;AAC5B,aAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACnC,UAAI,MAAM,CAAC,EAAE,WAAW,KAAK,EAAG,UAAS,KAAK,CAAC;AAAA,IACnD;AACA,QAAI,SAAS,UAAU,sBAAuB;AAE9C,UAAM,YAAY,KAAK,IAAI,GAAG,KAAK,MAAM,wBAAwB,CAAC,CAAC;AACnE,UAAM,QAAQ,SAAS,SAAS,KAAK,SAAS,CAAC;AAE/C,UAAM,YAAY,MAAM,UAAU,OAAK,EAAE,KAAK,MAAM,KAAK;AACzD,UAAM,SAAS,aAAa,IAAI,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,KAAK,IAAI,IAAI;AAC3E,UAAM,OAAO,MAAM,MAAM,KAAK,EAAE,KAAK,IAAI;AACzC,kBAAc,MAAM,SAAS,OAAO,MAAM,OAAO;AACjD,WAAO,KAAK,WAAW,WAAW,SAAS,wBAAwB,IAAI,EAAE;AAAA,EAC7E,QAAQ;AAAA,EAAoB;AAChC;AAQO,SAAS,4BAA4B,SAAiB,OAAwB;AACjF,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,OAAO,YAAY,OAAO;AAChC,MAAI,CAAC,WAAW,IAAI,EAAG,QAAO;AAC9B,MAAI;AACA,UAAM,MAAM,aAAa,MAAM,OAAO;AACtC,UAAM,QAAQ,IAAI,MAAM,OAAO;AAG/B,UAAM,UAA2F,CAAC;AAClG,aAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS;AAC/C,YAAM,IAAI,MAAM,KAAK;AACrB,YAAM,IAAI,EAAE,MAAM,+EAA+E;AACjG,UAAI,EAAG,SAAQ,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,KAAK,IAAI,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;AAAA,IACtF;AACA,QAAI,QAAQ,WAAW,EAAG,QAAO;AAGjC,UAAM,cAAc,SAAS,IAAI,YAAY;AAC7C,UAAM,SAAS,QAAQ,IAAI,QAAM;AAAA,MAC7B;AAAA,MACA,QAAQ,cAAc,EAAE,MAAM,YAAY,MAAM,aAAa,IAAI,MACzD,cAAc,EAAE,MAAM,YAAY,EAAE,SAAS,UAAU,IAAI,MAAM;AAAA,IAC7E,EAAE;AACF,WAAO,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,GAAG,cAAc,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK;AAEhG,UAAM,MAAM,OAAO,MAAM,GAAG,iBAAiB,EAAE,IAAI,OAAK,EAAE,CAAC;AAC3D,QAAI,IAAI,WAAW,EAAG,QAAO;AAE7B,UAAM,MAAgB,CAAC,kCAAkC,IAAI,MAAM,GAAG;AACtE,eAAW,KAAK,KAAK;AACjB,YAAM,MAAM,EAAE,QAAQ,MAAM,EAAE,KAAK,OAAO;AAC1C,UAAI,KAAK,OAAO,EAAE,IAAI,KAAK,GAAG,WAAM,EAAE,IAAI,EAAE;AAAA,IAChD;AACA,WAAO,IAAI,KAAK,IAAI;AAAA,EACxB,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AAGO,SAAS,oBAAoB,SAAyB;AACzD,QAAM,OAAO,YAAY,OAAO;AAChC,SAAO,WAAW,IAAI,IAAI,aAAa,MAAM,OAAO,IAAI;AAC5D;AAGO,SAAS,uBAAuB,SAAuB;AAC1D,QAAM,OAAO,YAAY,OAAO;AAChC,MAAI,WAAW,IAAI,GAAG;AAClB,QAAI;AAAE,iBAAW,IAAI;AAAA,IAAG,QAAQ;AAAA,IAAa;AAAA,EACjD;AACJ;","names":[]}

package/dist/agent/agentLoop.js

@@ -634,6 +634,9 @@ Try a COMPLETELY DIFFERENT strategy. Do NOT repeat the same tools or approach.`
         const chatOptions = {
           model: activeModel,
           messages: smartMessages,
+          // v6.5 — forward the request AbortSignal so Stop / client
+          // disconnect cancels in-flight generation at the provider fetch.
+          signal: ctx.signal,
           tools: ctx.activeTools.length > 0 ? ctx.activeTools : void 0,
           maxTokens: isVoice ? Math.min(ctx.config.agent.maxTokens, 300) : ctx.config.agent.maxTokens,
           temperature: ctx.config.agent.temperature,
@@ -1503,7 +1506,8 @@ Examples: use read_file instead of cat/head/tail/grep, and edit_file instead of
           temperature: ctx.config.agent.temperature,
           thinking: ctx.voiceFastPath ? false : thinkingMode !== "off",
           thinkingLevel: thinkingMode,
-          providerOptions: ctx.providerOptions
+          providerOptions: ctx.providerOptions,
+          signal: ctx.signal
         };
         let response;
         const respondStart = Date.now();