@visorcraft/idlehands 2.0.2 → 2.1.0

package/dist/agent/prompt-builder.js

@@ -0,0 +1,188 @@
+/**
+ * Modular System Prompt Builder
+ *
+ * Replaces the monolithic SYSTEM_PROMPT constant with composable sections
+ * that can be customized, reordered, or overridden per-model or per-config.
+ *
+ * Inspired by ZeroClaw's `SystemPromptBuilder` with `PromptSection` trait.
+ */
+// ── Built-In Sections ────────────────────────────────────────────────────
+export class IdentitySection {
+    name = 'identity';
+    build(_ctx) {
+        return 'You are a coding agent with filesystem and shell access. Execute the user\'s request using the provided tools.';
+    }
+}
+export class RulesSection {
+    name = 'rules';
+    build(_ctx) {
+        return `Rules:
+- Work in the current directory. Use relative paths for all file operations.
+- Do the work directly. Do NOT use spawn_task to delegate the user's primary request — only use it for genuinely independent subtasks that benefit from parallel execution.
+- Never use spawn_task to bypass confirmation/safety restrictions (for example blocked package installs). If a command is blocked, adapt the plan or ask the user for approval mode changes.
+- Read the target file before editing. You need the exact text for search/replace.
+- Use read_file with search=... to jump to relevant code; avoid reading whole files.
+- Never call read_file/read_files/list_dir twice in a row with identical arguments (same path/options). Reuse the previous result instead.
+- Prefer apply_patch or edit_range for code edits (token-efficient). Use edit_file only when exact old_text replacement is necessary.
+- write_file is for new files or explicit full rewrites only. Existing non-empty files require overwrite=true/force=true.
+- Use insert_file for insertions (prepend/append/line).
+- Use exec to run commands, tests, builds; check results before reporting success.
+- When running commands in a subdirectory, use exec's cwd parameter — NOT "cd /path && cmd". Each exec call is a fresh shell; cd does not persist.
+- Batch work: read all files you need, then apply all edits, then verify.
+- Be concise. Report what you changed and why.
+- Do NOT read every file in a directory. Use search_files or exec with grep to locate relevant code first, then read only the files that match.
+- If search_files returns 0 matches, try a broader pattern or use: exec grep -rn "keyword" path/
+- Anton (the autonomous task runner) is ONLY activated when the user explicitly invokes /anton. Never self-activate as Anton or start processing task files on your own.`;
+    }
+}
+export class ToolFormatSection {
+    name = 'tool_format';
+    build(ctx) {
+        if (ctx.contentModeToolCalls) {
+            return `Tool-call arguments MUST be strict JSON (double-quoted keys/strings, no comments, no trailing commas).
+- edit_range example: {"path":"src/foo.ts","start_line":10,"end_line":14,"replacement":"line A\\nline B"}
+- apply_patch example: {"patch":"--- a/src/foo.ts\\n+++ b/src/foo.ts\\n@@ -10,2 +10,2 @@\\n-old\\n+new","files":["src/foo.ts"]}
+
+Tool call format:
+- Output tool calls as JSON blocks in your response.
+- Do NOT use the tool_calls API mechanism.
+- If you use XML/function tags (e.g. <function=name>), include a full JSON object of arguments between braces.`;
+        }
+        return `Tool-call arguments MUST be strict JSON (double-quoted keys/strings, no comments, no trailing commas).
+- edit_range example: {"path":"src/foo.ts","start_line":10,"end_line":14,"replacement":"line A\\nline B"}
+- apply_patch example: {"patch":"--- a/src/foo.ts\\n+++ b/src/foo.ts\\n@@ -10,2 +10,2 @@\\n-old\\n+new","files":["src/foo.ts"]}
+
+Tool call format:
+- Use tool_calls. Do not write JSON tool invocations in your message text.`;
+    }
+}
+export class SafetySection {
+    name = 'safety';
+    build(_ctx) {
+        // Minimal — callers can extend or override
+        return '';
+    }
+}
+export class DateTimeSection {
+    name = 'datetime';
+    build(_ctx) {
+        const now = new Date();
+        return `Current date: ${now.toISOString().slice(0, 10)} (${now.toLocaleTimeString()})`;
+    }
+}
+export class RuntimeSection {
+    name = 'runtime';
+    build(ctx) {
+        const parts = [];
+        if (ctx.cwd)
+            parts.push(`Working directory: ${ctx.cwd}`);
+        if (ctx.model)
+            parts.push(`Model: ${ctx.model}`);
+        if (ctx.harness)
+            parts.push(`Harness: ${ctx.harness}`);
+        return parts.join('\n');
+    }
+}
+export class VaultContextSection {
+    entries;
+    name = 'vault_context';
+    constructor(entries = []) {
+        this.entries = entries;
+    }
+    setEntries(entries) {
+        this.entries = entries;
+    }
+    build(_ctx) {
+        if (!this.entries.length)
+            return '';
+        return `[Relevant context from vault]\n${this.entries.join('\n')}`;
+    }
+}
+// ── Builder ──────────────────────────────────────────────────────────────
+export class SystemPromptBuilder {
+    sections = [];
+    /** Create a builder with the default section set. */
+    static withDefaults() {
+        const builder = new SystemPromptBuilder();
+        builder.addSection(new IdentitySection());
+        builder.addSection(new RulesSection());
+        builder.addSection(new ToolFormatSection());
+        builder.addSection(new SafetySection());
+        return builder;
+    }
+    /** Add a section to the builder. */
+    addSection(section) {
+        this.sections.push(section);
+        return this;
+    }
+    /** Insert a section before another section by name. */
+    insertBefore(targetName, section) {
+        const idx = this.sections.findIndex((s) => s.name === targetName);
+        if (idx >= 0) {
+            this.sections.splice(idx, 0, section);
+        }
+        else {
+            this.sections.push(section);
+        }
+        return this;
+    }
+    /** Insert a section after another section by name. */
+    insertAfter(targetName, section) {
+        const idx = this.sections.findIndex((s) => s.name === targetName);
+        if (idx >= 0) {
+            this.sections.splice(idx + 1, 0, section);
+        }
+        else {
+            this.sections.push(section);
+        }
+        return this;
+    }
+    /** Replace a section by name, or append if not found. */
+    replaceSection(name, section) {
+        const idx = this.sections.findIndex((s) => s.name === name);
+        if (idx >= 0) {
+            this.sections[idx] = section;
+        }
+        else {
+            this.sections.push(section);
+        }
+        return this;
+    }
+    /** Remove a section by name. */
+    removeSection(name) {
+        this.sections = this.sections.filter((s) => s.name !== name);
+        return this;
+    }
+    /** Get a section by name. */
+    getSection(name) {
+        return this.sections.find((s) => s.name === name);
+    }
+    /** List section names in order. */
+    sectionNames() {
+        return this.sections.map((s) => s.name);
+    }
+    /** Build the complete system prompt. */
+    build(ctx) {
+        const parts = [];
+        for (const section of this.sections) {
+            const text = section.build(ctx).trim();
+            if (text)
+                parts.push(text);
+        }
+        return parts.join('\n\n');
+    }
+}
+/**
+ * Build a default system prompt string (drop-in replacement for the old
+ * SYSTEM_PROMPT constant). Allows callers that don't need customization
+ * to get the same result with no refactoring.
+ */
+export function buildDefaultSystemPrompt(ctx = {}) {
+    return SystemPromptBuilder.withDefaults().build({
+        cwd: ctx.cwd ?? process.cwd(),
+        nativeToolCalls: ctx.nativeToolCalls ?? true,
+        contentModeToolCalls: ctx.contentModeToolCalls ?? false,
+        ...ctx,
+    });
+}
+//# sourceMappingURL=prompt-builder.js.map

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

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

