@kkelly-offical/kkcode 0.1.2

package/src/ui/repl-dashboard.mjs

@@ -0,0 +1,357 @@
+import { homedir } from "node:os"
+import { paint } from "../theme/color.mjs"
+
+function stripAnsi(text) {
+  return String(text || "").replace(/\x1B\[[0-9;]*m/g, "")
+}
+
+function isFullWidthCodePoint(code) {
+  if (Number.isNaN(code)) return false
+  if (
+    code >= 0x1100 && (
+      code <= 0x115f ||
+      code === 0x2329 || code === 0x232a ||
+      (code >= 0x2e80 && code <= 0xa4cf && code !== 0x303f) ||
+      (code >= 0xac00 && code <= 0xd7a3) ||
+      (code >= 0xf900 && code <= 0xfaff) ||
+      (code >= 0xfe10 && code <= 0xfe19) ||
+      (code >= 0xfe30 && code <= 0xfe6f) ||
+      (code >= 0xff00 && code <= 0xff60) ||
+      (code >= 0xffe0 && code <= 0xffe6) ||
+      (code >= 0x1f300 && code <= 0x1f64f) ||
+      (code >= 0x1f900 && code <= 0x1f9ff) ||
+      (code >= 0x20000 && code <= 0x3fffd)
+    )
+  ) return true
+  return false
+}
+
+function visibleWidth(text) {
+  let width = 0
+  for (const ch of stripAnsi(text)) {
+    width += isFullWidthCodePoint(ch.codePointAt(0)) ? 2 : 1
+  }
+  return width
+}
+
+function clipPlainByWidth(text, maxWidth) {
+  if (maxWidth <= 0) return ""
+  let out = ""
+  let used = 0
+  for (const ch of String(text || "")) {
+    const w = isFullWidthCodePoint(ch.codePointAt(0)) ? 2 : 1
+    if (used + w > maxWidth) break
+    out += ch
+    used += w
+  }
+  return out
+}
+
+function padCell(text, width) {
+  const raw = stripAnsi(text)
+  const w = visibleWidth(raw)
+  if (w === width) return text
+  if (w < width) return text + " ".repeat(width - w)
+  if (width <= 1) return clipPlainByWidth(raw, width)
+  return clipPlainByWidth(raw, Math.max(1, width - 1)) + "…"
+}
+
+function wrapPlain(text, width) {
+  if (width <= 4) return [clipPlainByWidth(String(text || ""), Math.max(width, 1))]
+  const words = String(text || "").split(/\s+/).filter(Boolean)
+  if (!words.length) return [""]
+  const out = []
+  let line = ""
+  for (const word of words) {
+    const candidate = line ? `${line} ${word}` : word
+    if (visibleWidth(candidate) <= width) {
+      line = candidate
+      continue
+    }
+    if (line) out.push(line)
+    if (visibleWidth(word) <= width) {
+      line = word
+      continue
+    }
+    let rest = word
+    while (visibleWidth(rest) > width) {
+      const part = clipPlainByWidth(rest, width)
+      out.push(part)
+      rest = rest.slice(part.length)
+    }
+    line = rest || ""
+  }
+  if (line) out.push(line)
+  return out.length ? out : [""]
+}
+
+function terminalWidth() {
+  const cols = Number(process.stdout.columns || 120)
+  if (!Number.isFinite(cols) || cols <= 0) return 120
+  return Math.max(60, Math.min(cols, 220))
+}
+
+function centerLine(text, width) {
+  const rawWidth = visibleWidth(text)
+  if (rawWidth >= width) return text
+  const pad = Math.floor((width - rawWidth) / 2)
+  return `${" ".repeat(Math.max(0, pad))}${text}`
+}
+
+function shortenPath(path) {
+  const home = homedir()
+  if (!path) return ""
+  const replaced = path.startsWith(home) ? `~${path.slice(home.length)}` : path
+  if (replaced.length <= 72) return replaced
+  return `...${replaced.slice(-69)}`
+}
+
+function renderTag(theme, label, fg = "#0b0b0b", bg = theme.base.accent) {
+  return paint(` ${label} `, fg, { bg, bold: true })
+}
+
+function ageLabel(ms) {
+  const mins = Math.round(ms / 60000)
+  if (mins < 1) return "just now"
+  if (mins < 60) return `${mins}m ago`
+  const hours = Math.round(mins / 60)
+  if (hours < 24) return `${hours}h ago`
+  return `${Math.round(hours / 24)}d ago`
+}
+
+function flattenSections(sections, width) {
+  const lines = []
+  for (const [index, section] of sections.entries()) {
+    lines.push(paint(section.title, section.color, { bold: true }))
+    for (const item of section.items) {
+      if (!item) {
+        lines.push("")
+        continue
+      }
+      const wrapped = wrapPlain(item, width)
+      for (const line of wrapped) lines.push(line)
+    }
+    if (index !== sections.length - 1) lines.push("")
+  }
+  return lines
+}
+
+function frameLine(content, width, borderColor) {
+  const inner = width - 4
+  const padded = padCell(content, inner)
+  return paint(`| ${padded} |`, borderColor)
+}
+
+function drawSingleColumn({ width, theme, sections }) {
+  const border = paint(`+${"-".repeat(width - 2)}+`, theme.base.border)
+  const out = [border]
+  const cellWidth = width - 4
+  const lines = flattenSections(sections, cellWidth)
+  for (const line of lines) out.push(frameLine(line, width, theme.base.border))
+  out.push(border)
+  return out
+}
+
+function drawDoubleColumn({ width, theme, leftSections, rightSections }) {
+  const border = paint(`+${"-".repeat(width - 2)}+`, theme.base.border)
+  const out = [border]
+  const inner = width - 4
+  const gap = 3
+  const leftWidth = Math.floor((inner - gap) * 0.5)
+  const rightWidth = inner - gap - leftWidth
+
+  const leftLines = flattenSections(leftSections, leftWidth)
+  const rightLines = flattenSections(rightSections, rightWidth)
+  const rows = Math.max(leftLines.length, rightLines.length)
+
+  for (let i = 0; i < rows; i++) {
+    const left = padCell(leftLines[i] || "", leftWidth)
+    const right = padCell(rightLines[i] || "", rightWidth)
+    out.push(paint(`| ${left} | ${right} |`, theme.base.border))
+  }
+  out.push(border)
+  return out
+}
+
+export function renderReplDashboard({
+  theme,
+  state,
+  providers,
+  recentSessions,
+  customCommandCount,
+  cwd,
+  columns = null
+}) {
+  const width = Number.isFinite(columns) ? Math.max(60, Math.min(Number(columns), 220)) : terminalWidth()
+  const title = `${renderTag(theme, "KKCODE", "#111111", theme.semantic.info)} ${paint("Interactive Coding CLI", theme.base.fg, { bold: true })}`
+  const subtitle = paint("Adaptive dashboard + richer command palette", theme.base.muted)
+
+  const recentLines = recentSessions.length
+    ? recentSessions.slice(0, 6).map((s) => `${s.id.slice(0, 12)} ${s.mode} ${ageLabel(Date.now() - s.updatedAt)}`)
+    : ["(no session yet)"]
+
+  const leftSections = [
+    {
+      title: "Workspace",
+      color: theme.semantic.info,
+      items: [shortenPath(cwd)]
+    },
+    {
+      title: "Runtime",
+      color: theme.semantic.success,
+      items: [
+        `Session: ${state.sessionId}`,
+        `Mode: ${state.mode}`,
+        `Provider: ${state.providerType}`,
+        `Model: ${state.model}`,
+        `Custom commands: ${customCommandCount}`
+      ]
+    },
+    {
+      title: "Quick Aliases",
+      color: theme.modes.agent,
+      items: [
+        "/h  /?   help",
+        "/n       new session",
+        "/r       resume latest",
+        "/m       switch mode",
+        "/p       switch provider",
+        "/k       shortcuts"
+      ]
+    }
+  ]
+
+  const rightSections = [
+    {
+      title: "Tips",
+      color: theme.semantic.warn,
+      items: [
+        "Use /dash to redraw this panel",
+        "Use /clear to clear screen",
+        "Use /model <id> to override model",
+        "Use \"\"\" for multi-line prompts"
+      ]
+    },
+    {
+      title: "Recent Activity",
+      color: theme.modes.plan,
+      items: recentLines
+    },
+    {
+      title: "Providers",
+      color: theme.modes.ask,
+      items: [providers.length ? providers.join(" | ") : "(none configured)"]
+    },
+    {
+      title: "Useful Commands",
+      color: theme.modes.longagent,
+      items: [
+        "/history /resume /commands /reload",
+        "/ask /plan /agent /longagent"
+      ]
+    }
+  ]
+
+  const lines = [
+    title,
+    subtitle,
+    ""
+  ]
+
+  const useSingle = width < 110
+  const panel = useSingle
+    ? drawSingleColumn({ width, theme, sections: [...leftSections, ...rightSections] })
+    : drawDoubleColumn({ width, theme, leftSections, rightSections })
+
+  lines.push(...panel)
+  return lines.join("\n")
+}
+
+export function renderReplLogo({ theme, columns = null }) {
+  const width = Number.isFinite(columns) ? Math.max(60, Math.min(Number(columns), 220)) : terminalWidth()
+  const rawLogo = [
+    "██╗  ██╗ ██╗  ██╗  ██████╗  ██████╗  ██████╗  ███████╗",
+    "██║ ██╔╝ ██║ ██╔╝ ██╔════╝ ██╔═══██╗ ██╔══██╗ ██╔════╝",
+    "█████╔╝  █████╔╝  ██║      ██║   ██║ ██║  ██║ █████╗  ",
+    "██╔═██╗  ██╔═██╗  ██║      ██║   ██║ ██║  ██║ ██╔══╝  ",
+    "██║  ██╗ ██║  ██╗ ╚██████╗ ╚██████╔╝ ██████╔╝ ███████╗",
+    "╚═╝  ╚═╝ ╚═╝  ╚═╝  ╚═════╝  ╚═════╝  ╚═════╝  ╚══════╝"
+  ]
+  const wave = [
+    "#4af5f0", "#3de8f5", "#30dbfa", "#38c8ff", "#40b5ff",
+    "#58a0ff", "#708bff", "#8876ff", "#a061ff", "#b84cff",
+    "#d037ff", "#e828f0", "#f034d0", "#f040b0", "#f04c90",
+    "#f040b0", "#f034d0", "#e828f0", "#d037ff", "#b84cff",
+    "#a061ff", "#8876ff", "#708bff", "#58a0ff", "#40b5ff",
+    "#38c8ff", "#30dbfa", "#3de8f5"
+  ]
+  const coreLines = rawLogo.map((line, row) => {
+    let out = ""
+    for (let col = 0; col < line.length; col++) {
+      const ch = line[col]
+      if (ch === " ") { out += " "; continue }
+      const waveIdx = (col + row * 3) % wave.length
+      out += paint(ch, wave[waveIdx], { bold: true })
+    }
+    return out
+  })
+  coreLines.push(paint("AI Coding Agent", theme.base.fg, { bold: true }))
+  coreLines.push(paint("Type /status to open Workspace & Runtime panel", theme.base.muted))
+
+  const mascotRaw = [
+    "      /\\      ",
+    "     /__\\     ",
+    "    /|[]|\\    ",
+    "   /_|__|_\\   ",
+    "     /||\\     ",
+    "    /_||_\\    ",
+    "      /\\      "
+  ]
+  const mascotPalette = [
+    "#6ec1ff",
+    "#52b7ff",
+    "#36d8d3",
+    "#3fd487",
+    "#f1c55b",
+    "#f39b52",
+    "#ff7f6e"
+  ]
+  const mascotLines = mascotRaw.map((line, idx) => paint(line, mascotPalette[idx % mascotPalette.length], { bold: true }))
+
+  // Narrow terminals: keep pure centered logo, avoid cramped side art.
+  if (width < 96) {
+    const lines = coreLines.map((line) => centerLine(line, width))
+    return lines.join("\n")
+  }
+
+  // Three-column layout keeps KKCODE visually centered in the full terminal:
+  // [mascot] [center logo block] [symmetric spacer]
+  const mascotWidth = Math.max(...mascotRaw.map((line) => visibleWidth(line)))
+  const sideWidth = mascotWidth + 2
+  const centerWidth = Math.max(24, width - (sideWidth * 2))
+
+  const rows = Math.max(coreLines.length, mascotLines.length)
+  const mascotTopPad = Math.max(0, Math.floor((rows - mascotLines.length) / 2))
+  const logoTopPad = Math.max(0, Math.floor((rows - coreLines.length) / 2))
+  const lines = []
+
+  for (let i = 0; i < rows; i++) {
+    const mascotIdx = i - mascotTopPad
+    const logoIdx = i - logoTopPad
+    const left = mascotIdx >= 0 && mascotIdx < mascotLines.length ? mascotLines[mascotIdx] : ""
+    const mid = logoIdx >= 0 && logoIdx < coreLines.length ? centerLine(coreLines[logoIdx], centerWidth) : ""
+    const leftCell = padCell(left, sideWidth)
+    const midCell = padCell(mid, centerWidth)
+    const rightCell = " ".repeat(sideWidth)
+    lines.push(`${leftCell}${midCell}${rightCell}`)
+  }
+
+  return lines.join("\n")
+}
+
+export function renderStartupHint(recentSessions = []) {
+  if (!recentSessions.length) return ""
+  const last = recentSessions[0]
+  const age = ageLabel(Date.now() - last.updatedAt)
+  return `last session: ${last.id} (${last.mode}, ${age})\n  quick resume: /r ${last.id.slice(0, 12)}`
+}

package/src/usage/pricing.mjs

@@ -0,0 +1,121 @@
+import path from "node:path"
+import { access, readFile } from "node:fs/promises"
+import YAML from "yaml"
+
+const DEFAULT_PRICING = {
+  currency: "USD",
+  per_tokens: 1000000,
+  models: {
+    "claude-opus-4-6": { input: 5, output: 25, cache_read: 0.5, cache_write: 6.25 },
+    "claude-opus-4-5": { input: 5, output: 25, cache_read: 0.5, cache_write: 6.25 },
+    "claude-opus-4-1": { input: 15, output: 75, cache_read: 1.5, cache_write: 18.75 },
+    "claude-opus-4": { input: 15, output: 75, cache_read: 1.5, cache_write: 18.75 },
+    "claude-sonnet-4-6": { input: 3, output: 15, cache_read: 0.3, cache_write: 3.75 },
+    "claude-sonnet-4-5": { input: 3, output: 15, cache_read: 0.3, cache_write: 3.75 },
+    "claude-sonnet-4": { input: 3, output: 15, cache_read: 0.3, cache_write: 3.75 },
+    "claude-haiku-4-5": { input: 1, output: 5, cache_read: 0.1, cache_write: 1.25 },
+    "claude-haiku-3-5": { input: 0.8, output: 4, cache_read: 0.08, cache_write: 1 },
+    "gpt-5.3-codex": { input: 15, output: 60, cache_read: 7.5, cache_write: 15 },
+    "gpt-4o": { input: 2.5, output: 10, cache_read: 1.25, cache_write: 2.5 },
+    "gpt-4o-mini": { input: 0.15, output: 0.6, cache_read: 0.075, cache_write: 0.15 },
+    "deepseek-chat": { input: 0.27, output: 1.1, cache_read: 0.07, cache_write: 0.27 },
+    "deepseek-coder": { input: 0.27, output: 1.1, cache_read: 0.07, cache_write: 0.27 },
+    "deepseek-v3.1-terminus": { input: 0.55, output: 1.65, cache_read: 0.07, cache_write: 0.55 },
+    "deepseek-v3.2": { input: 0.28, output: 0.41, cache_read: 0.03, cache_write: 0.28 },
+    "kimi-k2.5": { input: 0.55, output: 2.9, cache_read: 0, cache_write: 0 },
+    "kimi-k2-0905": { input: 0.55, output: 2.2, cache_read: 0.14, cache_write: 0 },
+    "qwen-plus": { input: 0.11, output: 1.11, cache_read: 0.02, cache_write: 0 },
+    "qwen-max": { input: 0.33, output: 1.33, cache_read: 0.07, cache_write: 0 },
+    "qwen-turbo": { input: 0.04, output: 0.08, cache_read: 0.01, cache_write: 0 },
+    "qwen3-coder-plus": { input: 0.55, output: 2.2, cache_read: 0.11, cache_write: 0 },
+    "qwen3-coder-flash": { input: 0.14, output: 0.55, cache_read: 0.03, cache_write: 0 },
+    "qwen3-coder-480b-a35b": { input: 0.83, output: 3.3, cache_read: 0.17, cache_write: 0 },
+    "doubao-seed-2.0-code": { input: 0.44, output: 2.2, cache_read: 0, cache_write: 0 },
+    "doubao-seed-2.0-pro": { input: 0.44, output: 2.2, cache_read: 0, cache_write: 0 },
+    "doubao-seed-1.8": { input: 0.11, output: 1.1, cache_read: 0, cache_write: 0 },
+    "doubao-seed-code": { input: 0.17, output: 1.1, cache_read: 0, cache_write: 0 },
+    "minimax-m2.5": { input: 0.29, output: 1.16, cache_read: 0.03, cache_write: 0 },
+    "minimax-m2.5-highspeed": { input: 0.58, output: 2.32, cache_read: 0.03, cache_write: 0 },
+    "minimax-m2.1": { input: 0.29, output: 1.16, cache_read: 0.03, cache_write: 0 },
+    "minimax-m2": { input: 0.29, output: 1.16, cache_read: 0.03, cache_write: 0 },
+    "glm-5": { input: 0.55, output: 3.05, cache_read: 0, cache_write: 0 },
+    "glm-4.7": { input: 0.41, output: 1.93, cache_read: 0, cache_write: 0 },
+    "glm-4.6": { input: 0.28, output: 1.1, cache_read: 0, cache_write: 0 }
+  },
+  default: {
+    input: 3,
+    output: 15,
+    cache_read: 0.3,
+    cache_write: 3.75
+  }
+}
+
+async function exists(file) {
+  try {
+    await access(file)
+    return true
+  } catch {
+    return false
+  }
+}
+
+function parse(file, raw) {
+  if (file.endsWith(".json")) return JSON.parse(raw)
+  return YAML.parse(raw)
+}
+
+function resolvePricingPath(configState) {
+  const projectPath = configState.source.projectRaw?.usage?.pricing_file
+  if (typeof projectPath === "string" && projectPath.trim()) {
+    return path.resolve(configState.source.projectDir ?? process.cwd(), projectPath)
+  }
+  const userPath = configState.source.userRaw?.usage?.pricing_file
+  if (typeof userPath === "string" && userPath.trim()) {
+    return path.resolve(configState.source.userDir ?? process.cwd(), userPath)
+  }
+  return null
+}
+
+export async function loadPricing(configState) {
+  const file = resolvePricingPath(configState)
+  if (!file || !(await exists(file))) {
+    return { pricing: DEFAULT_PRICING, source: "default", errors: [] }
+  }
+  try {
+    const raw = await readFile(file, "utf8")
+    const parsed = parse(file, raw)
+    const pricing = {
+      ...DEFAULT_PRICING,
+      ...parsed,
+      default: { ...DEFAULT_PRICING.default, ...(parsed.default ?? {}) }
+    }
+    return { pricing, source: file, errors: [] }
+  } catch (error) {
+    return { pricing: DEFAULT_PRICING, source: "default", errors: [`${file}: ${error.message}`] }
+  }
+}
+
+function findPricingEntry(models, model) {
+  if (models[model]) return models[model]
+  // Fuzzy: try prefix match (e.g. "claude-opus-4-6-20250601" → "claude-opus-4-6")
+  const m = String(model).toLowerCase()
+  for (const key of Object.keys(models)) {
+    if (m.startsWith(key)) return models[key]
+  }
+  return null
+}
+
+export function calculateCost(pricing, model, usage) {
+  const entry = findPricingEntry(pricing.models, model) ?? pricing.default
+  const per = pricing.per_tokens || 1000000
+  // All providers normalize input to non-cached tokens only (see provider/*.mjs)
+  const amount =
+    ((usage.input || 0) * (entry.input || 0) +
+      (usage.output || 0) * (entry.output || 0) +
+      (usage.cacheRead || 0) * (entry.cache_read || 0) +
+      (usage.cacheWrite || 0) * (entry.cache_write || 0)) /
+    per
+  const savings = ((usage.cacheRead || 0) * ((entry.input || 0) - (entry.cache_read || 0))) / per
+  const unknown = !findPricingEntry(pricing.models, model)
+  return { amount, savings, unknown, currency: pricing.currency }
+}

package/src/usage/usage-meter.mjs

@@ -0,0 +1,113 @@
+import { ensureUserRoot, usageStorePath } from "../storage/paths.mjs"
+import { readJson, writeJson } from "../storage/json-store.mjs"
+
+export function emptyUsage() {
+  return {
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    cost: 0,
+    turns: 0
+  }
+}
+
+function addUsage(target, delta, cost) {
+  target.input += delta.input || 0
+  target.output += delta.output || 0
+  target.cacheRead += delta.cacheRead || 0
+  target.cacheWrite += delta.cacheWrite || 0
+  target.cost += cost || 0
+  target.turns += 1
+}
+
+function todayKey() {
+  return new Date().toISOString().slice(0, 10) // "YYYY-MM-DD"
+}
+
+function defaultStore() {
+  return {
+    updatedAt: Date.now(),
+    globalDay: todayKey(),
+    global: emptyUsage(),
+    sessions: {}
+  }
+}
+
+function maybeRotateGlobal(store) {
+  const today = todayKey()
+  if (store.globalDay && store.globalDay !== today) {
+    store.global = emptyUsage()
+    store.globalDay = today
+  }
+  if (!store.globalDay) store.globalDay = today
+}
+
+export async function readUsageStore() {
+  await ensureUserRoot()
+  return readJson(usageStorePath(), defaultStore())
+}
+
+async function persist(store) {
+  store.updatedAt = Date.now()
+  await writeJson(usageStorePath(), store)
+}
+
+export async function recordTurn({ sessionId, usage, cost }) {
+  const store = await readUsageStore()
+  maybeRotateGlobal(store)
+  if (!store.sessions[sessionId]) store.sessions[sessionId] = emptyUsage()
+  addUsage(store.sessions[sessionId], usage, cost)
+  addUsage(store.global, usage, cost)
+  await persist(store)
+  return {
+    turn: {
+      input: usage.input || 0,
+      output: usage.output || 0,
+      cacheRead: usage.cacheRead || 0,
+      cacheWrite: usage.cacheWrite || 0,
+      cost: cost || 0,
+      turns: 1
+    },
+    session: store.sessions[sessionId],
+    global: store.global
+  }
+}
+
+export async function resetUsage(sessionId = null) {
+  if (!sessionId) {
+    await persist(defaultStore())
+    return
+  }
+  const store = await readUsageStore()
+  delete store.sessions[sessionId]
+  store.global = emptyUsage()
+  for (const session of Object.values(store.sessions)) {
+    store.global.input += session.input
+    store.global.output += session.output
+    store.global.cacheRead += session.cacheRead
+    store.global.cacheWrite += session.cacheWrite
+    store.global.cost += session.cost
+    store.global.turns += session.turns
+  }
+  await persist(store)
+}
+
+export async function exportUsageCsv() {
+  const store = await readUsageStore()
+  const rows = [["scope", "sessionId", "input", "output", "cacheRead", "cacheWrite", "cost", "turns"]]
+  rows.push([
+    "global",
+    "",
+    store.global.input,
+    store.global.output,
+    store.global.cacheRead,
+    store.global.cacheWrite,
+    store.global.cost,
+    store.global.turns
+  ])
+  for (const [sessionId, usage] of Object.entries(store.sessions)) {
+    rows.push(["session", sessionId, usage.input, usage.output, usage.cacheRead, usage.cacheWrite, usage.cost, usage.turns])
+  }
+  return rows.map((row) => row.join(",")).join("\n") + "\n"
+}