Plugin SDK の開発とリリース

開発・検証・リリース用ツール、1.2 のワークフロー、増分キャッシュ、外部ツール、公開 LSP ブリッジ。

DDS Plugin SDK 1.2.0 の開発、検証、リリースに関するガイドです。セキュリティ監査と脆弱性検証は保留中です。API の安定性や機能チェックの結果は、セキュリティ面の受け入れを意味しません。

SDK のインストールと API ガイド

開発テンプレートと生成

command、language、theme、job、browser、configuration から選択します。init --dry-run は、書き込みやインストールを行わずに、出力先、ファイル一覧、ハッシュ、競合を報告します。通常の init には、新しい実ディレクトリが必要です。各テンプレートには、ソース、マニフェスト、開示情報、ライセンス/通知、テスト、型付きコンシューマー、実行可能な例が含まれます。browser と configuration のテンプレートにはループバックデモも含まれます。生成された依存関係は、正確な GitHub アーカイブに固定されます。

npx --no-install dds-plugin init example-plugin --template configuration --dry-run
npx --no-install dds-plugin init example-plugin --template configuration
cd example-plugin
npm install --ignore-scripts
npm run doctor
npm test
npm run typecheck
npm run example
npm run browser

dds-dev.json は、コマンドスキーマ、設定、ロケールカタログ、テーマデータを扱う、上限付きの JSON データです。generate は、ランタイム JSON、ESM エクスポート、未検証/検証済みの TypeScript 入力型、出力/設定型、JSON Schema、テーマ XML を出力します。JSON Schema のデフォルト値は注釈であり、デフォルト値を適用するのは SDK の入力検証だけです。生成処理はプラグインをインポートしません。doctor は、差分、メタデータ、欠落したモジュール、生成されたランタイムファイルがパッケージの許可リストに含まれているかをチェックします。

npx --no-install dds-plugin generate . --check
npx --no-install dds-plugin generate . --dry-run
# Review the new files, then use the previous digest from the report:
npx --no-install dds-plugin generate . --expected-digest <previous-digest>

置換には、正確な以前のダイジェストと、変更されていない生成バイト列が必要です。手動編集、余分なファイル、リンク、古いロックがあると置換を停止します。失敗時に削除されるのは、その試行が所有し、変更されていない項目だけです。変更済みまたは状態が不確かな項目は、確認のために保持します。ファイル数は 256、各ファイルは 1 MiB、合計は 4 MiB までです。ロックは協調するジェネレーターを調整するもので、敵対的な並行ファイルシステム書き込みへの防御や、ディレクトリをまたぐアトミックなトランザクションを提供するものではありません。独自ライセンスのテンプレートには、呼び出し側が提供する利用条件が必要で、継承された SDK のライセンス/通知ファイルを保持します。

決定的なテストとリプレイ

/testing の createScenarioHost は、選択したメモリ内ファイル、バックエンド、設定、シークレット、ジョブのフィクスチャを明示的にマウントします。起動時には付与権限も機能もありません。createTestClock は、グローバルを書き換えずに、シード付き ID、時刻、タイマーを提供します。同時刻のタイマーは登録順を保持します。仮想待機を解除するには、クロックの進行を await してください。生成される UUID はテストデータであり、暗号学的なエントロピーではありません。既存の createTestHost のデフォルト動作は互換性を維持します。

import {createScenarioHost} from '@altifigence/dds-plugin-sdk/testing';
const scenario = createScenarioHost({seed: 7, start: 1000,
  files: {'example.txt': 'synthetic'}, grants: ['workspace.read'],
});
try {
  // Activate your explicitly imported test plugin on scenario.host.
  scenario.faults.enqueue({operation: 'file.read', kind: 'delay', delayMs: 25});
  // Start its command, then await scenario.clock.advance(25).
} finally {
  await scenario.dispose();
  scenario.assertClean();
}

障害ポートは、遅延、拒否、切断、破損、リソース枯渇、呼び出しの欠落をモデル化します。イベントフィクスチャは、外部への作用を繰り返さずに、欠落、重複、逆順化できます。replaceGrants は、権限を失ったプラグインを無効化します。メモリ内ジョブスナップショットは、ID、リビジョン、ハッシュを検証し、自動実行せずに中断後の復旧をモデル化します。これらのフィクスチャは、ファイルシステムの永続性を再現したり、OS のハンドルを検出したりしません。別の所有者台帳が、明示的に登録されたリソースを追跡します。キャンセルを無視するコールバックは、実際に終了するまで teardown 後も保留数に残ります。設定の inspect は破棄後も読めるようになりましたが、データの読み取りは引き続き拒否されます。

