@project-ava-supernova/core 0.2.71

package/dist/agent/context-continuity.js

@@ -0,0 +1,231 @@
+/**
+ * Context continuity helpers — preserve task state through compression and
+ * truncation, and keep per-turn token cost in check.
+ *
+ * Background: when a long agent session hits the auto-compression threshold,
+ * the conversation history gets summarised and older messages are dropped.
+ * Without the helpers in this file, the agent can lose awareness of its
+ * active task — it sees the compression summary, can't tell what it was
+ * working on, and fresh-greets the user as if starting over. That's the
+ * "she acted like it was a new chat" failure mode observed on long runs.
+ *
+ * This file provides:
+ *   - findOriginalUserTaskIndex — locate the first real user request so it
+ *     can be preserved verbatim through all compression paths (it's "the
+ *     root of everything downstream" and never should be summarised away)
+ *   - formatSessionTasksBlock — render active session tasks from TaskManager
+ *     as a system-style block that gets re-injected after compression so the
+ *     post-compression model has direct visibility into what's in flight
+ *   - buildCompressionContinuationHeader — wrap the compression summary in
+ *     a continuation-first header that tells the model "resume the current
+ *     task, do not greet, do not start over"
+ *   - isMetaPrefix — recognise meta-prefixed user messages (summaries,
+ *     internal planning, memory briefs) that should NOT be treated as the
+ *     original user task
+ *
+ * All helpers are pure and stateless — they operate on the message array
+ * and read-only TaskManager access only.
+ */
+import { getTextContent } from '../core/types.js';
+// Known prefixes that mark a user-role message as machine-generated meta
+// content rather than a real user request. These messages should not be
+// treated as "the original user task" when pinning.
+const META_PREFIXES = [
+    '[Context Summary',
+    '[CONTEXT WAS COMPRESSED',
+    '[CONTEXT LIMIT]',
+    '[Internal Planning',
+    '[Memory Brief]',
+    '[System notice]',
+    '[ACTIVE TASKS',
+    '[Design context refresh',
+    '[Image captured',
+    '[Interjection]',
+    '[User pressed Stop',
+    '[Earlier user messages',
+];
+export function isMetaPrefix(content) {
+    const trimmed = content.trimStart();
+    return META_PREFIXES.some(prefix => trimmed.startsWith(prefix));
+}
+/**
+ * Find the index of the first user-role message that represents a real
+ * user request (not a meta-injection like a compression summary). Returns
+ * -1 if no such message exists. Used by compression and truncation paths
+ * to preserve the original task description verbatim — it's the one piece
+ * of context that should survive every compression pass because it's the
+ * root intent of the whole session.
+ */
+export function findOriginalUserTaskIndex(messages) {
+    for (let i = 0; i < messages.length; i++) {
+        const m = messages[i];
+        if (m.role !== 'user')
+            continue;
+        const text = getTextContent(m.content);
+        if (!text.trim())
+            continue;
+        if (isMetaPrefix(text))
+            continue;
+        return i;
+    }
+    return -1;
+}
+/**
+ * Return the first real user-task message if one exists, else null.
+ */
+export function findOriginalUserTask(messages) {
+    const idx = findOriginalUserTaskIndex(messages);
+    if (idx === -1)
+        return null;
+    return messages[idx];
+}
+/**
+ * Build a verbatim record of the user's own turns from the compress zone.
+ *
+ * The summariser distils assistant actions and decisions well, but it
+ * paraphrases the user — and the user's exact words are the truest record of
+ * intent ("I told you X and you forgot" is the most common context-loss
+ * complaint). User turns are short and cheap, so we keep them verbatim through
+ * compression instead of letting them survive only as a paraphrase.
+ *
+ * Framed explicitly as a historical reference, never as new requests — the
+ * same discipline that stops the pinned original task from being re-executed.
+ * Each turn is capped, and if there are very many we keep the most RECENT
+ * within a total budget (older ones remain in the summary and are retrievable
+ * via conversation_recall — the backstop covers the tail).
+ *
+ * Returns null when the compress zone holds no real user turns.
+ */
+export function buildVerbatimUserTurnsBlock(compressedMessages) {
+    const PER_TURN_CAP = 500;
+    const TOTAL_CAP = 6000;
+    const turns = [];
+    for (const m of compressedMessages) {
+        if (m.role !== 'user')
+            continue;
+        const text = getTextContent(m.content).trim();
+        if (!text || isMetaPrefix(text))
+            continue;
+        turns.push(text.length > PER_TURN_CAP ? text.slice(0, PER_TURN_CAP).trimEnd() + ' …' : text);
+    }
+    if (turns.length === 0)
+        return null;
+    // Keep the most recent turns within the total budget; count what we drop.
+    const kept = [];
+    let used = 0;
+    let omitted = 0;
+    for (let i = turns.length - 1; i >= 0; i--) {
+        const cost = turns[i].length + 8; // rough per-line overhead
+        if (used + cost > TOTAL_CAP && kept.length > 0) {
+            omitted = i + 1;
+            break;
+        }
+        kept.unshift(turns[i]);
+        used += cost;
+    }
+    const header = '[Earlier user messages in this session, verbatim — the user\'s own words, kept exactly as a reference record. These are NOT new requests to act on; they are context for what has already been said and asked.]';
+    const lines = kept.map((t, i) => `${i + 1}. "${t}"`);
+    if (omitted > 0) {
+        lines.unshift(`(${omitted} earlier user message(s) omitted here — they remain in the summary above and are retrievable with conversation_recall.)`);
+    }
+    return { role: 'user', content: [header, ...lines].join('\n') };
+}
+/**
+ * Format the active session tasks as a continuation-focused system block
+ * for injection after compression. The wording is deliberately imperative:
+ * the post-compression model must NOT treat the compressed state as a new
+ * conversation, so the block tells it directly what's in flight and forbids
+ * greeting or "what are we working on" responses.
+ *
+ * Returns null if there are no active tasks — in that case the caller
+ * should use the compression summary alone without a task block.
+ */
+export function formatSessionTasksBlock(tasks) {
+    const active = tasks.filter(t => t.status !== 'done' && t.status !== 'completed');
+    if (active.length === 0)
+        return null;
+    const lines = active.map((t, i) => {
+        const marker = t.status === 'in-progress' || t.status === 'in_progress' ? ' ← IN PROGRESS' : '';
+        return `  ${i + 1}. [${t.status}] ${t.title}${marker}`;
+    });
+    return [
+        '[ACTIVE TASKS — you are mid-session. Do NOT greet. Do NOT ask what we are working on. Continue the in-progress task below.]',
+        '',
+        ...lines,
+        '',
+        '[Resume the task marked IN PROGRESS. If no task is marked in progress, resume the first pending task. Your context was compressed — the tasks above are the source of truth for what you should be doing.]',
+    ].join('\n');
+}
+export function buildCompressionContinuationHeader(summaryBody, structured) {
+    const lines = [
+        '[CONTEXT WAS COMPRESSED. RESUME YOUR CURRENT TASK — DO NOT GREET OR ASK WHAT WE ARE WORKING ON.]',
+        '',
+    ];
+    if (structured) {
+        if (structured.currentTask)
+            lines.push(`**Current task:** ${structured.currentTask}`);
+        if (structured.lastStep)
+            lines.push(`**Last completed step:** ${structured.lastStep}`);
+        if (structured.nextStep)
+            lines.push(`**Next step:** ${structured.nextStep}`);
+        if (structured.blockers)
+            lines.push(`**Blockers:** ${structured.blockers}`);
+        if (lines.length > 2)
+            lines.push('');
+    }
+    lines.push('**Full summary (for reference):**');
+    lines.push(summaryBody.trim());
+    lines.push('');
+    lines.push('[Resume the current task from the state described above. Do NOT treat this as a new conversation. Do NOT greet. Do NOT ask what to do next — the answer is in the summary.]');
+    lines.push('[This summary is lossy. If you need an exact detail from earlier — what the user said, a decision, a path or value — call conversation_recall to read the real transcript. Recall it; do not guess it or ask the user to repeat themselves.]');
+    return lines.join('\n');
+}
+/**
+ * Parse a compression summary for structured CURRENT_TASK / LAST_STEP /
+ * NEXT_STEP / BLOCKERS fields that the summariser was asked to produce.
+ * The summariser prompt asks for these explicitly, but LLMs sometimes
+ * paraphrase — this parser handles both formal and loose formats.
+ *
+ * Returns empty object if no structured fields are found (the summary will
+ * still render via its free-form body).
+ */
+export function extractStructuredFields(summary) {
+    const result = {};
+    // Match various prefix styles the summariser might use
+    const patterns = [
+        ['currentTask', /(?:^|\n)\s*\**(?:CURRENT[_ ]?TASK|Current task)\**:\s*(.+?)(?=\n\s*\**(?:LAST|NEXT|BLOCK|CURRENT)|\n\n|$)/is],
+        ['lastStep', /(?:^|\n)\s*\**(?:LAST[_ ]?STEP|Last step|Last completed)\**:\s*(.+?)(?=\n\s*\**(?:LAST|NEXT|BLOCK|CURRENT)|\n\n|$)/is],
+        ['nextStep', /(?:^|\n)\s*\**(?:NEXT[_ ]?STEP|Next step)\**:\s*(.+?)(?=\n\s*\**(?:LAST|NEXT|BLOCK|CURRENT)|\n\n|$)/is],
+        ['blockers', /(?:^|\n)\s*\**(?:BLOCKERS?|Blocker)\**:\s*(.+?)(?=\n\s*\**(?:LAST|NEXT|BLOCK|CURRENT)|\n\n|$)/is],
+    ];
+    for (const [key, pattern] of patterns) {
+        const m = summary.match(pattern);
+        if (m && m[1]) {
+            const value = m[1].trim().replace(/\n+/g, ' ');
+            if (value && value.toLowerCase() !== 'none' && value.toLowerCase() !== 'n/a') {
+                result[key] = value;
+            }
+        }
+    }
+    return result;
+}
+// ─── Message body trimming for cost control ─────────────────────────────────
+/**
+ * Threshold above which old (non-recent) user/assistant message bodies get
+ * trimmed to a short summary. Chosen to preserve the structural meaning of
+ * the conversation (who said what, roughly) while stripping verbose
+ * content like inlined file contents or long reasoning traces.
+ */
+export const OLD_MESSAGE_BODY_MAX_CHARS = 1500;
+/**
+ * Produce a short trimmed representation of a long message body. Keeps the
+ * first N chars so the model can still see what the message was about, and
+ * appends a byte-count marker so it's clear content was omitted (not
+ * missing).
+ */
+export function trimMessageBody(content, maxChars = OLD_MESSAGE_BODY_MAX_CHARS) {
+    if (content.length <= maxChars)
+        return content;
+    return `${content.slice(0, maxChars).trimEnd()}\n\n[Trimmed — original ${content.length} chars for token-cost control]`;
+}
+//# sourceMappingURL=context-continuity.js.map

