Expose opaque plugin identities and ownership references on discovered contributions

Aperta
  • Qualcosa non va?
#2,878 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
java
Ambito
backend-api-design

Direzione di ricerca

Start by locating the plugin inventory and discovery APIs for agents, skills, instructions, hooks, and MCP servers across the supported language SDKs, then read their existing provenance fields and tests. Define and document a consistent ownership reference that resolves in the matching global or session context, including ID lifetime and same-named plugins from different sources. Done means every contribution type and supported SDK follows the contract, with tests covering resolution and global/session behavior.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Problem

VS Code needs to group SDK-discovered contributions under their owning plugins while leaving discovery and plugin lifecycle management to the SDK.

Please expose a common opaque plugin ID on plugin inventory entries and an owning-plugin reference on every plugin contribution: agents, skills, instructions, hooks, and MCP servers.

Without a shared ownership contract, consumers must infer relationships from names, parse contribution IDs, match filesystem paths, or scan plugin directories. Those approaches duplicate SDK responsibilities and can misattribute contributions when different plugins have the same name.

Proposed contract

  • Each plugin inventory entry exposes an opaque id.
  • Each plugin-owned contribution exposes an optional owning-plugin reference, for example pluginId, whose value matches an inventory entry's id.
  • Non-plugin contributions omit the reference.
  • Use the same identity contract across global discovery and session-scoped APIs wherever they refer to the same plugin instance.
  • Document the identity's scope and stability, including restarts, updates, and reinstallations. Distinguish same-named plugins from different marketplaces/direct sources and session-specific instances where necessary.
  • Document how contributions resolve to inventory entries in the corresponding context, including session-only, built-in, and managed plugins. Consumers should not need to reconstruct an identity from installation metadata.
  • Reuse or align existing provenance fields rather than introduce competing ownership identifiers.

Illustrative field names, not a required API shape:

const inventory = {
  plugins: [{ id: "opaque-plugin-id", name: "review-tools", enabled: true }]
};

const discovery = {
  agents: [{
    id: "opaque-agent-selection-id",
    name: "reviewer",
    pluginId: "opaque-plugin-id"
  }]
};

The agent's selection ID and the owning plugin's ID serve different purposes; callers must not parse either.

Expected consumer behavior

VS Code can join contribution results to inventory entries by the opaque plugin ID, present SDK-owned plugin groups, and use SDK-reported enablement. It does not scan plugin directories, parse manifests, match file paths, or implement another discovery mechanism.

Acceptance criteria

  • Ownership attribution is available consistently for agents, skills, instructions, hooks, and MCP servers.
  • Every returned plugin reference can be resolved using the documented inventory API/context.
  • Same-named plugins from different sources remain distinguishable.
  • Global/session behavior and ID lifetime are documented and covered by tests.
  • All supported language SDKs expose the contract.

Scope

This requests ownership attribution, not filesystem roots, enablement migration, or a change to policy precedence.

Whether APIs should also enumerate contributions of disabled plugins is a separate capability question. This issue does not require scanning those contributions on the client or assume active discovery returns them.

Related VS Code work: https://github.com/microsoft/vscode/issues/343342

Lingua principale
Java
Stelle
10.7k
Fork
1.5k
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di github/copilot-sdk

Tutte le issue di github/copilot-sdk

Issue simili

Altre issue su Java

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.