Expose opaque plugin identities and ownership references on discovered contributions

Aberta
  • Algo errado?
#2,878 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
35/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
java
Domínio
backend-api-design

Direção de pesquisa

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.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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

Linguagem predominante
Java
Estrelas
10.7k
Forks
1.5k
Nenhum PR com merge em 30d

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de github/copilot-sdk

Todas as issues de github/copilot-sdk

Issues semelhantes

Mais issues de Java

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.