@cocorograph/hub-agent 0.6.27 → 0.6.28

package/package.json

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

package/src/claude-stream-bridge.mjs

@@ -209,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()
@@ -445,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()
@@ -458,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",
@@ -467,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
     }
 
@@ -482,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",
@@ -490,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
@@ -512,6 +528,16 @@ class ClaudeStreamSession {
     if (this.maxTurns != null) options.maxTurns = this.maxTurns
     // 思考オプション (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
 
@@ -613,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
   }
 
@@ -685,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()
@@ -695,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])
   }
@@ -718,6 +777,10 @@ class ClaudeStreamSession {
     if (this.permissionMode) options.permissionMode = this.permissionMode
     if (this.maxTurns != null) options.maxTurns = this.maxTurns
     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
@@ -748,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)
@@ -1030,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

@@ -781,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": {