@dmsdc-ai/aigentry-brain 0.0.1

package/dist/cli/braincli.js

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import yaml from 'js-yaml';
+import simpleGit from 'simple-git';
+import { ProfileManager } from '../core/ProfileManager.js';
+import { SyncStatusStore } from '../status/SyncStatusStore.js';
+import { SystemClock } from '../shared/Clock.js';
+import { BrainContract } from '../contract/BrainContract.js';
+import { loadConfig } from '../shared/Config.js';
+import { createLogger } from '../shared/Logger.js';
+import { runSetup, runUninstall, defaultSetupOptions } from './setup.js';
+import { checkAndUpdate } from './AutoUpdater.js';
+// Check for updates on CLI usage (blocking for setup command)
+checkAndUpdate({ blocking: process.argv[2] === 'setup' });
+// Auto-clone repo if sync is configured but repo doesn't exist yet
+let preConfig = loadConfig();
+if (preConfig.remoteUrl && preConfig.repoPath && !existsSync(join(preConfig.repoPath, '.git'))) {
+    try {
+        const git = simpleGit();
+        await git.clone(preConfig.remoteUrl, preConfig.repoPath);
+        // Reload config so profilePath points to repo
+        preConfig = loadConfig();
+    }
+    catch {
+        // Clone failed (offline, etc.) — continue with local profile
+    }
+}
+const config = preConfig;
+const logger = createLogger('braincli', { level: config.logLevel });
+const pm = new ProfileManager(config.profilePath, SystemClock, config.deviceId);
+const statusStore = new SyncStatusStore(config.statusPath);
+const contract = new BrainContract({ profileManager: pm, statusStore });
+const [, , command, ...args] = process.argv;
+function usage() {
+    console.log(`aigentry-brain CLI — Memory Profile Manager
+
+Usage: aigentry-brain <command> [options]
+
+Commands:
+  list [--category <cat>] [--tags <t1,t2>] [--search <query>]
+      List memory entries with optional filters
+
+  get <id>
+      Get a specific entry by id
+
+  health
+      Show system health report
+
+  export [--format json|yaml]
+      Export all entries
+
+  stats
+      Show profile statistics
+
+  status
+      Show setup status dashboard (GitHub, encryption, sync, devices)
+
+  version
+      Show version info
+
+  setup
+      Register aigentry-brain MCP server in ~/.claude/.mcp.json and
+      create ~/.aigentry/ profile directory (idempotent)
+
+  uninstall
+      Remove aigentry-brain MCP server entry from ~/.claude/.mcp.json
+`);
+}
+async function run() {
+    switch (command) {
+        case 'list': {
+            const filter = {};
+            for (let i = 0; i < args.length; i++) {
+                if (args[i] === '--category' && args[i + 1])
+                    filter['category'] = args[++i];
+                if (args[i] === '--tags' && args[i + 1])
+                    filter['tags'] = args[++i].split(',');
+                if (args[i] === '--search' && args[i + 1])
+                    filter['contentQuery'] = args[++i];
+                if (args[i] === '--source' && args[i + 1])
+                    filter['source'] = args[++i];
+            }
+            const entries = await contract.query(Object.keys(filter).length > 0 ? filter : undefined);
+            if (entries.length === 0) {
+                console.log('No entries found.');
+                return;
+            }
+            for (const e of entries) {
+                const tags = e.tags && e.tags.length > 0 ? ` [${e.tags.join(', ')}]` : '';
+                console.log(`${e.id}  ${e.category.padEnd(12)} ${e.content.slice(0, 60)}${tags}`);
+            }
+            console.log(`\n${entries.length} entries total.`);
+            break;
+        }
+        case 'get': {
+            const id = args[0];
+            if (!id) {
+                console.error('Usage: aigentry-brain get <id>');
+                process.exit(1);
+            }
+            const entries = await contract.query();
+            const entry = entries.find(e => e.id === id);
+            if (!entry) {
+                console.error(`Entry not found: ${id}`);
+                process.exit(1);
+            }
+            console.log(JSON.stringify(entry, null, 2));
+            break;
+        }
+        case 'health': {
+            const health = await contract.health();
+            console.log(`Profile accessible: ${health.profileAccessible ? 'yes' : 'NO'}`);
+            console.log(`Entry count:        ${health.entryCount}`);
+            console.log(`Sync status:        ${health.syncStatus}`);
+            console.log(`Uptime:             ${(health.uptimeMs / 1000).toFixed(1)}s`);
+            break;
+        }
+        case 'export': {
+            const format = args.includes('--format') ? args[args.indexOf('--format') + 1] : 'json';
+            const entries = await contract.query();
+            if (format === 'json') {
+                console.log(JSON.stringify(entries, null, 2));
+            }
+            else if (format === 'yaml') {
+                console.log(yaml.dump(entries, { indent: 2 }));
+            }
+            else {
+                console.error(`Unsupported format: ${format}. Supported: json, yaml`);
+                process.exit(1);
+            }
+            break;
+        }
+        case 'stats': {
+            const entries = await contract.query();
+            const categories = new Map();
+            for (const e of entries) {
+                categories.set(e.category, (categories.get(e.category) ?? 0) + 1);
+            }
+            console.log(`Total entries: ${entries.length}`);
+            console.log(`Categories:`);
+            for (const [cat, count] of [...categories.entries()].sort((a, b) => b[1] - a[1])) {
+                console.log(`  ${cat.padEnd(16)} ${count}`);
+            }
+            const status = await contract.syncStatus();
+            console.log(`Sync status: ${status.status}`);
+            break;
+        }
+        case 'status': {
+            const { checkGhAuth } = await import('./Prerequisites.js');
+            const { readConfig } = await import('./ConfigStore.js');
+            const { execFileSync } = await import('node:child_process');
+            const { readFileSync, existsSync: fsExistsSync } = await import('node:fs');
+            console.log(`aigentry-brain v${config.serverVersion}`);
+            console.log('');
+            // GitHub auth
+            const ghAuth = await checkGhAuth();
+            if (ghAuth.authenticated) {
+                console.log(`✅ GitHub: authenticated (${ghAuth.username ?? 'unknown'})`);
+            }
+            else {
+                console.log('❌ GitHub: not authenticated. Run: gh auth login --web');
+            }
+            // Profile repo
+            const brainConfig = await readConfig(join(homedir(), '.aigentry', 'config.json'));
+            if (brainConfig?.remoteUrl) {
+                console.log(`✅ Profile: ${brainConfig.setupComplete ? 'synced' : 'configured'} (${brainConfig.remoteUrl})`);
+            }
+            else {
+                console.log('⚠️ Profile: offline mode (no remote configured)');
+            }
+            // Encryption (age-encryption npm — no external binaries needed)
+            const { readKeyFile, AgeKeyError } = await import('../crypto/AgeCrypto.js');
+            try {
+                const keyPair = readKeyFile();
+                const pk = keyPair.recipient;
+                console.log(`✅ Encryption: active (age-encryption npm)`);
+                console.log(`✅ Age key: ${pk.slice(0, 10)}...${pk.slice(-5)}`);
+            }
+            catch (err) {
+                if (err instanceof AgeKeyError) {
+                    console.log('❌ Encryption: age key not found. Run: aigentry-brain setup');
+                }
+                else {
+                    console.log('⚠️ Encryption: error reading key file');
+                }
+            }
+            // Multi-machine (count recipients in memory-profile.enc.json)
+            const repoPath = brainConfig?.remoteUrl
+                ? join(homedir(), '.aigentry', 'repo')
+                : null;
+            const encJsonPath = repoPath ? join(repoPath, 'memory-profile.enc.json') : null;
+            if (encJsonPath && fsExistsSync(encJsonPath)) {
+                try {
+                    const encContent = JSON.parse(readFileSync(encJsonPath, 'utf-8'));
+                    const recipients = encContent._aigentry?.recipients ?? [];
+                    const deviceCount = recipients.length;
+                    if (deviceCount > 1) {
+                        console.log(`✅ Multi-machine: ${deviceCount} devices registered`);
+                    }
+                    else {
+                        console.log(`⚠️ Multi-machine: ${deviceCount} device registered`);
+                    }
+                    if (encContent._aigentry?.format === 'plaintext-fallback') {
+                        console.log('⚠️ Encryption mode: plaintext fallback (re-run setup to enable encryption)');
+                    }
+                }
+                catch {
+                    console.log('⚠️ Multi-machine: could not read profile');
+                }
+            }
+            else {
+                // Check legacy .sops.yaml
+                const sopsYamlPath = repoPath ? join(repoPath, '.sops.yaml') : null;
+                if (sopsYamlPath && fsExistsSync(sopsYamlPath)) {
+                    console.log('⚠️ Multi-machine: legacy .sops.yaml found — will migrate on next sync');
+                }
+                else {
+                    console.log('⚠️ Multi-machine: no profile synced yet');
+                }
+            }
+            break;
+        }
+        case 'version': {
+            console.log(`aigentry-brain ${config.serverVersion}`);
+            break;
+        }
+        case 'setup': {
+            const setupOpts = defaultSetupOptions();
+            await runSetup(setupOpts);
+            // Run the full 6-step wizard (prereqs, repo, config, mcp env, sync, health)
+            const { runSetupWizard } = await import('./SetupWizard.js');
+            const result = await runSetupWizard({
+                mcpConfigPath: setupOpts.mcpConfigPath,
+                mcpCliPath: setupOpts.mcpCliPath,
+                profileDir: setupOpts.profileDir,
+            });
+            if (!result.success) {
+                console.log('[aigentry-brain] Run "aigentry-brain-setup" to complete setup.');
+            }
+            break;
+        }
+        case 'uninstall': {
+            await runUninstall(defaultSetupOptions());
+            break;
+        }
+        default:
+            usage();
+            if (command && command !== 'help' && command !== '--help') {
+                process.exit(1);
+            }
+            break;
+    }
+}
+run().catch((err) => {
+    logger.error('CLI error', { error: String(err) });
+    process.exit(1);
+});
+//# sourceMappingURL=braincli.js.map

