aura-code 0.6.3 → 0.10.1

package/dist/cli/context-health.js

@@ -0,0 +1,187 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextHealthTracker = void 0;
+exports.formatContextBar = formatContextBar;
+exports.formatContextDashboard = formatContextDashboard;
+exports.formatCompactionEvent = formatCompactionEvent;
+/**
+ * Context Health Dashboard — real-time visibility into token usage,
+ * compaction state, and session costs. Observational only — never
+ * modifies history or triggers compaction.
+ */
+const chalk_1 = __importDefault(require("chalk"));
+const diamond_js_1 = require("./diamond.js");
+const compactor_js_1 = require("../agent/compactor.js");
+const factory_js_1 = require("../providers/factory.js");
+const loop_js_1 = require("../agent/loop.js");
+const LADDER = [0.55, 0.70, 0.85];
+const ROLLOVER_AT_GENERATION = 3;
+const DEFAULT_WINDOW = 128_000;
+class ContextHealthTracker {
+    getSystem;
+    getHistory;
+    model;
+    pricingModel;
+    compactionEvents = [];
+    _turnCount = 0;
+    _toolCallCount = 0;
+    constructor(getSystem, getHistory, model, pricingModel) {
+        this.getSystem = getSystem;
+        this.getHistory = getHistory;
+        this.model = model;
+        this.pricingModel = pricingModel;
+    }
+    incrementTurn() { this._turnCount++; }
+    incrementToolCalls(n = 1) { this._toolCallCount += n; }
+    /** Replace the system-prompt source — used when a shared tracker is passed
+     *  into the loop and the loop builds the real (task-embedded) system prompt. */
+    updateSystem(s) { this.getSystem = () => s; }
+    recordCompaction(beforeTokens, afterTokens, generation) {
+        this.compactionEvents.push({ turn: this._turnCount, beforeTokens, afterTokens, generation });
+    }
+    snapshot(inputTokens = 0, outputTokens = 0) {
+        const system = this.getSystem();
+        const history = this.getHistory();
+        const estimatedTokens = (0, compactor_js_1.estimateContextTokens)(system, history);
+        const contextWindow = (0, factory_js_1.getContextWindow)(this.model) ?? DEFAULT_WINDOW;
+        const usagePercent = (estimatedTokens / contextWindow) * 100;
+        const recapGeneration = (0, compactor_js_1.getRecapGeneration)(history);
+        const genIndex = Math.min(recapGeneration, LADDER.length - 1);
+        const nextCompactionPercent = Math.round(LADDER[genIndex] * 100);
+        const nextCompactionThreshold = Math.floor(contextWindow * LADDER[genIndex]);
+        const tokensUntilCompaction = Math.max(0, nextCompactionThreshold - estimatedTokens);
+        return {
+            estimatedTokens, contextWindow, usagePercent, recapGeneration,
+            nextCompactionThreshold, nextCompactionPercent, tokensUntilCompaction,
+            rolloversRemaining: Math.max(0, ROLLOVER_AT_GENERATION - recapGeneration),
+            totalInputTokens: inputTokens, totalOutputTokens: outputTokens,
+            totalCostUsd: (0, loop_js_1.costFor)(this.pricingModel, inputTokens, outputTokens),
+            turnCount: this._turnCount, toolCallCount: this._toolCallCount,
+            compactionCount: this.compactionEvents.length,
+            largestMessages: getLargestMessages(history, system, 5),
+            compactionHistory: [...this.compactionEvents],
+        };
+    }
+}
+exports.ContextHealthTracker = ContextHealthTracker;
+function getLargestMessages(history, system, n) {
+    const messages = [];
+    messages.push({ role: 'system', preview: 'System prompt', tokens: (0, compactor_js_1.countText)(system), index: -1 });
+    for (let i = 0; i < history.length; i++) {
+        const msg = history[i];
+        const tokens = (0, compactor_js_1.countMessage)(msg);
+        let preview;
+        switch (msg.role) {
+            case 'user':
+                preview = msg.content?.slice(0, 60) ?? '(empty)';
+                break;
+            case 'assistant':
+                preview = msg.content?.slice(0, 60) || (msg.toolCalls?.length ? 'Calls: ' + msg.toolCalls.map(c => c.name).join(', ') : '(empty)');
+                break;
+            case 'tool_result':
+                preview = 'Tool: ' + msg.results.map(r => r.name).join(', ');
+                break;
+            default: preview = '(unknown)';
+        }
+        messages.push({ role: msg.role, preview, tokens, index: i });
+    }
+    return messages.sort((a, b) => b.tokens - a.tokens).slice(0, n);
+}
+function formatContextBar(h) {
+    const barWidth = 20;
+    const filled = Math.max(0, Math.min(barWidth, Math.round((h.usagePercent / 100) * barWidth)));
+    const ladderPos = LADDER.map(r => Math.floor(r * barWidth));
+    let bar = '';
+    for (let i = 0; i < barWidth; i++) {
+        if (i < filled)
+            bar += '\u2588';
+        else if (ladderPos.includes(i))
+            bar += '\u250a';
+        else
+            bar += '\u2591';
+    }
+    const barColor = h.usagePercent < 50 ? chalk_1.default.hex('#5a9e6e') : h.usagePercent < 70 ? chalk_1.default.hex('#d4903a') : chalk_1.default.hex('#b15439');
+    const pct = h.usagePercent.toFixed(0) + '%';
+    const tok = (h.estimatedTokens / 1000).toFixed(1) + 'k/' + (h.contextWindow / 1000).toFixed(0) + 'k';
+    const gen = h.recapGeneration > 0 ? ' \u00b7 gen ' + h.recapGeneration : '';
+    const compact = ' \u00b7 compact @ ' + h.nextCompactionPercent + '% (' + (h.nextCompactionThreshold / 1000).toFixed(0) + 'k)';
+    const cost = h.totalCostUsd > 0 ? ' \u00b7 $' + h.totalCostUsd.toFixed(2) : '';
+    return '  \u25c6 Context: ' + barColor(bar) + ' ' + pct + ' (' + tok + ')' + gen + compact + cost + ' \u00b7 ' + h.turnCount + ' turns';
+}
+function formatContextDashboard(h) {
+    const w = process.stdout.columns ?? 80;
+    const line = '\u2500'.repeat(Math.min(w - 4, 60));
+    const barWidth = 30;
+    const filled = Math.max(0, Math.min(barWidth, Math.round((h.usagePercent / 100) * barWidth)));
+    const ladderPos = LADDER.map(r => Math.floor(r * barWidth));
+    let bar = '';
+    for (let i = 0; i < barWidth; i++) {
+        if (i < filled)
+            bar += '\u2588';
+        else if (ladderPos.includes(i))
+            bar += '\u250a';
+        else
+            bar += '\u2591';
+    }
+    const barColor = h.usagePercent < 50 ? chalk_1.default.hex('#5a9e6e') : h.usagePercent < 70 ? chalk_1.default.hex('#d4903a') : chalk_1.default.hex('#b15439');
+    const freeTokens = Math.max(0, h.contextWindow - h.estimatedTokens);
+    const freePct = (100 - Math.min(100, h.usagePercent)).toFixed(0);
+    const lines = [
+        '',
+        chalk_1.default.hex(diamond_js_1.FAINT_HEX)(line),
+        chalk_1.default.hex('#cc785c').bold('  Context Health Dashboard'),
+        chalk_1.default.hex(diamond_js_1.FAINT_HEX)(line),
+        '',
+        '  Window:    ' + chalk_1.default.hex('#c8b5a0')(h.contextWindow.toLocaleString()) + ' tokens',
+        '  Used:      ' + chalk_1.default.hex('#c8b5a0')(h.estimatedTokens.toLocaleString()) + ' tokens (' + chalk_1.default.bold(h.usagePercent.toFixed(1) + '%') + ') ' + barColor(bar),
+        '  Free:      ' + chalk_1.default.hex('#c8b5a0')(freeTokens.toLocaleString()) + ' tokens (' + freePct + '%)',
+        '',
+        '  Compaction: ' + chalk_1.default.hex('#c8b5a0')('Generation ' + h.recapGeneration + ' of ' + ROLLOVER_AT_GENERATION),
+        '  Next fire:  ' + chalk_1.default.hex('#c8b5a0')(h.nextCompactionThreshold.toLocaleString() + ' tokens (' + h.nextCompactionPercent + '%)') + ' \u2014 ' + chalk_1.default.hex('#d4903a')(h.tokensUntilCompaction.toLocaleString() + ' tokens away'),
+        '  Ladder:     ' + formatLadder(h.recapGeneration),
+        '  Remaining:  ' + chalk_1.default.hex('#c8b5a0')(h.rolloversRemaining + ' compaction(s) before dream flush'),
+        '',
+        chalk_1.default.hex('#cc785c').bold('  Session totals'),
+        '    Input:    ' + chalk_1.default.hex('#c8b5a0')(h.totalInputTokens.toLocaleString()) + ' tokens',
+        '    Output:   ' + chalk_1.default.hex('#c8b5a0')(h.totalOutputTokens.toLocaleString()) + ' tokens',
+        '    Cost:     ' + chalk_1.default.hex('#c8b5a0')('$' + h.totalCostUsd.toFixed(4)),
+        '    Turns:    ' + chalk_1.default.hex('#c8b5a0')(String(h.turnCount)),
+        '    Tools:    ' + chalk_1.default.hex('#c8b5a0')(h.toolCallCount + ' calls'),
+    ];
+    if (h.compactionHistory.length > 0) {
+        lines.push('', chalk_1.default.hex('#cc785c').bold('  Compaction history'));
+        for (const e of h.compactionHistory) {
+            const saved = ((1 - e.afterTokens / e.beforeTokens) * 100).toFixed(0);
+            lines.push('    Turn ' + e.turn + ': ' + e.beforeTokens.toLocaleString() + ' \u2192 ' + e.afterTokens.toLocaleString() + ' tokens ' + chalk_1.default.hex('#5a9e6e')('(-' + saved + '%)') + ' gen ' + (e.generation - 1) + '\u2192' + e.generation);
+        }
+    }
+    if (h.largestMessages.length > 0) {
+        lines.push('', chalk_1.default.hex('#cc785c').bold('  Largest messages'));
+        for (const m of h.largestMessages) {
+            const idx = m.index === -1 ? 'sys' : '#' + m.index;
+            lines.push('    ' + chalk_1.default.hex(diamond_js_1.FAINT_HEX)(idx.padEnd(4)) + ' ' + chalk_1.default.hex(diamond_js_1.TEXT_DIM_HEX)(m.role.padEnd(12)) + ' ' + m.preview + ' ' + chalk_1.default.hex('#d4903a')(m.tokens.toLocaleString() + ' tok'));
+        }
+    }
+    lines.push('', chalk_1.default.hex(diamond_js_1.FAINT_HEX)(line), '');
+    return lines.join('\n');
+}
+function formatLadder(generation) {
+    const rungs = LADDER.map((r, i) => {
+        const pct = (r * 100).toFixed(0) + '%';
+        if (i < generation)
+            return chalk_1.default.hex('#5a9e6e')(pct + ' \u2713');
+        if (i === generation)
+            return chalk_1.default.hex('#d4903a')(pct + ' pending');
+        return chalk_1.default.hex(diamond_js_1.FAINT_HEX)(pct);
+    });
+    const flush = chalk_1.default.hex('#6d8fb3')('flush');
+    return rungs.join(' \u2192 ') + ' \u2192 ' + flush;
+}
+function formatCompactionEvent(beforeTokens, afterTokens, generation, threshold) {
+    const saved = ((1 - afterTokens / beforeTokens) * 100).toFixed(0);
+    return 'Context compacted: ' + beforeTokens.toLocaleString() + ' \u2192 ' + afterTokens.toLocaleString() + ' tokens ' + chalk_1.default.hex('#5a9e6e')('(-' + saved + '%)') + ' \u00b7 gen ' + generation + ' \u00b7 threshold ' + threshold.toLocaleString();
+}
+//# sourceMappingURL=context-health.js.map

