@axplusb/kepler 1.0.9 → 1.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axplusb/kepler",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Kepler — AI coding agent with operating brief, preflight planning, and sub-agents. SWE-bench Lite evaluated.",
   "type": "module",
   "bin": {

package/src/core/pricing.mjs

@@ -271,7 +271,7 @@ export function calculateCost(usage) {
 // ── Formatting ───────────────────────────────────────────────
 
 /**
- * Format a cost value as a dollar string.
+ * Format a cost value as a dollar string (diagnostic/telemetry only).
  * @param {number} cost
  * @returns {string}
  */
@@ -281,6 +281,28 @@ export function formatCostValue(cost) {
     return `$${cost.toFixed(2)}`;
 }
 
+/**
+ * Convert provider cost to Kepler credits.
+ * 100 credits = $1 of retail model usage, 2x multiplier.
+ * @param {number} costUsd
+ * @returns {number}
+ */
+export function costToCredits(costUsd) {
+    if (costUsd <= 0) return 0;
+    return Math.max(1, Math.ceil(costUsd * 2.0 * 100));
+}
+
+/**
+ * Format credits for display (e.g. "5 cr", "1.2k cr").
+ * @param {number} credits
+ * @returns {string}
+ */
+export function formatCredits(credits) {
+    if (credits === 0) return '0 cr';
+    if (credits >= 1000) return `${(credits / 1000).toFixed(1)}k cr`;
+    return `${credits} cr`;
+}
+
 /**
  * Format a token count for display (e.g. 42100 → '42.1k').
  * @param {number} tokens

package/src/core/tool-executor.mjs

@@ -113,6 +113,25 @@ export function createToolExecutor({
         }
     }
 
+    // ── Post-edit verification hint ──────────────────────────────
+    // Appended to edit_file/write_file results so the model knows
+    // exactly how to verify. Uses detected project commands.
+
+    function verificationHint(filePath) {
+        const project = projectRegistry.projectForPath(filePath);
+        const commands = project?.resource?.commands || {};
+        const parts = [];
+        if (commands.test) {
+            parts.push(`Run tests: ${commands.test}`);
+        }
+        if (parts.length === 0) {
+            const ext = path.extname(filePath);
+            if (ext === '.py') parts.push('Run tests: python -m pytest');
+            else if (['.js', '.ts', '.tsx', '.mjs'].includes(ext)) parts.push('Run tests: npm test');
+        }
+        return parts.length ? `\n--- Verify ---\n${parts.join('\n')}` : '';
+    }
+
     // ── Tool mapping table ──────────────────────────────────────
 
     const toolMap = {
@@ -275,10 +294,14 @@ export function createToolExecutor({
             // Auto-lint the written file
             const lintOutput = autoLint(filePath);
             if (lintOutput) {
-                wrapped.output += `\n\n--- Lint result ---\n${lintOutput}`;
+                wrapped.output += `\n\n--- Lint ---\n${lintOutput}`;
                 wrapped.lint = lintOutput;
             }
 
+            // Nudge: tell the model how to verify
+            const hint = verificationHint(filePath);
+            if (hint) wrapped.output += hint;
+
             return wrapped;
         },
 
@@ -399,10 +422,14 @@ print('OK: replaced')
             // Auto-lint the edited file
             const lintOutput = autoLint(filePath);
             if (lintOutput) {
-                wrapped.output += `\n\n--- Lint result ---\n${lintOutput}`;
+                wrapped.output += `\n\n--- Lint ---\n${lintOutput}`;
                 wrapped.lint = lintOutput;
             }
 
+            // Nudge: tell the model how to verify
+            const hint = verificationHint(filePath);
+            if (hint) wrapped.output += hint;
+
             return wrapped;
         },
 

package/src/terminal/ansi.mjs

@@ -399,7 +399,7 @@ export function formatElapsed(startMs) {
 
 // ── Format Cost ──
 
-import { calculateCost, formatCostValue } from '../core/pricing.mjs';
+import { calculateCost, formatCostValue, costToCredits, formatCredits } from '../core/pricing.mjs';
 
 /**
  * Format cost from token counts.
@@ -407,15 +407,13 @@ import { calculateCost, formatCostValue } from '../core/pricing.mjs';
  * or a single usage object with optional per-model breakdown.
  */
 export function formatCost(inputOrUsage, outputTokens) {
-  // New API: pass a usage object directly
   if (typeof inputOrUsage === 'object' && inputOrUsage !== null) {
     const { total } = calculateCost(inputOrUsage);
-    return formatCostValue(total);
+    return formatCredits(costToCredits(total));
   }
-  // Legacy API: flat input/output token counts, default pricing
   const { total } = calculateCost({
     input_tokens: inputOrUsage || 0,
     output_tokens: outputTokens || 0,
   });
-  return formatCostValue(total);
+  return formatCredits(costToCredits(total));
 }

package/src/terminal/repl.mjs

@@ -19,7 +19,7 @@ import * as readline from 'node:readline';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
 import { c, progressBar, spinner, inPlace, renderMarkdown, renderDiff, formatElapsed, formatCost, stripAnsi } from './ansi.mjs';
-import { calculateCost, formatCostValue, formatTokens } from '../core/pricing.mjs';
+import { calculateCost, formatCostValue, formatTokens, costToCredits, formatCredits } from '../core/pricing.mjs';
 import { TarangStreamClient, EVENT_TYPES } from '../core/stream-client.mjs';
 import { JsonlWriter } from '../core/jsonl-writer.mjs';
 import { createToolExecutor } from '../core/tool-executor.mjs';
@@ -163,13 +163,12 @@ function printBanner(auth) {
  */
 function buildContextStrip() {
   const totalTokens = session.inputTokens + session.outputTokens;
-  const cost = formatCostValue(session.totalCost);
+  const credits = formatCredits(costToCredits(session.totalCost));
   const elapsed = formatElapsed(session.startTime);
 
-  // Right side — always shown
   const right = [
     c.dim(`${formatTokens(totalTokens)} tok`),
-    c.dim(cost),
+    c.dim(credits),
     c.dim(elapsed),
   ].join(c.dim(' · '));
 
@@ -200,7 +199,7 @@ function printTurnSummary(toolCount, durationS, turnCost) {
   const parts = [];
   if (toolCount > 0) parts.push(`${toolCount} tools`);
   if (durationS) parts.push(`${Number(durationS).toFixed(1)}s`);
-  if (turnCost > 0) parts.push(formatCostValue(turnCost));
+  if (turnCost > 0) parts.push(formatCredits(costToCredits(turnCost)));
   if (parts.length > 0) {
     process.stderr.write(`\n  ${c.green('✓')} ${c.dim(parts.join(' · '))}\n`);
   }
@@ -783,7 +782,7 @@ async function handleCommand(input, ctx) {
       process.stderr.write(`  ${c.dim('Turns')}        ${session.turns}\n`);
       process.stderr.write(`  ${c.dim('Tools')}        ${session.totalToolCalls} total, ${session.toolCalls} last turn\n`);
       process.stderr.write(`  ${c.dim('Duration')}     ${formatElapsed(session.startTime)}\n`);
-      process.stderr.write(`  ${c.dim('Cost')}         ${formatCostValue(session.totalCost)}${session.costAccurate ? '' : c.dim(' (est)')}\n`);
+      process.stderr.write(`  ${c.dim('Credits')}      ${formatCredits(costToCredits(session.totalCost))}${session.costAccurate ? '' : c.dim(' (est)')}\n`);
       process.stderr.write(`  ${c.dim('CWD')}          ${safeCwd()}\n`);
 
       // Permissions
@@ -851,29 +850,29 @@ async function handleCommand(input, ctx) {
       process.stderr.write(`  ${c.gray('Turns:')}     ${session.turns}\n`);
       process.stderr.write(`  ${c.gray('Tools:')}     ${session.toolCalls}\n`);
       process.stderr.write(`  ${c.gray('Blocked:')}   ${session.blockedOps}\n`);
-      process.stderr.write(`  ${c.gray('Cost:')}      ${formatCostValue(session.totalCost)}${session.costAccurate ? '' : c.dim(' (est)')}\n`);
+      process.stderr.write(`  ${c.gray('Credits:')}   ${formatCredits(costToCredits(session.totalCost))}${session.costAccurate ? '' : c.dim(' (est)')}\n`);
       process.stderr.write(`  ${c.gray('Elapsed:')}  ${formatElapsed(session.startTime)}\n\n`);
       return;
     }
 
     case '/cost': {
-      process.stderr.write(`\n  ${c.bold('Session Cost')}`);
+      process.stderr.write(`\n  ${c.bold('Session Credits')}  ${c.brand(formatCredits(costToCredits(session.totalCost)))}`);
       if (!session.costAccurate) {
-        process.stderr.write(`  ${c.yellow('(estimated — backend not sending model breakdown)')}`);
+        process.stderr.write(`  ${c.yellow('(estimated)')}`);
       }
       process.stderr.write('\n');
       process.stderr.write(`  ${c.dim('─'.repeat(70))}\n`);
 
       if (session.costBreakdown.length > 0) {
         // Header
-        process.stderr.write(`  ${c.dim('Model'.padEnd(36))}${c.dim('Input'.padStart(10))}${c.dim('Output'.padStart(10))}${c.dim('Cache'.padStart(10))}${c.dim('Cost'.padStart(10))}\n`);
+        process.stderr.write(`  ${c.dim('Model'.padEnd(36))}${c.dim('Input'.padStart(10))}${c.dim('Output'.padStart(10))}${c.dim('Cache'.padStart(10))}${c.dim('Credits'.padStart(10))}\n`);
         process.stderr.write(`  ${c.dim('─'.repeat(70))}\n`);
 
         for (const b of session.costBreakdown) {
           const modelLabel = b.model === 'unknown' ? c.yellow('unknown model') : b.model;
           const roleTag = b.role && b.role !== 'unknown' ? ` ${c.dim(`(${b.role})`)}` : '';
           const cacheTokens = (b.cache_read_tokens || 0) + (b.cache_creation_tokens || 0);
-          const costStr = b.free ? c.green('free') : formatCostValue(b.cost);
+          const costStr = b.free ? c.green('free') : formatCredits(costToCredits(b.cost));
 
           process.stderr.write(
             `  ${(modelLabel + roleTag).padEnd(36)}` +
@@ -892,9 +891,9 @@ async function handleCommand(input, ctx) {
         `${formatTokens(session.inputTokens).padStart(10)}` +
         `${formatTokens(session.outputTokens).padStart(10)}` +
         `${''.padStart(10)}` +
-        `${formatCostValue(session.totalCost).padStart(10)}\n`
+        `${formatCredits(costToCredits(session.totalCost)).padStart(10)}\n`
       );
-      process.stderr.write(`  ${c.dim(`Turns: ${session.turns}  Duration: ${formatElapsed(session.startTime)}`)}\n\n`);
+      process.stderr.write(`  ${c.dim(`Turns: ${session.turns}  Duration: ${formatElapsed(session.startTime)}  Provider: ${formatCostValue(session.totalCost)}`)}\n\n`);
       return;
     }