Skip to content
Beskid Platform specification

Beskid

Jump to a Beskid service

Beskid

Jump to a Beskid service

Contracts and edge cases

Platform spec article

Contracts and edge cases

Back to Extension surface Open feature in platform map

Spec standingStandard

Owner
Piotr Mikstacki
Submitter
Piotr Mikstacki

focusedProjectUri

Section titled “focusedProjectUri”
SurfaceKey
LSP initializeinitializationOptions.focusedProjectUri
Deprecated aliasinitializationOptions.selectedProjectUri (one release)
Configurationbeskid.project.focusedProjectUri in workspace/didChangeConfiguration

When unset, LSP scans all workspace roots without prioritizing a single manifest.

LSP executeCommand payloads

Section titled “LSP executeCommand payloads”

beskid.listWorkspaces

Section titled “beskid.listWorkspaces”

Arguments: []
Returns:

{
  "workspaces": [
    {
      "uri": "file:///…/Workspace.proj",
      "name": "corelib",
      "members": [{ "name": "app", "path": "beskid_corelib", "uri": "file:///…/Project.proj" }]
    }
  ]
}

beskid.getWorkspaceSummary

Section titled “beskid.getWorkspaceSummary”

Arguments: [workspaceUri: string]
Returns: { workspaceUri, name, resolver, members[], registries: [{ name, url }] }

beskid.getProjectGraph

Section titled “beskid.getProjectGraph”

Arguments: [projectUri: string]
Returns: { projectUri, nodes[], edges[], unresolved[] }

beskid.getProjectDependencies

Section titled “beskid.getProjectDependencies”

Arguments: [projectUri: string]
Returns: { projectUri, declared[], locked[], unresolved[] } — locked entries include resolvedVersion, materializedRoot, registry when present in Project.lock.

Registry auth

Section titled “Registry auth”
  • beskid.pckg.apiKey setting or SecretStorage beskid.pckg.apiKey → Authorization: Bearer … on pckg fetch (matches pckg ApiKeyAuthentication).
  • Private packages: search/details fail without key; UI shows HTTP error nodes, not silent empty lists.

Offline / unreachable registry

Section titled “Offline / unreachable registry”
  • Cached search TTL ~30s; details ~60s.
  • Non-OK HTTP → tree info node; no unbounded refetch on every getChildren.