dsh-gate

dsh-gate は、MCP を通じて Codex が長時間実行される DeepSeek Harness セッションを監督できるようにし、DSH Host とセッションを MCP プロセスから独立したままに保ちます。

ワークスペースには以下が含まれます:

• @dsh-gate/mcp-server: DSH の公開ネットワーククライアントと再接続コントローラに基づく 9 つの MCP ツール;

• @dsh-gate/supervisor-tools: DSH 側のハンドオフ、アーティファクト受理、報告された障害予算ツール;

• 2 つの限定的なオペレータスキル、Codex/DSH 設定例、および決定的なブートストラップ/ドクター/Host ワークフロー。

デプロイ、検証、開始

pnpm bootstrap      # fetch the pinned DSH fork commit, build & link the exact
                    # network client, install the supervisor plugin into an
                    # isolated project-local DSH home (.dsh-state/) — never starts the Host
pnpm run doctor     # verify pin, link, built artifacts, and plugin/profile
pnpm host:start     # start the independent DSH Web Host on http://127.0.0.1:8080
pnpm run doctor --live  # additionally verify the running Host identity/protocol

次に、config/codex-mcp.example.toml を対応する Codex 設定にコピーし、<workspace-root> プレースホルダをこのチェックアウトの絶対パスに置き換えます — これが唯一のマシン固有の値です。サーバ実行ファイルは packages/mcp-server/dist/cli.js です — 古い設定がまだ dist/index.js を指している場合は、dist/cli.js に更新してください(ライブラリエントリは MCP サーバを起動しません)。Codex MCP 設定は、command、args、environment、startup timeout、tool timeout フィールドを持つ stdio サーバをサポートしています。

完全なオペレータガイド — 前提条件、互換性契約と更新ポリシー、Host の独立性、ブラウザの可視性、クリーンな失敗回復、公式アップストリーム PR の制限 — については、DEPLOYMENT.md をお読みください。

Related MCP server: codex-worker-runtime

固定された DSH フォークコミット

@dsh-gate/mcp-server は、汎用の network-client と reconnect-controller のエクスポートである @deepseek-ai/dsh-client-connection/network-client をインポートします。これらのエクスポートは公開された DSH リリースの一部ではなく、公開フォークの正確に 1 つのコミットから取得されます:

• fork: https://github.com/yidapan666-creator/deepseek-harness.git

• commit: 7212c955438c70c9a2d168f67e85a8014b8d4488

コミット SHA が互換性契約です — ブートストラップは SHA でフェッチし(移動するブランチは使用しません)、ドクターは HEAD が異なるチェックアウトやリモートがフォークを識別しないチェックアウトを拒否し、ダーティなチェックアウトは破壊的な回復なしに拒否されます。リンク自体は既存の scripts/link-local-dsh.mjs によって作成され、ブートストラップによって再利用されます。これはローカルのみであり、マシンのパスはパッケージメタデータにコミットされません。dist/cli.js は最初にシームをプローブし、欠落している場合は生のモジュール解決エラーの代わりに明確な診断を出力します。

ピンを更新するには: scripts/dsh-gate-lib.mjs の DSH_PINNED_COMMIT を変更し、.dsh-state/dsh を削除して、pnpm bootstrap を再実行します。ポリシーと、フォークコミットがアップストリームマージとして主張されない理由については、DEPLOYMENT.md を参照してください。

監視の周期

dsh_wait は 5 分間の集約された進捗周期で実行されます。デフォルトでは約 300000 ms ごとに 1 つの観測を返し、重要なスーパーバイザ境界 — たとえば終端状態、承認/質問、チェックポイント、ブロッカー、エスカレーション — の場合のみ早期に返します。通常のイベントの変動は、迅速な繰り返しの待機呼び出しを引き起こすことはありません。各周期の観測は、前回の asOfSeq 以降の進捗 — ステップ差分、ツール数、トークン差分 — に加えて、成功した編集/書き込みによって触れた個別のプロジェクトファイルと、試行された対象の検証コマンド(たとえば pnpm verify)の、コンパクトで制限された projectActivity サマリを集約します。終端観測はタスクスコープの合計を保持します。生のログ、差分、ツール出力は一切含まれません。

キューされたプロンプトは、人間が読める目的から始まり、その後に永続的なタスクパケットを埋め込みます。これにより、プロトコル検証は変更されず、新しい監視セッションが DSH Web サイドバーのタスク名で認識できるようになります。

長いハンドオフの詳細

supervisor_handoff.summary は 2048 文字に制限されています。タスクがより長いレポートを必要とする場合は、セッション cwd 内の .dsh-handoff/<taskId>/ の下に Markdown として書き込み(ディレクトリは gitignore されています)、artifacts に相対パスを渡し、簡潔なサマリから参照します。ハンドオフツールは、制限を超えたサマリを正確にこの指示で拒否し、ハンドオフデータ自体を決して書き込みません — 特に ~/.codex やその他のグローバルディレクトリには書き込みません。アーティファクト受理は封じ込めを強制します: 相対パスのみ、トラバーサル、シンボリックリンク、ハードリンク、非通常ファイルは許可されず、セッション cwd 内の検証済みハンドルを介してハッシュされます。

リリースステータス

ソースは MIT ライセンスで、yidapan666-creator/dsh-gate での公開ホスティング用に準備されています: DSH 依存は SHA で固定された公開フォークコミットであり、作業ツリーにはマシン固有のパスやシークレットは含まれておらず、pnpm verify はブートストラップで管理されたリンクで合格します。npm パッケージとしての公開は、別の、まだブロックされている決定です: 両方のパッケージは "private": true のままであり、アップストリームの DSH network-client シームが公開されるまで、クリーンなパッケージインストールはビルドも実行もできません(フォークピンはソースデプロイには機能しますが、レジストリ消費者には機能しません)。

残りのアップストリーム制限は npm 公開です: 汎用の @deepseek-ai/dsh-client-connection/network-client エクスポートがアップストリームで公開されるまで、両方のパッケージはプライベートのままです。7212c955438c70c9a2d168f67e85a8014b8d4488 の公開フォークピンにより、ソースデプロイは今日再現可能です。これはアップストリームマージではなく、マージは主張されていません。

ソースのインストール、ビルド、テスト、パッケージングチェック、プロトコル契約は、文書化された検証ワークフローでカバーされています。

状態のセマンティクスについては docs/protocol.md、受け入れパスについては docs/manual-e2e.md、評価設計については docs/benchmark.md、ソースとライセンスのトレーサビリティについては docs/source-provenance.md、歴史的な設計レビューについては docs/source-backed-reuse-review.md を参照してください。コントリビューター向け: CONTRIBUTING.md。脆弱性の報告: SECURITY.md。