zugzbot 1.0.6 → 1.0.8

package/.utils/docs_opencode/server.md

@@ -0,0 +1,324 @@
+# Servidor
+
+Interactuar con el servidor opencode a través de HTTP.
+
+El comando `opencode serve` ejecuta un servidor HTTP sin cabeza que expone un punto final OpenAPI que un cliente opencode puede usar.
+
+---
+
+### [Uso](#uso)
+
+**File**: Ventana de terminal
+
+```bash
+opencode serve [--port ] [--hostname ] [--cors ]
+```
+
+#### [Opciones](#opciones)
+ ````````````````````
+
+| Bandera Descripción Predeterminado |
+| --- |
+| --port Puerto para escuchar 4096 |
+| --hostname Nombre de host para escuchar 127.0.0.1 |
+| --mdns Habilitar el descubrimiento de mDNS false |
+| --mdns-domain Nombre de dominio personalizado para el servicio mDNS opencode.local |
+| --cors Orígenes de navegador adicionales para permitir [] |
+
+
+`--cors` se puede pasar varias veces:
+
+**File**: Ventana de terminal
+
+```bash
+opencode serve --cors http://localhost:5173 --cors https://app.example.com
+```
+
+---
+
+### [Autenticación](#autenticación)
+
+Configure `OPENCODE_SERVER_PASSWORD` para proteger el servidor con autenticación básica HTTP. El nombre de usuario predeterminado es `opencode`, o configure `OPENCODE_SERVER_USERNAME` para anularlo. Esto se aplica tanto a `opencode serve` como a `opencode web`.
+
+**File**: Ventana de terminal
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve
+```
+
+---
+
+### [Cómo funciona](#cómo-funciona)
+
+Cuando ejecuta `opencode`, inicia un TUI y un servidor. Donde el TUI es el Cliente que habla con el servidor. El servidor expone una especificación OpenAPI 3.1 punto final. Este punto final también se utiliza para generar un [SDK](https://opencode.ai/docs/sdk).
+
+> [!TIP]
+> Utilice el servidor opencode para interactuar con opencode mediante programación.
+
+Esta arquitectura permite que opencode admita múltiples clientes y le permite interactuar con opencode mediante programación.
+
+Puede ejecutar `opencode serve` para iniciar un servidor independiente. Si tienes el opencode TUI ejecutándose, `opencode serve` iniciará un nuevo servidor.
+
+---
+
+#### [Conectarse a un servidor existente](#conectarse-a-un-servidor-existente)
+
+Cuando inicia el TUI, asigna aleatoriamente un puerto y un nombre de host. En su lugar, puede pasar `--hostname` y `--port` [banderas](https://opencode.ai/docs/cli). Luego use esto para conectarse a su servidor.
+
+El punto final ``[/tui](#tui) se puede utilizar para conducir el TUI a través del servidor. Por ejemplo, puede completar previamente o ejecutar un mensaje. Esta configuración es utilizada por los complementos OpenCode [IDE](https://opencode.ai/docs/ide).
+
+---
+
+## [Especificaciones](#especificaciones)
+
+El servidor publica una especificación OpenAPI 3.1 que se puede ver en:
+
+**File**:
+
+```plaintext
+http://:/doc
+```
+
+Por ejemplo, `http://localhost:4096/doc`. Utilice la especificación para generar clientes o inspeccionar tipos de solicitudes y respuestas. O verlo en un explorador Swagger.
+
+---
+
+## [API](#api)
+
+El servidor opencode expone las siguientes API.
+
+---
+
+### [Global](#global)
+ ``````````
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /global/health Obtener el estado y la versión del servidor { healthy: true, version: string } |
+| GET /global/event Obtenga eventos globales (transmisión SSE) Flujo de eventos |
+
+
+---
+
+### [Proyecto](#proyecto)
+ ``````[Project[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[Project](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /project Listar todos los proyectos |
+| GET /project/current Obtener el proyecto actual |
+
+
+---
+
+### [Ruta y VCS](#ruta-y-vcs)
+ ``````[Path](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[VcsInfo](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /path Obtener la ruta actual |
+| GET /vcs Obtenga información de VCS para el proyecto actual |
+
+
+---
+
+### [Instancia](#instancia)
+ ``````
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| POST /instance/dispose Eliminar la instancia actual boolean |
+
+
+---
+
+### [Configuración](#configuración)
+ ``````[Config](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[Config](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[Proveedor[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /config Obtener información de configuración |
+| PATCH /config Actualizar configuración |
+| GET /config/providers Lista de proveedores y modelos predeterminados { providers: , default: { [key: string]: string } } |
+
+
+---
+
+### [Proveedor](#proveedor)
+ ``````[Proveedor[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)````````[ProviderAuthMethod[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)````````[ProviderAuthAuthorization](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /provider Listar todos los proveedores { all: , default: {...}, connected: string[] } |
+| GET /provider/auth Obtener métodos de autenticación de proveedores { [providerID: string]: } |
+| POST /provider/{id}/oauth/authorize Autorizar a un proveedor usando OAuth |
+| POST /provider/{id}/oauth/callback Manejar la devolución de llamada OAuth para un proveedor boolean |
+
+
+---
+
+### [Sesiones](#sesiones)
+ ``````[Session[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)````````[Session](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[SessionStatus](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)````````[Session](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````````````[Session](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[Session[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[Todo[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````````````````[Session](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)````````````[Session](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[Session](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)````````[FileDiff[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````````````````````````````
+
+| Método Ruta Descripción Notas |
+| --- |
+| GET /session Listar todas las sesiones Devuelve |
+| POST /session Crear una nueva sesión cuerpo: { parentID?, title? } , devuelve |
+| GET /session/status Obtener el estado de la sesión para todas las sesiones Devuelve { [sessionID: string]: } |
+| GET /session/:id Obtener detalles de la sesión Devuelve |
+| DELETE /session/:id Eliminar una sesión y todos sus datos Devuelve boolean |
+| PATCH /session/:id Actualizar propiedades de sesión cuerpo: { title? } , devuelve |
+| GET /session/:id/children Obtener las sesiones secundarias de una sesión Devuelve |
+| GET /session/:id/todo Obtener la lista de tareas pendientes para una sesión Devuelve |
+| POST /session/:id/init Analizar aplicación y crear AGENTS.md cuerpo: { messageID, providerID, modelID } , devuelve boolean |
+| POST /session/:id/fork Bifurca una sesión existente en un mensaje cuerpo: { messageID? } , devuelve |
+| POST /session/:id/abort Cancelar una sesión en ejecución Devuelve boolean |
+| POST /session/:id/share Compartir una sesión Devuelve |
+| DELETE /session/:id/share Dejar de compartir una sesión Devuelve |
+| GET /session/:id/diff Obtenga la diferencia para esta sesión consulta: messageID? , devuelve |
+| POST /session/:id/summarize Resumir la sesión cuerpo: { providerID, modelID } , devuelve boolean |
+| POST /session/:id/revert Revertir un mensaje cuerpo: { messageID, partID? } , devuelve boolean |
+| POST /session/:id/unrevert Restaurar todos los mensajes revertidos Devuelve boolean |
+| POST /session/:id/permissions/:permissionID Responder a una solicitud de permiso cuerpo: { response, remember? } , devuelve boolean |
+
+
+---
+
+### [Mensajes](#mensajes)
+ ````````[Mensaje](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``[Parte[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````````[Mensaje](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``[Parte[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)````````[Mensaje](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``[Parte[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````````````````[Mensaje](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``[Parte[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````````[Mensaje](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``[Parte[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``
+
+| Método Ruta Descripción Notas |
+| --- |
+| GET /session/:id/message Listar mensajes en una sesión consulta: limit? , devuelve { info: , parts: }[] |
+| POST /session/:id/message Envía un mensaje y espera respuesta cuerpo: { messageID?, model?, agent?, noReply?, system?, tools?, parts } , devuelve { info: , parts: } |
+| GET /session/:id/message/:messageID Obtener detalles del mensaje Devuelve { info: , parts: } |
+| POST /session/:id/prompt_async Enviar un mensaje de forma asincrónica (sin espera) cuerpo: igual que /session/:id/message , devuelve 204 No Content |
+| POST /session/:id/command Ejecutar un comando de barra diagonal cuerpo: { messageID?, agent?, model?, command, arguments } , devuelve { info: , parts: } |
+| POST /session/:id/shell Ejecute un comando de shell cuerpo: { agent, model?, command } , devuelve { info: , parts: } |
+
+
+---
+
+### [Comandos](#comandos)
+ ``````[Command[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /command Listar todos los comandos |
+
+
+---
+
+### [Archivos](#archivos)
+ ``````````````````````````[Symbol[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[FileNode[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[FileContent](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[File[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /find?pattern= Buscar texto en archivos Matriz de objetos coincidentes con path , lines , line_number , absolute_offset , submatches |
+| GET /find/file?query= Buscar archivos y directorios por nombre string[] (caminos) |
+| GET /find/symbol?query= Buscar símbolos del espacio de trabajo |
+| GET /file?path= Listar archivos y directorios |
+| GET /file/content?path= Leer un archivo |
+| GET /file/status Obtener el estado de los archivos rastreados |
+
+
+#### [Parámetros de consulta de /find/file](#parámetros-de-consulta-de-findfile)
+
+- `query` (obligatorio) — cadena de búsqueda (coincidencia aproximada)
+- `type` (opcional): limita los resultados a `"file"` o `"directory"`
+- `directory` (opcional): anula la raíz del proyecto para la búsqueda.
+- `limit` (opcional) — resultados máximos (1–200)
+- `dirs` (opcional): indicador heredado (`"false"` devuelve solo archivos)
+
+---
+
+### [Herramientas (experimentales)](#herramientas-experimentales)
+ ``````[ToolIDs](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[ToolList](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /experimental/tool/ids Listar todos los ID de herramientas |
+| GET /experimental/tool?provider=&model= Listar herramientas con esquemas JSON para un modelo |
+
+
+---
+
+### [LSP, formateadores y MCP](#lsp-formateadores-y-mcp)
+ ``````[LSPStatus[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[FormatterStatus[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)``````[MCPStatus](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)````````
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /lsp Obtener el estado del servidor LSP |
+| GET /formatter Obtener estado del formateador |
+| GET /mcp Obtener el estado del servidor MCP { [name: string]: } |
+| POST /mcp Agregue el servidor MCP dinámicamente cuerpo: { name, config } , devuelve MCP objeto de estado |
+
+
+---
+
+### [Agentes](#agentes)
+ ``````[Agent[]](https://github.com/anomalyco/opencode/blob/dev/packages/sdk/js/src/gen/types.gen.ts)
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /agent Listar todos los agentes disponibles |
+
+
+---
+
+### [Registro](#registro)
+ ````````
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| POST /log Escribir entrada de registro. Cuerpo: { service, level, message, extra? } boolean |
+
+
+---
+
+### [TUI](#tui)
+ ``````````````````````````````````````````````````````````````````````
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| POST /tui/append-prompt Agregar texto al mensaje boolean |
+| POST /tui/open-help Abra el cuadro de diálogo de ayuda boolean |
+| POST /tui/open-sessions Abrir el selector de sesiones boolean |
+| POST /tui/open-themes Abra el selector de temas boolean |
+| POST /tui/open-models Abrir el selector de modelo boolean |
+| POST /tui/submit-prompt Enviar el mensaje actual boolean |
+| POST /tui/clear-prompt Borrar el mensaje boolean |
+| POST /tui/execute-command Ejecutar un comando ( { command } ) boolean |
+| POST /tui/show-toast Mostrar brindis ( { title?, message, variant } ) boolean |
+| GET /tui/control/next Espere la próxima solicitud de control Objeto de solicitud de control |
+| POST /tui/control/response Responder a una solicitud de control ( { body } ) boolean |
+
+
+---
+
+### [Autenticación](#autenticación-1)
+ ``````
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| PUT /auth/:id Establecer credenciales de autenticación. El cuerpo debe coincidir con el esquema del proveedor boolean |
+
+
+---
+
+### [Eventos](#eventos)
+ ``````
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /event Transmisión de eventos enviados por el servidor. El primer evento es server.connected , luego eventos de bus Transmisión de eventos enviados por el servidor |
+
+
+---
+
+### [Documentación](#documentación)
+ ````
+
+| Método Ruta Descripción Respuesta |
+| --- |
+| GET /doc Especificación OpenAPI 3.1 Página HTML con especificación OpenAPI |

package/.utils/docs_opencode/skills.md

@@ -0,0 +1,235 @@
+# Habilidades del agente
+
+Defina el comportamiento reutilizable mediante definiciones de SKILL.md
+
+Las habilidades del agente permiten a OpenCode descubrir instrucciones reutilizables de su repositorio o directorio de inicio. Las habilidades se cargan bajo demanda a través de la herramienta nativa `skill`: los agentes ven las habilidades disponibles y pueden cargar el contenido completo cuando sea necesario.
+
+---
+
+## [Colocar archivos](#colocar-archivos)
+
+Cree una carpeta por nombre de habilidad y coloque un `SKILL.md` dentro de ella. OpenCode busca estas ubicaciones:
+
+- Configuración del proyecto: `.opencode/skills//SKILL.md`
+- Configuración global: `~/.config/opencode/skills//SKILL.md`
+- Compatible con Proyecto Claude: `.claude/skills//SKILL.md`
+- Compatible con Claude global: `~/.claude/skills//SKILL.md`
+- Compatible con agente de proyecto: `.agents/skills//SKILL.md`
+- Compatible con agentes globales: `~/.agents/skills//SKILL.md`
+
+---
+
+## [Entender el descubrimiento](#entender-el-descubrimiento)
+
+Para las rutas locales del proyecto, OpenCode sube desde su directorio de trabajo actual hasta llegar al árbol de trabajo de git. Carga cualquier `skills/*/SKILL.md` coincidente en `.opencode/` y cualquier `.claude/skills/*/SKILL.md` o `.agents/skills/*/SKILL.md` coincidente a lo largo del camino.
+
+Las definiciones globales también se cargan desde `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` y `~/.agents/skills/*/SKILL.md`.
+
+---
+
+## [Escribir la introducción](#escribir-la-introducción)
+
+Cada `SKILL.md` debe comenzar con el frontmatter de YAML. Sólo se reconocen estos campos:
+
+- `name` (obligatorio)
+- `description` (obligatorio)
+- `license` (opcional)
+- `compatibility` (opcional)
+- `metadata` (opcional, mapa de cadena a cadena)
+
+Los campos desconocidos se ignoran.
+
+---
+
+## [Validar nombres](#validar-nombres)
+
+`name` debe:
+
+- Tener entre 1 y 64 caracteres.
+- Ser alfanuméricos en minúsculas con separadores de guión simple
+- No comienza ni termina con `-`
+- No contener `--` consecutivos
+- Coincide con el nombre del directorio que contiene `SKILL.md`
+
+expresión regular equivalente:
+
+**File**:
+
+```text
+^[a-z0-9]+(-[a-z0-9]+)*$
+```
+
+---
+
+## [Seguir las reglas de longitud](#seguir-las-reglas-de-longitud)
+
+`description` debe tener entre 1 y 1024 caracteres. Manténgalo lo suficientemente específico para que el agente elija correctamente.
+
+---
+
+## [Usar un ejemplo](#usar-un-ejemplo)
+
+Crea `.opencode/skills/git-release/SKILL.md` así:
+
+**File**:
+
+```markdown
+---
+name: git-release
+description: Create consistent releases and changelogs
+license: MIT
+compatibility: opencode
+metadata:
+  audience: maintainers
+  workflow: github
+---
+
+## What I do
+
+- Draft release notes from merged PRs
+- Propose a version bump
+- Provide a copy-pasteable `gh release create` command
+
+## When to use me
+
+Use this when you are preparing a tagged release.
+Ask clarifying questions if the target versioning scheme is unclear.
+```
+
+---
+
+## [Reconocer la descripción de la herramienta](#reconocer-la-descripción-de-la-herramienta)
+
+OpenCode enumera las habilidades disponibles en la descripción de la herramienta `skill`. Cada entrada incluye el nombre y la descripción de la habilidad:
+
+**File**:
+
+```xml
+
+  
+    git-release
+    Create consistent releases and changelogs
+  
+
+```
+
+El agente carga una habilidad llamando a la herramienta:
+
+**File**:
+
+```plaintext
+skill({ name: "git-release" })
+```
+
+---
+
+## [Configurar permisos](#configurar-permisos)
+
+Controle a qué agentes de habilidades pueden acceder utilizando permisos basados ​​en patrones en `opencode.json`:
+
+**File**:
+
+```json
+{
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "pr-review": "allow",
+      "internal-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+ ``````
+
+| Permiso Comportamiento |
+| --- |
+| allow La habilidad se carga inmediatamente |
+| deny Habilidad oculta al agente, acceso rechazado |
+| ask Se solicita al usuario aprobación antes de cargar |
+
+
+Los patrones admiten comodines: `internal-*` coincide con `internal-docs`, `internal-tools`, etc.
+
+---
+
+## [Anulación por agente](#anulación-por-agente)
+
+Otorgue a agentes específicos permisos diferentes a los predeterminados globales.
+
+**Para agentes personalizados** (en el frente del agente):
+
+**File**:
+
+```yaml
+---
+permission:
+  skill:
+    "documents-*": "allow"
+---
+```
+
+**Para agentes integrados** (en `opencode.json`):
+
+**File**:
+
+```json
+{
+  "agent": {
+    "plan": {
+      "permission": {
+        "skill": {
+          "internal-*": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## [Deshabilitar la herramienta de habilidades](#deshabilitar-la-herramienta-de-habilidades)
+
+Deshabilite completamente las habilidades para los agentes que no deberían usarlas:
+
+**Para agentes personalizados**:
+
+**File**:
+
+```yaml
+---
+tools:
+  skill: false
+---
+```
+
+**Para agentes integrados**:
+
+**File**:
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "skill": false
+      }
+    }
+  }
+}
+```
+
+Cuando está deshabilitada, la sección `` se omite por completo.
+
+---
+
+## [Solucionar problemas de carga](#solucionar-problemas-de-carga)
+
+Si una habilidad no aparece:
+
+1. Verifique que `SKILL.md` esté escrito en mayúsculas.
+1. Verifique que el frontmatter incluya `name` y `description`
+1. Asegúrese de que los nombres de las habilidades sean únicos en todas las ubicaciones
+1. Verifique los permisos: las habilidades con `deny` están ocultas para los agentes