arc402-cli 0.9.19 → 0.10.0

package/src/daemon/job-lifecycle.ts

@@ -1,215 +0,0 @@
-/**
- * ARC-402 Job Lifecycle — Post-delivery processing.
- *
- * Handles everything that happens after a worker completes a job:
- *   1. Execution receipt generation
- *   2. Learning extraction from completed work
- *   3. Worker memory update
- *   4. Per-agreement job directory management
- *
- * These functions are called by the daemon after a successful delivery.
- */
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
-import * as crypto from "crypto";
-import { readUsageReport, type AggregatedTokenUsage } from "./token-metering.js";
-
-const ARC402_DIR = path.join(os.homedir(), ".arc402");
-const RECEIPTS_DIR = path.join(ARC402_DIR, "receipts");
-const WORKER_DIR = path.join(ARC402_DIR, "worker");
-const WORKER_MEMORY_DIR = path.join(WORKER_DIR, "memory");
-const WORKER_CONFIG = path.join(WORKER_DIR, "config.json");
-const JOBS_DIR = path.join(ARC402_DIR, "jobs");
-
-// ─── Execution Receipt ────────────────────────────────────────────────────────
-
-export interface ExecutionReceipt {
-  schema: "arc402.execution-receipt.v1";
-  agreement_id: string;
-  workroom_policy_hash: string;
-  started_at: string;
-  completed_at: string;
-  deliverable_hash: string;
-  worker_address: string;
-  metrics: {
-    wall_clock_seconds: number;
-    network_hosts_contacted: string[];
-    policy_violations_attempted: number;
-  };
-  token_usage: AggregatedTokenUsage | null;
-  receipt_hash: string;
-}
-
-/**
- * Generate and persist an execution receipt after job delivery.
- */
-export function generateReceipt(params: {
-  agreementId: string;
-  deliverableHash: string;
-  walletAddress: string;
-  startedAt: string;
-  completedAt: string;
-  policyFilePath?: string;
-  networkHosts?: string[];
-}): ExecutionReceipt {
-  fs.mkdirSync(RECEIPTS_DIR, { recursive: true });
-
-  // Compute policy hash
-  let policyHash = "0x0";
-  const policyPath = params.policyFilePath ?? path.join(ARC402_DIR, "openshell-policy.yaml");
-  if (fs.existsSync(policyPath)) {
-    const content = fs.readFileSync(policyPath, "utf-8");
-    policyHash = "0x" + crypto.createHash("sha256").update(content).digest("hex");
-  }
-
-  // Calculate wall clock time
-  const started = new Date(params.startedAt).getTime();
-  const completed = new Date(params.completedAt).getTime();
-  const wallClockSeconds = Math.max(0, Math.floor((completed - started) / 1000));
-
-  // Read token usage report (if the worker wrote one)
-  const tokenUsage = readUsageReport(params.agreementId);
-
-  const receipt: ExecutionReceipt = {
-    schema: "arc402.execution-receipt.v1",
-    agreement_id: params.agreementId,
-    workroom_policy_hash: policyHash,
-    started_at: params.startedAt,
-    completed_at: params.completedAt,
-    deliverable_hash: params.deliverableHash,
-    worker_address: params.walletAddress,
-    metrics: {
-      wall_clock_seconds: wallClockSeconds,
-      network_hosts_contacted: params.networkHosts ?? [],
-      policy_violations_attempted: 0,
-    },
-    token_usage: tokenUsage,
-    receipt_hash: "", // filled below
-  };
-
-  // Receipt hash = SHA-256 of the receipt content (without the hash field)
-  const hashInput = JSON.stringify({ ...receipt, receipt_hash: undefined });
-  receipt.receipt_hash = "0x" + crypto.createHash("sha256").update(hashInput).digest("hex");
-
-  // Persist
-  const receiptPath = path.join(RECEIPTS_DIR, `${params.agreementId}.json`);
-  fs.writeFileSync(receiptPath, JSON.stringify(receipt, null, 2));
-
-  return receipt;
-}
-
-// ─── Learning Extraction ──────────────────────────────────────────────────────
-
-/**
- * Extract learnings from a completed job and update worker memory.
- *
- * This creates:
- *   1. A per-job memory file: memory/job-<id>.md
- *   2. Updates the cumulative learnings.md
- *   3. Updates the worker config (job count, earnings)
- */
-export function extractLearnings(params: {
-  agreementId: string;
-  taskDescription: string;
-  deliverableHash: string;
-  priceEth: string;
-  capability: string;
-  wallClockSeconds: number;
-  success: boolean;
-}): void {
-  fs.mkdirSync(WORKER_MEMORY_DIR, { recursive: true });
-
-  const now = new Date().toISOString();
-  const dateStr = now.split("T")[0];
-
-  // 1. Per-job memory file
-  const jobMemory = `# Job: ${params.agreementId}
-*Completed: ${now}*
-*Capability: ${params.capability}*
-*Price: ${params.priceEth} ETH*
-*Duration: ${params.wallClockSeconds}s*
-*Outcome: ${params.success ? "delivered" : "failed"}*
-
-## Task
-${params.taskDescription}
-
-## Deliverable
-Hash: ${params.deliverableHash}
-
-## Learnings
-- Completed ${params.capability} task in ${params.wallClockSeconds}s
-- ${params.success ? "Delivered successfully" : "Delivery failed — review required"}
-`;
-
-  const jobFile = path.join(WORKER_MEMORY_DIR, `job-${params.agreementId}.md`);
-  fs.writeFileSync(jobFile, jobMemory);
-
-  // 2. Update cumulative learnings.md
-  const learningsPath = path.join(WORKER_MEMORY_DIR, "learnings.md");
-  let learnings = "";
-  if (fs.existsSync(learningsPath)) {
-    learnings = fs.readFileSync(learningsPath, "utf-8");
-  }
-
-  const newEntry = `\n### ${dateStr} — ${params.capability} (${params.agreementId.slice(0, 8)}...)
-- Duration: ${params.wallClockSeconds}s | Price: ${params.priceEth} ETH | Outcome: ${params.success ? "✓" : "✗"}
-`;
-
-  // Append to learnings
-  if (learnings.includes("No learnings yet")) {
-    learnings = `# Accumulated Learnings\n\n*Auto-updated after each completed job.*\n${newEntry}`;
-  } else {
-    learnings += newEntry;
-  }
-  fs.writeFileSync(learningsPath, learnings);
-
-  // 3. Update worker config
-  if (fs.existsSync(WORKER_CONFIG)) {
-    try {
-      const config = JSON.parse(fs.readFileSync(WORKER_CONFIG, "utf-8"));
-      config.job_count = (config.job_count || 0) + 1;
-      const currentEarnings = parseFloat(config.total_earned_eth || "0");
-      const jobEarnings = parseFloat(params.priceEth || "0");
-      config.total_earned_eth = (currentEarnings + jobEarnings).toFixed(6);
-      config.last_job_at = now;
-      fs.writeFileSync(WORKER_CONFIG, JSON.stringify(config, null, 2));
-    } catch { /* non-fatal — config may be malformed */ }
-  }
-}
-
-// ─── Per-Agreement Job Directory ──────────────────────────────────────────────
-
-/**
- * Create an isolated job directory for a specific agreement.
- * Returns the path to the job workspace.
- */
-export function createJobDirectory(agreementId: string): string {
-  const jobDir = path.join(JOBS_DIR, `agreement-${agreementId}`);
-  fs.mkdirSync(jobDir, { recursive: true });
-  return jobDir;
-}
-
-/**
- * Clean up a job directory after settlement.
- * Preserves the receipt and job memory — only removes working files.
- */
-export function cleanJobDirectory(agreementId: string): void {
-  const jobDir = path.join(JOBS_DIR, `agreement-${agreementId}`);
-  if (fs.existsSync(jobDir)) {
-    fs.rmSync(jobDir, { recursive: true, force: true });
-  }
-}
-
-// ─── Policy Hash ──────────────────────────────────────────────────────────────
-
-/**
- * Compute the SHA-256 hash of the current workroom policy.
- * This hash can be registered in AgentRegistry for verifiability.
- */
-export function computePolicyHash(policyFilePath?: string): string {
-  const policyPath = policyFilePath ?? path.join(ARC402_DIR, "openshell-policy.yaml");
-  if (!fs.existsSync(policyPath)) return "0x0";
-  const content = fs.readFileSync(policyPath, "utf-8");
-  return "0x" + crypto.createHash("sha256").update(content).digest("hex");
-}

