セッション

セッションはメッセージ、ツール活動、質問、Role、モデル、分岐状態を保持し、選択Profileに属します。DashboardやTUIを閉じても履歴は消えません。

履歴はstate.dbと参照オブジェクトにあります。会話をまたぐ個人メモリはmemory/USER.mdとmemory/MEMORY.mdという別のものです。文脈要約は新メモリ項目ではありません。

開始と再開

DashboardでNew sessionか既存チャットを選びます。Chatsは通常会話、Backgroundは予約、委任、常駐背景作業です。古いものはページ単位で読みます。

TUIではanyyから/newか/sessionsを使うか、直接開きます。

anyy --resume SESSION_ID

新会話のRoleを選びます。

anyy --role scribe
anyy chat --role scribe "Help me plan this article"

再開はRoleを保持します。--roleと--resume／chat --sessionは併用不可です。IDは選択Profile内だけで解決します。

CLIのターンを送る

anyy chat "Summarize my priorities"
anyy chat --session SESSION_ID --json "Add the new constraint"

anyy chatには稼働Gatewayが必要です。後続ターンが同Sessionを再利用しても、元の受理入力と実実行を待ちます。--jsonにはセッション、送信、実行、runのID、結果、記録回答があります。後の成功は前の失敗を置換しません。

確認中断、失敗、中断、入力消去、待機期限切れは非ゼロです。期限や呼び出し元キャンセルは待つのを止めるだけで作業は続きます。再送前にセッションを確認します。CLI結果を参照してください。

保留メッセージ

独立キューが2つあります。

• Steeringは次のAgentチェックポイントで読み、実行中ツールはキャンセルしません。
• Follow-upは現在応答の終了を待ちます。

DashboardのSendは1つです。作業中の送信は入力欄上のfollow-upになり、Steer、Edit、Deleteがあります。Steerは次の点用に保留会話へ移し、Editはその待機項目だけを変え、削除しない添付を維持し、取消では変えません。Deleteはその待機項目を消します。選択済み入力はキューとして編集／削除できません。競合時は更新して未送信下書きを保持します。Dashboard Chatを参照してください。

TUIの作業中Enterはsteering、Alt+Enterはfollow-upです。表示はsteeringが先です。Alt+Upは作業を止めず全待機文章と添付を入力欄へ戻し、既存下書きの前に空行区切りで置きます。Gatewayの成功確認後だけキュー所属を消します。修正版送信は新入力です。

停止と入力欄への返却

操作	実行中作業	保留入力
Dashboard Escape	キー時点で表示中の返信を停止	保持
作業中TUI Ctrl+C	現在Session作業を停止	保持
ストリーミングTUI Esc	入力返却後、取得したターンを停止	入力欄へ
TUI Alt+Up	続行	入力欄へ
再試行バックオフ中TUI Esc	その待機を取消	不変

選択画面やオーバーレイが先にEscapeを扱います。遅延した停止／入力返却確認は後のターンを中断できません。Abortは取得作業が落ち着くのを待ち確定履歴を保ちます。別呼び出しは自動開始せず、後の入力か明示Session継続で再開します。

APIによるキュー制御

接続クライアントはsession.queue.peek／session.queue.listで確認し、session.queue.clearで消去入力を返し、session.queue.steer、.update、.cancelで待機項目を変えられます。所属消去は入力本文を保持し、記録削除ではありません。

session.queue.modesはsteeringとfollow_upを独立に読み書きし、allかone-at-a-timeにします。チェックポイントで対象全件か1件を取るかを選び、steeringをfollow-upには変えません。RPC制御で、/queueやDashboardモード設定ではありません。

モデルとツール設定

Dashboard選択とTUI /provider、/model、/effortは現在セッションを操作します。Profile既定は新規へ渡します。再開／移動は該当選択を復元し、以前の仮想モデルが登録されていなければ最新の物理返信モデルへ戻せます。

RoleはアイデンティティとSoulで、ツール名やモードを選びません。CLIツールフラグかsession.tools.configureを使います。明示更新には、キュー／受理中作業や要約操作のない待機セッションが必要です。Tools/Codemode設定はProfileに属します。

リソース再読み込み

session.reload RPCは待機Sessionを現在Profile設定・リソースから更新し、履歴、選択ストア、読み込み済みツール、保留入力を保持します。作業停止や新ターン開始はしません。読み込みは順序付きで、エラーでも前の全変更の巻き戻しを意味しません。対応Dashboardボタン、TUI／シェルコマンドはありません。

目標メタデータAPI

session.goalは任意の目標文とactive／paused状態をメタデータに保存します。set、status、pause、resume、clearが使えます。実行開始／停止、予約、自律継続はしません。個人タスクとは別です。Dashboard/TUIの/goalやCLIサブコマンドはありません。

再試行と文脈サイズ

一時モデルエラーは既定で初回後最大3回自動再試行します。バックオフは2秒から指数増加し、上限1分です。Profile共有Session設定で、トランスポート再試行は別層です。TUIの待機中Escは待機だけ、Ctrl+C／Dashboard Escapeは作業を止めます。

圧縮と分岐要約もProfileポリシーを共有します。操作は予算を保ち、後のモデル呼び出しは現在トランスポート既定を読みます。自動再試行の無効化はHTTP期限を無効にしません。失敗、取消、切り詰め要約は適用しません。自動復旧と手動APIはコンテキスト圧縮を参照してください。

既存履歴を移動する

待機中のTUI /treeは会話ツリーを開きます。Up/Down、Enterで選び、sで離れる分岐要約、Escで取消します。ユーザー項目を選ぶと直前へ移り、空の入力欄に文章を返して修正できます。必要なら先に下書きを保存します。同Session内の移動でモデル返信は始めず、以前と兄弟分岐は残ります。

forkと削除のAPI

session.forkは選択点から別会話を作り、経路履歴とラベルを保ちます。ユーザーメッセージ前なら再送せず文章を返せます。実行作業、キュー、Channel送信権限はコピーしません。

元会話にも作用し、fork準備前に現在作業を取得します。新会話を永続保存後、取得した作業を中断して終了を待ちます。遅延停止は後続ターンを中断しません。終了待ちに失敗しても新会話は保存済みで、エラーはforkの巻き戻しを意味しません。

session.deleteは会話を削除し、他forkが参照する履歴を保持します。非最終作業があれば競合を返し、自動停止してから削除はしません。

forkと個別削除は公開RPCです。現Dashboard、TUI、シェルには操作がありません。TUI /treeは同会話の移動でforkではありません。

トラブルシューティング

問題	確認する項目
会話がない	ProfileとChats／Background
/sessions／/treeが開かない	完了を待つか先に停止
進行中に訂正したい	Dashboardは送信後Steer、TUIは作業中Enter
キューを編集できない	選択済みの可能性。更新履歴を確認
CLI接続不能	対象Profileでanyy gateway start
再開後に古いRole／モデル	Session所有の状態。モデル選択か新セッションで新既定

Profileバックアップは永続セッションを含みます。継続話題ごとに1セッションを使い、前の文脈が不要なら新規にします。