@cocorograph/hub-agent 0.6.26 → 0.6.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.6.26",
+  "version": "0.6.28",
   "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの tmux/pty を中継する。",
   "type": "module",
   "license": "UNLICENSED",
@@ -32,7 +32,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.152",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.158",
     "commander": "^12.1.0",
     "node-pty": "^1.0.0",
     "pino": "^9.0.0",

package/src/claude-stream-bridge.mjs

@@ -137,6 +137,7 @@ class ClaudeStreamSession {
     permissionMode,
     maxTurns,
     maxThinkingTokens,
+    effort,
     resumeSessionId,
     resident,
     sdk,
@@ -158,6 +159,10 @@ class ClaudeStreamSession {
     this.maxTurns = typeof maxTurns === "number" ? maxTurns : null
     this.maxThinkingTokens =
       typeof maxThinkingTokens === "number" ? maxThinkingTokens : null
+    // Opus 4.6+ の effort パラメータ (low/medium/high/xhigh/max)。adaptive thinking と
+    // 併用して思考の深さを制御する。Opus では budget 方式 (maxThinkingTokens) は廃止
+    // 扱いのため、effort モデルでは effort + thinking:{type:'adaptive'} を使う。
+    this.effort = effort || null
     this.sdk = sdk
     this.logger = logger
     this.onEvent = onEvent
@@ -204,6 +209,11 @@ class ClaudeStreamSession {
     /** 改修3: 直近 browser へ通知した queue 署名 (件数 + id 列)。変化時のみ emit する。
      *  空キューの署名 ("0:") で初期化し、空→空の冗長 emit を抑止する。 */
     this._lastEmittedQueueSig = "0:"
+    /** ultracode (0.6.28): 常駐 query へ現在適用済みの ultracode 状態。ターン単位の
+     *  ワンショット適用を applyFlagSettings で reconcile する際の差分判定に使う。
+     *  query を (再)起動すると flag settings は既定に戻るため、_runResidentQuery 冒頭で
+     *  false に戻す。 */
+    this._ultracodeCurrent = false
 
     /** @type {Map<string, {resolve: (decision: object) => void}>} permission 応答待ち */
     this._permissionResolvers = new Map()
@@ -326,7 +336,7 @@ class ClaudeStreamSession {
    *  値が undefined のキーは「変更なし」として無視する (バッジ未送出時に既存値を消さない)。
    *  model に空文字/null が来たら setModel(undefined) でデフォルトへ戻す。
    *  maxThinkingTokens に 0/null が来たら setMaxThinkingTokens(null) でオフにする。 */
-  applyRuntimeOptions({ model, permissionMode, maxThinkingTokens } = {}) {
+  applyRuntimeOptions({ model, permissionMode, maxThinkingTokens, effort } = {}) {
     const q = this._residentQuery
     // モデル
     if (model !== undefined) {
@@ -378,6 +388,34 @@ class ClaudeStreamSession {
         }
       }
     }
+    // effort (Opus 4.6+)。SDK には setEffort 相当のランタイム制御メソッドが無いため、
+    // 保持値の更新のみ行う。per-message セッションは次ターンの options 構築時に
+    // this.effort を読むため即反映される。常駐 query は次 spawn (resume 再起動) 時に
+    // 反映される (= 次回セッションから切替。ユーザー要件と一致)。
+    if (effort !== undefined) {
+      this.effort = effort || null
+    }
+  }
+
+  /** モデルが Opus 4.6+ (effort / adaptive thinking 対応) かどうか。
+   *  budget 方式 (maxThinkingTokens) は Opus 4.7+ で廃止扱いのため、effort モデルでは
+   *  effort + thinking:{type:'adaptive'} に切り替える。 */
+  _isEffortModel() {
+    return typeof this.model === "string" && /claude-opus-4-[678]/.test(this.model)
+  }
+
+  /** 思考関連オプション (effort / adaptive thinking / 旧 budget) を options へ適用する。
+   *  per-message / 常駐 query の両方から呼ぶ共通ロジック (分岐の二重定義を避ける)。 */
+  _applyThinkingOptions(options) {
+    if (this._isEffortModel()) {
+      // Opus: adaptive thinking を明示 ON にし、effort で深さを指定する。
+      // budget 方式 (maxThinkingTokens) は使わない (Opus 4.7+ で非対応)。
+      options.thinking = { type: "adaptive" }
+      if (this.effort) options.effort = this.effort
+    } else if (this.maxThinkingTokens != null) {
+      // 非 effort モデル (Sonnet / Haiku 等) は従来の budget 方式を維持。
+      options.maxThinkingTokens = this.maxThinkingTokens
+    }
   }
 
   /** soft detach: browser 切断時にターンを中断せずセッションを生かしたまま detached に
@@ -412,11 +450,18 @@ class ClaudeStreamSession {
    * 既存ターン実行中 (busy) は破棄せず pending キューへ退避し、現ターン完了時に drain する
    * (改修3)。常駐 query 対象 (新規セッション) は InputQueue へ積む (改修2)。
    */
-  async sendMessage(message) {
+  async sendMessage(message, opts = {}) {
     if (this._closed) return
     const prompt = extractPromptText(message)
     if (!prompt) return
 
+    // ultracode ワンショット (0.6.28): このターンのみ xhigh effort + 常時 dynamic-workflow
+    // オーケストレーションを有効化する。セッション既定としては持たず (トークン消費が
+    // 桁違いになるため)、ターン単位でトグルし、完了後は通常状態へ戻す。
+    // per-message では options.settings に乗せ、resident では applyFlagSettings で
+    // ターン前に ON / 次ターン前に OFF へ reconcile する (詳細は _reconcileResidentUltracode)。
+    const ultracode = opts.ultracode === true
+
     // 改修2+4: 常駐query対象セッション。
     if (this._residentEligible) {
       if (!this._inputQueue) this._inputQueue = new InputQueue()
@@ -425,7 +470,7 @@ class ClaudeStreamSession {
       // 次を push すると SDK streaming-input で割り込み扱いになり得るため (公式 interrupt 警告)。
       // pending は queue_state で UI (送信待ちチップ) に出す (per-message と同じ体験)。
       if (this._busy) {
-        this._enqueuePending(prompt)
+        this._enqueuePending(prompt, ultracode)
         this.logger?.info(
           { stream_id: this.stream_id, queued: this._pendingMessages.length },
           "resident busy, message queued",
@@ -434,14 +479,18 @@ class ClaudeStreamSession {
         return
       }
       this._busy = true
-      this._inputQueue.push(toSDKUserMessage(prompt))
       // 改修4 (A): 死亡ガード。常駐 query が未起動 or (エラー等で) 終了済み (_residentQuery=null)
       // なら (再)起動する。_runResidentQuery は起動時 options.resume=this.sessionId で文脈を
       // 復元するため、途中死からの復活でも過去コンテキストは失われない。
+      // ultracode のとき: query を先に起動 (空 InputQueue なので入力待ちでブロック) し、
+      // applyFlagSettings を await してから push することで、設定適用前にターンが
+      // 消費されるレースを防ぐ。
       if (!this._residentQuery) {
         this._residentStarted = true
         this._startResidentQuery()
       }
+      await this._reconcileResidentUltracode(ultracode)
+      this._inputQueue.push(toSDKUserMessage(prompt))
       return
     }
 
@@ -449,7 +498,7 @@ class ClaudeStreamSession {
     // 改修3: busy 中の送信は破棄せず pending キューへ退避し、現ターン完了時に drain する
     // (ターミナル流の「積む→待機→順次実行」)。常駐 query 化はしないので暴走リスクは増えない。
     if (this._busy) {
-      this._enqueuePending(prompt)
+      this._enqueuePending(prompt, ultracode)
       this.logger?.info(
         { stream_id: this.stream_id, queued: this._pendingMessages.length },
         "claude busy, message queued",
@@ -457,12 +506,12 @@ class ClaudeStreamSession {
       this._emitQueueState()
       return
     }
-    return this._runPerMessage(prompt)
+    return this._runPerMessage(prompt, { ultracode })
   }
 
   /** per-message 1 ターンを実行する (resume チェーン)。busy 中に届いた送信は sendMessage
    *  が pending キューへ退避し、本メソッドの finally で drain する。 */
-  async _runPerMessage(prompt) {
+  async _runPerMessage(prompt, opts = {}) {
     this._busy = true
     this._abortController = new AbortController()
     let aborted = false
@@ -475,9 +524,20 @@ class ClaudeStreamSession {
     }
     if (this.model) options.model = this.model
     if (this.permissionMode) options.permissionMode = this.permissionMode
-    // Phase B: チャット SDK に効くオプション (拡張思考予算 / ツール往復上限)。
+    // Phase B: チャット SDK に効くオプション (ツール往復上限)。
     if (this.maxTurns != null) options.maxTurns = this.maxTurns
-    if (this.maxThinkingTokens != null) options.maxThinkingTokens = this.maxThinkingTokens
+    // 思考オプション (effort / adaptive thinking / 旧 budget) はモデルに応じて切替。
+    this._applyThinkingOptions(options)
+    // ultracode ワンショット (0.6.28): per-message は 1 query = 1 ターンなので、
+    // このターンの options.settings (= --settings 相当 / flag settings 層) に乗せるだけで
+    // 自然に 1 ターン限定になる。次ターンは options を作り直すため通常状態に戻る。
+    if (opts.ultracode === true) {
+      options.settings = {
+        ...(options.settings || {}),
+        ultracode: true,
+        enableWorkflows: true,
+      }
+    }
     // 直前ターンまでの session_id があれば resume チェーン
     if (this.sessionId) options.resume = this.sessionId
 
@@ -579,18 +639,21 @@ class ClaudeStreamSession {
     }
     const next = this._pendingMessages.shift()
     this._emitQueueState([next.text])
-    this._runPerMessage(next.text).catch((err) => {
-      this.logger?.error(
-        { stream_id: this.stream_id, err: err?.message },
-        "drain runPerMessage threw",
-      )
-    })
+    this._runPerMessage(next.text, { ultracode: next.ultracode === true }).catch(
+      (err) => {
+        this.logger?.error(
+          { stream_id: this.stream_id, err: err?.message },
+          "drain runPerMessage threw",
+        )
+      },
+    )
   }
 
-  /** キャンセル機能 (0.6.26): pending キューへ安定 id 付きで 1 件積む。 */
-  _enqueuePending(prompt) {
+  /** キャンセル機能 (0.6.26): pending キューへ安定 id 付きで 1 件積む。
+   *  ultracode (0.6.28): ワンショット ultracode フラグもエントリに保持し、drain 時に伝播する。 */
+  _enqueuePending(prompt, ultracode = false) {
     const id = `q${++this._queueSeq}`
-    this._pendingMessages.push({ id, text: prompt })
+    this._pendingMessages.push({ id, text: prompt, ultracode: ultracode === true })
     return id
   }
 
@@ -651,9 +714,38 @@ class ClaudeStreamSession {
     })
   }
 
+  /** ultracode (0.6.28): 常駐 query の ultracode 状態を目標値へ寄せる (差分時のみ
+   *  applyFlagSettings を発行)。push の前に await して、設定適用前にターンが消費される
+   *  レースを防ぐ。query 未起動 / applyFlagSettings 非対応 SDK では no-op。 */
+  async _reconcileResidentUltracode(desired) {
+    const want = desired === true
+    if (want === this._ultracodeCurrent) return
+    const q = this._residentQuery
+    if (!q || typeof q.applyFlagSettings !== "function") return
+    try {
+      await q.applyFlagSettings(
+        want
+          ? { ultracode: true, enableWorkflows: true }
+          : { ultracode: false },
+      )
+      this._ultracodeCurrent = want
+      this.logger?.info(
+        { stream_id: this.stream_id, ultracode: want },
+        "resident ultracode reconciled",
+      )
+    } catch (err) {
+      this.logger?.warn(
+        { stream_id: this.stream_id, err: err?.message },
+        "applyFlagSettings ultracode failed",
+      )
+    }
+  }
+
   /** 改修4 (A): ターン完了時に pending の先頭 1 件を InputQueue へ流す (ターンのシリアライズ)。
-   *  queue_state を更新して送信待ちチップを drain させる (frontend がバブル昇格する)。 */
-  _drainResidentPending() {
+   *  queue_state を更新して送信待ちチップを drain させる (frontend がバブル昇格する)。
+   *  ultracode (0.6.28): 次ターンの目標 ultracode 状態へ reconcile してから push する
+   *  (await するため async 化。result ハンドラからは fire-and-forget で呼ばれる)。 */
+  async _drainResidentPending() {
     if (this._closed) return
     if (this._pendingMessages.length === 0) {
       this._emitQueueState()
@@ -661,6 +753,7 @@ class ClaudeStreamSession {
     }
     const next = this._pendingMessages.shift()
     this._busy = true
+    await this._reconcileResidentUltracode(next.ultracode === true)
     this._inputQueue.push(toSDKUserMessage(next.text))
     this._emitQueueState([next.text])
   }
@@ -683,7 +776,11 @@ class ClaudeStreamSession {
     if (this.model) options.model = this.model
     if (this.permissionMode) options.permissionMode = this.permissionMode
     if (this.maxTurns != null) options.maxTurns = this.maxTurns
-    if (this.maxThinkingTokens != null) options.maxThinkingTokens = this.maxThinkingTokens
+    this._applyThinkingOptions(options)
+    // ultracode (0.6.28): 新規 query は flag settings 既定 (ultracode=off) で始まる。
+    // 適用済み状態の追跡を false にリセットし、次ターンの reconcile が正しく差分判定できる
+    // ようにする (異常終了→resume 再起動時にも確実にリセット)。
+    this._ultracodeCurrent = false
     // 改修4: 起動時に sessionId (= resumeSessionId) があれば resume チェーンで文脈を引き継ぐ。
     // query 起動時点の値のみ有効 (起動後に確定/変化する session_id は同一 query 内で継続される)。
     if (this.sessionId) options.resume = this.sessionId
@@ -714,7 +811,14 @@ class ClaudeStreamSession {
           denyPending("turn ended")
           this._busy = false
           // 改修4 (A): シリアライズした pending があれば次の 1 件を InputQueue へ流す。
-          this._drainResidentPending()
+          // ultracode (0.6.28): _drainResidentPending は applyFlagSettings を await するため
+          // async。result ハンドラ (for await ループ内) からは fire-and-forget で呼ぶ。
+          this._drainResidentPending().catch((err) =>
+            this.logger?.warn(
+              { stream_id: this.stream_id, err: err?.message },
+              "drainResidentPending threw",
+            ),
+          )
         }
         try {
           this.onEvent?.(msg)
@@ -871,6 +975,7 @@ export class ClaudeStreamBridge extends EventEmitter {
    *   permissionMode?: string|null,
    *   maxTurns?: number|null,
    *   maxThinkingTokens?: number|null,
+   *   effort?: string|null,
    *   resumeSessionId?: string|null,
    * }} args
    * @returns {{ stream_id: string, resuming: boolean }}
@@ -882,6 +987,7 @@ export class ClaudeStreamBridge extends EventEmitter {
     permissionMode,
     maxTurns,
     maxThinkingTokens,
+    effort,
     resumeSessionId,
     resident,
   }) {
@@ -910,6 +1016,7 @@ export class ClaudeStreamBridge extends EventEmitter {
           permissionMode,
           maxThinkingTokens:
             typeof maxThinkingTokens === "number" ? maxThinkingTokens : null,
+          effort,
         })
         this.sessions.set(stream_id, live)
         this.logger?.info(
@@ -920,6 +1027,7 @@ export class ClaudeStreamBridge extends EventEmitter {
             model: live.model,
             permissionMode: live.permissionMode,
             maxThinkingTokens: live.maxThinkingTokens,
+            effort: live.effort,
           },
           "claude stream reattached to live session",
         )
@@ -934,6 +1042,7 @@ export class ClaudeStreamBridge extends EventEmitter {
       maxTurns: typeof maxTurns === "number" ? maxTurns : null,
       maxThinkingTokens:
         typeof maxThinkingTokens === "number" ? maxThinkingTokens : null,
+      effort: effort || null,
       resumeSessionId: resumeSessionId || null,
       resident,
       sdk: this.sdk,
@@ -991,14 +1100,15 @@ export class ClaudeStreamBridge extends EventEmitter {
   }
 
   /** browser → claude の user メッセージ。1 件 = 1 query (resume チェーン)。 */
-  input({ stream_id, message }) {
+  input({ stream_id, message, ultracode }) {
     const s = this.sessions.get(stream_id)
     if (!s) {
       this.logger?.warn({ stream_id }, "claude.input but stream missing")
       return false
     }
     // 非同期でターン実行 (完了は result イベント + onEvent 経由で browser に届く)
-    s.sendMessage(message).catch((err) => {
+    // ultracode (0.6.28): このメッセージのみ ultracode ワンショットを適用するフラグ。
+    s.sendMessage(message, { ultracode: ultracode === true }).catch((err) => {
       this.logger?.error(
         { stream_id, err: err?.message },
         "claude sendMessage threw unexpectedly",

package/src/main.mjs

@@ -756,6 +756,9 @@ async function dispatch(msg, ctx) {
               typeof msg.max_thinking_tokens === "number"
                 ? msg.max_thinking_tokens
                 : null,
+            // effort (Opus 4.6+): browser がチャット既定 (agent 設定由来) を送る。
+            // 空文字/未指定なら null (SDK / Claude Code 既定 = Opus は high)。
+            effort: msg.effort || ctx.config?.claude_effort || null,
             resumeSessionId: msg.resume_session_id || null,
           })
           ctx.client.send({
@@ -778,6 +781,9 @@ async function dispatch(msg, ctx) {
         ctx.claudeBridge.input({
           stream_id: msg.stream_id,
           message: msg.message,
+          // ultracode (0.6.28): browser がこのメッセージ単位で送るワンショット指定。
+          // true のときだけそのターンを xhigh effort + dynamic-workflow で実行する。
+          ultracode: msg.ultracode === true,
         })
         return
       case "claude.upload": {