package/src/daemon/notify.ts

@@ -1,297 +0,0 @@
-/**
- * Multi-channel notification module for daemon events.
- * Supports Telegram, Discord webhooks, generic webhooks, and email (via nodemailer).
- */
-import * as https from "https";
-import * as http from "http";
-import type { DaemonConfig } from "./config.js";
-
-export type NotifyEvent =
-  | "hire_request"
-  | "hire_accepted"
-  | "hire_rejected"
-  | "delivery"
-  | "dispute"
-  | "channel_challenge"
-  | "low_balance"
-  | "daemon_started"
-  | "daemon_stopped";
-
-// ─── Channel interface ────────────────────────────────────────────────────────
-
-export interface NotificationChannel {
-  send(title: string, body: string): Promise<void>;
-}
-
-// ─── HTTP helper ──────────────────────────────────────────────────────────────
-
-function httpPost(url: string, payload: string, extraHeaders: Record<string, string>): Promise<void> {
-  return new Promise((resolve, reject) => {
-    const parsed = new URL(url);
-    const mod = parsed.protocol === "https:" ? https : http;
-    const options = {
-      hostname: parsed.hostname,
-      port: parsed.port || (parsed.protocol === "https:" ? 443 : 80),
-      path: parsed.pathname + parsed.search,
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Content-Length": Buffer.byteLength(payload),
-        ...extraHeaders,
-      },
-    };
-    const req = mod.request(options, (res) => {
-      res.resume();
-      res.on("end", () => {
-        if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
-          resolve();
-        } else {
-          reject(new Error(`HTTP ${res.statusCode}`));
-        }
-      });
-    });
-    req.on("error", reject);
-    req.write(payload);
-    req.end();
-  });
-}
-
-// ─── Telegram channel ─────────────────────────────────────────────────────────
-
-export class TelegramChannel implements NotificationChannel {
-  constructor(private botToken: string, private chatId: string) {}
-
-  async send(title: string, body: string): Promise<void> {
-    const text = body ? `<b>${title}</b>\n${body}` : `<b>${title}</b>`;
-    const payload = JSON.stringify({ chat_id: this.chatId, text, parse_mode: "HTML" });
-    const options: https.RequestOptions = {
-      hostname: "api.telegram.org",
-      port: 443,
-      path: `/bot${this.botToken}/sendMessage`,
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Content-Length": Buffer.byteLength(payload),
-      },
-    };
-    await new Promise<void>((resolve, reject) => {
-      const req = https.request(options, (res) => {
-        let data = "";
-        res.on("data", (c: Buffer) => { data += c.toString(); });
-        res.on("end", () => {
-          const parsed = JSON.parse(data) as { ok: boolean; description?: string };
-          if (!parsed.ok) {
-            reject(new Error(`Telegram API error: ${parsed.description}`));
-          } else {
-            resolve();
-          }
-        });
-      });
-      req.on("error", reject);
-      req.write(payload);
-      req.end();
-    });
-  }
-}
-
-// ─── Discord channel ──────────────────────────────────────────────────────────
-
-export class DiscordChannel implements NotificationChannel {
-  constructor(private webhookUrl: string) {}
-
-  async send(title: string, body: string): Promise<void> {
-    const content = body ? `**${title}**\n${body}` : `**${title}**`;
-    await httpPost(this.webhookUrl, JSON.stringify({ content }), {});
-  }
-}
-
-// ─── Generic webhook channel ──────────────────────────────────────────────────
-
-export class WebhookChannel implements NotificationChannel {
-  constructor(private url: string, private headers: Record<string, string> = {}) {}
-
-  async send(title: string, body: string): Promise<void> {
-    await httpPost(
-      this.url,
-      JSON.stringify({ title, body, timestamp: new Date().toISOString() }),
-      this.headers
-    );
-  }
-}
-
-// ─── Email channel (optional — requires nodemailer) ───────────────────────────
-
-export class EmailChannel implements NotificationChannel {
-  constructor(private cfg: {
-    smtpHost: string;
-    smtpPort: number;
-    smtpUser: string;
-    smtpPass: string;
-    to: string;
-  }) {}
-
-  async send(title: string, body: string): Promise<void> {
-    // nodemailer is an optional runtime dependency — load via require to skip
-    // compile-time module resolution. Throws a clear message if not installed.
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    let nodemailer: any;
-    try {
-      // @ts-expect-error nodemailer is an optional dependency
-      nodemailer = await import("nodemailer");
-    } catch {
-      throw new Error("nodemailer is not installed. Run: npm install nodemailer");
-    }
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
-    const transport = nodemailer.createTransport({
-      host: this.cfg.smtpHost,
-      port: this.cfg.smtpPort,
-      auth: { user: this.cfg.smtpUser, pass: this.cfg.smtpPass },
-    });
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
-    await transport.sendMail({
-      from: this.cfg.smtpUser,
-      to: this.cfg.to,
-      subject: title,
-      text: body,
-    });
-  }
-}
-
-// ─── Notifier ─────────────────────────────────────────────────────────────────
-
-export class Notifier {
-  private channels: NotificationChannel[];
-  private notifyFlags: Record<NotifyEvent, boolean>;
-
-  constructor(
-    channels: NotificationChannel[],
-    flags: Partial<Record<NotifyEvent, boolean>> = {}
-  ) {
-    this.channels = channels;
-    this.notifyFlags = {
-      hire_request: flags.hire_request ?? true,
-      hire_accepted: flags.hire_accepted ?? true,
-      hire_rejected: flags.hire_rejected ?? true,
-      delivery: flags.delivery ?? true,
-      dispute: flags.dispute ?? true,
-      channel_challenge: flags.channel_challenge ?? true,
-      low_balance: flags.low_balance ?? true,
-      daemon_started: true,
-      daemon_stopped: true,
-    };
-  }
-
-  isEnabled(): boolean {
-    return this.channels.length > 0;
-  }
-
-  async send(event: NotifyEvent, title: string, body: string): Promise<void> {
-    if (!this.notifyFlags[event]) return;
-    await Promise.all(
-      this.channels.map(async (ch) => {
-        try {
-          await ch.send(title, body);
-        } catch (err) {
-          process.stderr.write(`[notify] Channel send failed: ${err}\n`);
-        }
-      })
-    );
-  }
-
-  async notifyHireRequest(hireId: string, hirerAddress: string, priceEth: string, capability: string): Promise<void> {
-    const short = hirerAddress.slice(0, 10);
-    await this.send("hire_request", "Hire Request", [
-      `ID: ${hireId}`,
-      `From: ${short}...`,
-      `Capability: ${capability || "unspecified"}`,
-      `Price: ${priceEth} ETH`,
-      ``,
-      `Approve: arc402 daemon approve ${hireId}`,
-      `Reject:  arc402 daemon reject ${hireId}`,
-    ].join("\n"));
-  }
-
-  async notifyHireAccepted(hireId: string, agreementId: string): Promise<void> {
-    await this.send("hire_accepted", "Hire Accepted",
-      `ID: ${hireId}\nAgreement: ${agreementId}`
-    );
-  }
-
-  async notifyHireRejected(hireId: string, reason: string): Promise<void> {
-    await this.send("hire_rejected", "Hire Rejected",
-      `ID: ${hireId}\nReason: ${reason}`
-    );
-  }
-
-  async notifyDelivery(agreementId: string, deliveryHash: string, userOpHash: string): Promise<void> {
-    await this.send("delivery", "Delivery Submitted", [
-      `Agreement: ${agreementId}`,
-      `Delivery hash: ${deliveryHash.slice(0, 16)}...`,
-      `UserOp: ${userOpHash.slice(0, 16)}...`,
-    ].join("\n"));
-  }
-
-  async notifyDispute(agreementId: string, raisedBy: string): Promise<void> {
-    await this.send("dispute", "Dispute Raised",
-      `Agreement: ${agreementId}\nBy: ${raisedBy}`
-    );
-  }
-
-  async notifyChannelChallenge(channelId: string, txHash: string): Promise<void> {
-    await this.send("channel_challenge", "Channel Challenged",
-      `Channel: ${channelId.slice(0, 16)}...\nTx: ${txHash.slice(0, 16)}...`
-    );
-  }
-
-  async notifyLowBalance(balanceEth: string, thresholdEth: string): Promise<void> {
-    await this.send("low_balance", "Low Balance Alert",
-      `Current: ${balanceEth} ETH\nThreshold: ${thresholdEth} ETH`
-    );
-  }
-
-  async notifyStarted(walletAddress: string, subsystems: string[]): Promise<void> {
-    await this.send("daemon_started", "ARC-402 Daemon Started",
-      `Wallet: ${walletAddress}\nSubsystems: ${subsystems.join(", ")}`
-    );
-  }
-
-  async notifyStopped(): Promise<void> {
-    await this.send("daemon_stopped", "ARC-402 Daemon Stopped", "");
-  }
-}
-
-// ─── Factory ──────────────────────────────────────────────────────────────────
-
-export function buildNotifier(config: DaemonConfig): Notifier {
-  const notif = config.notifications;
-  const channels: NotificationChannel[] = [];
-
-  if (notif.telegram_bot_token && notif.telegram_chat_id) {
-    channels.push(new TelegramChannel(notif.telegram_bot_token, notif.telegram_chat_id));
-  }
-  if (notif.discord?.webhook_url) {
-    channels.push(new DiscordChannel(notif.discord.webhook_url));
-  }
-  if (notif.webhook?.url) {
-    channels.push(new WebhookChannel(notif.webhook.url, notif.webhook.headers ?? {}));
-  }
-  if (notif.email?.smtp_host && notif.email?.smtp_user && notif.email?.to) {
-    channels.push(new EmailChannel({
-      smtpHost: notif.email.smtp_host,
-      smtpPort: notif.email.smtp_port,
-      smtpUser: notif.email.smtp_user,
-      smtpPass: notif.email.smtp_pass,
-      to: notif.email.to,
-    }));
-  }
-
-  return new Notifier(channels, {
-    hire_request: notif.notify_on_hire_request,
-    hire_accepted: notif.notify_on_hire_accepted,
-    hire_rejected: notif.notify_on_hire_rejected,
-    delivery: notif.notify_on_delivery,
-    dispute: notif.notify_on_dispute,
-    channel_challenge: notif.notify_on_channel_challenge,
-    low_balance: notif.notify_on_low_balance,
-  });
-}

