ワークスペースの境界
ワークスペースとは、プロジェクトルートが示すディレクトリツリーです。設定の workspace:
ブロックが置かれているルート、--workspace-root が指定するルート、エディタが開いたフォルダ、またはアシスタントの
サーバーの起動対象となったフォルダがこれにあたります。Aggrega が自らの判断で読み書きするものはすべてこのツリー内に限られます。
ただし、利用者またはワークスペースの設定がツリー外の場所を指定した場合は例外です。ツリー内のシンボリックリンクは
マシン上のどこでも指すことができるため、リンクがツリー内に置かれているというだけでワークスペースの一部とみなされることはありません。
判断の基準となるのは、リンクの行き先です。
このページでは、このルールの全体を説明します。各インターフェースのページ (コマンドライン、 言語サーバー、 アシスタントツール)では、それぞれのリクエストがこのルールにどう従うかを説明しています。
ワークスペースの内側にあるもの
パスのうち実在する最も深い部分が、リンクをたどった結果、ワークスペースのルートであるかその配下にある場合、そのパスはワークスペースの内側にあります。 ルート自身のリンクも同じようにたどるため、ワークスペース自身のリンクを通じて到達するワークスペースでも、その配下のすべてを保持します。
リンクを通じて開いたルートは、そのリンクの先にあるワークスペースです。 開いたフォルダ自体がリンクであっても、その上位のリンクを通じて到達したものであっても、Aggrega はリンクの先にあるワークスペースで行うのとまったく同じものを一覧し、読み取り、書き込みます。つまり、その Releases、ドキュメント、ロックファイルです。また、その内側のすべてのリンクを同じ方法で判定します。応答に含まれるパスは、引き続き与えられたとおりのルートから表記されます。すなわち、エディタが開いたフォルダ、入力した --workspace-root、シェルが作業中と示すディレクトリです。そのため、表示される内容は作業中のパスと一致します。
この一つの解釈が、あらゆる種類のパスに適用されます。
- パスを決めるのは、その表記ではなく、行き着く先です。
sharedが別の場所にあるディレクトリへのリンクである場合、./shared/app.yamlはそのすべての部分がワークスペース内に書かれていても外側です。リクエストのパラメータは、たとえばルートからの相対パスのように、独自の表記を求めることがあり、その場合はそのパラメータのページに記載されています。これはパラメータについての規則であり、境界についての規則ではありません。 - まだ存在しないパスは、そこに至る途中のディレクトリによって判定されます。 外側へ向かうリンクである
distの配下にビルドがこれから作成するファイルは、書き込まれる前から外側です。 - どこにも行き着かないリンクや、ループするリンクは、実在するものとはみなされません。 代わりにそれを含むディレクトリが判定され、リンクが本来どこを指すはずだったかを調べるためにたどることはありません。そのようなリンクが、これからファイルが作成されるまさにその場所にある場合は、ファイルが置かれることになるリンクの指す先も検査されます。
- ワークスペース内の別の場所へのリンクは、通常どおりたどられます。 留められるのは外側へ向かうリンクだけです。
この規則は、パスがディスク上のどこに行き着くかだけを判定します。値を読み取ることはなく、名前から何かを推測することもありません。
外部を指すリンクの扱い
外部を指すパスがどう扱われるかは、そのパスの種類によって決まります。結果は 3 通りあります。
読み取らなかったものとして一覧に示す
Aggrega がワークスペースの内容を一覧にする場面では、外部を指すリンクは読み取られず、一覧にそのことが示されます。 エディタが選択肢として提示する Releases、エンティティインデックスとエディタがそこから得る補完や候補、そしてアシスタントの list-releases と list-entities は、ワークスペース外のディレクトリを検索せず、ワークスペース外のファイルも、そのファイルが何を宣言していても読み取りません。そのため、そのようなリンクの下にあるとエディタが表示するエンティティは、ワークスペース自身のものとしては一覧に載りません。Release の一覧とエンティティの一覧は、そのようなリンクをすべて、リンク先ではなくワークスペース内でのリンク自身の場所で示します。言語サーバーでは unreadLinkedDirs と unreadLinkedFiles、アシスタントのツールでは unread_linked_dirs と unread_linked_files です。設定の catalog_dirs に列挙されたディレクトリ、その下のディレクトリ、または設定が指定する Release へのリンクは示されません。後述の例外で説明するとおり、その場所には設定が到達しているためです(列挙されたディレクトリは、その下のすべてを含めて読み取られます)。外部を指すリンクである .gitignore も読み取られないため、マシン上の別の場所にあるファイルが、ワークスペースのどのドキュメントを検索するかを決めることはありません。外部を指すリンクであるワークスペース設定ファイルも、読み取られなかったファイルとして示されます。これらの一覧は、何も設定されていない状態で読み取ったそのワークスペースについて引き続き応答しますが、設定によって決まるリクエストはすべて停止します。これは後述のワークスペース自身の設定で説明します。
拒否する
マシンの所有者自身が入力したのではないリクエストが指定するパスは、拒否されます。 後述の例外を除き、エディタが aggrega serve へのリクエストでサーバーに読み書きさせるパス、およびアシスタントが HTTP 経由で接続したサーバーに指定するパスは、すべてワークスペース内を指していなければなりません。外部を指すパスは何も読み書きされずに拒否され、拒否にはそのパラメータが示されます。詳細は各インターフェースのページに記載されています。ドキュメントの編集は、コマンドラインを含むすべてのインターフェースでこのように拒否されます。ドキュメントの編集はワークスペース内にとどまるを参照してください。
停止する
操作が自らの判断で外部を指すリンクを通じて読み書きしようとする場合、その操作は停止します。 これらは指定されたパスではなく製品自身が導き出すパスであり、黙って読み飛ばすとビルドの意味が変わる可能性があります。そのため、いずれの場合も操作を停止し、リンクとそのリンク先を示し、リンク先の場所には一切手を加えません。
- ルックアップが読み取るもの — カタログディレクトリ配下のドキュメント、Aggregate または Manifest を ID で指定する Release の隣にあるドキュメント、または拡張元の Manifest を同じように指定する Manifest の隣にあるドキュメントです。操作に指定された Release や Manifest 自体はこれらのドキュメントに含まれません。それは指定された場所で読み取られています。リンクを通じて指定された Release または Manifest を参照してください。
そのようなリンクを読み飛ばしたルックアップは、代わりに後続のディレクトリから同名の別のエンティティを解決してしまう可能性があります。そのため、ビルド、プル、検証、カタログを読み取るインスペクション、1 つの Release またはカタログ全体の lint、そして Release をビルド、プレビュー、グラフ化、検証、lint、説明するエディタおよびアシスタントのリクエストは、いずれも何かを解決またはチェックする前に停止します。
E0321。 - Release のロックファイル — ビルド、プル、検証、lint、
インスペクション、
aggrega cache prune、およびエディタとアシスタントのリクエストが解決に使うピンを得るために、Release の隣で読み取られます。ロックファイルは、書き込まれる場所とまったく同じく読み取られる場所でも制限されるため、外部を指すリンクであるロックファイルは、マシン上の別の場所に保持されたピンを提供するのではなく、それぞれの操作を停止させます。E0321。 - エンティティの隣で読み取られるファイル — ピン留めまたは公開するエンティティのディレクトリにある他のドキュメント(別のエンティティがそのディレクトリを共有しているかどうかを判断するために読み取られます)、およびカタログディレクトリ内の Plugin エンティティの読み込み元となるビルド済みの
.wasmです。いずれも、そのエンティティ自身のドキュメントが読み取られたディレクトリ、つまりワークスペース、ワークスペース外に指定したカタログディレクトリ、またはワークスペース外に指定したドキュメントのディレクトリの内部からのみ読み取られます。そのため、外部を指すリンクであるファイルは、aggrega pin、aggrega push(ドライランを含む)、ピン留めを行うプル、およびエディタとアシスタントによるピン留めと公開を停止させます(読み取られなかったドキュメントが、妨げとなるエンティティである可能性があるためです)。また、マシン上の別の場所に保持されたバイト列を実行するのではなく、プラグインを読み込むビルドやプルを停止させます。E0321。 - アーティファクトキャッシュ — Aggrega が
artifact_cache_dir配下のキャッシュから読み取るすべてのもの、すなわちキャッシュされたエンティティ、プラグイン、ライブラリとその隣のマニフェスト、ソースアーカイブとそのメタデータ、ピン留めされた外部入力、署名バンドルとレジストリのローカル検索インデックス、そしてaggrega cache status、aggrega cache prune、aggrega cache clearが一覧にするすべてのワークスペースエントリです。キャッシュは、書き込み先であるキャッシュディレクトリの内部からのみ読み取られます。そのため、キャッシュ内にあってそのディレクトリの外部を指すリンク(リンク先がワークスペース内の別の場所であっても他のどこであっても同じです)は、キャッシュが所有しない場所に保持されたバイト列を渡すのではなく、ビルド、プル、検証、検索、3 つのキャッシュコマンドのそれぞれ、およびキャッシュを読み取るエディタとアシスタントのリクエストを停止させます。記録されたダイジェストと照合されたコンテンツも例外ではありません。ダイジェストはバイト列が何であるかを示すものであり、どこから読み取ってよいかを示すものではないためです。aggrega inspectが出力する非推奨の通知は、何も決定しないため対象外です。prune または clear が、キャッシュ自身のディレクトリのうちそのようなリンクであるもの、またはそれ自体がワークスペースの外部を指すリンクであるキャッシュディレクトリに出会った場合は、それを本来行うはずの削除として扱い、何かを一覧にする前にE0320で停止します。E0321。 - ソースが取得するリポジトリ —
git-repositoryソースに対してプルがアーカイブするチェックアウトです。チェックアウトはそれ自体が独立したディレクトリであるため、リポジトリに含まれるリンクは、リンク先がリポジトリ内にある場合に限り、そのリンク先としてアーカイブされます。リポジトリの外部を指すリンクは、プルを実行するマシン上の任意のファイルに到達しうるため、何もキャッシュせずに、リンクとそのリンク先を示してプルを停止させます。module_subdir自体がそのようなリンクである場合も同様です。E0321。 プルが停止するとチェックアウトは削除されるため、メッセージはリンクをリポジトリ内での場所で示し、あわせてソースが指定するリポジトリとリビジョンを示します。記述の時点でリポジトリより上の階層に遡るmodule_subdirは、リポジトリを取得する前に拒否されるため、チェックアウトの外側にあるものは何も読み取られません。E0307。 - インポートするディレクトリのファイル —
aggrega import、アシスタントのインポートツール、およびセッションのaggrega/importは、ディレクトリを与えられると、そのディレクトリのファイルのうちインポーターのファイルパターンが選択するものを読み取ります。 このディレクトリは、どこにあってもそれ自体がルートになります(インポートするディレクトリを参照)。そのため、それらのファイルの中にディレクトリの外へ出るリンクがある場合、またはディレクトリの外へ出るディレクトリへのリンクがある場合、ディレクトリのファイルを読み取る前に、そのリンクを示してインポートが停止します:E0321。 - ワークスペース自身の設定 — ルートからコマンドを実行するディレクトリまでのすべての
.aggrega-config.yamlと、そのいずれかの隣にあるパイプラインの.aggrega-config-append-ci.yamlです。設定を読み取るすべてのコマンド、言語サーバー、アシスタントのツールは、何よりも先に設定を読み取ります。そのため、これらのファイルのいずれかが外へ出るリンクである場合、残ったものから作られた設定で実行させるのではなく、その時点でそれぞれを停止します:E0321。設定を読み取らないaggregaコマンド (version、help、completion、explain、get-schema、スターター文書を下書きするscaffold、skills list、plugin run-local、plugin sync、auth token、logout) は、そのリンクを示す警告を出して通常どおり実行されます。scaffold --exampleは、デフォルトのレジストリと署名ポリシーのために設定を読み取り、他のすべての読み取り側と同様にその時点で停止します。言語サーバーと、自身のストリームで通信するアシスタントのサーバーは、そのようなワークスペースでも起動し、その内容を一覧できるようにします。Release とエンティティの一覧は、カタログディレクトリも他の設定も一切ない状態で読み取って応答し、そのファイルを読み取られないリンクの中に挙げます。設定が決定するその他のすべてのリクエスト (ビルド、プレビュー、グラフ、検証、lint、説明、有効な設定、デフォルトの Release) は、そのリンクを示してE0321で停止します。HTTP で待ち受けるよう求められたアシスタントのサーバーも同様に停止します。そのアドレスと認可は設定が決めるはずだったものだからです。 - 操作が書き込む、または削除するもの — ビルドの出力ディレクトリ、その境界ディレクトリとそこに書き込まれるすべてのファイル、トレース。Release のロックファイルとその隣のプラグイン信頼記録。
entity.lock。コマンドが書き込むワークスペース設定ファイル。アーティファクトキャッシュと、pull が埋める、またはaggrega cache clearとaggrega cache pruneが空にするその各部分。インポートが書き込む下書きと、aggrega plugin gen-catalogが書き込む Plugin エンティティ。そして、エディタがデフォルトの Release を記録し、言語サーバーがエディタのために書き込む.aggrega/active-releaseマーカーです。リンクであるdistがあると、「出力を再ビルドする」ことが、マシン上の別の場所にあるディレクトリの削除に変わってしまいます:E0320。 - ドキュメントがパスで指定するもの — ドキュメントが書く参照を参照してください:
E0324。 - エンティティが宣言するコンテンツ — パスがエンティティ自身のディレクトリの外へ出るリンクであるディレクトリを通過する
source:または$import:です。そうでなければ、公開時にエンティティ内の名前のもとでその内容が運ばれてしまいます:E0304。
これらは、操作を開始したのが誰であっても(コマンドライン、エディタ、いずれかのトランスポート上のアシスタント)適用されます。パスは呼び出し元のものではなく、ワークスペースと製品のものだからです。
ドキュメントが記述する参照
Release と Manifest は、パスによって別のファイルを指定できます。./… または ../… と記述された Release の aggregate: と manifest:、その extends:、パスとして記述された Manifest の extends:、そして Release の parameters: { $import: … } です。ワークスペース内のドキュメントは、この方法ではワークスペース内のファイルにしか到達しません。記述どおりに外へ出るパスは拒否され、記述上はワークスペース内にとどまっていても途中で外へ向かうリンクに出会うパスも同様に拒否されます。どちらの場合も、指定されたファイルからは何も読み込まれません。
クローンしたワークスペースには作成者の参照が含まれているため、自分が指定するものだけを制限し、ドキュメントがその先で導くものには何でも従うのであれば、境界は ../ 一つで越えられてしまいます。ドキュメントが別の場所に置かれたエンティティを必要とする場合は、ファイルではなくエンティティを名前で指定し(aggregate: payments)、ワークスペースの設定にそのエンティティを含むカタログディレクトリを列挙します。名前は辿られるのではなく検索されるため、ここで拒否されることはありません。
ワークスペースの外にあり、指定したことによって受け入れられた Release や Manifest は、自身のディレクトリ内のファイルにしか到達しません。例外は指定したディレクトリまで到達し、それより先には及ばないを参照してください。
例外と、それぞれが例外である理由
次のいずれかの種類に属するパスは、ワークスペースの内外を問わず、その指す先で受け入れられます。それぞれは場所の一覧ではなくパスの種類であり、それぞれに固有の理由があって例外となっています。
- ワークスペース設定が指定するもの。 そのカタログディレクトリ(ワークスペース用、または
workspace.releases配下の Release 用のcatalog_dirsとcatalog_dirs_append)、workspace.releases配下にキーとして記載された Release ファイル、build.authoring_release、プラグインのアタッチメントのローカルの.wasmとそのwith.sources配下のファイル、mcp.tls.cert_file、mcp.tls.key_file、mcp.authorization.jwks_file、レジストリの固定されたトラストルート、そしてワークスペースルートの外へ出るartifact_cache_dirです。設定でパスを指定することは、ワークスペースが自身の外へ到達するための意図的な方法です。それは一度書き留められ、プロジェクトとともに保管され、レビューする人なら誰でも読めます。ワークスペースの慣例的なcatalogディレクトリは、設定がそれを記載しているか--catalogで渡した場合に指定されたものとみなされます。あるいは、それが指す先をどのような表記であれ記載するか渡した場合、またはその先より上位のディレクトリを記載するか渡した場合も同様で、このとき、そこにあるものは指定したディレクトリを通じて一度だけ読み込まれます。そこにあるというだけで読み込まれるものはワークスペース自身のコンテンツであるため、ワークスペースの外へ出るリンクであるcatalogは、それ自体またはその指す先を指定するまで読み込まれません。 - コマンドラインで入力するパス。
aggrega build --release ../other/release.yaml、--catalog /srv/shared-catalog、--output-dir、検証、lint、固定、公開の対象となるファイル。いずれも指す先でそのまま使われます(後述するドキュメント編集は除きます)。コマンドを実行するマシンは利用者自身のものであり、入力し得るものはすでにすべて読み書きできるため、ディレクトリに制限しても何も得られません。 - アシスタントがプロセス自身のストリームを通じて指定するパス。 マシン上で
aggrega mcpを起動したクライアントは利用者として実行され、そのホストは通常、独自のファイルツールやシェルツールを与えているため、それが指定するパスは利用者が入力した場合と同様に受け入れられます。詳しくは2 つのアシスタントトランスポートを参照してください。 - 製品のマシン全体のストア:グローバル設定ファイル、コンパイル済みモジュールストア、プラグイン記述子キャッシュ、ドキュメントバンドル、レジストリ認証情報ストアです。これらはどのワークスペースでもなくマシンに属するため、どのワークスペースにも含まれません。
- ダイアログで選択され、その場所で読み込まれるファイルまたはディレクトリ。 エディタは、レジストリ登録の鍵ファイルやトラストルート、
aggrega/importが変換する記述(ファイル、またはインポーターがファイルを読み込むディレクトリ)、そしてaggrega/pluginGenCatalogが隣にあるオーバーレイとともにエンティティを生成するモジュールを、絶対パスとして送信します。いずれも、保管場所にかかわらず人が選んだものです。これらは読み込まれるだけで、リクエストが書き込むものがこの方法で選ばれたパスに書き込まれることはありません。この方法で選ばれたディレクトリは、インポートするすべてのディレクトリと同様に、そのディレクトリ自身の中に制限されます。 - エディタが開いているドキュメント。 その検証、診断の要求や破棄、ホバー、補完、解決、そしてその中での参照や実装の検索は、エディタが送信したコンテンツをもとに応答されるため、それを指すパスでファイルが読み込まれることはなく、パスがその指す先を理由に拒否されることもありません。ドキュメントを実際にディスクから読み込むリクエストは、前述の拒否される種類に該当します。
コマンドラインで入力されたパスとマシン全体のストアは一切判定されません。それ以外のものは、その種類によって通過が許可され、たまたまそれを運ぶリクエストによって許可されることはありません。
例外は指定したディレクトリまで到達し、それより先には到達しない
ワークスペースの外で指定したディレクトリは、その配下で読み書きされるすべてにとって独立したルートとなります。ディレクトリ自体は指定したとおりに使われ(リンクであるディレクトリはその指す先まで辿られます)、その配下にあってその外へ出るリンクは、ワークスペース内のリンクとまったく同じように扱われます。つまり、一覧では読み込まれず、検索や書き込みを停止させます。したがって、ワークスペースの外に記載したカタログディレクトリ、aggrega plugin gen-catalog や aggrega import に渡す出力ディレクトリ、ワークスペースの外へ出る
artifact_cache_dir は、いずれも配下にあるものをそれ自身の中に制限します。指定したディレクトリがワークスペース内にある場合は、ワークスペースがルートとなります。ただしインポートするディレクトリは例外で、どこにあっても独立したルートとなります。
指定したディレクトリは、配下に何かが配置される前に、実行しているフォルダを基準に解決されます。
aggrega import に相対パスで渡した出力ディレクトリは、コマンドを実行しているフォルダ内のその名前のフォルダとなり、Windows で単独で指定したドライブ(D:)は、そのドライブ上のカレントフォルダとなります。ディレクトリはまずフルパスに変換され、すべてのファイルはそのフルパスの配下に配置されます。そのため、\notes.txt のように区切り文字で始まる名前のファイルは、ドライブの最上位ではなく指定したディレクトリ内に配置され、コマンドが報告するディレクトリは実際に書き込まれたディレクトリと一致します。
ワークスペースの外で指定した Release または Manifest には、同じ規則がファイルに対して適用されます。そのファイル自身のディレクトリがルートとなるため、それがパスで指定するもの、およびその extends: チェーンが辿るすべての Release が指定するものは、そのディレクトリ内にとどまる必要があります。Aggregate および Manifest の隣に置かれた Release はどこからでもビルドできますが、通常の releases/ レイアウトにあり ../aggregates/app.yaml を指定するものは、代わりにそれ自身のワークスペースからビルドされます。
リンクを通じて指定された Release または Manifest
リンクを通じて指定した Release は、リンクの指す先で読み込まれ、指定した場所で解決されます。
release.yaml が別の場所にあるファイルへのリンクである状態で --release release.yaml と入力した場合(または workspace.releases 配下で、あるいは build.authoring_release として同様に指定した場合)、Release はリンクの指す先から読み込まれます。それが識別子またはパスで指定する Aggregate と Manifest は、リンクの隣、つまりそれを指定したディレクトリで探され、そのディレクトリのルート(ワークスペース、またはワークスペースの外にある場合はそのディレクトリ自体)に制限されます。そのロックファイルもリンクの隣で読み書きされ、リンクの指す先で読み書きされることはありません。Release は、自身の検索が隣で出会うドキュメントには含まれないため、その検索を停止させることはありません。一方、隣に置かれた別の Release が外へ出るリンクである場合は、引き続き検索を停止させます。リンクを通じて単独で検査する Manifest も、同じ方法で読み込まれ解決されます。
アーティファクトキャッシュディレクトリは、どこにあっても独立したルートです。 キャッシュが保持するものはすべて、キャッシュディレクトリ内でのみ書き込み、読み込み、削除されます。そのため、キャッシュ自身のディレクトリまたはその中のファイルのうち、キャッシュディレクトリの外へ出るリンクであるものは、たとえワークスペース内の別の場所を指していても停止され、キャッシュディレクトリ内の別の場所を指すものは辿られます。キャッシュディレクトリ自体の場所は、その値の表記から判断されます。ワークスペースルート内として記述されている場合(デフォルトの .aggrega/cache を含む)、それはワークスペース自身のディレクトリです。ワークスペース内の別の場所へのリンクであるキャッシュディレクトリは辿られ、ワークスペースの外へ出るものは、読み込みでも書き込みでも拒否されます。外へ出るように記述されている場合(../shared-cache)、それは設定が指定するディレクトリであり、その指す先で読み書きされます。
インポートするディレクトリ
インポートするディレクトリは、どこにあってもそれ自体がルートです。ワークスペースの外にある場合と同様にワークスペースの内側にあっても同じであり、この点がワークスペース内で指定する他のすべてのディレクトリと異なります。
aggrega import、アシスタントのインポートツール、セッションの aggrega/import は、ディレクトリ内の各ファイルをそのディレクトリ内での位置のもとでインポーターに渡すため、渡されるものはディレクトリの内側からのみ読み取られます。判定されるのは、インポートが何かを取り込む対象です。すなわち、インポーターのパターンが選択するファイルへのリンク(形式が指定されるのではなく認識される場合は、いずれかのインポーターのパターン)と、ディレクトリへのリンクです。ディレクトリへのリンクの中に入ることはありません。これらのうちディレクトリの外へ向かうものは、ワークスペース内の別の場所へ向かう場合であっても、いずれかのファイルが読み取られる前に拒否されます。一方、ディレクトリ内の別の場所にあるファイルへの選択されたリンクは、リンク先から、リンク自身の名前のもとで読み取られます。どのパターンにも選択されないファイルへのリンクは、判定も読み取りもされません。ディレクトリ自体は指定したとおりに使われ、リンクであるディレクトリはリンク先までたどられます。
ドキュメントの編集は内側にとどまる
aggrega edit-document、言語サーバーのドキュメント編集と挿入位置、アシスタントの
edit-document と insertion-point は、ワークスペースが保持するドキュメントに対してのみ動作します。ワークスペースの外にあるドキュメントは、記述どおりであってもワークスペースの外へ向かうリンクを経由したものであっても、どの経路でも拒否され、何も読み取られず書き込まれません。指定したパスが他の場面では尊重される場合も同様です。
2 つのアシスタントトランスポート
aggrega mcp は同じツールを 2 つの方法で提供します。呼び出し元が異なるため、境界も両者で異なります。
- プロセス自身のストリーム経由では、クライアントがお使いのマシン上でサーバーを起動しているため、呼び出しはコマンドラインでの入力と同じ扱いになります。パス引数は絶対パスでもよく、ワークスペースの外にあってもかまいません。呼び出しは独自の
workspace_rootとcatalog_dirsを指定でき、別プロセスでaggregaコマンドを実行するツールも提供されます。指定どおりに尊重されるのは、呼び出しが指定したパスだけです。その後に操作が自らの判断で読み書きするものは、ターミナルの場合と同じく制限されます。一覧は外へ出るリンクをたどって読まず、ドキュメントが書く参照はワークスペースの外へ出ず、書き込みはリンクされた出力ディレクトリやキャッシュディレクトリを経由しません。ワークスペースの内容はアシスタントが要求するものを誘導できるため、これらのツールがファイルへの唯一の到達手段であるホストでも、クローンしたワークスペース内のドキュメントがアシスタントにワークスペース外のパスを指定させ、読み書きさせることは依然として可能です。アシスタントが確認なしにどこまで行うかは、アシスタントが事前の確認なしにできること で設定します。 - HTTP 経由では、呼び出し元はサーバーが動作するマシンの所有者ではありません。ワークスペースはサーバーの起動時に指定されたもので、その存続期間中は固定されます。すべてのパス引数はその内側に制限され、上記のとおりに判定されます。
workspace_rootやcatalog_dirsを指定する呼び出し、またはホスト上に保持された署名鍵を選択する呼び出しは拒否されます。また、aggregaコマンドを実行するツールは提供されません。拒否の際は引数を示し、相対値を送信されたとおりに引用しますが、ワークスペースのルートも、パスがどこへ 至るはずだったかも示しません。
拒否または停止が起きたとき
| 表示される内容 | 対処方法 |
|---|---|
| 一覧が、読み取らなかったものの中にリンクを挙げる | リンクを、そのリンク先のコピーに置き換えます。または、別の場所に置かれたエンティティについては、リンク先のディレクトリを catalog_dirs に列挙します。別の場所に置かれた Release については、workspace.releases に、または build.authoring_release として指定します。 |
E0321、カタログディレクトリまたは Release のディレクトリから外へ出るリンクを通じた読み取り | カタログディレクトリの下のリンクを通じて到達するのではなく、リンク先のディレクトリをカタログディレクトリとして列挙するか、--catalog で渡します。または、リンクをコピーに置き換えます。リンクが慣例の catalog そのものである場合は、catalog またはそのリンク先のディレクトリを列挙するか、いずれかを --catalog で渡します。 |
Release のロックファイルでの E0321 | リンクを削除して Release を再度プルします。これにより、その横に新しいロックファイルが書き込まれます。ロックファイルにはほかの置き場所はありません。 |
エンティティの横のファイルでの E0321 | リンクをファイルそのものに置き換えます。エンティティであるドキュメントは専用のディレクトリに移し、ビルドした .wasm は、それへのリンクではなく実体を Plugin エンティティの横に置きます。 |
設定ファイルでの E0321 | リンクを、ワークスペース内に置いたコピーに置き換えます。ワークスペース間で共有する設定は、--config または AGGREGA_CONFIG でグローバル設定ファイルとして指定することで、各ワークスペース自身のファイルの下位に読み込まれます。 |
アーティファクトキャッシュでの E0321 | リンクを削除します。プルによってキャッシュは再び満たされます。キャッシュを別の場所に置くには、リンクするのではなく、artifact_cache_dir にそのディレクトリをワークスペースルートからの相対パス(../shared-cache)で設定します。 |
取得したリポジトリ内のリンクでの E0321 | リンクはソースが指定するリポジトリにコミットされています(メッセージはそのリポジトリ内での位置でリンクを示します)。そこで変更し(リポジトリ内を指すようにするか、ファイルそのものをコミットします)、その変更を含むリビジョンを指定します。 |
インポートするディレクトリ内のリンクでの E0321 | ファイルへのリンクではなくファイルそのものをディレクトリに置くか、リンク先のディレクトリをインポートします。インポートするディレクトリは、どこにあっても、その内部からのみ読み取られます。 |
module_subdir での E0307 | リポジトリ内のディレクトリを指定します。値はリポジトリの最上位より下に降りることはできますが、それより上に上がることはできません。 |
E0320、リンクを通じた書き込みまたは削除 | メッセージが示すリンクを削除するか、メッセージが示すディレクトリ内のどこかを指すようにしてから、操作を再実行します。エンティティファイルの内容が原因ではありません。 |
E0324、外へ出る参照 | 別の場所に置かれた Aggregate は metadata.name で指定し、そのカタログディレクトリを列挙します。Manifest、extends: が指定する Release、パラメータファイルはワークスペース内に置きます(外部から指定したドキュメントの場合は、そのドキュメント自身のディレクトリ内に置きます)。または、両方のドキュメントを含むディレクトリでワークスペースを開きます。 |
E0304、リンクを通じたコンテンツ | リンクを、エンティティ自身のディレクトリ内に置いたリンク先のコピーに置き換えます。 |
| 外へ出るパスのために拒否された言語サーバーリクエスト | ワークスペース内のパスを、そのルートからの相対パスで送ります。ワークスペース外に置かれた Release には、設定の workspace.releases に、または build.authoring_release として指定したうえで、リクエストではそこへ通じるワークスペース内のリンク(Release 一覧がそれを提示する場所)を指定することで到達します。 |
| パスのために拒否された HTTP 経由のアシスタント呼び出し | サーバーが提供するワークスペースのルートからの相対パスを送ります。拒否が絶対パスの相対表記を提示している場合は、それを送ります。 |
| 拒否されたドキュメント編集 | ワークスペースが含むドキュメントを編集します。別の場所にあるドキュメントへのリンクを通じた編集は行われません。 |
関連項目
- 設定 — 上記の各設定をどこに記述するか、またその中の相対 パスがどのように解決されるか。
aggrega serveとaggrega mcp— 各リクエストとツール、および そのパラメータのうちどれがパスを指定するか。- 致命的な停止 — 上記の各状況についての完全な項目。