@cocorograph/hub-agent 0.6.0 → 0.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの tmux/pty を中継する。",
   "type": "module",
   "license": "UNLICENSED",

package/src/claude-history.mjs

@@ -0,0 +1,169 @@
+/**
+ * Claude Code のローカル会話履歴 (`~/.claude/projects/<cwd-encoded>/<session-id>.jsonl`)
+ * を読んで browser に返すモジュール (Sprint G hotfix 0.6.1)。
+ *
+ * 用途: Cockpit ChatView が re-mount された時に、SDK の `--resume <session_id>` で
+ * モデル側の文脈は復元されるが UI 側 messages は空のままという違和感を解消するため、
+ * 同じ jsonl ファイルを直読みして過去メッセージを UI に hydrate する。
+ *
+ * 設計:
+ * - cwd エンコード規則: `/`, `.`, `_` などの非英数字を `-` 置換 (Claude CLI と同じ)
+ * - 1 行 = 1 JSON。`type` が 'user' / 'assistant' / 'system' / 'result' のものだけ抽出
+ *   (内部 type 'attachment' / 'last-prompt' / 'permission-mode' 等は UI 表示対象外)
+ * - 上限 MAX_HISTORY_LINES (デフォルト 500) で末尾から切る
+ * - ファイル不在 (新規セッション) なら空配列を返す (エラーにしない)
+ */
+import { readFile, readdir, stat } from "node:fs/promises"
+import os from "node:os"
+import path from "node:path"
+
+export const MAX_HISTORY_LINES = 500
+
+/** UI 表示対象の SDK message type (それ以外は jsonl 内部メタなので除外)。 */
+const DISPLAY_TYPES = new Set(["user", "assistant", "system", "result"])
+
+/**
+ * cwd 文字列を Claude Code の project dir 名に変換する。
+ * 例: `/Users/kaz/hub/projects/D00585_partition-lab`
+ *  → `-Users-kaz-hub-projects-D00585-partition-lab`
+ *
+ * Claude CLI のエンコード規則は「英数字とハイフン以外を `-` 置換」。連続する非英数字は
+ * そのまま連続ハイフンになる (例: `/.claude/` → `--claude-`)。
+ *
+ * @param {string} cwd
+ * @returns {string}
+ */
+export function encodeCwdToDirName(cwd) {
+  if (!cwd) return ""
+  return cwd.replace(/[^A-Za-z0-9-]/g, "-")
+}
+
+/** `~/.claude/projects/<encoded>/<session_id>.jsonl` の絶対パス。 */
+export function jsonlPath({ cwd, session_id, projectsRoot }) {
+  const root = projectsRoot || path.join(os.homedir(), ".claude", "projects")
+  return path.join(root, encodeCwdToDirName(cwd), `${session_id}.jsonl`)
+}
+
+/**
+ * jsonl 1 ファイルを読んで UI 表示用イベント配列を返す。
+ *
+ * 末尾 maxLines 行に絞ってから JSON.parse + DISPLAY_TYPES でフィルタ。
+ * 大きいファイルでも先頭から全行 parse する必要はないが、line buffer を最小化
+ * するため簡易実装で全文 readFile → split → 末尾 slice する (典型 1MB 未満想定)。
+ *
+ * @param {string} filePath
+ * @param {{maxLines?: number, logger?: import('pino').Logger}} [opts]
+ * @returns {Promise<{events: object[], total_lines: number, truncated: boolean}>}
+ */
+export async function readSessionHistory(filePath, { maxLines = MAX_HISTORY_LINES, logger } = {}) {
+  let text
+  try {
+    text = await readFile(filePath, "utf-8")
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return { events: [], total_lines: 0, truncated: false }
+    }
+    logger?.warn({ err: err.message, filePath }, "claude history read failed")
+    throw err
+  }
+  // 末尾 newline は捨てる
+  const lines = text.split("\n").filter((l) => l.length > 0)
+  const total_lines = lines.length
+  const truncated = total_lines > maxLines
+  const slice = truncated ? lines.slice(-maxLines) : lines
+
+  const events = []
+  for (const line of slice) {
+    let obj
+    try {
+      obj = JSON.parse(line)
+    } catch {
+      continue
+    }
+    if (!obj || typeof obj !== "object") continue
+    if (!DISPLAY_TYPES.has(obj.type)) continue
+    // SDK message と同じ shape にする (余分な meta は落とす)
+    const event = { type: obj.type }
+    if (obj.message !== undefined) event.message = obj.message
+    if (obj.subtype !== undefined) event.subtype = obj.subtype
+    if (obj.session_id !== undefined) event.session_id = obj.session_id
+    else if (obj.sessionId !== undefined) event.session_id = obj.sessionId
+    if (obj.model !== undefined) event.model = obj.model
+    if (obj.cwd !== undefined) event.cwd = obj.cwd
+    if (obj.tools !== undefined) event.tools = obj.tools
+    if (obj.permissionMode !== undefined) event.permissionMode = obj.permissionMode
+    if (obj.total_cost_usd !== undefined) event.total_cost_usd = obj.total_cost_usd
+    if (obj.duration_ms !== undefined) event.duration_ms = obj.duration_ms
+    if (obj.num_turns !== undefined) event.num_turns = obj.num_turns
+    if (obj.usage !== undefined) event.usage = obj.usage
+    events.push(event)
+  }
+  return { events, total_lines, truncated }
+}
+
+/**
+ * cwd + session_id から jsonl を読み、Browser が `claude.history.response` として
+ * 受け取れる shape で返す。
+ *
+ * @param {{cwd: string, session_id: string, maxLines?: number, projectsRoot?: string, logger?: import('pino').Logger}} args
+ */
+export async function fetchSessionHistory({ cwd, session_id, maxLines, projectsRoot, logger }) {
+  if (!cwd || !session_id) {
+    return { events: [], total_lines: 0, truncated: false, error: "missing_cwd_or_session_id" }
+  }
+  const filePath = jsonlPath({ cwd, session_id, projectsRoot })
+  try {
+    const result = await readSessionHistory(filePath, { maxLines, logger })
+    return { ...result, file_path: filePath }
+  } catch (err) {
+    return {
+      events: [],
+      total_lines: 0,
+      truncated: false,
+      error: err.message || String(err),
+      file_path: filePath,
+    }
+  }
+}
+
+/**
+ * cwd 配下の全 jsonl ファイルから session 一覧を返す (Phase 2 用、現状未使用)。
+ * 各ファイルから session_id / 最終更新時刻 / 最初の user message の冒頭を抽出。
+ *
+ * @param {{cwd: string, projectsRoot?: string, logger?: import('pino').Logger}} args
+ */
+export async function listSessions({ cwd, projectsRoot, logger }) {
+  if (!cwd) return { sessions: [] }
+  const dir = path.join(
+    projectsRoot || path.join(os.homedir(), ".claude", "projects"),
+    encodeCwdToDirName(cwd),
+  )
+  let files
+  try {
+    files = await readdir(dir)
+  } catch (err) {
+    if (err.code === "ENOENT") return { sessions: [] }
+    logger?.warn({ err: err.message, dir }, "claude history list failed")
+    return { sessions: [], error: err.message }
+  }
+  const sessions = []
+  for (const f of files) {
+    if (!f.endsWith(".jsonl")) continue
+    const session_id = f.slice(0, -".jsonl".length)
+    const filePath = path.join(dir, f)
+    try {
+      const st = await stat(filePath)
+      sessions.push({
+        session_id,
+        file_path: filePath,
+        mtime: st.mtimeMs,
+        size_bytes: st.size,
+      })
+    } catch {
+      // ignore individual file stat errors
+    }
+  }
+  // 最新順
+  sessions.sort((a, b) => b.mtime - a.mtime)
+  return { sessions }
+}

