多開幾個 session 各自做事時，它們看得到自己的工作，卻看不到彼此。這個 bundle 讓 agent 用工具找 session、讀最近的對話、把工作連脈絡交棒。

它可以做什麼

工具	用途
session_list	列出其他 session：活著的，加上可以喚醒的 stored
session_inspect	唯讀讀取最近訊息；不會喚醒對方，也不消耗對方 token
session_send	送一則訊息；對方 idle 會開新 turn，running 則在下一個 step 邊界收到
session_handoff	把 summary 和下一步一起交出去，預設要求對方完成後回報

session_inspect 對冷 session 也有效；session_send 會把它 resume 成 live agent（回傳 coldResumed: true）。收到的訊息在 session log 裡帶 agent-message／relay 來源，本文開頭也有 [session-bridge] 標記。

需要 HAPI 的 list_peers／inspect_peer／ping_peer 時，同一組名字可以接本機 DSH session，也可以接真正的 HAPI hub；模式和限制見 HAPI 相容。

安裝

dsh plugin --profile web add github:Mizimo/dsh-session-bridge#v0.2.1

裝完重啟該 profile 的 dsh process，開一個新 session，確認 agent 有 session_list 就生效了。

DSH Desktop 的 desktop profile 由 GUI 管理，CLI 會拒絕；Desktop 請從內建插件管理介面安裝。

快速開始

在一個 session 裡對 agent 說：

用 session_list 看看其他 session，挑正在改登入頁的那個，用 session_inspect 讀它最近的進度，再問它能不能接手。

session A ── session_send ──▶ session B
          ◀── session_send ──

要交接工作時改用 session_handoff，把目前狀態和下一步一起送出去。

文件

文件	內容
設定	row config、環境變數、kill switch、憑證安全
工具參考	每個工具的參數、回傳、錯誤與限制
HAPI 相容	模式、hub 設定、wire 行為、單向限制
運作原理	送達／讀取／冷啟動，程式結構與設計取捨
測試	單元測試、E2E 驗證矩陣與重跑方式

相容性

• DSH 0.2.x：驗證過 0.2.0-rc.2 CLI 與 0.2.1-rc.2 Desktop；peerDependencies 是 >=0.2.0-rc.1 <0.3.0。
• HAPI 0.30.x／0.31.x：用到的 REST wire 在 0.30.7 與 0.31.2 相同。
• 只跑在同一個 dsh host process 內的 session；跨機器要經過 HAPI hub。

授權

MIT