@leviyuan/lodestar 0.2.9 → 0.3.0

package/src/claude-process.ts

@@ -1,417 +0,0 @@
-/**
- * Headless Claude Code subprocess + SDK control protocol over NDJSON.
- *
- * Spawned with:
- *   claude -p
- *     --input-format=stream-json
- *     --output-format=stream-json
- *     --verbose
- *     --permission-prompt-tool=stdio
- *     --permission-mode={mode}
- *     [--effort=max] [--model=...] [--append-system-prompt=...]
- *     [--resume <id> --resume-session-at <uuid>]
- *
- * Stdin / stdout are line-delimited JSON. Stdout flows assistant chunks,
- * tool_use, tool_result, control_request (can_use_tool / hook_callback)
- * and finally `result` per turn.  Stdin carries user messages and our
- * outbound control_responses + control_requests (Initialize / Interrupt /
- * SetPermissionMode).
- */
-
-import { spawn, type ChildProcessByStdio } from 'node:child_process'
-import { homedir } from 'node:os'
-import { join } from 'node:path'
-import { EventEmitter } from 'node:events'
-import type { Readable, Writable } from 'node:stream'
-import { log } from './log'
-
-interface SpawnOpts {
-  workDir: string
-  resumeSessionId?: string
-  resumeAtUuid?: string
-  model?: string
-  effort?: 'low' | 'medium' | 'high' | 'max'
-  permissionMode?: 'default' | 'acceptEdits' | 'plan' | 'bypassPermissions'
-  appendSystemPrompt?: string
-}
-
-export interface CanUseToolRequest {
-  request_id: string
-  tool_name: string
-  input: any
-  permission_suggestions?: any
-  blocked_paths?: string[]
-  tool_use_id?: string
-}
-
-/** Subset of the SDK's `usage` object — only the fields the console
- * panel actually shows. Anthropic adds new ones (server_tool_use,
- * service_tier, iterations, …) without breaking existing readers. */
-export interface ClaudeUsage {
-  input_tokens?: number
-  output_tokens?: number
-  cache_creation_input_tokens?: number
-  cache_read_input_tokens?: number
-}
-
-export interface ClaudeResultMeta {
-  cost_usd: number | null
-  duration_ms: number | null
-  num_turns: number | null
-  usage: ClaudeUsage | null
-  /** SDK `result.subtype` — `success` on natural end_turn,
-   * `error_max_turns` if --max-turns was reached, `error_during_execution`
-   * for API-side failures (rate limit / 5xx / context overflow / refusal).
-   * Session.wireProc uses this to drive auto-retry + suppress phone push
-   * on aborted turns. */
-  subtype: string | null
-  /** Mirror of `subtype !== 'success'`; cached so callers don't have to
-   * re-derive it from the (open-ended) subtype string. */
-  is_error: boolean
-}
-
-export interface HookCallbackRequest {
-  request_id: string
-  callback_id: string
-  input: any
-  tool_use_id?: string
-}
-
-export class ClaudeProcess extends EventEmitter {
-  private proc: ChildProcessByStdio<Writable, Readable, Readable>
-  private stdoutBuf = ''
-  private stderrBuf = ''
-  private requestCounter = 0
-  private alive = true
-  private expectedExit = false
-  sessionId: string | null = null
-  lastAssistantUuid: string | null = null
-  /** Model id (`claude-opus-4-7`, …) from the most recent assistant
-   * message — surfaced in the console panel so the user sees what's
-   * actually running, not whatever default we'd assume. */
-  lastModel: string | null = null
-  /** Usage from the most recent `assistant` message — input_tokens +
-   * cache_* on the *latest* message is the best proxy for current
-   * context-window occupancy, since each assistant turn replays the
-   * accumulated conversation. */
-  lastUsage: ClaudeUsage | null = null
-  /** Result-level metadata from the most recent `result` message —
-   * per-turn cost / wallclock / num_turns. Cleared to null only on
-   * spawn; persists across turns so the console panel can show "last
-   * turn" stats even while idle. */
-  lastResult: ClaudeResultMeta = {
-    cost_usd: null, duration_ms: null, num_turns: null, usage: null,
-    subtype: null, is_error: false,
-  }
-  /** Context-window capacity of the model that ran the latest turn —
-   * lifted from `result.modelUsage[model].contextWindow` so we don't
-   * have to hardcode `[1m]` vs stock variants. `null` until the first
-   * `result` event lands (spawn → first turn close gap). Callers that
-   * render a percentage MUST treat null as "unknown" and drop the %
-   * rather than substituting a default — past life of this field was a
-   * 200K constant default which made fresh-spawn `hi` panels lie about
-   * the limit on this project's opus-4-7[1m] (1M) pin. (no_fallbacks
-   * rule applies: surface absence, don't fabricate.) */
-  lastContextWindow: number | null = null
-
-  constructor(opts: SpawnOpts) {
-    super()
-    const claudeBin = join(homedir(), '.local', 'bin', 'claude')
-    const args = [
-      '-p',
-      '--input-format=stream-json',
-      '--output-format=stream-json',
-      '--verbose',
-      '--permission-prompt-tool=stdio',
-      `--permission-mode=${opts.permissionMode ?? 'default'}`,
-    ]
-    if (opts.model) args.push('--model', opts.model)
-    if (opts.effort) args.push('--effort', opts.effort)
-    if (opts.appendSystemPrompt) args.push('--append-system-prompt', opts.appendSystemPrompt)
-    if (opts.resumeSessionId) {
-      args.push('--resume', opts.resumeSessionId)
-      if (opts.resumeAtUuid) args.push('--resume-session-at', opts.resumeAtUuid)
-    }
-
-    log(`claude-process: spawn ${claudeBin} (cwd=${opts.workDir})`)
-    this.proc = spawn(claudeBin, args, {
-      cwd: opts.workDir,
-      stdio: ['pipe', 'pipe', 'pipe'],
-      env: {
-        ...process.env,
-        NPM_CONFIG_LOGLEVEL: 'error',
-        PATH: [
-          join(homedir(), '.local', 'bin'),
-          join(homedir(), '.bun', 'bin'),
-          join(homedir(), '.local', 'npm-global', 'bin'),
-          '/usr/local/bin', '/usr/bin', '/bin',
-        ].join(':'),
-      },
-    }) as ChildProcessByStdio<Writable, Readable, Readable>
-
-    this.proc.stdout.on('data', (chunk: Buffer) => this.onStdout(chunk))
-    this.proc.stderr.on('data', (chunk: Buffer) => this.onStderr(chunk))
-    this.proc.on('exit', (code, signal) => {
-      this.alive = false
-      log(`claude-process: exited code=${code} signal=${signal} expected=${this.expectedExit}`)
-      this.emit('exit', { code, signal, expected: this.expectedExit })
-    })
-    this.proc.on('error', err => {
-      log(`claude-process: spawn error: ${err}`)
-      this.emit('error', err)
-    })
-  }
-
-  // ── Stream parsers ─────────────────────────────────────────────────
-  private onStdout(chunk: Buffer): void {
-    this.stdoutBuf += chunk.toString()
-    let nl: number
-    while ((nl = this.stdoutBuf.indexOf('\n')) >= 0) {
-      const line = this.stdoutBuf.slice(0, nl).trim()
-      this.stdoutBuf = this.stdoutBuf.slice(nl + 1)
-      if (!line) continue
-      try {
-        const msg = JSON.parse(line)
-        this.handleMessage(msg)
-      } catch (e) {
-        log(`claude-process: bad json: ${line.slice(0, 200)} (${e})`)
-      }
-    }
-  }
-
-  private onStderr(chunk: Buffer): void {
-    this.stderrBuf += chunk.toString()
-    let nl: number
-    while ((nl = this.stderrBuf.indexOf('\n')) >= 0) {
-      const line = this.stderrBuf.slice(0, nl)
-      this.stderrBuf = this.stderrBuf.slice(nl + 1)
-      if (line.trim()) log(`claude-process[stderr]: ${line}`)
-    }
-  }
-
-  private handleMessage(msg: any): void {
-    const type = msg.type
-    if (type === 'system' && msg.subtype === 'init') {
-      this.sessionId = msg.session_id ?? null
-      log(`claude-process: session=${this.sessionId}`)
-      this.emit('init', msg)
-      return
-    }
-    if (type === 'control_request') {
-      const req = msg.request
-      if (req?.subtype === 'can_use_tool') {
-        this.emit('can_use_tool', {
-          request_id: msg.request_id,
-          tool_name: req.tool_name,
-          input: req.input,
-          permission_suggestions: req.permission_suggestions,
-          blocked_paths: req.blocked_paths,
-          tool_use_id: req.tool_use_id,
-        } as CanUseToolRequest)
-        return
-      }
-      if (req?.subtype === 'hook_callback') {
-        this.emit('hook_callback', {
-          request_id: msg.request_id,
-          callback_id: req.callback_id,
-          input: req.input,
-          tool_use_id: req.tool_use_id,
-        } as HookCallbackRequest)
-        return
-      }
-      log(`claude-process: unknown control_request subtype=${req?.subtype}`)
-      return
-    }
-    if (type === 'control_response') {
-      this.emit('control_response', msg)
-      return
-    }
-    if (type === 'assistant') {
-      const content = msg.message?.content ?? []
-      for (const block of content) {
-        if (block.type === 'text' && typeof block.text === 'string') {
-          this.emit('assistant_text', { uuid: msg.uuid, text: block.text })
-        } else if (block.type === 'tool_use') {
-          this.emit('tool_use', { uuid: msg.uuid, id: block.id, name: block.name, input: block.input })
-        } else if (block.type === 'thinking' && typeof block.thinking === 'string') {
-          this.emit('thinking', { uuid: msg.uuid, text: block.thinking })
-        }
-      }
-      if (msg.message?.usage) this.lastUsage = msg.message.usage as ClaudeUsage
-      if (typeof msg.message?.model === 'string') this.lastModel = msg.message.model
-      if (msg.uuid) this.lastAssistantUuid = msg.uuid
-      return
-    }
-    if (type === 'user') {
-      const content = msg.message?.content ?? []
-      for (const block of content) {
-        if (block.type === 'tool_result') {
-          this.emit('tool_result', {
-            tool_use_id: block.tool_use_id,
-            content: block.content,
-            is_error: block.is_error ?? false,
-          })
-        }
-      }
-      return
-    }
-    if (type === 'result') {
-      const subtype = typeof msg.subtype === 'string' ? msg.subtype : null
-      this.lastResult = {
-        cost_usd: typeof msg.total_cost_usd === 'number' ? msg.total_cost_usd : null,
-        duration_ms: typeof msg.duration_ms === 'number' ? msg.duration_ms : null,
-        num_turns: typeof msg.num_turns === 'number' ? msg.num_turns : null,
-        usage: msg.usage ?? null,
-        subtype,
-        // Trust the SDK's own bool when present; otherwise derive from
-        // subtype so a future error_* variant we haven't seen still flags
-        // as error.
-        is_error: typeof msg.is_error === 'boolean'
-          ? msg.is_error
-          : (subtype !== null && subtype !== 'success'),
-      }
-      // modelUsage maps "<model id>" → { contextWindow, maxOutputTokens, … }.
-      // For mixed-model runs the SDK reports one entry per model used in
-      // the turn; we take the one matching `lastModel` (the assistant's
-      // latest model id) and fall back to any single entry if it's the
-      // only one — covers the common single-model case.
-      const mu = msg.modelUsage
-      if (mu && typeof mu === 'object') {
-        const entry = (this.lastModel && mu[this.lastModel])
-          || (Object.keys(mu).length === 1 ? mu[Object.keys(mu)[0]!] : null)
-        if (entry && typeof entry.contextWindow === 'number' && entry.contextWindow > 0) {
-          this.lastContextWindow = entry.contextWindow
-        }
-      }
-      this.emit('result', msg)
-      return
-    }
-    this.emit('raw', msg)
-  }
-
-  private write(obj: object): void {
-    if (!this.alive) {
-      log(`claude-process: write to dead process: ${JSON.stringify(obj).slice(0, 200)}`)
-      return
-    }
-    try {
-      this.proc.stdin.write(JSON.stringify(obj) + '\n')
-    } catch (e) { log(`claude-process: stdin write failed: ${e}`) }
-  }
-
-  // ── Outbound control ────────────────────────────────────────────────
-  sendInitialize(hooks: Record<string, any> = {}): void {
-    this.write({
-      type: 'control_request',
-      request_id: `init-${++this.requestCounter}`,
-      request: { subtype: 'initialize', hooks },
-    })
-  }
-
-  sendUserText(text: string, files: string[] = []): void {
-    const fileHints = files.length ? files.map(f => `[file: ${f}]`).join(' ') + '\n\n' : ''
-    this.write({
-      type: 'user',
-      message: {
-        role: 'user',
-        content: [{ type: 'text', text: fileHints + text }],
-      },
-    })
-  }
-
-  sendInterrupt(): void {
-    this.write({
-      type: 'control_request',
-      request_id: `int-${++this.requestCounter}`,
-      request: { subtype: 'interrupt' },
-    })
-  }
-
-  /** Response schema for `can_use_tool` control_request (NOT the
-   * PreToolUse-hook output shape that lives elsewhere in the SDK).
-   *   allow → { behavior: 'allow', updatedInput: <record> }
-   *   deny  → { behavior: 'deny',  message: <string> }
-   * Sending the wrong shape gets Zod-rejected on the Claude side and
-   * the decision never lands — the card visually flips to "resolved"
-   * but Claude immediately re-fires the same can_use_tool, looking to
-   * the user like a "flash back to original" bug. */
-  sendPermissionResponse(
-    requestId: string,
-    decision: 'allow' | 'deny',
-    payload?: { updatedInput?: Record<string, unknown>; denyMessage?: string },
-  ): void {
-    const response = decision === 'allow'
-      ? { behavior: 'allow' as const, updatedInput: payload?.updatedInput ?? {} }
-      : { behavior: 'deny' as const, message: payload?.denyMessage ?? 'denied by user' }
-    this.write({
-      type: 'control_response',
-      response: {
-        subtype: 'success',
-        request_id: requestId,
-        response,
-      },
-    })
-  }
-
-  /** Feed a `tool_result` back to Claude as if a tool finished — used
-   * by the daemon when WE (the client) own the tool's execution side,
-   * e.g. AskUserQuestion: the SDK emits `tool_use` and waits for the
-   * client to render UI, collect a choice, and supply the result here.
-   * `content` is whatever the tool's contract says — for
-   * AskUserQuestion this is a JSON string `{"answers": {...}}`.
-   *
-   * NOTE: this is the same `{type:'user'}` envelope as `sendUserText`,
-   * just with a `tool_result` content block instead of plain text. The
-   * SDK demultiplexes by `tool_use_id`. */
-  sendToolResult(toolUseId: string, content: string, isError = false): void {
-    this.write({
-      type: 'user',
-      message: {
-        role: 'user',
-        content: [{
-          type: 'tool_result',
-          tool_use_id: toolUseId,
-          content,
-          ...(isError ? { is_error: true } : {}),
-        }],
-      },
-    })
-  }
-
-  sendHookResponse(requestId: string, output: object = {}): void {
-    this.write({
-      type: 'control_response',
-      response: {
-        subtype: 'success',
-        request_id: requestId,
-        response: output,
-      },
-    })
-  }
-
-  sendSetPermissionMode(mode: 'default' | 'acceptEdits' | 'plan' | 'bypassPermissions'): void {
-    this.write({
-      type: 'control_request',
-      request_id: `mode-${++this.requestCounter}`,
-      request: { subtype: 'set_permission_mode', mode },
-    })
-  }
-
-  // ── Lifecycle ───────────────────────────────────────────────────────
-  isAlive(): boolean { return this.alive }
-
-  async kill(timeoutMs = 5000): Promise<void> {
-    if (!this.alive) return
-    this.expectedExit = true
-    log(`claude-process: SIGTERM (timeout=${timeoutMs}ms)`)
-    try { this.proc.kill('SIGTERM') } catch {}
-    const start = Date.now()
-    while (this.alive && Date.now() - start < timeoutMs) {
-      await new Promise(r => setTimeout(r, 100))
-    }
-    if (this.alive) {
-      log('claude-process: SIGKILL (graceful timeout)')
-      try { this.proc.kill('SIGKILL') } catch {}
-    }
-  }
-}

