aiterm-mcp 0.45.2 → 0.46.1

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.46.1] - 2026-10-02
+
+### 修正
+
+- 認証PTYが閉じられた、またはbackend再起動で失われた場合、`agent_auth`の`status`は`failed`、`cancel`は取消済みの`blocked`を返し、`session_id:null`で再開始できる。通常PTY・harness不一致・記録の破損や読取り失敗は引き続きエラーとする。
+
+## [0.46.0] - 2026-10-02
+
+### 追加
+
+- 公開tool `agent_auth`。Claude／Codex／Grok／Cursorの公式認証を共通のstart・status・cancelで進め、公式URL・device code・入力待ちを`aiterm.agent-auth-result.v1`へ返す。CLI差はharness adapterへ閉じ、資格情報は公式CLIだけが保存する。Claudeの公式初回案内も同じ認証PTYで進め、Grokは公式loginの終了結果を認証確認の正本にし、device codeを公式URLの`user_code`から抽出する。remoteも標準対応し、公開面は18 toolsとなる。
+
 ## [0.45.2] - 2026-10-01
 
 ### 修正
@@ -1952,7 +1964,9 @@ prototype (preserved under `prototype/python/` as the porting source and referen
   `ubuntu-latest` for Node 18/20/22, publishing to npm on `v*` tags with
   provenance.
 
-[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.45.2...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.46.1...HEAD
+[0.46.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.46.0...v0.46.1
+[0.46.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.45.2...v0.46.0
 [0.45.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.45.1...v0.45.2
 [0.45.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.45.0...v0.45.1
 [0.45.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.44.1...v0.45.0

package/README.ja.md

@@ -143,7 +143,7 @@ diagnostics、recovery、update、releaseを所有します。このREADMEと[
 
 **言葉でなく実測で:** 記録済み203テストのベンチマークでは、`pty_read` はコンテキストに載るトークンを生ログの **約 7.1 分の 1** に減らす。しかも pass/fail の判定は畳んでも残る。→ [組み込みシェルツールとの使い分け](#組み込みシェルツールとの使い分け)
 
-17ツール: 7つのPTYツール、正規のagent起動入口`agent_launch`、移行用の旧3alias、`agent_models`、`agent_configure`、`agent_approval`、`claude_turn`、`claude_approval`、`diagnostics`。backendはPOSIXのtmux／Windows nativeのpsmuxなので、MCPサーバやAIクライアントが再起動してもsessionは生き残る。
+18ツール: 7つのPTYツール、正規のagent起動入口`agent_launch`、移行用の旧3alias、`agent_models`、`agent_configure`、`agent_auth`、`agent_approval`、`claude_turn`、`claude_approval`、`diagnostics`。backendはPOSIXのtmux／Windows nativeのpsmuxなので、MCPサーバやAIクライアントが再起動してもsessionは生き残る。
 
 **v0.28.0では実行基盤harnessとmodelを分離した。** harnessはagent loop・認証・hook・session・transcriptを所有し、modelはその上で選ぶ。Cursor Agent CLIでGPT／Claude／Grokを選んでも完了契約はCursor方式のまま。ComposerはCursorのmodelの一つで、harnessでもGrokのmodelでもない。`harness:"cursor-cli", model:"composer-2.5-fast"`（または`composer-2.5`）で表す。旧起動ツールは同じ実装へ流れる互換alias。
 
@@ -203,7 +203,7 @@ runtime-error store は canonical dotagents config の `collection.enabled: true
 場合だけ収集し、既定OFF、network送信は行いません。tag起点CIのnpm provenance（OIDC Trusted
 Publishing）で公開し、GitHub Release が Official MCP Registry を再登録します。
 
-**状態:** 開発継続中 · 現行公開版 **v0.45.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.46.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -411,7 +411,7 @@ MCP クライアントが aiterm を stdio 越しにプログラムから駆動
 
 ```mermaid
 flowchart LR
-    AI["AI / MCP client<br/>(the orchestrator)"] -->|"pty_send · pty_observe · agent_launch · agent_models · agent_configure · agent_approval · claude_turn · claude_approval<br/>旧launcher alias · diagnostics"| S["aiterm-mcp<br/>stdio MCP · 17 tools"]
+    AI["AI / MCP client<br/>(the orchestrator)"] -->|"pty_send · pty_observe · agent_launch · agent_models · agent_configure · agent_auth · agent_approval · claude_turn · claude_approval<br/>旧launcher alias · diagnostics"| S["aiterm-mcp<br/>stdio MCP · 18 tools"]
     S -->|"pty_read<br/>token-reduced"| AI
     S -->|"tmux / psmux<br/>send · capture"| P["persistent PTYs<br/>再起動を跨ぐ"]
     P -->|"ssh · docker · repl"| R["nested<br/>remote · container · REPL"]
@@ -527,6 +527,7 @@ Claudeの相関済み承認は既存の`claude_approval`を使う。
 | `pty_list` | textと構造化したsession一覧、明示した非秘密環境変数の照会 | `env_keys?` |
 | `pty_observe` | pane／harnessの生存、native process identity、状態と活動 | `session_id`, `cursor?` |
 | `agent_launch` | harnessとmodelを別軸で選ぶ正規agent起動入口 | `harness`, `prompt?`, `model?`, `reasoning_effort?`, `cwd?`, `write_scope?`, `trust_project?`, `env_vars?`, `throughline_source_session?`, `throughline_supplement_file?` |
+| `agent_auth` | 公式CLIの認証を開始・確認・取消し、公式URL・device code・入力待ちを返す | `harness`, `action`, `session_id?`, `cwd?`, `env_vars?` |
 | `agent_models` | harnessが今選べるmodelとreasoning effortを、そのharness自身の一覧からpromptを送らずに取得 | `harness`, `cwd?`, `include_hidden?` |
 | `agent_approval` | Codexの現在の承認を検査し、単発許可・拒否を送る | `action`, `session_id`, `approval_choice?`, `observed_prompt_digest?` |
 | `claude_agent` / `codex_agent` / `grok_agent` | deprecated互換alias（`composer_agent`は0.41.0で削除。Composerは`agent_launch`の`cursor-cli`で使う） | 旧launcher引数 |
@@ -549,6 +550,14 @@ consumer は `aiterm-runtime-errors snapshot` を読み、durable ingestion 後
 
 `agent_configure({ session_id, model?, reasoning_effort? })`はharness標準操作で起動中のClaude／Codex／Grok／Cursorを変更し、PTYと会話contextを維持する。
 
+`agent_auth({ harness, action:"start"|"status"|"cancel", session_id?, cwd?, env_vars? })`は、各harnessの公式CLIで認証を進める。Claudeは`claude auth login`、CodexとGrokは`login --device-auth`、Cursorは`NO_OPEN_BROWSER=1 cursor-agent login`を使い、資格情報は各CLIだけが保存する。Aitermは資格情報を読取り・copy・編集せず、独自OAuthも実装しない。`remote`は他toolと同じ標準対応。
+
+結果は`aiterm.agent-auth-result.v1`。`status`は`waiting`／`authenticated`／`blocked`／`failed`、`session_id`・`url`・`user_code`・`input_required`・`message`を返す。`start`のsession IDを保存して`status`へ渡す。公式HTTPS URLと明示device codeだけを返し、CLIの生出力・token・OAuth callback codeを結果へ載せない。`input_required:true`なら同じsessionの`pty_read(screen:true)`で公式画面を表示し、`pty_send`／`pty_key`で人の入力を中継する。
+
+Grokには公式認証status commandが無いため、session付きの確認は公式loginのexit 0を正本にし、session無しの確認は`blocked`を返す。他harnessは公式statusも照合する。Claudeは認証後の公式初回案内を同じsessionで進め、選択待ちは`blocked`／`input_required:true`で返す。`authenticated`は認証結果であり、`agent_launch`の起動準備完了は別途確認する。`cancel`は指定した認証sessionだけを閉じ、資格情報を削除しない。
+
+PTYが消失した場合は、相関記録の有無にかかわらず`status`が`failed`、`cancel`が既に終了・取消済みを示す`blocked`を返し、どちらも`session_id:null`となる。保存したsession IDを解除して`start`で再開始できる。生存中の通常PTYやharness不一致、記録の破損・読取り失敗はエラーを返す。
+
 `agent_models({ harness, cwd?, include_hidden? })`は、導入済みのharnessが今選べるmodel IDとreasoning effortを返す。画面の候補を、実際にagentを動かす端末の一覧から作れる。各harness自身の一覧を読むだけで、promptもturnも送らない。
 
 | `harness` | 取得元 | 補足 |

package/README.md

@@ -145,7 +145,7 @@ Aiterm and is not a runtime dependency.
 
 **Measured, not claimed:** in the recorded 203-test benchmark, a `pty_read` puts **~7.1× fewer tokens** in your context than the raw log — and the pass/fail verdict survives the fold. → [When to reach for it vs. the built-in shell](#when-to-reach-for-it-vs-the-built-in-shell)
 
-Seventeen tools: seven **PTY tools** — `pty_open` / `pty_send` / `pty_read` / `pty_key` / `pty_close` / `pty_list` / `pty_observe` — to open, drive, read, and observe one persistent terminal; one canonical **agent launcher**, `agent_launch`, which selects `claude-code`, `codex-cli`, `grok-cli`, or `cursor-cli` as the execution harness; three deprecated launcher aliases kept for migration; `agent_models`; `agent_configure`; `agent_approval`; `claude_turn`; `claude_approval`; and `diagnostics`. The backend is **tmux on POSIX and psmux on native Windows**, so sessions survive even if the MCP server or the AI client restarts.
+18 tools: seven **PTY tools** — `pty_open` / `pty_send` / `pty_read` / `pty_key` / `pty_close` / `pty_list` / `pty_observe` — to open, drive, read, and observe one persistent terminal; one canonical **agent launcher**, `agent_launch`, which selects `claude-code`, `codex-cli`, `grok-cli`, or `cursor-cli` as the execution harness; three deprecated launcher aliases kept for migration; `agent_models`; `agent_configure`; `agent_auth`; `agent_approval`; `claude_turn`; `claude_approval`; and `diagnostics`. The backend is **tmux on POSIX and psmux on native Windows**, so sessions survive even if the MCP server or the AI client restarts.
 
 **v0.28.0 separates the execution harness from the model.** The harness owns the agent loop, authentication, hooks, session, and transcript; `model` is what that harness runs. Cursor Agent CLI can therefore select GPT, Claude, or Grok without changing the completion contract from Cursor hooks to another harness's. Composer is one of Cursor's models, not a harness and not a Grok model: use `harness: "cursor-cli", model: "composer-2.5-fast"` (or `composer-2.5`). The old launcher tools are thin compatibility aliases over the same implementation.
 
@@ -217,7 +217,7 @@ collection is off by default and performs no network I/O. It ships via
 tag-triggered CI with npm provenance (OIDC Trusted Publishing); the GitHub
 Release re-registers the Official MCP Registry entry.
 
-**Status:** actively maintained · current public release **v0.45.2** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
+**Status:** actively maintained · current public release **v0.46.1** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
 
 ### Update and rollback
 
@@ -399,7 +399,7 @@ The only edits to the captures above are the two `⋮` lines (a long head/tail r
 `aiterm-setup --json`が`ready`になったら、利用するMCP clientを再起動して接続を確認する。Claude Codeの場合:
 
 ```bash
-/mcp        # aiterm should show as connected, exposing 17 tools
+/mcp        # aiterm should show as connected, exposing 18 tools
 ```
 
 Your first session — four calls, one persistent terminal:
@@ -440,7 +440,7 @@ The terminal is real and shared, so a human *can* jump in ([A human can watch](#
 
 ```mermaid
 flowchart LR
-    AI["AI / MCP client<br/>(the orchestrator)"] -->|"pty_send · pty_observe · agent_launch · agent_models · agent_configure · agent_approval · claude_turn · claude_approval<br/>legacy launcher aliases · diagnostics"| S["aiterm-mcp<br/>stdio MCP · 17 tools"]
+    AI["AI / MCP client<br/>(the orchestrator)"] -->|"pty_send · pty_observe · agent_launch · agent_models · agent_configure · agent_auth · agent_approval · claude_turn · claude_approval<br/>legacy launcher aliases · diagnostics"| S["aiterm-mcp<br/>stdio MCP · 18 tools"]
     S -->|"pty_read<br/>token-reduced"| AI
     S -->|"tmux / psmux<br/>send · capture"| P["persistent PTYs<br/>survive restarts"]
     P -->|"ssh · docker · repl"| R["nested<br/>remote · container · REPL"]
@@ -560,6 +560,7 @@ continue to use `claude_approval`.
 | `pty_list` | Text and structured session list, with explicitly requested non-secret environment values | `env_keys?` |
 | `pty_observe` | Pane/harness liveness, native process identity, state, and activity | `session_id`, `cursor?` |
 | `agent_launch` | Canonical agent launch; harness and model are independent | `harness`, `prompt?`, `model?`, `reasoning_effort?`, `cwd?`, `write_scope?`, `trust_project?`, `env_vars?`, `throughline_source_session?`, `throughline_supplement_file?` |
+| `agent_auth` | 公式CLIの認証を開始・確認・取消し、公式URL・device code・入力待ちを返す | `harness`, `action`, `session_id?`, `cwd?`, `env_vars?` |
 | `agent_models` | List the models and reasoning efforts a harness offers now, read from that harness's own catalog without sending a prompt | `harness`, `cwd?`, `include_hidden?` |
 | `agent_approval` | Inspect a Codex approval and submit a one-time approval or denial | `action`, `session_id`, `approval_choice?`, `observed_prompt_digest?` |
 | `claude_agent` / `codex_agent` / `grok_agent` | Deprecated compatibility aliases (`composer_agent` was removed in 0.41.0; run Composer with `agent_launch` on `cursor-cli`) | legacy launcher arguments |
@@ -584,6 +585,14 @@ Consumer flow is `aiterm-runtime-errors snapshot`, then `aiterm-runtime-errors a
 
 `agent_configure({ session_id, model?, reasoning_effort? })` changes a running Claude, Codex, Grok, or Cursor TUI through the harness's standard controls, preserving the PTY and conversation context.
 
+`agent_auth({ harness, action:"start"|"status"|"cancel", session_id?, cwd?, env_vars? })`は、各harnessの公式CLIで認証を進める。Claudeは`claude auth login`、CodexとGrokは`login --device-auth`、Cursorは`NO_OPEN_BROWSER=1 cursor-agent login`を使い、資格情報は各CLIだけが保存する。Aitermは資格情報を読取り・copy・編集せず、独自OAuthも実装しない。`remote`は他toolと同じ標準対応。
+
+結果は`aiterm.agent-auth-result.v1`。`status`は`waiting`／`authenticated`／`blocked`／`failed`、`session_id`・`url`・`user_code`・`input_required`・`message`を返す。`start`のsession IDを保存して`status`へ渡す。公式HTTPS URLと明示device codeだけを返し、CLIの生出力・token・OAuth callback codeを結果へ載せない。`input_required:true`なら同じsessionの`pty_read(screen:true)`で公式画面を表示し、`pty_send`／`pty_key`で人の入力を中継する。
+
+Grokには公式認証status commandが無いため、session付きの確認は公式loginのexit 0を正本にし、session無しの確認は`blocked`を返す。他harnessは公式statusも照合する。Claudeは認証後の公式初回案内を同じsessionで進め、選択待ちは`blocked`／`input_required:true`で返す。`authenticated`は認証結果であり、`agent_launch`の起動準備完了は別途確認する。`cancel`は指定した認証sessionだけを閉じ、資格情報を削除しない。
+
+PTYが消失した場合は、相関記録の有無にかかわらず`status`が`failed`、`cancel`が既に終了・取消済みを示す`blocked`を返し、どちらも`session_id:null`となる。保存したsession IDを解除して`start`で再開始できる。生存中の通常PTYやharness不一致、記録の破損・読取り失敗はエラーを返す。
+
 `agent_models({ harness, cwd?, include_hidden? })` returns the model IDs and reasoning efforts the installed harness offers right now, so a UI can build its choices from the machine that actually runs the agents. It reads each harness's own catalog and never sends a prompt or starts a turn:
 
 | `harness` | Source | Notes |

package/dist/agent-auth.js

@@ -0,0 +1,23 @@
+/** CLIが示した公式HTTPS URLだけを返す。tokenやOAuth callbackのcodeは公開しない。 */
+export function authUrl(screen, hosts) {
+    for (const match of screen.matchAll(/https:\/\/[^\s<>"']+/g)) {
+        const candidate = match[0].replace(/[).,;]+$/, "");
+        let url;
+        try {
+            url = new URL(candidate);
+        }
+        catch {
+            continue;
+        }
+        if (url.username || url.password || !hosts.includes(url.hostname) || url.hash)
+            continue;
+        if ([...url.searchParams.keys()].some(key => /^(?:access_token|refresh_token|id_token|token|code)$/i.test(key)))
+            continue;
+        return candidate;
+    }
+    return null;
+}
+/** 明示されたdevice code欄だけを読む。一般のtokenや認証情報は抽出しない。 */
+export function authUserCode(screen) {
+    return /(?:enter (?:this|the following) (?:one[- ]time )?code|(?:one[- ]time |user |device |verification )?code\s*:)(?:\s*\([^\n]*\))?\s*:?[ \t]*(?:\n\s*)?([A-Z0-9]{4}-[A-Z0-9]{4,5})\b/i.exec(screen)?.[1] ?? null;
+}

package/dist/core.js

@@ -20,10 +20,10 @@ import { AitermError, telemetryOwnedFailure, ownTelemetryFailure } from "./error
 import { isWin, SOCKDIR, tmuxCommand, sendPsmuxPayload, loadPtyBufferChunk, pasteBufferBaseArgs, TMUX_EMPTY_CONFIG, attachCommand, normalizePaneCommand, atomicShellMultiline, appendMarkSentinel, markShellCommand, settlePaneLog, paneCwdArgument, sessionEnvironmentLaunch, } from "./tmux-runtime.js";
 import { sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, writeJson0600, createEmpty0600, shq, LAUNCH_ID_RE, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, assertSessionName, agentsDir, agentEventPath, agentMetadataPath, writeAgentMetadata, AGENT_EVENT_TAIL_BYTES, agentLabel, agentHarness, subagentInstruction, agentLineageFields, } from "./agent-shared.js";
 import { catalogUnavailable } from "./model-catalog.js";
-import { realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokModelChoices, grokEventsTranscript, latestGrokCompletion, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokRateLimitDialog, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
-import { bindCodexTranscriptSession, latestCodexCompletion, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, codexModelChoices, } from "./harnesses/codex.js";
-import { OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, claudeModelChoices, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, claudePaneObservation, claudeUsageLimit, claudeStartupAction, claudeLoginMethodMenu, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, } from "./harnesses/claude.js";
-import { bindCursorTranscriptSession, cursorTurnBoundary, latestCursorCompletion, observeCursorDone, cursorTranscriptText, assertCursorAuthenticationReady, assertCursorModelAvailable, cursorModelChoices, buildCursorAgentCmd, cursorAgentArgv, cursorPwshLaunchLine, cursorPromptWithLineage, createCursorAgentMetadata, cursorLaunchNote, cursorEffortNavigation, cursorTuiReady, cursorPaneObservation, cursorPromptHooksRunning, cursorUsageLimit, CURSOR_SUBMIT_SEQUENCE, CURSOR_COMPOSER_CONTENT_MARKER_RE, validateCursorModelEffort, } from "./harnesses/cursor.js";
+import { grokAuthPlan, grokAuthStatus, grokAuthPane, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokModelChoices, grokEventsTranscript, latestGrokCompletion, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokRateLimitDialog, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
+import { codexAuthPlan, codexAuthStatus, codexAuthPane, bindCodexTranscriptSession, latestCodexCompletion, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, codexModelChoices, } from "./harnesses/codex.js";
+import { claudeAuthPlan, claudeAuthStatus, claudeAuthPane, OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, claudeModelChoices, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, claudePaneObservation, claudeUsageLimit, claudeStartupAction, claudeLoginMethodMenu, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, } from "./harnesses/claude.js";
+import { cursorAuthPlan, cursorAuthStatus, cursorAuthPane, bindCursorTranscriptSession, cursorTurnBoundary, latestCursorCompletion, observeCursorDone, cursorTranscriptText, assertCursorAuthenticationReady, assertCursorModelAvailable, cursorModelChoices, buildCursorAgentCmd, cursorAgentArgv, cursorPwshLaunchLine, cursorPromptWithLineage, createCursorAgentMetadata, cursorLaunchNote, cursorEffortNavigation, cursorTuiReady, cursorPaneObservation, cursorPromptHooksRunning, cursorUsageLimit, CURSOR_SUBMIT_SEQUENCE, CURSOR_COMPOSER_CONTENT_MARKER_RE, validateCursorModelEffort, } from "./harnesses/cursor.js";
 import { readInterimWords, recordInterimBoundary } from "./interim-words.js";
 import { resolveAgentBin, resolveThroughlineBin, runThroughlineHandoffContext, isWindowsNativeExecutable, agentBinForPaneShell, resolveWinPaneShell } from "./agent-resolver.js";
 export { AitermError } from "./errors.js";
@@ -310,7 +310,8 @@ function cleanupAgentState(name) {
                     f.endsWith(".claude-operation.json") ||
                     f.endsWith(".claude-approval.json") ||
                     f.endsWith(".claude-dispatch") ||
-                    f.endsWith(".interim.json"))
+                    f.endsWith(".interim.json") ||
+                    f.endsWith(".auth.json"))
                     fs.unlinkSync(p);
                 else if (f.endsWith(".codex-home") || f.endsWith(".grok-home") || f.endsWith(".cursor-plugin") || f.endsWith(".home")) {
                     fs.rmSync(p, { recursive: true, force: true });
@@ -1339,6 +1340,7 @@ export function killAll() {
                     f.endsWith(".claude-operation.json") ||
                     f.endsWith(".claude-dispatch") ||
                     f.endsWith(".interim.json") ||
+                    f.endsWith(".auth.json") ||
                     f.endsWith(".codex-home") ||
                     f.endsWith(".grok-home") ||
                     f.endsWith(".home")) {
@@ -3341,7 +3343,201 @@ async function waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, timeoutM
     }
     return { ready, codexRateLimitModelSwitch };
 }
-/** 同じ対話sessionを保ったまま、harness標準の操作でmodel／effortを変更する。 */
+function authMetadataPath(name) {
+    assertSessionName(name);
+    return path.join(agentsDir(), `${name}.auth.json`);
+}
+function authPlan(kind, phase) {
+    switch (kind) {
+        case "claude": return claudeAuthPlan(phase === "onboarding");
+        case "codex": return codexAuthPlan();
+        case "grok": return grokAuthPlan();
+        case "cursor": return cursorAuthPlan();
+    }
+}
+function authStatus(kind, bin, cwd, env = process.env) {
+    switch (kind) {
+        case "claude": return claudeAuthStatus(bin, cwd, env);
+        case "codex": return codexAuthStatus(bin, cwd, env);
+        case "grok": return grokAuthStatus();
+        case "cursor": return cursorAuthStatus(bin, cwd, env);
+    }
+}
+function authPane(meta, screen) {
+    switch (meta.kind) {
+        case "claude": return claudeAuthPane(screen, meta.phase === "onboarding");
+        case "codex": return codexAuthPane(screen);
+        case "grok": return grokAuthPane(screen);
+        case "cursor": return cursorAuthPane(screen);
+    }
+}
+function loadAuthMetadata(name, kind) {
+    let source;
+    try {
+        source = fs.readFileSync(authMetadataPath(name), "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            throw new AitermError("AGENT_AUTH_STATE_INVALID: 認証sessionの記録が不正です。", 2);
+        throw error;
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new AitermError("AGENT_AUTH_STATE_INVALID: 認証sessionの記録が不正です。", 2);
+    if (value.kind !== kind)
+        throw new AitermError("AGENT_AUTH_HARNESS_MISMATCH: 認証sessionのharnessが一致しません。", 2);
+    if (typeof value.bin !== "string" || typeof value.cwd !== "string" || !path.isAbsolute(value.cwd)
+        || !["login", "onboarding"].includes(value.phase) || !Array.isArray(value.env_vars)
+        || value.env_vars.some(key => typeof key !== "string" || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))) {
+        throw new AitermError("AGENT_AUTH_STATE_INVALID: 認証sessionの記録が不正です。", 2);
+    }
+    return value;
+}
+/** 一覧の取得失敗を端末の消失へ丸めず、正規PTY一覧で存在を確認する。 */
+function authSessionExists(name) {
+    return listSessionsResult().sessions.some(session => session.session_id === name);
+}
+function authSessionEnvironment(name, keys) {
+    const env = { ...process.env };
+    for (const key of keys) {
+        const value = tmux("show-environment", "-t", name, key);
+        if (value.code !== 0)
+            throw new AitermError("AGENT_AUTH_ENV_UNAVAILABLE: 認証sessionの環境を読めません。", 2);
+        if (value.stdout.trim() === `-${key}`)
+            delete env[key];
+        else if (value.stdout.startsWith(`${key}=`))
+            env[key] = value.stdout.slice(key.length + 1).replace(/\r?\n$/, "");
+        else
+            throw new AitermError("AGENT_AUTH_ENV_INVALID: 認証sessionの環境の形式が不正です。", 2);
+    }
+    return env;
+}
+function launchAuthProcess(name, meta) {
+    const plan = authPlan(meta.kind, meta.phase);
+    const env = plan.env.map(([key, value]) => shq(`${key}=${value}`));
+    const cmd = ["exec", "env", ...env, shq(agentBinForPaneShell(meta.bin)), ...plan.args.map(shq)].join(" ");
+    send(name, `cd ${shq(paneCwdArgument(meta.cwd))} && ${cmd}`, { enter: true, force: true, raw: true });
+}
+/** 公式CLIの認証processを起動・観測する。資格情報の読取り・copy・独自OAuthは行わない。 */
+export async function authenticateAgent(kind, options) {
+    const result = (status, session, message, pane) => ({ schema: "aiterm.agent-auth-result.v1", harness: agentHarness(kind),
+        status, session_id: session, url: pane?.url ?? null, user_code: pane?.user_code ?? null,
+        input_required: pane?.input_required ?? false, message: message ?? pane?.message ?? null });
+    if (options.action === "cancel") {
+        if (!options.session_id)
+            throw new AitermError("AGENT_AUTH_SESSION_REQUIRED: cancelにはsession_idが必要です。", 2);
+        const meta = loadAuthMetadata(options.session_id, kind);
+        if (!authSessionExists(options.session_id)) {
+            if (meta)
+                fs.unlinkSync(authMetadataPath(options.session_id));
+            return result("blocked", null, "認証sessionは既に終了または取消済みです。");
+        }
+        if (!meta)
+            throw new AitermError("AGENT_AUTH_SESSION_NOT_FOUND: 指定sessionはAitermの認証sessionではありません。", 2);
+        closeSession(options.session_id);
+        return result("blocked", null, "認証sessionを取り消しました。");
+    }
+    let name = options.session_id ?? null;
+    let meta;
+    if (options.action === "start") {
+        const cwd = options.cwd ?? process.cwd();
+        if (!path.isAbsolute(cwd) || !fs.statSync(cwd).isDirectory())
+            throw new AitermError("cwdは存在するディレクトリの絶対パスで指定してください。", 2);
+        const bin = resolveAgentBin(kind);
+        if (!bin)
+            return result("failed", null, `${agentLabel(kind)}の公式CLIが見つかりません。`);
+        const before = authStatus(kind, bin, cwd);
+        if (before.status === "failed")
+            return result("failed", null, before.message);
+        if (before.status === "authenticated" && !before.verify_onboarding)
+            return result("authenticated", null, null);
+        const envVars = options.env_vars ?? [];
+        [name] = openSession(name, "bash", envVars);
+        meta = { kind, bin, cwd, phase: before.status === "authenticated" ? "onboarding" : "login",
+            env_vars: envVars.filter(key => process.env[key] !== undefined) };
+        try {
+            const kept = tmux("set-option", "-t", name, "remain-on-exit", "on");
+            if (kept.code !== 0)
+                throw new AitermError("AGENT_AUTH_PANE_CONFIG_FAILED: 認証processの終了観測を設定できません。", 2);
+            writeJson0600(authMetadataPath(name), meta);
+            launchAuthProcess(name, meta);
+        }
+        catch (error) {
+            closeSession(name);
+            throw error;
+        }
+    }
+    else if (!name) {
+        const cwd = options.cwd ?? process.cwd();
+        if (!path.isAbsolute(cwd) || !fs.statSync(cwd).isDirectory())
+            throw new AitermError("cwdは存在するディレクトリの絶対パスで指定してください。", 2);
+        const bin = resolveAgentBin(kind);
+        if (!bin)
+            return result("failed", null, `${agentLabel(kind)}の公式CLIが見つかりません。`);
+        const checked = authStatus(kind, bin, cwd);
+        return result(checked.status === "authenticated" ? "authenticated" : checked.status === "failed" ? "failed" : "blocked", null, checked.message ?? (checked.status === "unauthenticated" ? "公式CLIの認証が必要です。agent_authのstartで開始してください。" : null));
+    }
+    else {
+        const loaded = loadAuthMetadata(name, kind);
+        if (!authSessionExists(name))
+            return result("failed", null, "認証sessionが失われました。agent_authのstartで開始してください。");
+        if (!loaded)
+            throw new AitermError("AGENT_AUTH_SESSION_NOT_FOUND: 指定sessionはAitermの認証sessionではありません。", 2);
+        meta = loaded;
+    }
+    const session = name;
+    const deadline = performance.now() + (options.action === "start" ? 3000 : 0);
+    for (;;) {
+        if (!authSessionExists(session))
+            return result("failed", null, "認証sessionが失われました。agent_authのstartで開始してください。");
+        const observed = tmux("display-message", "-p", "-t", session, "#{pane_dead}\t#{pane_dead_status}");
+        if (observed.code !== 0)
+            return result("failed", session, "認証processの終了状態を取得できません。");
+        const [dead, exit] = observed.stdout.trim().split("\t");
+        const pane = authPane(meta, stripControl(captureScreen(session, 120)));
+        if (dead === "1") {
+            if (exit !== "0")
+                return result("failed", session, `公式認証processが失敗しました（exit=${/^\d+$/.test(exit ?? "") ? exit : "unknown"}）。`);
+            const checked = authStatus(kind, meta.bin, meta.cwd, authSessionEnvironment(session, meta.env_vars));
+            if (checked.status === "failed")
+                return result("failed", session, checked.message);
+            if (checked.status === "unauthenticated")
+                return result("failed", session, "公式認証processは終了しましたが、公式statusは未認証です。");
+            if (!checked.verify_onboarding)
+                return result("authenticated", session, null);
+            if (meta.phase === "onboarding")
+                return result("blocked", session, "公式CLIの初回案内の完了を確認できません。");
+            meta.phase = "onboarding";
+            writeJson0600(authMetadataPath(session), meta);
+            const restarted = tmux("respawn-pane", "-k", "-t", session, resolveWinPaneShell("bash"));
+            if (restarted.code !== 0)
+                return result("failed", session, "公式CLIの初回案内を起動できません。");
+            launchAuthProcess(session, meta);
+            return result("waiting", session, "公式CLIの初回案内を確認しています。");
+        }
+        if (dead !== "0")
+            return result("failed", session, "認証processの生存状態の形式を認識できません。");
+        if (pane.onboarding_complete) {
+            const checked = authStatus(kind, meta.bin, meta.cwd, authSessionEnvironment(session, meta.env_vars));
+            if (checked.status === "authenticated")
+                return result("authenticated", session, null);
+            return result("failed", session, checked.message ?? "公式CLIのstatusが未認証です。");
+        }
+        if (pane.input_required)
+            return result("blocked", session, null, pane);
+        if (pane.url || performance.now() >= deadline)
+            return result("waiting", session, null, pane);
+        await sleep(100);
+    }
+}
 /**
  * harnessが今返すmodelとreasoning effortの候補（agent_models）。各harnessの公式の一覧を読むだけで、
  * promptもturnも送らない。取得不能・形式異常はfallbackせずエラーにする。

package/dist/harnesses/claude.js

@@ -1,3 +1,4 @@
+import { authUrl } from "../agent-auth.js";
 // Claude Code 固有の制御。完了正本は launch 固有 Stop hook が書く event/result（ADR 0025）。
 // core 所有のサービス（transcript 不在エラー）は引数で注入し、
 // 依存方向を core → harnesses → agent-shared の一方向に保つ。
@@ -437,3 +438,27 @@ export function claudeApiErrorAfter(meta, startedAtMs) {
     }
     return null;
 }
+export function claudeAuthPlan(onboarding = false) { return { args: onboarding ? [] : ["auth", "login"], env: [] }; }
+export function claudeAuthStatus(bin, cwd, env = process.env) {
+    const result = spawnAgentControlCommand(bin, ["auth", "status", "--json"], cwd, { cwd, env, encoding: "utf8", timeout: 5000, maxBuffer: 64 * 1024 });
+    let status;
+    try {
+        status = JSON.parse(result.stdout);
+    }
+    catch {
+        return { status: "failed", message: "Claude Codeの公式認証状態を読めません。" };
+    }
+    if (!result.error && result.status === 0 && status?.loggedIn === true)
+        return { status: "authenticated", verify_onboarding: true, message: null };
+    if (!result.error && status?.loggedIn === false)
+        return { status: "unauthenticated", message: null };
+    return { status: "failed", message: "Claude Codeの公式認証状態の確認に失敗しました。" };
+}
+export function claudeAuthPane(screen, onboarding = false) {
+    const url = authUrl(screen, ["claude.ai", "console.anthropic.com", "platform.claude.com"]);
+    const input = /Paste (?:the )?code|Enter (?:the )?(?:authorization )?code|Choose the text style|Select login method:|Press (?:Enter|Return)|do you trust|trust this folder/i.test(screen);
+    const complete = onboarding && (claudeTuiReady(screen) || /Is this a project you created or one you trust/.test(screen));
+    return { url, user_code: null, input_required: input && !complete,
+        message: complete ? null : input ? "Claude Codeの公式画面で入力または初回案内の選択を完了してください。" : null,
+        onboarding_complete: complete };
+}

package/dist/harnesses/codex.js

@@ -1,3 +1,4 @@
+import { authUrl, authUserCode } from "../agent-auth.js";
 // Codex 固有の制御。完了正本は root rollout transcript の task_complete（ADR 0022）。
 // core 所有のサービス（transcript 行読取・rate limit 検知）は引数で注入し、
 // 依存方向を core → harnesses → agent-shared の一方向に保つ。
@@ -6,6 +7,7 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { randomBytes } from "node:crypto";
 import { AitermError } from "../errors.js";
+import { spawnAgentControlCommand } from "../agent-resolver.js";
 import * as steer from "aiterm-steer-delivery";
 import { AITERM_PROFILE } from "../steer-profile.js";
 import { catalogInvalid, catalogUnavailable, checkedCatalog } from "../model-catalog.js";
@@ -779,3 +781,17 @@ export function codexCatalogFromPages(pages) {
         models,
     });
 }
+export function codexAuthPlan() { return { args: ["login", "--device-auth"], env: [] }; }
+export function codexAuthStatus(bin, cwd, env = process.env) {
+    const result = spawnAgentControlCommand(bin, ["login", "status"], cwd, { cwd, env, encoding: "utf8", timeout: 5000, maxBuffer: 64 * 1024 });
+    const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
+    if (!result.error && result.status === 0 && /Logged in/i.test(output))
+        return { status: "authenticated", message: null };
+    if (!result.error && /Not logged in/i.test(output))
+        return { status: "unauthenticated", message: null };
+    return { status: "failed", message: "Codex CLIの公式認証状態を確認できません。" };
+}
+export function codexAuthPane(screen) {
+    return { url: authUrl(screen, ["auth.openai.com", "auth0.openai.com", "login.openai.com"]),
+        user_code: authUserCode(screen), input_required: false, message: null };
+}

package/dist/harnesses/cursor.js

@@ -1,3 +1,4 @@
+import { authUrl } from "../agent-auth.js";
 // Cursor Agent CLI 固有の制御。通常 ~/.cursor を共有し、完了正本は
 // launch markerで一意にbindした agent transcript の turn_ended とする。
 import * as fs from "node:fs";
@@ -568,3 +569,18 @@ export function cursorPaneObservation(screen) {
         return { state: "idle", reason: "composer_ready" };
     return { state: "unknown", reason: "unrecognized_screen" };
 }
+export function cursorAuthPlan() { return { args: ["login"], env: [["NO_OPEN_BROWSER", "1"]] }; }
+export function cursorAuthStatus(bin, cwd, env = process.env) {
+    const result = spawnAgentControlCommand(bin, ["status"], cwd, { cwd, env, encoding: "utf8", timeout: 5000, maxBuffer: 64 * 1024 });
+    const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
+    if (!result.error && /not logged in|unauthenticated|sign in/i.test(output))
+        return { status: "unauthenticated", message: null };
+    // launcherと同じ公式status契約。stderrやアカウント情報はreceiptへ載せない。
+    if (!result.error && result.status === 0)
+        return { status: "authenticated", message: null };
+    return { status: "failed", message: "Cursor Agent CLIの公式認証状態を確認できません。" };
+}
+export function cursorAuthPane(screen) {
+    return { url: authUrl(screen, ["cursor.com", "www.cursor.com", "auth.cursor.com"]),
+        user_code: null, input_required: false, message: null };
+}

package/dist/harnesses/grok.js

@@ -1,3 +1,4 @@
+import { authUrl } from "../agent-auth.js";
 // Grok 固有の制御。Composer は Cursor の model の一つであり、Grok CLI では扱わない
 // （2026-09-27 grok 1.0.41 実測でcatalogに無い）。
 // core 所有のサービス（transcript 行読取・rate limit 検知）は引数で注入し、
@@ -519,3 +520,18 @@ export function createGrokAgentMetadata(kind, name, cwd, initialPrompt, authPath
     writeAgentMetadata(meta);
     return meta;
 }
+export function grokAuthPlan() { return { args: ["login", "--device-auth"], env: [] }; }
+export function grokAuthStatus() {
+    // 現行Grokには公式status commandが無い。auth fileの存在を成功とみなさない。
+    return { status: "unsupported", message: "Grokの認証状態はagent_authで開始した公式ログインsessionの終了結果で確認します。" };
+}
+export function grokAuthPane(screen) {
+    const url = authUrl(screen, ["auth.x.ai", "accounts.x.ai", "grok.com"]);
+    // Grok 1.0.46の公式device画面はverification_uri_completeだけを表示する。
+    // 人へ見せるuser_codeは、その公式URLの同名parameterを読む。
+    const embedded = url ? new URL(url).searchParams.get("user_code") : null;
+    if (embedded !== null && !/^[A-Z0-9-]+$/.test(embedded)) {
+        throw new AitermError("AGENT_AUTH_CHALLENGE_INVALID: Grokの公式URLにあるdevice codeの形式が不正です。", 2);
+    }
+    return { url, user_code: embedded, input_required: false, message: null };
+}

package/dist/index.js

@@ -736,6 +736,36 @@ registerRemoteAwareTool("claude_approval", {
         return fail(e);
     }
 });
+registerRemoteAwareTool("agent_auth", {
+    description: "各harnessの公式CLI認証を開始・確認・取消する。CLIごとのコマンドと認証URL/codeの抽出はAitermが所有し、資格情報は各CLIだけが保存する。" +
+        "waitingのURL/codeを人へ表示し、input_requiredなら同じsessionのpty_send／pty_keyで公式画面へ入力する。" +
+        "authenticatedは認証の結果であり、agent_launchの起動準備完了とは別。remoteは他toolと同じ標準対応。",
+    inputSchema: {
+        harness: z.enum(["claude-code", "codex-cli", "grok-cli", "cursor-cli"]),
+        action: z.enum(["start", "status", "cancel"]),
+        session_id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/).optional(),
+        cwd: z.string().optional().describe("公式CLIを実行する作業ディレクトリの絶対パス"),
+        env_vars: z.array(z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/)).optional().describe("startで認証PTYへ引き継ぐ環境変数名。値はreceiptへ返さない"),
+    },
+    outputSchema: {
+        schema: z.literal("aiterm.agent-auth-result.v1"),
+        harness: z.enum(["claude-code", "codex-cli", "grok-cli", "cursor-cli"]),
+        status: z.enum(["waiting", "authenticated", "blocked", "failed"]),
+        session_id: z.string().nullable(),
+        url: z.string().nullable(),
+        user_code: z.string().nullable(),
+        input_required: z.boolean(),
+        message: z.string().nullable(),
+    },
+}, async ({ harness, ...options }) => {
+    try {
+        const result = await core.authenticateAgent(kindForHarness(harness), options);
+        return { content: [{ type: "text", text: JSON.stringify(result) }], structuredContent: { ...result } };
+    }
+    catch (error) {
+        return fail(error);
+    }
+});
 registerRemoteAwareTool("agent_configure", {
     description: "起動済みのClaude／Codex／Grok／Cursor agent sessionを再起動せず、会話contextを保ったままmodel／reasoning effortを変更する。" +
         "各harnessのCLI標準model操作を使う。Cursorのreasoning_effort変更はmodelと同時指定する。",

package/docs/DESIGN.md

@@ -246,6 +246,14 @@ shell、接続先、各harnessの公式CLIが所有する。
 
 ## Model catalog
 
+`agent_auth`の共通進行はcore、公式command・status・認証画面の解釈は`src/harnesses/`が所有する。CLIの認証processを通常HOMEのPTYへ一度だけ起動し、`remain-on-exit`と`pane_dead_status`で終了を観測する。credentialを読み取る状態管理や独自OAuthは持たず、Aitermが保存するのは認証sessionのharness・実行file・cwd・phase・引き継いだenvの名前だけである。取消と通常のPTY closeでこの相関記録を削除する。
+
+PTYが消失した場合は、相関記録の有無にかかわらず`status`が`failed`、`cancel`が既に終了・取消済みを示す`blocked`を返し、どちらも`session_id:null`となる。保存したsession IDを解除して`start`で再開始できる。生存中の通常PTYやharness不一致、記録の破損・読取り失敗はエラーを返す。
+
+Claude／Codex／Cursorは公式statusを照合する。Grokは公式status commandが無いため、認証sessionの公式login exit 0を正本にし、session無しの確認を`blocked`とする。Claudeはlogin完了後に同じPTYへ公式の初回TUIを用意し、初回案内の入力待ちを`blocked`／`input_required:true`へ写す。認証とlauncherの起動準備は別の結果であり、`agent_launch`のready gateを省略しない。
+
+公開receiptは`aiterm.agent-auth-result.v1`で、公式HTTPS URLと明示device codeだけを抽出する。生の画面本文・credential・token・OAuth callback codeは含めない。人の入力は既存の`pty_send`／`pty_key`で同じPTYへ送る。`remote`は標準のremote tool中継を使い、callerはCLI commandや環境ごとの入力方言を組み立てない。
+
 `agent_models`は、harnessが今選べるmodelとreasoning effortを、そのharness自身の一覧から返す。
 BellTeam等の画面は、保存した固定の一覧ではなく、agentを実際に動かす端末のharnessが返す候補を使う。
 取得口、出力形式、model IDとeffortの変換は各harness adapterが持ち、`src/model-catalog.ts`は

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.45.2",
+  "version": "0.46.1",
   "mcpName": "io.github.kitepon/aiterm-mcp",
   "description": "Persistent terminal MCP with one harness-based launcher for Claude Code, Codex CLI, Grok CLI, and Cursor Agent CLI, plus durable PTYs for SSH, containers, and REPLs.",
   "keywords": [