package/dist/cli/context-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-health.js","sourceRoot":"","sources":["../../src/cli/context-health.ts"],"names":[],"mappings":";;;;;;AAoHA,4CAiBC;AAED,wDAyDC;AAaD,sDAGC;AAhND;;;;GAIG;AACH,kDAA0B;AAC1B,6CAAuD;AAEvD,wDAA2G;AAC3G,wDAA2D;AAC3D,8CAA2C;AAE3C,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAC3C,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,MAAM,cAAc,GAAG,OAAO,CAAC;AAmC/B,MAAa,oBAAoB;IAMrB;IACA;IACA;IACA;IARF,gBAAgB,GAAsB,EAAE,CAAC;IACzC,UAAU,GAAG,CAAC,CAAC;IACf,cAAc,GAAG,CAAC,CAAC;IAE3B,YACU,SAAuB,EACvB,UAAkC,EAClC,KAAa,EACb,YAAoB;QAHpB,cAAS,GAAT,SAAS,CAAc;QACvB,eAAU,GAAV,UAAU,CAAwB;QAClC,UAAK,GAAL,KAAK,CAAQ;QACb,iBAAY,GAAZ,YAAY,CAAQ;IAC3B,CAAC;IAEJ,aAAa,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACtC,kBAAkB,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,CAAC;IAEvD;oFACgF;IAChF,YAAY,CAAC,CAAS,IAAI,IAAI,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,gBAAgB,CAAC,YAAoB,EAAE,WAAmB,EAAE,UAAkB;QAC5E,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,QAAQ,CAAC,WAAW,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,eAAe,GAAG,IAAA,oCAAqB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,aAAa,GAAG,IAAA,6BAAgB,EAAC,IAAI,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC;QACrE,MAAM,YAAY,GAAG,CAAC,eAAe,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC;QAC7D,MAAM,eAAe,GAAG,IAAA,iCAAkB,EAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,qBAAqB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;QACjE,MAAM,uBAAuB,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7E,MAAM,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,GAAG,eAAe,CAAC,CAAC;QAErF,OAAO;YACL,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe;YAC7D,uBAAuB,EAAE,qBAAqB,EAAE,qBAAqB;YACrE,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAAC;YACzE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY;YAC9D,YAAY,EAAE,IAAA,iBAAO,EAAC,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;YACnE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,CAAC,cAAc;YAC9D,eAAe,EAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM;YAC7C,eAAe,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YACvD,iBAAiB,EAAE,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC;SAC9C,CAAC;IACJ,CAAC;CACF;AA/CD,oDA+CC;AAED,SAAS,kBAAkB,CAAC,OAAyB,EAAE,MAAc,EAAE,CAAS;IAC9E,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,IAAA,wBAAS,EAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAClG,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,MAAM,GAAG,IAAA,2BAAY,EAAC,GAAG,CAAC,CAAC;QACjC,IAAI,OAAe,CAAC;QACpB,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,MAAM;gBAAE,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC;gBAAC,MAAM;YACrE,KAAK,WAAW;gBAAE,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBAAC,MAAM;YAC5J,KAAK,aAAa;gBAAE,OAAO,GAAG,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAAC,MAAM;YACxF,OAAO,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC;QACjC,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAgB,gBAAgB,CAAC,CAAgB;IAC/C,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9F,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC5D,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,MAAM;YAAE,GAAG,IAAI,QAAQ,CAAC;aAC3B,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,GAAG,IAAI,QAAQ,CAAC;;YAC3C,GAAG,IAAI,QAAQ,CAAC;IACvB,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChI,MAAM,GAAG,GAAG,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAC5C,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACrG,MAAM,GAAG,GAAG,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,OAAO,GAAG,oBAAoB,GAAG,CAAC,CAAC,qBAAqB,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9H,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,oBAAoB,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,GAAG,CAAC,CAAC,SAAS,GAAG,QAAQ,CAAC;AAC1I,CAAC;AAED,SAAgB,sBAAsB,CAAC,CAAgB;IACrD,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9F,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC5D,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,MAAM;YAAE,GAAG,IAAI,QAAQ,CAAC;aAC3B,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,GAAG,IAAI,QAAQ,CAAC;;YAC3C,GAAG,IAAI,QAAQ,CAAC;IACvB,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChI,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEjE,MAAM,KAAK,GAAa;QACtB,EAAE;QACF,eAAK,CAAC,GAAG,CAAC,sBAAS,CAAC,CAAC,IAAI,CAAC;QAC1B,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC;QACvD,eAAK,CAAC,GAAG,CAAC,sBAAS,CAAC,CAAC,IAAI,CAAC;QAC1B,EAAE;QACF,eAAe,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC,GAAG,SAAS;QACpF,eAAe,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC,GAAG,WAAW,GAAG,eAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC;QAC7J,eAAe,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,GAAG,WAAW,GAAG,OAAO,GAAG,IAAI;QAClG,EAAE;QACF,gBAAgB,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,eAAe,GAAG,MAAM,GAAG,sBAAsB,CAAC;QAC5G,gBAAgB,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,cAAc,EAAE,GAAG,WAAW,GAAG,CAAC,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,UAAU,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,cAAc,EAAE,GAAG,cAAc,CAAC;QACjO,gBAAgB,GAAG,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC;QAClD,gBAAgB,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,kBAAkB,GAAG,mCAAmC,CAAC;QACnG,EAAE;QACF,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAC7C,gBAAgB,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,GAAG,SAAS;QACxF,gBAAgB,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,cAAc,EAAE,CAAC,GAAG,SAAS;QACzF,gBAAgB,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACxE,gBAAgB,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5D,gBAAgB,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,QAAQ,CAAC;KACpE,CAAC;IAEF,IAAI,CAAC,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAClE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,cAAc,EAAE,GAAG,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,cAAc,EAAE,GAAG,UAAU,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QAC5O,CAAC;IACH,CAAC;IAED,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAChE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,eAAK,CAAC,GAAG,CAAC,sBAAS,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,eAAK,CAAC,GAAG,CAAC,yBAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,GAAG,GAAG,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;QACjM,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,eAAK,CAAC,GAAG,CAAC,sBAAS,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,UAAkB;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACvC,IAAI,CAAC,GAAG,UAAU;YAAE,OAAO,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,UAAU;YAAE,OAAO,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC;QACpE,OAAO,eAAK,CAAC,GAAG,CAAC,sBAAS,CAAC,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,KAAK,CAAC;AACrD,CAAC;AAED,SAAgB,qBAAqB,CAAC,YAAoB,EAAE,WAAmB,EAAE,UAAkB,EAAE,SAAiB;IACpH,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,qBAAqB,GAAG,YAAY,CAAC,cAAc,EAAE,GAAG,UAAU,GAAG,WAAW,CAAC,cAAc,EAAE,GAAG,UAAU,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,UAAU,GAAG,oBAAoB,GAAG,SAAS,CAAC,cAAc,EAAE,CAAC;AACtP,CAAC"}