記録には synthetic: true と、明示された上限付きフィクスチャ一覧が必要です。エクスポートされたトレースには、操作種別、フィクスチャ ID、タイミング、シード/バージョン、連鎖ハッシュだけが含まれます。機密性のない ID を使用してください。ハッシュは推測可能なデータを匿名化せず、SDK は任意の入力を合成データと判定できません。純粋なリプレイは、順序、ハッシュ、フィクスチャ ID をチェックして、選択したフィクスチャの出力を返します。作用を伴うコールバックは受け付けません。上限はフィクスチャ 64 個、イベント 1,024 件、トレース 1 MiB です。障害、復旧、プライバシー、クリーンアップのチェックには、同梱された開発ツールの例を実行してください。

ローカル診断とデバッグ

import {createDiagnosticSession, profileHost}
  from '@altifigence/dds-plugin-sdk/diagnostics';
const session = createDiagnosticSession({enabled: true, sampleEvery: 10});
const measured = profileHost(host, session);
try {
  await measured.executeCommand('example', 'run', {});
} finally {
  measured.dispose();
  console.log(session.snapshot());
  session.dispose();
}

診断はデフォルトで無効で、ローカルでのみ行われます。レポートには、固定された操作/状態/エラーコード、相関 ID、所要時間、リソース数が含まれます。文書本文、パス、入力、出力本文、任意の例外テキストを扱う API はありません。バイト数、キューの深さ、メモリ値は、所有者による明示的な推定です。profileTransport は、ラップした呼び出しが解決するまでを測定します。fetch の場合は、本文の完了ではなくレスポンスヘッダーの到着までです。完了した記録には、上限付きリングと受動的な期限切れ処理を使います。診断用バックグラウンドタイマーやアップロードはありません。デフォルトは 128 イベント/60 秒、最大は 256 イベント/5 分、進行中の span 64 個、レポートあたり 256 KiB です。

npx --no-install dds-plugin dev . --trust-local-code --profile --command greet --input '{"name":"Ada"}'
npx --no-install dds-plugin dev . --trust-local-code --debug --debug-wait --timeout-ms 30000 --command greet --input '{"name":"Ada"}'

デバッグモードは、所有する子プロセス内に、一時的な 127.0.0.1 のインスペクターだけを公開します。--debug-wait はプラグインのインポート前に一時停止し、--debug が必要です。デバッガーの待機も含めた総実行時間の上限は 30 秒です。完了、キャンセル、タイムアウト時には、所有する子プロセスとインスペクターを終了します。プロファイリングもデバッグも、ローカルコードへの明示的な信頼が必要であり、サンドボックスではありません。クラッシュや強制終了ではプロファイルレポートが出ない場合があります。また、プラグインの生の stdout/stderr は別の上限付きストリームであり、自動的にはマスキングされません。

開発ツール · テスト · 診断 · 互換性

ホストの適合性

/conformance モジュールは、明示的に提供されたホスト、設定、ワークスペース、ローカライズ、テスト、診断、開発用アダプターに対して、バージョン管理された合成プローブを実行します。対応、未対応、失敗の各プロファイルを区別し、ホスト/バージョン/ランタイム/プラットフォーム、チェック ID、タイミング、クリーンアップ情報を含みます。宣言済みの機能にアダプターがないか壊れている場合は失敗となり、未知のオプション機能はプローブせずに記録します。デフォルトでは、コマンド、権限、キャンセルが必須です。

import {runConformance, formatConformanceReport}
  from '@altifigence/dds-plugin-sdk/conformance';
import {createPluginHost} from '@altifigence/dds-plugin-sdk';
const report = await runConformance({
  identity: {host: 'My host', version: '1.0.0', runtime: 'Node 24', platform: 'linux-x64'},
  features: ['commands', 'permissions', 'cancellation'],
  adapters: {host: options => createPluginHost(options)},
});
console.log(formatConformanceReport(report));

