@cocorograph/hub-agent 0.8.114 → 0.8.115

package/src/session-names.mjs

@@ -10,6 +10,7 @@
  * ## 規約 (2026-07-09 確定)
  *   claude → `<dir>`            (後方互換。既存セッションはそのまま claude として解釈される)
  *   codex  → `<dir>__codex`     (予約サフィックス)
+ *   grok   → `<dir>__grok`      (予約サフィックス)
  *
  * `__codex` を予約サフィックスに選べる根拠 (Phase0 スパイク済み):
  *   - frontend の `sanitizeSessionName` は `.` `:` のみ `-` へ置換し、`_` は保持する
@@ -17,19 +18,25 @@
  *
  * ## 不変条件
  *   - `sessionNameFor(baseSessionName(n), cliKindForSessionName(n)) === n`  (往復同一)
- *   - `cliKindForSessionName` は「末尾が `__codex` か」だけで決まる純関数。tmux / 設定 /
+ *   - `cliKindForSessionName` は「末尾の予約サフィックス」だけで決まる純関数。tmux / 設定 /
  *     ブリッジの状態を一切参照しない。これが「セッション行の CLI 種別を 1 箇所だけ見れば
  *     済む」ための SoT である。
  *
+ * backend 側の対応実装は `backend/apps/cockpit/session_names.py`。
  * frontend 側の対応実装は `frontend/lib/cockpit/sessionKey.ts` (同じ規約を TypeScript で再掲)。
- * どちらかを変更したら必ず両方揃えること。
+ * 変更時は backend / frontend / agent の規約を揃えること。
  */
 
+const SESSION_SUFFIXES = { claude: "", codex: "__codex", grok: "__grok" }
+
 /** codex セッションを表す予約サフィックス。 */
-export const CODEX_SESSION_SUFFIX = "__codex"
+export const CODEX_SESSION_SUFFIX = SESSION_SUFFIXES.codex
+
+/** grok セッションを表す予約サフィックス。 */
+export const GROK_SESSION_SUFFIX = SESSION_SUFFIXES.grok
 
 /** 有効な cli_kind。 */
