@axplusb/kepler 1.0.5 → 1.0.10

package/src/terminal/repl.mjs

@@ -17,17 +17,17 @@
 
 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';
+import { persistProjectArtifacts } from '../core/project-artifacts.mjs';
 import { TarangAuth } from '../auth/tarang-auth.mjs';
 import { ApprovalManager } from '../core/approval.mjs';
 import { resolveBackendUrl } from '../core/backend-url.mjs';
 import { BUILTIN_AGENTS, runAgent } from './agents.mjs';
-import { ContextRetriever } from '../context/retriever.mjs';
-import { buildProjectSkeleton } from '../context/skeleton.mjs';
 import { SessionManager } from '../core/session-manager.mjs';
 import { parseArgs } from '../config/cli-args.mjs';
 import { formatShellCommand, toolDisplayLabel, toolDisplaySummary } from './tool-display.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`);
   }
@@ -621,6 +620,16 @@ function renderEvent(event) {
       break;
     }
 
+    case 'plan_created': {
+      process.stderr.write(`  ${c.dim('project plan prepared')}\n`);
+      break;
+    }
+
+    case 'goal_created': {
+      process.stderr.write(`  ${c.dim('project goal prepared')}\n`);
+      break;
+    }
+
     case 'session_info': {
       if (data?.session_id) {
         session.id = data.session_id;
@@ -773,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
@@ -841,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)}` +
@@ -882,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;
     }
 
@@ -1122,9 +1131,8 @@ export async function startTerminalRepl() {
   const cliArgs = parseArgs(process.argv.slice(2));
   const auth = new TarangAuth();
 
-  // BM25 retriever — indexes project files for search_code tool
-  const retriever = new ContextRetriever(safeCwd());
-  const toolExecutor = createToolExecutor({ retriever });
+  // Projects are registered and indexed on demand through get_project_overview.
+  const toolExecutor = createToolExecutor();
   const skipPerms = cliArgs.freeswim;
   const approval = new ApprovalManager({ autoApprove: skipPerms });
 
@@ -1142,51 +1150,13 @@ export async function startTerminalRepl() {
 
   printBanner(auth);
 
-  // ── Initialization with progress ──
-  // BM25 indexing is CPU-bound and blocks the event loop, so setInterval
-  // spinners won't tick during it. Instead, show a static "Initializing..."
-  // message, then yield to the event loop between phases so the spinner runs.
-  let projectSkeleton = '';
-
-  // Phase 1: Show immediate feedback
+  // ── Initialization ──
   process.stderr.write(`  ${c.brand('⠋')} ${c.dim('Initializing...')}\r`);
-
-  // Fetch user in parallel (network I/O, won't block event loop)
-  const userPromise = fetchUser(ctx);
-
-  // Phase 2: BM25 index — CPU-bound, blocks event loop.
-  // Wrap in a microtask break so the initial message renders first.
-  const indexResult = await new Promise((resolve) => {
-    // Let the event loop flush stderr before blocking
-    setImmediate(async () => {
-      try {
-        process.stderr.write(`\r  ${c.brand('⠹')} ${c.dim('Indexing project files...')}${' '.repeat(20)}\r`);
-        const result = await retriever.buildIndex();
-        resolve(result);
-      } catch {
-        resolve({ fileCount: 0, chunkCount: 0 });
-      }
-    });
-  });
-
-  // Phase 3: Build skeleton (fast, synchronous)
-  process.stderr.write(`\r  ${c.brand('⠼')} ${c.dim('Building project skeleton...')}${' '.repeat(20)}\r`);
-  await new Promise(r => setImmediate(r)); // yield so message renders
-  projectSkeleton = buildProjectSkeleton(safeCwd());
-
-  // Wait for user fetch
-  await userPromise;
+  await fetchUser(ctx);
 
   // Clear the spinner line
   process.stderr.write(`\r${' '.repeat(60)}\r`);
-
-  // Show init summary
-  if (indexResult.fileCount > 0) {
-    process.stderr.write(`  ${c.green('✓')} ${c.dim(`Indexed ${indexResult.fileCount} files (${indexResult.chunkCount} chunks)`)}\n`);
-  }
-  if (projectSkeleton) {
-    process.stderr.write(`  ${c.green('✓')} ${c.dim('Project skeleton ready')}\n`);
-  }
+  process.stderr.write(`  ${c.green('✓')} ${c.dim('Ready; projects will be indexed on demand')}\n`);
   if (session.user) {
     process.stderr.write(`  ${c.green('✓')} ${c.dim(`Logged in as ${session.user.github_username || session.user.email || 'user'}`)}\n`);
   }
@@ -1367,9 +1337,17 @@ export async function startTerminalRepl() {
 
       const execContext = { cwd: safeCwd() };
       if (skipPerms) execContext.freeswim = true;
-      if (projectSkeleton) execContext.project_skeleton = projectSkeleton;
+      execContext.project_resources = toolExecutor.getProjectResources();
+      execContext.agent_context = toolExecutor.getAgentContext();
 
       for await (const event of client.execute(input, execContext, session.history)) {
+        if (event.type === 'plan_created' || event.type === 'goal_created') {
+          persistProjectArtifacts(
+            event.data,
+            toolExecutor.getProjectResources(),
+            message => process.stderr.write(`  ${c.dim(message)}\n`),
+          );
+        }
         renderEvent(event);
 
         if (event.type === 'content_partial') {

package/src/terminal/skills.mjs

@@ -0,0 +1,54 @@
+import { SkillInstaller } from '../skills/installer.mjs';
+import { SkillsLoader } from '../skills/loader.mjs';
+
+function has(args, flag) {
+    return args.includes(flag);
+}
+
+function scopeFrom(args) {
+    return has(args, '--project') ? 'project' : 'global';
+}
+
+function print(value) {
+    process.stdout.write(typeof value === 'string' ? `${value}\n` : `${JSON.stringify(value, null, 2)}\n`);
+}
+
+export async function runSkillsCommand(args, { cwd = process.cwd() } = {}) {
+    const action = args[0] || 'list';
+    const rest = args.slice(1);
+    const scope = scopeFrom(rest);
+    const installer = new SkillInstaller({ cwd });
+    const loader = new SkillsLoader().load(cwd);
+
+    if (action === 'list') {
+        const rows = loader.list({ scope: has(rest, '--all') ? '' : scope });
+        if (has(rest, '--json')) print(rows);
+        else if (!rows.length) print('No skills found.');
+        else for (const row of rows) print(`${row.name}\t${row.scope}\t${row.source}\t${row.description}`);
+        return;
+    }
+    if (action === 'view') {
+        const name = rest.find(arg => !arg.startsWith('--'));
+        if (!name) throw new Error('Usage: kepler skills view <name> [resource-path]');
+        const nameIndex = rest.indexOf(name);
+        const resource = rest.slice(nameIndex + 1).find(arg => !arg.startsWith('--')) || null;
+        print(loader.view(name, resource));
+        return;
+    }
+    if (action === 'install') {
+        const source = rest.find(arg => !arg.startsWith('--'));
+        print(installer.install(source, { scope, force: has(rest, '--force') }));
+        return;
+    }
+    if (action === 'remove') {
+        const name = rest.find(arg => !arg.startsWith('--'));
+        print(installer.remove(name, { scope }));
+        return;
+    }
+    if (action === 'update') {
+        const name = rest.find(arg => !arg.startsWith('--'));
+        print(installer.update(name, { scope }));
+        return;
+    }
+    throw new Error(`Unknown skills command: ${action}`);
+}

package/src/tools/bash.mjs

@@ -27,6 +27,7 @@ export const BashTool = {
             command: { type: 'string', description: 'The command to execute' },
             timeout: { type: 'number', description: 'Timeout in ms (max 600000)', default: 120000 },
             description: { type: 'string', description: 'Description of what this command does' },
+            cwd: { type: 'string', description: 'Working directory for the command' },
             run_in_background: { type: 'boolean', description: 'Run in background', default: false },
         },
         required: ['command'],
@@ -40,7 +41,7 @@ export const BashTool = {
         const timeout = Math.min(input.timeout || 120000, 600000);
 
         if (input.run_in_background) {
-            return runBackground(input.command);
+            return runBackground(input.command, input.cwd);
         }
 
         return new Promise((resolve) => {
@@ -50,6 +51,7 @@ export const BashTool = {
             let exitCode = null;
 
             const proc = spawn('bash', ['-c', input.command], {
+                cwd: input.cwd,
                 env: { ...process.env },
                 stdio: ['pipe', 'pipe', 'pipe'],
                 timeout: 0, // we handle timeout ourselves
@@ -120,9 +122,10 @@ export const BashTool = {
 const backgroundJobs = new Map();
 let bgJobId = 0;
 
-function runBackground(command) {
+function runBackground(command, cwd) {
     const id = ++bgJobId;
     const proc = spawn('bash', ['-c', command], {
+        cwd,
         detached: true,
         stdio: ['ignore', 'pipe', 'pipe'],
     });