@cocorograph/hub-agent 0.8.9 → 0.8.11

package/package.json

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

package/src/claude-history.mjs

@@ -664,7 +664,13 @@ function takeTextsFromLine(line, user, assistant) {
   return { user, assistant }
 }
 
-export async function extractLastTurnTexts(filePath) {
+/**
+ * @param {string} filePath 対象 jsonl
+ * @param {{ isInjected?: (text: string) => Promise<boolean> | boolean }} [opts]
+ *   注入と判定した user ターンは、そのターンの assistant も含めて飛ばす。
+ */
+export async function extractLastTurnTexts(filePath, opts = {}) {
+  const isInjected = typeof opts.isInjected === "function" ? opts.isInjected : null
   let handle
   try {
     handle = await open(filePath, "r")
@@ -716,11 +722,26 @@ export async function extractLastTurnTexts(filePath) {
           continue
         }
         const res = takeTextsFromLine(lineBuf.toString("utf-8"), user, assistant)
+        if (isInjected && res.user && !user) {
+          let injected = false
+          try {
+            injected = (await isInjected(res.user)) === true
+          } catch {
+            // 注入判定の障害で通常の依頼まで消さない。
+          }
+          if (injected) {
+            // 後方走査中の assistant はこの注入 user より後ろ、つまり同じ注入ターンの
+            // 応答候補。依頼だけでなく応答も捨てて、更に前の自分のターンを探す。
+            user = ""
+            assistant = ""
+            continue
+          }
+        }
         user = res.user
         assistant = res.assistant
-        if (user && assistant) break
+        if (isInjected ? Boolean(user) : user && assistant) break
       }
-      if (user && assistant) break
+      if (isInjected ? Boolean(user) : user && assistant) break
       if (skipped > LAST_TURN_MAX_SKIPPED_LINES) break
 
       if (carry && carry.length > LAST_TURN_MAX_LINE) {

package/src/claude-stream-bridge.mjs

@@ -523,11 +523,11 @@ export class ClaudeStreamSession {
     this._permissionResolvers = new Map()
     /** 現在ターン実行中か (多重 query 防止) */
     this._busy = false
-    /** SDK-P0-3 (2026-07-10): 現ターンが既に終端処理済みか (result / idle / abort の
+    /** SDK-P0-3 (2026-07-10): 現ターンが既に終端処理済みか (idle / abort の
      *  いずれか 1 回だけ _busy=false + drain させるための冪等ガード)。resident query は
-     *  1 ターンにつき `result` と `session_state_changed:idle` の**両方**が流れうるため、
-     *  素朴に両方で drain すると二重 drain (FIFO 崩れ) を起こす。ターン開始時
-     *  (_beginResidentTurn) に false へ戻す。 */
+     *  `result` の後にもバックグラウンド処理が続き、最後に権威的な
+     *  `session_state_changed:idle` が流れる。通常完了では idle だけが settle し、
+     *  明示 interrupt だけが先行して settled を立てる。ターン開始時に false へ戻す。 */
     this._turnSettled = false
     /** SDK-P0-3: 現ターンが 1 件でもストリームイベントを出したか。
      *  「前ターンの遅延 idle が、drain で始まったばかりの次ターンを誤終了させる」レースの
@@ -539,9 +539,9 @@ export class ClaudeStreamSession {
     this._turnProgressed = false
     /** SDK-P0-4 (2026-07-13): ターン連番。ログと帰属デバッグ用 (_beginResidentTurn で ++)。 */
     this._turnSeq = 0
-    /** SDK-P0-4: 「直前ターンの idle がこれから 1 件届きうる」状態。result で settle したとき、
-     *  および abort (interrupt) でターンを畳んだときに arm する (SDK は result → idle の順で
-     *  流し、interrupt 後にも中断ターンの idle を流すため)。arm 中に届いた idle は
+    /** SDK-P0-4: 「直前ターンの idle がこれから 1 件届きうる」状態。abort (interrupt) で
+     *  ターンを先行して畳んだときに arm する (interrupt 後にも中断ターンの idle が流れるため)。
+     *  通常完了は idle 自身で畳むので arm しない。arm 中に届いた idle は
      *  **前ターンのもの**として 1 件だけ握り潰し、現ターンを終端しない。
      *  解除条件: (a) idle を 1 件消費した (b) SDK の running が届いた (= 前ターンの全イベントは
      *  順序保証により既に通過済み) (c) 現ターンの result が届いた (d) STALE_IDLE_GUARD_MS 経過。 */
@@ -1131,9 +1131,10 @@ export class ClaudeStreamSession {
     this._busy = true
     this._abortController = new AbortController()
     let aborted = false
-    // RC-4: このターンで SDK の result イベントが届いたか。届かずに終わった
-    // (abort / 異常終了) ときだけ onTurnSettled でチャット信号を waiting へ落とす。
+    // `session_state_changed:idle` がターン終了の正本。SDK が idle を流さず generator が
+    // 閉じた旧/異常経路だけ合成 idle と onTurnSettled で waiting へ落とす。
     let resultDelivered = false
+    let idleDelivered = false
 
     const options = {
       cwd: this.cwd,
@@ -1185,6 +1186,7 @@ export class ClaudeStreamSession {
           resultDelivered = true
           if (typeof msg.session_id === "string") this.sessionId = msg.session_id
         }
+        if (isSessionIdleEvent(msg)) idleDelivered = true
         try {
           this._emit(msg)
         } catch (err) {
@@ -1224,12 +1226,9 @@ export class ClaudeStreamSession {
       if (aborted) {
         this.logger?.info({ stream_id: this.stream_id }, "claude turn aborted")
       }
-      // RC-4: result を届けずにターンが終わった (abort / 異常終了) 場合、チャット信号の
-      // status=processing が解除されず三点リーダー/ステータスドットが TTL まで固着する。
-      // ターン確定として onTurnSettled を呼び processing→waiting へ落とす。正常完了は
-      // result が既に waiting にしているので !resultDelivered のときだけ。_drainPending で
-      // 次ターン (processing) が始まる前に呼ぶこと (順序: ここ → reap/drain)。
-      if (!resultDelivered) {
+      // RC-4: idle を届けずに generator が閉じた旧/異常経路では、チャット信号と browser の
+      // 双方へ同じ終了境界を補う。_drainPending で次ターンを始める前に行うこと。
+      if (!idleDelivered) {
         try {
           this.onTurnSettled?.()
         } catch {
@@ -1244,11 +1243,24 @@ export class ClaudeStreamSession {
         // フッターで表示する)。uuid を持たせるのは重複排除 (isDuplicateEvent) が result
         // 署名 (session_id + num_turns + duration_ms + cost) で判定するため — 合成 result
         // はこれらが毎回同値になり、2 回目以降の中断で「重複」と誤判定され捨てられるのを防ぐ。
+        if (!resultDelivered) {
+          try {
+            this._emit({
+              type: "result",
+              subtype: aborted ? "aborted_by_user" : "turn_settled",
+              uuid: randomUUID(),
+              session_id: this.sessionId ?? undefined,
+              timestamp: new Date().toISOString(),
+            })
+          } catch {
+            /* ignore */
+          }
+        }
         try {
           this._emit({
-            type: "result",
-            subtype: aborted ? "aborted_by_user" : "turn_settled",
-            uuid: randomUUID(),
+            type: "system",
+            subtype: "session_state_changed",
+            state: "idle",
             session_id: this.sessionId ?? undefined,
             timestamp: new Date().toISOString(),
           })
@@ -1618,10 +1630,10 @@ export class ClaudeStreamSession {
     }
   }
 
-  /** SDK-P0-3 (2026-07-10): resident の「ターン終端」を 1 箇所に集約する (result / idle 共通)。
-   *  同一ターンで 2 回以上呼ばれても最初の 1 回しか作用しない (_turnSettled ガード)。
-   *  これにより `result` → `idle` の順で両方届く通常ケースでも drain は 1 回だけになる。
-   *  @param {string} reason "result" | "idle" — ログ用
+  /** resident の権威的な「ターン終端」を 1 箇所に集約する。
+   *  通常完了は SDK の session_state_changed:idle だけが呼ぶ。result は最終結果の
+   *  flush であり、バックグラウンド処理を含むターン全体の終了境界ではない。
+   *  @param {string} reason "idle" — ログ用
    *  @param {(msg: string) => void} [denyPending] 未解決 permission を閉じるクロージャ
    */
   _settleResidentTurn(reason, denyPending) {
@@ -1629,11 +1641,6 @@ export class ClaudeStreamSession {
     this._turnSettled = true
     denyPending?.("turn ended")
     this._busy = false
-    // SDK-P0-4: result で畳んだターンは、この後に自分の idle を必ず 1 件流す
-    // (sdk.d.ts: "'idle' fires after heldBackResult flushes … authoritative turn-over signal")。
-    // drain が同期で次ターンを開始するため、その idle が新ターンに誤帰属しないようガードを張る。
-    // idle 自身で畳んだ場合は既にその idle を消費済みなので張らない。
-    if (reason === "result") this._armStaleIdleGuard()
     // 改修4 (A): シリアライズした pending があれば次の 1 件を InputQueue へ流す。
     // ultracode (0.6.28): _drainResidentPending は applyFlagSettings を await するため
     // async。for await ループ内からは fire-and-forget で呼ぶ (最初の await より前に
@@ -1649,7 +1656,7 @@ export class ClaudeStreamSession {
   /** 改修4 (A): ターン完了時に pending の先頭 1 件を InputQueue へ流す (ターンのシリアライズ)。
    *  queue_state を更新して送信待ちチップを drain させる (frontend がバブル昇格する)。
    *  ultracode (0.6.28): 次ターンの目標 ultracode 状態へ reconcile してから push する
-   *  (await するため async 化。result ハンドラからは fire-and-forget で呼ばれる)。 */
+   *  (await するため async 化。idle ハンドラからは fire-and-forget で呼ばれる)。 */
   async _drainResidentPending() {
     if (this._closed) return
     if (this._pendingMessages.length === 0) {
@@ -1693,7 +1700,7 @@ export class ClaudeStreamSession {
 
   /** 改修2+4: 常駐 query を 1 回だけ起動し、streaming input キューから複数ターンを処理する。
    *  system/init は最初の 1 回のみ (毎ターン init = 文脈/キャッシュ温め直しを解消)。各ターンは
-   *  終端シグナル (result / session_state_changed:idle) で _busy=false にするが query は継続し
+   *  権威的終端シグナル (session_state_changed:idle) で _busy=false にするが query は継続し
    *  次 input を待つ。close (inputQueue.close) で generator が終わり query が完走する。
    *  SDK-P0-3 (2026-07-10): 終端を result だけに頼ると、SDK が idle でターンを終えたときに
    *  _busy が固着し、以降の送信が pending へ永久滞留する (T06052)。
@@ -1749,6 +1756,7 @@ export class ClaudeStreamSession {
       const q = this.sdk.query({ prompt: this._inputQueue, options })
       this._residentQuery = q
       for await (const msg of q) {
+        let suppressEmit = false
         if (
           msg?.type === "system" &&
           msg?.subtype === "init" &&
@@ -1758,12 +1766,12 @@ export class ClaudeStreamSession {
         }
         if (msg?.type === "result") {
           if (typeof msg.session_id === "string") this.sessionId = msg.session_id
-          // SDK-P0-4: 現ターンの result が届いた = 前ターンの遅延 idle は順序保証により
-          // 既に通過済み (届いたなら消費済み / 届かないなら二度と来ない)。ガードを解除してから
-          // settle する (settle が result 用のガードを張り直す)。
+          // result は結果 flush でありターン終了ではない。SDK の型定義が権威的な
+          // turn-over signal とする session_state_changed:idle まで busy を維持し、
+          // pending を streaming input へ流さない。
+          // 現ターンの result が届いた時点で前ターンの遅延 idle は順序保証により
+          // 既に通過済みなので、interrupt 由来のガードだけ解除できる。
           this._clearStaleIdleGuard()
-          // ターン完了: 未解決 permission を閉じ、次 input 受付へ (query は継続)。
-          this._settleResidentTurn("result", denyPending)
         } else if (isSessionIdleEvent(msg)) {
           // SDK-P0-3 (2026-07-10): result が届かずに idle でターンが終わるケースの救済。
           // これを見ていなかったため _busy が true で固着し、以降の送信が
@@ -1777,11 +1785,14 @@ export class ClaudeStreamSession {
           //  2) それ以外で _busy かつ (running を観測済み or 何かイベントを出した) → 現ターンの終端。
           if (this._staleIdleExpected) {
             this._clearStaleIdleGuard()
+            // browser にも転送しない。前ターンの遅延 idle を新ターンの reducer が受けると、
+            // 3点リーダーと送信ボタンだけが誤って idle になる。
+            suppressEmit = true
             this.logger?.debug?.(
               { stream_id: this.stream_id, turn: this._turnSeq },
               "stale idle from previous turn ignored",
             )
-          } else if (this._busy && (this._turnRunningSeen || this._turnProgressed)) {
+          } else if (this._busy) {
             this._settleResidentTurn("idle", denyPending)
             // per-message の RC-4 と対称に、チャット信号 (サイドバードット) を
             // processing→waiting へ落とす。result 経由なら main.mjs が result を見て
@@ -1804,13 +1815,15 @@ export class ClaudeStreamSession {
           // および session_state_changed の running / requires_action もここに含む。
           this._turnProgressed = true
         }
-        try {
-          this._emit(msg)
-        } catch (err) {
-          this.logger?.warn(
-            { err: err.message, stream_id: this.stream_id },
-            "onEvent callback threw",
-          )
+        if (!suppressEmit) {
+          try {
+            this._emit(msg)
+          } catch (err) {
+            this.logger?.warn(
+              { err: err.message, stream_id: this.stream_id },
+              "onEvent callback threw",
+            )
+          }
         }
       }
     } catch (err) {
@@ -1949,6 +1962,19 @@ export class ClaudeStreamSession {
         } catch {
           /* ignore */
         }
+        // 通常完了と同じ権威境界を browser へ即時提示する。SDK が後から流す
+        // 中断ターン由来の実 idle は _staleIdleExpected で抑止する。
+        try {
+          this._emit({
+            type: "system",
+            subtype: "session_state_changed",
+            state: "idle",
+            session_id: this.sessionId ?? undefined,
+            timestamp: new Date().toISOString(),
+          })
+        } catch {
+          /* ignore */
+        }
       }
       // T05699 残タスク #2-1 (2026-07-04): interrupt() は現ターンの result を発火しない
       // (query は継続、次 input 受付継続のみ)。そのため abort 時点で _pendingMessages に