Skema protokol wire daemon latar belakang Aggrega
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/serve-wire-v1beta1.schema.json
Bentuk-bentuk pesan yang dipertukarkan dengan daemon kompiler latar belakang yang dijalankan oleh aggrega serve. Klien membuka sesi pada daemon tersebut melalui handshake, dan sesi itulah yang menentukan cakupan pengaturan serta workspace tempat percakapan dibuka; daemon adalah proses yang menjawab permintaan, mengirim notifikasi, dan menyimpan apa yang telah dibacanya. Protokolnya adalah JSON-RPC 2.0 melalui input dan output standar, dengan setiap pesan dibingkai oleh header Content-Length; dokumen ini menjelaskan isi pesan, bukan pembingkaian maupun transportnya. Sebuah isi pesan adalah salah satu dari empat hal: permintaan yang dikirim klien, notifikasi yang dikirim klien, notifikasi yang dikirim daemon, atau respons yang dikembalikan daemon untuk suatu permintaan. Tiga sifat dari antarmuka ini menentukan cara penulisan bentuk-bentuk di bawah. Pertama, setiap permintaan menerima dua field di luar field yang dideklarasikan oleh metodenya sendiri — workspaceRoot, yang menyebutkan workspace yang menjadi sasaran permintaan, dan workDoneToken, nilai yang dibuat oleh pemanggil dan menjadi acuan pelaporan kemajuan — sehingga keduanya muncul pada setiap objek params permintaan di sini, termasuk tiga metode yang subjeknya bukan workspace: aggrega/getSchema dan aggrega/scaffoldEntity menerima workspaceRoot tetapi mengabaikannya, dan aggrega/initialize membacanya sebagai workspace yang dideklarasikan sesi. Kedua, daemon menolak objek params permintaan yang memuat field yang tidak diterima oleh metode tersebut, dengan menyebutkan field yang diterimanya, sehingga setiap objek params di sini tertutup pada tingkat teratasnya; objek bersarang di dalam permintaan tidak tertutup, karena pemeriksaan hanya membaca nama-nama field terluar. Ketiga, hasil disusun oleh daemon alih-alih disediakan oleh pemanggil, sehingga objek hasil tertutup pada setiap tingkat yang bentuknya tetap, dan hanya terbuka di tempat nilainya berupa JSON opak yang diteruskan daemon tanpa dibaca. Salah satu konsekuensi dari pengodean daemon terlihat pada wire dan dijelaskan alih-alih disembunyikan: koleksi yang tidak ditandai opsional oleh daemon dikeluarkan sebagai null ketika tidak ada nilai untuk dilaporkan dan sebagai koleksi kosong ketika nilai yang dilaporkannya kosong, sehingga kedua bentuk tersebut diterima di mana pun hal itu berlaku.
Salah satu dari bentuk berikut
RequestClientNotificationDaemonNotificationSuccessResponseErrorResponse
Definisi
ProtocolVersion
Versi JSON-RPC yang dibawa setiap pesan. Hanya 2.0 yang digunakan.
Jenis: const "2.0"
Konstanta: "2.0"
RequestId
Pengenal yang diberikan pemanggil untuk sebuah permintaan, dipantulkan kembali pada respons yang menjawabnya. Pesan yang tidak membawa pengenal adalah notifikasi dan tidak pernah dijawab.
Jenis: string or number
ProgressToken
Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak.
Jenis: string or number
WorkspaceRootSubject
Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak.
Jenis: string
WorkspaceRootAccepted
Path absolut sebuah workspace. Subjek metode ini bukan workspace — metode ini menjawab dari apa yang dibawa oleh biner itu sendiri — sehingga field ini diterima tetapi tidak dibaca. Field ini diizinkan karena klien dapat mengirimkannya secara seragam pada setiap permintaan tanpa perlu mengetahui metode mana yang memakainya.
Jenis: string
RequestMethod
Setiap metode yang dapat disebut oleh sebuah permintaan. Himpunan ini tertutup: permintaan yang menyebut hal lain dijawab dengan galat method-not-found.
Jenis: string (enum)
Nilai yang diizinkan: "aggrega/activeRelease", "aggrega/attachCandidates", "aggrega/attachmentContainer", "aggrega/build", "aggrega/buildPreview", "aggrega/cacheClear", "aggrega/cacheEvict", "aggrega/cachePrune", "aggrega/cacheStatus", "aggrega/catalogIndex", "aggrega/completion", "aggrega/configCapture", "aggrega/configInit", "aggrega/connectionAtPosition", "aggrega/connectionCandidates", "aggrega/deprecateArtifact", "aggrega/diagnostics", "aggrega/editDocument", "aggrega/effectiveConfiguration", "aggrega/entityDefinition", "aggrega/explainError", "aggrega/findImplementations", "aggrega/findReferences", "aggrega/getSchema", "aggrega/hover", "aggrega/import", "aggrega/initialize", "aggrega/insertionPoint", "aggrega/invalidate", "aggrega/irGraph", "aggrega/lint", "aggrega/logout", "aggrega/pin", "aggrega/pluginAdd", "aggrega/pluginGenCatalog", "aggrega/pluginRemove", "aggrega/pluginSync", "aggrega/publishArtifact", "aggrega/publishEntity", "aggrega/registryAdd", "aggrega/registryList", "aggrega/registryRemove", "aggrega/registryUpdate", "aggrega/releaseCandidates", "aggrega/releaseClosure", "aggrega/resolve", "aggrega/resolveDependencies", "aggrega/scaffoldEntity", "aggrega/search", "aggrega/setActiveRelease", "aggrega/signArtifacts", "aggrega/skillsInstall", "aggrega/skillsList", "aggrega/validate"
ClientNotificationMethod
Setiap metode yang dapat disebut oleh notifikasi klien. Himpunan ini tertutup, dan tidak satu pun notifikasi dijawab.
Jenis: string (enum)
Nilai yang diizinkan: "$/cancelRequest", "aggrega/shutdown"
DaemonNotificationMethod
Setiap metode yang dapat disebut oleh notifikasi yang dikirim daemon. Himpunan ini tertutup.
Jenis: string (enum)
Nilai yang diizinkan: "$/progress", "aggrega/publishDiagnostics"
Request
Permintaan yang dikirim klien dan dijawab daemon. Metode menyebutkan apa yang diminta; objek params membawa field milik metode tersebut ditambah dua field yang diizinkan setiap metode. Permintaan yang sama sekali menghilangkan params dibaca sebagai permintaan yang semua field-nya tidak ada.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
jsonrpc | ProtocolVersion | ya | Versi JSON-RPC yang dibawa setiap pesan. Hanya 2.0 yang digunakan. |
id | RequestId | ya | Pengenal yang diberikan pemanggil untuk sebuah permintaan, dipantulkan kembali pada respons yang menjawabnya. Pesan yang tidak membawa pengenal adalah notifikasi dan tidak pernah dijawab. |
method | RequestMethod | ya | Setiap metode yang dapat disebut oleh sebuah permintaan. Himpunan ini tertutup: permintaan yang menyebut hal lain dijawab dengan galat method-not-found. |
params | object | tidak |
Properti tambahan tidak diizinkan.
params untuk setiap method:
method | params | Wajib |
|---|---|---|
"aggrega/initialize" | InitializeParams | tidak |
"aggrega/validate" | ValidateParams | tidak |
"aggrega/invalidate" | InvalidateParams | tidak |
"aggrega/diagnostics" | DiagnosticsParams | tidak |
"aggrega/irGraph" | IrGraphParams | tidak |
"aggrega/build" | BuildParams | tidak |
"aggrega/buildPreview" | BuildPreviewParams | tidak |
"aggrega/entityDefinition" | EntityDefinitionParams | tidak |
"aggrega/releaseClosure" | ReleaseClosureParams | tidak |
"aggrega/resolveDependencies" | ResolveDependenciesParams | tidak |
"aggrega/pin" | PinParams | tidak |
"aggrega/cacheStatus" | WorkspaceAndProgressParams | tidak |
"aggrega/cachePrune" | WorkspaceAndProgressParams | tidak |
"aggrega/cacheEvict" | CacheEvictParams | tidak |
"aggrega/cacheClear" | WorkspaceAndProgressParams | tidak |
"aggrega/registryList" | WorkspaceAndProgressParams | tidak |
"aggrega/search" | SearchParams | tidak |
"aggrega/registryAdd" | RegistryAddParams | tidak |
"aggrega/registryRemove" | RegistryRemoveParams | tidak |
"aggrega/registryUpdate" | RegistryUpdateParams | tidak |
"aggrega/logout" | LogoutParams | tidak |
"aggrega/publishEntity" | PublishEntityParams | tidak |
"aggrega/publishArtifact" | PublishArtifactParams | tidak |
"aggrega/signArtifacts" | SignArtifactsParams | tidak |
"aggrega/deprecateArtifact" | DeprecateArtifactParams | tidak |
"aggrega/resolve" | ResolveParams | tidak |
"aggrega/findReferences" | FindReferencesParams | tidak |
"aggrega/findImplementations" | FindImplementationsParams | tidak |
"aggrega/hover" | HoverParams | tidak |
"aggrega/completion" | CompletionParams | tidak |
"aggrega/catalogIndex" | CatalogIndexParams | tidak |
"aggrega/attachCandidates" | AttachCandidatesParams | tidak |
"aggrega/connectionCandidates" | ConnectionCandidatesParams | tidak |
"aggrega/insertionPoint" | InsertionPointParams | tidak |
"aggrega/attachmentContainer" | AttachmentContainerParams | tidak |
"aggrega/connectionAtPosition" | ConnectionAtPositionParams | tidak |
"aggrega/releaseCandidates" | WorkspaceAndProgressParams | tidak |
"aggrega/activeRelease" | WorkspaceAndProgressParams | tidak |
"aggrega/setActiveRelease" | SetActiveReleaseParams | tidak |
"aggrega/editDocument" | EditDocumentParams | tidak |
"aggrega/effectiveConfiguration" | WorkspaceAndProgressParams | tidak |
"aggrega/configInit" | ConfigInitParams | tidak |
"aggrega/configCapture" | ConfigCaptureParams | tidak |
"aggrega/import" | ImportParams | tidak |
"aggrega/scaffoldEntity" | ScaffoldEntityParams | tidak |
"aggrega/lint" | LintParams | tidak |
"aggrega/pluginAdd" | PluginAddParams | tidak |
"aggrega/pluginRemove" | PluginRemoveParams | tidak |
"aggrega/pluginSync" | PluginSyncParams | tidak |
"aggrega/pluginGenCatalog" | PluginGenCatalogParams | tidak |
"aggrega/explainError" | ExplainErrorParams | tidak |
"aggrega/getSchema" | GetSchemaParams | tidak |
"aggrega/skillsInstall" | SkillsInstallParams | tidak |
"aggrega/skillsList" | WorkspaceAndProgressParams | tidak |
ClientNotification
Notifikasi yang dikirim klien. Notifikasi ini tidak membawa pengenal dan tidak pernah dijawab.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
jsonrpc | ProtocolVersion | ya | Versi JSON-RPC yang dibawa setiap pesan. Hanya 2.0 yang digunakan. |
method | ClientNotificationMethod | ya | Setiap metode yang dapat disebut oleh notifikasi klien. Himpunan ini tertutup, dan tidak satu pun notifikasi dijawab. |
params | object | tidak |
Properti tambahan tidak diizinkan.
params untuk setiap method:
method | params | Wajib |
|---|---|---|
"$/cancelRequest" | CancelRequestParams | ya |
"aggrega/shutdown" | ShutdownParams | tidak |
DaemonNotification
Notifikasi yang dikirim daemon. Notifikasi ini tidak membawa pengenal dan tidak pernah dijawab.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
jsonrpc | ProtocolVersion | ya | Versi JSON-RPC yang dibawa setiap pesan. Hanya 2.0 yang digunakan. |
method | DaemonNotificationMethod | ya | Setiap metode yang dapat disebut oleh notifikasi yang dikirim daemon. Himpunan ini tertutup. |
params | object | ya |
Properti tambahan tidak diizinkan.
params untuk setiap method:
method | params | Wajib |
|---|---|---|
"$/progress" | ProgressParams | ya |
"aggrega/publishDiagnostics" | PublishDiagnosticsParams | ya |
CancelRequestParams
Meminta daemon membatalkan permintaan yang sedang berjalan, dengan menyebutnya melalui pengenal yang dibawa permintaan itu. Permintaan yang sudah selesai, atau tidak pernah dikirim, secara diam-diam dianggap tidak ada yang perlu dibatalkan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
id | RequestId | ya | Pengenal yang diberikan pemanggil untuk sebuah permintaan, dipantulkan kembali pada respons yang menjawabnya. Pesan yang tidak membawa pengenal adalah notifikasi dan tidak pernah dijawab. |
Properti tambahan tidak diizinkan.
ShutdownParams
Meminta daemon berhenti menerima pekerjaan dan menyelesaikan pekerjaan yang sudah diterimanya. Notifikasi ini tidak membawa field, dan notifikasi itu sendiri biasanya dikirim tanpa objek params sama sekali. Notifikasi kedua membatalkan pekerjaan yang masih berjalan alih-alih menunggunya.
Objek ini tidak mendeklarasikan properti tetap dan tidak mengizinkan satu pun.
ProgressParams
Satu laporan pekerjaan yang sedang berlangsung, dikirim hanya untuk permintaan yang membuat token kemajuan dalam sesi yang mendeklarasikan bahwa sesi tersebut dapat menerimanya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
token | ProgressToken | ya | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
value | ProgressBegin atau ProgressReport atau ProgressEnd | ya | Laporan itu sendiri. Satu laporan pembuka, lalu sejumlah baris berapa pun, lalu satu laporan penutup. |
Properti tambahan tidak diizinkan.
ProgressBegin
Membuka laporan, dengan menyatakan apa yang telah dimulai dalam istilah yang digunakan operasi itu sendiri.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | const “begin” | ya | Menandai payload ini sebagai pembuka laporan. Konstanta: "begin" |
title | string | ya | Apa yang telah dimulai. |
Properti tambahan tidak diizinkan.
ProgressReport
Satu baris dari uraian operasi tentang dirinya sendiri. Baris ini tidak membawa pecahan: operasi yang melapor di sini bekerja atas himpunan yang ukurannya tidak diketahui saat pekerjaan dimulai, sehingga pecahan harus dikarang.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | const “report” | ya | Menandai payload ini sebagai satu baris dari laporan yang terbuka. Konstanta: "report" |
message | string | ya | Satu baris keluaran operasi itu sendiri, dengan spasi di sekelilingnya dihapus. |
Properti tambahan tidak diizinkan.
ProgressEnd
Menutup laporan. Payload ini tidak membawa apa pun selain jenisnya, karena hasilnya dikirim pada respons yang sudah ditunggu pemanggil.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | const “end” | ya | Menandai payload ini sebagai penutup laporan. Konstanta: "end" |
Properti tambahan tidak diizinkan.
PublishDiagnosticsParams
Temuan untuk satu file, dikirim oleh daemon ketika validasi menghasilkannya untuk dokumen selain dokumen yang disebut permintaan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
file | string | ya | File yang menjadi pokok temuan. |
diagnostics | Diagnostic[] atau null | ya | Temuan, sesuai urutan dihasilkannya. |
Properti tambahan tidak diizinkan.
SuccessResponse
Jawaban atas permintaan yang berhasil, membawa pengenal permintaan yang dijawabnya. Respons tidak membawa metode, sehingga bentuk hasil yang berlaku ditentukan oleh permintaan pemilik pengenal tersebut, bukan oleh apa pun di dalam respons itu sendiri.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
jsonrpc | ProtocolVersion | ya | Versi JSON-RPC yang dibawa setiap pesan. Hanya 2.0 yang digunakan. |
id | RequestId | ya | Pengenal yang diberikan pemanggil untuk sebuah permintaan, dipantulkan kembali pada respons yang menjawabnya. Pesan yang tidak membawa pengenal adalah notifikasi dan tidak pernah dijawab. |
result | InitializeResult atau ValidateResult atau InvalidateResult atau DiagnosticsResult atau IrGraphResult atau BuildResult atau BuildPreviewResult atau EntityDefinitionResult atau ReleaseClosureResult atau ResolveDependenciesResult atau PinResult atau CacheStatusResult atau CachePruneResult atau CacheEvictResult atau CacheClearResult atau RegistryListResult atau SearchResult atau RegistryAddResult atau RegistryRemoveResult atau RegistryUpdateResult atau LogoutResult atau PublishEntityResult atau PublishArtifactResult atau SignArtifactsResult atau DeprecateArtifactResult atau ResolveResult atau FindReferencesResult atau FindImplementationsResult atau HoverResult atau CompletionResult atau CatalogIndexResult atau AttachCandidatesResult atau ConnectionCandidatesResult atau InsertionPointResult atau AttachmentContainerResult atau ConnectionAtPositionResult atau ReleaseCandidatesResult atau ActiveReleaseResult atau EditDocumentResult atau EffectiveConfigurationResult atau ConfigInitResult atau ConfigCaptureResult atau ImportResult atau ScaffoldEntityResult atau LintResult atau PluginAddResult atau PluginRemoveResult atau PluginSyncResult atau PluginGenCatalogResult atau ExplainErrorResult atau GetSchemaResult atau SkillsInstallResult atau SkillsListResult | ya | Jawaban, dalam bentuk yang dikembalikan oleh metode yang diminta. |
Properti tambahan tidak diizinkan.
ErrorResponse
Jawaban atas permintaan yang ditolak atau gagal, yang membawa pengenal permintaan yang dijawabnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
jsonrpc | ProtocolVersion | ya | Versi JSON-RPC yang dibawa setiap pesan. Hanya 2.0 yang digunakan. |
id | RequestId | ya | Pengenal yang diberikan pemanggil untuk sebuah permintaan, dipantulkan kembali pada respons yang menjawabnya. Pesan yang tidak membawa pengenal adalah notifikasi dan tidak pernah dijawab. |
error | ErrorObject | ya | Apa yang salah: kode yang dapat dijadikan dasar percabangan oleh klien, pesan yang ditulis untuk dibaca manusia, dan — jika kondisinya memilikinya — artefak serta posisi sumber yang dirujuk pesan tersebut. |
Properti tambahan tidak diizinkan.
ErrorObject
Apa yang salah: kode yang dapat dijadikan dasar percabangan oleh klien, pesan yang ditulis untuk dibaca manusia, dan — jika kondisinya memilikinya — artefak serta posisi sumber yang dirujuk pesan tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
code | ErrorCode | ya | Kondisi yang dilaporkan jawaban. Kode negatif adalah himpunan cadangan milik protokol itu sendiri; kode empat digit adalah kondisi yang dimunculkan daemon ini, masing-masing menamai keadaan yang dapat ditindaklanjuti klien. Himpunan ini tertutup. |
message | string | ya | Apa yang salah, dalam bentuk prosa. Rumusannya sama dengan yang dibawa kondisi yang sama di setiap permukaan lain yang melaporkannya. |
data | ErrorData | tidak | Artefak dan posisi sumber yang dirujuk pesan, dibawa secara terstruktur sehingga klien tidak perlu membacanya kembali dari prosa. Setiap bidang bersifat opsional dan suatu kondisi hanya mengisi apa yang dimilikinya; tidak ada bidang yang menggantikan bidang lain, sehingga klien mengetahui apa yang diterimanya dari bidang yang dibacanya, bukan dari kode di sampingnya. |
Properti tambahan tidak diizinkan.
ErrorCode
Kondisi yang dilaporkan jawaban. Kode negatif adalah himpunan cadangan milik protokol itu sendiri; kode empat digit adalah kondisi yang dimunculkan daemon ini, masing-masing menamai keadaan yang dapat ditindaklanjuti klien. Himpunan ini tertutup.
Jenis: const -32700 or const -32600 or const -32601 or const -32602 or const -32603 or const 1001 or const 1003 or const 1004 or const 1005 or const 1006
Nilai yang diizinkan:
-32700— Pesan tidak dapat di-parse sebagai JSON.-32600— Pesan berhasil di-parse tetapi bukan permintaan yang berbentuk benar.-32601— Tidak ada metode dengan nama tersebut.-32602— params yang dibawa permintaan tidak dapat diterima: field yang tidak diterima metode, field dengan tipe yang salah, atau nilai yang ditolak metode.-32603— Daemon gagal saat mengerjakan pekerjaan.1001— Daemon tidak menyimpan hasil pembacaan berkas tersebut dan tidak sedang menghasilkannya. Klien memicunya dengan meminta validasi, lalu mencoba lagi.1003— Lockfile untuk Release yang disebutkan permintaan tidak ada, dan operasi memerlukannya.1004— Entitas yang disebutkan permintaan tidak dapat di-resolve dari katalog maupun dari Release yang disebutkan permintaan.1005— Daemon sedang dimatikan dan menolak pekerjaan baru. Klien tidak mencoba lagi terhadap daemon yang sama.1006— Validasi berkas sedang berjalan dan tidak selesai dalam batas waktu yang diizinkan oleh permintaan yang menunggu. Klien menunggu dan meminta lagi, tanpa mengirim apa pun selama itu.
ErrorData
Artefak dan posisi sumber yang dirujuk pesan, dibawa secara terstruktur sehingga klien tidak perlu membacanya kembali dari prosa. Setiap bidang bersifat opsional dan suatu kondisi hanya mengisi apa yang dimilikinya; tidak ada bidang yang menggantikan bidang lain, sehingga klien mengetahui apa yang diterimanya dari bidang yang dibacanya, bukan dari kode di sampingnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
file | string | tidak | Dokumen sumber yang ditunjuk oleh bidang posisi — dokumen yang sedang diperiksa, atau Release yang gagal dimuat. |
line | integer | tidak | Baris yang dirujuk kondisi, dihitung mulai dari satu. |
column | integer | tidak | Kolom yang dirujuk kondisi, dihitung mulai dari satu. |
end_line | integer | tidak | Baris satu setelah akhir token yang dirujuk kondisi. Tidak ada jika akhir token tidak dapat dipulihkan; dalam hal itu klien menampilkan posisi sebagai satu titik. |
end_column | integer | tidak | Kolom satu setelah akhir token yang dirujuk kondisi. |
release | string | tidak | Release yang dirujuk kondisi, ditulis sebagaimana permintaan menamainya, sehingga klien dapat menyusun perbaikannya tanpa merakitnya ulang. |
lockfile | string | tidak | Lockfile yang menjadi pokok kondisi berlingkup lockfile: path yang dicari dan tidak ditemukan, atau tidak dapat dibaca. |
unreachable | boolean | tidak | Apakah penolakan berupa registry yang dinamai permintaan tetapi tidak dapat dijangkau: namanya tidak dapat di-resolve, koneksi ke sana ditolak atau tidak dapat dibuka, atau koneksi aman ke sana tidak dapat dibangun. Nilainya dibaca dari kegagalan itu sendiri, bukan dari pesan, dan hanya diisi jika kegagalan menunjukkan registry tidak pernah dijangkau. Penyegaran indeks yang ditolak yang menamai satu registry membawanya; registry yang menjawab, apa pun jawabannya, membiarkannya tidak ada. |
code | string | tidak | Nama deskriptif kondisi yang dinamai penolakan, stabil di seluruh rilis: nilai yang sama dengan yang dibawa diagnostik yang melaporkan kondisi tersebut dalam kodenya sendiri. Inilah yang dijadikan dasar percabangan oleh klien, bukan pesan atau kode numerik di sampingnya, yang menamai keadaan permintaan dan tetap sama untuk setiap kondisi. Ada tepat ketika penolakan menamai kondisi terdaftar, dan tidak ada ketika tidak menamai kondisi apa pun. |
shortCode | string | tidak | Kode pendek kondisi, huruf E dan empat digit: bentuk yang dikutip dan dicari pembaca, dan yang membuka pesan penolakan yang menamai suatu kondisi. Ada tepat ketika code ada. |
Properti tambahan tidak diizinkan.
Diagnostic
Satu temuan tentang satu dokumen: di mana letaknya, seberapa serius, apa isinya, dan kode yang dapat dikutip yang menamai kondisi yang dilaporkannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
line | integer | ya | Baris yang menjadi pokok temuan, dihitung mulai dari satu. |
column | integer | ya | Kolom yang menjadi pokok temuan, dihitung mulai dari satu. |
severity | const “error” atau const “warning” atau const “info” | ya | Seberapa serius temuan tersebut. Nilai yang diizinkan: "error" — Temuan merupakan kesalahan. Temuan plugin dengan tingkat keparahan halt dilaporkan pada tingkat ini. "warning" — Temuan dilaporkan dan bukan kesalahan. Temuan plugin dengan tingkat keparahan warn dilaporkan pada tingkat ini. "info" — Temuan bersifat informasi, sebagaimana temuan plugin dengan tingkat keparahan info. |
message | string | ya | Isi temuan, dalam bentuk prosa. |
code | string | tidak | Nama deskriptif kondisi, stabil di seluruh rilis dan dapat dikutip dalam supresi. |
shortCode | string | tidak | Kode pendek kondisi, bentuk yang membuka diagnostik yang menghentikan proses. |
codeDescription | CodeDescription | tidak | Tempat kondisi yang dinamai temuan dijelaskan. |
classification | string | tidak | Bagaimana temuan dicapai, jika kondisinya membedakan hal itu. |
suggest | string | tidak | Ejaan yang diusulkan temuan, jika kondisinya dapat menamainya — misalnya pengenal yang hampir cocok. |
keyPath | string | tidak | Path di dalam dokumen menuju kunci yang menjadi pokok temuan. |
source | string | ya | Apa yang menghasilkan temuan. |
end_line | integer | tidak | Baris satu setelah akhir token yang menjadi pokok temuan, sehingga klien dapat menampilkan seluruh token, bukan satu karakter saja. Tidak ada untuk token yang membentang beberapa baris. |
end_column | integer | tidak | Kolom satu setelah akhir token yang menjadi pokok temuan. |
Properti tambahan tidak diizinkan.
CodeDescription
Tempat kondisi yang dinamai temuan dijelaskan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
href | string | ya | Alamat terpublikasi tempat kondisi dijelaskan. |
Properti tambahan tidak diizinkan.
Position
Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
line | integer | ya | Baris, dihitung mulai dari nol. |
character | integer | ya | Offset di dalam baris, dihitung mulai dari nol, dalam satuan encoding yang disepakati sesi. |
Properti tambahan tidak diizinkan.
Range
Rentang di antara dua tempat dalam dokumen.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
start | Position | ya | Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain. |
end | Position | ya | Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain. |
Properti tambahan tidak diizinkan.
Location
Rentang dalam dokumen bernama.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
uri | string | ya | Dokumen tempat rentang berada, dialamatkan sebagai URI. |
range | Range | ya | Rentang di antara dua tempat dalam dokumen. |
Properti tambahan tidak diizinkan.
WorkspaceAndProgressParams
Objek params dari metode yang tidak mendeklarasikan bidang sendiri. Objek ini tetap menerima dua bidang yang diterima setiap permintaan: workspace yang menjadi sasarannya, dan token progres.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
Properti tambahan tidak diizinkan.
InitializeParams
Membuka sesi atas sebuah workspace dan menyatakan apa yang dapat ditangani klien. Ini adalah satu-satunya metode di mana workspaceRoot merupakan deklarasi, bukan subjek: tidak ada, kosong, dan sebuah path adalah tiga hal yang berbeda, dan sesi yang dibuka tanpa path adalah sesi yang belum diarahkan klien ke sebuah workspace.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
capabilities | ClientCapabilities | tidak | Apa yang dapat ditangani klien. Yang tidak dinyatakan dianggap tidak didukung. Anggota yang tidak dikenal diabaikan alih-alih ditolak, sehingga klien dapat menyatakan kapabilitas yang belum dibaca oleh daemon ini. |
workspaceRoot | string | tidak | Path absolut workspace yang akan dibuka. Jika tidak ada, sesi dibiarkan tanpa workspace; string kosong adalah path yang diberikan klien dan tidak sama dengan tidak mengirimkan apa pun. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
Properti tambahan tidak diizinkan.
ClientCapabilities
Apa yang dapat ditangani klien. Yang tidak dinyatakan dianggap tidak didukung. Anggota yang tidak dikenal diabaikan alih-alih ditolak, sehingga klien dapat menyatakan kapabilitas yang belum dibaca oleh daemon ini.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
general | object | tidak | Kapabilitas yang tidak terikat pada satu jenis jawaban. |
window | object | tidak | Kapabilitas mengenai apa yang dapat ditampilkan klien selama pekerjaan berlangsung. |
Properti tambahan diizinkan.
ClientCapabilities.general
Kapabilitas yang tidak terikat pada satu jenis jawaban.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
positionEncodings | string[] | tidak | Encoding posisi yang dapat dibaca klien, diurutkan dari yang terbaik. |
Properti tambahan diizinkan.
ClientCapabilities.window
Kapabilitas mengenai apa yang dapat ditampilkan klien selama pekerjaan berlangsung.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workDoneProgress | boolean | tidak | Apakah klien dapat menerima notifikasi progres. Permintaan yang membuat token progres dalam sesi yang tidak mendeklarasikan ini akan ditolak. |
Properti tambahan diizinkan.
ValidateParams
Memeriksa workspace, atau satu dokumen di dalamnya, dan menjawab dengan temuan-temuannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
file | string | tidak | Dokumen yang akan diperiksa. Jika tidak ada, yang diperiksa adalah isi workspace. |
content | string | tidak | Teks dokumen sebagaimana saat ini dipegang klien, untuk memeriksa buffer yang belum disimpan. Jika tidak ada, byte di disk yang dibaca. |
release | string | tidak | Release yang menjadi acuan pemeriksaan, sebagai path relatif terhadap root workspace. |
Properti tambahan tidak diizinkan.
InvalidateParams
Memberi tahu daemon bahwa dokumen yang hasil pembacaannya ia pegang telah berubah, sehingga jawaban berikutnya tentang dokumen itu dihitung dari byte yang baru.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
file | string | tidak | Dokumen yang berubah. |
granularity | string | tidak | Seberapa banyak dari yang disimpan daemon yang dibuang: file hanya membuang yang disimpannya untuk dokumen yang disebutkan; workspace, nilai default dan cara nilai lain apa pun dibaca, juga membuang yang disimpannya untuk seluruh workspace. |
Properti tambahan tidak diizinkan.
DiagnosticsParams
Menjawab dengan temuan yang sudah dipegang daemon untuk sebuah dokumen, tanpa memeriksanya lagi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
file | string | tidak | Dokumen yang akan dilaporkan. Daemon harus sudah memegang hasil pembacaannya. |
Properti tambahan tidak diizinkan.
IrGraphParams
Menjawab dengan graf terselesaikan yang menjadi hasil kompilasi sebuah Release, tanpa merendernya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
release | string | tidak | Release yang akan diselesaikan, sebagai path relatif terhadap root workspace. Path absolut ditolak. |
unredacted | boolean | tidak | Apakah akan menjawab dengan nilai-nilai yang dideklarasikan sensitif oleh penulis dalam bentuk terbuka. Jika tidak ada atau false, setiap nilai tersebut ditahan dari graf dan sebuah penanda yang menyebutkan alasannya menggantikan tempatnya, sebagaimana keluaran graf baris perintah menahannya; true menjawab dengan graf sebagaimana Release dikompilasi menjadi graf itu, termasuk nilai-nilai tersebut. |
Properti tambahan tidak diizinkan.
BuildParams
Mengompilasi sebuah Release dan menulis artefak hasil render ke dalam workspace.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
release | string | tidak | Release yang akan di-build, sebagai path relatif terhadap root workspace. Path absolut ditolak. |
outputParent | string | tidak | Direktori tempat direktori keluaran dibuat, sebagai path relatif terhadap root workspace. Artefak ditempatkan di direktori keluaran di bawahnya, dengan tata letak yang sama seperti di bawah root workspace ketika tidak ada yang disebutkan — jadi ini menyebutkan induk direktori keluaran dan tidak pernah direktori keluaran itu sendiri. Jika tidak ada, atau kosong, direktori keluaran ditulis di bawah root workspace, sebagaimana dilakukan aggrega build dari mana pun ia dijalankan. Path absolut, atau path yang keluar dari workspace, ditolak. |
autoPull | boolean | tidak | Apakah dependensi Release diselesaikan terlebih dahulu. Jika diminta, registry yang dikonfigurasi akan dihubungi dan lockfile ditulis; jika tidak diminta, build tidak menghubungi registry apa pun. |
policyInput | string | tidak | Direktori untuk menulis, di samping artefak, payload yang diserahkan setiap peran tata kelola kepada plugin yang dilampirkan di sana, sebagai path relatif terhadap root workspace — berkas yang ditulis oleh aggrega build --policy-input, dengan nama yang sama, yang ditulis baik build selesai maupun berhenti. Pemberitahuan dalam jawaban menyebutkan berapa banyak berkas yang ditulis dan menyebutkan setiap peran yang tidak ditulisi berkas. Pada permintaan yang gagal, berkas yang sudah ditulis tetap ada di disk dan rincian tersebut tidak ada dalam balasan: error hanya membawa penolakan. Jika tidak ada, tidak ada yang ditulis. Path absolut, atau path yang keluar dari workspace, ditolak. |
Properti tambahan tidak diizinkan.
BuildPreviewParams
Mengompilasi sebuah Release dan melaporkan apa yang akan dihasilkan oleh penulisan artefak, tanpa menulis satu pun di antaranya. Permintaan ini menolak bidang resolusi dependensi yang diterima oleh build yang menulis, karena permintaan yang tidak menulis apa pun tidak dapat mengisi lockfile.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
release | string | tidak | Release yang akan dikompilasi, sebagai path relatif terhadap root workspace. |
autoPull | boolean | tidak | Diterima pada wire dan ditolak oleh metode: permintaan ini tidak menulis apa pun, sehingga tidak dapat mengisi lockfile dan tetap sesuai dengan apa yang dinyatakannya. |
policyInput | string | tidak | Direktori untuk menulis payload yang diserahkan setiap peran tata kelola kepada plugin yang dilampirkan di sana, sebagai path relatif terhadap root workspace — berkas yang ditulis oleh aggrega build --dry-run --policy-input, dengan nama yang sama. Jika dikirim, berkas-berkas itulah satu-satunya yang ditulis permintaan ini; direktori output dan lockfile tidak disentuh. Pemberitahuan dalam jawaban menyebutkan berapa banyak berkas yang ditulis dan menyebutkan setiap peran yang tidak ditulisi berkas. Pada permintaan yang gagal, berkas yang sudah ditulis tetap ada di disk dan rincian tersebut tidak ada dalam balasan: error hanya membawa penolakan. Path absolut, atau path yang keluar dari workspace, ditolak. |
Properti tambahan tidak diizinkan.
EntityDefinitionParams
Menjawab dengan hasil resolusi sebuah nama entitas dan lokasi dokumen yang mendefinisikannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
name | string | tidak | Entitas yang akan diresolusi, berdasarkan nama — atau referensi registry, oci://<host>/<repository>:<tag> atau @<digest> sebagai pengganti :<tag>, untuk membaca entitas yang dipublikasikan pada koordinat tersebut. |
release | string | tidak | Release yang menjadi acuan resolusi nama, sebagai path relatif terhadap root workspace. Nama kemudian diresolusi melalui direktori katalog yang diberikan konfigurasi workspace kepada Release tersebut, sehingga nama yang dideklarasikan oleh beberapa varian dalam satu workspace, satu per Release, diresolusi ke varian yang digunakan Release tersebut untuk build, dan nama yang tidak dapat diresolusinya ditolak dengan keterangan yang menyebutkan entri Release tersebut di bawah workspace.releases. Jika tidak ada, nama diresolusi melalui direktori katalog milik workspace sendiri. Referensi registry tidak menerima Release dan ditolak jika disertai satu, demikian pula nilai yang tidak menunjuk berkas Release. |
Properti tambahan tidak diizinkan.
CatalogIndexParams
Menjawab dengan entitas yang dimiliki workspace: setiap entitas yang dideklarasikan dokumennya, dan Features yang dideklarasikan direktori katalognya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
release | string | tidak | Release yang menjadi acuan daftar entitas, sebagai path relatif terhadap root workspace. Features kemudian adalah yang dideklarasikan oleh direktori katalog yang diberikan konfigurasi workspace kepada Release tersebut, dan dokumen di bawah direktori katalog yang hanya dibaca oleh Releases lain tidak disertakan, sehingga workspace yang menyimpan varian-varian satu entitas berdampingan, satu per Release, didaftar dengan varian yang digunakan Release tersebut untuk build. Jika tidak ada, daftarnya adalah milik workspace sendiri. Nilai yang tidak menunjuk berkas Release ditolak. |
Properti tambahan tidak diizinkan.
ReleaseClosureParams
Menjawab dengan semua hal yang menjadi dependensi sebuah Release, sebagaimana dicapai oleh resolusi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
release | string | tidak | Release yang akan diperiksa, sebagai path relatif terhadap root workspace. |
Properti tambahan tidak diizinkan.
ResolveDependenciesParams
Meresolusi dependensi sebuah Release, menyematkannya dalam lockfile dan memperoleh input eksternal yang dikonsumsi oleh render-nya. Permintaan ini menghubungi registry yang dikonfigurasi dan melakukan penulisan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
release | string | tidak | Release yang akan diresolusi, sebagai path relatif terhadap root workspace. |
upgrade | boolean | tidak | Apakah akan meresolusi ulang dalam rentang yang dideklarasikan alih-alih mengikuti apa yang sudah disematkan lockfile. |
targets | string[] | tidak | Referensi yang akan diresolusi ulang, sementara sisanya tetap tersemat apa adanya. Kosong berarti meresolusi semuanya. |
verify | boolean | tidak | Apakah akan membandingkan lockfile yang tercatat dengan resolusi yang akan dilakukan permintaan ini tanpanya, dengan mengikuti sematan yang akan diikuti permintaan tersebut, alih-alih menulisnya. Verifikasi tidak menulis lockfile, catatan kepercayaan plugin, maupun entity.lock; cache konten dibaca dan diisi sebagaimana resolusi tersebut akan membaca dan mengisinya. Penyimpangan, dan lockfile yang tidak ada, menggagalkan permintaan. Ini tidak dapat digabungkan dengan upgrade, targets atau pinSources, apa pun nilai yang dibawa pinSources: permintaan yang mengirim salah satunya bersama ini ditolak sebagai parameter tidak valid sebelum apa pun diresolusi. |
pinSources | boolean | tidak | Apakah akan menjalankan langkah penyematan yang dijalankan aggrega/pin atas Recipes dan FeatureRecipes yang di-build oleh Release dari direktori katalog workspace, dengan menulis entity.lock di samping masing-masing, alih-alih menolak permintaan karena ada yang lock-nya tidak mencatat sematan yang dibutuhkan suatu input. Jika tidak ada, mengikuti pin_sources_at_pull milik workspace; nilai apa pun menimpa pengaturan tersebut untuk permintaan ini. |
Properti tambahan tidak diizinkan.
PinParams
Mencatat, di dalam entity.lock di samping sebuah Recipe atau FeatureRecipe, pin konten untuk setiap input yang dibaca entitas dari luar dokumennya sendiri. Tidak ada Release yang disebutkan: input yang identitasnya ditulis lengkap oleh entitas menunjuk satu artefak untuk setiap Release yang menggunakan entitas tersebut, sehingga tidak ada yang perlu disediakan oleh sebuah Release untuk mem-pin-nya. Permintaan ini menjangkau host yang disebutkan oleh sumber entitas dan menulis di samping entitas; dokumen entitas itu sendiri tidak pernah ditulis.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
entity | string | tidak | Dokumen entitas yang akan di-pin, sebagai path relatif terhadap root workspace. |
dryRun | boolean | tidak | Apakah menjawab dengan lock yang akan ditulis oleh langkah ini alih-alih menulisnya. Input tetap di-resolve, sehingga cache konten tetap terisi. |
Properti tambahan tidak diizinkan.
CacheEvictParams
Mengambil kembali ruang konten yang di-cache hingga sisanya muat di bawah ukuran yang disebutkan permintaan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
maxSize | string | tidak | Ukuran target pengambilan kembali, ditulis sebagaimana orang menuliskannya — misalnya 500MB. |
Properti tambahan tidak diizinkan.
SearchParams
Mencari apa yang ditawarkan oleh indeks lokal registry yang dikonfigurasi. Permintaan ini membaca indeks yang sudah ada di disk dan tidak menghubungi registry mana pun.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
query | string | tidak | Teks yang dicocokkan dengan nama dan deskripsi sebuah rekaman. |
kinds | string[] | tidak | Jenis entitas yang dipertahankan. Kosong berarti mempertahankan semua jenis. |
selector | string | tidak | Selector label yang harus dipenuhi oleh rekaman yang dipertahankan. |
capabilities | string[] | tidak | Kapabilitas yang harus dideklarasikan oleh rekaman plugin yang dipertahankan. |
pluginType | string | tidak | Jenis plugin yang dipertahankan. |
registry | string | tidak | Satu host registry yang akan dicari. Jika tidak ada, semua host yang dikonfigurasi akan dicari. |
limit | integer | tidak | Jumlah maksimum rekaman dalam jawaban. |
includeRetracted | boolean | tidak | Apakah mempertahankan versi yang telah dinyatakan usang oleh penanda yang dipublikasikan. |
Properti tambahan tidak diizinkan.
RegistryAddParams
Mendaftarkan sebuah registry beserta kebijakan kepercayaan yang diterapkan resolusi terhadap apa yang disajikannya. Permintaan ini menulis file konfigurasi tingkat mesin kecuali permintaan meminta lain, sehingga setiap workspace di mesin tersebut melakukan resolusi melalui entri itu.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
host | string | tidak | Host registry yang akan didaftarkan. |
name | string | tidak | Alias ramah yang mengarah ke host tersebut. |
identities | string[] | tidak | Identitas penandatanganan yang dipercaya untuk apa yang disajikan registry ini. |
keyPath | string | tidak | Path kunci publik yang akan dipercaya, untuk registry yang ditandatangani dengan kunci alih-alih dengan identitas tanpa kunci. |
trustedRoot | string | tidak | Path trust anchor untuk memverifikasi tanda tangan. |
requireSignatures | boolean | tidak | Apakah artefak dari registry ini harus membawa tanda tangan yang terverifikasi. Jika tidak ada, tidak ada yang dinyatakan dan default hasil resolusi tetap berlaku. |
advisory | boolean | tidak | Apakah verifikasi yang gagal dilaporkan alih-alih menghentikan proses. |
fetchTrust | boolean | tidak | Apakah membaca kebijakan kepercayaan yang diiklankan registry dan mem-pin-nya. Jika tidak ada, tidak ada yang dinyatakan dan default hasil resolusi tetap berlaku. |
global | boolean | tidak | Menulis file konfigurasi tingkat mesin, yang merupakan default metode ini. |
workspace | boolean | tidak | Menulis file konfigurasi milik workspace ini alih-alih file tingkat mesin. |
Properti tambahan tidak diizinkan.
RegistryRemoveParams
Menghapus registry yang terdaftar. Permintaan ini menulis file konfigurasi tingkat mesin kecuali permintaan meminta lain.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
registry | string | tidak | Registry yang akan dihapus, berdasarkan host atau alias. |
global | boolean | tidak | Menulis file konfigurasi tingkat mesin, yang merupakan default metode ini. |
workspace | boolean | tidak | Menulis file konfigurasi milik workspace ini alih-alih file tingkat mesin. |
Properti tambahan tidak diizinkan.
RegistryUpdateParams
Menyegarkan indeks lokal yang dibaca oleh pencarian, dengan menjangkau registry untuk melakukannya. Yang ditulisnya adalah indeks di bawah direktori cache yang dikonfigurasi milik workspace ini. Registry yang memerlukan kredensial yang tidak dibawa oleh sumber ambien mana pun ditolak dengan menyebutkan kredensial tersebut, alih-alih meminta kredensial itu.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
registry | string | tidak | Satu registry yang akan disegarkan. Jika tidak ada, semua host yang dikonfigurasi akan disegarkan. |
upgrade | boolean | tidak | Apakah membangun ulang indeks alih-alih menambahkan ke isi yang sudah ada. |
Properti tambahan tidak diizinkan.
LogoutParams
Menghapus kredensial registri yang tersimpan. Penyimpanan tersebut digunakan bersama oleh setiap proyek di mesin, dan jawabannya menyatakan hal itu.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
registry | string | tidak | Registri yang kredensial tersimpannya akan dihapus. |
Properti tambahan tidak diizinkan.
PublishEntityParams
Menerbitkan entitas ke registri. Apa yang diterbitkannya adalah apa yang di-resolve oleh setiap konsumen registri tersebut, dan versi yang telah diterbitkan tidak dapat ditarik kembali dari siapa pun yang sudah mengambilnya. Tidak ada yang diminta secara interaktif: identitas di-resolve dari apa yang diberikan permintaan atau apa yang sudah tersedia di lingkungan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
entity | string | tidak | Dokumen entitas yang akan diterbitkan, sebagai path relatif terhadap root workspace. |
registry | string | tidak | Registri tujuan penerbitan. Jika tidak ada, default yang dikonfigurasi digunakan. |
dryRun | boolean | tidak | Apakah akan melaporkan apa yang akan diterbitkan tanpa benar-benar menerbitkannya. |
sign | boolean | tidak | Apakah akan menandatangani apa yang diterbitkan. Jika tidak ada, tidak ada yang dinyatakan dan default yang telah di-resolve tetap berlaku. |
plugin | string | tidak | Modul plugin yang diterbitkan bersama entitas Plugin. |
fulcioUrl | string | tidak | Otoritas sertifikat tempat memperoleh sertifikat penandatanganan. |
rekorUrl | string | tidak | Log transparansi tempat mencatat tanda tangan. |
timestampUrl | string | tidak | Otoritas stempel waktu yang digunakan untuk menandatangani bersama (countersign). |
identityToken | string | tidak | Token identitas untuk menandatangani, diberikan oleh pemanggil alih-alih diperoleh di terminal. |
pinSources | boolean | tidak | Apakah akan menjalankan langkah pin yang dijalankan aggrega/pin pada entitas sebelum entitas dibundel, sehingga entity.lock yang ditulis langkah itu di sampingnya menjadi bagian dari apa yang diterbitkan. Langkah ini berjalan sebelum setiap penolakan yang menilai entitas, dan di bawah dryRun langkah ini melaporkan lock yang akan ditulisnya dan tidak menulis apa pun. Jika tidak ada, mengikuti pin_sources_at_push milik workspace; nilai mana pun menggantikan pengaturan tersebut untuk permintaan ini. |
Properti tambahan tidak diizinkan.
PublishArtifactParams
Menerbitkan file sembarang ke registri dengan nama dan tag yang diberikan permintaan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
file | string | tidak | File yang akan diterbitkan, sebagai path relatif terhadap root workspace. |
name | string | tidak | Nama repositori tempat penerbitan. |
tag | string | tidak | Tag tempat penerbitan. |
mediaType | string | tidak | Jenis media yang dicatat untuk byte yang diterbitkan. |
registry | string | tidak | Registri tujuan penerbitan. Jika tidak ada, default yang dikonfigurasi digunakan. |
dryRun | boolean | tidak | Apakah akan melaporkan apa yang akan diterbitkan tanpa benar-benar menerbitkannya. |
Properti tambahan tidak diizinkan.
SignArtifactsParams
Menandatangani apa yang sudah diterbitkan. Tanda tangan tidak dapat ditarik kembali dari siapa pun yang sudah mengambilnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
references | string[] | tidak | Referensi terbitan yang akan ditandatangani. |
fulcioUrl | string | tidak | Otoritas sertifikat tempat memperoleh sertifikat penandatanganan. |
rekorUrl | string | tidak | Log transparansi tempat mencatat tanda tangan. |
timestampUrl | string | tidak | Otoritas stempel waktu yang digunakan untuk menandatangani bersama (countersign). |
identityToken | string | tidak | Token identitas untuk menandatangani, diberikan oleh pemanggil alih-alih diperoleh di terminal. |
jobs | integer | tidak | Berapa banyak referensi yang ditandatangani sekaligus. Jika tidak ada, ditandatangani satu per satu. Setiap referensi tetap ditandatangani persis seperti jika ditandatangani sendiri — jika keyless, dengan sertifikatnya sendiri dan entri log transparansinya sendiri — dan jawaban mempertahankan urutan referensi diberikan. Minimum: 1. |
Properti tambahan tidak diizinkan.
DeprecateArtifactParams
Menandai versi yang telah diterbitkan sebagai usang, sehingga resolusi dapat melaporkan atau menolaknya. Penanda itu sendiri diterbitkan dan ditandatangani. Sebuah permintaan mengirimkan satu referensi beserta isinya, atau sebuah file batch yang entri-entrinya membawa isinya sendiri — tidak pernah keduanya, dan tidak pernah isi di samping file batch.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
reference | string | tidak | Referensi terbitan yang akan ditandai. Alternatif untuk from: permintaan yang membawa keduanya ditolak. |
severity | const “warning” atau const “error” atau const “retracted” | tidak | Seberapa kuat penanda berbicara — apakah resolusi melaporkan versi tersebut atau menolaknya. Wajib bersama reference; ditolak di samping from, yang file batch-nya memuat nilai tersendiri untuk setiap penanda. Nilai yang diizinkan: "warning" — Di-deprecate, pada tingkat yang lebih ringan dari dua tingkat anjuran: tetap dipilih ketika versi dipilih. "error" — Di-deprecate, pada tingkat yang lebih kuat dari dua tingkat anjuran: tetap dipilih ketika versi dipilih. "retracted" — Ditarik: dikecualikan ketika versi dipilih. |
reason | string | tidak | Alasan versi tersebut usang. Wajib bersama reference; ditolak di samping from, yang file batch-nya memuat nilai tersendiri untuk setiap penanda. |
replacement | string | tidak | Referensi yang digunakan sebagai gantinya. Ditolak di samping from, yang file batch-nya memuat nilai tersendiri untuk setiap penanda. |
message | string | tidak | Apa yang disampaikan kepada konsumen yang menjumpai penanda. Ditolak di samping from, yang file batch-nya memuat nilai tersendiri untuk setiap penanda. |
from | string | tidak | File batch berisi entri penarikan, sebagai path relatif terhadap root workspace, yang memasang satu penanda per entri. Setiap entri membawa referensi, tingkat keparahan, dan alasannya sendiri, serta secara opsional pengganti dan pesan. Alternatif untuk reference: permintaan yang membawa keduanya, atau yang membawa tingkat keparahan, alasan, pengganti, atau pesan di sampingnya, ditolak. |
fulcioUrl | string | tidak | Otoritas sertifikat tempat memperoleh sertifikat penandatanganan. |
rekorUrl | string | tidak | Log transparansi tempat mencatat tanda tangan. |
timestampUrl | string | tidak | Otoritas stempel waktu yang digunakan untuk menandatangani bersama (countersign). |
identityToken | string | tidak | Token identitas untuk menandatangani, diberikan oleh pemanggil alih-alih diperoleh di terminal. |
Properti tambahan tidak diizinkan.
ResolveParams
Menjawab di mana hal yang berada di bawah kursor didefinisikan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
uri | string | tidak | Dokumen tempat kursor berada. |
position | Position | tidak | Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain. |
release | string | tidak | Release yang menjadi acuan jawaban, sebagai path relatif terhadap root workspace. Definisinya kemudian adalah dokumen yang menjadi tujuan resolusi referensi melalui direktori katalog yang diberikan konfigurasi workspace kepada Release tersebut, sesuai urutannya, sehingga nama yang dideklarasikan oleh beberapa varian dalam satu workspace, satu per Release, mengarah ke varian milik Release tersebut; jika direktori tersebut tidak mendeklarasikan entitas semacam itu, dokumen-dokumen workspace yang dicari, tanpa menyertakan dokumen yang berada di bawah salah satu direktori katalog workspace yang tidak dibaca oleh Release tersebut. Jika tidak ada, dokumen-dokumen workspace dicari lebih dahulu, dan direktori katalog milik workspace sendiri hanya dicari jika tidak ada dokumen yang mendeklarasikan nama tersebut. Nilai yang tidak menyebut file Release apa pun ditolak. |
Properti tambahan tidak diizinkan.
FindReferencesParams
Menjawab di mana hal yang berada di bawah kursor dirujuk.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
uri | string | tidak | Dokumen tempat kursor berada. |
position | Position | tidak | Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain. |
release | string | tidak | Release yang menjadi acuan jawaban, sebagai path relatif terhadap root workspace. Referensi yang dibuat dalam dokumen di bawah salah satu direktori katalog workspace yang tidak dibaca oleh Release tersebut kemudian tidak dilaporkan, sehingga varian-varian yang disimpan berdampingan dalam satu workspace, satu per Release, tidak pernah dilaporkan sebagai referensi satu sama lain. Jika tidak ada, setiap dokumen workspace dicari. Nilai yang tidak menyebut file Release apa pun ditolak. |
Properti tambahan tidak diizinkan.
FindImplementationsParams
Menjawab dokumen mana yang mengimplementasikan hal yang berada di bawah kursor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
uri | string | tidak | Dokumen tempat kursor berada. |
position | Position | tidak | Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain. |
release | string | tidak | Release yang menjadi acuan jawaban, sebagai path relatif terhadap root workspace. Dokumen di bawah salah satu direktori katalog workspace yang tidak dibaca oleh Release tersebut kemudian tidak dilaporkan, sehingga varian yang digunakan Release lain untuk build tidak pernah dicantumkan di antara varian milik Release ini. Jika tidak ada, setiap dokumen workspace dicari. Nilai yang tidak menyebut file Release apa pun ditolak. |
Properti tambahan tidak diizinkan.
HoverParams
Menjawab dengan apa yang perlu ditampilkan tentang hal yang berada di bawah kursor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
uri | string | tidak | Dokumen tempat kursor berada. |
position | Position | tidak | Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain. |
release | string | tidak | Release yang menjadi acuan jawaban, sebagai path relatif terhadap root workspace. Entitas yang ditampilkan kemudian adalah entitas yang menjadi tujuan resolusi referensi melalui direktori katalog yang diberikan konfigurasi workspace kepada Release tersebut, sesuai urutannya; jika direktori tersebut tidak mendeklarasikan entitas semacam itu, dokumen-dokumen workspace yang dicari, tanpa menyertakan dokumen yang berada di bawah salah satu direktori katalog workspace yang tidak dibaca oleh Release tersebut. Jika tidak ada, dokumen-dokumen workspace dicari lebih dahulu, dan direktori katalog milik workspace sendiri hanya dicari jika tidak ada dokumen yang mendeklarasikan nama tersebut. Nilai yang tidak menyebut file Release apa pun ditolak. |
Properti tambahan tidak diizinkan.
CompletionParams
Menjawab dengan apa yang dapat ditulis pada posisi kursor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
uri | string | tidak | Dokumen tempat kursor berada. |
position | Position | tidak | Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain. |
context | CompletionContext | tidak | Apa yang memicu permintaan, jika klien melacaknya. |
release | string | tidak | Release yang menjadi acuan jawaban, sebagai path relatif terhadap root workspace. Nama-nama yang ditawarkan kemudian adalah nama yang dideklarasikan dokumen-dokumen workspace, dikurangi dokumen di bawah salah satu direktori katalog workspace yang tidak dibaca oleh Release tersebut, bersama dengan Components dan Features yang dideklarasikan oleh direktori katalog yang diberikan konfigurasi workspace kepada Release tersebut. Jika tidak ada, nama-nama tersebut adalah dokumen-dokumen workspace serta Components dan Features yang dideklarasikan oleh direktori katalog milik workspace sendiri. Nilai yang tidak menyebut file Release apa pun ditolak. |
Properti tambahan tidak diizinkan.
CompletionContext
Apa yang memicu permintaan, jika klien melacaknya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
triggerKind | integer | tidak | Alasan completion diminta. |
triggerCharacter | string | tidak | Karakter yang memicunya, jika memang dipicu oleh karakter. |
Properti tambahan diizinkan.
AttachCandidatesParams
Menjawab Features mana yang dapat dilampirkan ke suatu entitas, dinilai berdasarkan label entitas tersebut, dan, untuk satu koneksi yang ditarik oleh komponen suatu node graf, Features mana yang dapat mengisi setiap slot yang dideklarasikan oleh socket koneksi tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
node | string | tidak | Entitas yang menjadi dasar penilaian kandidat, berdasarkan nama, dibaca dari apa yang dideklarasikan oleh dokumen workspace. |
graphNode | string | tidak | Node graf yang menjadi dasar penilaian kandidat, yang labelnya merupakan himpunan final yang digunakan build itu sendiri untuk mengevaluasi penerapan. Jawaban yang dihitung atas node ini menyatakan apa yang akan dilakukan build. |
release | string | tidak | Release yang grafnya memuat node tersebut, sebagai path relatif terhadap root workspace. Kandidat kemudian diambil dalam konteks Release tersebut: Features yang dideklarasikan oleh direktori katalog yang diberikan konfigurasi workspace kepada Release tersebut, serta dokumen workspace dikurangi dokumen apa pun di bawah salah satu direktori katalog workspace yang tidak dibaca oleh Release tersebut, sehingga Feature yang disimpan untuk Release lain tidak pernah ditawarkan untuk node pada graf Release ini. |
labels | map of string | tidak | Label yang langsung dijadikan dasar penilaian, sebagai pengganti pembacaan label dari entitas atau node graf. |
connection | ConnectionCoordinate | tidak | Satu koneksi yang ditarik oleh komponen dari node yang dinamai graphNode, untuk dijawab selain node tersebut: jawaban kemudian juga memuat slots, yaitu setiap slot yang dideklarasikan socket koneksi tersebut beserta Features yang dapat mengisinya, atau noSlotReason jika tidak ada slot yang dapat diisi. Nilai ini hanya dikirim bersama graphNode dan release, karena koneksi hanya ada pada graf yang telah dikompilasi; jika dikirim bersama node atau labels, permintaan ditolak. Kandidat di sampingnya tetap bermakna sama, yaitu Features yang dapat dilampirkan ke node itu sendiri. Dokumennya diterima dan tidak mengubah jawaban ini: slot adalah milik socket dan kandidat adalah milik Features, sama saja di dokumen mana pun lampiran ditulis. |
Properti tambahan tidak diizinkan.
ConnectionCandidatesParams
Menjawab entitas mana saja yang dapat dihubungkan dengan socket pada suatu entitas.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
node | string | tidak | Entitas yang socket-nya ditanyakan. |
socket | string | tidak | Satu socket yang akan dijawab. Jika tidak ada, jawaban mencakup setiap socket yang dideklarasikan entitas tersebut. |
Properti tambahan tidak diizinkan.
InsertionPointParams
Menjawab di bagian mana dalam suatu dokumen entri baru di bawah container bernama seharusnya ditempatkan, sementara penyusunan dan penerapan entri diserahkan kepada pemanggil yang memiliki buffer.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
file | string | tidak | Dokumen yang ditanyakan. |
container | string[] | tidak | Path melalui dokumen menuju container tempat entri tersebut berada. |
Properti tambahan tidak diizinkan.
AttachmentContainerParams
Menjawab di dokumen mana, dan di bagian mana di dalamnya, lampiran pada suatu node graf, atau pada satu koneksi yang ditarik komponennya, seharusnya berada.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
graphNode | string | tidak | Node graf yang menjadi tujuan lampiran. |
release | string | tidak | Release yang grafnya memuat node tersebut, sebagai path relatif terhadap root workspace. |
connection | ConnectionCoordinate | tidak | Satu koneksi yang ditarik oleh komponen node graf, jika lampiran ditujukan untuk koneksi tersebut dan bukan untuk node: jawaban kemudian menyebutkan container features milik koneksi itu sendiri dalam dokumen yang disebutkan oleh field document-nya, field yang wajib di sini. Dalam Aggregate, itu adalah entri koneksi dalam dokumen tempat node ditulis, dan ditolak untuk koneksi yang ditarik oleh Release, yang tidak memiliki entri di Aggregate. Dalam Release, itu adalah entri per-edge di bawah entri milik Release sendiri untuk node tersebut, baik Release sudah menulis entri untuk koneksi itu maupun belum, dan ditolak jika Release tidak menulis entri untuk node tersebut. Koneksi yang ditarik oleh Feature ditolak di kedua dokumen, karena lampiran hanya ditulis pada koneksi yang ditarik oleh komponen atau oleh Release. |
Properti tambahan tidak diizinkan.
ConnectionAtPositionParams
Menjawab entri koneksi mana yang memuat suatu posisi dalam Aggregate atau Release: node graf dan koneksinya, dalam bentuk yang diterima oleh permintaan kandidat dan container, atau alasan tidak ada koneksi yang ditulis di sana. Entri tersebut adalah entri tempat lampiran ditulis — entri yang digunakan komponen untuk menarik koneksi, di bawah alias koneksi, dalam dokumen tempat komponen ditulis, serta setiap entri per-edge yang ditulis Release — masing-masing di tempat yang dicatat oleh graf terkompilasi, sehingga apakah suatu kunci merupakan koneksi tidak pernah ditentukan dari namanya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
file | string | tidak | Dokumen tempat posisi berada: Release, atau dokumen yang dicatat oleh graf Release sebagai tempat komponen ditulis — Aggregate-nya, atau dokumen modul yang diimpor oleh Aggregate tersebut. Dokumen ini dibaca terlebih dahulu dari apa yang disimpan sesi untuknya, dan dari disk jika tidak ada. |
position | Position | tidak | Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain. |
release | string | tidak | Release yang graf terkompilasinya mencatat koneksi, sebagai path relatif terhadap root workspace. Nilai ini juga wajib untuk posisi dalam Aggregate, karena node graf dan koneksi hanya ada pada graf yang telah dikompilasi. |
Properti tambahan tidak diizinkan.
ConnectionCoordinate
Satu koneksi yang digambar oleh komponen sebuah node graf, dialamatkan melalui socket tempat koneksi itu dihubungkan dan alias yang dibawanya dalam socket tersebut, serta dokumen tempat lampiran pada koneksi itu ditulis. Sebuah koneksi membawa lampiran yang mengisi slot yang dideklarasikan socket-nya, dan Aggregate maupun Release dapat menuliskannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
socket | string | ya | Socket dependensi tempat koneksi dihubungkan. |
alias | string | ya | Nama yang dibawa koneksi di dalam socket-nya. |
document | const “aggregate” atau const “release” | tidak | Dokumen tempat lampiran pada koneksi ditulis. Himpunannya tertutup, dan nilai di luarnya ditolak. Nilai yang diizinkan: "aggregate" — Aggregate, tempat pengembang menulis lampiran pada entri koneksi. "release" — Release, tempat operator menulis lampiran pada entri per-edge untuk koneksi tersebut. |
Properti tambahan diizinkan.
SetActiveReleaseParams
Mencatat sebuah Release sebagai default workspace dengan menulis penanda di direktori .aggrega: pilihan yang dilaporkan aggrega/activeRelease membaca penanda tersebut setelah Release authoring dari konfigurasi. Penanda ditulis di dalam workspace dan tidak di tempat lain: jika direktori .aggrega atau penanda tersebut berupa tautan yang mengarah ke luar workspace, baik tempat tujuannya sudah ada maupun belum, penulisan ditolak dengan menyebutkan tautan tersebut dan tidak ada yang ditulis. Jawabannya adalah jawaban yang diberikan aggrega/activeRelease setelah penanda ditulis, sehingga jawaban itu menyebutkan Release lain jika Release authoring dari konfigurasi lebih diutamakan daripada penanda.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
release | string | tidak | Release yang akan dicatat, sebagai path relatif terhadap root workspace. Path absolut, dan path yang naik keluar dari workspace, ditolak; demikian pula path yang mengarah keluar melalui tautan, kecuali konfigurasi workspace menyebutkan Release tersebut. |
Properti tambahan tidak diizinkan.
EditDocumentParams
Menerapkan satu suntingan terbatas pada dokumen yang dibawa workspace: satu entri ditambahkan di bawah satu kontainer, atau satu skalar ditetapkan. Dokumen yang tersusun diperiksa terhadap skema jenisnya dan baru ditulis ke disk jika lolos, sehingga metode ini tidak dapat menulis apa yang ditolak skema authoring. Suntingan yang ditolak membiarkan berkas tetap sama persis byte demi byte.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
file | string | tidak | Dokumen yang akan disunting. |
edit | const “add-component” atau const “attach-feature” atau const “wire-edge” atau const “set-value” | tidak | Edit mana yang diterapkan. Nilai yang diizinkan: "add-component" — Menambahkan instance komponen di bawah kontainer components: name adalah nama instance, value adalah Component yang dimintanya. "attach-feature" — Melampirkan Feature ke node yang disebutkan permintaan: name adalah nama instance lampiran, value adalah Feature yang dimintanya. "wire-edge" — Menyambungkan koneksi dependensi dari node yang disebutkan permintaan, di dalam socket: name adalah alias yang digunakan untuk mengalamatkan koneksi, value adalah node yang ditunjuknya. "set-value" — Menetapkan satu nilai pada node yang disebutkan permintaan: name adalah kunci nilai, value adalah skalar. |
node | string[] | tidak | Path melalui dokumen menuju entri yang sedang disunting. |
socket | string | tidak | Socket yang menjadi pokok suntingan, untuk suntingan yang menghubungkannya. |
name | string | tidak | Nama yang ditulis oleh suntingan. |
value | any | tidak | Nilai yang ditulis oleh suntingan, dalam bentuk apa pun yang diambil suntingan tersebut. |
dryRun | boolean | tidak | Apakah menjawab dengan dokumen yang tersusun alih-alih menuliskannya. |
Properti tambahan tidak diizinkan.
ConfigInitParams
Membuat dokumen konfigurasi awal. Secara default metode ini menulis berkas tingkat mesin, karena registry dan identitas yang dipercaya padanya merupakan perangkat tingkat mesin. Metode ini menghubungi registry yang disebutkan untuk membaca kebijakan kepercayaan yang diumumkannya; registry yang tidak mengumumkan apa pun dilaporkan demikian dan pembuatan tetap berlanjut, dengan baseline bawaan untuk hub resmi dan tanpa kebijakan untuk registry lainnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
registry | string | tidak | Registry yang konfigurasinya akan dibuat. |
force | boolean | tidak | Apakah menimpa dokumen konfigurasi yang sudah ada. |
global | boolean | tidak | Menulis file konfigurasi tingkat mesin, yang merupakan default metode ini. |
workspace | boolean | tidak | Menulis file konfigurasi milik workspace ini alih-alih file tingkat mesin. |
dryRun | boolean | tidak | Apakah menjawab dengan isi dokumen alih-alih menuliskannya, untuk klien yang memelihara model dokumennya sendiri. |
Properti tambahan tidak diizinkan.
ConfigCaptureParams
Membekukan konfigurasi yang telah di-resolve ke dalam dokumen milik workspace ini sendiri, sehingga workspace menjadi mandiri. Metode ini selalu menulis berkas workspace tersebut dan tidak menghubungi apa pun di luarnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
allPlugins | boolean | tidak | Apakah membekukan setiap plugin yang terpasang alih-alih hanya plugin yang dikonfigurasi oleh workspace itu sendiri. |
Properti tambahan tidak diizinkan.
ImportParams
Mengonversi deskripsi sumber asing menjadi dokumen penulisan draf, dan menulis di sampingnya .aggrega-import.json, catatan tentang apa yang ditulis oleh impor — target yang diberikan kepadanya, jika diberikan, snapshot katalog yang dibacanya, jika ada yang dibaca, setiap berkas draf, dan setiap kunci dari Aggregate atau Release draf pada setiap kedalaman — yang dibaca oleh sinkronisasi berikutnya. Sumber yang tidak dapat dikonversi sepenuhnya merupakan jawaban, bukan kegagalan: draf yang berhasil dihasilkan ditulis dan temuan menyebutkan apa yang tidak dapat dikonversi — kecuali di bawah sync, yang tidak menulis apa pun dari konversi yang terhenti.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
source | string | tidak | Berkas atau direktori yang akan dikonversi, sebagai path absolut atau path relatif terhadap root workspace; permintaan tanpa nilai ini ditolak. Nilai ini dibaca di tempatnya, di dalam workspace maupun tidak, dan direktori dibaca menjadi berkas-berkas di dalamnya yang dipilih oleh pola berkas yang dideklarasikan importer. |
outputDir | string | tidak | Direktori di bawah workspace tempat draf ditulis, relatif terhadap root workspace; nilai absolut, atau nilai yang mengarah keluar dari workspace sebagaimana tertulis atau melalui tautan, ditolak. Jika tidak ada, penulisan dilakukan di bawah root workspace, tempat konversi yang sama yang dijalankan di terminal tanpa menyebut tujuan menulis. Setiap path draf relatif terhadap direktori yang disebut jawaban sebagai outputDir, termasuk di bawah dryRun. |
format | string | tidak | Format sumber. Jika tidak ada, konversi yang menentukannya. |
target | string | tidak | Kapabilitas provider, seperti compose atau helm — kata yang diikat oleh spec.capability sebuah Recipe — untuk membuat draf Manifest di samping draf-draf tersebut, sebagai manifest.yaml: setiap tipe component dan tipe feature yang dibutuhkan draf, termasuk tipe-tipe dari Aggregate katalog yang disusun oleh Aggregate draf, dipetakan ke Recipe atau resep feature dengan kapabilitas tersebut yang ditawarkan katalog workspace untuknya — satu-satunya yang ada, atau di antara beberapa, yang dinamai sesuai tipe tersebut — tipe yang tidak memilikinya, atau memiliki beberapa tetapi tidak ada yang dinamai demikian, dibiarkan tidak terpetakan dengan temuan peringatan yang menyebutkannya, pemetaan yang dibuat sendiri oleh importer dipertahankan jika katalog menawarkannya untuk tipe dan kapabilitas tersebut dan dibuang dengan temuan peringatan jika tidak, dan spec.manifest dari Release draf diatur ke Manifest tersebut. Kapabilitas yang tidak diikat oleh Recipe mana pun di katalog ditolak sebelum konversi berjalan, dan tidak ada yang ditulis. Jika tidak ada, tidak ada Manifest yang dibuat drafnya, kecuali di bawah sync, yang membuat draf untuk target yang disebut catatan impor sebelumnya; sync yang menyebut target membuat draf untuk target itu, dan catatan kemudian menyebutnya. |
dryRun | boolean | tidak | Apakah akan menjawab dengan konten setiap berkas yang akan ditulis permintaan alih-alih menulisnya. Setiap perilaku lain sama dengan penulisan, sehingga permintaan yang akan ditolak oleh penulisan juga ditolak di bawahnya; dengan sync, jawabannya berisi apa yang akan ditulis sync dan setiap bagian yang akan menyimpang. |
sync | boolean | tidak | Apakah akan memperbarui apa yang dibuat drafnya oleh impor sebelumnya di bawah outputDir agar sesuai dengan sumber, alih-alih menulis draf secara utuh. Hanya apa yang ditulis impor yang berubah, sebagaimana dicantumkan catatan di samping draf: bagian yang tidak diubah sumber tetap seperti di disk, diedit maupun tidak; bagian yang diubah, dihapus, atau ditambahkan oleh sumber ditulis ulang, dihapus — berkas draf dihapus seluruhnya — atau ditambahkan, jika yang ada di disk adalah apa yang terakhir ditulis impor; dan segala hal lainnya, kunci yang ditambahkan penulis — termasuk environment yang ditinggalkan Release draf untuk penulisnya — atau komentar yang tidak ditulis tepat di atas kunci draf, tetap byte demi byte. Sync yang akan mengubah atau menghapus apa yang diedit atau ditambahkan penulis, atau menambahkan bagian di tempat penulis sudah menulisnya, ditolak dengan menyebutkan setiap bagian, demikian pula sync atas Aggregate yang tidak tercantum dalam catatan mana pun; dalam kedua kasus tidak ada yang ditulis. Tanpanya, permintaan yang draf-drafnya akan ditulis menimpa Aggregate yang sudah ada di outputDir ditolak, termasuk di bawah dryRun. |
upgrade | boolean | tidak | Apakah akan mengambil snapshot katalog terbaru yang diterbitkan registry bawaan workspace dan mengimpor berdasarkan snapshot tersebut, serta menyimpannya sejak saat itu sebagai pengganti snapshot yang dimiliki workspace atau snapshot yang disebutkan oleh catatan di samping draf; tidak mengubah apa pun jika workspace menyebutkan folder katalog, dan ditolak saat offline. |
answers | string | tidak | File jawaban tempat nilai-nilai yang dibiarkan kosong oleh draf dan tidak dapat dimuat oleh sumber mana pun dibaca dan ditulis, relatif terhadap root workspace; nilai absolut, atau nilai yang mengarah ke luar workspace sebagaimana tertulis atau melalui tautan, ditolak. File ini memuat, di bawah path setiap file draf, path kunci di dalam dokumen tersebut beserta jawabannya, dan jawaban-jawaban itu ditulis ke dalam draf. Jika tidak ada, yang dibaca adalah file yang disebutkan oleh catatan di samping draf, atau jika tidak, import-answers.yaml di samping file sumber atau di dalam direktori sumber. Jawaban untuk sebuah secret menyebutkan asal secret tersebut — nama variabel, ${NAME}, atau nama sebuah Kubernetes Secret — dan apa pun selain itu ditolak tanpa ada yang ditulis. Tidak ada yang ditanyakan: setiap nilai yang masih terutang menjadi entri dalam owed jawaban dan temuan peringatan yang menyebutkan file draf, kuncinya, dan apa nilai itu, jawabannya dikirim sebagai answered, dan jika draf ditulis, temuan terakhir menyatakan berapa banyak yang masih terutang dan di mana. Jika draf mencakup Release, tidak ada yang terutang, dan konversi selesai, dependensinya kemudian di-pull sambil menulis lockfile-nya, dan pull yang gagal menutup temuan dengan menyebutkan alasannya, dengan draf tetap ditulis; dalam mode offline tidak ada yang di-pull dan sebuah temuan menyebutkan pull yang perlu dijalankan. Jawaban untuk kunci yang tidak dibiarkan kosong oleh draf ini tetap disimpan di file dan tidak diterapkan, sehingga satu file jawaban melayani setiap target. |
answered | ImportAnswered[] | tidak | Jawaban untuk nilai-nilai yang didaftarkan oleh owed jawaban, masing-masing menyebutkan file draf dan kunci-kuncinya sebagaimana owed menyebutkannya. Setiap jawaban dinilai, disimpan di file jawaban, dan ditulis ke dalam draf persis seperti jawaban yang diketik di terminal: jawaban untuk sebuah secret menyebutkan asal secret tersebut — nama variabel, ${NAME}, atau nama sebuah Kubernetes Secret — dan jawaban yang tidak demikian tidak disimpan maupun ditulis, dan nilainya tetap terutang dengan alasannya sebagai secretAdvice-nya. Nilai yang sudah dijawab oleh file jawaban dijawab dari file tersebut; jawaban kosong, atau jawaban yang menyebutkan nilai yang tidak terutang oleh draf, tidak diterapkan. Kirimkan dengan sync setelah draf ditulis, karena permintaan yang bukan sync ditolak atas Aggregate yang sudah ada di outputDir. Di bawah dryRun, yang tidak menyimpan jawaban apa pun, dan di bawah sync yang konversinya berhenti, yang tidak menulis apa pun, tidak ada jawaban terkirim yang diterapkan. |
Properti tambahan tidak diizinkan.
ScaffoldEntityParams
Membuat draf dokumen awal untuk sebuah jenis entitas, atau menulis salah satu contoh yang dapat dijalankan dari dokumentasi ke dalam direktori baru di workspace, atau mencantumkan daftarnya. Pembuatan draf menurunkan kerangka dari himpunan skema yang dibawa biner, sehingga tidak ada yang dibaca dari workspace dan tidak ada yang ditulis — jawabannya berupa teks, dan ke mana teks itu pergi ditentukan oleh klien. Menulis contoh hanya menulis direktori baru dan tidak ada yang lain, dan contoh dibaca dari bundel dokumentasi bertanda tangan yang dipublikasikan untuk versi biner, atau yang terbaru yang dipublikasikan sebelumnya jika tidak ada, yang diverifikasi terhadap kebijakan tanda tangan workspace sebelum disimpan atau dibaca: bundel yang tidak lolos verifikasi ditolak, dan saat offline hanya salinan yang sudah ada di cache yang dibaca. Permintaan yang mengirimkan field dari dua bentuk sekaligus — kind dengan example atau list, list dengan example, name dengan example atau list, dir tanpa example — ditolak sebelum apa pun dibaca.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | string | tidak | Path absolut workspace. Pembuatan draf tidak membacanya. Menulis atau mencantumkan contoh memerlukannya: konfigurasi workspace menentukan dari mana dokumentasi diambil dan tanda tangan apa yang harus dibawanya, dan contoh ditulis di dalamnya. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
kind | string | tidak | Jenis entitas yang akan dibuat drafnya, dinamai dengan token huruf kecilnya, seperti component, aggregate, release, recipe, atau featurerecipe — token yang dicantumkan aggrega/getSchema untuknya. |
name | string | tidak | Nama yang akan ditulis ke dalam dokumen draf. Hanya dikirim bersama kind. |
example | string | tidak | Contoh yang dapat dijalankan yang akan ditulis, berdasarkan nama yang diberikan daftar contoh kepadanya. Dikirim sebagai pengganti kind. |
list | boolean | tidak | Apakah akan menjawab dengan setiap contoh yang dapat dijalankan yang dipublikasikan dokumentasi, tanpa menulis apa pun. Dikirim tanpa example dan tanpa kind. |
dir | string | tidak | Direktori baru tempat contoh akan ditulis, relatif terhadap root workspace; jika tidak ada, contoh ditulis ke direktori yang dinamai sesuai contoh di sana. Direktori tersebut belum boleh ada atau harus kosong: direktori yang berisi apa pun ditolak dan dibiarkan apa adanya, dan nilai absolut, atau nilai yang mengarah keluar dari workspace sebagaimana tertulis atau melalui tautan, ditolak sebelum apa pun dibaca. Hanya dikirim bersama example. |
Properti tambahan tidak diizinkan.
LintParams
Memeriksa konvensi penerbitan katalog pada satu entitas, pada segala hal yang dijangkau closure sebuah Release, atau pada segala hal di bawah direktori katalog yang dikonfigurasi. Tidak ada yang ditulis dalam mode apa pun. Tanpa menyebut entitas maupun Release, seluruh katalog diperiksa: di workspace yang konfigurasinya tidak memberikan direktori katalog Release sendiri, sekali atas direktori workspace; di workspace yang menyebut Releases di bawah workspace.releases, sekali untuk setiap Release atas direktori yang dibaca Release tersebut, tidak pernah atas semuanya sekaligus.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
entity | string | tidak | Satu dokumen entitas yang akan diperiksa. |
release | string | tidak | Release yang closure-nya akan diperiksa, sebagai path relatif terhadap root workspace. |
prePublish | boolean | tidak | Apakah akan membandingkan setiap entitas dengan versi yang diterbitkan sebelumnya, yang menjangkau registry yang dikonfigurasi. |
Properti tambahan tidak diizinkan.
PluginAddParams
Memasang plugin ke soket yang dikonfigurasi oleh workspace. Metode ini menghubungi registry untuk menyelesaikan kueri menjadi satu plugin dan menyematkan versinya. Satu-satunya keputusan yang akan diminta oleh terminal — menerima kapabilitas yang dideklarasikan oleh plugin ekstensi perintah — datang sebagai field di sini, sehingga klien bertanya kepada siapa pun yang mengendalikannya dan antarmuka ini tidak pernah menunggu prompt.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
type | string | tidak | Soket tempat plugin dipasang. |
query | string | tidak | Apa yang diselesaikan menjadi satu plugin. |
capability | string | tidak | Kapabilitas yang menjadi tujuan pemasangan, jika soket membawa beberapa kapabilitas. |
role | string | tidak | Peran tempat pemasangan dijalankan, yang menentukan apa yang boleh dihasilkannya. |
global | boolean | tidak | Tulis file konfigurasi tingkat mesin. |
workspace | boolean | tidak | Tulis file konfigurasi milik workspace ini sendiri. |
acceptCapabilities | boolean | tidak | Apakah pemanggil menerima kapabilitas yang dideklarasikan oleh plugin ekstensi perintah. |
dryRun | boolean | tidak | Apakah akan menjawab dengan konten dokumen konfigurasi alih-alih menuliskannya. |
Properti tambahan tidak diizinkan.
PluginRemoveParams
Melepas plugin dari soket yang dikonfigurasi oleh workspace.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
type | string | tidak | Soket tempat plugin terpasang. |
query | string | tidak | Pemasangan mana yang akan dihapus. |
global | boolean | tidak | Tulis file konfigurasi tingkat mesin. |
workspace | boolean | tidak | Tulis file konfigurasi milik workspace ini sendiri. |
Properti tambahan tidak diizinkan.
PluginSyncParams
Menyelaraskan catatan milik mesin pada entitas Plugin dengan modul yang dirujuknya. Metode ini menulis ulang catatan tersebut dan membawa setiap byte lain dari dokumen tanpa perubahan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
entity | string | tidak | Dokumen entitas Plugin yang akan diselaraskan. |
plugin | string | tidak | Modul plugin tempat catatan dibaca. |
Properti tambahan tidak diizinkan.
PluginGenCatalogParams
Menghasilkan dokumen katalog Plugin dari metadata yang dideklarasikan sendiri oleh plugin ditambah overlay yang ditulis penulis. Pembuatan ulang atas input yang tidak berubah menghasilkan dokumen yang identik byte demi byte.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
fromEmbedded | boolean | tidak | Apakah akan membaca metadata dari plugin yang sudah dibawa oleh biner. |
plugin | string | tidak | Modul plugin tempat metadata dibaca. |
outputDir | string | tidak | Direktori di bawah workspace tempat dokumen ditulis. |
overlay | string | tidak | Dokumen yang ditulis penulis, yang kontennya digabungkan di atas metadata yang dihasilkan. |
dryRun | boolean | tidak | Apakah akan menjawab dengan konten dokumen alih-alih menuliskannya. |
Properti tambahan tidak diizinkan.
ExplainErrorParams
Menguraikan kode yang dibawa sebuah temuan menjadi apa yang dideklarasikan kompiler tentang kondisi tersebut beserta entri terpublikasi yang mengajarkan perbaikan penulisannya. Metode ini mengambil dokumentasi terpublikasi jika workspace tidak memiliki salinannya; jika tidak dapat diambil, metode ini tetap menjawab apa yang dideklarasikan biner, dan menyebutkan mengapa penjelasannya tidak ada.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
code | string | tidak | Kondisi yang akan diuraikan, disebut dengan kode yang dibawa temuan atau kode pendeknya. |
Properti tambahan tidak diizinkan.
GetSchemaParams
Menjawab dengan skema suatu jenis, atau — jika tidak ada jenis yang disebut — dengan jenis-jenis yang dapat disebut. Metode ini menjawab untuk biner yang sedang berjalan, bukan untuk salinan mana pun yang terpasang di tempat lain, sehingga tidak memerlukan workspace dan tidak membacanya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootAccepted | tidak | Path absolut sebuah workspace. Subjek metode ini bukan workspace — metode ini menjawab dari apa yang dibawa oleh biner itu sendiri — sehingga field ini diterima tetapi tidak dibaca. Field ini diizinkan karena klien dapat mengirimkannya secara seragam pada setiap permintaan tanpa perlu mengetahui metode mana yang memakainya. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
kind | string | tidak | Jenis yang skemanya dijadikan jawaban. Jika tidak ada, yang dijawab adalah jenis-jenis yang dapat disebut. |
Properti tambahan tidak diizinkan.
SkillsInstallParams
Menulis skill asisten yang tertanam dalam biner ke folder skill setiap asisten yang disebutkan permintaan atau, untuk permintaan global yang tidak menyebutkan satu pun, setiap asisten yang ditemukan di mesin ini. Tanpa global, permintaan ini menulis ke folder proyek setiap asisten di dalam workspace yang disebutkan permintaan, dan setiap path yang akan ditulisnya di sana dibatasi pada workspace tersebut; dengan global, permintaan ini menulis ke folder per pengguna setiap asisten di bawah direktori home. Setiap target diperiksa sebelum apa pun ditulis, sehingga penolakan membiarkan setiap folder seperti semula.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | ya | Path absolut workspace yang menjadi sasaran permintaan ini. Path ini adalah subjek permintaan: daemon me-resolve-nya sebelum metode dijalankan, dan permintaan yang menghilangkannya atau menuliskannya sebagai apa pun selain string akan ditolak. |
workDoneToken | ProgressToken | tidak | Nilai yang dibuat pemanggil agar dapat mencocokkan notifikasi kemajuan dengan panggilan yang memintanya. Nilai ini dipantulkan kembali tanpa diubah pada setiap notifikasi, sehingga pemanggil dapat membandingkannya dengan nilai yang dikirimnya. Nilai ini diterima pada setiap permintaan, dan permintaan yang mengirimkannya dalam sesi yang tidak mendeklarasikan kemampuan kemajuan akan ditolak. |
agents | string[] | tidak | Asisten yang akan dipasangi skill, berdasarkan pengidentifikasi yang dilaporkan daftar. Permintaan proyek yang tidak menyebutkan satu pun ditolak. Permintaan global yang tidak menyebutkan satu pun memasang skill untuk asisten yang ditemukan di mesin ini, yaitu setiap asisten yang folder konfigurasinya berada di direktori home atau yang perintahnya ada di PATH, dan ditolak tanpa menulis apa pun jika tidak ada yang ditemukan. Pengidentifikasi yang tidak diketahui folder skill-nya ditolak, dengan menyebutkan namanya, dan pengidentifikasi yang diberikan dua kali dipasang sekali. |
global | boolean | tidak | Menulis ke folder skill per pengguna setiap asisten di bawah direktori home, yang dibacanya di setiap proyek, alih-alih ke folder proyeknya di workspace. |
Properti tambahan tidak diizinkan.
ServerCapabilities
Apa yang akan dilakukan daemon dalam sesi ini, yang disepakati berdasarkan apa yang dinyatakan klien dapat ditanganinya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
positionEncoding | string | ya | Encoding yang digunakan untuk menyatakan setiap posisi dalam sesi ini. |
workDoneProgress | boolean | tidak | Apakah daemon akan mengirim notifikasi progres dalam sesi ini. Hanya ada jika klien menyatakan dapat menerimanya. |
Properti tambahan tidak diizinkan.
ClosureEntity
Satu entitas yang menjadi dependensi sebuah Release, pada versi yang ditetapkan oleh resolusi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
uri | string | ya | Referensi tempat entitas diresolusi. |
version | string | ya | Versi yang ditetapkan. |
kind | string | tidak | Jenis entitas. |
source | string | tidak | Asal entitas yang diambil oleh proses yang menghasilkan entri ini, dengan kata yang sama yang dicetak aggrega pull --detail untuknya: fetched-fresh (diambil dari registry selama proses tersebut), cache-reuse (salinan yang sudah ada di cache, digunakan kembali tanpa pengambilan), local (ditemukan di sistem berkas lokal, seperti direktori katalog), in-binary (salinan di dalam biner compiler), atau external (Aggregate atau Manifest milik Release itu sendiri, dibaca dari berkas atau entri yang disebut Release alih-alih diresolusi sebagai salah satu dependensinya; Aggregate yang diambil proses dari registry justru bernilai fetched-fresh). Ada pada entri laporan resolusi dependensi, tempat properti ini menjelaskan apa yang dilakukan proses tersebut di mesin ini, dan tidak ada pada daftar dependensi terresolusi sebuah Release, yang menjelaskan apa saja dependensi Release tersebut. Lockfile tidak mencatat sumber. Dihilangkan untuk entitas yang sumbernya tidak dicatat oleh proses. |
Properti tambahan tidak diizinkan.
ToolchainCorePlugin
Satu plugin yang dibawa oleh compiler itu sendiri, beserta versinya yang digunakan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
plugin | string | ya | Referensi plugin. |
version | string | ya | Versi yang digunakan. |
Properti tambahan tidak diizinkan.
ToolchainReport
Compiler yang melakukan resolusi, beserta plugin yang dibawanya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
compilerVersion | string | ya | Versi compiler yang melakukan resolusi. |
corePlugins | ToolchainCorePlugin[] | tidak | Plugin yang dibawa compiler, beserta versi masing-masing yang digunakan. |
Properti tambahan tidak diizinkan.
DependencyResolutionReport
Apa yang di-pin dan diperoleh oleh sebuah resolusi dependensi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
lockfile | string | ya | Lockfile yang ditulis resolusi, atau lockfile yang dibandingkan oleh verifikasi. |
verified | boolean | tidak | Apakah permintaan berupa verifikasi, yang membandingkan lockfile tercatat dan tidak menulis lockfile, catatan kepercayaan plugin, maupun entity.lock. |
entities | ClosureEntity[] atau null | ya | Entitas yang di-pin oleh resolusi, atau dibandingkan oleh verifikasi. |
libraries | ClosureEntity[] atau null | ya | Pustaka yang di-pin oleh resolusi, atau dibandingkan oleh verifikasi. |
plugins | ClosureEntity[] atau null | ya | Plugin yang di-pin oleh resolusi, atau dibandingkan oleh verifikasi. |
sourceArtifacts | integer | ya | Jumlah artefak sumber yang diperoleh. |
trustedPlugins | integer | ya | Jumlah plugin yang di-pin yang membawa tanda tangan terverifikasi. |
toolchain | ToolchainReport | tidak | Compiler yang melakukan resolusi, beserta plugin yang dibawanya. |
externalInputs | integer | ya | Jumlah input eksternal yang dikonsumsi render yang berhasil diperoleh. |
incompleteExternalInputs | string | tidak | Input eksternal mana yang tidak dapat diperoleh, jika ada yang tidak dapat diperoleh. |
Properti tambahan tidak diizinkan.
BuildNotice
Satu hal yang ingin diberitahukan build kepada pemanggil, yang bukan temuan tentang dokumen maupun kegagalan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
class | string | ya | Jenis pemberitahuan ini. |
text | string | ya | Isi pemberitahuan. |
Properti tambahan tidak diizinkan.
CacheScope
Seberapa jauh jangkauan sebuah jawaban cache. Dua kelas cache digunakan bersama oleh setiap proyek di mesin, sehingga setiap jawaban cache menyebutkan kelas mana yang disentuhnya — jika tidak, sesi yang dibuka atas satu workspace akan dibaca seolah hanya melaporkan tentang workspace tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
machineWideClasses | string[] atau null | ya | Kelas cache yang disentuh jawaban ini yang digunakan bersama oleh setiap proyek di mesin. |
workspaceRoot | string | ya | Workspace yang disebut oleh permintaan. |
Properti tambahan tidak diizinkan.
CacheElement
Satu hal yang disimpan cache.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
label | string | ya | Apa isi entri tersebut. |
size | integer | ya | Jumlah byte yang ditempatinya. |
sizeText | string | ya | Ukuran yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
digest | string | tidak | Digest konten yang menjadi kunci entri, jika ada. |
note | string | tidak | Keterangan lain yang perlu disampaikan tentang entri tersebut. |
Properti tambahan tidak diizinkan.
CacheClass
Satu cache yang dilaporkan oleh daemon.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Cache yang dimaksud. |
reach | string | ya | Apakah cache milik workspace ini atau digunakan bersama di seluruh mesin. |
prunable | boolean | ya | Apakah pengambilan kembali ruang cache ini akan dilakukan oleh daemon. |
elements | CacheElement[] atau null | ya | Apa yang disimpan cache. |
Properti tambahan tidak diizinkan.
CacheProvenance
Identitas mana saja yang digunakan saat artefak dalam cache diperoleh, dan seberapa luas artefak itu digunakan bersama.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
identities | string[] atau null | ya | Identitas yang diatribusikan pada artefak. |
sharedBy | integer | tidak | Jumlah pemegang yang menggunakan artefak bersama. |
Properti tambahan tidak diizinkan.
CacheRemoval
Satu hal yang dihapus oleh pengambilan kembali ruang — atau, dalam daftar hal yang dibiarkan di tempatnya, satu hal yang akan dihapusnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
class | string | ya | Cache tempat hal itu berada. |
label | string | ya | Hal yang dimaksud. |
reach | string | ya | Apakah cache tersebut milik workspace ini atau digunakan bersama di seluruh mesin. |
size | integer | ya | Jumlah byte yang ditempatinya, atau yang ditempatinya sebelum dihapus. |
sizeText | string | ya | Ukuran yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
Properti tambahan tidak diizinkan.
CacheShortfall
Apa yang ditinggalkan oleh pengambilan kembali ruang, dan apa yang dapat mengambilnya kembali, sehingga pemanggil yang membaca angka lebih kecil dari yang diharapkannya mengetahui alasannya alih-alih menduganya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
class | string | ya | Cache yang menyimpan hal yang ditinggalkan. |
count | integer | ya | Jumlah entri yang ditinggalkan. |
size | integer | ya | Jumlah byte yang ditempatinya. |
sizeText | string | ya | Ukuran yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
reach | string | ya | Apakah cache tersebut milik workspace ini atau digunakan bersama di seluruh mesin. |
reclaimedBy | string[] atau null | ya | Apa yang dapat mengambilnya kembali. |
Properti tambahan tidak diizinkan.
CacheCleared
Satu cache yang dikosongkan oleh pembersihan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
class | string | ya | Cache yang dikosongkan. |
reach | string | ya | Apakah cache milik workspace ini atau digunakan bersama di seluruh mesin. |
size | integer | ya | Jumlah byte yang diambil kembali darinya. |
sizeText | string | ya | Ukuran yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
heldOpenFiles | integer | ya | Jumlah berkas yang ditinggalkan pembersihan di cache ini karena sedang dibuka oleh proses lain. Hanya Windows yang menolak menghapus berkas yang sedang terbuka, sehingga di sistem lain nilainya nol. Pembersihan berikutnya menghapusnya setelah proses tersebut selesai menggunakannya. |
heldOpenBytes | integer | ya | Jumlah byte yang ditempati berkas-berkas tersebut. Jumlah ini tidak dihitung dalam size, yang merupakan ruang yang diambil kembali oleh pembersihan. |
heldOpenBytesText | string | ya | Angka yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
Properti tambahan tidak diizinkan.
ConfigWriteScope
Dokumen konfigurasi mana yang ditulis dan seberapa jauh jangkauannya. Sebuah permintaan menyebut satu workspace, sehingga jawaban yang tidak menyebutkan apa pun akan dibaca sebagai jawaban tentang workspace tersebut — dan untuk penulisan tingkat mesin, pembacaan itu keliru.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
configFile | string | ya | Dokumen yang ditulis. |
machineWide | boolean | ya | Apakah dokumen tersebut adalah dokumen yang dilalui resolusi setiap workspace di mesin. |
workspaceRoot | string | ya | Workspace yang disebut oleh permintaan. |
Properti tambahan tidak diizinkan.
PluginWriteScope
Dokumen konfigurasi mana yang menjadi tempat penulisan perubahan plugin dan seberapa jauh jangkauannya. Default socket ekstensi perintah sendiri adalah dokumen tingkat mesin, sehingga setiap jawaban menyebutkan dokumen mana yang ditulisnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
configFile | string | ya | Dokumen yang ditulis. |
machineWide | boolean | ya | Apakah dokumen tersebut adalah dokumen yang dilalui resolusi setiap workspace di mesin. |
workspaceRoot | string | ya | Workspace yang disebut oleh permintaan. |
Properti tambahan tidak diizinkan.
CredentialStoreScope
Seberapa jauh jangkauan perubahan kredensial. Penyimpanan digunakan bersama oleh setiap proyek di mesin dan oleh setiap alat lain yang mengakses registry yang sama, sehingga jawaban melaporkan hal itu alih-alih membiarkan pembacaan seolah terbatas pada sesi untuk diduga.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
machineWide | boolean | ya | Apakah penyimpanan yang disentuh perubahan digunakan bersama di seluruh mesin. |
workspaceRoot | string | ya | Workspace yang disebut oleh permintaan. |
Properti tambahan tidak diizinkan.
SkillFolderScope
Seberapa jauh jangkauan pemasangan skill. Permintaan menyebutkan satu workspace, sehingga jawaban yang tidak menyatakan apa pun akan dibaca sebagai berkaitan dengan workspace tersebut — dan untuk folder per pengguna, yang dibaca asisten di setiap proyek, pembacaan itu keliru.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
machineWide | boolean | ya | Apakah folder yang ditulis adalah folder per pengguna di bawah direktori home, yang dibaca asisten di setiap proyek pada mesin. |
workspaceRoot | string | ya | Workspace yang disebut oleh permintaan. |
Properti tambahan tidak diizinkan.
PublicationReach
Seberapa jauh sebuah publikasi menjangkau. Jawaban ini menjangkau sepenuhnya melampaui mesin ini — apa yang dilampirkannya adalah apa yang di-resolve oleh setiap konsumen registry tersebut — sehingga masing-masing menyebutkan setiap registry yang dituju dan apakah panggilan tersebut melampirkan sesuatu di sana.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
registries | string[] | ya | Setiap host registry yang dituju panggilan, masing-masing disebut sekali, dalam urutan pertama kali panggilan menujunya. Panggilan dengan satu referensi menyebutkan satu; dry run menyebutkan tujuan yang akan dituju. |
beyondThisMachine | boolean | ya | Apakah panggilan melampirkan sesuatu yang kini disajikan registry kepada pihak lain: konten yang diunggah, tanda tangan, tanggal publikasi, atau penanda deprecation. Bernilai false pada dry run, dan pada panggilan yang mendapati semua yang akan dilampirkannya sudah ada — publikasi yang dijalankan ulang atas versi yang lengkap, atau batch penandatanganan yang setiap referensinya sudah membawa tanda tangan yang terverifikasi. |
Properti tambahan tidak diizinkan.
WorkspaceEntityRef
Satu entitas, berdasarkan jenis dan nama, beserta dokumen yang mendeklarasikannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | ya | Jenis entitas. |
name | string | ya | Nama entitas. |
file | string | ya | Dokumen yang mendeklarasikannya, sebagai path relatif terhadap root workspace. |
Properti tambahan tidak diizinkan.
SourcedEntityRef
Satu entitas, beserta tempat entitas itu dibaca. Dokumen workspace melaporkan path relatif terhadap workspace; entitas yang di-resolve dari direktori katalog yang dikonfigurasi melaporkan path kosong, karena satu-satunya path yang dimilikinya tidak bermakna bagi klien. Origin menyatakan yang mana di antara keduanya, alih-alih membiarkan path kosong dibaca sebagai field yang tidak diisi siapa pun.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | ya | Jenis entitas. |
name | string | ya | Nama entitas. |
file | string | ya | Dokumen yang mendeklarasikannya, sebagai path relatif terhadap root workspace, atau kosong jika berasal dari direktori katalog yang dikonfigurasi. |
origin | string | ya | Tempat entitas dibaca. |
Properti tambahan tidak diizinkan.
SocketCandidacy
Satu socket pada sebuah entitas, dan apa yang dapat dihubungkan ke dalamnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
socket | string | ya | Nama socket. |
declaration | string | ya | Tempat socket dideklarasikan. |
selector | string | ya | Label selector yang harus dipenuhi oleh target. |
required | boolean | ya | Apakah socket harus dihubungkan agar build dapat dilanjutkan. |
targets | WorkspaceEntityRef[] atau null | ya | Entitas yang dapat dihubungkan ke dalamnya. |
Properti tambahan tidak diizinkan.
SlotCandidacy
Satu slot yang dideklarasikan socket sebuah koneksi, sebagaimana Component konsumen mendeklarasikannya pada socket, beserta Features yang dapat mengisinya pada koneksi tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
slot | string | ya | Nama slot, yang merupakan kunci tempat attachment yang mengisinya ditulis dalam features koneksi. |
selector | string | ya | Label selector yang harus dipenuhi oleh Feature yang mengisi slot dengan label miliknya sendiri. Kosong jika slot tidak mendeklarasikannya, yang menerima Feature apa pun. |
required | boolean | ya | Apakah setiap koneksi yang dihubungkan melalui socket harus mengisi slot agar build dapat dilanjutkan. |
inject | string[] | ya | Mekanisme pengiriman yang diizinkan slot untuk apa yang mengisinya, dalam urutan Component mendeklarasikannya. Kosong jika tidak ada yang dideklarasikan. |
sensitive | boolean | ya | Apakah slot mendeklarasikan bahwa apa yang mengisinya menangani materi rahasia. Ini menandai attachment yang mengisinya dan tidak menolak apa pun. |
description | string | ya | Kegunaan slot menurut Component. Kosong jika Component tidak menyatakan apa pun. |
candidates | SourcedEntityRef[] | ya | Setiap Feature yang dapat mengisi slot pada koneksi ini: Feature yang applicability yang dideklarasikannya dipenuhi oleh label node graph, yang menjadi ketentuan bagi setiap attachment yang dibawa node, dan yang label miliknya sendiri memenuhi selector slot. Feature yang applicability atau labelnya tidak dapat dibaca terhadap selector tidak ditawarkan, karena build akan menolaknya alih-alih menerimanya. |
Properti tambahan tidak diizinkan.
CatalogEntity
Satu entitas yang dimuat indeks workspace.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | ya | Jenis entitas. |
name | string | ya | Nama entitas. |
apiVersion | string | ya | Versi skema yang dideklarasikan dokumen. |
description | string | ya | Kegunaan entitas menurut dokumen. |
labels | map of string atau null | ya | Label yang dideklarasikan dokumen. |
file | string | ya | Dokumen yang mendeklarasikannya, sebagai path relatif terhadap root workspace. |
origin | string | ya | Tempat entitas dibaca. |
Properti tambahan tidak diizinkan.
CompletionItem
Satu hal yang dapat ditulis pada posisi kursor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
label | string | ya | Teks yang akan ditulis. |
kind | integer | tidak | Jenis hal tersebut, sehingga klien dapat memilih ikon untuknya. |
detail | string | tidak | Keterangan singkat yang ditampilkan di samping label. |
documentation | string | tidak | Penjelasan lengkap tentang hal tersebut. |
sortText | string | tidak | Nilai untuk pengurutan, jika berbeda dari label. |
Properti tambahan tidak diizinkan.
MarkupContent
Teks yang akan ditampilkan, dan cara markup-nya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | ya | Cara markup teks. |
value | string | ya | Teksnya. |
Properti tambahan tidak diizinkan.
EntityKindDescriptor
Satu jenis dokumen yang ditulis penulis, yang memasangkan token yang disebutkan permintaan dengan jenis yang dideklarasikan dokumen itu sendiri, serta menyatakan operasi mana yang menerima dokumen dengan jenis tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | ya | Token huruf kecil yang disebutkan permintaan, seperti component atau featurerecipe. |
documentKind | string | ya | Jenis yang dideklarasikan header dokumen itu sendiri. |
acceptedBy | EntityKindAcceptance | ya | Operasi mana yang menerima dokumen dengan jenis ini yang disebutkan sendiri — berdasarkan path-nya, atau berdasarkan namanya untuk inspeksi — tanpa ada hal lain yang dikirim bersamanya. Sebuah anggota bernilai true jika operasi tersebut tidak menolak dokumen karena jenisnya; dokumen yang diterimanya tetap dapat ditolak karena isinya. |
Properti tambahan tidak diizinkan.
EntityKindAcceptance
Untuk satu jenis yang ditulis penulis, apakah setiap operasi menerima dokumen dengan jenis tersebut yang disebutkan sendiri. Setiap anggota ada pada setiap entri, sehingga false merupakan pernyataan, bukan penghilangan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
singleEntityValidation | boolean | ya | Apakah cakupan entitas tunggal dari aggrega validate — perintah yang diberi path satu dokumen — memeriksa dokumen dengan jenis ini. Jenis yang ditolaknya diperiksa oleh cakupan seluruh katalog atau oleh cakupan Release. |
publication | boolean | ya | Apakah aggrega/publishEntity yang hanya menyebutkan dokumen tersebut memublikasikan dokumen dengan jenis ini. Jenis yang publikasinya juga mengikat executable yang disebutkan di samping dokumen — sebuah Plugin — bernilai false, karena permintaan yang hanya menyebutkan dokumen ditolak untuknya; Manifest dan Release bernilai false karena kedua jenis itu tidak dipublikasikan. |
inspectionByName | boolean | ya | Apakah aggrega/entityDefinition me-resolve sebuah nama menjadi entitas dengan jenis ini, dengan nama dikirim sebagaimana ditulis di tempat satu entitas mereferensikan entitas lain. |
Properti tambahan tidak diizinkan.
RegistryTrust
Kebijakan kepercayaan yang diterapkan resolusi pada apa yang disajikan registry.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
signaturesRequired | boolean | ya | Apakah artefak dari registry ini harus membawa tanda tangan yang terverifikasi. |
verificationSkipped | boolean | tidak | Apakah verifikasi sedang dilewati. |
advisory | boolean | tidak | Apakah verifikasi yang gagal dilaporkan alih-alih menghentikan proses. |
anchor | string | tidak | Trust anchor yang menjadi acuan verifikasi tanda tangan. |
keylessIdentities | integer | tidak | Berapa banyak identitas penandatangan yang dipercaya untuk registry ini. |
Properti tambahan tidak diizinkan.
Registry
Satu registry yang dikonfigurasi. Tidak ada field di sini yang membawa materi kredensial, panjangnya, bentuknya, atau representasi apa pun darinya — keberadaan adalah satu-satunya hal yang dilaporkan, dan itulah yang membuat nilai ini aman untuk ditempelkan ke dalam sebuah issue.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
host | string | ya | Host registry, yang merupakan identitasnya. |
name | string | tidak | Alias ramah yang di-resolve ke host, jika dikonfigurasi. |
default | boolean | ya | Apakah ini registry yang dituju oleh operasi yang tidak menyebutkan registry. |
authState | string | ya | Apakah kredensial untuk host ini ada di penyimpanan seluruh mesin. Nilai ini dilaporkan meskipun kosong, sehingga pemanggil dapat membedakan “tidak ada kredensial” dari “listing tidak memeriksanya”. |
trust | RegistryTrust | ya | Kebijakan kepercayaan yang diterapkan resolusi pada apa yang disajikan registry. |
Properti tambahan tidak diizinkan.
TrustFetchOutcome
Apa hasil pembacaan kebijakan kepercayaan yang diumumkan sebuah registry. Hasil-hasil ini dipisahkan karena maknanya berbeda: kebijakan yang diumumkan diambil, registry tidak mengumumkan apa pun — yang bukan merupakan kegagalan — baseline bawaan dipasang sebagai gantinya, atau tidak ada pembacaan yang dicoba. Jika tidak ada yang diumumkan, apakah registry dapat dijangkau sama sekali dinyatakan di sampingnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
pinned | boolean | ya | Apakah kebijakan yang diumumkan diambil. |
notAdvertised | boolean | tidak | Apakah registry ditanya dan tidak mengumumkan kebijakan, sehingga operasi berlanjut berdasarkan apa yang dinyatakan permintaan. Registry yang tidak ditanya karena postur offline tidak pernah dilaporkan dengan cara ini. Registry yang tidak dapat dijangkau juga dilaporkan dengan cara ini, karena tidak ada kebijakan yang kembali darinya, dan membawa unreachable di sampingnya; baca unreachable untuk membedakan keduanya. |
unreachable | boolean | tidak | Apakah registry tidak dapat dijangkau saat kebijakan yang diumumkannya diminta: namanya tidak dapat di-resolve, koneksi ke sana ditolak atau tidak dapat dibuka, atau koneksi aman ke sana tidak dapat dibuat. Nilai ini dibaca dari kegagalan itu sendiri, bukan dari reason, berdiri di samping notAdvertised, dan hanya diatur jika kegagalan menunjukkan registry tidak pernah dijangkau; registry yang menjawab — tanpa kebijakan, atau dengan kegagalan — membiarkannya tidak ada. |
baseline | boolean | tidak | Apakah baseline bawaan dipasang karena tidak ada kebijakan yang diumumkan yang diambil, yang hanya dimiliki hub resmi. Nilai ini berdiri di samping notAdvertised jika hub ditanya dan tidak mengumumkan apa pun, dan sendirian jika postur offline mencegah hub ditanya. |
skipped | boolean | tidak | Apakah tidak ada pembacaan yang dicoba, karena kebijakan yang dinyatakan menggantikannya atau permintaan tidak memintanya. |
identities | integer | tidak | Berapa banyak identitas penandatangan yang dibawa kebijakan yang diumumkan. |
reason | string | tidak | Mengapa kebijakan yang diumumkan tidak diambil: apa yang dilakukan endpoint registry, atau penolakan offline yang mencegahnya ditanya. |
Properti tambahan tidak diizinkan.
SkippedRepo
Satu repositori yang dilewati oleh penelusuran indeks, beserta alasannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
repo | string | ya | Repositori yang dilewati. |
reason | string | ya | Mengapa dilewati. |
Properti tambahan tidak diizinkan.
DeprecationNote
Satu penanda deprecation yang ditemui penelusuran indeks, dan apa yang dilakukannya terhadap penanda itu. Penanda yang dihormati dan penanda yang ada tetapi ditolak dilaporkan dengan kedudukan yang sama, sehingga mencatat banyak penanda tidak berlalu diam-diam sementara menolak satu penanda justru mencolok.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
repo | string | ya | Repositori tempat penanda berada. |
version | string | ya | Versi yang dicakup penanda. |
recorded | boolean | ya | Apakah tanda tangan penanda itu sendiri terverifikasi, sehingga indeks membawanya. |
severity | const “warning” atau const “error” atau const “retracted” | tidak | Seberapa kuat penanda berbicara. Nilai yang diizinkan: "warning" — Di-deprecate, pada tingkat yang lebih ringan dari dua tingkat anjuran: tetap dipilih ketika versi dipilih. "error" — Di-deprecate, pada tingkat yang lebih kuat dari dua tingkat anjuran: tetap dipilih ketika versi dipilih. "retracted" — Ditarik: dikecualikan ketika versi dipilih. |
reason | string | tidak | Alasan versi tersebut usang. |
Properti tambahan tidak diizinkan.
HostUpdate
Apa yang dilakukan penyegaran indeks untuk satu registry.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
host | string | ya | Host registry yang disegarkan. |
indexed | integer | ya | Berapa banyak rekaman yang ditulis. |
deprecationsExamined | boolean | ya | Apakah penelusuran mencari penanda deprecation sama sekali. Nilai ini terpisah dari hitungan karena “registry ini tidak menerbitkan satu pun” dan “proses ini tidak punya dasar untuk menilainya” adalah fakta yang berbeda. |
deprecationsRecorded | integer | ya | Berapa banyak penanda yang dihormati. |
skipped | SkippedRepo[] atau null | ya | Repositori yang dilewati penelusuran. |
deprecations | DeprecationNote[] atau null | ya | Penanda yang ditemui penelusuran. |
readsRetried | integer | ya | Berapa banyak pembacaan dalam penelusuran yang ditolak atau diputus di tengah jalan oleh registry dan diminta ulang, dengan setiap pembacaan dihitung sekali berapa pun percobaan yang dibutuhkan dan terlepas dari apakah kemudian berhasil; nol jika tidak ada. Penelusuran yang semua pembacaannya pada akhirnya berhasil tidak mencantumkan repositori apa pun di bawah skipped, sehingga hitungan inilah yang menunjukkan seberapa dekat penelusuran itu dengan melewatkan satu repositori. Minimum: 0. |
error | string | tidak | Apa yang gagal untuk host ini, sehingga penelusuran atas beberapa host melaporkan mana yang gagal tanpa pemanggil perlu mengkorelasikan apa pun. |
unreachable | boolean | tidak | Apakah registry ini tidak dapat dijangkau: namanya tidak dapat di-resolve, koneksi ke sana ditolak atau tidak dapat dibuka, atau koneksi aman ke sana tidak dapat dibuat. Nilai ini dibaca dari kegagalan itu sendiri, bukan dari error, hanya diatur di samping error, dan hanya jika kegagalan menunjukkan registry tidak pernah dijangkau; registry yang menjawab, apa pun jawabannya, membiarkannya tidak ada. |
Properti tambahan tidak diizinkan.
PublishedVersion
Satu versi yang dimiliki indeks untuk sebuah referensi: digest manifest yang di-resolve dari tag-nya saat indeks dibangun; jika kebijakan kepercayaan yang digunakan saat indeks dibangun memverifikasi tanda tangan versi itu sendiri, penandatangan hasil verifikasinya; dan, jika ada yang mencatatnya, kapan versi itu diterbitkan, beserta sumber yang menyatakannya. Penandatangan tidak ada untuk versi tanpa tanda tangan, untuk versi yang tidak satu pun tanda tangannya terverifikasi, dan jika kebijakan itu tidak memasang kunci publik maupun identitas tepercaya atau menonaktifkan verifikasi tanda tangan. Tidak satu pun dari itu menjadi dasar untuk menyebut penandatangan, dan ketiadaannya tidak menyatakan apa pun lebih dari itu. Tanggal penerbitan tidak ada jika penerbitan tidak menyatakannya dan tidak ada tanda tangan keyless yang diverifikasi kebijakan itu yang mencatatnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
version | string | ya | Versi, sebagaimana dinamai tag-nya. |
manifestDigest | string | ya | Digest manifest yang di-resolve dari tag versi saat indeks dibangun, yang menunjuk versi berdasarkan byte yang dinamainya, bukan berdasarkan tag-nya. |
signer | VerifiedSignature | tidak | Tanda tangan yang terverifikasi terhadap kebijakan kepercayaan sebuah registry: bagaimana ia terverifikasi, penandatangan hasil verifikasinya, dan digest bundel tanda tangan yang terverifikasi. |
publishedAt | string | tidak | Kapan versi diterbitkan, sebagai stempel waktu RFC 3339 dalam UTC hingga detik. Asalnya adalah publishedAtSource, dan keduanya ada bersama-sama atau tidak sama sekali. |
publishedAtSource | const “transparency-log” atau const “publisher” | tidak | Asal publishedAt, agar waktu yang dibuktikan log transparansi tidak pernah dikira waktu yang dinyatakan penerbit. Himpunannya tertutup. Nilai yang diizinkan: "transparency-log" — Waktu log transparansi mencatat tanda tangan keyless versi tersebut, yang diverifikasi oleh kebijakan kepercayaan yang digunakan saat indeks dibangun bersama janji bertanda tangan log atas waktu tersebut. Untuk versi yang ditandatangani saat dipublikasikan, itulah waktu publikasinya; untuk versi yang ditandatangani kemudian, itulah waktu tanda tangan tersebut dibuat. "publisher" — Waktu yang dinyatakan publikasi di samping apa yang dipublikasikannya, dari jam mesin penerbit itu sendiri. Tidak ada yang membuktikannya. Publikasi menyatakannya ketika tanda tangannya tidak membawa waktu yang dibuktikan: tanda tangan berkunci, atau tanpa tanda tangan. Jika beberapa dilampirkan, yang paling awal diambil. |
Properti tambahan tidak diizinkan.
VerifiedSignature
Tanda tangan yang terverifikasi terhadap kebijakan kepercayaan sebuah registry: bagaimana ia terverifikasi, penandatangan hasil verifikasinya, dan digest bundel tanda tangan yang terverifikasi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
bundleDigest | string | ya | Digest bundel tanda tangan yang terverifikasi, sebagai sha256: diikuti 64 karakter heksadesimal huruf kecil. |
identity | string | tidak | Penandatangan hasil verifikasi tanda tangan: untuk tanda tangan keyless, identitas yang menjadi tujuan penerbitan sertifikat penandatanganan, yaitu subject alternative name-nya; untuk tanda tangan keyed, keyed:sha256: diikuti SHA-256 heksadesimal huruf kecil dari teks PEM kunci publik yang dipasang. |
issuer | string | tidak | Penerbit OIDC yang tercatat dalam sertifikat penandatanganan, untuk tanda tangan keyless. Tidak ada untuk tanda tangan keyed. |
mode | const “keyless” atau const “keyed” | ya | Cara tanda tangan diverifikasi. Himpunannya tertutup. Nilai yang diizinkan: "keyless" — Terhadap sertifikat penandatanganan yang identitas dan penerbitnya cocok dengan yang dipercaya kebijakan, yang berantai ke root kepercayaan yang disematkan kebijakan atau, jika kebijakan tidak menyematkan satu pun, ke root Sigstore publik, dan yang tanda tangannya dicatat oleh log transparansi. "keyed" — Terhadap kunci publik yang disematkan kebijakan. |
Properti tambahan tidak diizinkan.
RegistrySearchRecord
Satu rekaman yang cocok dengan pencarian, sebagaimana disimpan indeks lokal, ditambah versi-versinya yang telah di-deprecate oleh penanda yang diterbitkan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
uri | string | ya | Referensi asal rekaman di-resolve. |
name | string | ya | Nama entitas. |
version | string | ya | Versi yang menjadi kunci rekaman. |
versions | string[] | tidak | Setiap versi yang dimiliki indeks untuk referensi ini. |
kind | string | tidak | Jenis entitas. |
description | string | tidak | Kegunaan entitas. |
category | string | tidak | Kategori tempat entitas diterbitkan. |
labels | map of string | tidak | Label yang dideklarasikan entitas. |
pluginType | string | tidak | Socket tempat rekaman plugin terpasang. |
capabilities | string[] | tidak | Kapabilitas yang dideklarasikan rekaman plugin. |
manifestDigest | string | tidak | Digest manifest yang diterbitkan. |
listingDigest | string | tidak | Digest daftar tempat rekaman dibaca. |
deprecations | object[] | tidak | Penanda deprecation yang dibawa indeks untuk referensi ini, masing-masing dengan versi yang dicakupnya dan penanda terverifikasi itu sendiri. |
published | PublishedVersion[] | tidak | Setiap versi yang dimiliki indeks untuk referensi ini, dalam urutan yang sama dengan versions, masing-masing dengan digest manifest yang di-resolve dari tag-nya saat indeks dibangun, penandatangan terverifikasinya jika kebijakan kepercayaan yang digunakan saat indeks dibangun memverifikasi tanda tangan versi itu sendiri, serta tanggal penerbitan dan sumber tanggal itu jika ada yang mencatatnya. Versi yang tercatat tanpa penandatangan tidak membawa tanda tangan yang diverifikasi kebijakan itu, dan tidak ada hal lain yang dinyatakan tentangnya. Hanya manifest, lampiran tanda tangan, dan lampiran tanggal penerbitan yang dibaca dari registry untuk mencatat ini; konten entitas tidak diambil. |
retracted | string[] | tidak | Versi yang telah di-deprecate oleh penanda yang diterbitkan. |
Properti tambahan tidak diizinkan.
RegistrySearchIndex
Kebaruan satu host yang dicari.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
host | string | ya | Host yang indeksnya dicari. |
lastUpdated | string | tidak | Kapan indeks terakhir diperbarui. Nilai ini tidak ada, alih-alih nol, ketika snapshot tidak membawa waktu, sehingga pemanggil dapat membedakan “tidak tercatat” dari epoch. |
Properti tambahan tidak diizinkan.
EffectiveConfigurationSetting
Satu pengaturan yang telah di-resolve, dan dokumen asalnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
field | string | ya | Pengaturan tersebut. |
value | string | ya | Nilai yang di-resolve. |
source | string | ya | Asal nilai tersebut. |
Properti tambahan tidak diizinkan.
ImportedFile
Satu file yang ditulis oleh impor: dokumen draf, atau catatan tentang apa yang ditulis impor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path | string | ya | Lokasi file, sebagai path relatif terhadap outputDir jawaban. |
content | string | ya | Teks file. |
Properti tambahan tidak diizinkan.
ImportDrift
Satu bagian yang disinkronkan dengan sumber oleh sinkronisasi, atau yang akan disinkronkan di bawah dryRun.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
change | string | ya | Bagaimana bagian tersebut menyimpang: added, untuk bagian yang ditambahkan sumber; removed, untuk bagian yang dihapusnya; atau changed, untuk bagian yang diubahnya. |
file | string | ya | File draf tempat bagian tersebut berada, sebagai path relatif terhadap outputDir jawaban. |
key | string[] | ya | Kunci-kunci yang mengarah ke bagian tersebut dari puncak Aggregate atau Release draf, satu entri per kunci, sehingga kunci yang memuat titik tetap menjadi satu entri. Kosong jika bagian tersebut adalah seluruh file. |
Properti tambahan tidak diizinkan.
ImportOwed
Satu nilai yang masih dibiarkan kosong oleh draf, yang tidak dapat disediakan oleh sumber mana pun dan tidak disediakan oleh jawaban mana pun.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
file | string | ya | File draf tempat nilai tersebut berada, sebagai path relatif terhadap outputDir jawaban. |
key | string[] | ya | Kunci-kunci yang mengarah ke nilai dari bagian atas dokumen tersebut, satu entri per kunci, sehingga kunci yang memuat titik tetap menjadi satu entri. Jawaban yang dikirim sebagai answered menyebutkan nilai dengan kunci-kunci ini. |
question | string | ya | Apa nilai itu: deskripsi skemanya, atau jika tidak ada, komentar yang ditulis draf di atas kuncinya, atau jika tidak ada, apa yang menurut skemanya diterima. |
sensitive | boolean | ya | Apakah nilai itu milik sebuah secret, yang jawabannya menyebutkan asal secret tersebut dan tidak pernah memuat secret itu sendiri. |
secretAdvice | string | tidak | Ada pada nilai sebuah secret: apa yang harus menjadi jawabannya, dalam kalimat yang ditampilkan kepada orang yang menjawabnya di terminal — atau, jika jawaban yang dikirim untuknya sebagai answered ditolak, mengapa jawaban itu ditolak. |
Properti tambahan tidak diizinkan.
ImportAnswered
Satu jawaban untuk nilai yang didaftarkan oleh owed jawaban.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
file | string | ya | File draf tempat nilai tersebut berada, sebagaimana owed menyebutkannya. |
key | string[] | ya | Kunci-kunci yang mengarah ke nilai, sebagaimana owed menyebutkannya. |
answer | string | ya | Jawabannya. Jawaban kosong membiarkan nilai tetap terutang. |
Properti tambahan tidak diizinkan.
ImportDiagnostic
Satu hal yang tidak dapat dikonversi oleh konversi. Ini adalah keluaran konversi yang paling berguna, sehingga dilaporkan secara lengkap alih-alih diringkas menjadi satu putusan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
severity | string | ya | Tingkat keseriusannya. |
message | string | ya | Apa yang tidak dapat dikonversi. |
code | string | tidak | Nama kondisi yang dapat dikutip, jika ada. |
Properti tambahan tidak diizinkan.
ImportDecision
Bagaimana konversi memetakan satu node sumber: Components katalog yang dipertimbangkan importer, yang dipilihnya, alasannya, dan cara menukar pilihan tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
sourceNode | DecisionSourceNode | ya | Node sumber yang menjadi pokok keputusan pemetaan. |
candidates | ImportCandidate[] | tidak | Components katalog yang dipertimbangkan importer untuk node tersebut, masing-masing dengan skornya. Tidak ada jika importer tidak mempertimbangkan satu pun. |
chosen | DecisionChoice | tidak | Apa yang dipilih importer untuk sebuah node sumber. Tidak ada dalam keputusan yang tidak menghasilkan pilihan. |
rationale | string | tidak | Alasan importer membuat pilihan tersebut, dengan kata-katanya sendiri. Tidak ada jika importer tidak menuliskannya. |
swapHint | string | tidak | Cara menukar pilihan dengan alternatif, dengan kata-kata importer sendiri. Tidak ada jika importer tidak menuliskannya. |
Properti tambahan tidak diizinkan.
DecisionSourceNode
Node sumber yang menjadi pokok keputusan pemetaan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
id | string | ya | Pengenal node di sumber. |
type | string | ya | Jenis node, sebagaimana dinamai sumber. |
paramsSummary | string | ya | Ringkasan parameter node, untuk ditampilkan di samping keputusan. |
Properti tambahan tidak diizinkan.
ImportCandidate
Satu Component katalog yang dipertimbangkan importer untuk sebuah node sumber.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
componentName | string | ya | Nama Component. |
score | number | ya | Seberapa cocok Component dengan node, menurut skor importer. |
tier | string | ya | Tingkat kecocokan tempat skor tersebut berada. |
signals | CandidateSignals | ya | Kontribusi setiap sinyal importer terhadap skor kandidat. |
Properti tambahan tidak diizinkan.
CandidateSignals
Kontribusi setiap sinyal importer terhadap skor kandidat.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
table | number | ya | Kontribusi sinyal tabel pemetaan. |
category | number | ya | Kontribusi sinyal kategori. |
domainLabels | number | ya | Kontribusi sinyal label domain. |
shape | number | ya | Kontribusi sinyal bentuk. |
name | number | ya | Kontribusi sinyal nama. |
Properti tambahan tidak diizinkan.
DecisionChoice
Apa yang dipilih importer untuk sebuah node sumber. Tidak ada dalam keputusan yang tidak menghasilkan pilihan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
target | string | ya | Nama Component yang dipilih: Component katalog yang sudah ada, atau yang didraf untuk node tersebut. |
mode | string | ya | Cara pilihan ditulis: sebagai referensi ke Component yang sudah ada, atau sebagai Component yang baru didraf. |
tier | string | ya | Tingkat kecocokan pilihan. |
Properti tambahan tidak diizinkan.
LintFileFindings
Apa yang ditemukan pemeriksaan konvensi dalam satu dokumen.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
file | string | ya | Dokumen tersebut. |
diagnostics | Diagnostic[] atau null | ya | Temuan di dalamnya. |
Properti tambahan tidak diizinkan.
PluginRetractionExclusion
Satu versi yang tersedia tetapi tidak dipilih.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
version | string | ya | Versi yang dilewati. |
reason | string | tidak | Mengapa dilewati. |
Properti tambahan tidak diizinkan.
PluginRetractionProvenance
Asal pengetahuan tentang apa yang usang.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
source | string | ya | Apa yang dirujuk. |
lastUpdated | string | tidak | Kapan itu terakhir diperbarui. |
Properti tambahan tidak diizinkan.
PluginRetraction
Bagaimana penanda deprecation memengaruhi versi plugin yang di-pin.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
reference | string | ya | Referensi pemilik versi-versi tersebut. |
selected | string | tidak | Versi yang di-pin. |
excluded | PluginRetractionExclusion[] | tidak | Versi-versi yang tersedia dan dilewati. |
unscreened | string | tidak | Apa yang tidak dapat disaring terhadap penanda, dan alasannya. |
provenance | PluginRetractionProvenance | tidak | Asal pengetahuan tentang apa yang usang. |
Properti tambahan tidak diizinkan.
PluginGeneratedDocument
Satu dokumen katalog yang dihasilkan oleh pembangkitan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path | string | ya | Lokasi dokumen, sebagai path relatif terhadap root workspace. |
content | string | ya | Teks dokumen. |
Properti tambahan tidak diizinkan.
PluginCommandFlag
Satu flag yang dideklarasikan plugin pada perintah yang disumbangkannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Nama panjang flag. |
shorthand | string | tidak | Alias satu karakter flag, jika ada. |
description | string | tidak | Teks bantuan satu baris flag. |
type | string | tidak | Jenis nilai flag. |
default | string | tidak | Nilai yang digunakan ketika flag tidak diberikan. |
Properti tambahan tidak diizinkan.
PluginCLICommand
Satu verba perintah tingkat atas yang disumbangkan plugin.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Verba perintah. |
description | string | tidak | Teks bantuan satu baris perintah. |
flags | PluginCommandFlag[] | tidak | Flag-flag perintah, dalam urutan deklarasi. |
Properti tambahan tidak diizinkan.
ConfigCapturedAttachment
Satu attachment yang ditulis pembekuan ke dalam konfigurasi workspace ini sendiri.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
uri | string | tidak | Referensi tempat attachment di-resolve. |
capability | string | tidak | Kapabilitas yang dilayani attachment. |
function | string | tidak | Export tempat attachment diteruskan. |
role | string | tidak | Peran tempat pemasangan dijalankan, yang menentukan apa yang boleh dihasilkannya. |
Properti tambahan tidak diizinkan.
ConfigCapturedSocket
Satu socket yang ditulis pembekuan, beserta attachment yang dibekukan padanya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
socket | string | ya | Socket tersebut. |
field | string | ya | Field konfigurasi tempat socket ditulis. |
attachments | ConfigCapturedAttachment[] atau null | ya | Attachment yang dibekukan padanya. |
Properti tambahan tidak diizinkan.
ExplainErrorEntry
Satu bagian terpublikasi yang mengajarkan perbaikan penulisan untuk sebuah kondisi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
heading | string | ya | Judul bagian tersebut. |
body | string | ya | Bagian tersebut. |
Properti tambahan tidak diizinkan.
SignedArtifact
Satu artefak terpublikasi yang dicakup oleh penandatanganan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
reference | string | ya | Referensi yang ditandatangani. |
digest | string | ya | Digest dari apa yang ditandatangani. |
Properti tambahan tidak diizinkan.
DeprecationMarked
Satu versi terpublikasi yang ditandai oleh deprecation.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
reference | string | ya | Referensi yang ditandai. |
severity | const “warning” atau const “error” atau const “retracted” | ya | Seberapa kuat penanda berbicara. Nilai yang diizinkan: "warning" — Di-deprecate, pada tingkat yang lebih ringan dari dua tingkat anjuran: tetap dipilih ketika versi dipilih. "error" — Di-deprecate, pada tingkat yang lebih kuat dari dua tingkat anjuran: tetap dipilih ketika versi dipilih. "retracted" — Ditarik: dikecualikan ketika versi dipilih. |
issuedOn | string | ya | Kapan penanda diterbitkan. |
digest | string | ya | Digest penanda yang dipublikasikan. |
Properti tambahan tidak diizinkan.
InitializeResult
Apa yang ditetapkan sesi untuk klien ini, dan dari lapisan konfigurasi mana hal itu di-resolve.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
capabilities | ServerCapabilities | ya | Apa yang akan dilakukan daemon dalam sesi ini, yang disepakati berdasarkan apa yang dinyatakan klien dapat ditanganinya. |
workspaceRoot | string | ya | Workspace tempat sesi dibuka. |
configSource | string | ya | Lapisan konfigurasi tempat sesi me-resolve pengaturannya. |
workspaceMarker | string | tidak | File yang mengidentifikasi root workspace, jika ada. |
version | string | ya | Versi biner yang menjawab sesi ini: nilai yang sama dengan yang dilaporkan aggrega version untuk biner tersebut. Nilai ini menggambarkan proses yang sedang berjalan, sehingga setelah file tempat daemon dijalankan diganti, nilai ini tetap menyebut versi yang sedang berjalan, sedangkan menanyakan file tersebut akan menyebut versi yang menggantikannya. |
Properti tambahan tidak diizinkan.
ValidateResult
Apa yang ditemukan pemeriksaan, dan seberapa banyak yang diperiksa.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
diagnostics | Diagnostic[] atau null | ya | Temuan. Nilainya null, bukan daftar kosong, jika pemeriksaan tidak menemukan apa pun. |
checked | string | tidak | Seberapa banyak yang diperiksa — satu dokumen, atau isi workspace. |
Properti tambahan tidak diizinkan.
InvalidateResult
Apakah daemon menyimpan sesuatu tentang dokumen tersebut untuk dibuang.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
invalidated | boolean | ya | Apakah ada yang dibuang. |
Properti tambahan tidak diizinkan.
DiagnosticsResult
Temuan yang sudah disimpan daemon untuk dokumen tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
diagnostics | Diagnostic[] atau null | ya | Temuan. Nilainya null, bukan daftar kosong, jika tidak ada temuan. |
Properti tambahan tidak diizinkan.
IrGraphResult
Graf ter-resolve yang menjadi hasil kompilasi sebuah Release.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
graph | any | ya | Dokumen graf. Nilai yang dinyatakan sensitif oleh penulis tidak disertakan di dalamnya kecuali permintaan memintanya dengan unredacted; semua hal lain diteruskan sebagaimana dikeluarkan compiler. Bentuknya sendiri merupakan kontrak graf yang dipublikasikan dan tidak diulang di sini. |
Properti tambahan tidak diizinkan.
BuildResult
Apa yang ditulis oleh build.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
outputDirectory | string | ya | Direktori tempat artefak ditulis. |
files | string[] atau null | ya | Artefak yang ditulis, sebagai path relatif terhadap direktori output. |
notices | BuildNotice[] | tidak | Apa pun yang ingin disampaikan build kepada pemanggil yang bukan temuan maupun kegagalan. |
dependencyResolution | DependencyResolutionReport | tidak | Apa yang di-pin dan diperoleh oleh sebuah resolusi dependensi. |
Properti tambahan tidak diizinkan.
BuildPreviewResult
Apa yang akan ditulis oleh build. Tidak ada yang ditulis, sehingga tidak ada direktori output yang disebutkan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
files | string[] atau null | ya | Artefak yang akan dihasilkan jika penulisan dilakukan. |
notices | BuildNotice[] | tidak | Apa pun yang ingin disampaikan kompilasi kepada pemanggil yang bukan temuan maupun kegagalan. |
Properti tambahan tidak diizinkan.
EntityDefinitionResult
Hasil resolve sebuah nama entitas, dan dokumen yang mendefinisikannya. Jawaban yang dibaca dari referensi registry membawa published, sedangkan jawaban yang di-resolve katalog berdasarkan nama tidak pernah membawanya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | ya | Jenis entitas. |
name | string | ya | Nama entitas. |
version | string | ya | Versi yang di-resolve. |
description | string | tidak | Kegunaan entitas menurut dokumen. |
publishScope | string | tidak | Seberapa luas entitas dipublikasikan. |
file | string | ya | Dokumen yang mendefinisikannya. |
authoredLength | integer | ya | Jumlah byte dokumen yang ditulis penulis, sehingga klien dapat membedakan dokumen yang ditulis penulis dari rendering ter-resolve dokumen tersebut. |
definition | string | ya | Teks definisi. |
published | PublishedArtifact | tidak | Apa yang dibaca sebuah referensi registry: koordinat, cara koordinat itu menyimpan entitas, dan manifest yang digunakan untuk membacanya. Setiap field ada di mana pun objek ini ada. |
Properti tambahan tidak diizinkan.
PublishedArtifact
Apa yang dibaca sebuah referensi registry: koordinat, cara koordinat itu menyimpan entitas, dan manifest yang digunakan untuk membacanya. Setiap field ada di mana pun objek ini ada.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
reference | string | ya | Referensi registry yang dibaca. |
archive | boolean | ya | Apakah byte koordinat berupa arsip tempat dokumen entitas diekstrak. False jika koordinat menyimpan dokumen entitas itu sendiri. |
mediaType | string | ya | Jenis artefak yang dideklarasikan manifest. |
manifestDigest | string | ya | Digest manifest yang digunakan untuk membaca entitas — nilai yang disebutkan setelah @ untuk membaca byte yang sama persis lagi. |
Properti tambahan tidak diizinkan.
ReleaseClosureResult
Semua hal yang menjadi dependensi sebuah Release, sebagaimana dicapai oleh resolusi. Objek ini melaporkan closure, bukan graf yang diturunkan darinya: dokumen yang berbeda tentang Release yang sama.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
release | string | ya | Release yang diperiksa. |
aggregate | string | ya | Aggregate yang di-deploy-nya. |
manifest | string | ya | Manifest yang digunakannya untuk resolve. |
environment | string | ya | Lingkungan yang disebutkannya. |
entities | ClosureEntity[] atau null | ya | Entitas yang dicapai closure. |
libraries | ClosureEntity[] atau null | ya | Library yang dicapai closure. |
plugins | ClosureEntity[] atau null | ya | Plugin yang dicapai closure. |
mappingDiagnostics | string[] atau null | ya | Apa yang disampaikan oleh resolusi mapping Manifest. |
deprecations | string[] atau null | ya | Penanda deprecation yang ditemui closure. |
Properti tambahan tidak diizinkan.
ResolveDependenciesResult
Apa yang di-pin dan diperoleh oleh resolusi dependensi, ditambah apa pun yang ingin disampaikannya kepada pemanggil. Field laporan dibawa langsung pada jawaban ini, bukan disarangkan di bawah salah satu anggotanya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
lockfile | string | ya | Lockfile yang ditulis resolusi, atau lockfile yang dibandingkan oleh verifikasi. |
verified | boolean | tidak | Apakah permintaan berupa verifikasi, yang membandingkan lockfile tercatat dan tidak menulis lockfile, catatan kepercayaan plugin, maupun entity.lock. |
entities | ClosureEntity[] atau null | ya | Entitas yang di-pin oleh resolusi, atau dibandingkan oleh verifikasi. |
libraries | ClosureEntity[] atau null | ya | Pustaka yang di-pin oleh resolusi, atau dibandingkan oleh verifikasi. |
plugins | ClosureEntity[] atau null | ya | Plugin yang di-pin oleh resolusi, atau dibandingkan oleh verifikasi. |
sourceArtifacts | integer | ya | Jumlah artefak sumber yang diperoleh. |
trustedPlugins | integer | ya | Jumlah plugin yang di-pin yang membawa tanda tangan terverifikasi. |
toolchain | ToolchainReport | tidak | Compiler yang melakukan resolusi, beserta plugin yang dibawanya. |
externalInputs | integer | ya | Jumlah input eksternal yang dikonsumsi render yang berhasil diperoleh. |
incompleteExternalInputs | string | tidak | Input eksternal mana yang tidak dapat diperoleh, jika ada yang tidak dapat diperoleh. |
notices | string[] | tidak | Apa pun yang ingin disampaikan resolusi kepada pemanggil. |
Properti tambahan tidak diizinkan.
PinResult
Apa yang dilakukan langkah pin terhadap lock di samping sebuah entitas, atau yang akan dilakukannya pada dry run. Ini adalah jawaban untuk aggrega/pin, dan publikasi yang menjalankan langkah ini membawanya sebagai pin.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
entity | string | ya | Dokumen entitas yang dibaca langkah ini, sebagai path relatif terhadap root workspace. |
kind | string | ya | Jenis entitas, sebagaimana dideklarasikan dokumennya. |
name | string | ya | Nama entitas, sebagaimana dideklarasikan dokumennya. |
pinnable | boolean | ya | Apakah entitas dengan jenis ini membaca sesuatu yang pin-nya dicatat oleh lock, seperti Recipe dan FeatureRecipe. Jika false, tidak ada yang disentuh di samping entitas, changed bernilai false, dan lock, removed, pins serta content tidak ada. |
lock | string | tidak | Lock yang ditulis, atau akan ditulis, oleh langkah ini, sebagai path relatif terhadap root workspace. |
changed | boolean | ya | Apakah lock berubah, atau akan berubah pada dry run. False jika lock sudah mencatat setiap pin yang dibutuhkan entitas dan dibiarkan identik per byte. |
removed | boolean | tidak | Apakah perubahan tersebut berupa penghapusan: entitas tidak membaca apa pun yang pin-nya dicatat oleh lock, sehingga tidak ada lock yang tersisa di sampingnya. |
dryRun | boolean | tidak | Apakah objek ini melaporkan apa yang akan dilakukan langkah ini, bukan apa yang telah dilakukannya. |
pins | PinClassCount[] | tidak | Jumlah pin setiap kelas yang disimpan lock setelah langkah ini, atau yang akan disimpan setelah dry run. Setiap kelas yang dapat disimpan lock dicantumkan, termasuk kelas tanpa pin. |
content | string | tidak | Lock yang akan ditulis dry run. Tidak ada jika lock akan dibiarkan apa adanya atau dihapus, dan pada setiap jawaban yang bukan dry run. |
Properti tambahan tidak diizinkan.
PinClassCount
Jumlah pin satu kelas yang disimpan sebuah lock.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
class | string | ya | Kelas pin, dengan kata-kata yang digunakan penolakan yang menyebut pin yang hilang — misalnya remote source atau imported file. |
pins | integer | ya | Jumlah pin kelas tersebut yang disimpan lock. |
Properti tambahan tidak diizinkan.
CacheStatusResult
Isi cache yang melayani workspace ini.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
classes | CacheClass[] atau null | ya | Setiap cache dan isinya. |
provenance | CacheProvenance[] atau null | ya | Identitas yang digunakan saat artefak dalam cache diperoleh. |
totalCount | integer | ya | Jumlah total entri yang disimpan cache. |
totalSize | integer | ya | Jumlah total byte yang ditempatinya. |
totalSizeText | string | ya | Total yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
scope | CacheScope | ya | Seberapa jauh jangkauan sebuah jawaban cache. Dua kelas cache digunakan bersama oleh setiap proyek di mesin, sehingga setiap jawaban cache menyebutkan kelas mana yang disentuhnya — jika tidak, sesi yang dibuka atas satu workspace akan dibaca seolah hanya melaporkan tentang workspace tersebut. |
Properti tambahan tidak diizinkan.
CachePruneResult
Apa yang dihapus oleh reklamasi, apa yang dipertahankan, dan apa yang tidak dapat direklamasi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
removed | CacheRemoval[] atau null | ya | Apa yang dihapus. |
heldOpen | CacheRemoval[] atau null | ya | Apa yang akan dihapus oleh prune tetapi dibiarkan di tempatnya karena proses lain sedang membukanya. Hanya Windows yang menolak menghapus file yang sedang terbuka, sehingga di sistem lain nilai ini kosong. Entri-entri ini tidak dihitung sebagai dihapus maupun dipertahankan, tidak ada byte-nya yang dihitung sebagai direklamasi, dan prune berikutnya akan mereklamasinya; entri yang berupa direktori mungkin sudah kehilangan file di dalamnya yang tidak sedang terbuka. |
retainedCount | integer | ya | Jumlah entri yang dipertahankan. |
reclaimedBytes | integer | ya | Jumlah byte yang direklamasi. |
reclaimedBytesText | string | ya | Angka yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
unattributedCount | integer | ya | Jumlah entri yang tidak diklaim oleh pemegang mana pun. |
unattributedSize | integer | ya | Jumlah byte yang ditempati entri tersebut. |
unattributedSizeText | string | ya | Angka yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
notPruneEligible | CacheShortfall[] atau null | ya | Apa yang tertinggal, dan apa yang dapat mereklamasinya. |
scope | CacheScope | ya | Seberapa jauh jangkauan sebuah jawaban cache. Dua kelas cache digunakan bersama oleh setiap proyek di mesin, sehingga setiap jawaban cache menyebutkan kelas mana yang disentuhnya — jika tidak, sesi yang dibuka atas satu workspace akan dibaca seolah hanya melaporkan tentang workspace tersebut. |
Properti tambahan tidak diizinkan.
CacheEvictResult
Apa yang dihapus oleh reklamasi hingga ukuran tertentu, dan apa yang tersisa.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
withinCapBefore | boolean | ya | Apakah isi yang disimpan sudah muat di bawah ukuran tersebut, sehingga tidak ada yang perlu dihapus. |
removed | CacheRemoval[] atau null | ya | Apa yang dihapus. |
heldOpen | CacheRemoval[] atau null | ya | Apa yang akan dihapus oleh reklamasi tetapi dibiarkan di tempatnya karena proses lain sedang membukanya; reklamasi beralih ke entri tertua berikutnya sebagai gantinya. Hanya Windows yang menolak menghapus file yang sedang terbuka, sehingga di sistem lain nilai ini kosong. Entri-entri ini tetap dihitung dalam byte yang tersisa, dan reklamasi berikutnya dapat menghapusnya. |
totalBefore | integer | ya | Jumlah byte yang disimpan sebelumnya. |
totalBeforeText | string | ya | Angka yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
reclaimedBytes | integer | ya | Jumlah byte yang direklamasi. |
reclaimedBytesText | string | ya | Angka yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
remainingBytes | integer | ya | Jumlah byte yang tersisa. |
remainingBytesText | string | ya | Angka yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
capBytes | integer | ya | Ukuran target reklamasi, dalam byte. |
capBytesText | string | ya | Ukuran yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
scope | CacheScope | ya | Seberapa jauh jangkauan sebuah jawaban cache. Dua kelas cache digunakan bersama oleh setiap proyek di mesin, sehingga setiap jawaban cache menyebutkan kelas mana yang disentuhnya — jika tidak, sesi yang dibuka atas satu workspace akan dibaca seolah hanya melaporkan tentang workspace tersebut. |
Properti tambahan tidak diizinkan.
CacheClearResult
Apa yang direklamasi dengan mengosongkan cache.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
cleared | CacheCleared[] atau null | ya | Setiap cache yang dikosongkan. |
reclaimedBytes | integer | ya | Jumlah byte yang direklamasi. |
reclaimedBytesText | string | ya | Angka yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
scope | CacheScope | ya | Seberapa jauh jangkauan sebuah jawaban cache. Dua kelas cache digunakan bersama oleh setiap proyek di mesin, sehingga setiap jawaban cache menyebutkan kelas mana yang disentuhnya — jika tidak, sesi yang dibuka atas satu workspace akan dibaca seolah hanya melaporkan tentang workspace tersebut. |
Properti tambahan tidak diizinkan.
RegistryListResult
Registry yang digunakan workspace ini untuk resolusi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
registries | Registry[] atau null | ya | Setiap registry yang dikonfigurasi. |
credentialStateIsMachineWide | boolean | ya | Apakah keberadaan kredensial yang dilaporkan untuk setiap registry merupakan fakta yang berlaku di seluruh mesin, bukan hanya di workspace. Ini dilaporkan agar jawaban yang berlingkup sesi tidak dibaca sebagai menyangkal jangkauan yang lebih luas. |
Properti tambahan tidak diizinkan.
SearchResult
Apa yang ditawarkan indeks registry lokal untuk pencarian ini.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
records | RegistrySearchRecord[] atau null | ya | Catatan yang cocok. |
indexes | RegistrySearchIndex[] atau null | ya | Setiap host yang dicari dan kapan indeksnya terakhir diperbarui. |
missingIndexHosts | string[] atau null | ya | Host yang dikonfigurasi tetapi tidak memiliki indeks lokal untuk dicari, sehingga jawaban yang pendek dijelaskan alih-alih dibiarkan untuk disimpulkan. |
stale | boolean | ya | Apakah ada indeks yang dicari yang sudah cukup lama sehingga layak diperbarui. |
registriesConfigured | boolean | ya | Apakah ada registry yang dikonfigurasi sama sekali, yang membedakan “tidak ada yang cocok” dari “tidak ada yang dicari”. |
Properti tambahan tidak diizinkan.
RegistryAddResult
Apa yang ditulis oleh pendaftaran registry, di mana, dan apa yang dibacanya dari registry itu sendiri.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
host | string | ya | Host yang menjadi kunci entri, yang tidak selalu sama dengan ejaan yang digunakan permintaan. |
scope | ConfigWriteScope | ya | Dokumen konfigurasi mana yang ditulis dan seberapa jauh jangkauannya. Sebuah permintaan menyebut satu workspace, sehingga jawaban yang tidak menyebutkan apa pun akan dibaca sebagai jawaban tentang workspace tersebut — dan untuk penulisan tingkat mesin, pembacaan itu keliru. |
trust | TrustFetchOutcome | ya | Apa hasil pembacaan kebijakan kepercayaan yang diumumkan sebuah registry. Hasil-hasil ini dipisahkan karena maknanya berbeda: kebijakan yang diumumkan diambil, registry tidak mengumumkan apa pun — yang bukan merupakan kegagalan — baseline bawaan dipasang sebagai gantinya, atau tidak ada pembacaan yang dicoba. Jika tidak ada yang diumumkan, apakah registry dapat dijangkau sama sekali dinyatakan di sampingnya. |
Properti tambahan tidak diizinkan.
RegistryRemoveResult
Apa yang ditulis oleh penghapusan registry, dan di mana.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
host | string | ya | Host yang entrinya dihapus. |
scope | ConfigWriteScope | ya | Dokumen konfigurasi mana yang ditulis dan seberapa jauh jangkauannya. Sebuah permintaan menyebut satu workspace, sehingga jawaban yang tidak menyebutkan apa pun akan dibaca sebagai jawaban tentang workspace tersebut — dan untuk penulisan tingkat mesin, pembacaan itu keliru. |
Properti tambahan tidak diizinkan.
RegistryUpdateResult
Apa yang dilakukan pembaruan indeks lokal, per host.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
hosts | HostUpdate[] atau null | ya | Apa yang dilakukan pembaruan untuk setiap host. |
failed | string[] atau null | ya | Host yang pembaruannya tidak dapat diselesaikan. |
indexRoot | string | ya | Direktori tempat indeks ditulis. |
registriesConfigured | boolean | ya | Apakah ada registry yang dikonfigurasi sama sekali. |
reachedRegistries | boolean | ya | Selalu true pada jawaban ini: pembaruan indeks menghubungi registry itu sendiri, sedangkan pencantuman dan pencarian registry dijawab dari konfigurasi dan dari indeks lokal. Apakah suatu registry benar-benar terjangkau dinyatakan pada entrinya sendiri di hosts, melalui unreachable. |
Properti tambahan tidak diizinkan.
LogoutResult
Kredensial tersimpan mana yang dihapus, dan seberapa jauh jangkauan penyimpanannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
registry | string | ya | Registry yang kredensialnya dihapus. |
scope | CredentialStoreScope | ya | Seberapa jauh jangkauan perubahan kredensial. Penyimpanan digunakan bersama oleh setiap proyek di mesin dan oleh setiap alat lain yang mengakses registry yang sama, sehingga jawaban melaporkan hal itu alih-alih membiarkan pembacaan seolah terbatas pada sesi untuk diduga. |
Properti tambahan tidak diizinkan.
PublishEntityResult
Apa yang dihasilkan oleh publikasi sebuah entitas, dan di mana. Publikasi yang menjalankan langkah pin terlebih dahulu juga membawa apa yang dilakukan langkah tersebut, sebagai pin, yang tidak ada jika langkah itu tidak dijalankan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
reference | string | ya | Referensi tempat entitas dipublikasikan. |
tag | string | ya | Tag tempat entitas dipublikasikan. |
kind | string | ya | Jenis entitas yang dipublikasikan. |
mediaType | string | ya | Media type yang dicatat untuk byte yang dipublikasikan. |
size | integer | ya | Jumlah byte yang dipublikasikan. |
sizeText | string | ya | Ukuran yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
pluginSize | integer | tidak | Jumlah byte yang ditempati modul plugin yang dipublikasikan bersama entitas Plugin. |
pluginSizeText | string | tidak | Ukuran yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
digest | string | ya | Digest dari apa yang dipublikasikan. Pada dry run, digest yang akan dihasilkan oleh publikasi konten yang sama, dihitung dari konten saja: digest yang dicetak oleh aggrega push --dry-run. |
signed | boolean | ya | Apakah publikasi ini melampirkan tanda tangan: tanda tangan yang dibuatnya sebelum memublikasikan, atau, pada versi yang sudah dipublikasikan, tanda tangan yang belum dimiliki versi tersebut. |
alreadyPublished | boolean | ya | Apakah byte yang sama sudah ada di sana, sehingga tidak ada konten yang diunggah. Hanya apa yang masih belum dimiliki publikasi tersebut yang dilampirkan di sampingnya: tanggal publikasinya dan, jika publikasi ini menandatangani, tanda tangannya; signed menyatakan apakah tanda tangan dilampirkan. |
dryRun | boolean | ya | Apakah ini melaporkan apa yang akan dihasilkan publikasi, bukan apa yang telah dilakukannya. |
reach | PublicationReach | ya | Seberapa jauh sebuah publikasi menjangkau. Jawaban ini menjangkau sepenuhnya melampaui mesin ini — apa yang dilampirkannya adalah apa yang di-resolve oleh setiap konsumen registry tersebut — sehingga masing-masing menyebutkan setiap registry yang dituju dan apakah panggilan tersebut melampirkan sesuatu di sana. |
pin | PinResult | tidak | Apa yang dilakukan langkah pin terhadap lock di samping sebuah entitas, atau yang akan dilakukannya pada dry run. Ini adalah jawaban untuk aggrega/pin, dan publikasi yang menjalankan langkah ini membawanya sebagai pin. |
wholeDirectorySource | string | tidak | Sumber lokal entitas sebagaimana ditulis, ada jika sumber itu ditulis sebagai templat. Sumber seperti itu baru menamai direktorinya setelah sebuah Release mengisi templat tersebut, sehingga publikasi membawa setiap file di direktori entitas, bukan hanya file yang dinamai entitas. Tidak ada jika publikasi hanya membawa file-file tersebut. |
windowsUnusableEntries | string[] | tidak | Entri arsip yang dipublikasikan yang jalurnya memuat bagian yang tidak dapat disimpan Windows sebagaimana tertulis — nama yang dicadangkan Windows untuk perangkat, seperti CON, AUX atau NUL, dalam huruf besar atau kecil apa pun dan apa pun ekstensi yang mengikutinya, atau bagian yang diakhiri titik atau spasi — nama file dokumen entitas itu sendiri terlebih dahulu, lalu file yang dibawanya. Workspace di Windows menolak membongkarnya, sehingga tidak dapat menggunakan versi tersebut; publikasi tetap berjalan atau berhenti persis seperti tanpa entri tersebut. Tidak ada jika tidak ada entri seperti itu, termasuk entitas yang dipublikasikan hanya sebagai dokumennya. |
Properti tambahan tidak diizinkan.
PublishArtifactResult
Apa yang dihasilkan oleh publikasi sebuah file, dan di mana.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
reference | string | ya | Referensi tempat file dipublikasikan. |
tag | string | ya | Tag tempat entitas dipublikasikan. |
mediaType | string | ya | Media type yang dicatat untuk byte yang dipublikasikan. |
size | integer | ya | Jumlah byte yang dipublikasikan. |
sizeText | string | ya | Ukuran yang sama, ditulis dalam bentuk yang mudah dibaca manusia. |
digest | string | ya | Digest dari apa yang dipublikasikan. |
alreadyPublished | boolean | ya | Apakah byte yang sama sudah ada di sana, sehingga tidak ada konten yang diunggah. Tanggal publikasi dilampirkan di sampingnya hanya jika artefak belum memilikinya. |
dryRun | boolean | ya | Apakah ini melaporkan apa yang akan dihasilkan publikasi, bukan apa yang telah dilakukannya. |
reach | PublicationReach | ya | Seberapa jauh sebuah publikasi menjangkau. Jawaban ini menjangkau sepenuhnya melampaui mesin ini — apa yang dilampirkannya adalah apa yang di-resolve oleh setiap konsumen registry tersebut — sehingga masing-masing menyebutkan setiap registry yang dituju dan apakah panggilan tersebut melampirkan sesuatu di sana. |
Properti tambahan tidak diizinkan.
SignArtifactsResult
Apa yang ditandatangani, dan di mana tanda tangan itu ditempatkan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
signed | SignedArtifact[] atau null | ya | Setiap referensi yang ditandatangani. |
reach | PublicationReach | ya | Seberapa jauh sebuah publikasi menjangkau. Jawaban ini menjangkau sepenuhnya melampaui mesin ini — apa yang dilampirkannya adalah apa yang di-resolve oleh setiap konsumen registry tersebut — sehingga masing-masing menyebutkan setiap registry yang dituju dan apakah panggilan tersebut melampirkan sesuatu di sana. |
Properti tambahan tidak diizinkan.
DeprecateArtifactResult
Apa yang ditandai sebagai usang, dan di mana penanda itu ditempatkan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
marked | DeprecationMarked[] atau null | ya | Setiap versi yang ditandai. |
reach | PublicationReach | ya | Seberapa jauh sebuah publikasi menjangkau. Jawaban ini menjangkau sepenuhnya melampaui mesin ini — apa yang dilampirkannya adalah apa yang di-resolve oleh setiap konsumen registry tersebut — sehingga masing-masing menyebutkan setiap registry yang dituju dan apakah panggilan tersebut melampirkan sesuatu di sana. |
Properti tambahan tidak diizinkan.
ResolveResult
Tempat sesuatu di bawah kursor didefinisikan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
location | null atau Location | ya | Tempat sesuatu itu didefinisikan. Bernilai null jika tidak ada apa pun di bawah kursor yang mengarah ke sebuah definisi. |
Properti tambahan tidak diizinkan.
FindReferencesResult
Tempat sesuatu di bawah kursor dirujuk.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
locations | Location[] atau null | ya | Setiap tempat sesuatu itu dirujuk. |
Properti tambahan tidak diizinkan.
FindImplementationsResult
Dokumen mana yang mengimplementasikan sesuatu di bawah kursor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
locations | Location[] atau null | ya | Setiap tempat sesuatu itu diimplementasikan. |
Properti tambahan tidak diizinkan.
HoverResult
Apa yang ditampilkan tentang sesuatu di bawah kursor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
contents | null atau MarkupContent | ya | Apa yang ditampilkan. Bernilai null jika tidak ada yang dapat dikatakan tentang apa yang ada di bawah kursor. |
Properti tambahan tidak diizinkan.
CompletionResult
Apa yang dapat ditulis di posisi kursor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
items | CompletionItem[] atau null | ya | Setiap hal yang dapat ditulis. |
Properti tambahan tidak diizinkan.
CatalogIndexResult
Setiap entitas yang dimuat indeks workspace, serta tautan yang mengarah keluar dari workspace, ke direktori dan ke file, yang tidak dibaca untuk indeks tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
entities | CatalogEntity[] atau null | ya | Setiap entitas. |
unreadLinkedDirs | string[] | ya | Setiap tautan di bawah root workspace yang mengarah ke direktori di luarnya, dinamai relatif terhadap root tempat tautan itu sendiri berada, dalam urutan workspace ditelusuri. Tidak ada direktori di luar root yang ditelusuri, sehingga tidak ada dokumen di balik salah satu tautan ini yang termasuk dalam entities sebagai milik workspace sendiri, dan klien yang menampilkan daftar entitas dapat menjelaskan alasannya. Tidak dinamai: tautan ke direktori di dalam root, yang ditelusuri, atau dikecualikan, di tempat direktori itu sebenarnya berada; tautan di mana pun sebuah direktori akan dikecualikan, baik karena tempatnya, namanya, maupun oleh .gitignore; tautan yang tidak dapat di-resolve, karena tidak mengarah ke mana pun atau berputar dalam loop; dan, dalam jawaban yang diberikan menurut ketentuan sebuah Release, tautan di bawah direktori katalog yang hanya dibaca oleh Releases lain. Kosong jika workspace tidak memuatnya. |
unreadLinkedFiles | string[] | ya | Setiap tautan di bawah root workspace yang dinamai seperti file YAML, dengan namanya sendiri berakhiran .yaml atau .yml, dan mengarah ke file di luar root, dinamai relatif terhadap root tempat tautan itu sendiri berada, dalam urutan workspace ditelusuri. File semacam itu tidak dibaca untuk indeks, apa pun yang dideklarasikannya, sehingga entitas yang dideklarasikannya tidak termasuk dalam entities sebagai milik workspace sendiri, dan klien yang menampilkan daftar entitas dapat menjelaskan alasannya; direktori katalog yang dikonfigurasi adalah cara entitas di luar workspace dibaca. Tidak dinamai: tautan ke file yang dinamai konfigurasi workspace sebagai Release, sebagai build.authoring_release atau sebagai kunci workspace.releases, dan yang mendeklarasikan satu Release, yang dibaca dan dicantumkan dalam entities di tempat tautan itu sendiri; tautan ke file di dalam root, yang dibaca di tempat tautan itu sendiri; tautan yang dikecualikan oleh .gitignore, atau yang berada di dalam direktori yang dikecualikan penelusuran; tautan yang tidak mengarah ke file, baik ke direktori, yang dinamai unreadLinkedDirs jika mengarah keluar dari root, atau tidak ke mana pun, atau berputar dalam loop; dan, dalam jawaban yang diberikan menurut ketentuan sebuah Release, tautan di bawah direktori katalog yang hanya dibaca oleh Releases lain. File konfigurasi workspace yang merupakan tautan yang mengarah keluar dari workspace, yaitu .aggrega-config.yaml miliknya sendiri atau overlay milik CI di sampingnya, dinamai baik ditemui penelusuran maupun tidak, setelah tautan-tautan yang dinamai penelusuran: konfigurasi workspace lalu tidak dibaca sama sekali, jawaban ini adalah indeks workspace sendiri yang dibaca tanpa konfigurasi apa pun, sehingga tidak ada direktori katalog yang dibaca untuknya, dan setiap permintaan yang ditentukan oleh konfigurasi, termasuk indeks menurut ketentuan sebuah Release, ditolak untuk workspace tersebut dengan kondisi penahanan baca. Kosong jika workspace tidak memuatnya. |
Properti tambahan tidak diizinkan.
AttachCandidatesResult
Features mana yang dapat dilampirkan ke entitas, dan label yang menjadi dasar penilaiannya; serta, untuk koneksi yang dinamai permintaan, slot yang dideklarasikan socket-nya beserta Features yang dapat mengisi masing-masing slot.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
node | string | ya | Entitas yang menjadi sasaran penilaian kandidat. |
nodeLabels | map of string atau null | ya | Label yang menjadi dasar penilaian. |
labelSource | string | ya | Set label mana yang digunakan, yang bukan sekadar kosmetik: label yang dideklarasikan dokumen adalah apa yang dapat dilihat dari pembacaan sumber, sedangkan label node graf adalah set final yang dijadikan dasar penilaian oleh build itu sendiri. Jawaban yang dihitung atas set kedua merupakan pernyataan tentang apa yang akan dilakukan build. |
candidates | SourcedEntityRef[] atau null | ya | Setiap Feature yang dapat dilampirkan. |
slots | SlotCandidacy[] | tidak | Hanya ada jika permintaan menamai sebuah koneksi: setiap slot yang dideklarasikan socket koneksi tersebut, dalam urutan Component mendeklarasikannya, beserta Features yang dapat mengisinya. Kosong jika tidak ada slot yang dapat diisi pada koneksi tersebut, dan noSlotReason lalu menjelaskan alasannya — yang dibaca klien alih-alih menganggap daftar kosong sebagai slot yang tidak cocok dengan Feature mana pun. |
noSlotReason | const “feature-created-connection” atau const “ad-hoc-socket” atau const “no-slot-declared” | tidak | Hanya ada jika permintaan menamai sebuah koneksi dan tidak ada slot yang dapat diisi padanya: alasan tidak ada yang dapat dilampirkan di sana. Tidak ada di mana pun socket mendeklarasikan slot. Set ini tertutup. Nilai yang diizinkan: "feature-created-connection" — Sebuah Feature menggambar koneksi tersebut, dan lampiran hanya ditulis pada koneksi yang digambar oleh komponen atau Release. "ad-hoc-socket" — Socket tersebut tidak dideklarasikan oleh Component, sehingga tidak mendeklarasikan slot untuk diisi koneksi. "no-slot-declared" — Component mendeklarasikan socket tersebut dan tidak mendeklarasikan slot apa pun padanya. |
Properti tambahan tidak diizinkan.
ConnectionCandidatesResult
Entitas mana saja yang dapat dihubungkan ke setiap socket pada entitas.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
node | string | ya | Entitas pemilik socket-socket ini. |
adHocSocketsAccepted | boolean | ya | Apakah socket yang tidak dideklarasikan sebelumnya oleh definisi entitas itu sendiri masih dapat ditulis. |
sockets | SocketCandidacy[] atau null | ya | Setiap socket dan apa yang dapat dihubungkan ke dalamnya. |
Properti tambahan tidak diizinkan.
InsertionPointResult
Di mana dalam dokumen entri baru di bawah kontainer yang dinamai seharusnya ditempatkan, dan apa yang dibutuhkan klien untuk menuliskannya di sana: titik itu sendiri, apakah teks harus diawali dengan jeda baris, kunci kontainer yang masih belum ada, dan indentasi setiap baris.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
file | string | ya | Dokumen tersebut. |
container | string[] atau null | ya | Jalur melalui dokumen menuju kontainer. |
positionEncoding | string | ya | Encoding yang digunakan untuk menyatakan posisi dalam jawaban ini. |
position | Position | ya | Suatu tempat dalam dokumen: baris dan offset karakter di dalamnya, keduanya dihitung mulai dari nol. Offset diukur dalam satuan encoding yang disepakati sesi saat dibuka, yaitu UTF-16 kecuali klien meminta yang lain. |
precededByLineBreak | boolean | ya | Apakah teks yang ditulis pada posisi tersebut harus diawali dengan jeda baris, karena posisi berada di akhir baris yang sudah dimuat dokumen. Nilainya false hanya jika dokumen tidak memuat apa pun untuk diikuti entri. |
missingContainerKeys | string[] atau null | ya | Segmen jalur kontainer yang belum dimuat dokumen, dimulai dari yang terluar. Masing-masing harus ditulis sebagai kunci tersendiri, diindentasi satu langkah lebih jauh daripada yang sebelumnya, sebelum entri dapat ditempatkan di dalam yang terdalam. Nilainya null jika seluruh jalur sudah ada. |
entryIndent | integer | ya | Kolom tempat baris pertama entri itu sendiri dimulai, dihitung dalam spasi dari awal baris. |
indentStep | integer | ya | Seberapa jauh tambahan indentasi untuk setiap tingkat nesting. |
indentStepMeasured | boolean | ya | Apakah langkah diukur dari nesting dokumen ini sendiri. Jika false, dokumen tidak menunjukkan nesting yang dapat diukur dan langkah tersebut merupakan nilai cadangan, sehingga klien yang lebih suka menerapkan nilainya sendiri tahu bahwa ia bebas melakukannya. |
entryShape | const “mapping” atau const “sequence” atau const “unknown” | ya | Bentuk yang digunakan kontainer untuk memuat entrinya, yang menentukan cara teks entri itu sendiri disusun. Bentuk ini dibaca dari kontainer yang sudah dimuat dokumen dan tidak pernah disimpulkan dari nama kontainer. Set ini tertutup. Nilai yang diizinkan: "mapping" — Kontainer adalah block mapping, sehingga entri yang ditambahkan kepadanya adalah sebuah kunci dan nilainya. "sequence" — Kontainer adalah block sequence, sehingga entri yang ditambahkan kepadanya adalah tanda hubung dan nilainya. "unknown" — Dokumen tidak memuat kontainer, atau memuatnya tanpa isi, sehingga bentuk yang diambil entri ditentukan oleh klien. |
Properti tambahan tidak diizinkan.
AttachmentContainerResult
Di dokumen mana, dan di bagian mana di dalamnya, sebuah lampiran pada node graf, atau pada koneksi yang dinamai permintaan, seharusnya ditempatkan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
node | string | ya | Node graf yang menjadi tujuan lampiran. |
file | string | ya | Dokumen tempat lampiran seharusnya berada. |
container | string[] atau null | ya | Jalur melalui dokumen tersebut menuju tempat lampiran seharusnya berada. |
Properti tambahan tidak diizinkan.
ConnectionAtPositionResult
Koneksi yang entrinya memuat posisi tersebut, atau alasan tidak ada yang dilaporkan. Tepat satu bagian yang ada: graphNode dan connection bersama-sama, atau noConnectionReason saja. Posisi di mana pun di dalam sebuah entri — pada alias, target, atau lampirannya — berada di dalam entri tersebut, yaitu entri terdalam jika entri bersarang; posisi pada kunci socket itu sendiri, di atas entri yang ditulis di bawahnya, tidak berada di dalam entri mana pun.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
graphNode | string | tidak | Id node yang komponennya menggambar koneksi, sebagaimana graf hasil kompilasi menjadikannya kunci — nilai yang diterima permintaan kandidat dan kontainer sebagai graphNode. |
connection | ConnectionCoordinate | tidak | Koneksi, berdasarkan socket dan aliasnya, dengan document yang menamai dokumen tempat posisi dibaca — nilai yang diterima permintaan kandidat dan kontainer sebagai connection. |
noConnectionReason | const “no-connection-entry” atau const “feature-created-connection” atau const “unknown-connection” | tidak | Hanya ada jika tidak ada koneksi yang dilaporkan: alasannya. Set ini tertutup. Nilai yang diizinkan: "no-connection-entry" — Posisi tidak berada pada entri mana pun tempat lampiran ditulis: bukan koneksi yang digambar komponen dan ditulis di bawah aliasnya, bukan pula entri per-edge di Release. Koneksi yang ditulis sebagai daftar target, dan koneksi yang digambar oleh blok milik Feature sendiri, tidak memiliki entri semacam itu. "feature-created-connection" — Posisi berada pada entri Release untuk koneksi yang digambar oleh Feature, dan lampiran hanya ditulis pada koneksi yang digambar oleh komponen atau Release. "unknown-connection" — Posisi berada pada entri yang ditulis Release untuk koneksi yang tidak ada dalam graf hasil kompilasi. |
Properti tambahan tidak diizinkan.
ReleaseCandidatesResult
Releases yang dimuat workspace, beserta tautan yang mengarah keluar darinya, ke direktori dan ke file, yang tidak dibaca untuknya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
releases | string[] atau null | ya | Setiap dokumen Release. |
lockfiles | map of string | ya | Lockfile dari setiap Release yang tercantum, dengan kunci berupa Release persis seperti yang tercantum. Masing-masing adalah file yang ditulis oleh pull untuk Release tersebut dan dibaca oleh build, sehingga klien membaca lokasinya alih-alih menyimpulkannya sendiri. Kosong bila workspace tidak memuat Release. |
unreadLinkedDirs | string[] | ya | Setiap tautan di bawah root workspace yang mengarah ke direktori di luarnya, dinamai relatif terhadap root tempat tautan itu sendiri berada, dalam urutan pencarian workspace. Tidak ada direktori di luar root yang dicari, sehingga Release yang hanya terjangkau melalui salah satu tautan ini tidak ada di releases, dan klien yang menawarkan Releases dapat menjelaskan alasannya. Tidak dinamai: tautan ke direktori di dalam root, yang dicari, atau dikecualikan, di tempat ia sebenarnya berada; tautan di mana pun sebuah direktori akan dikecualikan, baik karena lokasinya maupun namanya; dan tautan yang tidak dapat di-resolve, karena tidak mengarah ke mana pun atau berputar dalam loop. Kosong bila workspace tidak memuatnya. |
unreadLinkedFiles | string[] | ya | Setiap tautan di bawah root workspace yang dinamai seperti file YAML, dengan namanya sendiri berakhiran .yaml atau .yml, dan mengarah ke file di luar root, dinamai relatif terhadap root tempat tautan itu sendiri berada, dalam urutan pencarian workspace. File semacam itu tidak dibaca, sehingga Release yang hanya terjangkau melalui salah satu tautan ini tidak ada di releases, dan klien yang menawarkan Releases dapat menjelaskan alasannya. Apakah sebuah file merupakan Release tidak dapat diketahui tanpa membacanya, sehingga setiap tautan semacam itu dinamai apa pun isi filenya. Tidak dinamai: tautan ke file yang dinamai konfigurasi workspace sebagai Release, sebagai build.authoring_release atau sebagai kunci workspace.releases, yang dibaca dan dicantumkan di releases pada tempat tautan itu sendiri; tautan ke file di dalam root, yang dibaca; tautan di dalam direktori yang dikecualikan pencarian; dan tautan yang tidak mengarah ke file, baik ke direktori, yang dinamai oleh unreadLinkedDirs bila mengarah keluar dari root, maupun ke tidak ke mana pun, atau berputar dalam loop. File konfigurasi workspace yang berupa tautan yang mengarah keluar dari workspace, yaitu .aggrega-config.yaml miliknya sendiri atau overlay milik CI di sebelahnya, dinamai terlepas dari apakah pencarian menjumpainya atau tidak, setelah tautan yang dinamai pencarian: konfigurasi workspace kemudian sama sekali tidak dibaca, jawaban ini dibaca tanpa konfigurasi apa pun, sehingga tidak ada Release yang dinamai konfigurasi melalui tautan yang dicantumkan, dan setiap permintaan yang ditentukan oleh konfigurasi ditolak untuk workspace tersebut dengan kondisi penahanan baca. Kosong bila workspace tidak memuatnya. |
Properti tambahan tidak diizinkan.
ActiveReleaseResult
Release mana yang secara default harus ditangani klien. Workspace yang tidak menunjuk ke Release mana pun adalah keadaan biasa, bukan kegagalan, sehingga hal itu dilaporkan di sini beserta penjelasan tentang bagaimana pemilihan dicoba, alih-alih dimunculkan sebagai error.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
release | string | ya | Release yang ditetapkan, atau kosong bila tidak ada. |
lockfile | string | tidak | Lockfile dari Release yang ditetapkan: file yang ditulis oleh pull untuknya dan dibaca oleh build. Tidak ada bila tidak ada Release yang ditetapkan. |
reason | string | tidak | Alasan tidak ada Release yang ditetapkan. |
trace | string | tidak | Setiap langkah pemilihan dan apa yang ditemukannya, sehingga pemanggil dapat melihat langkah mana yang akan menetapkannya. |
Properti tambahan tidak diizinkan.
EditDocumentResult
Apa yang ditulis oleh pengeditan, dan di mana. Setelah penulisan, hasil pembacaan daemon atas dokumen tersebut dibuang, sehingga jawaban berikutnya tentangnya dihitung dari byte yang dihasilkan pengeditan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
file | string | ya | Dokumen yang diedit. |
edit | string | ya | Pengeditan mana yang diterapkan. |
container | string[] atau null | ya | Jalur melalui dokumen ke tempat pengeditan berlaku. |
createdContainers | string[] atau null | ya | Container yang harus dibuat oleh pengeditan di sepanjang jalan. |
written | string[] atau null | ya | Dokumen-dokumen yang ditulis. |
content | string | ya | Dokumen yang tersusun, untuk permintaan yang meminta agar hasilnya ditampilkan alih-alih ditulis. |
Properti tambahan tidak diizinkan.
EffectiveConfigurationResult
Konfigurasi yang di-resolve oleh workspace, dan dari dokumen mana setiap pengaturan berasal.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
layers | string[] atau null | ya | Dokumen konfigurasi yang digabungkan, dalam urutan penggabungannya. |
settings | EffectiveConfigurationSetting[] atau null | ya | Setiap pengaturan yang di-resolve dan asalnya. |
Properti tambahan tidak diizinkan.
ConfigInitResult
Apa yang ditulis oleh penyemaian konfigurasi, di mana, dan apa yang dibacanya dari registry.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
host | string | ya | Registry yang menjadi tujuan penyemaian konfigurasi. |
scope | ConfigWriteScope | ya | Dokumen konfigurasi mana yang ditulis dan seberapa jauh jangkauannya. Sebuah permintaan menyebut satu workspace, sehingga jawaban yang tidak menyebutkan apa pun akan dibaca sebagai jawaban tentang workspace tersebut — dan untuk penulisan tingkat mesin, pembacaan itu keliru. |
trust | TrustFetchOutcome | ya | Apa hasil pembacaan kebijakan kepercayaan yang diumumkan sebuah registry. Hasil-hasil ini dipisahkan karena maknanya berbeda: kebijakan yang diumumkan diambil, registry tidak mengumumkan apa pun — yang bukan merupakan kegagalan — baseline bawaan dipasang sebagai gantinya, atau tidak ada pembacaan yang dicoba. Jika tidak ada yang diumumkan, apakah registry dapat dijangkau sama sekali dinyatakan di sampingnya. |
written | boolean | ya | Apakah dokumen ditulis, alih-alih dikembalikan agar ditempatkan oleh pemanggil. |
existed | boolean | tidak | Ada dan bernilai true bila dokumen sudah ada, sehingga entri registry digabungkan ke dalamnya alih-alih membuat dokumen baru. Hanya permintaan yang mengirim force yang dilanjutkan di atas dokumen yang sudah ada, sehingga properti ini tidak ada di setiap jawaban untuk permintaan yang tidak mengirimnya. |
content | string | tidak | Teks dokumen, untuk permintaan yang meminta agar teks itu ditampilkan alih-alih ditulis. |
Properti tambahan tidak diizinkan.
ConfigCaptureResult
Apa yang ditulis oleh pembekuan konfigurasi yang di-resolve ke dalam dokumen milik workspace ini sendiri.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
configFile | string | ya | Dokumen yang ditulis. Dokumen ini selalu milik workspace ini sendiri, karena seluruh tujuannya adalah membuat satu workspace mandiri. |
workspaceRoot | string | ya | Workspace yang disebut oleh permintaan. |
captured | boolean | ya | Apakah ada sesuatu yang dibekukan. |
sockets | ConfigCapturedSocket[] atau null | ya | Setiap socket yang dibekukan, beserta attachment-nya. |
catalogDirs | string[] atau null | ya | Direktori katalog yang dibekukan. |
Properti tambahan tidak diizinkan.
ImportResult
Apa yang dihasilkan oleh konversi sumber asing, dan apa yang tidak dapat dikonversinya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
format | string | ya | Format sumber yang dikonversi. |
outputDir | string | ya | Direktori yang menjadi acuan relatif setiap jalur dalam jawaban, dan tempat file-file ditulis. |
written | string[] atau null | ya | Setiap file yang sampai ke disk, dalam urutan penulisan: draf-draf, lalu catatan tentang apa yang ditulis oleh impor. Dalam sync, hanya draf yang diubah sync dan catatan bila catatan itu berubah. Kosong dalam dryRun. |
files | ImportedFile[] atau null | ya | Setiap file yang ditulis oleh permintaan, beserta teksnya, dengan maupun tanpa dryRun: setiap draf, lalu catatan tentang apa yang ditulis oleh impor. Dalam sync, setiap draf yang diubah sync, dengan teks barunya, lalu catatan bila catatan itu juga berubah, sehingga sync yang sudah selaras menjawab dengan daftar kosong. |
drift | ImportDrift[] | ya | Setiap bagian yang diselaraskan sync dengan sumber, atau akan diselaraskan dalam dryRun, dalam urutan yang dinamai draf; file draf yang dihapus sync termasuk di antaranya, dihapus tanpa kunci. Daftar kosong untuk permintaan yang bukan sync, untuk sync yang sudah selaras, dan untuk sync yang konversinya berhenti, yang tidak menulis apa pun. |
diagnostics | ImportDiagnostic[] atau null | ya | Apa yang tidak dapat dikonversi. |
decisions | ImportDecision[] | ya | Bagaimana importer memetakan setiap node sumber, dalam urutan importer dan persis seperti yang dilaporkannya: inilah yang memberi tahu Anda di mana konversi menebak. Disertakan dalam kedua cara penyampaian dan terlepas dari apakah konversi berhenti atau tidak, dan berupa daftar kosong untuk importer yang tidak melaporkan apa pun. |
owed | ImportOwed[] | tidak | Setiap nilai yang masih dibiarkan kosong oleh draf, yang tidak dapat disediakan oleh sumber mana pun dan tidak disediakan oleh jawaban mana pun, dalam urutan penulisan draf — nilai-nilai yang disebut oleh temuan peringatan. Setiap jawaban memuatnya, berupa daftar kosong jika draf tidak kekurangan apa pun. |
halted | boolean | ya | Apakah konversi berhenti alih-alih selesai dengan temuan. |
Properti tambahan tidak diizinkan.
ScaffoldEntityResult
Dokumen awal hasil draf, daftar contoh yang dapat dijalankan, atau contoh yang ditulis — setiap bentuk menjawab dengan field-nya sendiri dan membiarkan field lainnya tidak ada.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | tidak | Jenis entitas yang dirancang. Ada pada draf. |
skeleton | string | tidak | Teks dokumen yang dirancang. Ada pada draf. |
examples | ScaffoldExample[] | tidak | Setiap contoh yang dapat dijalankan yang dipublikasikan dokumentasi, masing-masing sekali, dalam urutan nama. Ada pada daftar yang menemukan setidaknya satu contoh. |
example | string | tidak | Contoh yang ditulis. Ada pada penulisan. |
dir | string | tidak | Direktori tempat contoh ditulis, relatif terhadap root workspace, sebagaimana disebutkan permintaan atau, jika permintaan tidak menyebutkannya, sebagai nama contoh. Ada pada penulisan. |
files | string[] | tidak | Setiap berkas yang ditulis, relatif terhadap dir dan dipisahkan garis miring, dalam urutan yang dimuat dokumentasi. Ada pada penulisan. |
next | string[] | tidak | Perintah yang diberikan halaman contoh untuk membangunnya, baris demi baris sebagaimana ditulis halaman, termasuk komentar: blok shell pertama di bawah judul Build-nya. Tidak ada jika halaman tidak memberikannya. |
version | string | tidak | Versi dokumentasi tempat contoh dibaca: versi milik biner itu sendiri jika ada yang dipublikasikan untuknya, jika tidak, versi terbaru yang dipublikasikan sebelumnya. Ada pada penulisan. |
Properti tambahan tidak diizinkan.
ScaffoldExample
Satu contoh yang dapat dijalankan yang dipublikasikan dokumentasi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Nama contoh, yang dikirim permintaan sebagai example untuk menulisnya. |
level | string | ya | Tingkat yang dideklarasikan halaman contoh untuknya. |
summary | string | ya | Kalimat pertama halaman contoh. |
Properti tambahan tidak diizinkan.
LintResult
Apa yang ditemukan oleh pemeriksaan konvensi, dihitung menurut tingkat keparahan dan dicantumkan per dokumen. Pemeriksaan seluruh katalog yang dijalankan sekali untuk setiap Release juga membawa passes; hitungan dan files kemudian mencakup semua pass sekaligus.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
entity | string | tidak | Satu entitas yang diperiksa, jika permintaan menyebutkan satu. |
release | string | tidak | Release yang closure-nya diperiksa, jika permintaan menyebutkan satu. |
checked | integer | ya | Berapa banyak dokumen yang diperiksa. Jika pemeriksaan dijalankan sekali untuk setiap Release, jumlahnya adalah total atas semua pass: dokumen yang dibaca oleh dua pass dihitung pada masing-masing pass. |
findings | integer | ya | Berapa banyak temuan secara keseluruhan. |
errors | integer | ya | Berapa banyak di antaranya yang berupa galat. |
warnings | integer | ya | Berapa banyak di antaranya yang berupa peringatan. |
infos | integer | ya | Berapa banyak di antaranya yang bersifat informasi. |
files | LintFileFindings[] atau null | ya | Temuan, per dokumen. |
halted | boolean | ya | Apakah pemeriksaan berhenti alih-alih selesai dengan temuan. |
passes | LintPass[] atau null | tidak | Pemeriksaan seluruh katalog, satu pass demi satu pass, hanya ada jika pemeriksaan dijalankan sekali untuk setiap Release karena workspace menyebutkan Releases di bawah workspace.releases. Setiap pass menyatakan untuk Releases mana temuannya ditemukan. Tidak ada untuk workspace yang tidak menyebutkan satu pun, yang diperiksa sekali atas direktorinya sendiri, dan untuk pemeriksaan satu entitas atau closure sebuah Release. |
Properti tambahan tidak diizinkan.
LintPass
Satu pass dari pemeriksaan konvensi seluruh katalog dalam workspace yang memberi Releases-nya direktori katalog sendiri: Releases yang menjadi sasaran pass tersebut, direktori yang dibacanya, dan apa yang ditemukannya di sana.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
releases | string[] atau null | ya | Releases yang menjadi sasaran pass, masing-masing sebagai path relatif terhadap root workspace. Releases yang membaca direktori katalog yang sama berbagi satu pass. |
catalogDirs | string[] atau null | ya | Direktori katalog yang dibaca pass, dalam urutan pencariannya, masing-masing relatif terhadap root workspace jika berada di dalamnya. Kosong jika Releases-nya tidak membaca direktori katalog apa pun, sehingga pass tidak memeriksa apa pun dan tidak menggagalkan pass lainnya. |
checked | integer | ya | Berapa banyak dokumen yang diperiksa oleh pass. |
findings | integer | ya | Berapa banyak temuan yang ditemukan oleh pass. |
errors | integer | ya | Berapa banyak di antaranya yang berupa galat. |
warnings | integer | ya | Berapa banyak di antaranya yang berupa peringatan. |
infos | integer | ya | Berapa banyak di antaranya yang bersifat informasi. |
files | LintFileFindings[] atau null | ya | Temuan pass, per dokumen. |
Properti tambahan tidak diizinkan.
PluginAddResult
Apa yang ditulis saat memasang plugin, di mana, dan versi mana yang di-pin.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
type | string | ya | Socket tempat plugin dipasang. |
identity | string | tidak | Identitas yang menjadi hasil resolusi pemasangan. |
uri | string | tidak | Referensi tempat attachment di-resolve. |
capability | string | tidak | Kapabilitas yang dilayani attachment. |
reference | string | tidak | Referensi yang di-pin, termasuk versinya. |
scope | PluginWriteScope | ya | Dokumen konfigurasi mana yang menjadi tempat penulisan perubahan plugin dan seberapa jauh jangkauannya. Default socket ekstensi perintah sendiri adalah dokumen tingkat mesin, sehingga setiap jawaban menyebutkan dokumen mana yang ditulisnya. |
written | boolean | ya | Apakah dokumen konfigurasi ditulis, alih-alih dikembalikan agar ditempatkan oleh pemanggil. |
content | string | tidak | Teks dokumen konfigurasi, untuk permintaan yang meminta agar teks itu ditampilkan alih-alih ditulis. |
retraction | PluginRetraction | tidak | Bagaimana penanda deprecation memengaruhi versi plugin yang di-pin. |
withdrawn | boolean | tidak | Bernilai true jika kueri menamai versi yang di-pin dan retraksi yang dipercaya workspace ini telah menarik versi tersebut. Versi yang dinamai tetap di-pin, karena menamainya adalah override-nya. Tidak ada jika sebaliknya, dan ketiadaannya tidak berarti versi tersebut tidak ditarik: jika penanda penarikan dari versi yang dinamai tidak dapat dibaca, retraction.unscreened menyebutkan alasannya, dan jika tidak ada versi yang dinamai, versi terpublikasi terbaru dipilih dan retraction melaporkan apa yang disimpulkan pemeriksaan penarikan tentang pilihan tersebut. |
Properti tambahan tidak diizinkan.
PluginRemoveResult
Apa yang ditulis saat melepas plugin, dan di mana.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
type | string | ya | Socket tempat plugin dipasang. |
query | string | ya | Pemasangan mana yang dihapus. |
scope | PluginWriteScope | ya | Dokumen konfigurasi mana yang menjadi tempat penulisan perubahan plugin dan seberapa jauh jangkauannya. Default socket ekstensi perintah sendiri adalah dokumen tingkat mesin, sehingga setiap jawaban menyebutkan dokumen mana yang ditulisnya. |
Properti tambahan tidak diizinkan.
PluginSyncResult
Apa yang diubah saat menyelaraskan catatan milik mesin dari entitas Plugin dengan modulnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
entity | string | ya | Dokumen entitas Plugin yang diselaraskan. |
hostFunctions | string[] atau null | ya | Fungsi host yang dinyatakan diperlukan oleh modul. |
commands | PluginCLICommand[] atau null | ya | Perintah yang disumbangkan oleh modul. |
changed | boolean | ya | Apakah ada sesuatu dalam dokumen yang benar-benar berubah. |
Properti tambahan tidak diizinkan.
PluginGenCatalogResult
Dokumen katalog yang dihasilkan oleh suatu pembuatan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
documents | PluginGeneratedDocument[] | tidak | Setiap dokumen yang dihasilkan beserta teksnya. |
notices | string | tidak | Apa pun yang ingin disampaikan oleh proses pembuatan kepada pemanggil. |
dryRun | boolean | ya | Apakah dokumen dikembalikan alih-alih ditulis. |
Properti tambahan tidak diizinkan.
ExplainErrorResult
Apa yang dinyatakan compiler tentang suatu kondisi, dan bagian terbitan yang mengajarkan perbaikan penulisannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
shortCode | string | ya | Kode singkat kondisi. |
code | string | ya | Nama deskriptif kondisi. |
message | string | ya | Apa yang dinyatakan kondisi saat dimunculkan. |
entries | ExplainErrorEntry[] | tidak | Bagian terbitan yang mengajarkan perbaikannya. |
reference | string | ya | Alamat terpublikasi tempat kondisi dijelaskan. |
note | string | tidak | Mengapa bagian terbitan tidak ada, jika bagian itu tidak dapat diperoleh. Apa yang dinyatakan oleh biner itu sendiri tetap dijawab. |
Properti tambahan tidak diizinkan.
GetSchemaResult
Skema suatu jenis, atau — jika permintaan tidak menyebutkan satu pun — jenis mana saja yang dapat disebutkan. Kedua cakupan ini dibawa dalam satu jawaban alih-alih dua metode, karena “apa yang boleh saya sebutkan” dan “yang mana di antaranya yang dokumennya ditulis oleh penulis” adalah pertanyaan yang sama dalam dua cakupan, dan dua jawaban harus dijaga agar tetap selaras.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | tidak | Jenis yang menjadi sasaran skema. |
schema | any | tidak | Skema itu sendiri, diteruskan sebagaimana disimpan oleh biner. |
kinds | string[] | tidak | Setiap token yang dijawab oleh biner ini. |
entityKinds | EntityKindDescriptor[] | tidak | Himpunan yang lebih sempit yang dokumennya ditulis oleh penulis, masing-masing memasangkan token yang disebutkan permintaan dengan jenis yang dinyatakan oleh header dokumen itu sendiri. |
Properti tambahan tidak diizinkan.
SkillsInstallResult
Apa yang ditulis oleh pemasangan skill asisten, dan di mana.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
skill | string | ya | Skill yang ditulis. |
installed | SkillsInstalledFolder[] | ya | Setiap folder skill yang ditulis, dalam urutan permintaan menyebutkan asisten. Asisten yang membaca satu folder bersama berbagi satu entri, karena skill ditulis ke sana sekali. |
scope | SkillFolderScope | ya | Seberapa jauh jangkauan pemasangan skill. Permintaan menyebutkan satu workspace, sehingga jawaban yang tidak menyatakan apa pun akan dibaca sebagai berkaitan dengan workspace tersebut — dan untuk folder per pengguna, yang dibaca asisten di setiap proyek, pembacaan itu keliru. |
Properti tambahan tidak diizinkan.
SkillsInstalledFolder
Satu folder skill yang ditulis oleh sebuah pemasangan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
agents | string[] | ya | Pengidentifikasi asisten yang disebutkan yang membaca folder ini, dalam urutan permintaan menyebutkannya. |
folder | string | ya | Folder skill, sebagai path absolut. |
replaced | boolean | ya | Apakah salinan yang memuat baris komentar yang dimuat setiap salinan skill yang ditulis — yang ditulis pemasangan sebelumnya, atau yang diambil dari repositori skill yang dipublikasikan — ada di sana dan telah diganti. Berkas di sana tanpa baris tersebut ditolak alih-alih diganti. |
Properti tambahan tidak diizinkan.
SkillsListResult
Skill yang disertakan biner dan setiap asisten yang dapat dituliskan skill tersebut oleh sebuah pemasangan. Tidak ada yang ditulis dan tidak ada yang dihubungi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
skills | SkillsListedSkill[] | ya | Setiap skill yang disertakan biner, dalam urutan tetap. |
agents | SkillsListedAgent[] | ya | Setiap asisten yang folder skill-nya diketahui oleh pemasangan, diurutkan berdasarkan pengidentifikasi. |
Properti tambahan tidak diizinkan.
SkillsListedSkill
Satu skill yang disertakan biner.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Nama skill, yang juga merupakan nama folder yang ditulis oleh pemasangan. |
description | string | ya | Kapan asisten menggunakan skill, sebagaimana dideklarasikan oleh skill itu sendiri. |
Properti tambahan tidak diizinkan.
SkillsListedAgent
Satu asisten yang dapat dituliskan skill oleh sebuah pemasangan, beserta dua folder tempat asisten tersebut membaca skill.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
id | string | ya | Pengidentifikasi yang digunakan permintaan untuk menyebutkan asisten. |
name | string | ya | Nama asisten itu sendiri. |
projectFolder | string | ya | Folder, relatif terhadap root proyek dan dipisahkan dengan garis miring, tempat asisten membaca skill proyek. Pemasangan proyek menulis folder skill di dalamnya, di workspace yang disebutkan permintaan. |
userFolder | string | ya | Folder, relatif terhadap direktori home dan dipisahkan dengan garis miring, tempat asisten membaca skill milik pengguna sendiri di setiap proyek. Pemasangan dengan global menulis folder skill di dalamnya. |
Properti tambahan tidak diizinkan.