ホストファクトリーを自分のアダプターに置き換え、プラグインのテストも実行してください。Node の /conformance-node ヘルパーは、新しい一時フィクスチャと一時的なループバックサーバーだけを作成します。ブラウザーの例は、利用可能なブラウザープロファイルを実行し、存在しない Node 機能を未対応として報告します。簡易プローブは契約の一部を確認します。リンクされた例とリリーステストでは、より広い言語、復旧、ストレージの経路を検証します。レポートはテストの証拠であり、信頼証明書ではありません。

期限はケースごとにデフォルト 10 秒、最大 30 秒です。タイムアウトやキャンセルは、後続のケースを停止します。クリーンアップの失敗はケースを失敗にし、保留中のクリーンアップは未検証のままです。信頼されたプロセス内アダプターは、同期的にブロックしたり、実行環境に元からある権限を保持したりする可能性があります。レポートは、プロバイダーのエラー本文、ペイロード、トークン、パスを含みません。機密性のない識別ラベルを選んでください。レポートが自動アップロードされることはありません。

SDK のサポートと移行

API_SUPPORT.json は、エクスポートされるすべてのモジュール、ランタイム名、型宣言、宣言のダイジェスト、環境、安定性を一覧化します。安定版 1.x API はセマンティックバージョニングに従います。互換性のある追加はマイナーリリース、安定 API の非互換変更には新しいメジャー版が必要です。artifact-resume-browser は実験段階のままで、正確な SDK/ブラウザーバージョンと新たなブラウザー受け入れ検証が必要です。オプション機能の検出と現在の権限の確認も引き続き必要です。

安定版系列のポリシーは 1.0.0 から適用されます。最新の安定マイナー版には通常の修正が提供され、その直前のマイナー版は、サポートされるランタイム上で 90 日間、重大なセキュリティ修正の対象となります。1.0.0 では非推奨となる安定 API はありません。メジャー版で削除する前に、少なくとも 2 回のマイナーリリースと 6 か月の非推奨告知期間を設けます。RC とプレビューは後続版に置き換えられます。このオープンソースのポリシーは、商用の応答時間を約束するものではありません。

サーバーと CLI の受け入れ検証は、修正済み Node 22 または 24 を使う Windows/Linux、および TypeScript 5.9.3 の型宣言を対象とします。Node 22 のサポートは 2027-04-30、Node 24 は 2028-04-30 に終了します。リリース記録には、正確なパッチバージョン、OS イメージ、ブラウザービルドが示されます。その他のランタイムやブラウザー/ストレージの組み合わせには、独自の受け入れ検証が必要です。SDK のランタイム npm 依存関係は引き続きありません。

安定版 1.0 プラグインは >=1.0.0 <2.0.0 を使用します。後の API を採用する場合は、最小バージョンを引き上げてください。RC1 パッケージは、正確な 1.0.0-rc.1 の peer 依存を保持します。変更するには再検証し、新しいプラグインバージョンを公開してください。以前のアーカイブは不変のまま保持します。旧アーカイブは相互運用性の入力であり、保守対象の系列ではありません。再起動後は、新しい接続と現在の付与権限を確立してください。復旧では、確定済みの状態を読み取り、作業を再実行しません。

リリースの受け入れ検証

所有者が 2026-10-05 に延期したため、セキュリティ監査と脆弱性検証は保留中です。機能、互換性、性能の結果は、セキュリティ面の受け入れを意味しません。保留されたレビューは別途再開されます。このリリースを、その監査に合格したものと説明してはいけません。

統合フィクスチャは、言語/設定、レビュー済み編集、コマンドジョブ、プロジェクト監視、アップロード/ダウンロード、保持ストレージを同時に検証します。中断、不正なレスポンス、権限取り消し、世代変更、復旧、リソースのクリーンアップを確認します。個別のファイルシステム/プロセステストでは、終了させられた子プロセス、破損、書き込み失敗、期限切れ、キャンセルの無視を検証します。RC 受け入れレポートには、再現可能なコマンドと各結果の適用範囲へのリンクがあります。

性能検証では、Windows/Linux と Node 22/24 の各プロファイルについて、新しいプロセスで 5 回測定します。中央値/ばらつき、CPU 時間、サンプリングしたメモリ、インポート/起動/監視の時間、論理的なディスク/HTTP ペイロード数を記録します。基準値はこれらの測定サンプルに基づく大まかなリグレッション防止策であり、レイテンシーの SLA ではありません。物理ディスクの通信量を測定したり、OS のすべてのハンドルを検出したことを保証したりしません。

