DeepSeek Harness 向け OrgX

@useorgx/deepseek-harness-plugin は、DeepSeek Harness プロファイルに OrgX MCP ツールを追加し、Harness のヘッドレスモードを通じてワークスペースにバインドされた OrgX ゲートウェイピアを実行できます。

このパッケージは開発者プレビューです。パッケージがインストールされていることは、バンドルが存在することのみを示します。OrgX の認証、ゲートウェイへの admission、ディスパッチの成功、デプロイ、または本番環境での使用を証明するものではありません。

OrgX ウィザードを使用したインストール

サポートされているユーザーフローは OrgX ウィザードです。互換性のある DeepSeek Harness のインストールを検出し、このパッケージを headless プロファイルにインストールし、ブラウザで OrgX をペアリングします:

npx @useorgx/wizard@latest setup

次に、ウィザードを通じてタスクを起動し、DSH が起動する前に OAuth トークンを更新できるようにします:

npx @useorgx/wizard@latest deepseek "List the OrgX tools available in this workspace."

DSH バンドルは、MCP 接続または初期ツール同期が失敗すると起動に失敗します。パッケージの存在を、OrgX ツールサーフェスが認証されていることの証明として扱わないでください。

Related MCP server: dsh-harness-mcp-server

バンドルを直接インストールする

DeepSeek Harness は 0.1.0-rc.6 に固定されています。上級ユーザーは、Node ^22.19.0 または >=24.0.0 を使用してパッケージを直接インストールできます:

npm install --global @deepseek-ai/dsh@0.1.0-rc.6
export ORGX_MCP_ACCESS_TOKEN='your_orgx_oauth_access_token'
export DEEPSEEK_API_KEY='your_deepseek_key'
dsh plugin --profile headless add @useorgx/deepseek-harness-plugin@0.1.0
dsh --profile headless --dump-config
dsh --profile headless "List the OrgX tools available in this workspace."

ソース開発の場合は、npm pack --ignore-scripts を実行し、結果の tarball を file: URL でインストールします。単なるローカルリンクでは、同じクリーンインストールの保証は得られません。

このパッケージは、正確な MIT ライセンスの OrgX ゲートウェイピアクライアントを @useorgx/orgx-gateway-sdk@0.1.0-alpha.9 コミット 49f3cad612954c448878dc62d0f9c6bc87fa0f79 からベンダー提供しています。DSH はプラグインのインストール中に Git やその他の特殊なサブ依存関係をブロックするため、監査済みのそのクライアントをバンドルすることで、新しいプロファイルをインストール可能に保つことができます。THIRD_PARTY_NOTICES.md を参照してください。

このバンドルは、orgx という名前の @deepseek-ai/dsh-mcp-client インスタンスを 1 つマウントします。これは、https://mcp.useorgx.com/mcp に Streamable HTTP 経由で接続し、Authorization: Bearer $ORGX_MCP_ACCESS_TOKEN を送信します。この値は、クライアント管理の OrgX OAuth 2.1 アクセストークンである必要があります。oxk_ ゲートウェイキーは、ホスト型 MCP では有効ではありません。別の OrgX MCP エンドポイントを使用するには、ORGX_MCP_URL を設定します。OAuth トークンがない場合、または初期 MCP 接続とツール同期が失敗した場合、起動は失敗します。このプレビューは、ブラウザの PKCE フローやトークンの更新を実行しません。期限切れになったクライアント管理のアクセストークンを置き換えてください。

DeepSeek Harness 0.1.0-rc.6 は MCP ツールのみをブリッジします。MCP リソースとプロンプトは、このクライアントでは利用できません。非テキスト MCP ブロックも、実行ローカルの結果が JSON ブロックを保持している場合でも、モデル側への投影が損失を伴います。

OrgX ピアの実行

ピアは、実行 cwd を ORGX_WORKSPACE_ROOT 内に設定します。要求されたリポジトリがそのディレクトリの外にあると解決される場合、Harness が起動する前に失敗します。これはパスとミューテーションの境界であり、ホストの分離ではありません。Harness の workspace-write は、同一ユーザーのファイル読み取り、プロセスの可視性、またはネットワークアクセスを制限しないため、モデルまたはツールが他のホストデータを観測したり、ネットワーク経由でデータを送信したりする可能性があります。そのリスクを受け入れた場合にのみ ORGX_DEEPSEEK_HOST_ACCESS_ACK=1 を設定してください。この確認がない場合、起動と認証情報の準備は失敗します。

gateway:drive および plugin:heartbeat にスコープされた API キーを使用します。OrgX ゲートウェイキーの応答は installation_id を返します。その安定した値をキーとともに保持し、起動のたびに両方を変更せずに渡します。

export ORGX_API_KEY='oxk_your_workspace_key'
export ORGX_MCP_ACCESS_TOKEN='your_orgx_oauth_access_token'
export DEEPSEEK_API_KEY='your_deepseek_key'
export ORGX_WORKSPACE_ID='your-workspace-uuid'
export ORGX_INSTALLATION_ID='install.your-stable-installation-id'
export ORGX_WORKSPACE_ROOT='/absolute/path/to/the/workspace'
export ORGX_DEEPSEEK_HOST_ACCESS_ACK='1'
dsh plugin --profile headless exec orgx-deepseek-harness-peer

このプレビューは、管理対象外のゲートウェイプロトコル v1 ピアです。候補/正規のアクティベーションおよびプロモーションライフサイクルを実装していません。ORGX_RUNNER_INSTANCE_ID、ORGX_ACTIVATION_ATTEMPT_ID、または ORGX_RUNNER_ROLE を指定すると、起動が明確に失敗します。これらのフィールドは、そのハートビートまたはソケット URL で送信されることはありません。