package/dist/cli/diamond.d.ts

@@ -1 +1,68 @@
+import chalk from 'chalk';
+export declare const RUBY_HEX = "#9b1b30";
+export declare const RUBY_ACCENT: chalk.Chalk;
+export declare const BG_HEX = "#0f1724";
+export declare const PANEL_BG_HEX = "#1c2739";
+export declare const TERRACOTTA_HEX = "#cc785c";
+export declare const TEXT_HEX = "#e8e6e3";
+export declare const TEXT_DIM_HEX = "#8a94a6";
+export declare const FAINT_HEX = "#4a5568";
+export declare const TEXT: chalk.Chalk;
+export declare const TEXT_DIM: chalk.Chalk;
+export declare const FAINT: chalk.Chalk;
+export declare const CHROME_DIM: chalk.Chalk;
+/**
+ * Color a run of identical border/rule characters with the four-stop ruby
+ * gradient, dark → bright, split into four roughly equal segments across
+ * its length. Works for horizontal rules ('─'.repeat(n)) and is also used
+ * character-by-character for vertical dividers (see `gradientRows`).
+ */
+export declare function gradient(str: string): string;
+/** Bold variant of `gradient()` — for borders that need extra visual weight (e.g. the input box, where the user types). */
+export declare function gradientBold(str: string): string;
+/**
+ * Color for the Nth row (0-indexed) of a `total`-row vertical divider —
+ * dark at the top, bright at the bottom, same four stops as `gradient()`.
+ * Used to color a single divider character ('│') per output row.
+ */
+export declare function gradientStopFor(row: number, total: number): chalk.Chalk;
+/**
+ * Brilliant-cut gem, 9 rows: a narrow flat table, a widening crown, the
+ * wide girdle (row 4, the widest point), then a long tapering pavilion
+ * down to a single point — the silhouette of an actual cut diamond, not
+ * a symmetric kite or a wedge. Solid blocks only (no fractional glyphs)
+ * so the point renders cleanly on every terminal font; per-row 3D facet
+ * shading is applied at render time by styleGemRow, not baked in here.
+ */
+export declare const GEM: string[];
+/** Column width of one gem row (all rows share the same padded width). */
+export declare const GEM_WIDTH: number;
+/** The gem's styled Nth row, or null if out of range — for compositing beside other columns. */
+export declare function gemRow(i: number): string | null;
+export interface BannerInfo {
+    version: string;
+    title?: string;
+    model?: string;
+    provider?: string;
+    language?: string;
+    mode?: string;
+    cwd?: string;
+    extras?: string[];
+}
+/** Clear the screen and move the cursor to the top-left (home). */
+export declare function clearToTop(): void;
+/**
+ * The banner's fully-styled lines, one string per terminal row:
+ * - Brilliant-cut gem centered above the wordmark, each row faceted
+ *   left-bright / mid / shadow (light hits from the top-left).
+ * - LOGO text gets a left-bright / right-shadow treatment.
+ * - Session metadata (version, provider/model, cwd, tagline) below.
+ * Exposed separately from renderBanner() so the TUI can keep a copy and
+ * repaint the banner itself when it rebuilds the screen (e.g. returning
+ * from scroll mode) — the alt screen has no scrollback to recover it from.
+ */
+export declare function buildBannerLines(info: BannerInfo): string[];
+/** Render the banner pinned to the top of a cleared screen, so it reads like a real app header, not scrollback. */
+export declare function renderBanner(info: BannerInfo): void;
+/** Standalone diamond (no logo, no info column) — splash contexts. */
 export declare function renderDiamond(): void;

