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

docs/config: subagent_depth defaults to 1 and is undocumented, so subagents can't delegate

Abierto Apto para principiantes
#59,826 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@nateEc ya está trabajando en esto.

Desde el 28/10/2026.

  • #59905 de @nateEc — abierto

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
65/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
typescript

Línea de trabajo

Empieza por las páginas de documentación de V2 agents y config, y busca en el config schema experimental.subagent_depth, el único lugar donde, según la issue, está documentada esta opción. Explica el valor predeterminado y cómo configurar una profundidad de delegación anidada; el trabajo estará hecho cuando los usuarios puedan encontrar esta guía en la documentación de V2. La issue no menciona rutas de archivos de documentación ni pruebas.

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

Descripción

Summary

experimental.subagent_depth defaults to 1 in 2.1.4, so a subagent cannot spawn another subagent ("Subagent depth limit reached (1)"). The default and the setting are not mentioned in the V2 docs (agents / config pages), so agent designs that delegate one level down (for example a coder subagent spawning explore) fail with no documented fix.

Environment

  • opencode version: 2.1.4
  • OS: Darwin 25.6.0 (darwin arm64); also Linux
  • Install/channel: latest (official installer)
  • Active plugins: not required to reproduce

Reproduction

  1. Define a subagent coder whose permissions allow subagent on explore.
  2. From the main session, spawn coder and ask it to delegate a search to explore.

Expected Behavior

Either a documented default and setting, or a default that allows at least one nested level (common pattern: main → specialist → explore).

Actual Behavior

The nested spawn fails with Subagent depth limit reached (1). Setting experimental.subagent_depth: 3 in opencode.json fixes it; the only place we found the setting was the config schema.

Additional Context

Related closed issues on depth-2 behaviour: #49342, #39112.

Lenguaje dominante
TypeScript
Estrellas
221k
Forks
29.6k
Merge medio
5 h 32 min
PR fusionados (30 d)
492

Preparar el entorno

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 anomalyco/opencode

Todos los issues de anomalyco/opencode

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.