Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

npm 0.4.0: V2 entry never registers pty_* tools — setup omits ctx.tool.transform

Abierto Apto para principiantes
  • ¿Algo no está bien?
#86 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
75/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
nodejs, typescript
Área
cli, tooling

Línea de trabajo

Empieza comparando el archivo publicado dist/src/v2/index.js con src/v2/index.ts en main, especialmente la función setup y cómo gestiona ctx.tool.transform. Sigue el cableado de registerV2Tools y del adaptador V2, y después revisa el ejemplo de configuración V2 del README. La tarea estará terminada cuando el plugin publicado exponga las herramientas PTY y la especificación de paquete documentada se resuelva a través de npm.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

The npm-published [email protected] V2 entry loads and reports itself as active in OpenCode, but none of pty_spawn / pty_write / pty_read / pty_list / pty_kill ever reach the agent's tool catalog.

Cause. package.json has no publishConfig/files exclusion that would catch it, but the tarball's dist/src/v2/index.js ships the pre-#61 setup:

setup: async (ctx) => {
    const options = ctx.options;
    const adapter = createV2Adapter();
    installHostAdapter(adapter);
    if (ctx.command && typeof ctx.command.transform === 'function') { ... }
    if (options?.autostart) { ... }
}

It calls createV2Adapter() without the notifier and never calls registerV2Tools. ptyTools is exported from dist/src/v2/tools.js and is importable, but nothing wires it into ctx.tool.transform.

Commit 9be5126 (2026-09-19, "fix(v2): register pty tools, slash commands and exit notifications via the V2 plugin SDK") adds exactly this, but it landed one day after the v0.4.0 release commit ce5f61c (2026-09-18). So the fix is on main and simply never shipped — installing from npm gives a plugin that loads cleanly, passes opencode plugin check-adjacent loading, and silently provides no tools.

Repro. npm pack [email protected], inspect dist/src/v2/index.js: no ctx.tool usage. Compare src/v2/index.ts on main, which has registerV2Tools(draft) behind ctx.tool.transform.

Impact. Silent failure — no error at load time. The only signal is that the tools are absent at runtime.

Suggestion. Publish 0.4.1 from main. Note also that the README's V2 config example uses "package": "opencode-pty/v2"; opencode passes that string to npm, which parses pkg/subpath as a GitHub shorthand, so it fails to resolve. A subpath spec that npm can actually install (or documenting the plain package name plus a v2 export condition) would help.

Lenguaje dominante
TypeScript
Estrellas
606
Forks
67
Merge medio
4 d 9 h
PR fusionados (30 d)
1

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de shekohex/opencode-pty

Todos los issues de shekohex/opencode-pty

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.