package/dist/cli/braincli.js.map

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

package/dist/cli/setup.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+export interface SetupOptions {
+    profileDir: string;
+    mcpConfigPath: string;
+    mcpCliPath: string;
+    geminiConfigPath: string;
+    codexConfigPath: string;
+}
+export declare function defaultSetupOptions(): SetupOptions;
+/**
+ * Register aigentry-brain in Gemini's settings.json (same mcpServers JSON structure as Claude).
+ * Fails gracefully — if the file/dir doesn't exist and Gemini isn't installed, just skip.
+ */
+export declare function registerGemini(geminiConfigPath: string, mcpCliPath: string, env?: Record<string, string>): Promise<void>;
+/**
+ * Register aigentry-brain in Codex's config.toml.
+ * Uses a simple string-based approach (no TOML library dependency):
+ * 1. Read existing content
+ * 2. Remove existing [mcp_servers.aigentry-brain] section (and its env sub-table)
+ * 3. Append the new section
+ * Fails gracefully if Codex isn't installed.
+ */
+export declare function registerCodex(codexConfigPath: string, mcpCliPath: string, env?: Record<string, string>): Promise<void>;
+export declare function runSetup(options: SetupOptions): Promise<void>;
+export declare function runUninstall(options: SetupOptions): Promise<void>;

