@cspeach/cli 1.1.32 → 1.1.33

package/dist/commands/cost.js

@@ -83,7 +83,7 @@ export async function runCostCommand(sessionId, credits = globalCredits.snapshot
         emit('');
         emit(panelRow('Readers', `${s.readerCalls} run${s.readerCalls === 1 ? '' : 's'}   ${formatCost(s.readerCost)}`));
     }
-    if (s.byModel.length > 1) {
+    if (s.byModel.length > 1 && !inCredits) {
         emit('');
         emit(chalk.bold('By model:'));
         for (const m of s.byModel) {
@@ -93,7 +93,9 @@ export async function runCostCommand(sessionId, credits = globalCredits.snapshot
             emit(panelRow(modelText(m.model), `${m.turns} turn${m.turns === 1 ? '' : 's'}${tail}`, 24));
         }
     }
-    else if (s.byModel[0]) {
+    else if (s.byModel[0] && !inCredits) {
+        // 2026-10-09 (owner): no model line for managed customers — they pay in
+        // credits and cannot change the model here; it only invites questions.
         emit('');
         emit(panelRow('Model', modelText(s.byModel[0].model)));
     }
@@ -124,6 +126,8 @@ export async function runCostCommand(sessionId, credits = globalCredits.snapshot
             + `their usage is included in a later turn's figure.`).trimEnd());
     }
     emit('');
+    if (inCredits)
+        emit(formatInfo('This month and your top skills: /usage').trimEnd());
     emit(formatInfo(`Detailed JSONL: ~/.cspeach/sessions/${sessionId}-cost.jsonl`).trimEnd());
     emit('');
 }

package/dist/commands/help.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { SKILL_CATALOG } from '../skill-catalog.js';
-import { costCommandDescription } from '../repl/builtin-commands.js';
+import { costCommandDescription, USAGE_DESCRIPTION } from '../repl/builtin-commands.js';
 import { panelHeading } from '../renderer/panel-rows.js';
 import { paint } from '../renderer/theme.js';
 import { uiWidth, truncateToWidth } from '../renderer/ui-width.js';
