@project-ava-supernova/core 0.2.71

package/dist/agent/system-prompt.js.map

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

package/dist/agent/task-classifier.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Task complexity classifier — a lightweight keyword + heuristic scorer that
+ * labels each incoming task as `focused`, `moderate`, or `architectural`.
+ *
+ * The label is injected into the agent's system prompt as a directness hint:
+ * focused tasks get a "be direct, minimum exploration" framing that stops the
+ * agent from running the full Scout → Architect → Verifier → Sequencer →
+ * Challenger → Builder chain for what should have been a one-file edit.
+ *
+ * Intentionally simple — no ML, no embedding lookup, no LLM round-trip. The
+ * scorer runs in microseconds on the user's message, defaults to `moderate`
+ * when unsure (safest middle ground), and can be overridden mid-run if the
+ * agent detects that the work is actually bigger than the classification
+ * suggested (graceful re-classification escalation).
+ *
+ * The whole point: 3M tokens for a sidebar redesign was the observed
+ * pathology. Most of those tokens were the conductor pipeline treating a
+ * focused visual change as if it were an architectural task. This classifier
+ * is the fix for that specific pattern: it tells the agent "this is small,
+ * stay small."
+ */
+export type TaskComplexity = 'focused' | 'moderate' | 'architectural';
+/**
+ * Budget hints per complexity class. These are soft targets used by the
+ * exploration budget tracker to decide when to nudge the agent. They're not
+ * hard limits — hard limits would cut tasks off mid-work, which is worse
+ * than the original problem. See exploration budget hook in agent.ts.
+ */
+export declare const COMPLEXITY_BUDGETS: Record<TaskComplexity, {
+    readCapBeforeFirstWrite: number;
+    tokenSoftTarget: number;
+}>;
+export interface ClassificationResult {
+    complexity: TaskComplexity;
+    confidence: 'low' | 'medium' | 'high';
+    reasoning: string;
+}
+/**
+ * Classify a user message's task complexity. Returns the label plus a short
+ * reasoning string used for logs and for injecting into the agent's directness
+ * hint (so Ava can see WHY her task was classified the way it was).
+ */
+export declare function classifyTaskComplexity(userMessage: string): ClassificationResult;
+/**
+ * Format the classification as a directness hint for injection into the
+ * system prompt. The hint is short, pointed, and tells the agent exactly
+ * how aggressively to scope its work.
+ */
+export declare function formatDirectnessHint(result: ClassificationResult): string;
+//# sourceMappingURL=task-classifier.d.ts.map

package/dist/agent/task-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-classifier.d.ts","sourceRoot":"","sources":["../../src/agent/task-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,cAAc,EAAE;IACtD,uBAAuB,EAAE,MAAM,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;CACzB,CAIA,CAAC;AAyDF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAmFhF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAsBzE"}

package/dist/agent/task-classifier.js

