@theihtisham/agent-shadow-brain 5.1.1 → 6.0.0

package/dist/brain/token-economy.d.ts

@@ -0,0 +1,25 @@
+import { AgentTool, TokenEconomyStats, TokenSpendRecord } from '../types.js';
+export declare class TokenEconomy {
+    private records;
+    private savingsOpportunitiesUsd;
+    private initialized;
+    init(): Promise<void>;
+    /** Record a token spend event. */
+    record(input: {
+        agentTool: AgentTool;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        taskCategory?: string;
+    }): Promise<TokenSpendRecord>;
+    /** Report aggregate spend + projections + savings opportunities. */
+    report(): Promise<TokenEconomyStats>;
+    /** Total saved by routing to cheaper models (returned as tweetable USD). */
+    getSavingsUsd(): number;
+    private computeSavings;
+    private detectRedundantCalls;
+    private persistStats;
+}
+export declare function getTokenEconomy(): TokenEconomy;
+export declare function resetTokenEconomyForTests(): void;
+//# sourceMappingURL=token-economy.d.ts.map

package/dist/brain/token-economy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-economy.d.ts","sourceRoot":"","sources":["../../src/brain/token-economy.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AA2BrB,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,uBAAuB,CAAa;IAC5C,OAAO,CAAC,WAAW,CAAS;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B,kCAAkC;IAC5B,MAAM,CAAC,KAAK,EAAE;QAClB,SAAS,EAAE,SAAS,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2B7B,oEAAoE;IAC9D,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAmD1C,4EAA4E;IAC5E,aAAa,IAAI,MAAM;IAMvB,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,oBAAoB;YAwBd,YAAY;CAe3B;AAID,wBAAgB,eAAe,IAAI,YAAY,CAG9C;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/brain/token-economy.js