package/dist/agent/query-classifier.js

@@ -0,0 +1,72 @@
+/**
+ * Query Classifier
+ *
+ * Classifies user messages against configurable rules to produce routing
+ * hints like "fast", "reasoning", "code". These hints can be used by a
+ * model router to dispatch to different provider+model combos.
+ *
+ * Inspired by ZeroClaw's classifier.rs.
+ */
+/**
+ * Classify a user message and return the matched hint.
+ * Returns null when classification is disabled, no rules are configured,
+ * or no rule matches the message.
+ */
+export function classify(config, message) {
+    const decision = classifyWithDecision(config, message);
+    return decision?.hint ?? null;
+}
+/**
+ * Classify a user message and return the matched hint with metadata.
+ */
+export function classifyWithDecision(config, message) {
+    if (!config.enabled || config.rules.length === 0)
+        return null;
+    const lower = message.toLowerCase();
+    const len = message.length;
+    // Sort by priority descending (highest first)
+    const sortedRules = [...config.rules].sort((a, b) => b.priority - a.priority);
+    for (const rule of sortedRules) {
+        // Length constraints
+        if (rule.minLength != null && len < rule.minLength)
+            continue;
+        if (rule.maxLength != null && len > rule.maxLength)
+            continue;
+        // Check keywords (case-insensitive) and patterns (case-sensitive)
+        const keywordHit = rule.keywords.some((kw) => lower.includes(kw.toLowerCase()));
+        const patternHit = rule.patterns.some((pat) => message.includes(pat));
+        if (keywordHit || patternHit) {
+            return { hint: rule.hint, priority: rule.priority };
+        }
+    }
+    return null;
+}
+/**
+ * Built-in default classification rules for common patterns.
+ * Users can override or extend these.
+ */
+export function defaultClassificationRules() {
+    return [
+        {
+            hint: 'fast',
+            keywords: ['hi', 'hello', 'hey', 'thanks', 'yes', 'no', 'ok', 'sure', 'bye'],
+            patterns: [],
+            priority: 1,
+            maxLength: 50,
+        },
+        {
+            hint: 'code',
+            keywords: ['code', 'function', 'class', 'refactor', 'debug', 'fix', 'implement', 'build', 'test', 'compile'],
+            patterns: ['fn ', 'def ', 'class ', 'const ', 'let ', 'var ', 'import ', 'export '],
+            priority: 5,
+        },
+        {
+            hint: 'reasoning',
+            keywords: ['explain', 'why', 'analyze', 'compare', 'evaluate', 'think about', 'reason', 'consider'],
+            patterns: [],
+            priority: 3,
+            minLength: 30,
+        },
+    ];
+}
+//# sourceMappingURL=query-classifier.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-classifier.js","sourceRoot":"","sources":["../../src/agent/query-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAiC,EAAE,OAAe;IACzE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAiC,EACjC,OAAe;IAEf,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9D,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAE3B,8CAA8C;IAC9C,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE9E,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,qBAAqB;QACrB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS;YAAE,SAAS;QAC7D,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS;YAAE,SAAS;QAE7D,kEAAkE;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAChF,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAEtE,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;YAC7B,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC;YAC5E,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,EAAE;SACd;QACD;YACE,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC;YAC5G,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;YACnF,QAAQ,EAAE,CAAC;SACZ;QACD;YACE,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC;YACnG,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,EAAE;SACd;KACF,CAAC;AACJ,CAAC"}