package/dist/cli/diamond.js

@@ -3,21 +3,231 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEM_WIDTH = exports.GEM = exports.CHROME_DIM = exports.FAINT = exports.TEXT_DIM = exports.TEXT = exports.FAINT_HEX = exports.TEXT_DIM_HEX = exports.TEXT_HEX = exports.TERRACOTTA_HEX = exports.PANEL_BG_HEX = exports.BG_HEX = exports.RUBY_ACCENT = exports.RUBY_HEX = void 0;
+exports.gradient = gradient;
+exports.gradientBold = gradientBold;
+exports.gradientStopFor = gradientStopFor;
+exports.gemRow = gemRow;
+exports.clearToTop = clearToTop;
+exports.buildBannerLines = buildBannerLines;
+exports.renderBanner = renderBanner;
 exports.renderDiamond = renderDiamond;
 const chalk_1 = __importDefault(require("chalk"));
-const r = chalk_1.default.hex('#9b1b30');
-const g = chalk_1.default.hex('#c9a84c');
-const w = chalk_1.default.hex('#f0ece4');
+// Ruby palette — matches https://aurawebsite-self.vercel.app/
+// (#e63956 bright ruby, #9b1b30 primary, #4a0d1a deep wine)
+const light = chalk_1.default.hex('#e63956');
+const mid = chalk_1.default.hex('#c22743');
+const ruby = chalk_1.default.hex('#9b1b30');
+const shadow = chalk_1.default.hex('#6d1322');
+// Primary ruby as a single reusable accent (e.g. the message-bubble left
+// bar) — distinct from the 4-stop gradient, which is for dividers/borders.
+exports.RUBY_HEX = '#9b1b30';
+exports.RUBY_ACCENT = ruby;
+// ── Palette v3: bluish-dark background, terracotta chrome, white text ──────
+// Terminal background, set via OSC 11 on TUI start (desaturated dark navy).
+exports.BG_HEX = '#0f1724';
+// Elevated panel background (code/log blocks) — one step lighter than BG_HEX.
+exports.PANEL_BG_HEX = '#1c2739';
+// Tool/UI chrome — the terracotta already used for tool labels and mode
+// indicators across the CLI. Everything that is "the tooling talking to you".
+exports.TERRACOTTA_HEX = '#cc785c';
+// Primary text (user input, assistant replies, body copy) — near-white for
+// maximum readability on the bluish background.
+exports.TEXT_HEX = '#e8e6e3';
+// Secondary/de-emphasized text — desaturated blue-gray, quieter than TEXT_HEX
+// but still readable on BG_HEX.
+exports.TEXT_DIM_HEX = '#8a94a6';
+// Faintest text (rules, timings, ellipses) — visible but receding on BG_HEX.
+exports.FAINT_HEX = '#4a5568';
+exports.TEXT = chalk_1.default.hex(exports.TEXT_HEX);
+exports.TEXT_DIM = chalk_1.default.hex(exports.TEXT_DIM_HEX);
+exports.FAINT = chalk_1.default.hex(exports.FAINT_HEX);
+// Muted terracotta for unfocused/quiet chrome (e.g. blurred panel borders).
+exports.CHROME_DIM = chalk_1.default.hex('#8a5a48');
+const dim = exports.TEXT_DIM;
+/**
+ * The four terracotta stops, dark end → bright end, centered on
+ * TERRACOTTA_HEX. Used for every line that separates fields/panels/sections
+ * (box borders, rules, column dividers) — per the fixed palette rule,
+ * dividers get this same four-stop gradient rather than a single flat hue.
+ * (The ruby stops above remain for the gem/logo branding only.)
+ */
+const chromeShadow = chalk_1.default.hex('#7a4636');
+const chromeMid = chalk_1.default.hex('#a05a44');
+const chromeBase = chalk_1.default.hex(exports.TERRACOTTA_HEX);
+const chromeLight = chalk_1.default.hex('#e29a80');
+const GRADIENT_STOPS = [chromeShadow, chromeMid, chromeBase, chromeLight];
+/**
+ * Color a run of identical border/rule characters with the four-stop ruby
+ * gradient, dark → bright, split into four roughly equal segments across
+ * its length. Works for horizontal rules ('─'.repeat(n)) and is also used
+ * character-by-character for vertical dividers (see `gradientRows`).
+ */
+function gradient(str) {
+    const len = str.length;
+    if (len === 0)
+        return str;
+    const segLen = Math.max(1, Math.ceil(len / GRADIENT_STOPS.length));
+    let out = '';
+    let i = 0;
+    for (const stop of GRADIENT_STOPS) {
+        if (i >= len)
+            break;
+        out += stop(str.slice(i, i + segLen));
+        i += segLen;
+    }
+    return out;
+}
+/** Bold variant of `gradient()` — for borders that need extra visual weight (e.g. the input box, where the user types). */
+function gradientBold(str) {
+    const len = str.length;
+    if (len === 0)
+        return str;
+    const segLen = Math.max(1, Math.ceil(len / GRADIENT_STOPS.length));
+    let out = '';
+    let i = 0;
+    for (const stop of GRADIENT_STOPS) {
+        if (i >= len)
+            break;
+        out += stop.bold(str.slice(i, i + segLen));
+        i += segLen;
+    }
+    return out;
+}
+/**
+ * Color for the Nth row (0-indexed) of a `total`-row vertical divider —
+ * dark at the top, bright at the bottom, same four stops as `gradient()`.
+ * Used to color a single divider character ('│') per output row.
+ */
+function gradientStopFor(row, total) {
+    const idx = Math.min(GRADIENT_STOPS.length - 1, Math.floor((row / Math.max(1, total)) * GRADIENT_STOPS.length));
+    return GRADIENT_STOPS[idx];
+}
+/**
+ * Brilliant-cut gem, 9 rows: a narrow flat table, a widening crown, the
+ * wide girdle (row 4, the widest point), then a long tapering pavilion
+ * down to a single point — the silhouette of an actual cut diamond, not
+ * a symmetric kite or a wedge. Solid blocks only (no fractional glyphs)
+ * so the point renders cleanly on every terminal font; per-row 3D facet
+ * shading is applied at render time by styleGemRow, not baked in here.
+ */
+exports.GEM = [
+    '   █████    ', // table
+    '  ████████  ', // crown
+    ' ██████████ ', // crown → girdle
+    '████████████', // girdle (widest)
+    ' █████████  ', // pavilion
+    '  ███████   ', // pavilion
+    '   █████    ', // pavilion
+    '    ███     ', // pavilion, narrowing to the point
+    '     █      ', // point
+];
+/** Column width of one gem row (all rows share the same padded width). */
+exports.GEM_WIDTH = exports.GEM[0].length;
+/** The gem's styled Nth row, or null if out of range — for compositing beside other columns. */
+function gemRow(i) {
+    const row = exports.GEM[i];
+    return row === undefined ? null : styleGemRow(row, FACET_SHADES);
+}
+const LOGO = [
+    ' ░▒▓██████▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓███████▓▒░ ░▒▓██████▓▒░         ░▒▓██████▓▒░  ▒▓██████▓▒░░▒▓███████▓▒░░ ▒▓████████▓ ',
+    '░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░       ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ ▒▓█▓▒░      ',
+    '░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░       ░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░░▒▓█▓▒░▒▓█▓▒░      ',
+    '░▒▓████████▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓███████▓▒░░▒▓████████▓▒░       ░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░░▒▓█▓▒░▒▓██████▓▒  ',
+    '░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░       ░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░░▒▓█▓▒░▒▓█▓▒░      ',
+    '░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░       ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ ▒▓█▓▒░      ',
+    '░▒▓█▓▒░░▒▓█▓▒░░▒▓██████▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░        ░▒▓██████▓▒░ ░▒▓██████▓▒░░▒▓███████▓▒░░ ▒▓████████▓ ',
+];
+// Shade zones for 3D faceted diamond: [leftFace, midFace, shadowFace].
+// Light comes from top-left, so left face is brightest.
+const FACET_SHADES = [light, mid, shadow];
+/** Clear the screen and move the cursor to the top-left (home). */
+function clearToTop() {
+    // \x1b[2J clears the screen, \x1b[3J wipes scrollback, \x1b[H homes cursor.
+    // Matches how Claude Code pins its header at the top on launch.
+    if (process.stdout.isTTY)
+        process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
+}
+/** A ruby-gradient horizontal rule spanning the terminal width (capped). */
+function rule() {
+    const width = Math.min(process.stdout.columns ?? 80, 100);
+    return gradient('─'.repeat(width));
+}
+/**
+ * Apply 3D faceted lighting to a diamond row: bright → mid → shadow across
+ * the width of its solid-block run (three-zone split, 40/35/25).
+ */
+function styleGemRow(row, shades) {
+    const match = row.match(/([█]+)/);
+    if (!match)
+        return row;
+    const blockStr = match[1];
+    const blockIdx = match.index;
+    const len = blockStr.length;
+    const leftLen = Math.max(1, Math.ceil(len * 0.40));
+    const midLen = Math.max(1, Math.ceil(len * 0.35));
+    const rightLen = Math.max(0, len - leftLen - midLen);
+    let styled = '';
+    if (leftLen > 0)
+        styled += shades[0](blockStr.slice(0, leftLen));
+    if (midLen > 0)
+        styled += shades[1](blockStr.slice(leftLen, leftLen + midLen));
+    if (rightLen > 0)
+        styled += shades[2](blockStr.slice(leftLen + midLen));
+    return row.slice(0, blockIdx) + styled + row.slice(blockIdx + len);
+}
+/** The gem's styled rows, centered above whatever text follows them. */
+function gemBlockLines(indent) {
+    const pad = ' '.repeat(Math.max(0, indent));
+    return exports.GEM.map(row => pad + styleGemRow(row, FACET_SHADES));
+}
+/** Render the gem alone, centered above whatever text follows it. */
+function renderGemBlock(indent) {
+    gemBlockLines(indent).forEach(line => console.log(line));
+}
+/**
+ * The banner's fully-styled lines, one string per terminal row:
+ * - Brilliant-cut gem centered above the wordmark, each row faceted
+ *   left-bright / mid / shadow (light hits from the top-left).
+ * - LOGO text gets a left-bright / right-shadow treatment.
+ * - Session metadata (version, provider/model, cwd, tagline) below.
+ * Exposed separately from renderBanner() so the TUI can keep a copy and
+ * repaint the banner itself when it rebuilds the screen (e.g. returning
+ * from scroll mode) — the alt screen has no scrollback to recover it from.
+ */
+function buildBannerLines(info) {
+    const lines = [''];
+    const gemIndent = Math.floor((LOGO[0].length - exports.GEM[0].length) / 2);
+    lines.push(...gemBlockLines(gemIndent), '');
+    LOGO.forEach(row => {
+        const midPoint = Math.floor(row.length / 2);
+        lines.push(light(row.slice(0, midPoint)) + shadow(row.slice(midPoint)));
+    });
+    lines.push('');
+    const meta = [
+        info.provider,
+        info.model,
+        info.language,
+        info.mode && `${info.mode} mode`,
+        ...(info.extras ?? []),
+    ].filter(Boolean).join(' · ');
+    lines.push('  ' + ruby.bold(`v${info.version}`) + (info.title ? dim(` — ${info.title}`) : ''));
+    if (meta)
+        lines.push('  ' + dim(meta));
+    lines.push('  ' + dim(info.cwd ?? process.cwd()));
+    lines.push('  ' + light.italic('"I don\'t try. I verify."'));
+    lines.push(rule());
+    return lines;
+}
+/** Render the banner pinned to the top of a cleared screen, so it reads like a real app header, not scrollback. */
+function renderBanner(info) {
+    clearToTop();
+    buildBannerLines(info).forEach(line => console.log(line));
+}
+/** Standalone diamond (no logo, no info column) — splash contexts. */
 function renderDiamond() {
-    console.log(r('           / / /  \ \ \           '));
-    console.log(w('          /__|____|__|__\          '));
-    console.log(w('          \  |    |  | /          '));
-    console.log(r('           \ \    / / /           '));
-    console.log(r('            \ \  / //            '));
-    console.log(r('             \ \/ //             '));
-    console.log(g('              \  //              '));
-    console.log(g('               \//               '));
-    console.log(g('                V                '));
+    console.log('');
+    renderGemBlock(2);
     console.log('');
 }
 //# sourceMappingURL=diamond.js.map

package/dist/cli/diamond.js.map

@@ -1 +1 @@
-{"version":3,"file":"diamond.js","sourceRoot":"","sources":["../../src/cli/diamond.ts"],"names":[],"mappings":";;;;;AAMA,sCAWC;AAjBD,kDAA0B;AAE1B,MAAM,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC/B,MAAM,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC/B,MAAM,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAE/B,SAAgB,aAAa;IAC3B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"diamond.js","sourceRoot":"","sources":["../../src/cli/diamond.ts"],"names":[],"mappings":"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"}

package/dist/cli/dic.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};