@@ -0,0 +1,187 @@
+/**
+ * Task complexity classifier — a lightweight keyword + heuristic scorer that
+ * labels each incoming task as `focused`, `moderate`, or `architectural`.
+ *
+ * The label is injected into the agent's system prompt as a directness hint:
+ * focused tasks get a "be direct, minimum exploration" framing that stops the
+ * agent from running the full Scout → Architect → Verifier → Sequencer →
+ * Challenger → Builder chain for what should have been a one-file edit.
+ *
+ * Intentionally simple — no ML, no embedding lookup, no LLM round-trip. The
+ * scorer runs in microseconds on the user's message, defaults to `moderate`
+ * when unsure (safest middle ground), and can be overridden mid-run if the
+ * agent detects that the work is actually bigger than the classification
+ * suggested (graceful re-classification escalation).
+ *
+ * The whole point: 3M tokens for a sidebar redesign was the observed
+ * pathology. Most of those tokens were the conductor pipeline treating a
+ * focused visual change as if it were an architectural task. This classifier
+ * is the fix for that specific pattern: it tells the agent "this is small,
+ * stay small."
+ */
+/**
+ * Budget hints per complexity class. These are soft targets used by the
+ * exploration budget tracker to decide when to nudge the agent. They're not
+ * hard limits — hard limits would cut tasks off mid-work, which is worse
+ * than the original problem. See exploration budget hook in agent.ts.
+ */
+export const COMPLEXITY_BUDGETS = {
+    focused: { readCapBeforeFirstWrite: 5, tokenSoftTarget: 200_000 },
+    moderate: { readCapBeforeFirstWrite: 12, tokenSoftTarget: 600_000 },
+    architectural: { readCapBeforeFirstWrite: 30, tokenSoftTarget: 2_000_000 },
+};
+// ─── Keyword dictionaries ───────────────────────────────────────────────────
+const FOCUSED_PHRASES = [
+    // Direct edit verbs
+    'tweak', 'adjust', 'rename', 'move', 'remove', 'delete',
+    'swap', 'replace', 'change the', 'edit', 'modify',
+    // Visual/taste tweaks
+    'redesign this', 'redesign the', 'restyle',
+    'polish', 'make this', 'make it',
+    // Minimising framing
+    'quick', 'small', 'simple', 'just ', 'minor',
+    'little ', 'trivial', 'one-liner', 'typo',
+    // Targeted scope
+    'this component', 'this file', 'this function',
+    'the sidebar', 'the header', 'the footer', 'the button',
+    'the modal', 'the card', 'the nav',
+    // Rename refactors
+    'rename', 'extract', 'inline',
+];
+const ARCHITECTURAL_PHRASES = [
+    // Build-from-scratch
+    'build a new', 'build the', 'create a new', 'set up',
+    'scaffold', 'bootstrap', 'from scratch', 'ground up',
+    // Migration / overhaul
+    'migrate', 'refactor the whole', 'refactor everything',
+    'rewrite', 'overhaul', 'redo the', 'redo all',
+    // System-level
+    'add support for', 'integrate with', 'connect to',
+    'new subsystem', 'new module', 'new service',
+    'architect', 'design the system', 'design the architecture',
+    // Broad scope
+    'across the', 'throughout', 'every', 'all of',
+    // Schema / data model
+    'schema', 'data model', 'database migration',
+];
+const MODERATE_PHRASES = [
+    // Medium-scope features
+    'add a', 'create a component', 'new page',
+    'new feature', 'implement', 'build out',
+    // Wiring work
+    'connect', 'wire up', 'hook up',
+    // Fix that might be deeper
+    'fix the bug', 'debug', 'investigate',
+];
+// File-extension references — rough proxy for scope
+const FILE_EXT_PATTERN = /\.(?:tsx?|jsx?|vue|svelte|astro|css|scss|sass|less|py|go|rs|java|rb|php|swift|kt|md|json|yaml|yml|toml|html|svg)\b/g;
+// Plural / "every file" signals → architectural
+const PLURAL_PHRASES = ['all ', 'every ', 'many ', 'multiple ', 'several ', 'throughout', 'across '];
+/**
+ * Classify a user message's task complexity. Returns the label plus a short
+ * reasoning string used for logs and for injecting into the agent's directness
+ * hint (so Ava can see WHY her task was classified the way it was).
+ */
+export function classifyTaskComplexity(userMessage) {
+    const lower = userMessage.toLowerCase().trim();
+    // Empty or trivially short messages → moderate default
+    if (lower.length < 4) {
+        return {
+            complexity: 'moderate',
+            confidence: 'low',
+            reasoning: 'empty or trivial message — defaulting to moderate',
+        };
+    }
+    // Count hits per category
+    const focusedHits = FOCUSED_PHRASES.filter(p => lower.includes(p));
+    const architecturalHits = ARCHITECTURAL_PHRASES.filter(p => lower.includes(p));
+    const moderateHits = MODERATE_PHRASES.filter(p => lower.includes(p));
+    // File references and plural signals
+    const fileMatches = userMessage.match(FILE_EXT_PATTERN) || [];
+    const fileCount = fileMatches.length;
+    const hasPluralSignal = PLURAL_PHRASES.some(p => lower.includes(p));
+    // ─── Architectural override conditions ─────────────────────────────────
+    // Any of these, regardless of other signals, force architectural:
+    //   - explicit architectural keyword
+    //   - mention of 4+ distinct files
+    //   - plural signals + medium-scope keywords
+    if (architecturalHits.length > 0) {
+        return {
+            complexity: 'architectural',
+            confidence: 'high',
+            reasoning: `architectural keyword${architecturalHits.length > 1 ? 's' : ''}: ${architecturalHits.slice(0, 3).join(', ')}`,
+        };
+    }
+    if (fileCount >= 4) {
+        return {
+            complexity: 'architectural',
+            confidence: 'medium',
+            reasoning: `${fileCount} file references → broad-scope work`,
+        };
+    }
+    if (hasPluralSignal && moderateHits.length > 0) {
+        return {
+            complexity: 'architectural',
+            confidence: 'medium',
+            reasoning: 'plural scope signal with medium-scope verb',
+        };
+    }
+    // ─── Focused override conditions ──────────────────────────────────────
+    // Two or more focused keywords → confident focused
+    // One focused keyword + no moderate/architectural signals → confident focused
+    // One focused keyword + moderate keyword → moderate
+    if (focusedHits.length >= 2 && moderateHits.length === 0) {
+        return {
+            complexity: 'focused',
+            confidence: 'high',
+            reasoning: `focused keywords: ${focusedHits.slice(0, 3).join(', ')}`,
+        };
+    }
+    if (focusedHits.length === 1 && moderateHits.length === 0 && fileCount <= 1) {
+        return {
+            complexity: 'focused',
+            confidence: 'medium',
+            reasoning: `focused keyword: "${focusedHits[0]}"`,
+        };
+    }
+    // ─── Moderate default ───────────────────────────────────────────────────
+    if (moderateHits.length > 0) {
+        return {
+            complexity: 'moderate',
+            confidence: 'medium',
+            reasoning: `moderate keyword${moderateHits.length > 1 ? 's' : ''}: ${moderateHits.slice(0, 2).join(', ')}`,
+        };
+    }
+    // Unclear → moderate (safe middle ground)
+    return {
+        complexity: 'moderate',
+        confidence: 'low',
+        reasoning: 'no strong signals — defaulting to moderate',
+    };
+}
+/**
+ * Format the classification as a directness hint for injection into the
+ * system prompt. The hint is short, pointed, and tells the agent exactly
+ * how aggressively to scope its work.
+ */
+export function formatDirectnessHint(result) {
+    const budget = COMPLEXITY_BUDGETS[result.complexity];
+    if (result.complexity === 'focused') {
+        return [
+            `**Task classification: FOCUSED** (${result.reasoning}).`,
+            `This is a small, targeted task. Be direct. Read at most ${budget.readCapBeforeFirstWrite} files before your first write. No elaborate planning. No "let me also check X" — if the task says "redesign the sidebar", find the sidebar file, redesign it, verify it compiles, stop. One read-then-write beats three reads followed by a write. Target effort: ~${Math.round(budget.tokenSoftTarget / 1000)}k tokens of total work.`,
+        ].join(' ');
+    }
+    if (result.complexity === 'architectural') {
+        return [
+            `**Task classification: ARCHITECTURAL** (${result.reasoning}).`,
+            `This is a system-level task. Take the time to plan carefully, understand the surface area, and verify your approach. The full Scout → Architect → Verifier → Sequencer → Challenger → Builder chain is justified here. Target effort: ~${Math.round(budget.tokenSoftTarget / 1_000_000)}M tokens of total work is reasonable for architectural scope.`,
+        ].join(' ');
+    }
+    // moderate
+    return [
+        `**Task classification: MODERATE** (${result.reasoning}).`,
+        `This is a mid-sized task. Scout the relevant files, plan your approach, execute directly. Don't over-verify small decisions but do verify structural ones. Target effort: ~${Math.round(budget.tokenSoftTarget / 1000)}k tokens of total work.`,
+    ].join(' ');
+}
+//# sourceMappingURL=task-classifier.js.map