npm ci --ignore-scripts
npm run check
npm run example:conformance -- --json
npm run example:combined -- --faults
npm run benchmark:combined
npm run example:conformance-browser

適合性 · API 一覧 · サポートポリシー · RC の受け入れ検証

安定版 1.0 のリリース内容

元の 1.0 パッケージには、38 個のエクスポートと 86 個のスキーマに加え、型宣言、例、LICENSE、NOTICE が含まれます。1.1 では以下のリリースツール、1.2 では以下のワークフロー/キャッシュ/ツール/LSP の項目が追加されます。リリース記録では、正確なソース/CI/ダイジェスト、新規コンシューマー、再利用したブラウザーの証拠を区別します。

ダウングレードするには、所有する作業を停止し、保持された互換性のある SDK/プラグインアーカイブと設定エクスポートを明示的に選択します。現在の付与権限を確認し、新しい接続を作成してください。結果の復旧は読み戻しのみです。外部への作用や非互換な設定は自動的に取り消されません。実際に使用した形式とオプション機能をテストしてください。

リリース内容、移行、サポート

オフラインバンドルと SBOM

SDK 1.1 は、Node 専用のオプションエントリーポイント /bundles、/provenance、/updates、/updates-node、/upstream の 5 個を追加します。パッケージには、43 個のエクスポート、96 個のスキーマ、型宣言、実行可能な例が含まれ、ランタイム npm 依存関係はありません。既存の 1.0 API と署名のない DDS .tgz アーカイブは互換性を維持します。

lockBundleDependency は、レビュー済みの ESM/CommonJS ファイルツリーを、正確なバージョン、HTTPS ソース、正規化されたファイルダイジェスト、依存関係マップ、LICENSE/NOTICE、明示的な再配布判断に固定します。ダイジェストが表すのは、レビュー済みのツリーであり、上流アーカイブのハッシュではありません。createPluginBundle は、元の DDS プラグインアーカイブとリリースメタデータ、単一バージョンの非循環依存グラフ、決定的な CycloneDX 1.6 SBOM を組み込みます。

verifyPluginBundle は、上限付きの正確なバイトスナップショットを検証します。installPluginBundle には、expectedSha256、approved: true、オペレーターが所有する親ディレクトリ内の新しいディレクトリが必要です。npm、ライフサイクルスクリプト、ダウンロード、プラグインコードは実行しません。依存関係に新しい付与権限は継承されません。ホスト SDK は別の依存関係です。ネイティブアドオン、export map、任意の npm 依存関係解決は、この形式の対象外です。

上限は、依存パッケージ 32 個、展開済みファイル 1,024 個、依存ファイルあたり 4 MiB、展開内容 32 MiB、エンコード済みバンドル 48 MiB です。元のルートアーカイブには、別の、より小さい上限があります。バージョンの欠落や競合、循環、孤立した依存関係、変更されたハッシュ、ライセンス/NOTICE の欠落、不正なパス/リンク、ファイルとディレクトリの衝突は拒否されます。インストール失敗時には、確認のために新しい出力先を保持します。並行書き込みを排除してください。このツールは OS のサンドボックスではありません。

分離署名とオペレーターの信頼

createProvenanceStatement は、正確なバンドル名/バージョン/SHA-256、発行者、ソースリビジョン、発行時刻/有効期限を関連付けます。signPluginProvenance は、呼び出し側が所有する Ed25519 KeyObject を使います。canonicalProvenancePayload は DDS-PROVENANCE-V1 に続く正規化 JSON を公開するため、別の署名者も同じペイロードを再現できます。SDK は、秘密署名鍵も DDS 製品の署名権限も提供しません。

verifyPluginProvenance は、オペレーターが選択した信頼ルート、発行者/対象の関連付け、現在時刻、鍵の有効性/失効状態、時刻付きの失効証拠を受け取ります。オフライン検証は、提供された証拠に同じ鮮度上限を適用し、新しい失効情報を自ら取得しません。新しいパッケージ鍵は、オペレーターが追加するまで信頼されません。明示的に期間を重ねた信頼ルートによりローテーションできます。最大の時計ずれは 5 分、証拠の最大経過時間は 30 日です。必要に応じて、より厳しい上限を選択してください。