package/src/config.ts

@@ -1,98 +0,0 @@
-/**
- * Read config.toml — minimal hand-rolled parser sufficient for the
- * three-section, scalar-value-only schema we expect:
- *
- *   [feishu]
- *   app_id = "cli_..."
- *   app_secret = "..."
- *
- *   [runtime]
- *   projects_root = "~/"      # optional, defaults to $HOME
- *
- *   [notify]                  # all optional
- *   bind = "127.0.0.1"        # default 127.0.0.1 (loopback only)
- *   port = 9876               # default 9876
- *
- * Loaded synchronously at import time; downstream modules read the
- * exported `config` object directly.
- */
-
-import { readFileSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { CONFIG_FILE } from './paths'
-
-export interface LodestarConfig {
-  feishu: {
-    app_id: string
-    app_secret: string
-  }
-  runtime: {
-    projects_root: string
-  }
-  notify: {
-    bind: string
-    port: number
-  }
-}
-
-function expandTilde(v: string): string {
-  return v.replace(/^~(?=\/|$)/, homedir())
-}
-
-function parseToml(text: string): Record<string, Record<string, string>> {
-  const out: Record<string, Record<string, string>> = { _: {} }
-  let section = '_'
-  for (const raw of text.split('\n')) {
-    const line = raw.replace(/(^|[^\\])#.*$/, '$1').trim()
-    if (!line) continue
-    const sec = line.match(/^\[([^\]]+)\]$/)
-    if (sec) {
-      section = sec[1].trim()
-      out[section] ??= {}
-      continue
-    }
-    const kv = line.match(/^([\w.-]+)\s*=\s*(.+)$/)
-    if (kv) {
-      let v = kv[2].trim()
-      if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
-        v = v.slice(1, -1)
-      }
-      out[section][kv[1]] = v
-    }
-  }
-  return out
-}
-
-function loadConfig(): LodestarConfig {
-  let raw: string
-  try {
-    raw = readFileSync(CONFIG_FILE, 'utf8')
-  } catch (e) {
-    process.stderr.write(
-      `lodestar: cannot read config at ${CONFIG_FILE}\n` +
-      `  set LODESTAR_CONFIG=/path/to/config.toml to override, or create the file with:\n\n` +
-      `    [feishu]\n    app_id = "cli_xxx"\n    app_secret = "xxx"\n\n`,
-    )
-    throw e
-  }
-  const t = parseToml(raw)
-  const appId = t.feishu?.app_id
-  const appSecret = t.feishu?.app_secret
-  if (!appId || !appSecret) {
-    throw new Error(`lodestar: ${CONFIG_FILE} is missing [feishu].app_id / [feishu].app_secret`)
-  }
-  const projectsRoot = expandTilde(t.runtime?.projects_root ?? homedir())
-  const notifyBind = t.notify?.bind ?? '127.0.0.1'
-  const notifyPortRaw = t.notify?.port ?? '9876'
-  const notifyPort = Number.parseInt(notifyPortRaw, 10)
-  if (!Number.isFinite(notifyPort) || notifyPort <= 0 || notifyPort > 65535) {
-    throw new Error(`lodestar: [notify].port must be 1..65535, got "${notifyPortRaw}"`)
-  }
-  return {
-    feishu: { app_id: appId, app_secret: appSecret },
-    runtime: { projects_root: projectsRoot },
-    notify: { bind: notifyBind, port: notifyPort },
-  }
-}
-
-export const config = loadConfig()