@visorcraft/idlehands 0.9.1

package/dist/confirm/terminal.js

@@ -0,0 +1,90 @@
+/**
+ * TerminalConfirmProvider — interactive readline-based confirmation.
+ * Implements Phase 8c: diff preview, shell prompts, remembered decisions.
+ */
+export class TerminalConfirmProvider {
+    rl;
+    /**
+     * Remembered decisions: keyed by tool+identifier.
+     * If a user approves `exec:npm test` once, we auto-approve it for the rest of the session.
+     */
+    remembered = new Map();
+    constructor(rl) {
+        this.rl = rl;
+    }
+    async confirm(opts) {
+        // Check remembered decisions
+        const memKey = this.memoryKey(opts);
+        if (memKey && this.remembered.has(memKey)) {
+            const decision = this.remembered.get(memKey);
+            const tag = decision ? '✓' : '✗';
+            console.error(`\x1b[2m[remembered ${tag}] ${opts.summary}\x1b[0m`);
+            return decision;
+        }
+        const hasDiff = Boolean(opts.diff);
+        const prompt = this.formatPrompt(opts, hasDiff);
+        const ans = (await this.rl.question(prompt)).trim().toLowerCase();
+        // Handle diff request
+        if (hasDiff && (ans === 'd' || ans === 'diff')) {
+            console.log(opts.diff);
+            // Re-prompt after showing diff
+            const ans2 = (await this.rl.question('Apply? [Y/n] ')).trim().toLowerCase();
+            const approved = ans2 === '' || ans2 === 'y' || ans2 === 'yes';
+            if (memKey)
+                this.remembered.set(memKey, approved);
+            return approved;
+        }
+        const approved = ans === '' || ans === 'y' || ans === 'yes';
+        if (memKey)
+            this.remembered.set(memKey, approved);
+        return approved;
+    }
+    async showBlocked(opts) {
+        console.error(`\x1b[31m[blocked]\x1b[0m ${opts.tool}: ${opts.reason}`);
+    }
+    /** Clear remembered decisions (e.g. on session reset). */
+    clearRemembered() {
+        this.remembered.clear();
+    }
+    /**
+     * Generate a memory key for a tool+args combination.
+     * - exec: keyed by command string
+     * - file tools: keyed by path
+     * - other: null (don't remember)
+     */
+    memoryKey(opts) {
+        if (opts.tool === 'exec') {
+            const cmd = typeof opts.args.command === 'string' ? opts.args.command : '';
+            return cmd ? `exec:${cmd}` : null;
+        }
+        if (opts.tool === 'edit_file' || opts.tool === 'write_file' || opts.tool === 'insert_file') {
+            const p = typeof opts.args.path === 'string' ? opts.args.path : '';
+            return p ? `${opts.tool}:${p}` : null;
+        }
+        return null;
+    }
+    formatPrompt(opts, hasDiff) {
+        if (opts.tool === 'exec') {
+            const cmd = typeof opts.args.command === 'string' ? opts.args.command : opts.summary;
+            return this.boxedPrompt(`Run: ${cmd}`, '[Y/n]');
+        }
+        if (hasDiff) {
+            // Show summary with diff option
+            return this.boxedPrompt(opts.summary, '[Y/n/diff]');
+        }
+        return this.boxedPrompt(opts.summary, '[Y/n]');
+    }
+    /** Format a boxed prompt: ┌─ summary ─┐ with action hints */
+    boxedPrompt(summary, suffix) {
+        const maxW = Math.min(process.stdout.columns ?? 80, 80);
+        const inner = summary.length > maxW - 6 ? summary.slice(0, maxW - 9) + '...' : summary;
+        const border = '─'.repeat(Math.max(inner.length + 2, 20));
+        const lines = [
+            `┌${border}┐`,
+            `│ ${inner.padEnd(border.length - 1)}│`,
+            `└${border}┘`
+        ];
+        return `${lines.join('\n')}\n${suffix} `;
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/confirm/terminal.js.map

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

package/dist/context.js

@@ -0,0 +1,49 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { estimateTokens } from './utils.js';
+async function readIfExists(p) {
+    try {
+        const st = await fs.stat(p);
+        if (!st.isFile())
+            return null;
+        return await fs.readFile(p, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+export async function loadProjectContext(cfg) {
+    if (cfg.no_context)
+        return '';
+    const maxTokens = cfg.context_max_tokens ?? 8192;
+    const cwd = cfg.dir ? path.resolve(cfg.dir) : process.cwd();
+    // Build candidate list: explicit override first, then search-order names
+    const candidates = [];
+    if (cfg.context_file && cfg.context_file.trim()) {
+        candidates.push(cfg.context_file.trim());
+    }
+    const names = cfg.context_file_names?.length ? cfg.context_file_names : [];
+    for (const n of names)
+        candidates.push(n);
+    // First match wins (plan §9b)
+    for (const f of candidates) {
+        const abs = path.isAbsolute(f) ? f : path.join(cwd, f);
+        const txt = await readIfExists(abs);
+        if (!txt)
+            continue;
+        const chunk = `[Project context from ${abs}]\n${txt.trim()}\n[End project context]`;
+        const t = estimateTokens(chunk);
+        if (t > maxTokens) {
+            throw new Error(`Project context file is ~${t} tokens (${abs}). Max is ${maxTokens}. ` +
+                `Trim it or use --no-context to skip.`);
+        }
+        if (t > 2048) {
+            // Warn but still include (plan §9b: 2049–8192 range)
+            const warn = `[note: project context is ~${t} tokens — consider trimming ${path.basename(abs)}]`;
+            return `${warn}\n${chunk}`;
+        }
+        return chunk;
+    }
+    return '';
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,KAAK,UAAU,YAAY,CAAC,CAAS;IACnC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAoB;IAC3D,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAE9B,MAAM,SAAS,GAAG,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC;IACjD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAE5D,yEAAyE;IACzE,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;QAChD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE1C,8BAA8B;IAC9B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,MAAM,KAAK,GAAG,yBAAyB,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,yBAAyB,CAAC;QACpF,MAAM,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEhC,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,4BAA4B,CAAC,YAAY,GAAG,aAAa,SAAS,IAAI;gBACtE,sCAAsC,CACvC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;YACb,qDAAqD;YACrD,MAAM,IAAI,GAAG,8BAA8B,CAAC,+BAA+B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YACjG,OAAO,GAAG,IAAI,KAAK,KAAK,EAAE,CAAC;QAC7B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/git.js

@@ -0,0 +1,136 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { BASH_PATH as BASH } from './utils.js';
+async function sh(cmd, cwd, timeoutSec) {
+    return await new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(BASH, ['-lc', cmd], { cwd, stdio: ['ignore', 'pipe', 'ignore'] });
+        }
+        catch {
+            resolve({ rc: 127, out: '' });
+            return;
+        }
+        const out = [];
+        const t = setTimeout(() => child.kill('SIGKILL'), Math.max(1, timeoutSec) * 1000);
+        child.on('error', () => {
+            clearTimeout(t);
+            resolve({ rc: 127, out: '' });
+        });
+        child.stdout.on('data', (d) => out.push(d));
+        child.on('close', (code) => {
+            clearTimeout(t);
+            resolve({ rc: code ?? 0, out: Buffer.concat(out).toString('utf8') });
+        });
+    });
+}
+function clipLines(s, maxLines, maxChars) {
+    const lines = s.split(/\r?\n/).filter(Boolean);
+    const clipped = lines.slice(0, maxLines);
+    let out = clipped.join('\n');
+    if (out.length > maxChars)
+        out = out.slice(0, maxChars) + '\n[truncated]';
+    if (lines.length > maxLines)
+        out += `\n[truncated: ${lines.length - maxLines} more lines]`;
+    return out;
+}
+export async function loadGitContext(cwd) {
+    // Avoid slow git operations; keep it short and bounded.
+    const inside = await sh('git rev-parse --is-inside-work-tree', cwd, 1);
+    if (inside.rc !== 0 || !inside.out.trim().startsWith('true'))
+        return '';
+    const branch = await sh('git rev-parse --abbrev-ref HEAD', cwd, 1);
+    const status = await sh('git status -s', cwd, 2);
+    const diffstat = await sh('git diff --stat', cwd, 2);
+    const recent = await sh('git log --oneline -5', cwd, 2);
+    const parts = [];
+    parts.push(`[git branch: ${branch.out.trim() || 'unknown'}]`);
+    const st = clipLines(status.out, 40, 2000);
+    if (st.trim()) {
+        parts.push('[git status -s]');
+        parts.push(st);
+    }
+    const ds = clipLines(diffstat.out, 40, 2000);
+    if (ds.trim()) {
+        parts.push('[git diff --stat]');
+        parts.push(ds);
+    }
+    const lg = clipLines(recent.out, 8, 1200);
+    if (lg.trim()) {
+        parts.push('[git log --oneline -5]');
+        parts.push(lg);
+    }
+    return parts.join('\n');
+}
+export function isGitDirty(cwd) {
+    const inside = spawnSync(BASH, ['-lc', 'git rev-parse --is-inside-work-tree'], { cwd, encoding: 'utf8', timeout: 1000 });
+    if (inside.status !== 0 || !String(inside.stdout || '').trim().startsWith('true'))
+        return false;
+    const st = spawnSync(BASH, ['-lc', 'git status --porcelain'], { cwd, encoding: 'utf8', timeout: 1500 });
+    return st.status === 0 && String(st.stdout || '').trim().length > 0;
+}
+export function stashWorkingTree(cwd) {
+    const stamp = new Date().toISOString();
+    const res = spawnSync(BASH, ['-lc', `git stash push -u -m "idlehands auto-stash ${stamp}"`], { cwd, encoding: 'utf8', timeout: 5000 });
+    const out = `${res.stdout || ''}${res.stderr || ''}`.trim();
+    if (res.status === 0)
+        return { ok: true, message: out || 'stashed' };
+    return { ok: false, message: out || `git stash failed (rc=${res.status ?? 1})` };
+}
+export async function loadGitStartupSummary(cwd) {
+    const inside = await sh('git rev-parse --is-inside-work-tree', cwd, 1);
+    if (inside.rc !== 0 || !inside.out.trim().startsWith('true'))
+        return '';
+    const branch = (await sh('git rev-parse --abbrev-ref HEAD', cwd, 1)).out.trim() || 'unknown';
+    const status = (await sh('git status --porcelain', cwd, 2)).out.split(/\r?\n/).filter(Boolean);
+    const modified = status.filter((l) => /^[ MARC][MDARC]/.test(l) || /^[MDARC][ MARC]/.test(l)).length;
+    const untracked = status.filter((l) => l.startsWith('??')).length;
+    return `${modified} modified files, ${untracked} untracked, on branch ${branch}`;
+}
+export function ensureCleanWorkingTree(cwd) {
+    if (isGitDirty(cwd)) {
+        throw new Error("Anton: Working tree not clean. Commit or stash first.");
+    }
+}
+export function getWorkingDiff(cwd) {
+    const inside = spawnSync(BASH, ['-lc', 'git rev-parse --is-inside-work-tree'], { cwd, encoding: 'utf8', timeout: 1000 });
+    if (inside.status !== 0 || !String(inside.stdout || '').trim().startsWith('true'))
+        return '';
+    const res = spawnSync(BASH, ['-lc', 'git diff HEAD'], { cwd, encoding: 'utf8', timeout: 30000 });
+    return String(res.stdout || '');
+}
+export function commitAll(cwd, message) {
+    const res = spawnSync(BASH, ['-lc', `git add -A && git commit -m ${JSON.stringify(message)}`], { cwd, encoding: 'utf8', timeout: 30000 });
+    if (res.status !== 0) {
+        // Check if it's because there's nothing to commit
+        const status = spawnSync(BASH, ['-lc', 'git status --porcelain'], { cwd, encoding: 'utf8', timeout: 1500 });
+        if (status.status === 0 && String(status.stdout || '').trim().length === 0) {
+            return '';
+        }
+        throw new Error(`git commit failed: ${res.stderr || res.stdout || 'unknown error'}`);
+    }
+    // Get the commit hash
+    const hashRes = spawnSync(BASH, ['-lc', 'git rev-parse --short HEAD'], { cwd, encoding: 'utf8', timeout: 30000 });
+    return String(hashRes.stdout || '').trim();
+}
+export function commitAmend(cwd) {
+    const res = spawnSync(BASH, ['-lc', 'git add -A && git commit --amend --no-edit'], { cwd, encoding: 'utf8', timeout: 30000 });
+    if (res.status !== 0) {
+        throw new Error(`git commit --amend failed: ${res.stderr || res.stdout || 'unknown error'}`);
+    }
+}
+export function restoreTrackedChanges(cwd) {
+    spawnSync(BASH, ['-lc', 'git checkout -- .'], { cwd, encoding: 'utf8', timeout: 30000 });
+}
+export function cleanUntracked(cwd) {
+    const res = spawnSync(BASH, ['-lc', 'git clean -fd'], { cwd, encoding: 'utf8', timeout: 30000 });
+    if (res.status !== 0) {
+        throw new Error(`git clean failed: ${res.stderr || res.stdout || 'unknown error'}`);
+    }
+}
+export function createBranch(cwd, name) {
+    const res = spawnSync(BASH, ['-lc', `git checkout -b ${JSON.stringify(name)}`], { cwd, encoding: 'utf8', timeout: 30000 });
+    if (res.status !== 0) {
+        throw new Error(`git checkout -b failed: ${res.stderr || res.stdout || 'unknown error'}`);
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/harnesses.js

@@ -0,0 +1,171 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { configDir } from './utils.js';
+/** Default behavioral configs used to fill gaps in user-defined harnesses and inline definitions */
+const DEFAULT_THINKING = { format: 'xml', openTag: '<think>', closeTag: '</think>', strip: true };
+const DEFAULT_TOOL_CALLS = { reliableToolCallsArray: false, contentFallbackLikely: true, parallelCalls: true, retryOnMalformed: 3 };
+const DEFAULT_QUIRKS = { omitsRequiredParams: false, loopsOnToolError: false, emitsMarkdownInToolArgs: false, needsExplicitToolCallFormatReminder: false };
+const QUIRKS_NEEDS_REMINDER = { ...DEFAULT_QUIRKS, needsExplicitToolCallFormatReminder: true };
+const HARNESS = [
+    {
+        id: 'qwen3-coder',
+        match: [/qwen3-coder/i],
+        description: 'Qwen3-Coder family (tool-native MoE)',
+        defaults: { temperature: 0.2, top_p: 0.95, max_tokens: 32768, trifecta: { vaultMode: 'active' } },
+        thinking: { format: 'xml', openTag: '<think>', closeTag: '</think>', strip: true },
+        toolCalls: { reliableToolCallsArray: false, contentFallbackLikely: true, parallelCalls: true, retryOnMalformed: 3 },
+        quirks: DEFAULT_QUIRKS,
+        systemPromptSuffix: 'Prefer write_file over edit_file when replacing large sections or rewriting files. edit_file is only for small, surgical changes where you can reproduce the exact old_text.\nWhen answering questions about code, search first (search_files or grep), then read only the relevant files. Never scan an entire directory by reading files one by one.'
+    },
+    {
+        id: 'qwen3-moe',
+        match: [/qwen3/i],
+        description: 'Qwen3 MoE family (non-coder variants)',
+        defaults: { temperature: 0.2, top_p: 0.95, max_tokens: 16384, trifecta: { vaultMode: 'passive' } },
+        thinking: { format: 'xml', openTag: '<think>', closeTag: '</think>', strip: true },
+        toolCalls: { reliableToolCallsArray: true, contentFallbackLikely: true, parallelCalls: true, retryOnMalformed: 2 },
+        quirks: QUIRKS_NEEDS_REMINDER
+    },
+    {
+        id: 'qwen',
+        match: [/qwen/i],
+        description: 'Qwen family (generic, includes Qwen2.5)',
+        defaults: { temperature: 0.2, top_p: 0.95, max_tokens: 16384, trifecta: { vaultMode: 'passive' } },
+        thinking: { format: 'none', strip: false },
+        toolCalls: { reliableToolCallsArray: true, contentFallbackLikely: true, parallelCalls: true, retryOnMalformed: 2 },
+        quirks: QUIRKS_NEEDS_REMINDER
+    },
+    {
+        id: 'nemotron',
+        match: [/nemotron/i],
+        description: 'Nemotron family — loops on errors, omits params, low agent quality',
+        defaults: { temperature: 0.2, top_p: 0.95, max_tokens: 16384, trifecta: { vaultMode: 'passive' } },
+        thinking: { format: 'none', strip: false },
+        toolCalls: { reliableToolCallsArray: false, contentFallbackLikely: true, parallelCalls: false, retryOnMalformed: 1 },
+        quirks: { ...QUIRKS_NEEDS_REMINDER, omitsRequiredParams: true, loopsOnToolError: true, maxIterationsOverride: 10 }
+    },
+    {
+        id: 'mistral',
+        match: [/mistral/i],
+        description: 'Mistral family — no thinking tokens, may need chat-template-file',
+        defaults: { temperature: 0.2, top_p: 0.95, max_tokens: 16384, trifecta: { vaultMode: 'passive' } },
+        thinking: { format: 'none', strip: false },
+        toolCalls: { reliableToolCallsArray: true, contentFallbackLikely: false, parallelCalls: true, retryOnMalformed: 2 },
+        quirks: DEFAULT_QUIRKS
+    },
+    {
+        id: 'gpt-oss',
+        match: [/gpt-oss/i, /gpt_oss/i],
+        description: 'GPT-OSS — correct tool format but bad decisions, scans everything',
+        defaults: { temperature: 0.2, top_p: 0.95, max_tokens: 16384, trifecta: { vaultMode: 'passive' } },
+        thinking: { format: 'none', strip: false },
+        toolCalls: { reliableToolCallsArray: true, contentFallbackLikely: false, parallelCalls: true, retryOnMalformed: 2 },
+        quirks: { ...DEFAULT_QUIRKS, maxIterationsOverride: 10 },
+        systemPromptSuffix: 'When answering questions about code, search first (search_files or grep), then read only the relevant files. Never scan an entire directory by reading files one by one.'
+    },
+    {
+        id: 'llama',
+        match: [/llama/i],
+        description: 'Llama family (llama.cpp style)',
+        defaults: { temperature: 0.2, top_p: 0.95, max_tokens: 16384, trifecta: { vaultMode: 'passive' } },
+        thinking: { format: 'none', strip: false },
+        toolCalls: { reliableToolCallsArray: false, contentFallbackLikely: true, parallelCalls: false, retryOnMalformed: 2 },
+        quirks: QUIRKS_NEEDS_REMINDER,
+        systemPromptSuffix: 'When answering questions about code, search first (search_files or grep), then read only the relevant files. Never scan an entire directory by reading files one by one.'
+    },
+    {
+        id: 'generic',
+        match: [/.*/],
+        description: 'Generic fallback harness — conservative, all fallbacks enabled',
+        defaults: { temperature: 0.2, top_p: 0.95, max_tokens: 16384, trifecta: { vaultMode: 'passive' } },
+        thinking: { format: 'xml', openTag: '<think>', closeTag: '</think>', strip: true },
+        toolCalls: { reliableToolCallsArray: false, contentFallbackLikely: true, parallelCalls: true, retryOnMalformed: 3 },
+        quirks: DEFAULT_QUIRKS,
+        systemPromptSuffix: 'When answering questions about code, search first (search_files or grep), then read only the relevant files. Never scan an entire directory by reading files one by one.'
+    }
+];
+/**
+ * Load user-defined harnesses from ~/.config/idlehands/harnesses/*.json
+ * User harnesses with the same `id` override built-ins.
+ * Match patterns are converted from strings to RegExps (case-insensitive).
+ */
+function loadUserHarnesses() {
+    const dir = join(configDir(), 'harnesses');
+    let files;
+    try {
+        files = readdirSync(dir).filter(f => f.endsWith('.json'));
+    }
+    catch {
+        return [];
+    }
+    const result = [];
+    for (const f of files) {
+        try {
+            const raw = JSON.parse(readFileSync(join(dir, f), 'utf8'));
+            if (!raw.id || !raw.match)
+                continue;
+            const harness = {
+                id: String(raw.id),
+                match: (Array.isArray(raw.match) ? raw.match : [raw.match]).map((m) => new RegExp(String(m), 'i')),
+                description: String(raw.description ?? `User harness: ${raw.id}`),
+                supportsVision: typeof raw.supportsVision === 'boolean' ? raw.supportsVision : undefined,
+                defaults: {
+                    temperature: raw.params?.temperature ?? raw.defaults?.temperature,
+                    top_p: raw.params?.top_p ?? raw.defaults?.top_p,
+                    max_tokens: raw.params?.max_tokens ?? raw.defaults?.max_tokens,
+                    trifecta: raw.defaults?.trifecta
+                },
+                thinking: { ...DEFAULT_THINKING, ...(raw.thinking ?? {}) },
+                toolCalls: { ...DEFAULT_TOOL_CALLS, ...(raw.toolCalls ?? {}) },
+                quirks: { ...DEFAULT_QUIRKS, ...(raw.quirks ?? {}) },
+                systemPromptSuffix: raw.systemPromptSuffix
+            };
+            result.push(harness);
+        }
+        catch (e) {
+            console.warn(`[warn] failed to load harness ${f}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return result;
+}
+let _mergedHarnesses = null;
+/** Get the merged harness list (built-in + user overrides). Cached after first call. */
+function getMergedHarnesses() {
+    if (_mergedHarnesses)
+        return _mergedHarnesses;
+    const user = loadUserHarnesses();
+    if (!user.length) {
+        _mergedHarnesses = HARNESS;
+        return HARNESS;
+    }
+    // User harnesses override built-ins by id, then remaining built-ins follow
+    const userIds = new Set(user.map(h => h.id));
+    const merged = [
+        ...user,
+        ...HARNESS.filter(h => !userIds.has(h.id))
+    ];
+    _mergedHarnesses = merged;
+    return merged;
+}
+/** Reset the cached harness list (for testing) */
+export function _resetHarnessCache() {
+    _mergedHarnesses = null;
+}
+export function selectHarness(modelId, overrideId) {
+    const harnesses = getMergedHarnesses();
+    if (overrideId) {
+        const h = harnesses.find((x) => x.id === overrideId);
+        if (h)
+            return h;
+    }
+    for (const h of harnesses) {
+        for (const m of h.match) {
+            if (typeof m === 'string' && modelId.includes(m))
+                return h;
+            if (m instanceof RegExp && m.test(modelId))
+                return h;
+        }
+    }
+    return harnesses[harnesses.length - 1];
+}
+//# sourceMappingURL=harnesses.js.map

package/dist/harnesses.js.map

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

package/dist/history.js

@@ -0,0 +1,139 @@
+// Pre-compiled regex for think-block stripping (avoids re-creation per call)
+const THINK_RE = /<think>([\s\S]*?)<\/think>/gi;
+const THINKING_RE = /<thinking>([\s\S]*?)<\/thinking>/gi;
+export function stripThinking(text) {
+    // Support <think>...</think> and <thinking>...</thinking>
+    const thinkBlocks = [];
+    let visible = text;
+    for (const re of [THINK_RE, THINKING_RE]) {
+        re.lastIndex = 0; // reset stateful global regex
+        visible = visible.replace(re, (_m, g1) => {
+            thinkBlocks.push(String(g1));
+            return '';
+        });
+    }
+    return { visible: visible.trim(), thinking: thinkBlocks.join('\n\n').trim() };
+}
+function messageContentChars(content) {
+    if (!content)
+        return 0;
+    if (typeof content === 'string')
+        return content.length;
+    let total = 0;
+    for (const part of content) {
+        if (part.type === 'text')
+            total += part.text.length;
+        else if (part.type === 'image_url')
+            total += (part.image_url?.url?.length ?? 0) + 16;
+    }
+    return total;
+}
+export function estimateTokensFromMessages(messages) {
+    // crude: chars/4 + overhead per message + tool_calls JSON estimate
+    let chars = 0;
+    for (const m of messages) {
+        chars += messageContentChars(m.content) + 20;
+        // Account for tool_calls JSON in assistant messages (function name + arguments)
+        const tc = m.tool_calls;
+        if (Array.isArray(tc)) {
+            for (const t of tc) {
+                chars += (t.function?.name?.length ?? 0) + (t.function?.arguments?.length ?? 0) + 30;
+            }
+        }
+    }
+    return Math.ceil(chars / 4);
+}
+/**
+ * Estimate tokens consumed by tool schemas (JSON.stringify / 4).
+ * Callers should pass the actual tool array so the budget reflects the real schema footprint
+ * (built-in + MCP + LSP + vault + spawn_task — which varies per session).
+ */
+export function estimateToolSchemaTokens(tools) {
+    if (!tools || tools.length === 0)
+        return 0;
+    // JSON.stringify is a reasonable proxy for what gets sent on the wire.
+    let chars = 0;
+    for (const t of tools)
+        chars += JSON.stringify(t).length;
+    return Math.ceil(chars / 4);
+}
+export function enforceContextBudget(opts) {
+    const { contextWindow, maxTokens } = opts;
+    const minTail = opts.minTailMessages ?? 10;
+    // Reserve overhead: 2048 safety margin (thinking tokens, tool-call framing)
+    // + actual tool schema tokens (caller-supplied) or 800 as a conservative fallback.
+    const toolOverhead = opts.toolSchemaTokens ?? 800;
+    const safetyMargin = 2048 + toolOverhead;
+    const budget = Math.max(1024, contextWindow - maxTokens - safetyMargin);
+    // Trigger compaction at configurable threshold (default 80%).
+    const compactAt = Number.isFinite(opts.compactAt) ? Math.min(0.95, Math.max(0.5, Number(opts.compactAt))) : 0.8;
+    const threshold = Math.floor(budget * compactAt);
+    let msgs = [...opts.messages];
+    const beforeCount = msgs.length;
+    const beforeTokens = estimateTokensFromMessages(msgs);
+    if (beforeTokens <= threshold)
+        return msgs;
+    const sysStart = msgs[0]?.role === 'system' ? 1 : 0;
+    let currentTokens = beforeTokens;
+    // Phase 1: drop oldest tool-call exchange groups first (§10 — they're bulky and stale).
+    // A "group" = assistant message with tool_calls + all its tool-result messages.
+    // Dropping tool results without their paired assistant message breaks the OpenAI
+    // protocol contract (orphaned tool_call IDs cause server errors / model confusion).
+    while (msgs.length > 2 && currentTokens > threshold) {
+        if (msgs.length - sysStart <= minTail)
+            break;
+        const groupIdx = findOldestToolCallGroup(msgs, sysStart, msgs.length - minTail);
+        if (groupIdx === -1)
+            break;
+        // Remove the group (assistant + following tool results) in one splice.
+        const groupEnd = findGroupEnd(msgs, groupIdx);
+        const dropped = msgs.splice(groupIdx, groupEnd - groupIdx);
+        for (const d of dropped)
+            currentTokens -= Math.ceil((messageContentChars(d.content) + 20) / 4);
+    }
+    // Phase 2: drop any oldest messages if still over budget.
+    while (msgs.length > 2 && currentTokens > threshold) {
+        if (msgs.length - sysStart <= minTail)
+            break;
+        const [removed] = msgs.splice(sysStart, 1);
+        currentTokens -= Math.ceil((messageContentChars(removed.content) + 20) / 4);
+    }
+    const dropped = beforeCount - msgs.length;
+    if (dropped > 0) {
+        const freed = beforeTokens - estimateTokensFromMessages(msgs);
+        const usedPct = budget > 0 ? ((beforeTokens / budget) * 100).toFixed(1) : '?';
+        console.error(`[auto-compact] Approaching context limit (${usedPct}%) - compacting ${dropped} old turns, ~${freed} tokens freed`);
+    }
+    return msgs;
+}
+/**
+ * Find the index of the oldest assistant message that has tool_calls in the droppable range.
+ * We drop the entire group (assistant + tool results) to keep the protocol valid.
+ * Falls back to finding the oldest tool-result message (orphaned) if no group is found.
+ */
+function findOldestToolCallGroup(msgs, fromIdx, toIdx) {
+    // First: look for an assistant message with tool_calls (a complete group to drop)
+    for (let i = fromIdx; i < toIdx; i++) {
+        const m = msgs[i];
+        if (m.role === 'assistant' && m.tool_calls?.length)
+            return i;
+    }
+    // Fallback: look for orphaned tool-result messages (shouldn't happen, but safe)
+    for (let i = fromIdx; i < toIdx; i++) {
+        if (msgs[i].role === 'tool')
+            return i;
+    }
+    return -1;
+}
+/**
+ * Given an assistant message at `startIdx` with tool_calls, find the exclusive end index
+ * of the group: the assistant + all immediately following tool-result messages.
+ */
+function findGroupEnd(msgs, startIdx) {
+    let i = startIdx + 1;
+    while (i < msgs.length && msgs[i].role === 'tool') {
+        i++;
+    }
+    return i;
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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