記録では、チェックサム、署名、発行者、ポリシーを別々に扱い、常に executionAuthorized: false を返します。署名はコードの安全性を証明せず、実行、データアクセス、サンドボックスの権限も付与しません。古い未署名パッケージには envelope: null と allowUnsigned: true が必要であり、未署名かつ発行者未検証として報告されます。セキュリティ監査と脆弱性検証は、それとは独立して保留中です。

レビュー、有効化、ロールバック

createPluginUpdatePlan は、新旧のバージョン、API、付与権限、依存関係のソース/ハッシュ、宣言済みツール、ライセンス、設定ハッシュ、移行 ID、署名、鍵を比較し、レビューのダイジェストを固定します。createPluginUpdateController は、現在認可されたホストと設定、およびオペレーターの getPolicy/prepare ポートを所有します。stage は候補を検証してスナップショットを作成します。approve は、正確な計画ダイジェスト、付与権限、鍵 ID と一致しなければなりません。activate は、別の候補ホストを準備する前後に、現在の設定をチェックし、信頼状態を更新します。

wait は、ジョブが実行中の間、有効化を延期します。retain-old は、既存ジョブを元のホスト/設定/ハッシュ上に残し、切り替え後の新規実行を新しいホストに送ります。execute は、各結果とともにプラグインハッシュを返します。ジョブは暗黙にはキャンセルされません。設定の置換は保留中の承認を無効にします。並行変更や準備失敗では、以前の状態を保持するか、その状態を明示的に報告します。ロールバックは、古いパッケージ/設定を新たなレビュー対象の更新として stage し、現在の信頼と新たな承認を必要とします。

準備と移行は、オペレーターが所有する信頼されたポートを通じて実行されます。ロールバックも失敗も、外部ファイル、ネットワークリクエスト、その他の作用を取り消しません。reversible はレビュー用メタデータであり、自動取り消しの約束ではありません。Node のジャーナルは、追記専用、単一ライター、ワークスペース外で、正確なリビジョン CAS を使います。上限は 256 記録/エンベロープあたり 128 KiB/合計 8 MiB です。上限に達したら、オペレーターの管理下でアーカイブしてから新しいジャーナルを開いてください。

inspectNodeUpdateJournal は、リプレイせずに永続化された状態を読み取ります。preparing 中のクラッシュや曖昧な応答では、ホスト/設定の明示的な読み戻しが必要です。reconcilePluginUpdateJournal は、承認済みの、既知の新旧ダイジェストと設定ハッシュを記録します。破損した末尾は、オペレーターによる確認/修復が必要です。recoverStaleLock は、同じマシン上で停止したことが証明されたライターだけを復旧します。プロセスをまたぐホスト/設定のトランザクションや、あらゆる電源断に対するアトミック性を約束するものではありません。

明示的な上流チェックと候補

fetchUpstreamArtifact には、明示的な呼び出し、enabled: true、正確なソース URL/バージョン/ダイジェスト、正確な URL 許可リスト、オフラインポリシー、バイト上限、期限が必要です。リダイレクト先も許可リストに含める必要があります。Cookie や認証ヘッダーを送らず、自動再試行も行いません。観測時刻とともに、verified/digest-mismatch/unavailable/offline/unverified を報告します。タグやハッシュの変更には、新たなレビューが必要です。ループバック HTTP は、明示的なフィクスチャオプションを使う場合にだけ利用できます。

アダプターは、API 一覧、正確なソースリビジョン、完全なライセンス/NOTICE、ファイルハッシュを含む、レビュー済みの upstream-manifest を公開できます。inspectUpstreamManifest は、そのメタデータをダウンロード済みバイト列に関連付けます。任意のソースコードを分析したり、再配布許可を推論したりしません。createUpstreamCandidate は、API/ファイル/ライセンスの差分と、変更前ダイジェスト/置換ソースのパッチを返します。正確なバージョン行列と一致しても、開発者による機能チェックがなければ未検証のままです。必須 API が欠けている場合は未対応となります。

対応する候補でも、人間によるレビューが必要です。automaticActions 配列は空であり、これらの API は、ブランチ作成、マージ、公開、新しい付与権限の承認、監視のインストールを行いません。アダプターテストの実行とキャンセルはホストが管理します。以下の完全な公開例は、ローカルフィクスチャだけを使用します。ワークフロー/キャッシュ/ツール/LSP API は、以下の 1.2 の項目で利用できます。

node node_modules/@altifigence/dds-plugin-sdk/examples/release-tools/run.mjs

