openinputbridge-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,29 @@
+MIT License
+
+Copyright (c) 2026 OpenInputBridge-MCP Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+NOTE: This project communicates with the OpenInputBridge driver by directly
+implementing the IOCTL protocol documented in OpenInputBridge's
+docs/PROTOCOL.md. It does not use, link against, or redistribute any code
+from oblitum/Interception (which is separately dual-licensed under LGPL /
+commercial terms). See NOTICE.md for details.

package/README.md

@@ -0,0 +1,211 @@
+# OpenInputBridge-MCP
+
+[![Build](https://github.com/Applet-LLC/OpenInputBridge-MCP/actions/workflows/build.yml/badge.svg)](https://github.com/Applet-LLC/OpenInputBridge-MCP/actions/workflows/build.yml)
+
+**[OpenInputBridge](https://github.com/Applet-LLC/OpenInputBridge)(Interception互換のカーネルレベル キーボード/マウス入力ドライバ)を、MCP (Model Context Protocol) 経由のツールとして公開するサーバーです。**
+
+GUI/ネイティブアプリのテスト自動化における `SendInput()` / UI Automation / 座標ベース自動化ツールの代替・上位互換として、AIエージェント(Claude Codeなど)やテストコードから、カーネルレベルの合成キーボード/マウス入力を送信できます。
+
+> ⚠️ 本プロジェクトは [oblitum/Interception](https://github.com/oblitum/Interception)(LGPL/商用デュアルライセンス)のコードには一切依存していません。ヘルパー実行ファイル(`helper/oib_bridge.c`)は、OpenInputBridge本体の [`docs/PROTOCOL.md`](https://github.com/Applet-LLC/OpenInputBridge/blob/main/docs/PROTOCOL.md) に文書化されたワイヤプロトコルのみを根拠に、独自にIOCTLを実装しています。
+
+## これは何のためのツールか
+
+`SendInput()` / UI Automation / PyAutoGUI・Selenium等の座標ベース自動化には、テスト自動化の現場でよく遭遇する構造的な限界があります。本ツールはそれらを、ドライバレベルで合成入力を注入することで回避します。
+
+| よくある失敗パターン | 原因 | 本ツールでの解決 |
+|---|---|---|
+| 管理者権限で起動したアプリに入力が届かない | UIPI (User Interface Privilege Isolation) により、非管理者プロセスからの合成入力が上位integrity levelのウィンドウにブロックされる | カーネルドライバ層でHIDスタックに直接介在するため、送信元プロセスのintegrity levelに依存しない |
+| RDP/仮想マシン/CI専用機で不安定 | 仮想ディスプレイやリモートセッションでは、`SendInput` が前提とするフォアグラウンドウィンドウ/デスクトップの扱いが環境依存になりやすい | ドライバはセッションが物理/仮想いずれであってもHIDスタック側で動作する |
+| UI Automation/PyAutoGUIが解像度・DPI変更で壊れる | 画面座標やUI要素のプロパティに依存する | キーのメイクコード/マウスの相対移動量ベースで送信するため、解像度非依存 |
+| 一部アプリが合成入力(`SendInput`由来)を区別・無視する | アプリによっては `SendInput` のフラグやRAW_INPUTの出自を見て弾く実装がある | 物理デバイスと同じ経路(`KEYBOARD_INPUT_DATA`/`MOUSE_INPUT_DATA`)でHIDスタックに入るため、アプリ側から区別しにくい |
+
+**注意**: 上記はあくまで技術的な限界の回避策であり、「検知されない」ことを保証するものではありません。カーネルレベルのフィルタドライバ自体が検知され得ることは [SECURITY.md](SECURITY.md) に記載しています。**自分が権限を持つ/管理しているテスト環境以外(他社のゲーム・アプリのアンチチート回避目的など)での利用は想定しておらず、対象ソフトウェアの利用規約に違反する可能性がある用途には使用しないでください。**
+
+## アーキテクチャ
+
+```mermaid
+flowchart TB
+    Client["MCPクライアント<br/>(Claude Desktop / Claude Code など)"]
+
+    subgraph Server["openinputbridge-mcp (Node.js/TypeScript)"]
+        direction TB
+        McpServer["MCP Server<br/>(stdio transport, ネットワーク非公開)"]
+        Safety["Safety Gate<br/>arm必須化 + レート制限"]
+        Bridge["OibBridge<br/>JSON Linesクライアント"]
+        McpServer --> Safety --> Bridge
+    end
+
+    subgraph Helper["oib_bridge.exe (自作Cヘルパー, MIT)"]
+        direction TB
+        StdioLoop["stdin/stdout<br/>JSON Lines プロトコル"]
+        Watchdog["排他モード<br/>ウォッチドッグスレッド"]
+        Ioctl["DeviceIoControl呼び出し"]
+        StdioLoop --> Ioctl
+        Watchdog -.監視.-> Ioctl
+    end
+
+    subgraph Driver["OpenInputBridgeドライバ"]
+        direction TB
+        Devices["\\.\interception00-19<br/>(コントロールデバイス)"]
+        Filter["oib_kbd.sys / oib_mou.sys<br/>(キーボード/マウス フィルタドライバ)"]
+        Devices --> Filter
+    end
+
+    Target["対象アプリケーション<br/>(実際のキーボード/マウス入力として着弾)"]
+
+    Client -- "MCPプロトコル (stdio, JSON-RPC)" --> McpServer
+    Bridge -- "子プロセスspawn<br/>stdin/stdout (JSON Lines)" --> StdioLoop
+    Ioctl -- "IOCTL_WRITE / IOCTL_SET_FILTER 等" --> Devices
+    Filter -- "合成入力として注入<br/>(実HIDスタックと同じ経路)" --> Target
+```
+
+- **stdioトランスポートのみ**。ネットワークリスナーは一切持ちません。MCPクライアントがローカルでサブプロセス起動する通常の使い方のみを想定しています。
+- ヘルパー(`oib_bridge.exe`)とドライバの間は `docs/PROTOCOL.md` を単一の仕様源とし、`third_party/interception`(LGPL)には一切依存しません。
+- MCPサーバー(Node.js)とヘルパー(C)の間は、1行1JSONオブジェクトの単純なリクエスト/レスポンスプロトコルです。
+
+## できること(v1ツール一覧)
+
+**送信専用**です。物理入力の内容を読み取る/監視するツールは意図的に含んでいません(詳細は [SECURITY.md](SECURITY.md))。
+
+| ツール | できること |
+|---|---|
+| `enable_input_control` | このセッションで送信系ツールを有効化する(**最初に必ず1回呼ぶ必要がある**) |
+| `disable_input_control` | 送信系ツールを無効化する |
+| `get_driver_status` | ドライバのインストール状況・バージョン・キーボード/マウスのスロット構成を確認する(診断用、armなしで呼べる) |
+| `press_key` | 1キーをタップ(押して離す)。Ctrl+A等の修飾キー同時押しにも対応 |
+| `key_down` / `key_up` | キーを押しっぱなしにする/離す(複合ジェスチャ用) |
+| `type_text` | 文字列をキーストローク列として送信する(US/JIS/独/仏/露配列は自動判定対応、韓国語字母・台湾注音符号は明示指定) |
+| `mouse_move` | マウスを相対/絶対移動する(絶対移動は`virtualDesktop:true`でマルチモニタ全体を対象にできる) |
+| `mouse_click` | マウスボタン(左/右/中/X1/X2)のクリック・押下・解放 |
+| `mouse_wheel` | 垂直/水平ホイールのスクロール |
+| `enable_exclusive_input_mode` | **排他モード**: 物理キーボード/マウスの入力を全スロットで捕捉・破棄し、このセッションからの合成入力だけを対象アプリに届ける(CI/専用テスト機向け、要armかつ強い注意が必要) |
+| `disable_exclusive_input_mode` | 排他モードを解除する(**armなしでも常に呼び出せるエスケープハッチ**) |
+| `get_exclusive_mode_status` | 排他モードが現在有効かどうかを確認する |
+
+## AIエージェントが知っておくべき仕様
+
+このMCPサーバーを操作するAIエージェント(あるいはそれを実装する開発者)は、以下を理解しておく必要があります。
+
+### 1. 送信前に必ず `enable_input_control` を呼ぶ
+
+サーバー起動直後は全ての送信系ツール(`press_key`等)が `NotArmedError` で拒否されます。MCPクライアント自体のツール許可UIとは別に、このドライバ固有の強力さに見合ったもう一段の明示的な同意ステップです。セッション中に1回呼べば、以降はそのプロセスが生きている間は有効です。
+
+### 2. キー名はDOM `KeyboardEvent.code` 語彙
+
+`press_key`/`key_down`/`key_up` の `key` パラメータは、Playwright/Seleniumのテスト自動化エンジニアに馴染みのある [DOM `KeyboardEvent.code`](https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_code_values) 命名(`KeyA`〜`KeyZ`, `Digit0`〜`Digit9`, `Enter`, `ArrowUp`, `ShiftLeft`, `F1`〜`F12` 等、JIS配列専用の`IntlRo`/`IntlYen`/`Convert`/`NonConvert`/`KanaMode`も含む)を使います。完全な一覧は [`src/keycodes.ts`](src/keycodes.ts) の `KEY_TABLE` を参照してください。これらは物理キー位置ベースなのでレイアウトに依存せず動作します。
+
+`type_text` は入力された**文字**からキー+Shift状態を逆算する必要があり、これはOS側のアクティブなキーボードレイアウトに依存します。既定(`layout: "auto"`)では、フォーカス中のウィンドウの入力ロケールを呼び出しごとに検出し、`us`/`jis`(日本語)/`de`(ドイツ語QWERTZ)/`fr`(フランス語AZERTY)/`ru`(ロシア語ЙЦУКЕН)を自動選択します(`layout`パラメータで明示指定も可能)。**US/JISのみ実機で検証済み**です([test/REALWORLD_TESTING.md](test/REALWORLD_TESTING.md)参照)。独/仏/露は標準的なレイアウト仕様を基にした未検証の実装です。
+
+`ko`(韓国語2ベルシク)・`tw`(台湾注音符号)も`layout`パラメータで明示指定できますが、**IMEによる合成(ハングル音節・漢字への変換)は行わず、字母/注音記号を1文字ずつそのまま送信します**(例: `layout:"ko"`で"r"+"k"を送ると、合成された音節「가」ではなく字母「ㄱ」「ㅏ」が個別に送信される)。この2つは自動判定の対象外です — 同じ韓国語/繁体中国語キーボードレイアウトのままIMEのON/OFF状態だけが切り替わることがあり、レイアウトのLANGIDだけからは判別できないため、明示的に`layout`を指定した場合のみ有効になります。
+
+**中国語(拼音入力)を扱う場合は `layout: "us"`(または `"auto"`)を使ってください。** 中国語入力で主に使われる拼音(ピンイン)方式は、物理キーボード自体はUS配列(QWERTY)そのままで、ローマ字を打鍵した内容をIMEが漢字に変換する仕組みのため、専用のキー配列テーブルは不要です。ただしこれも他の言語と同様、実際のIME変換(拼音→漢字)はスコープ外です。`type_text` はローマ字までしか送れず、続く候補選択・確定はこのMCPサーバーの対象外です。注音符号(ボポモフォ)方式で入力したい場合のみ、上記の `layout: "tw"` で未合成の注音記号を送信できます。
+
+上記いずれのレイアウトも、実際のIME変換(ひらがな/漢字、ハングル音節合成、拼音→漢字等)を経由した入力はスコープ外です。
+
+### 3. `type_text` は全体を検証してから送信する(部分的な副作用なし)
+
+未対応文字(非ASCII等)が1文字でも含まれる場合、何も送信せずエラーを返します。途中まで入力されて残りが失敗する、という状態にはなりません。
+
+### 4. デバイススロットの境界は可変
+
+`\\.\interception00`〜`19` の20スロットのうち、どこまでがキーボードでどこからがマウスかは、ドライバのインストール時設定(`KeyboardSlotCount`)次第で変わります(デフォルトは10/10)。ツール側のデフォルト値(キーボード系は`device=0`、マウス系は`device=10`)は既定構成を前提にしているため、複数デバイス/非既定構成を扱う場合は `get_driver_status` の `keyboardSlotCount`/`mouseSlotCount` を先に確認してください。
+
+### 5. レート制限がある
+
+既定では10秒間に最大500入力イベントまで(環境変数 `OIB_MCP_RATE_LIMIT_MAX` / `OIB_MCP_RATE_LIMIT_WINDOW_MS` で変更可能)。暴走したエージェント(プロンプトインジェクション含む)が入力を連射し続けることを防ぐためのものです。超過すると `RateLimitError` が返ります。
+
+### 6. 排他モードは強力・危険。CI/専用テスト機以外では使わない
+
+`enable_exclusive_input_mode` を有効化すると、**オペレーターが物理キーボード/マウスを操作しても対象アプリには一切反映されなくなります**。日常利用中のPCで有効化すると物理入力が使えなくなるため、無人のテスト実行環境(CI・専用テスト機)での利用のみを想定しています。
+
+- ハートビートが一定時間(既定5秒、`watchdogTimeoutMs`で設定可)途絶えると自動的に解除されます
+- `disable_exclusive_input_mode` は arm状態やレート制限に関係なく**常に呼び出せます**
+- MCPサーバーやAIエージェント自体が応答不能になった場合の最終手段として、**`oib_bridge.exe` プロセスを終了させると、ドライバ側の仕組みにより即座に物理入力が復元されます**(Interceptionプロトコルのハンドルクローズ時クリーンアップによるもので、他のいかなるプロセスもこれを代替できません)。詳細は [SECURITY.md](SECURITY.md) を参照してください。
+
+### 7. v1には「読み取り・監視系」ツールがない
+
+物理キーボード/マウスの入力内容をAIエージェントに渡すツール(`IOCTL_READ`/`interception_receive`相当)は意図的に実装していません。これは「MCP経由でAIがシステム全体のキー入力を盗聴できる」という最も深刻な悪用シナリオを設計上排除するためです。
+
+## 前提条件
+
+- **Windows専用**(OpenInputBridge自体がWindows専用のため)
+- [OpenInputBridge](https://github.com/Applet-LLC/OpenInputBridge) ドライバがインストール済み・起動していること(`sc.exe query OpenInputBridgeKeyboard` / `OpenInputBridgeMouse` が `RUNNING`)
+- Node.js 18以上
+- ヘルパー実行ファイルのビルドに Visual Studio 2022 (C++ ビルドツール) — 事前ビルド済みバイナリの配布は今後の予定です(下記「既知の制限」参照)
+
+## クイックスタート
+
+```powershell
+git clone https://github.com/Applet-LLC/OpenInputBridge-MCP.git
+cd OpenInputBridge-MCP
+npm install
+npm run build
+
+# C ヘルパーのビルド (Visual Studio Developer PowerShell/コマンドプロンプトで)
+cl.exe /nologo /W4 /utf-8 /Fe:helper\oib_bridge.exe helper\oib_bridge.c
+```
+
+npm公開後は `npx openinputbridge-mcp` でのビルド不要インストールを予定していますが、現時点では未公開のため上記のソースビルドが必要です(詳細は「既知の制限」参照)。
+
+MCPクライアント(例: Claude Code の `.mcp.json`)に登録します。
+
+```json
+{
+  "mcpServers": {
+    "openinputbridge": {
+      "command": "node",
+      "args": ["C:\\path\\to\\OpenInputBridge-MCP\\dist\\index.js"]
+    }
+  }
+}
+```
+
+接続後、まず `get_driver_status` でドライバが認識されているか確認し、`enable_input_control` を呼んでから各ツールを使用してください。
+
+## 既知の制限
+
+実機(OpenInputBridgeインストール環境)での検証を実施済みです。詳細は [test/REALWORLD_TESTING.md](test/REALWORLD_TESTING.md) を参照してください。
+
+- **US/JIS/独/仏/露配列に対応**(`type_text`が呼び出しごとにフォーカス中ウィンドウのレイアウトを自動検出、明示指定も可)。**US/JISのみ実機検証済み**、独/仏/露は標準仕様ベースの未検証実装です。韓国語字母・台湾注音符号は明示指定のみ(自動判定対象外)、いずれもIME合成なしの生記号送信です。**中国語(拼音入力)は物理配列がUS配列と同一のため専用レイアウトは無く、`layout:"us"`(既定の`"auto"`でも可)を使用**します。IME経由のひらがな/漢字/ハングル音節/拼音変換等はスコープ外
+- JIS配列の「¥」キーは(Windowsの既知の仕様により)実際にはASCIIバックスラッシュを送出し、真のyen記号文字(U+00A5)を`type_text`で入力する手段はありません(物理キーそのものは`press_key({key:"IntlYen"})`で押せます)
+- `type_text`でShift状態を1文字ごとに切り替える極端なパターン(例: `"MiXeD"`)は、タイミング対策後も一部の文字でShiftが反映されないことがあります。通常の英文・識別子等では問題にならないことを確認済みです
+- マウスの相対移動(`mouse_move`, `absolute:false`)はOSのポインタ加速の影響を受けるため、指定した移動量とカーソルの実際の移動量は一致しません(物理マウスと同じ経路のため、想定通りの挙動)
+- マウスの絶対移動(`absolute:true`)の0-65535正規化座標は、既定では**プライマリモニタの物理ピクセル範囲**にマッピングされます(DPIスケーリング設定とは無関係。標準Win32 `SendInput`の`MOUSEEVENTF_ABSOLUTE`と同じ仕様)。**セカンダリモニタなど、仮想デスクトップ全体を対象にしたい場合は`virtualDesktop:true`を指定してください**(標準`SendInput`の`MOUSEEVENTF_VIRTUALDESK`相当)。マルチモニタ環境では相対移動(`absolute:false`)でモニタ境界をまたぐことも可能です。実機検証・`mouse_click`によるクリック精度確認済みです(詳細は [test/REALWORLD_TESTING.md](test/REALWORLD_TESTING.md) の項目6)
+- **Bluetoothキーボード/マウス等、切断され得るデバイスでは、非接続時に送信が失敗します**: OpenInputBridgeデバイスドライバは、その時点で実際に接続されているキーボード/マウスのみを対象とします。Bluetooth接続の入力デバイスが省電力モードなどで切断状態になっている間は、MCPサーバー経由の入力送信も失敗します。常時接続の有線デバイス、またはCI/専用テスト機での利用を推奨します
+- **Windows専用**
+- **読み取り・監視系ツールなし**(意図的、上記参照)
+- **事前ビルド済みバイナリ未配布**: 現状 `helper/oib_bridge.c` を利用者自身がビルドする必要があります。npm公開の準備(`.github/workflows/release.yml`、`scripts/check-native-binary.mjs`等)は整いましたが、実際の公開はまだ行っていません。長期有効なトークンをリポジトリに置かない[npm Trusted Publishing(OIDC)](https://docs.npmjs.com/trusted-publishers/)方式を採用する予定で、Trusted Publisherの設定自体は「既存パッケージの設定ページ」から行う仕様のため、最初の1回だけ保守側が手元から`npm publish`する必要があります(それ以降のリリースは`release.yml`がタグpushで自動公開)。公開後もビルド成果物(`oib_bridge.exe`)はコード署名されない見込みで、初回実行時にWindows SmartScreen等の警告が出る可能性があります(署名は将来検討)
+
+## セキュリティ
+
+このツールが持つ能力(無昇格プロセスからのシステム全体入力の注入)のリスクと、実装済みの安全機構については [SECURITY.md](SECURITY.md) を必ず読んでください。
+
+## ロードマップ
+
+| マイルストーン | 内容 | 状態 |
+|---|---|---|
+| M1 | プロトタイプ: Cヘルパー(`oib_bridge.exe`) + TypeScript製MCPサーバーのスケルトン | ✅ 完了 |
+| M2 | v1ツール一式(送信専用)+ セーフティ機構(arm/レート制限)の実装 | ✅ 完了 |
+| M3 | 排他モードの実装(物理入力の捕捉・破棄、ウォッチドッグによる自動解除) | ✅ 完了 |
+| M4 | 実機検証(実際のOpenInputBridgeインストール環境での動作確認・バグ修正、US/JIS配列対応) | ✅ 完了(詳細は [test/REALWORLD_TESTING.md](test/REALWORLD_TESTING.md)) |
+| M5 | GitHubでの公開(MITライセンス、パブリックリポジトリ) | ✅ 完了 |
+| M6 | GitHub Actionsによるビルド検証(push/PRごとにCヘルパー+TypeScript双方をビルド、`oib_bridge.exe`のスモークテスト) | ✅ 完了 |
+| M6b | ビルド成果物の署名検討、npmパッケージ公開(`npx openinputbridge-mcp`) | 🚧 公開準備完了(タグpush時の`release.yml`、Trusted Publishing対応)、実公開は初回手動publish + Trusted Publisher設定待ち |
+| M7 | クローズドベータ: 複数環境(非既定`KeyboardSlotCount`構成、複数物理キーボードの個別指定送信、他レイアウト等)での動作確認 | 🔲 未着手 |
+| M8 | MCPサーバーディレクトリへの掲載検討(安定運用の確認後) | 🔲 未着手 |
+
+今後の検証・改善候補(優先度未確定、詳細は [test/REALWORLD_TESTING.md](test/REALWORLD_TESTING.md) の「未実施の検証」参照):
+
+- 非既定の`KeyboardSlotCount`構成での動作確認
+- 複数物理キーボードを`device`パラメータで個別指定して送信する動作の確認
+- 独/仏/露/韓国語字母/台湾注音符号レイアウトの実機検証(現状は標準仕様ベースの未検証実装)
+- 中国語(拼音等)・韓国語・台湾のIME合成対応(現状はIME非対応が既定方針。将来検討)
+
+## ライセンス
+
+[MIT](LICENSE)。`third_party/interception`(LGPL)のコードには一切依存していません。
+
+## Contributors
+
+- **[Applet-LLC](https://github.com/Applet-LLC)** — プロジェクトオーナー
+- **Claude**([Anthropic](https://www.anthropic.com/)、[Claude Code](https://claude.com/claude-code) 経由)— 実装・実機検証・ドキュメント作成に貢献

package/dist/bridge.js

@@ -0,0 +1,224 @@
+/**
+ * Manages the oib_bridge.exe child process and speaks its JSON-Lines
+ * request/response protocol over stdin/stdout (one JSON object per line,
+ * matched by numeric "id"; lines with no "id" are unsolicited events -
+ * currently only the watchdog's exclusive-mode auto-disable notice). See
+ * helper/oib_bridge.c for the protocol.
+ */
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { EventEmitter } from "node:events";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export class OibBridgeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OibBridgeError";
+    }
+}
+/** Locates the compiled helper executable: packaged (bin/) first, then a local source build (helper/). */
+export function resolveHelperExePath() {
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(moduleDir, "..", "bin", "oib_bridge.exe"),
+        join(moduleDir, "..", "helper", "oib_bridge.exe"),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    throw new OibBridgeError(`oib_bridge.exe not found. Looked in:\n  ${candidates.join("\n  ")}\n` +
+        "Build it from helper/oib_bridge.c (see README.md) or install a packaged release.");
+}
+const DEFAULT_REQUEST_TIMEOUT_MS = 3000;
+/** Heartbeats are sent at roughly a third of the watchdog timeout, never below this. */
+const MIN_HEARTBEAT_INTERVAL_MS = 500;
+export class OibBridge extends EventEmitter {
+    exePath;
+    child = null;
+    rl = null;
+    nextId = 1;
+    pending = new Map();
+    heartbeatTimer = null;
+    constructor(exePath = resolveHelperExePath()) {
+        super();
+        this.exePath = exePath;
+    }
+    ensureStarted() {
+        if (this.child)
+            return this.child;
+        const child = spawn(this.exePath, [], { stdio: ["pipe", "pipe", "pipe"] });
+        this.child = child;
+        const rl = createInterface({ input: child.stdout });
+        rl.on("line", (line) => this.handleLine(line));
+        this.rl = rl;
+        child.on("exit", (code, signal) => this.handleTermination(code, signal));
+        child.on("error", (err) => this.handleTermination(null, null, err));
+        return child;
+    }
+    handleLine(line) {
+        if (!line)
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            return; // malformed line from the helper; ignore rather than crash the server
+        }
+        if (typeof msg.event === "string") {
+            this.handleEvent(msg);
+            return;
+        }
+        const response = msg;
+        const pending = this.pending.get(response.id);
+        if (!pending)
+            return;
+        this.pending.delete(response.id);
+        clearTimeout(pending.timer);
+        pending.resolve(response);
+    }
+    handleEvent(evt) {
+        if (evt.event === "exclusive_mode_auto_disabled") {
+            this.stopHeartbeat();
+            this.emit("exclusiveModeAutoDisabled", {
+                reason: String(evt.reason ?? "unknown"),
+                failedDeviceCount: Number(evt.failedDeviceCount ?? 0),
+            });
+        }
+    }
+    handleTermination(code, signal, spawnError) {
+        this.stopHeartbeat();
+        const reason = spawnError
+            ? `failed to launch oib_bridge.exe: ${spawnError.message}`
+            : `oib_bridge.exe exited unexpectedly (code=${code ?? "null"}, signal=${signal ?? "null"})`;
+        const err = new OibBridgeError(reason);
+        for (const req of this.pending.values()) {
+            clearTimeout(req.timer);
+            req.reject(err);
+        }
+        this.pending.clear();
+        this.rl?.close();
+        this.rl = null;
+        this.child = null;
+    }
+    request(cmd, fields = {}, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
+        const child = this.ensureStarted();
+        const id = this.nextId++;
+        const line = JSON.stringify({ id, cmd, ...fields }) + "\n";
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new OibBridgeError(`bridge request timed out: ${cmd}`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            child.stdin.write(line, (err) => {
+                if (err) {
+                    this.pending.delete(id);
+                    clearTimeout(timer);
+                    reject(new OibBridgeError(`failed to write to oib_bridge.exe: ${err.message}`));
+                }
+            });
+        }).then((msg) => {
+            if (!msg.ok) {
+                throw new OibBridgeError(msg.error ?? `${cmd} failed with no error message`);
+            }
+            return msg;
+        });
+    }
+    async status() {
+        const msg = await this.request("status");
+        return {
+            installed: true,
+            versionMajor: Number(msg.versionMajor),
+            versionMinor: Number(msg.versionMinor),
+            keyboardSlotCount: msg.keyboardSlotCount !== undefined ? Number(msg.keyboardSlotCount) : undefined,
+            mouseSlotCount: msg.mouseSlotCount !== undefined ? Number(msg.mouseSlotCount) : undefined,
+            exclusiveModeActive: Boolean(msg.exclusiveModeActive),
+        };
+    }
+    /** Returns the Windows LANGID (low word of the HKL) of whatever window currently has focus. */
+    async getActiveKeyboardLayout() {
+        const msg = await this.request("get_active_keyboard_layout");
+        return Number(msg.languageId);
+    }
+    async writeKey(device, makeCode, down, extended) {
+        await this.request("write_key", {
+            device,
+            makeCode,
+            down: down ? 1 : 0,
+            extended: extended ? 1 : 0,
+        });
+    }
+    async writeMouseButton(device, buttonFlags) {
+        await this.request("write_mouse_button", { device, buttonFlags });
+    }
+    async writeMouseMove(device, x, y, absolute, virtualDesktop = false) {
+        await this.request("write_mouse_move", {
+            device,
+            x,
+            y,
+            absolute: absolute ? 1 : 0,
+            virtualDesktop: virtualDesktop ? 1 : 0,
+        });
+    }
+    async writeMouseWheel(device, rolling, horizontal) {
+        await this.request("write_mouse_wheel", { device, rolling, horizontal: horizontal ? 1 : 0 });
+    }
+    /**
+     * Arms exclusive input mode: every physical keyboard/mouse slot captures
+     * and discards real input, while this bridge's own write* calls still
+     * reach the real input stream. Starts sending periodic heartbeats so the
+     * helper's watchdog doesn't auto-disable it. See helper/oib_bridge.c.
+     */
+    async enableExclusiveMode(watchdogTimeoutMs) {
+        const msg = await this.request("enable_exclusive_input_mode", { watchdogTimeoutMs }, 5000);
+        const info = {
+            keyboardSlotCount: Number(msg.keyboardSlotCount),
+            mouseSlotCount: Number(msg.mouseSlotCount),
+            watchdogTimeoutMs: Number(msg.watchdogTimeoutMs),
+        };
+        this.startHeartbeat(info.watchdogTimeoutMs);
+        return info;
+    }
+    async disableExclusiveMode() {
+        this.stopHeartbeat();
+        const msg = await this.request("disable_exclusive_input_mode", {}, 5000);
+        return {
+            wasActive: Boolean(msg.wasActive),
+            failedDeviceCount: Number(msg.failedDeviceCount ?? 0),
+        };
+    }
+    /** Sends one heartbeat and returns the helper's authoritative exclusive-mode state. */
+    async heartbeat() {
+        const msg = await this.request("heartbeat");
+        return Boolean(msg.exclusiveModeActive);
+    }
+    startHeartbeat(watchdogTimeoutMs) {
+        this.stopHeartbeat();
+        const intervalMs = Math.max(MIN_HEARTBEAT_INTERVAL_MS, Math.floor(watchdogTimeoutMs / 3));
+        this.heartbeatTimer = setInterval(() => {
+            this.request("heartbeat").catch(() => {
+                // Best-effort; if the bridge is gone, handleTermination() already
+                // stopped this timer and rejected everything else.
+            });
+        }, intervalMs);
+        this.heartbeatTimer.unref?.();
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    /** Terminates the helper process, if running. Safe to call multiple times. */
+    dispose() {
+        this.stopHeartbeat();
+        if (!this.child)
+            return;
+        this.child.stdin?.end();
+        this.child.kill();
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * openinputbridge-mcp entry point. Starts an MCP server over stdio that
+ * exposes OpenInputBridge (kernel-level, Interception-compatible key/mouse
+ * injection) as SendInput()-alternative tools for GUI/native-app test
+ * automation. See README.md for setup and SECURITY.md for the safety model.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { OibBridge } from "./bridge.js";
+import { SafetyGate, DEFAULT_SAFETY_OPTIONS } from "./safety.js";
+import { registerTools } from "./tools.js";
+function readSafetyOptionsFromEnv() {
+    const maxEventsPerWindow = Number(process.env.OIB_MCP_RATE_LIMIT_MAX ?? DEFAULT_SAFETY_OPTIONS.maxEventsPerWindow);
+    const windowMs = Number(process.env.OIB_MCP_RATE_LIMIT_WINDOW_MS ?? DEFAULT_SAFETY_OPTIONS.windowMs);
+    return {
+        maxEventsPerWindow: Number.isFinite(maxEventsPerWindow) && maxEventsPerWindow > 0 ? maxEventsPerWindow : DEFAULT_SAFETY_OPTIONS.maxEventsPerWindow,
+        windowMs: Number.isFinite(windowMs) && windowMs > 0 ? windowMs : DEFAULT_SAFETY_OPTIONS.windowMs,
+    };
+}
+async function main() {
+    if (process.platform !== "win32") {
+        process.stderr.write("openinputbridge-mcp: OpenInputBridge is Windows-only; this process will start but every tool call will fail.\n");
+    }
+    const bridge = new OibBridge();
+    const safety = new SafetyGate(readSafetyOptionsFromEnv());
+    bridge.on("exclusiveModeAutoDisabled", (info) => {
+        process.stderr.write(`openinputbridge-mcp: exclusive input mode was auto-disabled by the watchdog ` +
+            `(reason=${info.reason}, failedDeviceCount=${info.failedDeviceCount}); physical input restored.\n`);
+    });
+    const server = new McpServer({
+        name: "openinputbridge-mcp",
+        version: "0.1.0",
+    });
+    registerTools(server, bridge, safety);
+    const shutdown = () => {
+        bridge.dispose();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`openinputbridge-mcp: fatal error: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,SAAS,wBAAwB;IAC/B,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IACnH,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACrG,OAAO;QACL,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,sBAAsB,CAAC,kBAAkB;QAClJ,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ;KACjG,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gHAAgH,CACjH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAE1D,MAAM,CAAC,EAAE,CAAC,2BAA2B,EAAE,CAAC,IAAI,EAAE,EAAE;QAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8EAA8E;YAC5E,WAAW,IAAI,CAAC,MAAM,uBAAuB,IAAI,CAAC,iBAAiB,+BAA+B,CACrG,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7H,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}