@@ -52,6 +52,7 @@ export const HELP_GROUPS = [
             { name: '/new', description: fixed('Next prompt picks a skill afresh (also /reset)') },
             { name: '/recap', description: fixed('Show the recap (last session, open tasks, plan)') },
             { name: '/cost', description: costCommandDescription },
+            { name: '/usage', description: fixed(USAGE_DESCRIPTION) },
             { name: '/context', description: fixed("Show what fills the model's context window") },
             { name: '/compact', description: fixed('Shrink a long session and keep the facts') },
             { name: '/help', description: fixed('This screen (also /skills)') },

package/dist/commands/usage.js

@@ -0,0 +1,106 @@
+/**
+ * `/usage` slash command (2026-10-09) — this month at a glance, in credits:
+ * a bar of what this month used against what was available, the balance,
+ * the top skills and this session. `/cost` stays the per-turn detail.
+ *
+ * Managed only: the numbers come from the proxy's credit ledger
+ * (GET /v1/me/usage). Own key / local mode: no CSPeach ledger exists, so the
+ * panel says where monthly usage lives instead. Never a dollar figure.
+ * Colours: the panels palette only (panelHeading / panelRow / paint).
+ */
+import { loadConfig } from '../config/loader.js';
+import { getStore } from '../auth/api-key.js';
+import { creditsActive, formatCredits, globalCredits } from '../cost/credits.js';
+import { fetchMonthUsage } from '../cost/month-usage.js';
+import { panelHeading, panelRow } from '../renderer/panel-rows.js';
+import { formatInfo } from '../renderer/notice-shape.js';
+import { paint } from '../renderer/theme.js';
+import { sanitizeControlChars } from '../renderer/sanitize.js';
+import { shouldUseUnicodeBoxChars } from '../renderer/tty.js';
+const BAR_WIDTH = 20;
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+/** used / (used + left), as filled cells of BAR_WIDTH; a non-zero use shows at least one cell. */
+export function usageBar(used, left, unicode = shouldUseUnicodeBoxChars()) {
+    const total = used + Math.max(0, left ?? 0);
+    let filled = total > 0 ? Math.round((BAR_WIDTH * used) / total) : 0;
+    if (used > 0 && filled === 0)
+        filled = 1;
+    filled = Math.min(BAR_WIDTH, filled);
+    const [on, off] = unicode ? ['█', '░'] : ['#', '-'];
+    return paint('brand', on.repeat(filled)) + paint('frame', off.repeat(BAR_WIDTH - filled));
+}
+function monthName(iso) {
+    const d = iso ? new Date(iso) : new Date();
+    return MONTHS[(Number.isNaN(d.getTime()) ? new Date() : d).getUTCMonth()];
+}
+async function defaultDeps() {
+    const cfg = await loadConfig();
+    return {
+        mode: cfg.llm?.mode ?? 'managed',
+        fetchUsage: () => fetchMonthUsage(cfg, async () => (await (await getStore()).get()) ?? ''),
+        // Credits seen this run (balance deltas); unknown outside credits mode.
+        sessionCredits: creditsActive() ? globalCredits.snapshot().sessionTotal : null,
+    };
+}
+export async function runUsageCommand(emit = (l) => console.log(l), deps) {
+    // Review fix: a config that fails to load mid-session must not throw out of
+    // the REPL handler — fall back to the "could not reach" line.
+    let d;
+    try {
+        d = deps ?? await defaultDeps();
+    }
+    catch {
+        d = { mode: 'managed', fetchUsage: async () => null, sessionCredits: null };
+    }
+    emit('');
+    if (d.mode !== 'managed') {
+        emit(panelHeading('Usage'));
+        emit(formatInfo('You are on your own model key, so CSPeach keeps no monthly usage. It is in your provider account. /cost shows this session.').trimEnd());
+        emit('');
+        return;
+    }
+    const u = await d.fetchUsage();
+    if (!u) {
+        emit(panelHeading('Usage'));
+        emit(formatInfo('Could not reach CSPeach for this month’s usage. Try again in a moment. /cost shows this session.').trimEnd());
+        emit('');
+        return;
+    }
+    if (!u.metered) {
+        emit(panelHeading('Usage'));
+        emit(formatInfo('This account is not billed in credits, so there is no monthly credit usage to show. /cost shows this session.').trimEnd());
+        emit('');
+        return;
+    }
+    const unit = u.unitLabel;
+    const used = u.monthUsed ?? 0;
+    emit(panelHeading('Usage', `this month (${monthName(u.monthStart)}, UTC)`));
+    emit('');
+    emit(panelRow('This month', `${usageBar(used, u.balance)}  ${formatCredits(used, unit)} used`, 14));
+    if (u.balance !== null) {
+        const split = u.subscription !== null && u.purchased !== null
+            ? paint('dim', `   monthly ${Math.round(u.subscription).toLocaleString('en-US')} · bought ${Math.round(u.purchased).toLocaleString('en-US')}`)
+            : '';
+        emit(panelRow('Balance', `${formatCredits(u.balance, unit)} left${split}`, 14));
+    }
+    if (u.topSkills.length > 0) {
+        emit('');
+        emit(panelHeading('Top skills this month'));
+        const width = Math.max(14, ...u.topSkills.map((s) => sanitizeControlChars(s.skill).length + 2));
+        const valueWidth = Math.max(...u.topSkills.map((s) => Math.round(s.credits).toLocaleString('en-US').length));
+        for (const s of u.topSkills) {
+            emit(panelRow(sanitizeControlChars(s.skill), Math.round(s.credits).toLocaleString('en-US').padStart(valueWidth), width));
+        }
+        if (u.otherSkills > 0) {
+            emit(panelRow('other skills', Math.round(u.otherSkills).toLocaleString('en-US').padStart(valueWidth), width));
+        }
+    }
+    emit('');
+    if (d.sessionCredits !== null) {
+        emit(panelRow('This session', `${formatCredits(d.sessionCredits, unit)}${paint('dim', '   details: /cost')}`, 14));
+    }
+    else {
+        emit(formatInfo('Details for this session: /cost').trimEnd());
+    }
+    emit('');
+}

package/dist/cost/month-usage.js

@@ -0,0 +1,45 @@
+export const MONTH_USAGE_TIMEOUT_MS = 5_000;
+function num(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : null;
+}
+export async function fetchMonthUsage(cfg, getBearer, fetchFn = fetch) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), MONTH_USAGE_TIMEOUT_MS);
+    try {
+        const key = await getBearer();
+        if (!key)
+            return null;
+        const r = await fetchFn(`${cfg.proxy_url.replace(/\/$/, '')}/v1/me/usage`, {
+            headers: { Authorization: `Bearer ${key}` },
+            signal: controller.signal,
+        });
+        if (!r.ok)
+            return null;
+        const b = await r.json();
+        if (typeof b !== 'object' || b === null)
+            return null;
+        const o = b;
+        const skills = Array.isArray(o.top_skills) ? o.top_skills : [];
+        return {
+            metered: o.metered === true,
+            unitLabel: typeof o.unit_label === 'string' && o.unit_label ? o.unit_label : 'credits',
+            monthStart: typeof o.month_start === 'string' ? o.month_start : null,
+            monthUsed: num(o.month_used_credits),
+            topSkills: skills.flatMap((s) => {
+                const e = s;
+                const credits = num(e?.credits);
+                return typeof e?.skill === 'string' && credits !== null ? [{ skill: e.skill, credits }] : [];
+            }),
+            otherSkills: num(o.other_skills_credits) ?? 0,
+            balance: num(o.balance_credits),
+            subscription: num(o.subscription_credits),
+            purchased: num(o.purchased_credits),
+        };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}