package/dist/agent/task-classifier.js.map

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

package/dist/agent/text-tool-parser.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Text-based tool call parser for models that don't support native tool_calls.
+ *
+ * When a model lacks native function calling, we:
+ * 1. Inject tool descriptions into the system prompt as text
+ * 2. Instruct the model to output tool calls as XML blocks
+ * 3. Parse the XML blocks from the model's text response
+ * 4. Convert them into the standard ToolCall format
+ *
+ * Format used:
+ *   <tool_call>
+ *   {"name": "tool_name", "arguments": {"param": "value"}}
+ *   </tool_call>
+ */
+import type { ToolSchema } from '../providers/types.js';
+import type { ToolCall } from '../core/types.js';
+/**
+ * Generate a text description of available tools to inject into the system prompt.
+ */
+export declare function buildToolPrompt(schemas: ToolSchema[]): string;
+/**
+ * Parse tool calls from model text output.
+ * Returns the extracted tool calls and the text with tool_call blocks removed.
+ */
+export declare function parseToolCalls(text: string): {
+    toolCalls: ToolCall[];
+    cleanText: string;
+};
+/**
+ * Convert tool results back into a format the model can understand as text.
+ * For models without native tool support, tool results are injected as user messages.
+ */
+export declare function formatToolResult(toolName: string, result: string, success: boolean): string;
+//# sourceMappingURL=text-tool-parser.d.ts.map