@@ -0,0 +1,216 @@
+// src/brain/token-economy.ts — Cross-agent token spend tracker + cost predictor
+// v6.0.0 — Hive Mind Edition
+//
+// Tracks token usage across every connected agent. Predicts monthly spend,
+// identifies savings opportunities (e.g., calls that could run on cheaper
+// models), and exposes a simple "you saved $X" number for README badges.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+const SPEND_PATH = path.join(os.homedir(), '.shadow-brain', 'token-spend.jsonl');
+const STATS_PATH = path.join(os.homedir(), '.shadow-brain', 'token-economy.json');
+// Per-1M-tokens USD pricing (rough, for projection only)
+const MODEL_PRICING = {
+    'claude-opus-4-7': { input: 15, output: 75 },
+    'claude-sonnet-4-6': { input: 3, output: 15 },
+    'claude-haiku-4-5': { input: 0.8, output: 4 },
+    'gpt-5.4': { input: 10, output: 30 },
+    'gpt-5.4-codex': { input: 10, output: 30 },
+    'glm-5.1': { input: 0.5, output: 2 },
+    'minimax-m2.7': { input: 0.6, output: 2.4 },
+    'gemini-2.5-flash': { input: 0.15, output: 0.6 },
+    'deepseek-671b': { input: 0, output: 0 }, // local/free
+    'qwen2.5-coder:7b': { input: 0, output: 0 }, // local
+    'local': { input: 0, output: 0 },
+};
+export class TokenEconomy {
+    constructor() {
+        this.records = [];
+        this.savingsOpportunitiesUsd = 0;
+        this.initialized = false;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(path.dirname(SPEND_PATH), { recursive: true });
+        if (fs.existsSync(SPEND_PATH)) {
+            try {
+                const raw = fs.readFileSync(SPEND_PATH, 'utf-8');
+                for (const line of raw.split('\n')) {
+                    if (!line.trim())
+                        continue;
+                    const r = JSON.parse(line);
+                    this.records.push({ ...r, timestamp: new Date(r.timestamp) });
+                }
+            }
+            catch {
+                /* skip */
+            }
+        }
+        if (fs.existsSync(STATS_PATH)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(STATS_PATH, 'utf-8'));
+                this.savingsOpportunitiesUsd = parsed.savingsOpportunitiesUsd ?? 0;
+            }
+            catch {
+                /* skip */
+            }
+        }
+        this.initialized = true;
+    }
+    /** Record a token spend event. */
+    async record(input) {
+        await this.init();
+        const model = input.model || 'local';
+        const pricing = MODEL_PRICING[model] ?? { input: 1, output: 3 };
+        const cost = (input.inputTokens * pricing.input + input.outputTokens * pricing.output) / 1000000;
+        const record = {
+            id: `spend-${crypto.randomBytes(6).toString('hex')}`,
+            agentTool: input.agentTool,
+            model,
+            inputTokens: input.inputTokens,
+            outputTokens: input.outputTokens,
+            estimatedCostUsd: +cost.toFixed(6),
+            taskCategory: input.taskCategory ?? 'general',
+            timestamp: new Date(),
+        };
+        this.records.push(record);
+        try {
+            fs.appendFileSync(SPEND_PATH, JSON.stringify(record) + '\n');
+        }
+        catch {
+            /* non-fatal */
+        }
+        return record;
+    }
+    /** Report aggregate spend + projections + savings opportunities. */
+    async report() {
+        await this.init();
+        const byAgent = {};
+        const byModel = {};
+        const byCategory = {};
+        let totalSpend = 0;
+        let totalInput = 0;
+        let totalOutput = 0;
+        for (const r of this.records) {
+            totalSpend += r.estimatedCostUsd;
+            totalInput += r.inputTokens;
+            totalOutput += r.outputTokens;
+            byAgent[r.agentTool] = byAgent[r.agentTool] ?? { spendUsd: 0, calls: 0 };
+            byAgent[r.agentTool].spendUsd += r.estimatedCostUsd;
+            byAgent[r.agentTool].calls++;
+            byModel[r.model] = byModel[r.model] ?? { spendUsd: 0, calls: 0 };
+            byModel[r.model].spendUsd += r.estimatedCostUsd;
+            byModel[r.model].calls++;
+            byCategory[r.taskCategory] = byCategory[r.taskCategory] ?? { spendUsd: 0, calls: 0 };
+            byCategory[r.taskCategory].spendUsd += r.estimatedCostUsd;
+            byCategory[r.taskCategory].calls++;
+        }
+        // Project monthly spend from last 7 days
+        const weekAgo = Date.now() - 7 * 24 * 60 * 60 * 1000;
+        const recent = this.records.filter(r => r.timestamp.getTime() >= weekAgo);
+        const weeklySpend = recent.reduce((acc, r) => acc + r.estimatedCostUsd, 0);
+        const monthlyProjectionUsd = +(weeklySpend * (30 / 7)).toFixed(2);
+        const { savings, suggestions } = this.computeSavings(recent);
+        this.savingsOpportunitiesUsd = savings;
+        await this.persistStats(monthlyProjectionUsd, savings);
+        return {
+            totalSpendUsd: +totalSpend.toFixed(4),
+            totalInputTokens: totalInput,
+            totalOutputTokens: totalOutput,
+            byAgent,
+            byModel,
+            byCategory,
+            monthlyProjectionUsd,
+            savingsOpportunitiesUsd: +savings.toFixed(2),
+            suggestions,
+        };
+    }
+    /** Total saved by routing to cheaper models (returned as tweetable USD). */
+    getSavingsUsd() {
+        return +this.savingsOpportunitiesUsd.toFixed(2);
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    computeSavings(records) {
+        const suggestions = [];
+        let savings = 0;
+        // Opus calls that could pass with Haiku (heuristic: small tasks = general/category)
+        const opusCalls = records.filter(r => r.model.includes('opus'));
+        if (opusCalls.length) {
+            const opusSpend = opusCalls.reduce((acc, r) => acc + r.estimatedCostUsd, 0);
+            const haikuPricing = MODEL_PRICING['claude-haiku-4-5'];
+            const opusPricing = MODEL_PRICING['claude-opus-4-7'];
+            const ratio = (haikuPricing.input + haikuPricing.output) / (opusPricing.input + opusPricing.output);
+            const potentialSave = opusSpend * (1 - ratio) * 0.43; // assume 43% are Haiku-able
+            savings += potentialSave;
+            suggestions.push(`~43% of Opus calls ($${opusSpend.toFixed(2)}) could route to Haiku → ~$${potentialSave.toFixed(2)} saved.`);
+        }
+        // Calls >1500 tokens → consider MiniMax/GLM
+        const bigCalls = records.filter(r => r.inputTokens > 1500 && r.model.includes('gpt'));
+        if (bigCalls.length) {
+            const bigSpend = bigCalls.reduce((acc, r) => acc + r.estimatedCostUsd, 0);
+            const potentialSave = bigSpend * 0.35;
+            savings += potentialSave;
+            suggestions.push(`${bigCalls.length} GPT calls exceed 1500 input tokens — route large-context to MiniMax/GLM for ~$${potentialSave.toFixed(2)} saved.`);
+        }
+        // Redundant calls (identical input within 1h) → cache
+        const cacheable = this.detectRedundantCalls(records);
+        if (cacheable.savings > 0) {
+            savings += cacheable.savings;
+            suggestions.push(`${cacheable.count} redundant calls detected — Shadow Brain cache could save ~$${cacheable.savings.toFixed(2)}.`);
+        }
+        if (!suggestions.length)
+            suggestions.push('No obvious routing wins. Running lean already.');
+        return { savings, suggestions };
+    }
+    detectRedundantCalls(records) {
+        // Simple approximation: calls within 60 min on same agent+category+model
+        const buckets = new Map();
+        for (const r of records) {
+            const key = `${r.agentTool}::${r.model}::${r.taskCategory}`;
+            const list = buckets.get(key) ?? [];
+            list.push(r);
+            buckets.set(key, list);
+        }
+        let redundant = 0;
+        let savings = 0;
+        for (const list of buckets.values()) {
+            list.sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+            for (let i = 1; i < list.length; i++) {
+                const gap = list[i].timestamp.getTime() - list[i - 1].timestamp.getTime();
+                if (gap < 60 * 60 * 1000) {
+                    redundant++;
+                    savings += list[i].estimatedCostUsd * 0.4;
+                }
+            }
+        }
+        return { count: redundant, savings };
+    }
+    async persistStats(monthly, savings) {
+        try {
+            const shape = {
+                schemaVersion: 1,
+                monthlyProjectionUsd: monthly,
+                savingsOpportunitiesUsd: savings,
+                lastRecalculated: new Date().toISOString(),
+            };
+            const tmp = STATS_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(shape, null, 2));
+            fs.renameSync(tmp, STATS_PATH);
+        }
+        catch {
+            /* non-fatal */
+        }
+    }
+}
+let _instance = null;
+export function getTokenEconomy() {
+    if (!_instance)
+        _instance = new TokenEconomy();
+    return _instance;
+}
+export function resetTokenEconomyForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=token-economy.js.map