package/src/daemon/token-metering.ts

@@ -1,183 +0,0 @@
-/**
- * ARC-402 Token Usage Metering
- *
- * Tracks LLM token consumption per agreement. The worker writes a usage report
- * file during execution; the daemon reads it after delivery and includes the
- * data in the execution receipt.
- *
- * Architecture:
- *   - Before execution: daemon creates a usage report path for the agreement
- *   - During execution: worker appends usage entries as it calls LLM APIs
- *   - After execution: daemon reads the report, aggregates totals, includes in receipt
- *
- * The worker writes entries in JSON Lines format to:
- *   /workroom/jobs/agreement-<id>/token-usage.jsonl
- *
- * Each line:
- *   {"model":"claude-sonnet-4-6","provider":"anthropic","input":1200,"output":450,"ts":"..."}
- *
- * This is non-invasive — no proxy, no network interception. The worker
- * is responsible for reporting its own usage. OpenClaw agents can do this
- * natively via session metadata.
- */
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
-
-const ARC402_DIR = path.join(os.homedir(), ".arc402");
-const JOBS_DIR = path.join(ARC402_DIR, "jobs");
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-export interface TokenUsageEntry {
-  model: string;
-  provider: string;
-  input: number;
-  output: number;
-  ts: string;
-  cost_usd?: number;
-}
-
-export interface AggregatedTokenUsage {
-  total_input: number;
-  total_output: number;
-  total_tokens: number;
-  estimated_cost_usd: number;
-  models_used: string[];
-  entries: number;
-  by_model: Record<string, {
-    input: number;
-    output: number;
-    calls: number;
-    cost_usd: number;
-  }>;
-}
-
-// ─── Known model pricing (USD per 1M tokens, as of 2026-03) ──────────────────
-
-const MODEL_PRICING: Record<string, { input: number; output: number }> = {
-  // Anthropic
-  "claude-opus-4-6":     { input: 15.0,  output: 75.0  },
-  "claude-sonnet-4-6":   { input: 3.0,   output: 15.0  },
-  "claude-haiku-4-5":    { input: 0.8,   output: 4.0   },
-  // OpenAI
-  "gpt-5.4":             { input: 2.5,   output: 10.0  },
-  "gpt-5.3-codex":       { input: 2.5,   output: 10.0  },
-  "gpt-4o":              { input: 2.5,   output: 10.0  },
-  "gpt-4o-mini":         { input: 0.15,  output: 0.6   },
-  // Google
-  "gemini-2.5-pro":      { input: 1.25,  output: 10.0  },
-  "gemini-2.5-flash":    { input: 0.15,  output: 0.6   },
-  // Defaults
-  "default":             { input: 2.0,   output: 8.0   },
-};
-
-function estimateCost(model: string, inputTokens: number, outputTokens: number): number {
-  const pricing = MODEL_PRICING[model] ?? MODEL_PRICING["default"];
-  return (inputTokens * pricing.input + outputTokens * pricing.output) / 1_000_000;
-}
-
-// ─── Usage report path ────────────────────────────────────────────────────────
-
-/**
- * Get the path where the worker should write token usage for an agreement.
- * The daemon sets this as an env var before calling exec_command.
- */
-export function getUsageReportPath(agreementId: string): string {
-  return path.join(JOBS_DIR, `agreement-${agreementId}`, "token-usage.jsonl");
-}
-
-/**
- * Create the parent directory and return the path.
- * Called by the daemon before spawning the worker.
- */
-export function prepareUsageReport(agreementId: string): string {
-  const reportPath = getUsageReportPath(agreementId);
-  fs.mkdirSync(path.dirname(reportPath), { recursive: true });
-  return reportPath;
-}
-
-// ─── Read and aggregate ───────────────────────────────────────────────────────
-
-/**
- * Read the token usage report for an agreement and aggregate totals.
- * Returns null if no report exists.
- */
-export function readUsageReport(agreementId: string): AggregatedTokenUsage | null {
-  const reportPath = getUsageReportPath(agreementId);
-
-  if (!fs.existsSync(reportPath)) return null;
-
-  const content = fs.readFileSync(reportPath, "utf-8").trim();
-  if (!content) return null;
-
-  const lines = content.split("\n").filter(Boolean);
-  const entries: TokenUsageEntry[] = [];
-
-  for (const line of lines) {
-    try {
-      entries.push(JSON.parse(line) as TokenUsageEntry);
-    } catch {
-      // Skip malformed lines
-    }
-  }
-
-  if (entries.length === 0) return null;
-
-  // Aggregate
-  const byModel: Record<string, { input: number; output: number; calls: number; cost_usd: number }> = {};
-  let totalInput = 0;
-  let totalOutput = 0;
-  let totalCost = 0;
-
-  for (const entry of entries) {
-    totalInput += entry.input;
-    totalOutput += entry.output;
-
-    const model = entry.model || "unknown";
-    if (!byModel[model]) {
-      byModel[model] = { input: 0, output: 0, calls: 0, cost_usd: 0 };
-    }
-    byModel[model].input += entry.input;
-    byModel[model].output += entry.output;
-    byModel[model].calls += 1;
-
-    const cost = entry.cost_usd ?? estimateCost(model, entry.input, entry.output);
-    byModel[model].cost_usd += cost;
-    totalCost += cost;
-  }
-
-  return {
-    total_input: totalInput,
-    total_output: totalOutput,
-    total_tokens: totalInput + totalOutput,
-    estimated_cost_usd: Math.round(totalCost * 10000) / 10000, // 4 decimal places
-    models_used: Object.keys(byModel),
-    entries: entries.length,
-    by_model: byModel,
-  };
-}
-
-// ─── CLI display helper ───────────────────────────────────────────────────────
-
-/**
- * Format token usage for CLI display.
- */
-export function formatUsageReport(usage: AggregatedTokenUsage): string {
-  const lines: string[] = [];
-  lines.push(`Token Usage`);
-  lines.push(`───────────`);
-  lines.push(`Total tokens:  ${usage.total_tokens.toLocaleString()} (${usage.total_input.toLocaleString()} in / ${usage.total_output.toLocaleString()} out)`);
-  lines.push(`Est. cost:     $${usage.estimated_cost_usd.toFixed(4)}`);
-  lines.push(`LLM calls:     ${usage.entries}`);
-  lines.push(``);
-
-  if (Object.keys(usage.by_model).length > 1) {
-    lines.push(`By model:`);
-    for (const [model, data] of Object.entries(usage.by_model)) {
-      lines.push(`  ${model.padEnd(24)} ${data.calls} calls  ${(data.input + data.output).toLocaleString()} tokens  $${data.cost_usd.toFixed(4)}`);
-    }
-  }
-
-  return lines.join("\n");
-}