package/dist/agent/text-tool-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-tool-parser.d.ts","sourceRoot":"","sources":["../../src/agent/text-tool-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAOjD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAiC7D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAiCzF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAK3F"}

package/dist/agent/text-tool-parser.js

@@ -0,0 +1,96 @@
+/**
+ * Text-based tool call parser for models that don't support native tool_calls.
+ *
+ * When a model lacks native function calling, we:
+ * 1. Inject tool descriptions into the system prompt as text
+ * 2. Instruct the model to output tool calls as XML blocks
+ * 3. Parse the XML blocks from the model's text response
+ * 4. Convert them into the standard ToolCall format
+ *
+ * Format used:
+ *   <tool_call>
+ *   {"name": "tool_name", "arguments": {"param": "value"}}
+ *   </tool_call>
+ */
+// Regex to match <tool_call>...</tool_call> blocks (lazy, dotAll)
+const TOOL_CALL_REGEX = /<tool_call>\s*([\s\S]*?)\s*<\/tool_call>/g;
+let _callCounter = 0;
+/**
+ * Generate a text description of available tools to inject into the system prompt.
+ */
+export function buildToolPrompt(schemas) {
+    if (schemas.length === 0)
+        return '';
+    const toolDescriptions = schemas.map((schema) => {
+        const fn = schema.function;
+        const params = fn.parameters;
+        const required = new Set(params.required ?? []);
+        const paramLines = Object.entries(params.properties).map(([name, def]) => {
+            const p = def;
+            const type = p.type ?? 'string';
+            const desc = p.description ?? '';
+            const req = required.has(name) ? ' (required)' : ' (optional)';
+            const enumValues = p.enum ? ` — one of: ${p.enum.join(', ')}` : '';
+            return `    - ${name}: ${type}${req} — ${desc}${enumValues}`;
+        });
+        return `### ${fn.name}\n${fn.description}\nParameters:\n${paramLines.join('\n')}`;
+    });
+    return `## Available Tools
+
+You have access to the following tools. To use a tool, output a <tool_call> block with the tool name and arguments as JSON:
+
+<tool_call>
+{"name": "tool_name", "arguments": {"param1": "value1", "param2": "value2"}}
+</tool_call>
+
+You can make multiple tool calls in a single response. Each must be in its own <tool_call> block.
+After each tool call, you will receive the result. Use the results to continue your work.
+Always explain what you're doing before and after tool calls.
+
+${toolDescriptions.join('\n\n')}`;
+}
+/**
+ * Parse tool calls from model text output.
+ * Returns the extracted tool calls and the text with tool_call blocks removed.
+ */
+export function parseToolCalls(text) {
+    const toolCalls = [];
+    let match;
+    // Reset regex state
+    TOOL_CALL_REGEX.lastIndex = 0;
+    while ((match = TOOL_CALL_REGEX.exec(text)) !== null) {
+        const jsonStr = match[1].trim();
+        try {
+            const parsed = JSON.parse(jsonStr);
+            const name = parsed.name;
+            const args = parsed.arguments ?? {};
+            if (typeof name === 'string' && name.length > 0) {
+                toolCalls.push({
+                    id: `text_tc_${++_callCounter}`,
+                    type: 'function',
+                    function: {
+                        name,
+                        arguments: typeof args === 'string' ? args : JSON.stringify(args),
+                    },
+                });
+            }
+        }
+        catch {
+            // Malformed JSON inside tool_call block — skip it
+        }
+    }
+    // Remove tool_call blocks from the text to get clean display content
+    const cleanText = text.replace(TOOL_CALL_REGEX, '').trim();
+    return { toolCalls, cleanText };
+}
+/**
+ * Convert tool results back into a format the model can understand as text.
+ * For models without native tool support, tool results are injected as user messages.
+ */
+export function formatToolResult(toolName, result, success) {
+    const status = success ? 'success' : 'error';
+    return `<tool_result name="${toolName}" status="${status}">
+${result}
+</tool_result>`;
+}
+//# sourceMappingURL=text-tool-parser.js.map