package/dist/brain/token-economy.js.map

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

package/dist/brain/voice-mode.d.ts

@@ -0,0 +1,15 @@
+import { VoiceCommandResult } from '../types.js';
+export interface VoiceProcessInput {
+    transcript: string;
+    confidence?: number;
+    projectDir?: string;
+}
+export declare class VoiceMode {
+    private brain;
+    constructor();
+    process(input: VoiceProcessInput): Promise<VoiceCommandResult>;
+    history(limit?: number): VoiceCommandResult[];
+}
+export declare function getVoiceMode(): VoiceMode;
+export declare function resetVoiceModeForTests(): void;
+//# sourceMappingURL=voice-mode.d.ts.map

package/dist/brain/voice-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-mode.d.ts","sourceRoot":"","sources":["../../src/brain/voice-mode.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKjD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAc;;IAMrB,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmDpE,OAAO,CAAC,KAAK,SAAK,GAAG,kBAAkB,EAAE;CAa1C;AAID,wBAAgB,YAAY,IAAI,SAAS,CAGxC;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/brain/voice-mode.js

@@ -0,0 +1,97 @@
+// src/brain/voice-mode.ts — Voice command entry point
+// v6.0.0 — Hive Mind Edition
+//
+// Minimal voice integration surface — the CLI and dashboard accept transcribed
+// text and route through the intent engine. Actual audio capture lives in the
+// companion browser bundle (dashboard) or external tools like macOS Dictation.
+// This module provides:
+//   - Intent parsing for voice commands
+//   - Structured response formatting (ready for TTS)
+//   - Persisted command history for dashboard
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { getGlobalBrain } from './global-brain.js';
+const HISTORY_PATH = path.join(os.homedir(), '.shadow-brain', 'voice-history.jsonl');
+export class VoiceMode {
+    constructor() {
+        this.brain = getGlobalBrain();
+    }
+    async process(input) {
+        await this.brain.init();
+        const transcript = input.transcript.trim();
+        const lower = transcript.toLowerCase();
+        let intent = 'unknown';
+        let response = '';
+        if (/summariz(e|ed).*yesterday|recap yesterday|what did .+ learn yesterday/.test(lower)) {
+            intent = 'recap-yesterday';
+            const yesterday = Date.now() - 24 * 60 * 60 * 1000;
+            const events = this.brain
+                .timeline({ limit: 50 })
+                .filter(e => e.createdAt.getTime() >= yesterday);
+            response = events.length
+                ? `Yesterday: ${events.length} memory events. Top category: ${events[0].category}. First: ${events[0].content.slice(0, 140)}`
+                : 'No brain activity from yesterday.';
+        }
+        else if (/show.*dreams?|what.*dream/.test(lower)) {
+            intent = 'show-dreams';
+            response = 'Listing recent dream insights via shadow-brain dream list.';
+        }
+        else if (/brain status|hive mind status|how.*brain/.test(lower)) {
+            intent = 'status';
+            const stats = this.brain.getStats();
+            response = `Hive Mind v6.0: ${stats.totalEntries} memories across ${stats.totalProjects} projects and ${stats.totalAgents} agents. Hit rate ${Math.round(stats.hitRate * 100)}%.`;
+        }
+        else if (/stop watching|pause brain|quiet mode/.test(lower)) {
+            intent = 'pause';
+            response = 'Pausing Shadow Brain is not supported from voice in this build. Use: shadow-brain off.';
+        }
+        else if (/dash(board)?/.test(lower)) {
+            intent = 'open-dashboard';
+            response = 'The dashboard is at http://localhost:7341 when running.';
+        }
+        else {
+            response = `I heard "${transcript.slice(0, 120)}". Try: "brain status", "recap yesterday", or "show dreams".`;
+        }
+        const result = {
+            transcript,
+            confidence: input.confidence ?? 0.9,
+            intent,
+            response,
+            timestamp: new Date(),
+        };
+        try {
+            fs.mkdirSync(path.dirname(HISTORY_PATH), { recursive: true });
+            fs.appendFileSync(HISTORY_PATH, JSON.stringify(result) + '\n');
+        }
+        catch {
+            /* non-fatal */
+        }
+        return result;
+    }
+    history(limit = 20) {
+        if (!fs.existsSync(HISTORY_PATH))
+            return [];
+        try {
+            const raw = fs.readFileSync(HISTORY_PATH, 'utf-8');
+            const lines = raw.split('\n').filter(Boolean).slice(-limit);
+            return lines.map(l => {
+                const p = JSON.parse(l);
+                return { ...p, timestamp: new Date(p.timestamp) };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+}
+let _instance = null;
+export function getVoiceMode() {
+    if (!_instance)
+        _instance = new VoiceMode();
+    return _instance;
+}
+export function resetVoiceModeForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=voice-mode.js.map

package/dist/brain/voice-mode.js.map

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