package/dist/repl/builtin-commands.js

@@ -14,6 +14,8 @@ import { BUNDLED_RUNS } from '../runs/bundled-runs.js';
 export const COST_DESCRIPTION_USD = 'Show this session\'s spend so far ($ and tokens)';
 export const COST_DESCRIPTION_CREDITS = 'Show the credits this session has used so far';
 /** Piece 2 §10: managed customers see credits, never "$" (cost/display-mode.ts). */
+/** /usage (2026-10-09): this month in credits — see commands/usage.ts. */
+export const USAGE_DESCRIPTION = 'Show this month’s credits, your balance and the top skills';
 export function costCommandDescription() {
     return creditsActive() ? COST_DESCRIPTION_CREDITS : COST_DESCRIPTION_USD;
 }
@@ -21,6 +23,7 @@ export const BUILTIN_ENTRIES = [
     // Piece 2: /cancel is not listed — it exists only in the classic loop
     // (repl.tsx), and Esc / Ctrl+C already cancel under Ink.
     { name: '/cost', get description() { return costCommandDescription(); } },
+    { name: '/usage', description: USAGE_DESCRIPTION },
     { name: '/compact', description: 'Shrink a long session and keep the facts (later turns cost far less)' },
     { name: '/export', description: 'Export the signable session audit record — /export audit [filename]' },
     { name: '/context', description: 'Show what fills the model context window — a composition grid of bars' },

package/dist/repl/slash-completer.js

@@ -22,6 +22,7 @@ const BUILTIN_COMMANDS = [
     '/cancel',
     '/compact',
     '/cost',
+    '/usage',
     '/context',
     '/export',
     '/exit',

package/dist/repl.js

@@ -1068,6 +1068,12 @@ export async function runRepl(opts) {
                 printHelp((line) => chunkEmitter.emit('chunk', line + '\n'));
                 return;
             }
+            // /usage (2026-10-09) — this month in credits, from the proxy's ledger.
+            if (trimmed === '/usage') {
+                const { runUsageCommand } = await import('./commands/usage.js');
+                await runUsageCommand((l) => chunkEmitter.emit('chunk', l + '\n'));
+                return;
+            }
             // Phase 1 cost tracking (2026-05-16) — /cost prints session $ summary
             // from the JSONL log written each turn. Read-only, no network.
             if (trimmed === '/cost') {
@@ -2992,6 +2998,12 @@ export async function runRepl(opts) {
             printHelp();
             continue;
         }
+        // /usage (2026-10-09) — classic mirror of the Ink handler above.
+        if (trimmed === '/usage') {
+            const { runUsageCommand } = await import('./commands/usage.js');
+            await runUsageCommand();
+            continue;
+        }
         // Phase 1 cost tracking (2026-05-16) — classic-mode /cost.
         // Mirrors the Ink-mode handler above. /cost prints session $ summary
         // from the JSONL log written each turn. Read-only, no network.

package/dist/skills/bundled-skills.js

@@ -1,6 +1,6 @@
 // GENERATED FILE — bundled skills for local mode.
 // Source: https://manifest.cspeach.dev/v1.json
-// Generated: 2026-10-09T13:56:07.835Z
+// Generated: 2026-10-10T00:40:56.198Z
 // Manifest signature verified at build time.
 export const BUNDLED_SKILLS = {
     "abap-app": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cspeach/cli",
-  "version": "1.1.32",
+  "version": "1.1.33",
   "description": "CSPeach — AI-assisted ABAP development CLI. Direct SAP access, 34 skills, safety gates.",
   "keywords": [
     "abap",