package/src/main.mjs

@@ -22,6 +22,7 @@ import { loadPlugins, runHookBroadcast, runHookChain } from "./plugin-loader.mjs
 import { WsClient } from "./ws-client.mjs"
 import { PtyBridge } from "./pty-bridge.mjs"
 import { ClaudeStreamBridge } from "./claude-stream-bridge.mjs"
+import { fetchSessionHistory } from "./claude-history.mjs"
 import { listAgents } from "./agents.mjs"
 import { listSkills } from "./skills.mjs"
 import { listSessionStates } from "./state.mjs"
@@ -631,6 +632,31 @@ async function dispatch(msg, ctx) {
         if (!ctx.claudeBridge) return
         ctx.claudeBridge.detach({ stream_id: msg.stream_id })
         return
+      case "claude.history.request": {
+        // Sprint G 0.6.1: ~/.claude/projects/<cwd-encoded>/<session_id>.jsonl を読んで
+        // 過去メッセージを返す。ChatView の re-mount 時の UI 復元用。
+        // stream_id は per-stream routing のため必須 (browser 側 stream に紐付ける)。
+        const stream_id = msg.stream_id
+        const cwd = msg.cwd || ""
+        const session_id = msg.session_id || ""
+        const maxLines = typeof msg.max_lines === "number" ? msg.max_lines : undefined
+        const result = await fetchSessionHistory({
+          cwd,
+          session_id,
+          maxLines,
+          logger: ctx.logger,
+        })
+        ctx.client.send({
+          type: "claude.history.response",
+          stream_id,
+          session_id,
+          events: result.events,
+          total_lines: result.total_lines,
+          truncated: result.truncated,
+          error: result.error,
+        })
+        return
+      }
       case "tmux.exec": {
         const args = Array.isArray(msg.args) ? msg.args : []
         const hookResult = await runHookChain(ctx.plugins, "interceptTmuxExec", {