dual-brain 0.2.30 → 0.3.0

package/dist/src/provider-context.js

@@ -0,0 +1,222 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+const PROVIDER_CAPS = {
+    claude: {
+        name: 'Claude Code',
+        cli: 'claude',
+        hasNativeCompaction: true,
+        compactionStrategy: 'automatic',
+        contextFormat: 'markdown-blocks',
+        supportsSpecialists: true,
+        supportsSituationBrief: true,
+        maxContextTokens: 200_000,
+        sessionStorage: 'claude-internal',
+        authCheck: 'claude --version',
+        resumeSupport: 'receipt + handoff',
+    },
+    openai: {
+        name: 'Codex CLI',
+        cli: 'codex',
+        hasNativeCompaction: false,
+        compactionStrategy: 'none',
+        contextFormat: 'plain-text',
+        supportsSpecialists: false,
+        supportsSituationBrief: true,
+        maxContextTokens: 128_000,
+        sessionStorage: '~/.codex/sessions/YYYY/MM/DD/*.jsonl',
+        authCheck: 'codex --version',
+        resumeSupport: 'handoff-only',
+    },
+};
+export function getProviderCaps(provider) {
+    return PROVIDER_CAPS[provider] || PROVIDER_CAPS.claude;
+}
+// ── Provider-agnostic context injection ─────────────────────────────────────
+/**
+ * Build a context block that works for any provider.
+ * Adapts format based on provider capabilities.
+ */
+export function buildContextBlock(provider, sections) {
+    const caps = getProviderCaps(provider);
+    const lines = [];
+    if (caps.contextFormat === 'markdown-blocks') {
+        for (const [label, content] of Object.entries(sections)) {
+            if (!content)
+                continue;
+            lines.push(`[${label.toUpperCase()}]`);
+            lines.push(typeof content === 'string' ? content : JSON.stringify(content));
+            lines.push(`[/${label.toUpperCase()}]`);
+            lines.push('');
+        }
+    }
+    else {
+        for (const [label, content] of Object.entries(sections)) {
+            if (!content)
+                continue;
+            lines.push(`--- ${label} ---`);
+            lines.push(typeof content === 'string' ? content : JSON.stringify(content));
+            lines.push('');
+        }
+    }
+    return lines.join('\n').trim();
+}
+/**
+ * Build a compaction survival block tuned for the target provider.
+ */
+export function buildSurvivalBlock(provider, state) {
+    const caps = getProviderCaps(provider);
+    const coreLines = [];
+    if (state.activeTask)
+        coreLines.push(`TASK: ${state.activeTask}`);
+    if (state.provider)
+        coreLines.push(`PROVIDER: ${state.provider}/${state.model || 'default'}`);
+    if (state.tier)
+        coreLines.push(`TIER: ${state.tier}`);
+    if (state.risk)
+        coreLines.push(`RISK: ${state.risk}`);
+    if (state.filesInProgress?.length)
+        coreLines.push(`FILES: ${state.filesInProgress.slice(0, 10).join(', ')}`);
+    if (state.decisions?.length)
+        coreLines.push(`DECISIONS: ${state.decisions.slice(0, 3).join('; ')}`);
+    if (state.warnings?.length)
+        coreLines.push(`WARNINGS: ${state.warnings.slice(0, 3).join('; ')}`);
+    if (state.routingRules?.length)
+        coreLines.push(`ROUTING: ${state.routingRules.join('; ')}`);
+    if (caps.hasNativeCompaction) {
+        return `[DUAL-BRAIN CONTINUITY]\n${coreLines.join('\n')}\n[/DUAL-BRAIN CONTINUITY]`;
+    }
+    // Codex: compact header block — placed at prompt start for max visibility
+    return `## dual-brain state\n${coreLines.join('\n')}\n---`;
+}
+/**
+ * Generate a handoff receipt that works for both providers.
+ */
+export function generateProviderHandoff(sessionState, provider) {
+    const caps = getProviderCaps(provider);
+    return {
+        version: 2,
+        provider,
+        providerCaps: caps.name,
+        timestamp: new Date().toISOString(),
+        task: sessionState.taskDescription || null,
+        progress: {
+            filesChanged: (sessionState.filesChanged || []).slice(0, 20),
+            testsRun: sessionState.testsRun || [],
+            decisions: (sessionState.decisions || []).slice(0, 5),
+        },
+        unresolved: (sessionState.unresolved || []).slice(0, 5),
+        routing: {
+            lastProvider: provider,
+            lastModel: sessionState.routingHistory?.lastModel || null,
+            failedProviders: sessionState.routingHistory?.failedProviders || [],
+        },
+        resumeHint: sessionState.resumeHint || null,
+        resumeStrategy: caps.resumeSupport,
+    };
+}
+/**
+ * Build a resume brief from the latest handoff, adapted for the resuming provider.
+ */
+export function buildProviderResumeBrief(cwd, targetProvider) {
+    const dir = join(cwd || process.cwd(), '.dualbrain', 'handoffs');
+    if (!existsSync(dir))
+        return null;
+    const files = readdirSync(dir)
+        .filter(f => f.startsWith('handoff-') && f.endsWith('.json'))
+        .sort()
+        .reverse();
+    if (files.length === 0)
+        return null;
+    let handoff;
+    try {
+        handoff = JSON.parse(readFileSync(join(dir, files[0]), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    const age = (Date.now() - Date.parse(handoff.timestamp)) / 3600000;
+    if (age > 48)
+        return null;
+    const caps = getProviderCaps(targetProvider);
+    const lines = [];
+    const ageLabel = age < 1 ? 'just now' : age < 24 ? `${Math.round(age)}h ago` : `${Math.round(age / 24)}d ago`;
+    lines.push(`Resuming from previous session (${ageLabel}, ran on ${handoff.provider || 'unknown'}):`);
+    if (handoff.task)
+        lines.push(`  Task: ${handoff.task}`);
+    if (handoff.resumeHint)
+        lines.push(`  Next: ${handoff.resumeHint}`);
+    if (handoff.progress?.filesChanged?.length) {
+        const shown = handoff.progress.filesChanged.slice(0, caps.hasNativeCompaction ? 5 : 10);
+        lines.push(`  Changed: ${shown.join(', ')}`);
+    }
+    if (handoff.unresolved?.length) {
+        lines.push(`  Unresolved: ${handoff.unresolved.join('; ')}`);
+    }
+    // Codex gets extra context since it has no native session memory
+    if (!caps.hasNativeCompaction && handoff.progress?.decisions?.length) {
+        lines.push(`  Prior routing: ${handoff.progress.decisions.map(d => `${d.provider}/${d.model}`).join(', ')}`);
+    }
+    if (handoff.routing?.failedProviders?.length) {
+        lines.push(`  Note: ${handoff.routing.failedProviders.join(', ')} failed last session`);
+    }
+    return lines.join('\n');
+}
+// ── Specialist/plugin injection (provider-aware) ────────────────────────────
+/**
+ * Build a capability hint block for the target provider.
+ */
+export function buildCapabilityHint(provider, prompt, cwd) {
+    if (provider === 'claude') {
+        return null; // Handled by dispatch.mjs specialist injection
+    }
+    // Codex: try to match plugins
+    try {
+        // Dynamic require for optional dependency
+        const { matchPluginsForTask } = require('./replit.mjs');
+        const matched = matchPluginsForTask(prompt, undefined, cwd);
+        if (matched.length > 0) {
+            const names = matched.slice(0, 3).map(m => m.plugin.id).join(', ');
+            return `[Available Codex plugins: ${names}. Consider using matching plugins for direct API access.]`;
+        }
+    }
+    catch { /* non-fatal */ }
+    return null;
+}
+/**
+ * Estimate remaining context budget for a provider.
+ */
+export function estimateContextBudget(provider, usedTokens) {
+    const caps = getProviderCaps(provider);
+    const remaining = caps.maxContextTokens - usedTokens;
+    return {
+        provider,
+        maxTokens: caps.maxContextTokens,
+        usedTokens,
+        remainingTokens: Math.max(0, remaining),
+        utilizationPct: Math.round((usedTokens / caps.maxContextTokens) * 100),
+        compactionRisk: remaining < 20_000 ? 'critical' : remaining < 50_000 ? 'high' : remaining < 100_000 ? 'medium' : 'low',
+        hasNativeCompaction: caps.hasNativeCompaction,
+        action: caps.hasNativeCompaction
+            ? (remaining < 20_000 ? 'survival-kit-injected' : 'none')
+            : (remaining < 30_000 ? 'manual-handoff-recommended' : 'none'),
+    };
+}
+// ── Cross-provider compatibility helpers ────────────────────────────────────
+/**
+ * Get the opposite provider for cross-review.
+ */
+export function getReviewProvider(workProvider, availableProviders) {
+    const opposite = workProvider === 'claude' ? 'openai' : 'claude';
+    if (availableProviders?.includes(opposite))
+        return opposite;
+    return workProvider;
+}
+/**
+ * Check if both providers are available for true dual-brain operation.
+ */
+export function isDualProviderAvailable(profile) {
+    const claude = profile?.providers?.claude?.enabled !== false;
+    const openai = !!(profile?.providers?.openai?.enabled && profile?.providers?.openai?.plan);
+    return { claude, openai, dual: claude && openai };
+}
+//# sourceMappingURL=provider-context.js.map

package/dist/src/provider-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-context.js","sourceRoot":"","sources":["../../src/provider-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAA4B,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmBjC,MAAM,aAAa,GAAyC;IAC1D,MAAM,EAAE;QACN,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,QAAQ;QACb,mBAAmB,EAAE,IAAI;QACzB,kBAAkB,EAAE,WAAW;QAC/B,aAAa,EAAE,iBAAiB;QAChC,mBAAmB,EAAE,IAAI;QACzB,sBAAsB,EAAE,IAAI;QAC5B,gBAAgB,EAAE,OAAO;QACzB,cAAc,EAAE,iBAAiB;QACjC,SAAS,EAAE,kBAAkB;QAC7B,aAAa,EAAE,mBAAmB;KACnC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,OAAO;QACZ,mBAAmB,EAAE,KAAK;QAC1B,kBAAkB,EAAE,MAAM;QAC1B,aAAa,EAAE,YAAY;QAC3B,mBAAmB,EAAE,KAAK;QAC1B,sBAAsB,EAAE,IAAI;QAC5B,gBAAgB,EAAE,OAAO;QACzB,cAAc,EAAE,sCAAsC;QACtD,SAAS,EAAE,iBAAiB;QAC5B,aAAa,EAAE,cAAc;KAC9B;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC;AACzD,CAAC;AAED,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,QAA4D;IAC9G,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,IAAI,CAAC,aAAa,KAAK,iBAAiB,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAgBD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,KAAoB;IACvE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,UAAU;QAAE,SAAS,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,QAAQ;QAAE,SAAS,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC;IAC9F,IAAI,KAAK,CAAC,IAAI;QAAE,SAAS,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,IAAI;QAAE,SAAS,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,eAAe,EAAE,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7G,IAAI,KAAK,CAAC,SAAS,EAAE,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpG,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,IAAI,KAAK,CAAC,YAAY,EAAE,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE5F,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7B,OAAO,4BAA4B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,CAAC;IACtF,CAAC;IAED,0EAA0E;IAC1E,OAAO,wBAAwB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;AAC7D,CAAC;AAuCD;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAA0B,EAAE,QAAgB;IAClF,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEvC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,QAAQ;QACR,YAAY,EAAE,IAAI,CAAC,IAAI;QACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE,YAAY,CAAC,eAAe,IAAI,IAAI;QAC1C,QAAQ,EAAE;YACR,YAAY,EAAE,CAAC,YAAY,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC5D,QAAQ,EAAE,YAAY,CAAC,QAAQ,IAAI,EAAE;YACrC,SAAS,EAAE,CAAC,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACtD;QACD,UAAU,EAAE,CAAC,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACvD,OAAO,EAAE;YACP,YAAY,EAAE,QAAQ;YACtB,SAAS,EAAE,YAAY,CAAC,cAAc,EAAE,SAAS,IAAI,IAAI;YACzD,eAAe,EAAE,YAAY,CAAC,cAAc,EAAE,eAAe,IAAI,EAAE;SACpE;QACD,UAAU,EAAE,YAAY,CAAC,UAAU,IAAI,IAAI;QAC3C,cAAc,EAAE,IAAI,CAAC,aAAa;KACnC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAuB,EAAE,cAAsB;IACtF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAC5D,IAAI,EAAE;SACN,OAAO,EAAE,CAAC;IACb,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,IAAI,OAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC;IACnE,IAAI,GAAG,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,IAAI,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;IAC9G,KAAK,CAAC,IAAI,CAAC,mCAAmC,QAAQ,YAAY,OAAO,CAAC,QAAQ,IAAI,SAAS,IAAI,CAAC,CAAC;IAErG,IAAI,OAAO,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,OAAO,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEpE,IAAI,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxF,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,iEAAiE;IACjE,IAAI,CAAC,IAAI,CAAC,mBAAmB,IAAI,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,MAAc,EAAE,GAAY;IAChF,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,CAAC,+CAA+C;IAC9D,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC;QACH,0CAA0C;QAC1C,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,cAAc,CAAkH,CAAC;QACzK,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC5D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnE,OAAO,6BAA6B,KAAK,2DAA2D,CAAC;QACvG,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;IAE3B,OAAO,IAAI,CAAC;AACd,CAAC;AAeD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,UAAkB;IACxE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC;IAErD,OAAO;QACL,QAAQ;QACR,SAAS,EAAE,IAAI,CAAC,gBAAgB;QAChC,UAAU;QACV,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC;QACvC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,GAAG,CAAC;QACtE,cAAc,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;QACtH,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,MAAM,EAAE,IAAI,CAAC,mBAAmB;YAC9B,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,MAAM,CAAC;YACzD,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,MAAM,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAoB,EAAE,kBAA6B;IACnF,MAAM,QAAQ,GAAG,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACjE,IAAI,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5D,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA6H;IACnK,MAAM,MAAM,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC;IAC7D,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,IAAI,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3F,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;AACpD,CAAC"}

package/dist/src/provider-manager.d.ts

@@ -0,0 +1,92 @@
+/**
+ * provider-manager.ts — Provider health, failover, and rate-limit management
+ *
+ * The "invisible failover" layer: when Claude is rate-limited, work seamlessly
+ * continues on GPT. When GPT is down, Claude handles everything.
+ *
+ * State storage:
+ *   - Provider states: .dual-brain/providers/{provider}.json (atomic writes)
+ *   - Global dispatch log: .dual-brain/dispatch-log.ndjson (append-only)
+ */
+/** Maximum dispatches allowed per rolling window (default: 30 per 5 min). */
+export declare const MAX_DISPATCHES_PER_WINDOW = 30;
+/** Default rolling window in minutes. */
+export declare const DEFAULT_WINDOW_MINUTES = 5;
+export interface ProviderState {
+    provider: 'anthropic' | 'openai';
+    status: 'healthy' | 'degraded' | 'rate-limited' | 'down';
+    lastCheck: string;
+    lastSuccess: string;
+    lastFailure?: string;
+    cooldownUntil?: string;
+    remainingCapacity: number;
+    recentDispatches: number;
+    consecutiveFailures: number;
+}
+export interface FailoverResult {
+    provider: string;
+    model: string;
+    reason: string;
+    wasFailover: boolean;
+}
+export interface DispatchPermission {
+    allowed: boolean;
+    reason: string;
+    suggestedDelay?: number;
+    alternativeProvider?: string;
+}
+/**
+ * Get the current health state for a provider.
+ */
+export declare function getProviderState(provider: string, cwd?: string): ProviderState;
+/**
+ * Get health states for all known providers.
+ */
+export declare function getAllProviderStates(cwd?: string): ProviderState[];
+/**
+ * Record a successful dispatch to a provider.
+ */
+export declare function recordSuccess(provider: string, model: string, cwd?: string): void;
+/**
+ * Record a dispatch failure. Detects rate limits automatically.
+ */
+export declare function recordFailure(provider: string, model: string, error: string, cwd?: string): void;
+/**
+ * Explicitly record a rate limit event.
+ */
+export declare function recordRateLimit(provider: string, resetTime?: string, cwd?: string): void;
+/**
+ * Check whether dispatching to a provider is allowed right now.
+ */
+export declare function canDispatch(provider: string, cwd?: string): DispatchPermission;
+/**
+ * If the preferred provider cannot handle work right now, find the best alternative.
+ */
+export declare function getFailoverTarget(preferredProvider: string, preferredModel: string, cwd?: string): FailoverResult;
+/**
+ * Choose the best provider right now based on health + task tier.
+ */
+export declare function selectProvider(taskTier: number, preferredProvider?: string, cwd?: string): FailoverResult;
+/**
+ * Get the total number of dispatches across all providers in the given window.
+ */
+export declare function getGlobalDispatchCount(windowMinutes?: number, cwd?: string): number;
+/**
+ * Append a dispatch attempt to the global log (file-based, shared across processes).
+ */
+export declare function recordDispatchAttempt(provider: string, model: string, taskId: string, cwd?: string): void;
+/**
+ * Check whether dispatch rate is within budget.
+ */
+export declare function isWithinBudget(maxPerWindow?: number, windowMinutes?: number, cwd?: string): boolean;
+/**
+ * Parse an error message for rate limit signals.
+ */
+export declare function detectRateLimit(error: string): {
+    isRateLimit: boolean;
+    resetTime?: string;
+};
+/**
+ * One-line health status string for TUI display.
+ */
+export declare function getHealthSummary(cwd?: string): string;