型、API、上限、実行可能な完全なソース

コマンドワークフローと明示的な復旧

SDK 1.2 は、/workflows、/workflows-node、/workflow-cache、/workflow-cache-node、/tool-streams、/tool-streams-node、/lsp-node の 7 個のオプションエクスポートを追加します。現在のパッケージには、50 個のエクスポート、107 個のスキーマ、TypeScript 型宣言、独立してインストールできる例が含まれ、ランタイム npm 依存関係はありません。ブラウザーに移植可能なのは /tool-streams だけで、ほかの新規エクスポートには Node が必要です。既存のワークスペースプロトコルと 1.x API は互換性を維持します。新しい 1.2 API をインポートするプラグインは、SDK の最小バージョンとして 1.2.0 を宣言する必要があります。

prepareWorkflowPlan は、実行前に、登録済みコマンド ID、一意のステップ、非循環依存関係、閉じた入力/出力データスキーマ、必須出力バインディングを検証します。各入力は、リテラルの {value} か、明示的な依存先への {step, path} バインディングです。スキーマ制約は完全に一致する必要があります。不変の計画は、そのコマンド、付与権限、スコープ、入力を SHA-256 に関連付けます。run には、approved: true と、レビュー済みのその正確なダイジェストが必要です。ホストの authorize/execute ポートは、引き続きオペレーターが所有します。

createCommandJobExecutor は、resolveHost が選択した、隔離された既存の PluginHost に接続します。resolveHost は、正確なホストスコープ、ステップの付与権限、プラグインハッシュを返します。ステップ間で付与権限が合算されることはありません。実行前、結果の取得後、再利用前に、現在の認可をチェックします。continue は独立した分岐を完了し、失敗したステップの子孫をブロックします。fail-fast は残りのステップをキャンセルします。記録には、親ジョブ/試行 ID、個々のジョブ、入力/出力ダイジェスト、成果物、理由、タイムスタンプを保持します。キャッシュヒットには新しいジョブ ID がなく、変更可能なジョブ成果物があるとは主張できません。

recover は、保存されたチェックポイントを読み取り、保留中/実行中の作業を実行せずに中断として報告します。手動 resume は、新しい承認で正確な前回記録と previousAttemptId を提供し、新しい試行を作成します。一致し、期限切れでない成功結果だけを保持します。retrySteps は、順序のない DAG でも、選択したステップとその子孫を再実行します。出力が期限切れの場合、明示的な再試行選択が必要です。スキーマ、入力、付与権限、プラグインハッシュが変わった場合は、新しい計画が必要です。キャンセルを無視するエグゼキューターは未完了として数えられ続け、重複する再試行を防ぎます。

createNodeWorkflowStore は、互いに分離した実際のストア/ワークスペースディレクトリ、スコープとファイルシステムの識別マーカー、単一ライター、チェックサム付きエンベロープ、CAS チェックポイントを使います。既知のクラッシュ後の明示的な recoverStaleLock は、同じマシン上で停止が証明された所有者だけを受け付けます。デフォルトのクリーンアップは、認識できる破損記録と未完了の書き込みを処理し、未知のファイル/リンクを保持します。cleanup({expiredBefore}) は、期限切れの終了済み記録も削除できます。アクティブな記録は復旧のために残します。Windows では、ディレクトリ fsync や電源断時の永続性を保証しません。上限は、64 ステップ、同時実行 8 ステップ、ワークフロー期限 10 分、結果あたり 64 KiB、出力合計 1 MiB、記録 2 MiB、保持記録 64 件、部分結果の保持期間最大 24 時間です。

型、API、上限、実行可能な完全な例

決定的なキャッシュと増分実行

fingerprintWorkflowInputs は、実際のファイルバイト列に加え、SDK バージョン、ワークスペース/セキュリティスコープ、コマンドスキーマ/入力、プラグイン/ツールのハッシュ、設定、宣言済み環境、付与権限をハッシュ化します。mtime とパスだけが内容の識別情報になることはありません。オペレーターは、optIn、deterministic、declaredInputsComplete、secretDependent を明示的に宣言します。未知または不完全な入力、非決定性、シークレット依存、欠落/未宣言の環境、シークレット参照を含む入力は、理由付きでキャッシュを迂回します。ホストは、生のシークレットや副作用も除外する必要があります。SDK は隠れた入力を推論できません。