-const VALID_CLI_KINDS = new Set(["claude", "codex"])
+const VALID_CLI_KINDS = new Set(Object.keys(SESSION_SUFFIXES))
 
 /**
  * 任意の入力を cli_kind へ正規化する。未知値 / null / undefined は "claude" (既定 CLI)。
@@ -39,7 +46,7 @@ const VALID_CLI_KINDS = new Set(["claude", "codex"])
  * 方が退行が小さい (claude が圧倒的多数のセッション)。
  *
  * @param {unknown} value
- * @returns {'claude'|'codex'}
+ * @returns {'claude'|'codex'|'grok'}
  */
 export function normalizeCliKind(value) {
   return VALID_CLI_KINDS.has(value) ? value : "claude"
@@ -49,11 +56,14 @@ export function normalizeCliKind(value) {
  * tmux セッション名からその行の CLI 種別を導出する (構造的判定)。
  *
  * @param {string} sessionName
- * @returns {'claude'|'codex'}
+ * @returns {'claude'|'codex'|'grok'}
  */
 export function cliKindForSessionName(sessionName) {
   if (typeof sessionName !== "string") return "claude"
-  return sessionName.endsWith(CODEX_SESSION_SUFFIX) ? "codex" : "claude"
+  for (const [kind, suffix] of Object.entries(SESSION_SUFFIXES)) {
+    if (suffix && sessionName.endsWith(suffix)) return kind
+  }
+  return "claude"
 }
 
 /**
@@ -65,15 +75,14 @@ export function cliKindForSessionName(sessionName) {
  */
 export function baseSessionName(sessionName) {
   if (typeof sessionName !== "string") return ""
-  return sessionName.endsWith(CODEX_SESSION_SUFFIX)
-    ? sessionName.slice(0, -CODEX_SESSION_SUFFIX.length)
-    : sessionName
+  const suffix = SESSION_SUFFIXES[cliKindForSessionName(sessionName)]
+  return suffix ? sessionName.slice(0, -suffix.length) : sessionName
 }
 
 /**
  * dir 名 (ベース名) と cli_kind から tmux セッション名を組み立てる。
  *
- * 既に `__codex` が付いたベース名を渡しても二重付与しない (冪等)。
+ * 既に `__codex` / `__grok` が付いたベース名を渡しても二重付与しない (冪等)。
  *
  * @param {string} dir
  * @param {unknown} cliKind
@@ -82,5 +91,5 @@ export function baseSessionName(sessionName) {
 export function sessionNameFor(dir, cliKind) {
   const base = baseSessionName(String(dir || ""))
   if (!base) return ""
-  return normalizeCliKind(cliKind) === "codex" ? `${base}${CODEX_SESSION_SUFFIX}` : base
+  return `${base}${SESSION_SUFFIXES[normalizeCliKind(cliKind)]}`
 }

package/src/sibling-inject.mjs

@@ -337,7 +337,7 @@ function claudeCandidatesNameability(candidates) {
  * 「hint 用」「フィールド用」「エラーコード用」と 3 回呼ぶ形にすると将来ずれるので、1 つの判定から
  * 全部を組み立てて構造的に食い違えないようにしている。
  *
- * @param {string} cliKind 宛先 CLI ("codex" | "claude")
+ * @param {string} cliKind 宛先 CLI ("codex" | "claude" | "grok")
  * @param {string} [targetSessionId] 明示宛先で指定された id (省略 = 宛先省略の曖昧)
  * @param {object[]} [candidates] 曖昧になった候補一覧 (claude の名指し可否判定に使う)
  * @returns {{error: string, hint: string, candidates_nameable: boolean}}
@@ -348,15 +348,16 @@ function ambiguousTargetOutcome(cliKind, targetSessionId, candidates) {
   // codex は候補ごとに必ず一意な接続 ID (stream_id) を持つため、候補を見るまでもなく名指しで
   // 解消できる (既定の宛先は会話 ID = thread_id だが、同じ会話に複数の接続がぶら下がると会話 ID
   // では一意に定まらない。そのときに接続 ID で絞り込む、という降格した位置づけ)。
-  const nameability = cliKind === "codex" ? "nameable" : claudeCandidatesNameability(candidates)
+  const streamAddressable = cliKind === "codex" || cliKind === "grok"
+  const nameability = streamAddressable ? "nameable" : claudeCandidatesNameability(candidates)
   const nameable = nameability === "nameable"
   const lead = targetSessionId
-    ? cliKind === "codex"
+    ? streamAddressable
       ? `指定した id (${targetSessionId}) はこの cwd で複数の live セッションに一致します。`
       : `指定した session_id (${targetSessionId}) がこの cwd で複数の live セッションに一致します。`
     : `この cwd には live な ${cliKind} セッションが複数あるため、宛先を省略すると一意に定まりません。`
   let remedy
-  if (cliKind === "codex") {
+  if (streamAddressable) {
     // ⚠️ 「stream_id を指定」とだけ案内しない (2026-08-05)。--list / --list-all が既定で表示する
     //    宛先は **会話 ID (thread_id)** で、stream_id は「同じ会話に複数の接続がある稀なケース」の
     //    曖昧解消用へ降格した。利用者が画面で見ているのは --list が候補に併記する `stream=…` の
@@ -426,7 +427,7 @@ function queuedResult(r) {
 
 export class SiblingInjectBridge {
   /**
-   * @param {{dir?: string, claudeBridge?: object, codexBridge?: object, logger?: object,
+   * @param {{dir?: string, claudeBridge?: object, codexBridge?: object, grokBridge?: object, logger?: object,
    *   now?: () => number, processKill?: (pid: number, signal: number) => void,
    *   pidStartedAt?: (pid: number) => Promise<string>, onRestartRequested?: () => object,
    *   isInputBlocked?: () => boolean, watchFn?: typeof watch}} [opts]
@@ -435,6 +436,7 @@ export class SiblingInjectBridge {
     dir = SIBLING_REQUESTS_DIR,
     claudeBridge,
     codexBridge,
+    grokBridge,
     logger,
     now = Date.now,
     processKill = process.kill.bind(process),
@@ -447,6 +449,7 @@ export class SiblingInjectBridge {
     this.dir = dir
     this.claudeBridge = claudeBridge
     this.codexBridge = codexBridge
+    this.grokBridge = grokBridge
     this.logger = logger
     /** @type {Set<string>} 二重処理防止 (request_id) */
     this._seen = new Set()
@@ -679,7 +682,7 @@ export class SiblingInjectBridge {
    * 経由し、`tmux.list_sessions` の `warm` と同じ判定を共有する。
    */
   _bridges() {
-    return { claudeBridge: this.claudeBridge, codexBridge: this.codexBridge }
+    return { claudeBridge: this.claudeBridge, codexBridge: this.codexBridge, grokBridge: this.grokBridge }
   }
 
   async replayReviews(kind, cwd, sessionId) {
@@ -901,7 +904,7 @@ export class SiblingInjectBridge {
     const hasRequestAck = Object.prototype.hasOwnProperty.call(body || {}, "request_ack")
     const isRestart = op === "restart"
     let result
-    const badKind = target_cli_kind !== "claude" && target_cli_kind !== "codex"
+    const badKind = !["claude", "codex", "grok"].includes(target_cli_kind)
     const delegatePhases = new Set(["started", "completed", "failed", "stopped"])
     const badDelegateBody =
       typeof delegation_id !== "string" ||
@@ -992,7 +995,8 @@ export class SiblingInjectBridge {
           )
         }
       }
-      const bridge = target_cli_kind === "codex" ? this.codexBridge : this.claudeBridge
+      const bridge = target_cli_kind === "grok" ? this.grokBridge
+        : target_cli_kind === "codex" ? this.codexBridge : this.claudeBridge
       if (isReviewEvent) {
         const matches = describeLiveSessionsUnion(this._bridges(), { cwd, cliKind: target_cli_kind })
           .filter((s) => (target_cli_kind === "codex" ? s.thread_id : s.session_id) === target_session_id)

package/src/ws-client.mjs

@@ -74,6 +74,16 @@ const BUFFERED_CTRL_TYPES = new Set([
   "claude.permission.cancel",
   "claude.input.ack",
   "claude.input.nack",
+  "grok.event",
+  "grok.ready",
+  "grok.exit",
+  "grok.error",
+  "grok.permission.request",
+  // 破棄の通知も保存し、再接続後に要求より先に届いて取消済みの承認が復活するのを防ぐ。
+  "grok.permission.cancelled",
+  "grok.input.ack",
+  "grok.input.nack",
+  "grok.turn.complete",
   "codex.event",
   "codex.ready",
   "codex.exit",
@@ -110,6 +120,19 @@ function isEphemeralCodexDeltaEvent(obj) {
   return typeof method === "string" && method.toLowerCase().endsWith("/delta")
 }
 
+/** Grok ACP の本文 chunk（応答・思考・利用者発話）。高頻度で、切断中に積むと共有リングの
+ *  承認要求・ACK を押し出す。捨てた分は grok.ready の history（seq 付き）で復元する前提で、
+ *  browser は seq の欠番、または turn.complete / exit / error の last_seq が受信済み seq より大きいとき
+ *  再 attach して history を取り直す（末尾の欠落は後続 update が無いので last_seq でしか分からない）。
+ *  ⚠️ last_seq 付きの終端 frame もこのバッファの 30 秒期限で落ちうる。30 秒を超える切断の復元は
+ *  バッファに頼らず、Codex と同じく backend が全タブへ送る agent.status online を受けた browser が
+ *  同じ attach_id で再 attach し、grok.ready の history / last_seq で取り直す（useCockpitCodexStream の
+ *  agent.status 処理と同じ契約。Grok の画面側でも同じ処理を持つこと）。 */
+const GROK_CHUNK_UPDATES = new Set(["agent_message_chunk", "agent_thought_chunk", "user_message_chunk"])
+function isEphemeralGrokChunkEvent(obj) {
+  return GROK_CHUNK_UPDATES.has(obj?.event?.sessionUpdate)
+}
+
 export class WsClient extends EventEmitter {
   get bufferedAmount() {
     return this.ws?.readyState === WebSocket.OPEN ? this.ws.bufferedAmount : null
@@ -331,6 +354,9 @@ export class WsClient extends EventEmitter {
         if (type === "codex.event" && isEphemeralCodexDeltaEvent(obj)) {
           return false
         }
+        if (type === "grok.event" && isEphemeralGrokChunkEvent(obj)) {
+          return false
+        }
         this._bufferCtrl(obj)
         return false
       }