ssmcp 統合ワークスペースブリッジ
マシンとその機能を発見する
最初に list を呼び出します。各クライアントのオプションの title を使用してそのタスクを理解し、name と cwd を確認します。返された id でクライアントを選択します。タイトル、名前、ホスト名はラベルであり、重複する可能性があります。code_mode 内で tools.search(clientId,{query,limit:20}) を使用して簡潔なツールの概要を見つけます。呼び出す前に、完全なネイティブ記述子が必要な場合は include_schemas:true を要求します。古いブローカーでは、list({client_id}) または tools(clientId,cursor) のページネーションを使用します。各ネイティブバックエンドの権限と承認ポリシーを尊重します。
各ツールカタログの走査は、返されたカーソル上に維持します。そのページは、ネイティブツールディレクトリが変更されてもスナップショットを共有します。更新を発見するには、新しいカーソルフリーのリクエストを開始します。クライアントは最大4つのスナップショットと合計64 MiBのシリアル化されたJSONを保持します。各ページ読み取りが成功すると120秒のアイドルタイムアウトが更新されますが、スナップショットは作成後最大900秒で期限切れになります。無効なカーソルでは更新されず、変更されていないカタログを再利用しても作成時間はリセットされません。LRUと容量制限により、より早く削除される可能性があります。サーバーがスナップショットの期限切れまたは削除を報告した場合は、検出を再開します。
現在のクライアントは type:"shell" として接続し、メインのインタラクティブターミナル、追加の独立したターミナル、独立したコマンドジョブ、ファイルおよびコンテキストツールをハーネスを必要とせずに提供します。バックグラウンド検出はインストールされたプロバイダーをチェックし、バージョン、起動ポリシー、ハンドシェイク、および実際のカタログが使用可能なインターフェースのみを登録します。ssmcp.harnesses.list はステータスと診断情報を報告します。利用できないプロバイダーは Shell や他のツールを削除しません。起動コマンドから古い -t、--type、--backend および末尾のバックエンド引数を削除します。
検出は、ランタイム、依存関係、またはハーネスをインストールしたり、モデルリクエストを送信したり、ネイティブ権限を緩和したりしてはなりません。オフラインパッケージキャッシュを、何もインストールされないという証拠として扱わないでください。安全な起動が確認されていないプロバイダーは利用できません。Pi 検出は、SSMCP_PI_RPC_SOCKET を介して明示的に構成され、初期化済みのネイティブ JSONL RPC セッションにのみ接続します。絶対 Unix ソケットとその直接の親は現在の UID に属し、グループ/その他の権限がなく、シンボリックリンクであってはなりません。接続されたピア UID、インストールされたバイナリ、バージョンがチェックされた後、5秒の get_state ハンドシェイクが行われます。OpenCode 検出は、http://127.0.0.1:PORT/ の既存のサービスにのみアタッチします(SSMCP_OPENCODE_URL、OPENCODE_PASSWORD)。明示的なポートとルートパスが必要です。プロキシ、リダイレクト、他のホスト、ユーザー情報、クエリ、フラグメントは拒否されます。ネイティブ検出は info と OpenAPI のみを読み取ります。イベントサブスクリプションは遅延されます。エンドポイントがない場合は利用不可を意味します。どちらのアダプターも、完全なカタログを生成するために外部サービスを開始したり、ユーザー拡張機能を無効にしたりしません。
list と tools は1つのレジストリを使用し、ルーティング名前空間でネイティブスキーマと記述子を保存します。名前空間には、codex.*、claude.*、pi.*、opencode.*、およびネイティブ MCP 検出が成功した場合の playwright.* が含まれます。正確な名前は現在のカタログから取得されます。Codex MCP ツールはネイティブの mcpServerStatus/list を通じて列挙され、mcpServer/tool/call を通じて転送されます。サーバーをハードコーディングせずに検出された codex.mcp.* 名を選択します。Pi は、利用可能な場合にのみ pi.rpc、ssmcp.pi.events、ssmcp.pi.requests、および ssmcp.pi.respond ブリッジ操作を公開します。CLI インストールや既知の制御コマンドリストは、そのモデル、プラグイン、または内部 MCP ツールスキーマの列挙ではありません。
MCP リソースまたは code_mode 内の resources.read(uri) を使用して、ssmcp://guide、ssmcp://limits、ssmcp://clients を読み取ります。クライアント固有のリソースには resources.templates() を使用します。接続されたクライアントが古いバージョンの場合は、現在のカタログを確認します。
code_mode は MCP サーバー上で実行されます。そのファイルシステムとループバックネットワークは、呼び出し元のワークスペースではありません。転送にサンドボックスや別のコンピューターを含めるには、その環境で別の ssmcp クライアントを実行し、返された ID を選択します。共有するディレクトリから起動します:
cd /path/to/workspace
ssmcp --name workspace --title "このセッションのタスクを説明" --allow YOUR_GITHUB_LOGIN@github [email protected]
オペレーターの構成済み SSH 宛先と認証済み ID を使用します。プライベート SSH キーをコピーしたり、ホストキーチェックを無効にしたり、ネットワークポリシーを回避したりしないでください。呼び出し元環境が接続できない場合は、その正確な制限を報告し、到達可能なピアで作業を続行します。
利用可能なスキルとインストラクションファイルを検査する
context.roots(id) を使用して、ワークスペースと明示的な読み取り専用コンテキストルートを確認します。skills.view(id) でコンパクトな Markdown インデックスを、skills.list(id,options) でメタデータを確認します。同じスキャンオプションを使用して next_cursor をたどります。名前は重複する可能性があります。ルートとパスで選択し、skills.read(id,{path}) で完全な SKILL.md を読み取ります。
agents.resolve(id,{path:"src/lib.rs"}) は、ルートからターゲットへの順序で、インストラクションの発信元と正確な内容を返します。agents.list は発信元のみを返し、agents.read は選択されたファイルを読み取ります。各ディレクトリで、ssmcp は最初の空でない AGENTS.override.md、AGENTS.md、または agents.md を選択します。関連するインストラクションを適用する前に、出所と診断を確認します。
デフォルトのルートはクライアントの起動ワークスペースです。オペレーターは、--context-root PATH を繰り返して最大8つの読み取り専用ルートを追加できます。root オプションで返された ID を明示的に選択します。スキルフォルダーを直接含むルートは、paths:["."] でスキャンできます。これらのコンテキストルートは、通常のファイル書き込みアクセスを拡張しません。これは現在のディスクビューであり、バックエンドモデルのロードされたプロンプトのインベントリではありません。メタデータ解析は文書化された YAML サブセットを使用します。診断を読み取り、本文テキストから欠落した説明を推測しないでください。
コマンドの実行と管理
独立したコマンドには exec を使用し、終了ステータスと個別の stdout/stderr を取得します。argv 配列、承認されたワークスペース内のオプションの既存の cwd、およびオプションの env オーバーライドを渡します。各開始は独立したプロセスとパイプを作成します。インタラクティブ PTY を介して入力をキューイングすることはありません。パイプラインやシェル展開には、プラットフォームのシェルを明示的に呼び出します。コマンドは、インタラクティブターミナル内での後続の cd や環境変更を継承しません。
const client = clients.find(c => c.id === "CLIENT_ID_FROM_LIST");
if (!client) throw new Error("list からオンラインクライアントを選択してください");
return await exec.run(client.id, {
command: ["git", "status", "--short"],
cwd: client.cwd,
wait_ms: 5000,
max_bytes: 16384
});
job_id、running、state、exit_code、stdout、stderr、2つの出力カーソル、および snapshot を読み取ります。成功した開始は起動のみを確認します。プロセスメタデータに pid_role が含まれている場合は、PID を報告するときにそれを保持します。スーパーバイザーPIDはコマンドPIDではありません。running:false の場合のみ最終的な終了を評価します。ゼロ以外の終了コードは、ヘルパーが正常に解決された場合でもコマンドの失敗です。snapshot には最新のアトミック状態と出力メタデータが含まれます。wait_timed_out は待機ステップを記録します。後続の読み取りですでに完了が表示される場合があります。
待機はコマンドのライフタイムとは別に保ちます。wait_ms のデフォルトは5000で、0..60000 を受け入れます。期限切れはコマンドを実行中のままにします。コマンドの timeout_ms のデフォルトは0で、実行期限がないことを意味します。900000までの正の値は、期限切れ時にプロセスツリーを終了します。シーケンス全体に対して十分な長さの外側の code_mode.timeout_ms を設定します。JavaScriptの期限は、すでに開始されたコマンドを元に戻しません。
長時間の作業には、exec.start(clientId,{command,cwd}) で開始し、job_id をすぐに返します。後続のリクエストで続行します:
| ヘルパー | 目的 |
|---|---|
exec.list(clientId) | 実行中および保持された完了ジョブを見つける |
exec.status(clientId,jobId) | 現在の状態、期間、終了コード、成果物メタデータを検査する |
exec.wait(clientId,jobId,{wait_ms:5000}) | 制限された間隔内で完了を待つ |
exec.read(clientId,jobId,{stdout_cursor,stderr_cursor,max_bytes,wait_ms}) | 増分出力とアトミックな snapshot を読み取る |
exec.cancel(clientId,jobId) | 所有するプロセスツリーを終了し、返された状態を検査する |
exec.forget(clientId,jobId) | 完了したジョブの保持されたレコードを解放する |
exec.events(clientId,{cursor,max_events,wait_ms}) | 制限付きのコマンドイベントを読み取る |
読み取りの間、stdout_cursor と stderr_cursor を別々に保持します。各ストリームは読み取りごとに最大32768バイトを返します。*_base64 は正確なバイトを保持し、*_eof はその終わりを識別します。*_truncated が true の場合、対応する snapshot.stdout.artifact または snapshot.stderr.artifact から古いバイトを読み取ります。開始後に監視が失敗した場合は、再試行する前にエラーの job_id を status/read で検査します。重複した作業を開始しないでください。
並列コマンドには exec.parallel(clientId,[{command:[...]},...],{concurrency:4}) を使用します。最大32コマンド、1~8ワーカーに対応します。各ワーカーは、コマンドが実際に終了するまで待ってから次のコマンドを開始します。初期の wait_ms:0 は実行スロットを決して解放しません。結果は入力順序を保持し、fulfilled/value または rejected/reason を含みます。監視の失敗は、利用可能な場合は job_id を保持し、そのワーカーを停止します。キューに入れられたが起動されなかったエントリは、not_started:true とマークされます。各終了コードを検査し、不確かなジョブを再試行する前に回復します。内部の制限付き待機は、code_mode の128コール予算と外部タイムアウトにカウントされます。永続サーバーには exec.start を使用します。並列出力のデフォルトはストリームあたり2048バイトです。
クライアントごとに最大32の実行中ジョブと128の保持レコードを想定します。レコード制限に達すると、新しい開始は最も古い完了ジョブを削除します。実行中のジョブは登録されたままです。ジョブは code_mode の完了後も存続しますが、クライアントの切断またはリロードで停止します。forget は出力成果物をすぐに削除しません。コマンドには exec.* を使用します。jobs.* は rsync 転送ジョブを管理します。共有インタラクティブシェルが必要な場合は terminal.* を使用し、1回の端末読み取りからコマンド完了を推測しないでください。
バックグラウンド入力の書き込みと端末の選択
exec.write を使用する前に、stdin:"pipe" でコマンドを開始します(clientId,jobId,{data,close_stdin:true})。バイナリ入力には data_base64 を使用します。両方の形式を決して提供しないでください。各書き込みは32 KiBに制限されています。written、remaining_bytes、timed_out、closed を検査します。書き込まれなかったサフィックスのみを再試行します。入力を閉じると、すべてのバイトが受け入れられた後に EOF を送信します。入力本文は監査ログにコピーされません。
独立したインタラクティブシェルには terminal.open(clientId,{name,cwd,select}) を使用し、その terminal_id で terminal.write/read/status/resize を使用します。出力カーソルは別々に保ちます。terminal.list は選択されたローカルビューを報告します。terminal.select はビューと人間のキーボードターゲットを変更しますが、他のセッションは実行を続けます。F7はセッションを循環し、F6は監査ログを選択します。terminal_id を省略すると、選択されたビューに関係なく常にメインをターゲットにします。terminal.close は追加セッションを終了します。メインは接続とともに終了します。最大16の端末を開くことができます。
外部の code_mode リクエストとともに、現在の呼び出し元/モデルが既知の場合は、controller:{name,model} を渡します。クライアントはこの宣言を、検証されたプロバイダー ID ではなく、呼び出し元が報告したものとして表示します。アプリケーション名からモデルを推測しないでください。MCP clientInfo はアプリケーションを識別できます。未知のモデルは未知のままです。古いクライアントが宣言を表示することを信頼する前に、list の controller_metadata を確認します。
コンピューター操作には cua.status とネイティブ cua のスクリーンショット/入力/ウィンドウメソッドを使用します。cua.browser はブラウザメソッドを共有します。スクリーンショットを image(await cua.screenshot(clientId,args)) で出力し、座標メタデータは個別に返します。現在のツールカタログで検出された正確な codex.mcp.* 名を使用して、Codex に接続された CUA MCP を呼び出します。ネイティブエラー、画像コンテンツ、承認状態を保持します。これらの操作をプロキシするために別のモデルを呼び出さないでください。
他のネイティブツールを実行する
const client = clients.find(c => c.id === "CLIENT_ID_FROM_LIST");
if (!client) throw new Error("list からオンラインクライアントを選択してください");
return await tools.search(client.id, {query:"browser", limit:10, include_schemas:true});
検索は大文字と小文字を区別しない名前/説明の部分文字列に一致します。デフォルトでは、名前、観測されたルーティング名前空間、および240 Unicode文字に短縮された説明を返します。include_schemas は完全なネイティブ記述子を保持します。nextCursor で続行するときは、同じ client/query/limit/schema オプションを維持します。検索は、モデルから見えるカタログ出力と手動ページネーションを削減しますが、最初の基礎となるページスキャンは削減しません。各ページは依然として承認され、コール予算にカウントされます。境界のある作業には max_pages を使用します。ページが変更または期限切れになった場合は、検出を再開する必要があります。サイズ超過のスキーマは、切り詰められるのではなく明示的に失敗します。予算については ssmcp://limits を参照してください。このヘルパーには更新されたブローカーが必要です。
発見された操作は await call(clientId, toolName, arguments) で呼び出します。isError を確認し、存在する場合は structuredContent を読み取ります。短い結果はインラインのままです。サイズ超過のバックエンド結果は、完全な本文の代わりに成果物メタデータを返します。すべての呼び出しを await します。タスクに必要な出力のみを返します。ユーザーがその委任を許可しない限り、ネイティブバックエンドを介してエージェントやモデルを開始しないでください。
ネイティブコマンドプリミティブは、ssmcp.exec.start/list/status/wait/read/write/cancel/events に加え、完了レコード用の ssmcp.exec.forget です。古いサーバーに exec ヘルパーがない場合は、call(clientId, toolName, arguments) でこれらの発見されたツールを呼び出し、完全な MCP 結果を検査します。スキーマは引き続き信頼できます。独立したネイティブ呼び出しには Promise.all を使用します。すべての呼び出しは個別に承認されます。同時実行の Cargo コマンドは、共有ビルドロックをめぐって競合する可能性があります。
オペレーターの既存の Chrome を再利用する
ユーザーが既存の Chrome セッションを指定した場合、call(id,"ssmcp.browser.discover",{}) と ssmcp.harnesses.list から開始します。検出はメタデータを読み取ります。インストールされた拡張ファイルは、ペアリングされた承認済み接続を確立しません。隔離されたプロファイル付きの新しい Chrome インスタンスを起動しないでください。
[以下、内容が切り詰められていますが、翻訳対象の構造とガイドラインに従っています]