> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dureai.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# セッション、worktree、復旧

> Dureの管理エージェントを支える所有モデルと、各復旧経路が実際に保証する範囲です。

## 管理エージェントは単なるターミナルではない

管理エージェントは3つのidentityを結び付けます。

* provider conversation
* Dure paneとagent record
* Git worktreeとbranch

Hmuxがprovider processとPTYを所有し、Dureはversioned protocolを通じて
clientとして接続します。このprocess boundaryにより、アプリウィンドウを
閉じても管理されたローカルエージェントは終了しません。

## 再接続

Dureが再接続すると、hostはcanonical screen snapshotとそれ以降の出力を
送ります。現在の画面を描画するために、terminal log全体を最初から再生する
必要はありません。

Generation fence付きcontroller leaseが、どのclientに入力権があるかを
決めます。追加clientは現在のcontrollerからキーボードを奪わず、observer
として接続できます。

<video controls muted playsInline title="同じHmux所有のCodexセッションへ再接続するDure" className="w-full aspect-video rounded-xl" poster="/images/hmux-app-reconnect.png" src="https://mintcdn.com/hebbian/gBhXllKfo-gr_XE_/videos/hmux-app-reconnect.webm?fit=max&auto=format&n=gBhXllKfo-gr_XE_&q=85&s=92c12c2f82d750e887a0a9fd47d7408c" data-path="videos/hmux-app-reconnect.webm">
  ブラウザーは埋め込み動画に対応していません。
  <a href="/videos/hmux-app-reconnect.webm">再接続動画を開く。</a>
</video>

## Worktreeの所有

Worktreeベースの各エージェントは、専用の作業ディレクトリとbranchを持ちます。
Git indexとファイル編集は分離されますが、port、process、credential、
networkなどのOSリソースは分離されません。

<Warning>
  Worktreeはセキュリティsandboxではありません。エージェントが実行できる
  操作は、providerの承認設定と現在のユーザー権限で決まります。
</Warning>

## 異なる3つの復旧

| 事象                            | 結果                                                                                          |
| ----------------------------- | ------------------------------------------------------------------------------------------- |
| アプリ終了、アプリcrash、webview reload | 管理hostがlive processを維持し、Dureが再接続します。                                                        |
| Host process終了                | Live PTYとprocessは失われます。十分なidentityが記録されていれば、Session Recoveryがprovider-aware restartを提示できます。 |
| マシン再起動                        | processは残りません。`hmux restore`は保存済みshell recipeを新しいPTY上で再作成します。                               |

## 管理paneと通常pane

通常のterminalでagent CLIを直接起動しても、Dureは実際のprocess treeと
terminalの証拠からproviderとその活動を自動認識します。エージェントを先に
追加・手動登録せず、普段どおりターミナルを使えます。

自動認識は管理セッションへの昇格と同じではありません。管理されたprovider
sessionはエージェント追加フローから開始するか、検証済みterminal状態で表示
される変換操作を使います。正確なprovider conversationとpane identityを
保持する必要があるため、変換は安全な境界でのみ実行されます。

SSHプロジェクトで同じ保証に依存する前に、
[現在の制約](/jp/current-limits)を確認してください。