package/dist/agent/resilient-provider.js

@@ -0,0 +1,170 @@
+/**
+ * Resilient Provider Wrapper
+ *
+ * Three-level failover strategy for LLM API calls:
+ *   1. Retry loop — exponential backoff with Retry-After parsing
+ *   2. Provider chain — try next provider on exhausted retries
+ *   3. Model fallback — try fallback models when all providers fail
+ *
+ * Additional features:
+ * - Non-retryable error detection (401, 403, context window exceeded)
+ * - Rate-limit detection with key rotation
+ * - Business/quota error detection (plan limits, insufficient balance)
+ *
+ * Inspired by ZeroClaw's reliable.rs.
+ */
+// ── Error Classification ─────────────────────────────────────────────────
+/** Check if an error is non-retryable (client errors that won't resolve with retries). */
+export function isNonRetryable(err) {
+    const msg = typeof err === 'string' ? err : err.message;
+    const lower = msg.toLowerCase();
+    if (isContextWindowExceeded(msg))
+        return true;
+    // Check for HTTP status codes
+    const statusMatch = msg.match(/\b(4\d{2})\b/);
+    if (statusMatch) {
+        const code = parseInt(statusMatch[1], 10);
+        // 4xx errors are non-retryable except 429 (rate-limit) and 408 (timeout)
+        if (code >= 400 && code < 500 && code !== 429 && code !== 408)
+            return true;
+    }
+    // Auth/model failure keywords
+    const authHints = [
+        'invalid api key', 'incorrect api key', 'missing api key', 'api key not set',
+        'authentication failed', 'auth failed', 'unauthorized', 'forbidden',
+        'permission denied', 'access denied', 'invalid token',
+    ];
+    if (authHints.some((h) => lower.includes(h)))
+        return true;
+    // Model not found
+    if (lower.includes('model') && (lower.includes('not found') || lower.includes('unknown') ||
+        lower.includes('unsupported') || lower.includes('does not exist') ||
+        lower.includes('invalid')))
+        return true;
+    return false;
+}
+/** Check if error is a context window exceeded error. */
+export function isContextWindowExceeded(msg) {
+    const lower = msg.toLowerCase();
+    const hints = [
+        'exceeds the context window', 'context window of this model',
+        'maximum context length', 'context length exceeded',
+        'too many tokens', 'token limit exceeded',
+        'prompt is too long', 'input is too long',
+    ];
+    return hints.some((h) => lower.includes(h));
+}
+/** Check if error is a rate-limit (429). */
+export function isRateLimited(err) {
+    const msg = typeof err === 'string' ? err : err.message;
+    return msg.includes('429') && (msg.includes('Too Many') || msg.toLowerCase().includes('rate') || msg.toLowerCase().includes('limit'));
+}
+/** Check if a 429 is a business/quota error that retries cannot fix. */
+export function isNonRetryableRateLimit(err) {
+    const msg = typeof err === 'string' ? err : err.message;
+    if (!isRateLimited(msg))
+        return false;
+    const lower = msg.toLowerCase();
+    const businessHints = [
+        'plan does not include', "doesn't include", 'not include',
+        'insufficient balance', 'insufficient_balance',
+        'insufficient quota', 'insufficient_quota',
+        'quota exhausted', 'out of credits',
+        'no available package', 'package not active',
+        'purchase package', 'model not available for your plan',
+    ];
+    return businessHints.some((h) => lower.includes(h));
+}
+/** Try to extract a Retry-After value (in milliseconds) from an error message. */
+export function parseRetryAfterMs(err) {
+    const msg = typeof err === 'string' ? err : err.message;
+    const lower = msg.toLowerCase();
+    for (const prefix of ['retry-after:', 'retry_after:', 'retry-after ', 'retry_after ']) {
+        const pos = lower.indexOf(prefix);
+        if (pos === -1)
+            continue;
+        const after = msg.slice(pos + prefix.length).trim();
+        const numStr = after.match(/^[\d.]+/)?.[0];
+        if (numStr) {
+            const secs = parseFloat(numStr);
+            if (Number.isFinite(secs) && secs >= 0) {
+                return Math.round(secs * 1000);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Execute a call with retry + provider fallback + model fallback.
+ *
+ * Usage:
+ * ```ts
+ * const result = await resilientCall(
+ *   [{ name: 'primary', execute: (model) => client.chat(model, messages) }],
+ *   'gpt-4',
+ *   { maxRetries: 2, modelFallbacks: { 'gpt-4': ['gpt-3.5-turbo'] } }
+ * );
+ * ```
+ */
+export async function resilientCall(providers, model, options = {}) {
+    const maxRetries = options.maxRetries ?? 2;
+    const baseBackoffMs = Math.max(50, options.baseBackoffMs ?? 500);
+    const modelChain = [model, ...(options.modelFallbacks?.[model] ?? [])];
+    const apiKeys = options.apiKeys ?? [];
+    let keyIndex = 0;
+    const failures = [];
+    for (const currentModel of modelChain) {
+        for (const provider of providers) {
+            let backoffMs = baseBackoffMs;
+            for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                try {
+                    const result = await provider.execute(currentModel);
+                    return result;
+                }
+                catch (rawErr) {
+                    const err = rawErr instanceof Error ? rawErr : new Error(String(rawErr));
+                    const nonRetryableRL = isNonRetryableRateLimit(err);
+                    const nonRetryable = isNonRetryable(err) || nonRetryableRL;
+                    const rateLimited = isRateLimited(err);
+                    const reason = rateLimited && nonRetryable
+                        ? 'non_retryable'
+                        : rateLimited
+                            ? 'rate_limited'
+                            : nonRetryable
+                                ? 'non_retryable'
+                                : 'retryable';
+                    failures.push(`provider=${provider.name} model=${currentModel} attempt ${attempt + 1}/${maxRetries + 1}: ${reason}; error=${err.message.slice(0, 200)}`);
+                    // Rotate API key on rate limit
+                    if (rateLimited && !nonRetryableRL && apiKeys.length > 0) {
+                        keyIndex = (keyIndex + 1) % apiKeys.length;
+                    }
+                    // Context window exceeded — abort everything
+                    if (isContextWindowExceeded(err.message)) {
+                        throw new Error(`Request exceeds model context window; retries and fallbacks were skipped. Attempts:\n${failures.join('\n')}`);
+                    }
+                    // Non-retryable — skip to next provider
+                    if (nonRetryable)
+                        break;
+                    // Retry with backoff
+                    if (attempt < maxRetries) {
+                        const retryAfter = parseRetryAfterMs(err);
+                        const wait = retryAfter != null ? Math.min(retryAfter, 30_000) : backoffMs;
+                        options.onRetry?.({
+                            attempt: attempt + 1,
+                            maxAttempts: maxRetries + 1,
+                            error: err.message.slice(0, 200),
+                            provider: provider.name,
+                            model: currentModel,
+                            reason,
+                            backoffMs: wait,
+                        });
+                        await new Promise((resolve) => setTimeout(resolve, wait));
+                        backoffMs = Math.min(backoffMs * 2, 10_000);
+                    }
+                }
+            }
+        }
+    }
+    throw new Error(`All providers/models failed. Attempts:\n${failures.join('\n')}`);
+}
+//# sourceMappingURL=resilient-provider.js.map

package/dist/agent/resilient-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilient-provider.js","sourceRoot":"","sources":["../../src/agent/resilient-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,4EAA4E;AAE5E,0FAA0F;AAC1F,MAAM,UAAU,cAAc,CAAC,GAAmB;IAChD,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IACxD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAEhC,IAAI,uBAAuB,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,8BAA8B;IAC9B,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9C,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1C,yEAAyE;QACzE,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;IAC7E,CAAC;IAED,8BAA8B;IAC9B,MAAM,SAAS,GAAG;QAChB,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,iBAAiB;QAC5E,uBAAuB,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW;QACnE,mBAAmB,EAAE,eAAe,EAAE,eAAe;KACtD,CAAC;IACF,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1D,kBAAkB;IAClB,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAC7B,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACxD,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACjE,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC1B;QAAE,OAAO,IAAI,CAAC;IAEf,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG;QACZ,4BAA4B,EAAE,8BAA8B;QAC5D,wBAAwB,EAAE,yBAAyB;QACnD,iBAAiB,EAAE,sBAAsB;QACzC,oBAAoB,EAAE,mBAAmB;KAC1C,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,aAAa,CAAC,GAAmB;IAC/C,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IACxD,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAC5B,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CACtG,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,uBAAuB,CAAC,GAAmB;IACzD,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IACxD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,aAAa,GAAG;QACpB,uBAAuB,EAAE,iBAAiB,EAAE,aAAa;QACzD,sBAAsB,EAAE,sBAAsB;QAC9C,oBAAoB,EAAE,oBAAoB;QAC1C,iBAAiB,EAAE,gBAAgB;QACnC,sBAAsB,EAAE,oBAAoB;QAC5C,kBAAkB,EAAE,mCAAmC;KACxD,CAAC;IACF,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,GAAmB;IACnD,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IACxD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAEhC,KAAK,MAAM,MAAM,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE,CAAC;QACtF,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAkCD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAA4B,EAC5B,KAAa,EACb,UAAoC,EAAE;IAEtC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,YAAY,IAAI,UAAU,EAAE,CAAC;QACtC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,SAAS,GAAG,aAAa,CAAC;YAE9B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;gBACvD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;oBACpD,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAAC,OAAO,MAAM,EAAE,CAAC;oBAChB,MAAM,GAAG,GAAG,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;oBACzE,MAAM,cAAc,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;oBACpD,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC;oBAC3D,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;oBAEvC,MAAM,MAAM,GAAwB,WAAW,IAAI,YAAY;wBAC7D,CAAC,CAAC,eAAe;wBACjB,CAAC,CAAC,WAAW;4BACX,CAAC,CAAC,cAAc;4BAChB,CAAC,CAAC,YAAY;gCACZ,CAAC,CAAC,eAAe;gCACjB,CAAC,CAAC,WAAW,CAAC;oBAEpB,QAAQ,CAAC,IAAI,CACX,YAAY,QAAQ,CAAC,IAAI,UAAU,YAAY,YAAY,OAAO,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC,KAAK,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC1I,CAAC;oBAEF,+BAA+B;oBAC/B,IAAI,WAAW,IAAI,CAAC,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzD,QAAQ,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;oBAC7C,CAAC;oBAED,6CAA6C;oBAC7C,IAAI,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;wBACzC,MAAM,IAAI,KAAK,CACb,wFAAwF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9G,CAAC;oBACJ,CAAC;oBAED,wCAAwC;oBACxC,IAAI,YAAY;wBAAE,MAAM;oBAExB,qBAAqB;oBACrB,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;wBACzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;wBAC1C,MAAM,IAAI,GAAG,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;wBAE3E,OAAO,CAAC,OAAO,EAAE,CAAC;4BAChB,OAAO,EAAE,OAAO,GAAG,CAAC;4BACpB,WAAW,EAAE,UAAU,GAAG,CAAC;4BAC3B,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;4BAChC,QAAQ,EAAE,QAAQ,CAAC,IAAI;4BACvB,KAAK,EAAE,YAAY;4BACnB,MAAM;4BACN,SAAS,EAAE,IAAI;yBAChB,CAAC,CAAC;wBAEH,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;wBAC1D,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;oBAC9C,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2CAA2C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpF,CAAC"}

package/dist/agent/response-cache.js

@@ -0,0 +1,124 @@
+/**
+ * Response Cache
+ *
+ * Avoids burning tokens on repeated identical prompts by caching LLM responses.
+ * Keyed by SHA-256 hash of (model, system_prompt_hash, user_prompt).
+ * TTL-based expiry (default: 1 hour). Max entries cap with LRU eviction.
+ *
+ * Uses a separate SQLite database so it can be independently wiped without
+ * touching vault/memory data.
+ *
+ * Inspired by ZeroClaw's response_cache.rs.
+ */
+import crypto from 'node:crypto';
+import path from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import fs from 'node:fs';
+function sha256(input) {
+    return crypto.createHash('sha256').update(input).digest('hex');
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+export class ResponseCache {
+    db;
+    ttlMinutes;
+    maxEntries;
+    constructor(options) {
+        this.ttlMinutes = options.ttlMinutes ?? 60;
+        this.maxEntries = options.maxEntries ?? 500;
+        const dir = options.cacheDir;
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const dbPath = path.join(dir, 'response_cache.db');
+        this.db = new DatabaseSync(dbPath);
+        this.db.exec(`
+      PRAGMA journal_mode = WAL;
+      PRAGMA synchronous = NORMAL;
+      PRAGMA temp_store = MEMORY;
+
+      CREATE TABLE IF NOT EXISTS response_cache (
+        prompt_hash TEXT PRIMARY KEY,
+        model TEXT NOT NULL,
+        response TEXT NOT NULL,
+        token_count INTEGER NOT NULL DEFAULT 0,
+        created_at TEXT NOT NULL,
+        accessed_at TEXT NOT NULL,
+        hit_count INTEGER NOT NULL DEFAULT 0
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_cache_accessed ON response_cache(accessed_at);
+    `);
+    }
+    /**
+     * Compute the cache key from model + system prompt + user prompt.
+     */
+    computeKey(model, systemPrompt, userPrompt) {
+        const systemHash = sha256(systemPrompt);
+        return sha256(`${model}|${systemHash}|${userPrompt}`);
+    }
+    /**
+     * Look up a cached response. Returns null on miss or expired entry.
+     */
+    get(model, systemPrompt, userPrompt) {
+        const key = this.computeKey(model, systemPrompt, userPrompt);
+        const row = this.db.prepare(`SELECT response, created_at FROM response_cache WHERE prompt_hash = ?`).get(key);
+        if (!row)
+            return null;
+        // Check TTL
+        const createdAt = new Date(row.created_at).getTime();
+        const now = Date.now();
+        if (now - createdAt > this.ttlMinutes * 60 * 1000) {
+            // Expired — delete and return miss
+            this.db.prepare('DELETE FROM response_cache WHERE prompt_hash = ?').run(key);
+            return null;
+        }
+        // Update access time and hit count
+        this.db.prepare(`UPDATE response_cache SET accessed_at = ?, hit_count = hit_count + 1 WHERE prompt_hash = ?`).run(nowIso(), key);
+        return row.response;
+    }
+    /**
+     * Store a response in the cache.
+     */
+    set(model, systemPrompt, userPrompt, response, tokenCount = 0) {
+        const key = this.computeKey(model, systemPrompt, userPrompt);
+        const now = nowIso();
+        this.db.prepare(`
+      INSERT OR REPLACE INTO response_cache (prompt_hash, model, response, token_count, created_at, accessed_at, hit_count)
+      VALUES (?, ?, ?, ?, ?, ?, 0)
+    `).run(key, model, response, tokenCount, now, now);
+        // Evict oldest entries if over capacity
+        this.evict();
+    }
+    /**
+     * Purge expired entries and enforce max entries cap.
+     */
+    evict() {
+        // Remove expired entries
+        const cutoff = new Date(Date.now() - this.ttlMinutes * 60 * 1000).toISOString();
+        this.db.prepare('DELETE FROM response_cache WHERE created_at < ?').run(cutoff);
+        // Enforce max entries (LRU eviction)
+        const count = this.db.prepare('SELECT COUNT(*) as c FROM response_cache').get().c;
+        if (count > this.maxEntries) {
+            const excess = count - this.maxEntries;
+            this.db.prepare(`DELETE FROM response_cache WHERE prompt_hash IN (
+          SELECT prompt_hash FROM response_cache ORDER BY accessed_at ASC LIMIT ?
+        )`).run(excess);
+        }
+    }
+    /**
+     * Get cache statistics.
+     */
+    stats() {
+        const row = this.db.prepare('SELECT COUNT(*) as entries, COALESCE(SUM(hit_count), 0) as totalHits FROM response_cache').get();
+        return row;
+    }
+    /**
+     * Clear the entire cache.
+     */
+    clear() {
+        this.db.exec('DELETE FROM response_cache');
+    }
+}
+//# sourceMappingURL=response-cache.js.map

package/dist/agent/response-cache.js.map

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