Codex Micro Focused App通知解析

Codex-Micro-Host-Focused-App.md

Codex Micro Focused App通知解析

解析日: 2026-08-07

host.focused_app

ホストで現在フォーカスされているアプリ情報をデバイスへ通知するJSON-RPC。デバイス側の画面表示やコンテキスト別Profile切り替えに利用できる。

{
  "method": "host.focused_app",
  "params": {
    "appName": "Google Chrome",
    "process": "Google Chrome",
    "path": "/Applications/Google Chrome.app"
  },
  "id": 123
}

すべてのparamsフィールドは任意。

フィールド	意味
appName	人間向けアプリ名
process	Process / executable名
path	Application bundleまたは実行ファイルのPath

応答

互換デバイス側で機能を使わない場合でも、RPCキューを進めるため成功応答を返す。

{"result":{"ok":1},"id":123,"method":"host.focused_app"}

応答はVendor HID Report ID 6 Inputで送信し、末尾へCRLFを付ける。

注意点

• pathやアプリ名には非ASCII文字が含まれる可能性がある
• Host側SDKは非ASCII文字をUnicode escapeして送る
• 前回値と同じ場合の重複処理を省略してよい
• デバイスで機能を実装しなくても、無応答にしない