package/dist/cli/setup.js

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+import { mkdir, readFile, writeFile, access } from 'node:fs/promises';
+import { openSync, writeSync, closeSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+/** Write directly to terminal, bypassing npm's output suppression */
+function log(msg) {
+    const data = msg + '\n';
+    for (const ttyPath of ['/dev/tty', 'CON']) {
+        try {
+            const fd = openSync(ttyPath, 'w');
+            writeSync(fd, data);
+            closeSync(fd);
+            return;
+        }
+        catch { /* try next */ }
+    }
+    process.stderr.write(data);
+}
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Resolve the project root directory.
+ * Works whether running from dist/cli/setup.js or src/cli/setup.ts (via tsx).
+ */
+function resolveProjectRoot() {
+    // __dirname is dist/cli/ or src/cli/ — go up 2 levels to project root
+    return join(__dirname, '..', '..');
+}
+export function defaultSetupOptions() {
+    const projectRoot = resolveProjectRoot();
+    return {
+        profileDir: join(homedir(), '.aigentry'),
+        mcpConfigPath: join(homedir(), '.claude', '.mcp.json'),
+        mcpCliPath: join(projectRoot, 'bin', 'aigentry-brain-mcp.mjs'),
+        geminiConfigPath: join(homedir(), '.gemini', 'settings.json'),
+        codexConfigPath: join(homedir(), '.codex', 'config.toml'),
+    };
+}
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readMcpConfig(mcpConfigPath) {
+    if (!(await pathExists(mcpConfigPath))) {
+        return {};
+    }
+    try {
+        const raw = await readFile(mcpConfigPath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+async function writeMcpConfig(mcpConfigPath, config) {
+    const dir = dirname(mcpConfigPath);
+    await mkdir(dir, { recursive: true });
+    await writeFile(mcpConfigPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+}
+/**
+ * Register aigentry-brain in Gemini's settings.json (same mcpServers JSON structure as Claude).
+ * Fails gracefully — if the file/dir doesn't exist and Gemini isn't installed, just skip.
+ */
+export async function registerGemini(geminiConfigPath, mcpCliPath, env) {
+    try {
+        // Read existing settings (may have other keys)
+        const config = await readMcpConfig(geminiConfigPath);
+        if (!config.mcpServers) {
+            config.mcpServers = {};
+        }
+        const existing = config.mcpServers['aigentry-brain'];
+        const entry = existing
+            ? { ...existing }
+            : { command: 'node', args: [mcpCliPath] };
+        if (env && Object.keys(env).length > 0) {
+            entry.env = {
+                ...entry.env,
+                ...env,
+            };
+        }
+        config.mcpServers['aigentry-brain'] = entry;
+        await writeMcpConfig(geminiConfigPath, config);
+        log(`[aigentry-brain] MCP server registered in Gemini: ${geminiConfigPath}`);
+    }
+    catch (err) {
+        // Gemini may not be installed — skip gracefully
+        const msg = err instanceof Error ? err.message : String(err);
+        log(`[aigentry-brain] Gemini config skipped: ${msg}`);
+    }
+}
+/**
+ * Register aigentry-brain in Codex's config.toml.
+ * Uses a simple string-based approach (no TOML library dependency):
+ * 1. Read existing content
+ * 2. Remove existing [mcp_servers.aigentry-brain] section (and its env sub-table)
+ * 3. Append the new section
+ * Fails gracefully if Codex isn't installed.
+ */
+export async function registerCodex(codexConfigPath, mcpCliPath, env) {
+    try {
+        let existing = '';
+        if (await pathExists(codexConfigPath)) {
+            existing = await readFile(codexConfigPath, 'utf8');
+        }
+        // Remove existing [mcp_servers.aigentry-brain] section including env sub-table.
+        // Strategy: split into lines, track when we're inside the target section, drop those lines.
+        const lines = existing.split('\n');
+        const kept = [];
+        let insideTarget = false;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed === '[mcp_servers.aigentry-brain]' ||
+                trimmed === '[mcp_servers.aigentry-brain.env]') {
+                insideTarget = true;
+                continue;
+            }
+            if (insideTarget) {
+                // Any new [section] header ends the target block
+                if (trimmed.startsWith('[') && !trimmed.startsWith('[mcp_servers.aigentry-brain')) {
+                    insideTarget = false;
+                    kept.push(line);
+                }
+                // Otherwise drop this line (it belongs to the old section)
+                continue;
+            }
+            kept.push(line);
+        }
+        // Rebuild base content, stripping trailing blank lines
+        let base = kept.join('\n').trimEnd();
+        if (base.length > 0) {
+            base += '\n\n';
+        }
+        // Build the new section
+        const argsToml = `["${mcpCliPath}"]`;
+        let section = `[mcp_servers.aigentry-brain]\ncommand = "node"\nargs = ${argsToml}\n`;
+        if (env && Object.keys(env).length > 0) {
+            section += '\n[mcp_servers.aigentry-brain.env]\n';
+            for (const [k, v] of Object.entries(env)) {
+                section += `${k} = "${v}"\n`;
+            }
+        }
+        const dir = dirname(codexConfigPath);
+        await mkdir(dir, { recursive: true });
+        await writeFile(codexConfigPath, base + section, 'utf8');
+        log(`[aigentry-brain] MCP server registered in Codex: ${codexConfigPath}`);
+    }
+    catch (err) {
+        // Codex may not be installed — skip gracefully
+        const msg = err instanceof Error ? err.message : String(err);
+        log(`[aigentry-brain] Codex config skipped: ${msg}`);
+    }
+}
+export async function runSetup(options) {
+    const { profileDir, mcpConfigPath, mcpCliPath, geminiConfigPath, codexConfigPath } = options;
+    // 1. Create profile directory
+    await mkdir(profileDir, { recursive: true });
+    log(`[aigentry-brain] Profile directory ready: ${profileDir}`);
+    // 2. Read existing Claude MCP config
+    const config = await readMcpConfig(mcpConfigPath);
+    // 3. Ensure mcpServers key exists
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    // 4. Add or update entry (idempotent, refreshes path on upgrade)
+    const existing = config.mcpServers['aigentry-brain'];
+    if (existing) {
+        // Update args path if it changed (e.g. dist/ → bin/ migration)
+        if (existing.args?.[0] !== mcpCliPath) {
+            existing.args = [mcpCliPath];
+            await writeMcpConfig(mcpConfigPath, config);
+            log(`[aigentry-brain] MCP server path updated in Claude: ${mcpCliPath}`);
+        }
+        else {
+            log('[aigentry-brain] MCP server entry already registered in Claude.');
+        }
+    }
+    else {
+        config.mcpServers['aigentry-brain'] = {
+            command: 'node',
+            args: [mcpCliPath],
+        };
+        await writeMcpConfig(mcpConfigPath, config);
+        log(`[aigentry-brain] MCP server registered in Claude: ${mcpConfigPath}`);
+    }
+    // 5. Register in Gemini (graceful skip if not installed)
+    await registerGemini(geminiConfigPath, mcpCliPath);
+    // 6. Register in Codex (graceful skip if not installed)
+    await registerCodex(codexConfigPath, mcpCliPath);
+}
+export async function runUninstall(options) {
+    const { mcpConfigPath } = options;
+    if (!(await pathExists(mcpConfigPath))) {
+        log('[aigentry-brain] No MCP config found — nothing to remove.');
+        return;
+    }
+    const config = await readMcpConfig(mcpConfigPath);
+    if (!config.mcpServers || !config.mcpServers['aigentry-brain']) {
+        log('[aigentry-brain] MCP server entry not found — nothing to remove.');
+        return;
+    }
+    delete config.mcpServers['aigentry-brain'];
+    await writeMcpConfig(mcpConfigPath, config);
+    log(`[aigentry-brain] MCP server entry removed from: ${mcpConfigPath}`);
+    log('[aigentry-brain] Uninstall complete. Restart Claude Code to deactivate.');
+}
+// Run as standalone script (postinstall / aigentry-brain-setup bin)
+if (process.argv[1] === fileURLToPath(import.meta.url) ||
+    process.argv[1]?.endsWith('dist/cli/setup.js') ||
+    process.argv[1]?.endsWith('bin/aigentry-brain-setup.mjs')) {
+    const options = defaultSetupOptions();
+    runSetup(options)
+        .then(async () => {
+        // After basic setup, attempt full wizard if gh is available
+        const { runSetupWizard } = await import('./SetupWizard.js');
+        const result = await runSetupWizard({
+            mcpConfigPath: options.mcpConfigPath,
+            mcpCliPath: options.mcpCliPath,
+            profileDir: options.profileDir,
+            geminiConfigPath: options.geminiConfigPath,
+            codexConfigPath: options.codexConfigPath,
+        });
+        if (!result.success) {
+            log('[aigentry-brain] Run "aigentry-brain-setup" to complete setup.');
+        }
+    })
+        .catch((err) => {
+        console.error(`[aigentry-brain] Setup failed: ${String(err)}`);
+        // Don't exit(1) — basic setup may have succeeded
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/context/ConfidenceGuard.d.ts

@@ -0,0 +1,11 @@
+export interface ScoredEvidence {
+    tokens: number;
+    score?: number;
+}
+export declare function calculateRecallConfidence(evidence: ScoredEvidence[]): number;
+export declare function shouldAskClarification(recallConfidence: number, threshold?: number): boolean;
+export declare function evaluateRecallConfidence(evidence: ScoredEvidence[], threshold?: number): {
+    recallConfidence: number;
+    threshold: number;
+    shouldAskClarification: boolean;
+};

package/dist/context/ConfidenceGuard.js

@@ -0,0 +1,32 @@
+function clamp01(value) {
+    if (Number.isNaN(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+}
+export function calculateRecallConfidence(evidence) {
+    if (evidence.length === 0)
+        return 0;
+    let weightedScore = 0;
+    let totalWeight = 0;
+    for (const item of evidence) {
+        const weight = Math.max(1, item.tokens);
+        const score = clamp01(item.score ?? 0);
+        weightedScore += (score * weight);
+        totalWeight += weight;
+    }
+    if (totalWeight <= 0)
+        return 0;
+    return clamp01(weightedScore / totalWeight);
+}
+export function shouldAskClarification(recallConfidence, threshold = 0.65) {
+    return recallConfidence < threshold;
+}
+export function evaluateRecallConfidence(evidence, threshold = 0.65) {
+    const recallConfidence = calculateRecallConfidence(evidence);
+    return {
+        recallConfidence,
+        threshold,
+        shouldAskClarification: shouldAskClarification(recallConfidence, threshold),
+    };
+}
+//# sourceMappingURL=ConfidenceGuard.js.map

package/dist/context/ConfidenceGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfidenceGuard.js","sourceRoot":"","sources":["../../src/context/ConfidenceGuard.ts"],"names":[],"mappings":"AAKA,SAAS,OAAO,CAAC,KAAa;IAC5B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAA0B;IAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEpC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;QACvC,aAAa,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;QAClC,WAAW,IAAI,MAAM,CAAC;IACxB,CAAC;IAED,IAAI,WAAW,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC,aAAa,GAAG,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,gBAAwB,EACxB,SAAS,GAAG,IAAI;IAEhB,OAAO,gBAAgB,GAAG,SAAS,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAA0B,EAC1B,SAAS,GAAG,IAAI;IAMhB,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAC7D,OAAO;QACL,gBAAgB;QAChB,SAAS;QACT,sBAAsB,EAAE,sBAAsB,CAAC,gBAAgB,EAAE,SAAS,CAAC;KAC5E,CAAC;AACJ,CAAC"}

package/dist/context/ContextBudgetPolicy.d.ts

@@ -0,0 +1,21 @@
+export type ContextMode = 'qa' | 'coding' | 'strategy';
+export interface SlotBudget {
+    minTokens: number;
+    targetTokens: number;
+}
+export interface ContextBudgetPlan {
+    windowTokens: number;
+    inputBudget: number;
+    outputReserve: number;
+    mustKeepCap: number;
+    recallConfidenceThreshold: number;
+    slots: {
+        systemPolicy: SlotBudget;
+        userRequest: SlotBudget;
+        mustKeep: SlotBudget;
+        conversationSummary: SlotBudget;
+        retrievalEvidence: SlotBudget;
+        repackBuffer: SlotBudget;
+    };
+}
+export declare function buildContextBudgetPlan(windowTokens: number, mode?: ContextMode): ContextBudgetPlan;