package/dist/agent/context-continuity.js.map

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

package/dist/agent/conversation.d.ts

@@ -0,0 +1,26 @@
+import type { Message, ContentPart } from '../core/types.js';
+export declare class Conversation {
+    private messages;
+    private _id;
+    constructor(id?: string);
+    get id(): string;
+    setSystemPrompt(content: string): void;
+    addUserMessage(content: string | ContentPart[]): void;
+    setMessages(messages: Message[]): void;
+    /**
+     * Append new messages to the conversation in order. This is the
+     * canonical way to consume Agent.run's return value — the agent
+     * produces the messages a single turn generated (assistant replies,
+     * tool results, interjections) and the caller appends them to the
+     * conversation it owns. setMessages is kept for full-replace paths
+     * (loading a conversation from disk, clearing, stop-marker injection),
+     * but append is the default for the run-agent loop.
+     */
+    appendMessages(messages: Message[]): void;
+    getMessages(): Message[];
+    clear(): void;
+    truncateToFit(maxTokens: number): boolean;
+    estimateTokenCount(): number;
+    private estimateMessageTokens;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/dist/agent/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/agent/conversation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE7D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,GAAG,CAAS;gBAER,EAAE,CAAC,EAAE,MAAM;IAIvB,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQtC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,IAAI;IAIrD,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAItC;;;;;;;;OAQG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAKzC,WAAW,IAAI,OAAO,EAAE;IAIxB,KAAK,IAAI,IAAI;IAKb,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAwBzC,kBAAkB,IAAI,MAAM;IAI5B,OAAO,CAAC,qBAAqB;CAY9B"}

package/dist/agent/conversation.js

@@ -0,0 +1,86 @@
+import { randomUUID } from 'node:crypto';
+export class Conversation {
+    messages = [];
+    _id;
+    constructor(id) {
+        this._id = id ?? randomUUID();
+    }
+    get id() {
+        return this._id;
+    }
+    setSystemPrompt(content) {
+        if (this.messages.length > 0 && this.messages[0].role === 'system') {
+            this.messages[0] = { role: 'system', content };
+        }
+        else {
+            this.messages.unshift({ role: 'system', content });
+        }
+    }
+    addUserMessage(content) {
+        this.messages.push({ role: 'user', content });
+    }
+    setMessages(messages) {
+        this.messages = [...messages];
+    }
+    /**
+     * Append new messages to the conversation in order. This is the
+     * canonical way to consume Agent.run's return value — the agent
+     * produces the messages a single turn generated (assistant replies,
+     * tool results, interjections) and the caller appends them to the
+     * conversation it owns. setMessages is kept for full-replace paths
+     * (loading a conversation from disk, clearing, stop-marker injection),
+     * but append is the default for the run-agent loop.
+     */
+    appendMessages(messages) {
+        if (messages.length === 0)
+            return;
+        this.messages.push(...messages);
+    }
+    getMessages() {
+        return [...this.messages];
+    }
+    clear() {
+        const systemMsg = this.messages.find((m) => m.role === 'system');
+        this.messages = systemMsg ? [systemMsg] : [];
+    }
+    truncateToFit(maxTokens) {
+        const estimatedTokens = this.estimateTokenCount();
+        if (estimatedTokens <= maxTokens)
+            return false;
+        const systemMsg = this.messages[0]?.role === 'system' ? this.messages[0] : null;
+        const rest = systemMsg ? this.messages.slice(1) : [...this.messages];
+        const systemTokens = systemMsg ? this.estimateMessageTokens(systemMsg) : 0;
+        const budget = maxTokens - systemTokens;
+        const kept = [];
+        let used = 0;
+        for (let i = rest.length - 1; i >= 0; i--) {
+            const msgTokens = this.estimateMessageTokens(rest[i]);
+            if (used + msgTokens > budget)
+                break;
+            kept.unshift(rest[i]);
+            used += msgTokens;
+        }
+        this.messages = systemMsg ? [systemMsg, ...kept] : kept;
+        return true;
+    }
+    estimateTokenCount() {
+        return this.messages.reduce((sum, m) => sum + this.estimateMessageTokens(m), 0);
+    }
+    estimateMessageTokens(message) {
+        const { content } = message;
+        if (content === null)
+            return 4;
+        // Use /3 divisor aligned with agent.ts estimation to avoid context window divergence
+        if (typeof content === 'string')
+            return Math.ceil(content.length / 3) + 4;
+        // Content array — sum text tokens + ~85 tokens per image
+        return content.reduce((sum, part) => {
+            if (part.type === 'text')
+                return sum + Math.ceil(part.text.length / 3);
+            if (part.type === 'image_url')
+                return sum + 85;
+            return sum;
+        }, 0) + 4;
+    }
+}
+//# sourceMappingURL=conversation.js.map

package/dist/agent/conversation.js.map

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

package/dist/agent/design-reinjection.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Dynamic design context re-injection.
+ *
+ * When an agent (main or Builder) writes/edits a UI file during a long
+ * session, its attention has usually drifted toward recent tool results
+ * (stack traces, build failures, edit diffs) and away from the session-start
+ * design context. By the time it makes the next design decision, the palette
+ * and voice files have faded out of the active attention window.
+ *
+ * This helper detects "about to touch a UI file" moments and returns a fresh
+ * system-message payload containing the current Decisions/design/ contents,
+ * suitable for injection into the next LLM call. The caller appends this
+ * payload to the messages array just before the next turn, placing the design
+ * context back into the most-recent-token attention slot where it can compete
+ * with whatever else is dominating her focus.
+ *
+ * This is the hardware-level fix for "flustered design degradation": by the
+ * time she makes a colour choice, the palette file is the freshest thing in
+ * her context, not the stack trace that just finished scrolling.
+ *
+ * The helper is intentionally stateless and cheap — it reads from disk every
+ * call, so user edits to Decisions/design/*.md take effect immediately
+ * without any cache invalidation plumbing.
+ */
+/**
+ * Return true if the given file path looks like a UI file where taste
+ * decisions (palette, typography, spacing, voice, layout) are likely to be
+ * embedded.
+ */
+export declare function isUIFilePath(filePath: string): boolean;
+/**
+ * Read the current contents of Decisions/design/*.md (and Decisions/overview.md,
+ * Decisions/context.md for framing) from the given project root. Returns a
+ * formatted string suitable for injection as a system message body, or null
+ * if the project has no Decisions folder or all files are empty.
+ *
+ * This reads from disk every call — intentional. User edits to these files
+ * take effect on the very next re-injection without any caching layer.
+ */
+export declare function loadFreshDesignContext(projectRoot: string): Promise<string | null>;
+/**
+ * Build the full system-message body for re-injection. Wraps the design
+ * context in framing that tells the model *why* this content is arriving
+ * mid-session: it's a deliberate refresh, not a duplicate. The framing
+ * matters because without it, the model might treat the injection as noise.
+ */
+export declare function formatDesignReinjectionMessage(designContext: string): string;
+/**
+ * Minimum number of agent turns that must pass between design-context
+ * re-injections. Prevents the same palette/voice/typography files from
+ * being read and injected 20 times in a session where Ava writes 20 UI
+ * files back-to-back. If design files are genuinely modified between
+ * turns, the mtime check still triggers re-injection regardless.
+ */
+export declare const REINJECTION_MIN_TURNS = 5;
+/**
+ * Per-Agent state for design re-injection throttling. Owned by the Agent
+ * instance and passed through on each call so the helper can decide
+ * whether to re-inject based on turn count and file-mtime changes.
+ */
+export interface ReinjectionState {
+    /** Current agent turn counter — incremented on each UI tool call. */
+    currentTurn: number;
+    /** Turn index at which the last re-injection fired. -Infinity if none yet. */
+    lastInjectedTurn: number;
+    /** Map of design file path → last-known mtime in ms. Updated on each injection. */
+    lastMtimes: Map<string, number>;
+}
+export interface ReinjectionResult {
+    content: string;
+    updatedMtimes: Map<string, number>;
+}
+/**
+ * One-shot helper: given a project root, a file path the agent is about
+ * to write to, and the per-Agent re-injection state, decide whether to
+ * re-inject the design context and return the result (or null if no
+ * injection is warranted).
+ *
+ * Throttling rules:
+ *   (a) If the file path isn't a UI file → no injection
+ *   (b) If the project has no Decisions folder → no injection
+ *   (c) If fewer than REINJECTION_MIN_TURNS turns have passed since the
+ *       last injection AND no design file has been modified since → no
+ *       injection (avoids burning tokens on duplicate context reads when
+ *       the agent writes many UI files back-to-back)
+ *   (d) Otherwise: read the design files fresh, build the injection
+ *       message, and return it along with the updated mtime map so the
+ *       caller can store it as the new cache baseline.
+ *
+ * All I/O is best-effort; any error silently returns null.
+ */
+export declare function maybeBuildDesignReinjection(projectRoot: string | undefined, filePath: string | undefined, state: ReinjectionState): Promise<ReinjectionResult | null>;
+//# sourceMappingURL=design-reinjection.d.ts.map

package/dist/agent/design-reinjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-reinjection.d.ts","sourceRoot":"","sources":["../../src/agent/design-reinjection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAuBH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAkBtD;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyCxF;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQ5E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAiDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA2BnC"}