zugzbot 1.0.0 → 1.0.2

package/.utils/docs_opencode/server.md

@@ -1,324 +0,0 @@
-# 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

@@ -1,235 +0,0 @@
-# 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