package/dist/agent/text-tool-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-tool-parser.js","sourceRoot":"","sources":["../../src/agent/text-tool-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,kEAAkE;AAClE,MAAM,eAAe,GAAG,2CAA2C,CAAC;AAEpE,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC3B,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE;YACvE,MAAM,CAAC,GAAG,GAA8B,CAAC;YACzC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC;YAChC,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;YAC/D,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAe,CAAC,CAAC,IAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,OAAO,SAAS,IAAI,KAAK,IAAI,GAAG,GAAG,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,WAAW,kBAAkB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,OAAO;;;;;;;;;;;;EAYP,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,IAAI,KAA6B,CAAC;IAElC,oBAAoB;IACpB,eAAe,CAAC,SAAS,GAAG,CAAC,CAAC;IAE9B,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;YAEpC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,SAAS,CAAC,IAAI,CAAC;oBACb,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE;oBAC/B,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE;wBACR,IAAI;wBACJ,SAAS,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;qBAClE;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE3D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,MAAc,EAAE,OAAgB;IACjF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7C,OAAO,sBAAsB,QAAQ,aAAa,MAAM;EACxD,MAAM;eACO,CAAC;AAChB,CAAC"}

package/dist/agent/vision-bridge.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Vision bridge — let a TEXT-ONLY coordinator "see" images.
+ *
+ * Models like DeepSeek V4 (Supernova) and Mistral Codestral (Aurora) have no
+ * vision. When an image is attached, instead of stripping it and telling the
+ * user to switch models, we run a vision-capable model (e.g. Qwen 3.5 Omni
+ * Plus) ONCE to describe the image, then inject that description as text — so
+ * the text-only model can act on it as if it had seen it.
+ *
+ * Shared by the main Agent and the Conductor (per-persona) so direct turns and
+ * orchestrated turns behave the same. Descriptions are cached per image (by
+ * data URL) so we don't re-run the vision model every turn.
+ */
+import type { Provider } from '../providers/types.js';
+import type { ModelDefinition, Message } from '../core/types.js';
+/** Describe a single image with the vision model. Cached by data URL; returns
+ *  null on failure or timeout so callers can fall back gracefully. */
+export declare function describeImageWithVision(visionProvider: Provider, visionModel: ModelDefinition, image: {
+    url: string;
+    detail?: string;
+}, cache: Map<string, string>): Promise<string | null>;
+/**
+ * For a TEXT-ONLY model, return a copy of `messages` where image content is
+ * replaced by a vision-model description (or a "switch model" note when no
+ * vision provider is configured), and image-free array content is flattened to
+ * a string. No-op (returns the same array) for vision-capable models.
+ */
+export declare function bridgeImagesForTextModel(messages: Message[], model: ModelDefinition, visionProvider: Provider | undefined, visionModel: ModelDefinition | undefined, cache: Map<string, string>): Promise<Message[]>;
+//# sourceMappingURL=vision-bridge.d.ts.map