WebSocket を開く前に、ピアはトランスポートとディスパッチの準備ができていない状態でゲートウェイハートビートを書き込みます。以下のすべてのチェックが成功した後にのみ、ディスパッチ準備完了を通知します:

• dsh --version により、固定されたランタイムプロセスが起動していることが証明される。

• 固定された公式エンドポイント https://api.deepseek.com/user/balance が DEEPSEEK_API_KEY を受け入れ、推論リクエストを行わずに is_available: true を報告する。

• MCP Streamable HTTP の初期化と tools/list の交換が ORGX_MCP_ACCESS_TOKEN を受け入れる。

シークレットの存在や認証情報なしのバージョンコマンドは、認証として扱われることはありません。プローブの失敗、拒否または期限切れの認証情報、および欠落した証拠は、フェイルクローズドのままです。成功した証拠は 45 秒間キャッシュされます。ピアは 15 秒ごとにゲートウェイプレゼンスを更新し、ソケットが閉じられたときにベストエフォートのオフラインハートビートを書き込みます。

DSH 子プロセスは、プロバイダーキーと別途スコープされた MCP アクセストークンを受け取りますが、ゲートウェイキーは受け取りません。アンビエントな DSH_* 制御は、DSH_HOME を除いて転送されません。子プロセスは強制的に workspace-write 権限に設定され、テレメトリーは無効化されるため、アンビエントなフルアクセスや OTLP エクスポート設定がこれら 2 つのポリシーをオーバーライドすることはできません。これらの設定は、それでもホストの読み取り、プロセス、またはネットワークアクセスを分離しません。

オプションのランタイム設定:

• ORGX_BASE_URL は、OrgX ゲートウェイのベース URL を変更します。

• ORGX_RECEIPT_OUTBOX_PATH は、絶対パスの永続的なレシートディレクトリを設定します。デフォルトは、現在のユーザーの OrgX ステートディレクトリ以下です。

• ORGX_DEEPSEEK_HARNESS_BIN は、実行可能パスを dsh から変更します。

• ORGX_DEEPSEEK_HARNESS_PROFILE は、プロファイルを headless から変更します。

• ORGX_DEEPSEEK_HARNESS_MODEL は、deepseek-official プロバイダー用のパッケージ化されたモデルパッチをアクティブ化します。構成のデフォルトを変更します。DSH 設定に既に保存されているモデルが優先される可能性があります。

Harness ヘッドレス stdout には、最終的なアシスタントテキストと終了コードが含まれますが、トークンやコストの会計情報は含まれません。したがって、ドライバーワイヤーメッセージには、数値の tokens_used: 0 と cost_estimate_cents: 0 を含める必要があります。どちらも、このソースでは不明であることを意味し、無料であることを意味するものではありません。OrgX は、永続化された DeepSeek コストをその控えめなディスパッチ見積もりに正規化し、メータリングの品質を記録し、その見積もりを予算上限に累積します。ゼロプロセス終了は outcome_kind: awaiting_review を報告します。プロセスは終了しましたが、作業はまだ承認、マージ、デプロイ、または本番環境で実証されていません。

SDK の WebSocket 送信にはサーバー確認応答がないため、永続性はアプリケーションが責任を持ちます。task.started を生成する前に、ピアはアトミックに開始前予約マーカーを書き込みます。その書き込みが失敗した場合、Harness が生成する前に内部イテレータを閉じ、ブロックされたレシートをベストエフォートで POST します。開始後の task.completed フレームを生成する前に、正確な v1 HTTP レシートを、mode-0600 ファイルを使用してモード 0700 の outbox にアトミックに書き込み、それをべき等な実行レシートエンドポイントに POST します。キーやトークンはどちらのファイルにも書き込まれません。

2xx 応答のみがターミナルレシートを削除します。Harness が完了した後に最終的な永続化が失敗した場合、ピアは直ちにバインドされた HTTP レシートを直接試行し、それでも元の完了を生成します。2xx 応答は予約をクリアします。HTTP も失敗した場合、完了はインメモリの再試行キューに残り、その予約マーカーも残ります。保留中のレシートは、起動時、再接続時、および 15 秒ごとのハートビートティックで再試行されます。未解決の予約がある状態での再起動は、再実行のリスクを冒す代わりに、修復メッセージとともにフェイルクローズドします。

固定された SDK は、ソケットのみの task.failed を永続的に回復できません。実行が開始された後、このピアは失敗理由をステップとして記録し、outcome_kind: blocked を発行します。キャンセルは outcome_kind: abandoned を発行します。どちらもアプリケーション outbox を使用します。task.started の前に拒否された重複は task.failed のままであり、その実行 ID を既に所有しているディスパッチを終了することはできません。

検証

パッケージ開発のために、ライフサイクルスクリプトなしで固定された依存関係をインストールし、決定論的なチェックを実行します:

npm install --ignore-scripts --no-package-lock
npm run validate

パッケージテストスクリプトは、test/*.node-test.mjs に対して明示的に node:test を実行します。Node のみのサフィックスにより、これらのスイートをリポジトリのルート Vitest ディスカバリから除外しつつ、npm run validate で保持します。

検証では、バンドルとマニフェスト、証拠に基づく準備状況、ワークスペースと子環境の境界、キャンセルと重複の競合、管理対象外プロトコル v1 ハートビート、および固定された SDK の切断時 HTTP 障害回復をチェックします。OrgX または DeepSeek には接触しません。