@cocorograph/hub-agent 0.7.30 → 0.7.33

package/src/skills.mjs

@@ -18,6 +18,16 @@ const CLAUDE_DIR = process.env.CLAUDE_DIR || path.join(os.homedir(), ".claude")
 const GLOBAL_SKILLS_DIR = path.join(CLAUDE_DIR, "skills")
 const GLOBAL_COMMANDS_DIR = path.join(CLAUDE_DIR, "commands")
 
+// Cockpit Codex 両対応 Stream A3 (2026-07-02): Codex 側のディレクトリ
+// (`~/.codex/skills/`) は Phase 0 の実機検証で確定済み。CODEX_DIR env override
+// は hub-bundle.mjs / main.mjs の CODEX_DIR と揃える。
+const CODEX_DIR = process.env.CODEX_DIR || path.join(os.homedir(), ".codex")
+const CODEX_GLOBAL_SKILLS_DIR = path.join(CODEX_DIR, "skills")
+
+function skillsDirFor(cliKind) {
+  return cliKind === "codex" ? CODEX_GLOBAL_SKILLS_DIR : GLOBAL_SKILLS_DIR
+}
+
 // Claude Code 組み込みスラッシュコマンド (ファイルから取得できないのでハードコード)
 const BUILT_IN_COMMANDS = [
   { name: "clear", description: "会話履歴をクリア (短期メモリのリセット)", source: "builtin" },
@@ -43,6 +53,14 @@ const BUILT_IN_COMMANDS = [
   { name: "migrate-installer", description: "古い installer から移行", source: "builtin" },
 ]
 
+// Codex Code 組み込みスラッシュコマンド。⚠️ Cockpit Codex 両対応 Stream A3
+// (2026-07-02) 時点では未確定 (故意に空にしている)。`codex --help` で拾えるのは
+// CLI サブコマンド (login/logout/exec/mcp/app-server 等) であり、chat セッション
+// 内のスラッシュコマンド一覧とは別概念。誤った一覧を配信するより空の方が安全
+// (SkillBar は skill 側のみ表示になる)。A5 のライブ検証 (`codex` 対話セッションで
+// 実際に使えるスラッシュコマンドを確認) 後に埋める。
+const CODEX_BUILT_IN_COMMANDS = []
+
 function extractFrontmatter(text) {
   const m = text.match(/^---\s*\n([\s\S]*?)\n---/)
   if (!m) return {}
@@ -118,22 +136,31 @@ async function loadCommandsDir(commandsDir, source) {
 /**
  * skills 全リストを返す。
  *
- * @param {{ sessionName?: string, projectsRoot?: string }} [opts]
+ * @param {{ sessionName?: string, projectsRoot?: string, cliKind?: 'claude'|'codex' }} [opts]
  *   - sessionName が `Dxxxxx_*` 形式なら projectsRoot 配下の同名 dir からも
  *     `.claude/skills/` と `.claude/commands/` を追加で読む
+ *   - cliKind='codex' (Stream A3, 2026-07-02): `~/.codex/skills/` から読む。
+ *     Codex は custom slash command 相当の `commands/` ディレクトリ仕様が
+ *     未確認のため対象外（A5 のライブ検証待ち）。既定 'claude' は完全に従来どおり。
  */
 export async function listSkills(opts = {}) {
+  const cliKind = opts.cliKind === "codex" ? "codex" : "claude"
   const out = []
-  out.push(...BUILT_IN_COMMANDS)
-  out.push(...(await loadSkillsDir(GLOBAL_SKILLS_DIR, "skill")))
-  out.push(...(await loadCommandsDir(GLOBAL_COMMANDS_DIR, "command")))
+  out.push(...(cliKind === "codex" ? CODEX_BUILT_IN_COMMANDS : BUILT_IN_COMMANDS))
+  out.push(...(await loadSkillsDir(skillsDirFor(cliKind), "skill")))
+  if (cliKind === "claude") {
+    out.push(...(await loadCommandsDir(GLOBAL_COMMANDS_DIR, "command")))
+  }
 
   const sessionName = opts.sessionName
   const projectsRoot = opts.projectsRoot || path.join(os.homedir(), "hub", "projects")
   if (sessionName && /^D\d{5}_/.test(sessionName)) {
-    const projectDir = path.join(projectsRoot, sessionName, ".claude")
+    const projectDirName = cliKind === "codex" ? ".codex" : ".claude"
+    const projectDir = path.join(projectsRoot, sessionName, projectDirName)
     out.push(...(await loadSkillsDir(path.join(projectDir, "skills"), "project-skill")))
-    out.push(...(await loadCommandsDir(path.join(projectDir, "commands"), "project-command")))
+    if (cliKind === "claude") {
+      out.push(...(await loadCommandsDir(path.join(projectDir, "commands"), "project-command")))
+    }
   }
 
   // 同名は最初を採用、名前順 sort

package/src/tmux.mjs

@@ -18,6 +18,7 @@ import fs from "node:fs/promises"
 import os from "node:os"
 import path from "node:path"
 import { promisify } from "node:util"
+import { fileURLToPath } from "node:url"
 
 import { ensureClaudeMd } from "./claude-md.mjs"
 import { syncClaudeMdWithHub } from "./claude-md-sync.mjs"
@@ -968,9 +969,30 @@ export function buildFreshCmd(opts = {}) {
 //     ディレクトリ切替で行う (injectCodexHomeEnv)。
 // ---------------------------------------------------------------------------
 
+/**
+ * Cockpit Codex 両対応 Stream A5（2026-07-02 実機検証で確定、中村さん明示承認済み）:
+ * Codex は hooks.json の各 hook エントリごとに `~/.codex/config.toml` の
+ * `[hooks.state]` へ SHA256 ハッシュを信頼登録しないと発火しない（Claude の
+ * settings.json hooks には無い追加の信頼レイヤー）。実機確認: 未信頼の新規 hook を
+ * hooks.json に足して `codex exec` を実行したところ、既存の信頼済み hook は発火
+ * したが新規 hook はエラーも出さず無言でスキップされた。hub-agent が配信する
+ * バンドル hook は Hub という唯一の管理された配信元から来る
+ * （`--dangerously-bypass-hook-trust` のヘルプ文言そのまま
+ * 「automation that already vets hook sources」に該当）ため、常時このフラグを
+ * 付与する（中村さん承認: 「常に --dangerously-bypass-hook-trust フラグを付与して、
+ * 全部信用登録なしでOK」）。`HUB_CODEX_BYPASS_HOOK_TRUST=0` で無効化可能
+ * （対話的な信頼プロンプトに戻したい場合の避難ハッチ）。
+ * @returns {string} 空文字 (無効時) または `"--dangerously-bypass-hook-trust"`
+ */
+function codexHookTrustBypassFlag() {
+  return process.env.HUB_CODEX_BYPASS_HOOK_TRUST !== "0" ? "--dangerously-bypass-hook-trust" : ""
+}
+
 /**
  * agent 設定から codex 起動 flags を組み立てる (純粋関数)。
- * model / sandbox / approvalPolicy / effort のうち指定されたものだけを並べる。
+ * model / sandbox / approvalPolicy / effort のうち指定されたものだけを並べ、
+ * 先頭に常時 `--dangerously-bypass-hook-trust` を付与する
+ * （`codexHookTrustBypassFlag` 参照。無効時は付与しない）。
  * @param {{model?:string,sandbox?:string,approvalPolicy?:string,effort?:string}} [opts]
  * @returns {string}
  */
@@ -980,6 +1002,8 @@ export function composeCodexFlags(opts = {}) {
   const approval = (opts.approvalPolicy || "").trim()
   const effort = (opts.effort || "").trim()
   const flags = []
+  const bypass = codexHookTrustBypassFlag()
+  if (bypass) flags.push(bypass)
   if (model) flags.push(`--model ${model}`)
   if (sandbox) flags.push(`--sandbox ${sandbox}`)
   if (approval) flags.push(`--ask-for-approval ${approval}`)
@@ -992,14 +1016,28 @@ export function composeCodexFlags(opts = {}) {
  * codex 既定起動コマンド (claude の buildClaudeCmd 相当)。
  * hub オプション (model/sandbox/approval/effort) があれば反映、無ければ
  * HUB_CODEX_CMD 環境変数、どちらも無ければ最小デフォルト `codex`。
+ * ⚠️ hub オプション有無に関わらず `--dangerously-bypass-hook-trust` は常時付与する
+ * （hub オプション判定と bypass flag 判定を分離しているため、HUB_CODEX_CMD
+ * 分岐を選んでも bypass flag は付く。詳細は `codexHookTrustBypassFlag` 参照）。
  * @param {{model?:string,sandbox?:string,approvalPolicy?:string,effort?:string}} [opts]
  * @returns {string}
  */
 export function buildCodexCmd(opts = {}) {
-  const flags = composeCodexFlags(opts)
-  if (flags) return `codex ${flags}`.trim()
-  if (process.env.HUB_CODEX_CMD) return process.env.HUB_CODEX_CMD
-  return "codex"
+  const model = (opts.model || "").trim()
+  const sandbox = (opts.sandbox || "").trim()
+  const approval = (opts.approvalPolicy || "").trim()
+  const effort = (opts.effort || "").trim()
+  const hasHubOptions = !!(model || sandbox || approval || effort)
+  const bypass = codexHookTrustBypassFlag()
+
+  if (hasHubOptions) {
+    const flags = composeCodexFlags(opts)
+    return `codex ${flags}`.trim()
+  }
+  if (process.env.HUB_CODEX_CMD) {
+    return `${process.env.HUB_CODEX_CMD}${bypass ? ` ${bypass}` : ""}`.trim()
+  }
+  return bypass ? `codex ${bypass}` : "codex"
 }
 
 /**
@@ -1921,3 +1959,155 @@ export async function rebindClaudeSession(name, sessionId, opts = {}) {
     return { ok: false, error: err?.message || String(err) }
   }
 }
+
+// ---------------------------------------------------------------------------
+// ターミナルミラー (Cockpit Codex 両対応 Stream C, 2026-07-03)
+//
+// 「チャットの動作は変えず、ターミナルのペインは普通に使えるシェルのまま、そこに
+// チャットの会話を実況表示する読み取り専用の子プロセス」をバックグラウンドで起動/
+// 停止する。session-mirror.mjs / bin/hub-agent.mjs の `mirror` サブコマンド参照。
+//
+// 安全設計:
+//   - ペインの前景が plain shell のときだけ起動を許可する（`claude`/`codex` 対話 TUI が
+//     前景にいる状態で send-keys すると、実況コマンドがその対話プロンプトへの入力として
+//     誤解釈されてしまうため）。
+//   - 起動コマンドは `& echo $! > <pidfile>` で直後に PID を記録し、停止はその PID を
+//     kill するだけ（プロセス名 grep 等の曖昧一致はしない）。
+// ---------------------------------------------------------------------------
+
+/** 現在の hub-agent パッケージの `bin/hub-agent.mjs` 絶対パス。node 実行 (`process.execPath`)
+ *  と組み合わせることで、対象ペインの shell の PATH に依存せず確実に起動できる。 */
+function hubAgentBinPath() {
+  return path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "bin", "hub-agent.mjs")
+}
+
+/** POSIX シェルの単一引数として安全な形にクォートする (単純な `'...'` ラップ + `'` エスケープ)。 */
+function shQuote(s) {
+  return `'${String(s).replace(/'/g, "'\\''")}'`
+}
+
+/** ミラーの pidfile パス (セッション名ごとに 1 つ)。 */
+function mirrorPidFile(sessionName) {
+  return path.join(os.tmpdir(), `hub-agent-mirror-${sanitizeTmuxName(sessionName)}.pid`)
+}
+
+/**
+ * ミラー起動用の send-keys コマンド文字列を組み立てる (純粋関数)。
+ *
+ * @param {{cwd: string, sessionId: string, cliKind: 'claude'|'codex', sessionName: string}} args
+ * @returns {string}
+ * @throws sessionId が安全形でなければ throw (コマンド注入防止、buildResumeCmd と同方針)
+ */
+export function buildMirrorStartCmd({ cwd, sessionId, cliKind, sessionName }) {
+  if (!isSafeSessionId(sessionId)) {
+    throw new Error(`unsafe session_id for mirror: ${String(sessionId)}`)
+  }
+  const kind = cliKind === "codex" ? "codex" : "claude"
+  const bin = hubAgentBinPath()
+  const pidFile = mirrorPidFile(sessionName)
+  const args = [
+    shQuote(process.execPath),
+    shQuote(bin),
+    "mirror",
+    "--cwd",
+    shQuote(cwd),
+    "--session",
+    shQuote(sessionId),
+    "--cli-kind",
+    kind,
+  ].join(" ")
+  return `${args} & echo $! > ${shQuote(pidFile)}; disown`
+}
+
+/** ミラー停止用の send-keys コマンド文字列を組み立てる (純粋関数)。 */
+export function buildMirrorStopCmd({ sessionName }) {
+  const pidFile = mirrorPidFile(sessionName)
+  return `kill $(cat ${shQuote(pidFile)} 2>/dev/null) 2>/dev/null; rm -f ${shQuote(pidFile)}`
+}
+
+/**
+ * 対象ペインの前景が plain shell か判定する (`isPaneRunningClaude` の逆方向・保守版)。
+ * 判定不能 (tmux 失敗等) は false を返す = 起動を許可しない安全側。
+ *
+ * @param {string} name
+ * @param {{ tmux?: string }} [opts]
+ * @returns {Promise<boolean>}
+ */
+export async function isPaneAtShellPrompt(name, opts = {}) {
+  if (!name) return false
+  try {
+    const { stdout } = await execFileP(tmuxBin(opts), [
+      "display-message",
+      "-p",
+      "-t",
+      `${name}:`,
+      "-F",
+      "#{pane_current_command}",
+    ])
+    const cmd = (stdout || "").trim().toLowerCase()
+    const SHELLS = new Set(["fish", "bash", "zsh", "sh", "dash"])
+    return SHELLS.has(cmd)
+  } catch {
+    return false
+  }
+}
+
+/**
+ * ターミナルミラーを対象ペインで起動する。ペイン前景が plain shell のときのみ許可する
+ * (対話 TUI が前景にいる状態での誤爆入力を防ぐ)。
+ *
+ * @param {string} name tmux セッション名
+ * @param {{cwd: string, sessionId: string, cliKind: 'claude'|'codex'}} args
+ * @param {{ tmux?: string, logger?: import('pino').Logger }} [opts]
+ * @returns {Promise<{ ok: boolean, reason?: string, error?: string }>}
+ */
+export async function startTerminalMirror(name, { cwd, sessionId, cliKind }, opts = {}) {
+  if (!isSafeSessionName(name)) {
+    return { ok: false, error: "unsafe session name" }
+  }
+  const atShell = await isPaneAtShellPrompt(name, opts)
+  if (!atShell) {
+    return {
+      ok: false,
+      reason: "pane-not-at-shell",
+      error: "ペインが対話 TUI 実行中のためミラーを起動できません (シェルに戻ってから再試行してください)",
+    }
+  }
+  let cmd
+  try {
+    cmd = buildMirrorStartCmd({ cwd, sessionId, cliKind, sessionName: name })
+  } catch (err) {
+    return { ok: false, error: err?.message || String(err) }
+  }
+  try {
+    await execFileP(tmuxBin(opts), ["send-keys", "-t", name, cmd, "Enter"])
+    opts.logger?.info({ session: name, cliKind, sessionId }, "terminal mirror started")
+    return { ok: true }
+  } catch (err) {
+    opts.logger?.warn({ session: name, err: err?.message }, "terminal mirror start failed")
+    return { ok: false, error: err?.message || String(err) }
+  }
+}
+
+/**
+ * ターミナルミラーを対象ペインで停止する。pidfile に記録された PID を kill するだけの
+ * ベストエフォート (既に停止済み/pidfile 無しでもエラーにしない)。
+ *
+ * @param {string} name tmux セッション名
+ * @param {{ tmux?: string, logger?: import('pino').Logger }} [opts]
+ * @returns {Promise<{ ok: boolean, error?: string }>}
+ */
+export async function stopTerminalMirror(name, opts = {}) {
+  if (!isSafeSessionName(name)) {
+    return { ok: false, error: "unsafe session name" }
+  }
+  const cmd = buildMirrorStopCmd({ sessionName: name })
+  try {
+    await execFileP(tmuxBin(opts), ["send-keys", "-t", name, cmd, "Enter"])
+    opts.logger?.info({ session: name }, "terminal mirror stop requested")
+    return { ok: true }
+  } catch (err) {
+    opts.logger?.warn({ session: name, err: err?.message }, "terminal mirror stop failed")
+    return { ok: false, error: err?.message || String(err) }
+  }
+}

package/src/usage.mjs

@@ -1152,9 +1152,13 @@ export async function getUsage() {
   // チャット(SDK) の rate_limit_event が statusLine cache より新しければ、5h/7d を
   // その実値 (utilization) で上書きする。ターミナルが statusLine を更新していない
   // チャットモードでも 5h/7d がライブで動くようになる。
+  // `>=` (2026-07-03): ファイル mtime はミリ秒未満の粒度が丸められる環境があり、
+  // 同一ミリ秒 (またはそれ以下) の解像度で statusLine 書き込みと rate_limit_event が
+  // 揃うとタイになり得る。プロセス内の直近イベント (chatRateLimits) の方が
+  // ディスク read-back より鮮度の情報として確実なため、タイ時は上書きを優先する。
   if (
     chatRateLimits.updatedAtMs > 0 &&
-    (cacheMtime === null || chatRateLimits.updatedAtMs > cacheMtime)
+    (cacheMtime === null || chatRateLimits.updatedAtMs >= cacheMtime)
   ) {
     if (chatRateLimits.five_hour) {
       result.last5h = {
@@ -1183,7 +1187,9 @@ export async function getUsage() {
   const chatSnap = await readChatUsageSnapshot()
   if (chatSnap && chatSnap.updatedAtMs > 0) {
     const baseline = Math.max(cacheMtime ?? 0, chatRateLimits.updatedAtMs || 0)
-    if (chatSnap.updatedAtMs > baseline) {
+    // `>=` (上と同じ理由): ファイル mtime とプロセス内タイムスタンプがタイになり得る。
+    // chatSnap は最も直接的な情報源 (SDK control request 実値) なのでタイ時は優先する。
+    if (chatSnap.updatedAtMs >= baseline) {
       if (chatSnap.five_hour) {
         result.last5h = {
           ...result.last5h,
@@ -1250,3 +1256,197 @@ export async function getSessionUsages() {
   )
   return out
 }
+
+// ---------------------------------------------------------------------------
+// Codex 版 usage 集計 (Cockpit Codex 両対応 Stream B3, 2026-07-03 設計)。
+//
+// Claude は 5h/7d を「statusLine cache」(TUI) / 「SDK control request」(chat) の
+// 2 経路で取得し、context% は jsonl の assistant.usage を手集計していた。
+//
+// Codex は rollout jsonl (`~/.codex/sessions/Y/M/D/rollout-<ts>-<threadId>.jsonl`)
+// に書かれる `event_msg` (`payload.type === "token_count"`) 1 イベントだけで、
+// context 算出用のトークン数・context_window サイズ・5h/7d 相当の rate_limits
+// (used_percent 済み) の**すべて**が完成品で手に入ることを実機ライブ検証
+// (2026-07-03) で確認済み (実サンプルは正本プラン参照)。TUI モード (bare pane) も
+// chat モード (app-server 駆動、`thread/resume` が rollout から復元する設計 = 動作中
+// ずっと rollout へ書き続けている) も同じ 1 本のロジックで読める。
+//
+// ファイル特定: Claude は cwd を dir 名にエンコードして直接対応するが、Codex の
+// rollout は日付シャードで cwd 直接対応が無い。ファイル名に埋め込まれた threadId
+// (呼び出し側が attach()/bound session 解決から持っている) で glob 検索する。
+// ---------------------------------------------------------------------------
+
+function codexSessionsDir() {
+  return configPath("HUB_CODEX_SESSIONS_DIR", os.homedir(), ".codex", "sessions")
+}
+
+// rate_limits.primary/secondary が無いときの limit は「% 表示のみ」の意味で 100 固定
+// (Claude の readOfficial の bucketize と同じ約束事)。
+const CODEX_DEFAULT_LIMIT = 100
+
+/** threadId から rollout jsonl の絶対パスを検索する（日付シャード配下、直近 N 日のみ走査）。
+ *  7d 窓 + バッファで 9 日分を既定にする（月またぎでも大抵 1〜2 ディレクトリの readdir で済む）。
+ *  `session-mirror.mjs`（Stream C ターミナルミラー）からも再利用するため export する。
+ *  @returns {Promise<string|null>}
+ */
+export async function findCodexRolloutFile(threadId, { lookbackDays = 9, now = Date.now() } = {}) {
+  if (!threadId) return null
+  const base = codexSessionsDir()
+  for (let i = 0; i < lookbackDays; i++) {
+    const d = new Date(now - i * 24 * 60 * 60 * 1000)
+    const y = String(d.getFullYear())
+    const m = String(d.getMonth() + 1).padStart(2, "0")
+    const day = String(d.getDate()).padStart(2, "0")
+    const dir = path.join(base, y, m, day)
+    const files = await fs.readdir(dir).catch(() => null)
+    if (!files) continue
+    const match = files.find((f) => f.endsWith(`-${threadId}.jsonl`))
+    if (match) return path.join(dir, match)
+  }
+  return null
+}
+
+/** P5(perf): rollout ファイルの token_count 抽出結果を mtime+size でメモ化。 */
+const _codexTokenCountMemo = new Map() // fp → { mtimeMs, size, result }
+
+/**
+ * 単一 rollout jsonl から末尾（最新）の `token_count` event_msg を 1 件取り出す。
+ * 末尾 tail で見つからない稀なケース（token_count 未着のセッション冒頭等）のみ
+ * 全文フォールバックする（Claude 側 `latestJsonlContext`/`turnActiveForCwd` と同じ
+ * tail-first パターン）。見つからなければ null。
+ *
+ * @returns {Promise<{payload: object, ts: number|null}|null>}
+ */
+async function latestTokenCountFromRollout(fp) {
+  let st
+  try {
+    st = await fs.stat(fp)
+  } catch {
+    return null
+  }
+  const memo = _codexTokenCountMemo.get(fp)
+  if (memo && memo.mtimeMs === st.mtimeMs && memo.size === st.size) {
+    return memo.result
+  }
+  const scan = (text) => {
+    const lines = text.split("\n")
+    for (let i = lines.length - 1; i >= 0; i--) {
+      const line = lines[i]
+      if (!line || !line.includes('"token_count"')) continue
+      let d
+      try {
+        d = JSON.parse(line)
+      } catch {
+        continue
+      }
+      if (d.type !== "event_msg") continue
+      const payload = d.payload
+      if (!payload || payload.type !== "token_count") continue
+      return { payload, ts: parseEntryTs(d.timestamp) }
+    }
+    return null
+  }
+  let result = null
+  const tail = await readTail(fp, 64 * 1024)
+  if (tail != null) result = scan(tail)
+  if (!result) {
+    const full = await readOrNull(fp)
+    if (full != null) result = scan(full)
+  }
+  _codexTokenCountMemo.set(fp, { mtimeMs: st.mtimeMs, size: st.size, result })
+  return result
+}
+
+/** テスト用: codex token_count メモをクリアする。 */
+export function _resetCodexTokenCountMemo() {
+  _codexTokenCountMemo.clear()
+}
+
+/**
+ * 指定 threadId の Codex セッションから usage (5h/7d + context%) を返す。
+ * Claude の `getUsage()` と同じ shape (`UsageStats`) を返すため、frontend / wire
+ * protocol の分岐を増やさずに済む。
+ *
+ * ⚠️ `last5h`/`last7d` は Codex 側アカウント全体の rate limit（ChatGPT/OpenAI
+ * サブスクリプション）であり、Claude の `last5h`/`last7d`（Anthropic サブスク）とは
+ * **別契約の別数値**。呼び出し側で Claude usage と単純合算/上書きしないこと
+ * （どちらのアカウントの残量か分からなくなる）。
+ *
+ * @param {string} threadId
+ * @returns {Promise<import("./usage.mjs").UsageStats|null>} 見つからなければ null
+ */
+export async function codexUsageForThread(threadId) {
+  if (!threadId) return null
+  const fp = await findCodexRolloutFile(threadId)
+  if (!fp) return null
+  const found = await latestTokenCountFromRollout(fp)
+  if (!found) return null
+  const info = found.payload.info
+  const rateLimits = found.payload.rate_limits
+
+  let contextPercent = null
+  const totalTok = info?.total_token_usage
+  const windowSize = info?.model_context_window
+  if (totalTok && typeof windowSize === "number" && windowSize > 0) {
+    const tokens =
+      typeof totalTok.total_tokens === "number"
+        ? totalTok.total_tokens
+        : (totalTok.input_tokens || 0) +
+          (totalTok.cached_input_tokens || 0) +
+          (totalTok.output_tokens || 0)
+    contextPercent = Math.min(100, Math.round((tokens / windowSize) * 1000) / 10)
+  }
+
+  const bucketize = (w) => {
+    if (!w || typeof w.used_percent !== "number") return emptyBucket(CODEX_DEFAULT_LIMIT)
+    let resetMs = null
+    if (typeof w.resets_at === "number") {
+      resetMs = w.resets_at < 1e12 ? w.resets_at * 1000 : w.resets_at
+    }
+    return {
+      tokens: 0,
+      messages: 0,
+      limit: CODEX_DEFAULT_LIMIT,
+      percent: w.used_percent,
+      oldestTsMs: null,
+      resetAtMs: resetMs,
+    }
+  }
+
+  return {
+    plan: rateLimits?.plan_type || "codex",
+    computedAt: Date.now(),
+    source: rateLimits ? "official" : "estimate",
+    context: contextPercent,
+    last5h: bucketize(rateLimits?.primary),
+    last7d: bucketize(rateLimits?.secondary),
+  }
+}
+
+/**
+ * 複数の Codex セッション (threadId + cwd + sessionId) から `SessionUsageEntry[]`
+ * (Claude の `getSessionUsages()` と同 shape) を返す。見つからなかった/context 不明な
+ * セッションは結果から除外する (Claude 版と同じ「分かるものだけ返す」約束)。
+ *
+ * @param {Array<{sessionId: string, cwd: string, threadId: string}>} liveSessions
+ * @returns {Promise<Array<{sessionId: string, cwd: string, contextPercent: number, updatedAtMs: number}>>}
+ */
+export async function codexSessionUsages(liveSessions) {
+  if (!Array.isArray(liveSessions) || liveSessions.length === 0) return []
+  const now = Date.now()
+  const out = []
+  await Promise.all(
+    liveSessions.map(async ({ sessionId, cwd, threadId }) => {
+      if (!threadId || !cwd) return
+      const usage = await codexUsageForThread(threadId)
+      if (!usage || typeof usage.context !== "number") return
+      out.push({
+        sessionId: sessionId || threadId,
+        cwd,
+        contextPercent: usage.context,
+        updatedAtMs: now,
+      })
+    }),
+  )
+  return out
+}