createWorkflowCache は、lookup/fill/after-fill/hit/return の各時点で現在の認可を再確認し、値のハッシュ、スコープ、付与権限、有効期限を検証します。同時に発生した、条件を満たすキャッシュミスは、1 回の fill を共有します。待機者を 1 人キャンセルしても、ほかの待機者はキャンセルされません。期限切れまたは破損した値はミスになります。TTL/LRU、エントリー/値の上限、所有ストアのクリーンアップでストレージを制御します。書き込みが失敗しても、明示的な理由付きの計算結果として残ります。シークレット参照を含む結果は保持しません。フィンガープリントの上限は 64 ファイル、各 4 MiB、合計 16 MiB。キャッシュの上限は 512 エントリー、保持値 16 MiB、fill 8 件、fill あたり 60 秒です。

ワークフローの例は、現在の依存先が成功してからキャッシュを検索します。ファイルの変更は該当ステップを無効にし、出力の変更は依存する入力のフィンガープリントを無効にします。依存先が失敗した場合は、親結果のキャッシュを検索する前に親をブロックします。記録では、hit、miss、shared、bypass、実際の実行と再利用、キャッシュカウンター、ストレージのバイト数、ローカルの所要時間を区別します。永続キャッシュは、分離した所有者ディレクトリとアトミックな置換を使い、孤立した書き込み/破損から復旧します。ソースファイルは削除しません。

型、API、上限、実行可能な完全な例

登録済みツールの出力ストリーム

createToolStreamParser は、移植可能で上限付きの UTF-8 JSONL/テキストデコーダーです。バックプレッシャーのため write(bytes, stdout/stderr) を await し、両ストリームの終了後にだけ finish してください。分割されたマルチバイト文字と最後の不完全な行を保持し、関連付けられた log、progress、diagnostic、unknown イベントを出力します。不正な UTF-8 と厳格な上限違反は解析を停止します。相対診断パス、位置の順序、重大度を検証します。利用するエディターも、現在の文書テキストに対して位置を検証する必要があります。createJobToolEventSink は、進捗/ログを既存の JobReporter に接続し、診断は呼び出し側が所有する sink に任せます。

オプションの Node ランナーは、オペレーターによる固定登録を受け付けます。登録内容は、backend/tool/version、絶対実行ファイルパス、選択された実装の固定情報、正確なバージョンプローブ、明示的な環境、閉じた入力スキーマ、必須のスカラー引数スロットです。ファイルスロットは、既存の相対ワークスペースファイルを指定する必要があります。プラグイン呼び出しで選べるのは、登録済みのツール/バージョンと検証済み入力だけであり、シェルや実行ファイルは選べません。準備/起動前、イベント時、完了後に現在の認可をチェックします。記録には、終了コード、キャンセル/失敗の理由、出力統計を保持します。

既知の 1 行のシークレット/パスのリテラルは、分割チャンクも含め、行を組み立てた後にマスキングします。エンコードされたシークレットや未知のシークレットは自動検出されません。ランナーが所有するのは、直接の子プロセスとパイプだけで、キャンセルや close 時に閉じます。無関係なプロセスや子孫プロセスのツリーを走査/終了せず、OS のサンドボックスではありません。上限は、チャンク 64 KiB、行 16 KiB、総出力 2 MiB、イベント 4,096 件、キュー中の書き込み 8 件、sink 5 秒、ツール 32 個、同時実行 4 件です。設定されたバージョンは、別の 5 秒/16 KiB のプローブで確認します。

SDK 作成の再配布可能なツールフィクスチャは、分割された UTF-8/JSONL、末尾出力、ゼロ以外の終了コード、キャンセル、上限をテストします。実際のアダプターは TypeScript 5.9.3 で、--noEmit --noLib --pretty false と、TS2322 を発生させる使い捨ての組み込み型フィクスチャを使います。実行するには、承認済みの既存 TypeScript ルートを明示的に指定してください。SDK は外部ツールを自動インストール/ダウンロードしません。提供されたハッシュだけで、発行者を独立に認証することはできません。

型、API、上限、実行可能な完全な例

公開 Stdio LSP ブリッジ

