@nexus-cortex/cli 4.26.0

package/dist/commands/config/get.js

@@ -0,0 +1,98 @@
+/**
+ * Get configuration value(s)
+ *
+ * Unified config: reads from .env via SettingsLoader.
+ * Shows current values grouped by category.
+ */
+import { SettingsLoader, SETTINGS_METADATA } from '@nexus-cortex/core';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+import { findProjectRoot } from './utils.js';
+const CATEGORY_LABELS = {
+    api_keys: 'API Keys',
+    models: 'Models',
+    system: 'System',
+    mentorship: 'Mentorship',
+    context: 'Context Management',
+    session: 'Session',
+    loop_control: 'Loop Control',
+    server_side_tools: 'Tools & Execution',
+    model_router: 'Model Router',
+    agent_workspace: 'Agent Workspace',
+    training: 'Training & Audit',
+    runtime: 'Runtime',
+};
+const CATEGORY_ORDER = [
+    'models', 'system', 'runtime', 'loop_control', 'context',
+    'mentorship', 'server_side_tools', 'model_router', 'training',
+    'session', 'agent_workspace', 'api_keys',
+];
+function getCurrentValue(key, loader) {
+    const fromEnv = process.env[key];
+    if (fromEnv !== undefined && fromEnv !== '')
+        return fromEnv;
+    return loader.get(key) || '';
+}
+function formatDisplayValue(setting, value) {
+    if (setting.secret && value) {
+        return value.length > 8
+            ? value.substring(0, 4) + '...' + value.substring(value.length - 4)
+            : '***configured***';
+    }
+    return value || '(not set)';
+}
+/**
+ * Get configuration value(s)
+ * If key provided, shows single value; otherwise shows all config grouped by category
+ */
+export async function configGet(key, options = {}) {
+    const theme = ThemeManager.getTheme();
+    const projectPath = findProjectRoot();
+    const loader = new SettingsLoader(projectPath);
+    try {
+        if (options.json) {
+            if (key) {
+                const value = getCurrentValue(key, loader);
+                console.log(JSON.stringify({ [key]: value }, null, 2));
+            }
+            else {
+                const env = loader.getEnvironment();
+                console.log(JSON.stringify(env, null, 2));
+            }
+            return;
+        }
+        if (key) {
+            const value = getCurrentValue(key, loader);
+            const meta = SETTINGS_METADATA.find(s => s.key === key);
+            if (!meta && !value) {
+                console.error(theme.colors.error(`Unknown config key: ${key}`));
+                console.log(theme.colors.muted('\nUse "cortex config list" to see all keys'));
+                process.exit(1);
+            }
+            const display = meta ? formatDisplayValue(meta, value) : value;
+            console.log(theme.colors.highlight(`${key}:`), theme.colors.secondary(display));
+            return;
+        }
+        console.log(theme.colors.primary('\nConfiguration (.env):'));
+        console.log();
+        for (const cat of CATEGORY_ORDER) {
+            const settings = SETTINGS_METADATA.filter(s => s.category === cat);
+            if (settings.length === 0)
+                continue;
+            console.log(theme.colors.highlight(` ${CATEGORY_LABELS[cat] || cat}`));
+            for (const s of settings) {
+                const value = getCurrentValue(s.key, loader);
+                const display = formatDisplayValue(s, value);
+                const padded = s.displayName.padEnd(30);
+                console.log(` ${theme.colors.muted(padded)} ${theme.colors.secondary(display)}`);
+            }
+            console.log();
+        }
+        console.log(theme.colors.muted(`Config source: ${projectPath}/.env`));
+        console.log();
+    }
+    catch (error) {
+        console.error(theme.colors.error(`Error: ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/config/get.js.map

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

package/dist/commands/config/reset.d.ts

@@ -0,0 +1,6 @@
+export interface ConfigResetOptions {
+    force?: boolean;
+    includeKeys?: boolean;
+}
+export declare function configReset(options?: ConfigResetOptions): Promise<void>;
+//# sourceMappingURL=reset.d.ts.map

package/dist/commands/config/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../../src/commands/config/reset.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgEjF"}

package/dist/commands/config/reset.js

@@ -0,0 +1,68 @@
+/**
+ * Reset configuration to benchmark-proven optimal defaults
+ *
+ * Backs up current .env, then writes DEFAULT_SETTINGS while preserving API keys.
+ */
+import { SettingsLoader, SettingsWriter, DEFAULT_SETTINGS, SETTINGS_METADATA, } from '@nexus-cortex/core';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+import { findProjectRoot } from './utils.js';
+const API_KEY_FIELDS = SETTINGS_METADATA
+    .filter(s => s.category === 'api_keys')
+    .map(s => s.key);
+export async function configReset(options = {}) {
+    const theme = ThemeManager.getTheme();
+    const projectPath = findProjectRoot();
+    const writer = new SettingsWriter(projectPath);
+    const loader = new SettingsLoader(projectPath);
+    try {
+        const currentEnv = loader.getEnvironment();
+        const preserved = {};
+        if (!options.includeKeys) {
+            for (const key of API_KEY_FIELDS) {
+                const val = currentEnv[key];
+                if (val) {
+                    preserved[key] = val;
+                }
+            }
+        }
+        const backupPath = writer.backup();
+        if (backupPath) {
+            console.log(theme.colors.muted(` Backup: ${backupPath}`));
+        }
+        const resetEnv = {
+            ...DEFAULT_SETTINGS,
+            ...preserved,
+        };
+        writer.write(resetEnv);
+        for (const [key, val] of Object.entries(resetEnv)) {
+            process.env[key] = val;
+        }
+        const preservedCount = Object.keys(preserved).length;
+        const totalSettings = SETTINGS_METADATA.length;
+        console.log(theme.colors.success(`[OK] Configuration reset to optimal defaults`));
+        console.log(theme.colors.muted(` ${totalSettings} settings written`));
+        if (preservedCount > 0) {
+            console.log(theme.colors.muted(` ${preservedCount} API keys preserved`));
+        }
+        console.log();
+        const highlights = [
+            'DEFAULT_MODEL_ID', 'HELPER_MODEL_ID', 'CONTEXT_BUDGET_STRATEGY',
+            'TOOL_TIMEOUT_MS', 'MODEL_ROUTER_EXPLORATION', 'MODEL_ROUTER_EXCLUDE',
+            'MCP_AUTO_INJECT', 'ENABLE_SERVER_SIDE_TOOLS',
+        ];
+        for (const key of highlights) {
+            const val = resetEnv[key] || DEFAULT_SETTINGS[key];
+            if (val) {
+                const meta = SETTINGS_METADATA.find(s => s.key === key);
+                const name = meta?.displayName || key;
+                console.log(` ${theme.colors.highlight(name.padEnd(30))} ${theme.colors.secondary(val)}`);
+            }
+        }
+        console.log();
+    }
+    catch (error) {
+        console.error(theme.colors.error(`Error: ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=reset.js.map

package/dist/commands/config/reset.js.map

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

package/dist/commands/config/set.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Set configuration value
+ * Validates the key and value before saving to .env
+ */
+export declare function configSet(key: string, value: string): Promise<void>;
+//# sourceMappingURL=set.d.ts.map

package/dist/commands/config/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/commands/config/set.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAmDf"}

package/dist/commands/config/set.js

@@ -0,0 +1,60 @@
+/**
+ * Set configuration value
+ *
+ * Unified config: writes to .env via SettingsLoader.
+ * Validates against SettingsSchema metadata.
+ */
+import { SettingsLoader, SETTINGS_METADATA, validateSetting, isLiveToggleable, } from '@nexus-cortex/core';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+import { findProjectRoot } from './utils.js';
+/**
+ * Set configuration value
+ * Validates the key and value before saving to .env
+ */
+export async function configSet(key, value) {
+    const theme = ThemeManager.getTheme();
+    try {
+        const meta = SETTINGS_METADATA.find(s => s.key === key);
+        if (!meta) {
+            const allKeys = SETTINGS_METADATA.map(s => s.key);
+            const close = allKeys.filter(k => k.toLowerCase().includes(key.toLowerCase()));
+            console.error(theme.colors.error(`Unknown config key: ${key}`));
+            if (close.length > 0) {
+                console.log(theme.colors.muted(`\nDid you mean: ${close.slice(0, 5).join(', ')}?`));
+            }
+            console.log(theme.colors.muted('\nUse "cortex config list" to see all keys'));
+            process.exit(1);
+            return; // guard: process.exit is mockable in tests — never fall through to a write
+        }
+        const validation = validateSetting(key, value);
+        if (validation !== true) {
+            console.error(theme.colors.error(`Invalid value for ${key}: ${validation}`));
+            if (meta.type === 'choice' && meta.choices) {
+                console.log(theme.colors.muted(`Valid values: ${meta.choices.join(', ')}`));
+            }
+            process.exit(1);
+            return; // guard: do not write an invalid value if exit is mocked
+        }
+        const projectPath = findProjectRoot();
+        const loader = new SettingsLoader(projectPath);
+        const result = loader.set(key, value);
+        if (!result.success) {
+            console.error(theme.colors.error(`Failed to set ${key}: ${result.error}`));
+            process.exit(1);
+            return;
+        }
+        process.env[key] = value;
+        const label = isLiveToggleable(key) ? '(live)' : '(restart required)';
+        console.log(theme.colors.success(`[OK] ${key} updated ${label}`));
+        if (result.previousValue !== undefined && result.previousValue !== value) {
+            console.log(theme.colors.muted(` was: ${result.previousValue}`));
+        }
+        console.log(theme.colors.highlight(` now: ${value}`));
+        console.log();
+    }
+    catch (error) {
+        console.error(theme.colors.error(`Error: ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=set.js.map

package/dist/commands/config/set.js.map

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

package/dist/commands/config/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Find the project root that contains the .env config.
+ *
+ * Resolution order:
+ * 1. CORTEX_ROOT / CORTEX_ROOT env var (explicit override)
+ * 2. Walk up from this file's location to find the monorepo package.json
+ * 3. Walk up from cwd to find the monorepo package.json
+ * 4. cwd fallback
+ *
+ * Validates by checking package.json name === "nexus-cortex-monorepo",
+ * so it works in both monorepo dev and flattened npm installs.
+ */
+export declare function findProjectRoot(): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/commands/config/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/commands/config/utils.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAsBxC"}

package/dist/commands/config/utils.js

@@ -0,0 +1,54 @@
+import { existsSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const MONOREPO_NAME = 'nexus-cortex-monorepo';
+function isProjectRoot(dir) {
+    const pkgPath = join(dir, 'package.json');
+    if (!existsSync(pkgPath))
+        return false;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        return pkg.name === MONOREPO_NAME;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find the project root that contains the .env config.
+ *
+ * Resolution order:
+ * 1. CORTEX_ROOT / CORTEX_ROOT env var (explicit override)
+ * 2. Walk up from this file's location to find the monorepo package.json
+ * 3. Walk up from cwd to find the monorepo package.json
+ * 4. cwd fallback
+ *
+ * Validates by checking package.json name === "nexus-cortex-monorepo",
+ * so it works in both monorepo dev and flattened npm installs.
+ */
+export function findProjectRoot() {
+    const envRoot = process.env.CORTEX_ROOT;
+    if (envRoot && existsSync(envRoot))
+        return envRoot;
+    try {
+        const thisFile = fileURLToPath(import.meta.url);
+        let d = dirname(thisFile);
+        for (let i = 0; i < 8; i++) {
+            if (isProjectRoot(d))
+                return d;
+            const parent = dirname(d);
+            if (parent === d)
+                break;
+            d = parent;
+        }
+    }
+    catch { }
+    let dir = process.cwd();
+    while (dir !== dirname(dir)) {
+        if (isProjectRoot(dir))
+            return dir;
+        dir = dirname(dir);
+    }
+    return process.cwd();
+}
+//# sourceMappingURL=utils.js.map

package/dist/commands/config/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/commands/config/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAE9C,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,OAAO,GAAG,CAAC,IAAI,KAAK,aAAa,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACxC,IAAI,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,IAAI,aAAa,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,MAAM,KAAK,CAAC;gBAAE,MAAM;YACxB,CAAC,GAAG,MAAM,CAAC;QACb,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACxB,OAAO,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,aAAa,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QACnC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC"}

package/dist/commands/context/boundaries.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context Boundaries Command
+ * List compaction boundaries
+ */
+export interface ContextBoundariesOptions {
+    serverUrl?: string;
+    json?: boolean;
+}
+/**
+ * List compaction boundaries
+ */
+export declare function contextBoundaries(sessionId: string, options?: ContextBoundariesOptions): Promise<void>;
+//# sourceMappingURL=boundaries.d.ts.map

package/dist/commands/context/boundaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries.d.ts","sourceRoot":"","sources":["../../../src/commands/context/boundaries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/commands/context/boundaries.js

@@ -0,0 +1,45 @@
+/**
+ * Context Boundaries Command
+ * List compaction boundaries
+ */
+import { CortexClient } from '../../client/CortexClient.js';
+import { ConfigManager } from '../../config/ConfigManager.js';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+/**
+ * List compaction boundaries
+ */
+export async function contextBoundaries(sessionId, options = {}) {
+    const config = await ConfigManager.load();
+    const serverUrl = options.serverUrl || config.serverUrl || 'http://localhost:4000';
+    const theme = ThemeManager.getTheme();
+    const client = new CortexClient(serverUrl);
+    try {
+        // Get boundaries
+        const response = await client.get(`/sessions/${sessionId}/compaction/boundaries`);
+        // JSON output
+        if (options.json) {
+            console.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        // Formatted output
+        console.log(theme.colors.primary('\n Compaction Boundaries\n'));
+        if (response.boundaries && response.boundaries.length > 0) {
+            response.boundaries.forEach((boundary, index) => {
+                console.log(theme.colors.secondary(`Boundary ${index + 1}:`));
+                console.log(` Turn: ${theme.colors.highlight(boundary.turn.toString())}`);
+                console.log(` Timestamp: ${theme.colors.muted(boundary.timestamp)}`);
+                console.log(` Tokens saved: ${theme.colors.success(boundary.tokensSaved.toString())}`);
+                console.log();
+            });
+        }
+        else {
+            console.log(theme.colors.muted('No compaction boundaries yet.'));
+            console.log();
+        }
+    }
+    catch (error) {
+        console.error(theme.colors.error(`Error: ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=boundaries.js.map

package/dist/commands/context/boundaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries.js","sourceRoot":"","sources":["../../../src/commands/context/boundaries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAO5D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAiB,EACjB,UAAoC,EAAE;IAEtC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,IAAI,uBAAuB,CAAC;IACnF,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,iBAAiB;QACjB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,SAAS,wBAAwB,CAAC,CAAC;QAElF,cAAc;QACd,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,mBAAmB;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAEhE,IAAI,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,QAAa,EAAE,KAAa,EAAE,EAAE;gBAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9D,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC1E,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACrE,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;gBACvF,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;IAEH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/context/compact.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context Compact Command
+ * Trigger manual compaction
+ */
+export interface ContextCompactOptions {
+    serverUrl?: string;
+    json?: boolean;
+}
+/**
+ * Trigger manual compaction
+ */
+export declare function contextCompact(sessionId: string, options?: ContextCompactOptions): Promise<void>;
+//# sourceMappingURL=compact.d.ts.map

package/dist/commands/context/compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../../src/commands/context/compact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/commands/context/compact.js

@@ -0,0 +1,41 @@
+/**
+ * Context Compact Command
+ * Trigger manual compaction
+ */
+import { CortexClient } from '../../client/CortexClient.js';
+import { ConfigManager } from '../../config/ConfigManager.js';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+/**
+ * Trigger manual compaction
+ */
+export async function contextCompact(sessionId, options = {}) {
+    const config = await ConfigManager.load();
+    const serverUrl = options.serverUrl || config.serverUrl || 'http://localhost:4000';
+    const theme = ThemeManager.getTheme();
+    const client = new CortexClient(serverUrl);
+    try {
+        // Trigger compaction
+        const response = await client.post(`/sessions/${sessionId}/compaction`, {});
+        // JSON output
+        if (options.json) {
+            console.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        // Formatted output
+        console.log(theme.colors.success('\n✓ Compaction complete\n'));
+        if (response.tokensBefore && response.tokensAfter) {
+            console.log(theme.colors.secondary('Results:'));
+            console.log(` Tokens before: ${theme.colors.highlight(response.tokensBefore.toString())}`);
+            console.log(` Tokens after: ${theme.colors.highlight(response.tokensAfter.toString())}`);
+            const saved = response.tokensBefore - response.tokensAfter;
+            const percentage = ((saved / response.tokensBefore) * 100).toFixed(1);
+            console.log(` Saved: ${theme.colors.success(saved.toString() + ' tokens (' + percentage + '%)')}`);
+        }
+        console.log();
+    }
+    catch (error) {
+        console.error(theme.colors.error(`Error: ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=compact.js.map

package/dist/commands/context/compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.js","sourceRoot":"","sources":["../../../src/commands/context/compact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAO5D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,IAAI,uBAAuB,CAAC;IACnF,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,qBAAqB;QACrB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,SAAS,aAAa,EAAE,EAAE,CAAC,CAAC;QAE5E,cAAc;QACd,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,mBAAmB;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC;QAE/D,IAAI,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3F,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;YAEzF,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,GAAG,QAAQ,CAAC,WAAW,CAAC;YAC3D,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;IAEhB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/context/savings.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context Savings Command
+ * Show token savings from compaction
+ */
+export interface ContextSavingsOptions {
+    serverUrl?: string;
+    json?: boolean;
+}
+/**
+ * Show token savings from compaction
+ */
+export declare function contextSavings(options?: ContextSavingsOptions): Promise<void>;
+//# sourceMappingURL=savings.d.ts.map

package/dist/commands/context/savings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"savings.d.ts","sourceRoot":"","sources":["../../../src/commands/context/savings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/commands/context/savings.js

@@ -0,0 +1,49 @@
+/**
+ * Context Savings Command
+ * Show token savings from compaction
+ */
+import { CortexClient } from '../../client/CortexClient.js';
+import { ConfigManager } from '../../config/ConfigManager.js';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+/**
+ * Show token savings from compaction
+ */
+export async function contextSavings(options = {}) {
+    const config = await ConfigManager.load();
+    const serverUrl = options.serverUrl || config.serverUrl || 'http://localhost:4000';
+    const theme = ThemeManager.getTheme();
+    const client = new CortexClient(serverUrl);
+    try {
+        // Get savings data
+        const response = await client.get('/context/savings');
+        // JSON output
+        if (options.json) {
+            console.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        // Formatted output
+        console.log(theme.colors.primary('\n Token Savings\n'));
+        if (response.totalSaved) {
+            console.log(theme.colors.secondary('Summary:'));
+            console.log(` Total saved: ${theme.colors.success(response.totalSaved.toString() + ' tokens')}`);
+            if (response.compactionCount) {
+                console.log(` Compactions: ${theme.colors.highlight(response.compactionCount.toString())}`);
+            }
+            if (response.averageReduction) {
+                console.log(` Avg reduction: ${theme.colors.success(response.averageReduction + '%')}`);
+            }
+            if (response.costSaved) {
+                console.log(` Cost saved: ${theme.colors.success('$' + response.costSaved.toFixed(2))}`);
+            }
+        }
+        else {
+            console.log(theme.colors.muted('No compaction savings yet.'));
+        }
+        console.log();
+    }
+    catch (error) {
+        console.error(theme.colors.error(`Error: ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=savings.js.map

package/dist/commands/context/savings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savings.js","sourceRoot":"","sources":["../../../src/commands/context/savings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAO5D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,IAAI,uBAAuB,CAAC;IACnF,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,mBAAmB;QACnB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAEtD,cAAc;QACd,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,mBAAmB;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAExD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;YAEjG,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9F,CAAC;YAED,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1F,CAAC;YAED,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;IAEhB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/context/status.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context Status Command
+ * Show context budget status
+ */
+export interface ContextStatusOptions {
+    serverUrl?: string;
+    json?: boolean;
+}
+/**
+ * Show context budget status
+ */
+export declare function contextStatus(sessionId: string, options?: ContextStatusOptions): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/context/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/context/status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/commands/context/status.js

@@ -0,0 +1,52 @@
+/**
+ * Context Status Command
+ * Show context budget status
+ */
+import { CortexClient } from '../../client/CortexClient.js';
+import { ConfigManager } from '../../config/ConfigManager.js';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+/**
+ * Show context budget status
+ */
+export async function contextStatus(sessionId, options = {}) {
+    const config = await ConfigManager.load();
+    const serverUrl = options.serverUrl || config.serverUrl || 'http://localhost:4000';
+    const theme = ThemeManager.getTheme();
+    const client = new CortexClient(serverUrl);
+    try {
+        // Get context status
+        const response = await client.get(`/sessions/${sessionId}/context`);
+        // JSON output
+        if (options.json) {
+            console.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        // Formatted output
+        console.log(theme.colors.primary(`\n Context Budget Status - ${response.model.name}\n`));
+        // Model Info
+        console.log(theme.colors.secondary('Model:'));
+        console.log(` ${theme.colors.highlight(response.model.id)}`);
+        console.log(` Context Window: ${theme.colors.muted(response.model.contextWindow.toLocaleString() + ' tokens')}`);
+        console.log();
+        // Budget
+        console.log(theme.colors.secondary('Budget Allocation:'));
+        console.log(` Max Tokens: ${theme.colors.highlight(response.budget.maxTokens.toLocaleString())}`);
+        console.log(` Reserved for Output: ${theme.colors.muted(response.budget.reservedForOutput.toLocaleString())}`);
+        console.log(` Available for Input: ${theme.colors.muted(response.budget.availableForInput.toLocaleString())}`);
+        console.log(` System Messages: ${theme.colors.muted(response.budget.systemMessageAllocation.toLocaleString())}`);
+        console.log();
+        // Usage
+        console.log(theme.colors.secondary('Current Usage:'));
+        console.log(` Estimated Tokens: ${theme.colors.highlight(response.usage.estimatedTokens.toLocaleString())}`);
+        const utilization = response.usage.utilization;
+        const color = utilization > 90 ? theme.colors.error : utilization > 70 ? theme.colors.warning : theme.colors.success;
+        console.log(` Utilization: ${color(utilization.toFixed(1) + '%')}`);
+        console.log(` Remaining: ${theme.colors.muted(response.usage.remaining.toLocaleString() + ' tokens')}`);
+        console.log();
+    }
+    catch (error) {
+        console.error(theme.colors.error(`Error: ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=status.js.map