Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Plugin fails to load on OpenCode v2.0.27 - incompatible plugin API

Aberta
  • Algo errado?
#83 1 comentário 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
25/100
Tipo de issue
Bug
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
node.js, typescript
Domínio
developer-experience

Direção de pesquisa

Start at the plugin's entry module, where the named export PTYPlugin is declared, and compare it with the default-export shape OpenCode 2.x expects (an id plus an effect or setup function). The error text is in the issue, and the linked oh-my-openagent and opencode-pty#67 threads describe the same loader. Done means the plugin loads on OpenCode v2.0.27 without the error. The issue does not choose between adapting the API and adding a shim, so ask the maintainer first.

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

Descrição

Bug Description

[email protected] fails to load as a plugin on OpenCode v2.0.27 with the following error:

Plugin must export a default definition with an id and an effect or setup function.

Environment

  • OpenCode version: v2.0.27
  • opencode-pty version: 0.4.0 (latest on npm)
  • Platform: Windows 11
  • Node: v22.18.0

Steps to Reproduce

  1. Install opencode-pty: opencode plugin add opencode-pty@latest
  2. Start OpenCode v2.0.27
  3. Plugin fails to load with the error above

Root Cause

OpenCode 2.0 introduced a new Effect-based plugin API that requires plugins to export a default definition with id and effect or setup function keys. opencode-pty currently uses the old export format (named exports like export { PTYPlugin }).

Expected Behavior

opencode-pty should either:

  • Adapt to the new Effect-based plugin API, OR
  • Provide a compatibility shim for OpenCode 2.x

Additional Context

Linguagem predominante
TypeScript
Estrelas
601
Forks
66
Merge médio
1d 20h
PRs com merge (30d)
3

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

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 shekohex/opencode-pty

Todas as issues de shekohex/opencode-pty

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

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