createLspBridge は、明示的に承認され固定された stdio プロセスを、既存の SDK 言語リクエスト/プロバイダーに接続します。対応する LSP 3.17 サブセット、UTF-16 位置、完全なスナップショットをネゴシエートします。capabilities は、通知された対応状況と実行成功を別々に報告します。対応するマッピングは、補完、ホバー、定義、参照、フラット/階層シンボル、シグネチャヘルプ、prepare-rename/rename、文書/範囲のフォーマット、コードアクション、完全なセマンティックトークン、折りたたみ、インレイヒントで、SDK の 15 機能です。

syncDocument と closeDocument は、didOpen/didChange/didClose を処理します。現在のバージョンや世代の変更は古い処理をキャンセルし、重複するアクティブなリクエスト ID は拒否され、遅れて届いた応答は無視されます。ローカル URI は、リンクを経由せず、ワークスペース内に解決される必要があります。ソースと編集対象には、現在の認可と、開かれている、またはホストが提供する正確なスナップショットが必要です。名前変更/フォーマット/アクションの結果は、基準ハッシュ付きの条件付きワークスペース編集案であり、自動適用される編集や実行可能なコマンドではありません。

診断は、現在の文書バージョンと一致する場合だけ受け付けます。バージョンなし/古い通知は破棄して数えます。明示的な未対応機能は、補完の resolve/スニペット、コードアクションの resolve、セマンティック差分、サーバーコマンド、動的機能、リソース操作、ソケットトランスポート、バージョンなし診断です。workspace/applyEdit は applied:false を返します。上限は、メッセージ 1 MiB、ヘッダー 8 KiB、セッション 64 MiB/20,000 メッセージ、保留リクエストとキュー中の書き込み各 16 件、文書 32 個/合計テキスト 4 MiB、リクエスト期限最大 30 秒、破棄される stderr 64 KiB です。

close は shutdown/exit を送り、上限付きで直接プロセス/パイプをクリーンアップします。正常な応答、拒否/クラッシュしたサーバー、実際のプロセス終了を区別します。サーバーが shutdown に応答しても、所有プロセスの停止が必要な場合があります。自動再起動やリプレイはありません。オペレーターが新しいブリッジを作成し、選択した現在のスナップショットを明示的に再送します。合成テストは、不正なフレーミング、クラッシュ/タイムアウト、キャンセル/遅い応答、文書の競合、shutdown の拒否、未対応リクエスト、マッピングされた全機能を検証します。

実際の独立サーバーチェックは、コミュニティ版 typescript-language-server 5.3.0 と TypeScript 5.9.3 を使います。補完、ホバー、定義、参照、シンボル、シグネチャヘルプ、フォーマット、セマンティックトークンは合格しました。選択した実装ファイルと Node は固定され、tsserver パスも固定、自動型定義取得は無効です。このサーバーバージョンは、任意の initialize.serverInfo を省略し、バージョンなしの診断を送るため、診断はこのブリッジでは明示的に未対応です。バージョン付き診断は、独立した合成サーバーで検証されています。オペレーターは、インストール済みツール全体とその OS アクセスを信頼する必要があります。

1.2 の受け入れ検証には、独立したパッケージ化コンシューマー、型宣言、107 スキーマ、実際のコンパイラー/サーバーアダプター、過去の公開アーカイブとの相互運用性が含まれます。ワークフローの例は、永続化された状態からの復旧と明示的な再試行を、自動リプレイと区別します。セキュリティ監査と脆弱性検証は、所有者の延期判断により保留中です。このリリースは、DDS UI、Engine、Cloud スケジューラー、Marketplace、インストーラー、セキュリティサンドボックスの受け入れを意味しません。

型、API、上限、実行可能な完全な例

node node_modules/@altifigence/dds-plugin-sdk/examples/workflows/run.mjs
node node_modules/@altifigence/dds-plugin-sdk/examples/workflow-tools/run.mjs
node node_modules/@altifigence/dds-plugin-sdk/examples/lsp/run.mjs
node node_modules/@altifigence/dds-plugin-sdk/examples/tool-streams-browser/serve.mjs

実際のアダプターでは、オペレーターが承認した既存インストールの絶対パスを追加してください。デフォルトの例は SDK 作成のフィクスチャだけを使い、ツールをダウンロードしません。

node node_modules/@altifigence/dds-plugin-sdk/examples/workflow-tools/run.mjs --typescript-root /absolute/path/to/typescript
node node_modules/@altifigence/dds-plugin-sdk/examples/lsp/run.mjs --typescript-root /absolute/path/to/typescript --language-server-root /absolute/path/to/typescript-language-server