package/dist/agent/vision-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision-bridge.d.ts","sourceRoot":"","sources":["../../src/agent/vision-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAe,MAAM,kBAAkB,CAAC;AAW9E;sEACsE;AACtE,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,QAAQ,EACxB,WAAW,EAAE,eAAe,EAC5B,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACvC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2BxB;AA6BD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,QAAQ,GAAG,SAAS,EACpC,WAAW,EAAE,eAAe,GAAG,SAAS,EACxC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,OAAO,CAAC,OAAO,EAAE,CAAC,CAoDpB"}

package/dist/agent/vision-bridge.js

@@ -0,0 +1,143 @@
+/**
+ * Vision bridge — let a TEXT-ONLY coordinator "see" images.
+ *
+ * Models like DeepSeek V4 (Supernova) and Mistral Codestral (Aurora) have no
+ * vision. When an image is attached, instead of stripping it and telling the
+ * user to switch models, we run a vision-capable model (e.g. Qwen 3.5 Omni
+ * Plus) ONCE to describe the image, then inject that description as text — so
+ * the text-only model can act on it as if it had seen it.
+ *
+ * Shared by the main Agent and the Conductor (per-persona) so direct turns and
+ * orchestrated turns behave the same. Descriptions are cached per image (by
+ * data URL) so we don't re-run the vision model every turn.
+ */
+import { logger } from '../core/logger.js';
+import { avaEvents } from '../dataset/emitter.js';
+const DESCRIBE_PROMPT = 'You are a vision relay for a text-only AI coding/agent model that CANNOT see this image. ' +
+    'Describe it in thorough, specific detail so that model can act on it as if it had seen it. ' +
+    'Transcribe ALL visible text, code, error messages and UI labels verbatim. Describe layout, ' +
+    'components, colours, shapes and anything a developer would need. Do not summarise away detail, ' +
+    'and do not add commentary — just the description.';
+/** Describe a single image with the vision model. Cached by data URL; returns
+ *  null on failure or timeout so callers can fall back gracefully. */
+export async function describeImageWithVision(visionProvider, visionModel, image, cache) {
+    if (!image?.url)
+        return null;
+    const cached = cache.get(image.url);
+    if (cached)
+        return cached;
+    try {
+        const response = await Promise.race([
+            visionProvider.createCompletion({
+                model: visionModel.id,
+                messages: [{
+                        role: 'user',
+                        content: [
+                            { type: 'image_url', image_url: image },
+                            { type: 'text', text: DESCRIBE_PROMPT },
+                        ],
+                    }],
+                max_tokens: 900,
+            }),
+            new Promise((resolve) => setTimeout(() => resolve(null), 45_000)),
+        ]);
+        const content = response?.choices?.[0]?.message?.content;
+        const desc = typeof content === 'string' ? content.trim() : '';
+        if (desc) {
+            cache.set(image.url, desc);
+            return desc;
+        }
+        return null;
+    }
+    catch (err) {
+        logger.debug(`[vision-bridge] describe failed: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+/**
+ * What the model is handed when it can't see and no relay is available.
+ *
+ * This is addressed to Ava, not to the user, and it deliberately does NOT read
+ * like an error: a model without vision is a known property of the model the
+ * user picked, not a failure. Ava explains it herself, in her own voice, and
+ * carries on — errors are reserved for things that actually went wrong.
+ *
+ * It points at the picker's affordance rather than naming models, because a
+ * hard-coded roster goes stale (this note used to recommend Kimi K2.5 and
+ * "Mistral Large") whereas the struck-through paperclip is always current.
+ */
+function fallbackNote(model) {
+    return [
+        `[Context for you — not a message from the user, and not an error.`,
+        `They attached an image, but ${model.name || model.id} has no vision and no vision`,
+        `relay is available right now, so you genuinely cannot see it.`,
+        ``,
+        `Tell them briefly and plainly, in your own voice, that you can't see images on this`,
+        `model. Don't apologise at length and don't frame it as something broken — it's a`,
+        `property of the model they chose. Offer the two ways forward: switch to a`,
+        `vision-capable model (the model picker strikes through the paperclip on any model`,
+        `that can't read images), or describe the image and you'll work from their`,
+        `description. Then get on with whatever else they asked for.]`,
+    ].join('\n');
+}
+/**
+ * For a TEXT-ONLY model, return a copy of `messages` where image content is
+ * replaced by a vision-model description (or a "switch model" note when no
+ * vision provider is configured), and image-free array content is flattened to
+ * a string. No-op (returns the same array) for vision-capable models.
+ */
+export async function bridgeImagesForTextModel(messages, model, visionProvider, visionModel, cache) {
+    if (model.supportsVision)
+        return messages;
+    const out = [];
+    // Dataset signal accounting (shape-only) — totals across this turn's messages.
+    let totalImages = 0;
+    let totalDescribed = 0;
+    const startedAt = Date.now();
+    for (const m of messages) {
+        if (!Array.isArray(m.content)) {
+            out.push(m);
+            continue;
+        }
+        const parts = m.content;
+        const textPrefix = parts.filter((p) => p.type === 'text').map((p) => p.text).join('\n');
+        const imageParts = parts.filter((p) => p.type === 'image_url');
+        if (imageParts.length === 0) {
+            out.push({ ...m, content: textPrefix });
+            continue;
+        }
+        totalImages += imageParts.length;
+        let block;
+        if (visionProvider && visionModel) {
+            const descs = [];
+            for (const part of imageParts) {
+                const img = part.image_url;
+                const d = img ? await describeImageWithVision(visionProvider, visionModel, img, cache) : null;
+                if (d)
+                    descs.push(d);
+            }
+            totalDescribed += descs.length;
+            block = descs.length
+                ? `[Image — described for you by a vision model:\n${descs.join('\n\n---\n\n')}\n]`
+                : fallbackNote(model);
+        }
+        else {
+            block = fallbackNote(model);
+        }
+        out.push({ ...m, content: textPrefix ? `${textPrefix}\n\n${block}` : block });
+    }
+    // ── Dataset event: the vision bridge ran for a text-only coordinator ──
+    // Only when images were actually present. Shape-only: model id, counts,
+    // latency, and whether descriptions were produced (vs a fallback note).
+    if (totalImages > 0) {
+        avaEvents.emit('vision_bridge', {
+            describer_model: visionModel?.id ?? 'none',
+            image_count: totalImages,
+            described_count: totalDescribed,
+            latency_ms: Date.now() - startedAt,
+            success: totalDescribed > 0,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=vision-bridge.js.map

package/dist/agent/vision-bridge.js.map

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

package/dist/audit/cost.d.ts

@@ -0,0 +1,18 @@
+import type { AuditCost } from './types.js';
+/** Compute the cost record for an audit entry. Tools that don't carry
+ *  token counts (file_read, ls, etc.) get an empty cost — they're free
+ *  in both billing models. Returns undefined when there's nothing to
+ *  attribute, so the receipt UI can render a dash instead of "$0.00". */
+export declare function computeCost(opts: {
+    mode: 'platform' | 'byok';
+    toolName: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    provider?: string;
+    model?: string;
+    cacheHit?: boolean;
+}): AuditCost | undefined;
+/** Format a cost record for display. Returns a short string suitable
+ *  for table cells: "12 credits", "$0.04", "—" when no cost data. */
+export declare function formatCost(cost: AuditCost | undefined): string;
+//# sourceMappingURL=cost.d.ts.map

package/dist/audit/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/audit/cost.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA4G5C;;;yEAGyE;AACzE,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,SAAS,GAAG,SAAS,CAyBxB;AAoBD;qEACqE;AACrE,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAK9D"}