orca-multiagent-kit 1.4.1 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +45 -1
- package/README.md +13 -7
- package/VERSION +1 -1
- package/bin/omk.js +47 -4
- package/bin/orca.js +170 -0
- package/bin/sea.js +95 -0
- package/bin/setup.js +326 -0
- package/bin/team.js +353 -0
- package/core/AGENTS.md +1 -1
- package/docs/EJECUTABLE.md +70 -0
- package/docs/PLUGIN-ORCA.md +126 -28
- package/orca-plugin/README.md +5 -1
- package/orca-plugin/assets/logos/README.md +10 -0
- package/orca-plugin/assets/logos/agent.png +0 -0
- package/orca-plugin/assets/logos/aider.png +0 -0
- package/orca-plugin/assets/logos/amp.png +0 -0
- package/orca-plugin/assets/logos/antigravity.png +0 -0
- package/orca-plugin/assets/logos/claude.png +0 -0
- package/orca-plugin/assets/logos/cline.png +0 -0
- package/orca-plugin/assets/logos/codex.png +0 -0
- package/orca-plugin/assets/logos/copilot.png +0 -0
- package/orca-plugin/assets/logos/cursor.png +0 -0
- package/orca-plugin/assets/logos/devin.png +0 -0
- package/orca-plugin/assets/logos/droid.png +0 -0
- package/orca-plugin/assets/logos/gemini.png +0 -0
- package/orca-plugin/assets/logos/goose.png +0 -0
- package/orca-plugin/assets/logos/grok.png +0 -0
- package/orca-plugin/assets/logos/kimi.png +0 -0
- package/orca-plugin/assets/logos/kiro.png +0 -0
- package/orca-plugin/assets/logos/opencode.png +0 -0
- package/orca-plugin/assets/logos/qwen-code.png +0 -0
- package/orca-plugin/orca-plugin.json +28 -7
- package/orca-plugin/src/icons.test.ts +14 -0
- package/orca-plugin/src/icons.ts +30 -0
- package/orca-plugin/src/kit.test.ts +456 -9
- package/orca-plugin/src/kit.ts +639 -16
- package/orca-plugin/src/models.test.ts +28 -0
- package/orca-plugin/src/models.ts +29 -0
- package/orca-plugin/src/node.d.ts +40 -0
- package/orca-plugin/src/panel-state.ts +28 -0
- package/orca-plugin/src/panel.test.tsx +298 -0
- package/orca-plugin/src/panel.tsx +609 -0
- package/orca-plugin/src/plan-card.test.ts +99 -0
- package/orca-plugin/src/plan-card.ts +107 -0
- package/orca-plugin/src/protocol.ts +179 -0
- package/orca-plugin/src/tabs/autonomy.tsx +70 -0
- package/orca-plugin/src/tabs/history.test.tsx +78 -0
- package/orca-plugin/src/tabs/history.tsx +118 -0
- package/orca-plugin/src/tabs/notices.test.tsx +183 -0
- package/orca-plugin/src/tabs/notices.tsx +274 -0
- package/orca-plugin/src/tabs/worktrees.test.tsx +130 -0
- package/orca-plugin/src/tabs/worktrees.tsx +138 -0
- package/orca-plugin/src/ui/agent-icon.tsx +13 -0
- package/orca-plugin/src/worker/context.test.ts +32 -0
- package/orca-plugin/src/worker/context.ts +92 -0
- package/orca-plugin/src/worker/history.test.ts +149 -0
- package/orca-plugin/src/worker/history.ts +181 -0
- package/orca-plugin/src/worker/notices.test.ts +356 -0
- package/orca-plugin/src/worker/notices.ts +291 -0
- package/orca-plugin/src/worker/system.test.ts +58 -0
- package/orca-plugin/src/worker/system.ts +122 -0
- package/orca-plugin/src/worker/worktrees.test.ts +177 -0
- package/orca-plugin/src/worker/worktrees.ts +188 -0
- package/orca-plugin/src/worker.test.ts +297 -15
- package/orca-plugin/src/worker.ts +353 -32
- package/package.json +3 -2
- package/skills/orca/SKILL.md +1 -0
- package/skills/orca/references/engine-orca.md +1 -0
- package/skills/orca/references/olimpo.md +1 -0
- package/skills/orca/references/plan-card.md +45 -0
package/core/AGENTS.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Reglas operativas globales (Orca Multiagent Kit v1.
|
|
1
|
+
# Reglas operativas globales (Orca Multiagent Kit v1.6.0 · CSR + MAW)
|
|
2
2
|
<!-- Fuente única para todos los agentes (import o enlace). Edita el kit y reinstala; no edites copias. -->
|
|
3
3
|
|
|
4
4
|
## 0. Precedencia
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Ejecutable y `omk setup`: Orca listo de una vez
|
|
2
|
+
|
|
3
|
+
`omk setup` deja [Orca](https://www.onorca.dev) preparado para el kit con una sola orden. El ejecutable autónomo (`omk-windows-x64.exe`, `omk-macos-arm64`, `omk-linux-x64`) es lo mismo para quien no tiene Node: se descarga, se abre y hace `omk setup`.
|
|
4
|
+
|
|
5
|
+
## Qué hace `omk setup`
|
|
6
|
+
|
|
7
|
+
| Paso | Qué pasa | Si falla |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| 1. Kit | `omk install` (con backup, como siempre; acepta `--agents` y `--dry-run`) | Se para con el código de `install.sh` |
|
|
10
|
+
| 2. `omk` en el `PATH` (solo el ejecutable) | Se copia a sí mismo a `%LOCALAPPDATA%\Programs\orca-multiagent-kit\omk.exe` (Windows) o `~/.local/bin/omk`, y en Windows añade esa carpeta al `Path` de tu usuario | No pisa un `omk` que no sea el del kit; lo dice y sale con error |
|
|
11
|
+
| 3. Orca | Busca su CLI (`PATH`, o donde lo deja el instalador de Orca; `OMK_ORCA` para indicar otro) y comprueba que su versión cumple `engines.orca` del plugin | Dice qué falta (instalar o actualizar Orca) y sale con error |
|
|
12
|
+
| 4. App | Si Orca no está abierto, `orca open` y espera a que arranque | Sale con error |
|
|
13
|
+
| 5. Plugins | `orca plugin system on` (el mismo interruptor que *Settings → Plugins → Turn on plugins*; no aprueba nada) | Sale con error |
|
|
14
|
+
| 6. Plugin del kit | Instala, actualiza o aprueba el plugin, según lo que haya ([detalle](PLUGIN-ORCA.md#instalar)). Orca enseña lo que concede y **omk te pregunta** antes de aprobarlo | Sin tu sí no se instala, y sale con error |
|
|
15
|
+
| 7. Panel | `orca plugin open local.multiagent-kit --panel kit`: el panel *Multiagent Kit* queda abierto en la barra lateral derecha | Solo avisa |
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
omk setup --dry-run # qué haría, sin escribir ni instalar nada
|
|
19
|
+
omk setup # pregunta antes de aprobar el plugin
|
|
20
|
+
omk setup --yes # aprueba el acceso del plugin sin preguntar (lo que liste Orca)
|
|
21
|
+
omk setup --no-plugin # solo el kit (y omk en el PATH, con el ejecutable)
|
|
22
|
+
omk setup --no-path # el ejecutable no toca el PATH; te dice qué añadir
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Con doble clic, el ejecutable hace `omk setup` y espera a que pulses Enter antes de cerrar la ventana.
|
|
26
|
+
|
|
27
|
+
**Ajustes del plugin**: en el panel *Multiagent Kit* o en *Settings → Plugins → Orca Multiagent Kit*, que Orca construye con los ajustes que declara el manifiesto. Son los mismos valores en los dos sitios.
|
|
28
|
+
|
|
29
|
+
## El ejecutable
|
|
30
|
+
|
|
31
|
+
Es un [Node SEA](https://nodejs.org/api/single-executable-applications.html): el Node oficial con el kit dentro. Al arrancar extrae el kit a una carpeta estable y ejecuta `omk` desde ella:
|
|
32
|
+
|
|
33
|
+
| Sistema | Kit extraído | `omk` |
|
|
34
|
+
|---|---|---|
|
|
35
|
+
| Windows | `%LOCALAPPDATA%\Programs\orca-multiagent-kit\kit` | `%LOCALAPPDATA%\Programs\orca-multiagent-kit\omk.exe` |
|
|
36
|
+
| macOS, Linux | `~/.local/share/orca-multiagent-kit` | `~/.local/bin/omk` |
|
|
37
|
+
|
|
38
|
+
`OMK_HOME` y `OMK_BIN_DIR` cambian esas carpetas. La carpeta del kit tiene que existir para que Orca pueda actualizar el plugin (`orca plugin update` vuelve a copiar la carpeta desde la que se instaló).
|
|
39
|
+
|
|
40
|
+
- Solo extrae cuando cambia la build (sello `.omk-build` con el SHA-256 del kit embebido). Extrae en `<carpeta>.new` y la cambia por la anterior al final: una extracción a medias no deja un kit roto.
|
|
41
|
+
- No pisa una carpeta que no sea una copia del kit (sin `VERSION` e `install.sh`). En macOS y Linux es la misma carpeta que usa `scripts/get.sh`: la versión que quede es la del último que se ejecutó.
|
|
42
|
+
- `omk update` en el ejecutable no descarga nada: te da el enlace de la última release y vuelve a aplicar la instalación de su versión.
|
|
43
|
+
- Sigue necesitando bash para `install.sh`: en Windows, Git for Windows (Orca usa Git para los worktrees, así que suele estar ya).
|
|
44
|
+
- Pesa ~90 MiB, porque lleva Node entero.
|
|
45
|
+
|
|
46
|
+
**PATH en Windows.** Escribe en `HKCU\Environment\Path` con la API del registro, sin expandir las variables que ya tenga (`%USERPROFILE%\…`) y conservando su tipo (`REG_EXPAND_SZ`), y avisa a Windows del cambio. Orca y los terminales abiertos antes no lo ven: **cierra y vuelve a abrir Orca** para que los comandos del plugin encuentren `omk`. En macOS y Linux no toca tus ficheros de shell: te dice la línea que tienes que añadir si `~/.local/bin` no está en el `PATH`.
|
|
47
|
+
|
|
48
|
+
**Firma.** Los binarios de la release no están firmados con un certificado de desarrollador. Windows SmartScreen puede avisar al abrirlo (*Más información → Ejecutar de todas formas*), y en macOS lleva solo firma ad hoc: si Gatekeeper lo bloquea, `xattr -d com.apple.quarantine omk-macos-arm64`. Comprueba la integridad con su `.sha256` antes de abrirlo.
|
|
49
|
+
|
|
50
|
+
## Construirlo
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
node scripts/build-exe.js # o: npm run build:exe
|
|
54
|
+
bash tests/test_exe.sh # pruebas del ejecutable, en carpetas desechables y con un doble de Orca
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Construye el ejecutable del sistema y la arquitectura donde se ejecuta, con el Node que lo ejecuta (≥ 20.12; la CI usa 22). Deja `dist/omk-<sistema>-<arquitectura>[.exe]` y su `.sha256`. Node SEA no compila para otro sistema: la release construye cada uno en su runner (`.github/workflows/release.yml`, job `exe`).
|
|
58
|
+
|
|
59
|
+
Pasos: empaqueta en `kit.json.gz` lo mismo que el zip de la release; genera el blob con `node --experimental-sea-config`; copia el binario de Node; inyecta el blob con [`postject`](https://github.com/nodejs/postject) (de nodejs, fijado a `1.0.0-alpha.6`, se descarga con `npx` al construir y no va dentro del ejecutable); en macOS quita la firma de Node antes y firma ad hoc después.
|
|
60
|
+
|
|
61
|
+
## Pruebas
|
|
62
|
+
|
|
63
|
+
- `tests/test_orca.sh`: `omk setup` y `omk plugin` contra `tests/fixtures/fake-orca.js`, un doble del CLI de Orca (`OMK_ORCA` apunta siempre a él: las pruebas nunca hablan con tu Orca). Cubre la aprobación (sin `--yes` ni terminal no aprueba; con `--yes` usa la huella de Orca; una huella con formato inesperado se rechaza), cada estado del plugin, Orca ausente o antigua, y `setup` completo, en simulación y sin aprobación.
|
|
64
|
+
- `tests/test_exe.sh`: el ejecutable (extracción, sello, carpeta ajena, `install --dry-run`, `update`, `setup` copiándose a `OMK_BIN_DIR` sin tocar el `PATH`, un `omk` ajeno que no se pisa).
|
|
65
|
+
- La CI ejecuta las dos en Linux, macOS y Windows (job `exe`).
|
|
66
|
+
|
|
67
|
+
DEFERRED:
|
|
68
|
+
- **Autoactualización del ejecutable**: `omk update` en el ejecutable da el enlace a la release, no descarga. Descargar y sustituir un binario en ejecución exige verificar su integridad (firma o checksum publicado) y en Windows renombrarlo en caliente; queda para otro PR.
|
|
69
|
+
- **Firma de código** (Authenticode, notarización de Apple): necesita certificados del proyecto.
|
|
70
|
+
- **Linux arm64 y macOS x64**: la release construye los runners por defecto de GitHub (`ubuntu-latest` x64, `macos-latest` arm64, `windows-latest` x64).
|
package/docs/PLUGIN-ORCA.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Plugin de Orca
|
|
2
2
|
|
|
3
|
-
El kit funciona en [Orca](https://www.onorca.dev) sin plugin: las skills viven en `~/.agents/skills` (el mismo sitio donde Orca instala las suyas) y la skill `orca` usa `orca orchestration` como motor. El plugin `orca-plugin/` añade lo que solo puede hacer la propia app: comandos en la paleta, un cambio en los despachos de orquestación y un indicador en la barra de estado.
|
|
3
|
+
El kit funciona en [Orca](https://www.onorca.dev) sin plugin: las skills viven en `~/.agents/skills` (el mismo sitio donde Orca instala las suyas) y la skill `orca` usa `orca orchestration` como motor. El plugin `orca-plugin/` añade lo que solo puede hacer la propia app: comandos en la paleta, un panel lateral con los agentes, el equipo de roles, las acciones y los ajustes, un cambio en los despachos de orquestación, avisos y un indicador en la barra de estado.
|
|
4
4
|
|
|
5
5
|
Requisitos: Orca ≥ 1.4.248 (hooks y barra de estado) con los plugins activados (*Settings → Plugins → Turn on plugins*). Para los comandos, el kit instalado (`omk` en el `PATH`).
|
|
6
6
|
|
|
@@ -11,11 +11,88 @@ Requisitos: Orca ≥ 1.4.248 (hooks y barra de estado) con los plugins activados
|
|
|
11
11
|
| **Orca Multiagent Kit: verificar instalación** | Un terminal nuevo en el workspace activo que ejecuta `omk verify` | `terminal.create` con el literal `omk verify` |
|
|
12
12
|
| **Orca Multiagent Kit: actualizar kit** | Lo mismo con `omk update` | `terminal.create` con el literal `omk update` |
|
|
13
13
|
| **Orca Multiagent Kit: inicializar proyecto** | Un agente nuevo en el workspace activo con el prompt «inicializa el proyecto» (skill `kit-init`) | `agent.launch`; el agente sale del ajuste *Agente para inicializar* (por defecto `claude`) |
|
|
14
|
-
| **Orca Multiagent Kit: estado de los agentes** | Una línea por agente activo:
|
|
14
|
+
| **Orca Multiagent Kit: estado de los agentes** | Una línea por agente activo: nombre, estado, agente y workspace | Lo que ha ido contando la barra de estado |
|
|
15
|
+
| **Panel *Multiagent Kit* · Agentes** (barra lateral derecha, icono de robot) | Los agentes activos con nombre, agrupados por run del kit o por workspace, los bloqueados primero (y abiertos). Cada uno se despliega en su ficha: estado y desde cuándo, agente, unidad, rol y nivel, run, título en Orca, workspace, rama, carpeta, si corre en un terminal o en un chat de Orca y cómo acabó su último turno; y un botón para ir a su workspace | Ver [Nombres de los agentes](#nombres-de-los-agentes) |
|
|
16
|
+
| **Panel · Avisos** (la etiqueta dice cuántos hay) | Lo que espera tu respuesta: la **tarjeta del plan de rondas** del coordinador (cabecera, rondas, cada unidad con su rol, nivel, agente con su icono, modelo y recurso en colores, notas) con «Sí, lánzalo» y «Pedir cambio»; y cada agente bloqueado o esperando, con las últimas líneas de su terminal, una caja para responderle, «Ir a su workspace» y «Descartar» | Ver [Avisos y tarjeta del plan](#avisos-y-tarjeta-del-plan) |
|
|
17
|
+
| **Panel · Worktrees** | Los worktrees de la orquestación agrupados por run (los demás con agentes, en «Otros»), con su rama y unidad, sus agentes con icono, estado y modelo, «Abrir worktree» y, para un Claude Code que espera, «Cambiar modelo» (opus, sonnet, haiku) | El modelo sale de `--model` en la orden de arranque (hook `agent.launch.before`); el cambio escribe `/model <alias>` + Intro en su terminal |
|
|
18
|
+
| **Panel · Historial** | Despachos, bloqueos y finales de unidad, runs terminados, planes, respuestas, cambios de modelo, repartos y autonomía, lo más reciente primero, con filtro y «Vaciar historial» (dos pasos) | Las 200 últimas entradas, en el almacenamiento del plugin (`storage:own`, clave `history.v1`) |
|
|
19
|
+
| **Panel · Repartir** | Repartir una tarea entre agentes: eliges de dónde sale el trabajo (lo que escribes, un plan del repo o spec-kit), el coordinador y, si quieres, otra autonomía solo para ese run | Ver [Repartir una tarea](#repartir-una-tarea) |
|
|
20
|
+
| **Panel · Equipo** | La autonomía del proyecto (manual, semi, auto) y quién hace cada rol: equipo predefinido o personalizado, proveedores activos (casillas), revisión cruzada, un proveedor por rol de Olimpo y roles propios del proyecto | «Guardar en el proyecto» abre un terminal con `omk team set --autonomy <nivel>`; «Aplicar al proyecto», con `omk team set --data …`; «Ver el del proyecto», con `omk team`. Ver [Equipo](#equipo) |
|
|
21
|
+
| **Panel · Kit** | Botones de verificar, inicializar y actualizar y los cuatro ajustes del plugin (los agentes se eligen de una lista, no se escriben) | El panel pide las acciones al worker (`kit.run`, solo esas tres) y lee y escribe los ajustes con `settings` |
|
|
22
|
+
| **Avisos** | «U2 · Ariadna — Pagos: bloqueado» al bloquearse un agente; «RUN …: unidades terminadas» cuando acaban todas las unidades lanzadas de un run | Transiciones de `agent.status.changed`; se apagan con *Avisos de agentes* |
|
|
23
|
+
| **Repartir siempre** | Todo agente que Orca arranca con una tarea (al crear un worktree con tarea, en una pestaña nueva, desde una issue) pasa primero por la skill `orca`: decide si compensa repartir y, si compensa, reparte. Sin spec-kit | Hook `agent.prompt.before` con `inputKind: "launch"`. Ver [Repartir siempre](#repartir-siempre) |
|
|
15
24
|
| **Contrato del worker** | Cada despacho de la skill `orca` lleva al final una línea que remite a `~/.agents/skills/orca/references/worker-contract.md` | Hook `agent.prompt.before` |
|
|
16
|
-
| **Barra de estado** `MAW · 2 trabajando · 1 bloqueado` | Agentes trabajando, bloqueados o esperando en todos los workspaces. Ámbar si hay alguno bloqueado. Al pulsarlo, el estado de los agentes | Evento `agent.status.changed` y `agents.list` al arrancar |
|
|
25
|
+
| **Barra de estado** `MAW · 2 trabajando · 1 bloqueado` | Agentes trabajando, bloqueados o esperando en todos los workspaces. Ámbar si hay alguno bloqueado. El tooltip nombra hasta seis. Al pulsarlo, el estado de los agentes | Evento `agent.status.changed` y `agents.list` al arrancar |
|
|
17
26
|
|
|
18
|
-
Si `omk` no está en el `PATH`, el terminal muestra el error del shell y, en unos 15 s, llega una notificación con cómo instalarlo (`npm install -g orca-multiagent-kit` o
|
|
27
|
+
Si `omk` no está en el `PATH`, el terminal muestra el error del shell y, en unos 15 s, llega una notificación con cómo instalarlo (`npm install -g orca-multiagent-kit` o el ejecutable de la release, que se deja a sí mismo en el `PATH`). Si el plugin no identifica el workspace activo (ninguno enfocado, o dos con el mismo nombre y rama), avisa y no ejecuta nada: es preferible no lanzar nada a lanzarlo en otro workspace.
|
|
28
|
+
|
|
29
|
+
### Nombres de los agentes
|
|
30
|
+
|
|
31
|
+
Orca no siempre manda título en `agent.status.changed`. El plugin junta lo que sabe de cada terminal, por este orden:
|
|
32
|
+
|
|
33
|
+
1. **Despacho del kit** (hook `agent.prompt.before`): la cabecera `UNIT: U2 — <título> RUN: <run>` y la línea `ROL: Ariadna · …` dan `U2 · Ariadna — <título>` y lo agrupan bajo `RUN <run>`.
|
|
34
|
+
2. **Título de Orca**, si llega; un cambio de estado sin título conserva el anterior.
|
|
35
|
+
3. **Qué agente es** (`claude`, `codex`…), de `agents.list` al arrancar, del hook `agent.launch.before` o, en los chats de agente de Orca (no tienen terminal), del nombre de su panel (`structured-agent-session-<agente>_…`).
|
|
36
|
+
|
|
37
|
+
El workspace sale de `workspace.list`. Los eventos de agentes lo identifican a veces como `<repo>::<ruta>` y la lista como `identity:…`; el plugin los cruza por la ruta. Títulos y despachos los escribe un agente: se quitan los caracteres de control y de formato y se acortan (80 caracteres) antes de enseñarlos. Lo aprendido de cada terminal vive en memoria (los 200 más recientes); si el plugin se reinicia, los agentes en curso se nombran con lo que vuelva a contar Orca.
|
|
38
|
+
|
|
39
|
+
### Repartir siempre
|
|
40
|
+
|
|
41
|
+
Sin el plugin, la orquestación solo arranca sola con spec-kit (el hook `before_implement` de `/speckit.implement`); en el resto de casos depende de que el agente decida usar la skill `orca`, y a menudo no lo hace. El ajuste *Repartir al lanzar un agente con tarea* (activado por defecto) lo vuelve automático: a cada prompt con el que Orca arranca un agente le añade al final
|
|
42
|
+
|
|
43
|
+
> [Orca Multiagent Kit] Antes de empezar, aplica la skill orca (~/.agents/skills/orca/SKILL.md) a esta tarea: decide si compensa repartirla entre agentes y, si compensa, repártela. La entrada es este prompt (adaptador de chat): no hace falta spec-kit. Si no compensa, hazla tú directamente.
|
|
44
|
+
|
|
45
|
+
Así, crear un worktree con una tarea ya es orquestar: la skill decide en menos de un minuto si compensa (`95-multi-agent.md` §Cuándo paralelizar) y, si no, el agente la hace solo como siempre. No se toca:
|
|
46
|
+
|
|
47
|
+
- lo que escribe una persona en el chat o el terminal (Orca no pasa esos prompts por los hooks);
|
|
48
|
+
- los despachos a workers (`inputKind: "orchestration"`), que llevan el contrato del worker en su lugar;
|
|
49
|
+
- los prompts que ya van por la skill `orca` (*Repartir* del panel), los de `kit-init` y un despacho del kit.
|
|
50
|
+
|
|
51
|
+
Falla en abierto como el resto de hooks: si el plugin falla o tarda más de 2 s, el prompt sale sin cambios.
|
|
52
|
+
|
|
53
|
+
### Repartir una tarea
|
|
54
|
+
|
|
55
|
+
Es la forma de arrancar un run multiagente sin abrir un chat y escribir el prompt a mano. Lanza el coordinador elegido (`agent.launch`) en el workspace activo con un prompt que invoca la skill `orca` y le dice de dónde sale el trabajo:
|
|
56
|
+
|
|
57
|
+
| De dónde sale el trabajo | Qué recibe el coordinador | Campo de texto |
|
|
58
|
+
|---|---|---|
|
|
59
|
+
| Lo que escribo aquí | La tarea, con el adaptador de chat | Obligatorio (máx. 4000 caracteres) |
|
|
60
|
+
| Un plan del repo | «reparte el plan de `planes/*.md`», adaptador plan-file | Opcional: qué plan |
|
|
61
|
+
| Tareas de spec-kit | «reparte `specs/<feature>/tasks.md`», adaptador speckit | Opcional: qué feature |
|
|
62
|
+
|
|
63
|
+
Las dos primeras dicen expresamente que **no hace falta spec-kit**: la skill `orca` reparte igual desde un texto o un plan. Después, el coordinador hace lo de siempre: decide si compensa repartir, te enseña el plan de rondas para que lo confirmes, lanza un agente por unidad en su worktree con su rol del equipo, integra y te pide confirmar el merge. Los agentes aparecen en la pestaña *Agentes*.
|
|
64
|
+
|
|
65
|
+
### Equipo
|
|
66
|
+
|
|
67
|
+
La pestaña *Equipo* edita un borrador (se guarda en el panel) y lo escribe en `ORCHESTRATION.md` §1 del proyecto activo con `omk team set --data <equipo>`, que es lo que la skill `orca` lee al repartir. `<equipo>` es el equipo en JSON y base64url: al terminal solo llegan letras, números, `-` y `_`, aunque los roles propios lleven texto libre; `omk team` lo valida otra vez entero antes de escribir.
|
|
68
|
+
|
|
69
|
+
| En el panel | En `ORCHESTRATION.md` §1 |
|
|
70
|
+
|---|---|
|
|
71
|
+
| Proveedores activos (casillas; al menos uno) | `- Proveedores activos: claude, codex` (conserva el comentario) |
|
|
72
|
+
| Revisión cruzada | `- Revisión cruzada (…): unidades L y sensibles` · `todas` · `nunca` |
|
|
73
|
+
| Un proveedor por rol de Olimpo | Una fila `Rol Casandra · Casandra / codex · equipo (omk team)` en «Excepciones al reparto por roles». `references/olimpo.md` la lee como «todas las unidades de ese rol van con ese proveedor» |
|
|
74
|
+
| Roles propios (hasta 10): nombre, qué hace, nivel, revisión, guardarraíl y proveedor | Una fila `**Hermes** · Traducciones · bajo · Argos · … <!-- omk team -->` en «Roles propios del proyecto» y, si lleva proveedor, su fila `Rol Hermes` en las excepciones. Se quitan `\|`, `<`, `>` y saltos de línea del texto |
|
|
75
|
+
| Coordinador | No se escribe: es el agente que lanza *Repartir* |
|
|
76
|
+
|
|
77
|
+
Los agentes se eligen de una lista: los habituales del catálogo de Orca (Claude Code, Codex, Gemini CLI, Antigravity, Copilot, Cursor, OpenCode…). Un nombre de rol propio no puede repetir uno de Olimpo ni otro propio.
|
|
78
|
+
|
|
79
|
+
Equipos predefinidos: *Solo Claude* (sin roles fijados; la revisión cruzada la hace una sesión nueva), *Claude + Codex revisor* (todo con Claude salvo Casandra, con Codex) y *Codex + Claude revisor* (al revés). Elegir uno conserva los roles propios; cualquier cambio a mano lo deja en *Personalizado*. `omk team` solo reescribe las filas que escribió él (`equipo (omk team)` y `<!-- omk team -->`); las que escribiste tú se quedan. Desde un terminal:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
omk team # el equipo del proyecto
|
|
83
|
+
omk team set --provider claude --provider codex --cross todas --role casandra=codex
|
|
84
|
+
omk team set --role casandra=auto # vuelve a decidirlo el coordinador
|
|
85
|
+
omk team set --autonomy auto # §0: manual, semi o auto
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
La tarjeta *Autonomía* de la misma pestaña cambia la línea `- Nivel:` de `ORCHESTRATION.md` §0 (`omk team set --autonomy manual|semi|auto`; el terminal solo recibe uno de esos tres literales). En *Repartir*, «Autonomía de este run» la cambia solo para el coordinador que lanzas: va en su prompt y no toca el fichero.
|
|
89
|
+
|
|
90
|
+
### Avisos y tarjeta del plan
|
|
91
|
+
|
|
92
|
+
- **Tarjeta del plan**: antes de pedir la confirmación 1, la skill `orca` escribe el plan en `.work/runs/<run>/plan.json` ([formato](../skills/orca/references/plan-card.md)). El plugin lo ve en el hook `agent.tool.after` (la herramienta `Write` de Claude Code, con su contenido), lo valida campo a campo (hasta 60 unidades, 10 notas y 200 caracteres por texto; lo que no encaja se descarta y queda en `orca plugin logs`) y lo pinta en *Avisos*, con una notificación. «Sí, lánzalo» escribe `sí` en el terminal del coordinador; «Pedir cambio», `cambia: <lo que pidas>`. Es lo mismo que escribirlo tú en su chat.
|
|
93
|
+
- **Coordinador en un chat de Orca**: ahí no llega el hook, así que cuando el coordinador se queda esperando el plugin busca `.work/runs/*/plan.json` en su workspace (solo ficheros de verdad, no enlaces; hasta 64 KB y 50 runs; solo los escritos después de arrancar el plugin). Como la API de plugins no escribe en chats, la respuesta va por el buzón del Run de Orca de la tarjeta (`orcaRun`): `orca orchestration send --from run:<orcaRun> --to run:<orcaRun> --subject "Respuesta desde el panel: …" --body <tu texto>`, y Orca la entrega al chat del coordinador. Sin `orcaRun`, se le responde en su chat.
|
|
94
|
+
- **Agentes que esperan**: un agente bloqueado (pide permiso) o esperando instrucciones sale con las 12 últimas líneas de su terminal, sin códigos de escape ni caracteres de control. La respuesta va a **su** terminal (el worker no acepta un terminal que venga del panel), en una sola línea de hasta 2000 caracteres, sin saltos ni caracteres de control, y con Intro.
|
|
95
|
+
- Un aviso desaparece al responderlo, al descartarlo o cuando el agente vuelve a trabajar; uno descartado no vuelve hasta que el agente cambie de estado.
|
|
19
96
|
|
|
20
97
|
### Por qué el contrato del worker
|
|
21
98
|
|
|
@@ -32,37 +109,54 @@ Es un plugin `trusted-worker`: Orca ejecuta `src/worker.ts` en un proceso Node a
|
|
|
32
109
|
|
|
33
110
|
| Capacidad | Para qué | Si no la concedes |
|
|
34
111
|
|---|---|---|
|
|
35
|
-
| `workspace:read` | Saber qué workspace está enfocado (`workspace.readContext` + `workspace.list`) y enterarse de los que se eliminan | Los comandos no saben dónde ejecutarse |
|
|
36
|
-
| `
|
|
37
|
-
| `terminal:
|
|
38
|
-
| `
|
|
39
|
-
| `agent:
|
|
40
|
-
| `
|
|
41
|
-
| `
|
|
112
|
+
| `workspace:read` | Saber qué workspace está enfocado y cómo se llama cada uno (`workspace.readContext` + `workspace.list`) y enterarse de los que se eliminan | Los comandos no saben dónde ejecutarse y los agentes salen sin workspace |
|
|
113
|
+
| `workspace:write` | Abrir el workspace de un agente al pulsarlo en el panel (`workspace.open`). El plugin no renombra workspaces ni ejecuta comandos de Orca | Pulsar un agente no hace nada |
|
|
114
|
+
| `terminal:send` | Abrir un terminal con `omk verify`, `omk update` u `omk team` (`terminal.create`); escribir tu respuesta de *Avisos* o `/model <alias>` en el terminal de un agente que sigue el plugin (`terminal.sendText`) | No hay comandos de verificar ni actualizar, no se aplican el equipo ni la autonomía, y no se puede responder ni cambiar el modelo desde el panel |
|
|
115
|
+
| `terminal:read` | Leer la salida de **ese** terminal para detectar que `omk` no existe y avisar, y las últimas líneas del terminal de un agente que espera, para su aviso | El fallo se ve en el terminal, pero no llega la notificación, y los avisos salen sin contexto |
|
|
116
|
+
| `agent:launch` | Lanzar el agente de «inicializar proyecto» y el coordinador de *Repartir* (`agent.launch`) | No hay comando de inicializar ni botón de repartir |
|
|
117
|
+
| `agent:read` | Contar y nombrar agentes para la barra, el panel y los avisos (`agents.list`, `agent.status.changed`) | La barra se queda en `MAW` |
|
|
118
|
+
| `notifications:show` | Avisos accionables (sin `omk`, sin workspace, fallos de Orca, agente bloqueado, run terminado) | Los avisos solo quedan en `orca plugin logs` |
|
|
119
|
+
| `settings:own` | Leer los cuatro ajustes del plugin, y cambiarlos desde el panel | Se usan los valores por defecto y el panel no puede guardarlos |
|
|
120
|
+
| `storage:own` | Guardar el historial (las 200 últimas entradas, clave `history.v1`) | El historial solo dura hasta que se reinicia el plugin |
|
|
42
121
|
|
|
43
|
-
|
|
122
|
+
Además observa dos hooks sin cambiar ni denegar nada: `agent.launch.before` (qué agente se lanza, en qué terminal y con qué `--model`) y `agent.tool.after` (solo le interesa un `Write` de `.work/runs/<run>/plan.json`; el resto de llamadas se descartan en el acto y no se guardan).
|
|
44
123
|
|
|
45
|
-
|
|
124
|
+
Lo que **no** hace: no envía a un **shell** texto libre de un usuario, de un agente o de un fichero. `omk verify` y `omk update` son literales fijos, `omk team set --autonomy` lleva uno de tres literales, y `omk team set --data` solo lleva base64url (letras, números, `-` y `_`) de un equipo que el worker ya validó entero (ids con `^[a-z0-9][a-z0-9-]{0,39}$`, roles, niveles y revisiones de listas cerradas, texto de los roles propios sin `|`, `<`, `>` ni caracteres de control); `omk team` lo valida otra vez. El id de agente se valida igual antes de pasarlo a `agent.launch`. La tarea de *Repartir* va como prompt al agente que eliges. Lo único que se escribe en el terminal de un agente es lo que tú escribes en *Avisos* (una línea, sin caracteres de control) y `/model <id>` con un id de modelo validado, y solo en terminales de agentes que el plugin sigue. No usa red ni secretos. Fuera de la API de Orca solo hace dos cosas, ambas para el coordinador que corre como chat: lee `.work/runs/*/plan.json` (`node:fs`, solo esos ficheros, sin seguir enlaces) y ejecuta el `orca` que trae la propia app (`resources/bin` junto a `Orca.exe`) con `orchestration send` (`node:child_process`, `execFile` **sin shell**: cada argumento va aparte, el id del Run se valida con `^run_[a-z0-9]{4,40}$` y tu respuesta va como un único argumento `--body`).
|
|
46
125
|
|
|
47
|
-
|
|
126
|
+
> **Seguridad**: cualquier agente del Run puede escribir en su buzón con `--from run:<id>`, así que un mensaje «Respuesta desde el panel» no prueba que lo escribieras tú. La skill `orca` solo lo acepta para la confirmación 1 (lanzar el plan o cambiarlo); el merge final y la limpieza (confirmaciones 2 y 3) solo valen escritos en el chat.
|
|
48
127
|
|
|
49
|
-
|
|
50
|
-
# Desde un clon o el zip de la release
|
|
51
|
-
orca plugin install ./orca-plugin --json
|
|
128
|
+
## Instalar
|
|
52
129
|
|
|
53
|
-
|
|
54
|
-
|
|
130
|
+
```bash
|
|
131
|
+
omk plugin install # enciende los plugins, enseña lo que pide el plugin y te pregunta antes de aprobarlo
|
|
132
|
+
omk plugin status # qué versión hay instalada y si es la de este kit
|
|
133
|
+
omk setup # todo el entorno: kit, Orca abierto, plugins encendidos, plugin y su panel
|
|
55
134
|
```
|
|
56
135
|
|
|
57
|
-
|
|
136
|
+
`omk plugin install` busca el CLI de Orca (en el `PATH` o donde lo deja el instalador de Orca; `OMK_ORCA` para indicar otro) y comprueba que su versión cumple `engines.orca`. Después:
|
|
137
|
+
|
|
138
|
+
- **No está instalado**: `orca plugin install <kit>/orca-plugin`. Orca contesta `approval_required` con lo que concedería; omk lo enseña y pregunta `¿Apruebas este acceso? [s/N]`. Solo con un sí repite la orden con `--approve <huella>`, la que da Orca, y solo si tiene el formato esperado. Sin terminal interactivo no aprueba nada: hay que repetir con `--yes`, que es tu aprobación dada de antemano.
|
|
139
|
+
- **Otra versión instalada desde esta carpeta**: `orca plugin update` (Orca vuelve a copiar la carpeta; si la versión nueva pide más acceso, se pregunta otra vez).
|
|
140
|
+
- **Otra versión instalada desde otra carpeta**: no la toca y dice cómo cambiarla (`omk plugin uninstall && omk plugin install`).
|
|
141
|
+
- **Esta versión, pendiente de aprobación**: `orca plugin enable` con el mismo flujo de aprobación.
|
|
142
|
+
- **Esta versión, desactivada por ti**: se respeta.
|
|
143
|
+
|
|
144
|
+
El plugin queda como `local.multiagent-kit`. A mano, sin omk: `orca plugin install ./orca-plugin --json` y, tras revisar lo que lista `error.data`, el comando con `--approve <fingerprint>` que da Orca. La huella está ligada a esta versión, sus ficheros y su acceso.
|
|
145
|
+
|
|
146
|
+
## Ajustes
|
|
147
|
+
|
|
148
|
+
Dos sitios, los mismos valores (cambiar uno cambia el otro, y el worker se entera al momento):
|
|
58
149
|
|
|
59
|
-
|
|
150
|
+
- El panel *Multiagent Kit* de la barra lateral derecha.
|
|
151
|
+
- *Settings → Plugins → Orca Multiagent Kit*, la página que Orca genera con los ajustes que declara el manifiesto (`contributes.settings`).
|
|
60
152
|
|
|
61
153
|
| Ajuste | Por defecto | Valores |
|
|
62
154
|
|---|---|---|
|
|
155
|
+
| Repartir al lanzar un agente con tarea | Activado | sí / no |
|
|
63
156
|
| Contrato del worker en los despachos | Solo despachos del kit | Solo del kit · Todos · Desactivado |
|
|
64
157
|
| Agentes en la barra de estado | Activado | sí / no |
|
|
65
|
-
|
|
|
158
|
+
| Avisos de agentes | Activado | sí / no |
|
|
159
|
+
| Agente para inicializar | Claude Code | Lista de agentes del catálogo de Orca |
|
|
66
160
|
|
|
67
161
|
## Desactivar o quitar
|
|
68
162
|
|
|
@@ -75,28 +169,32 @@ Sin plugin, el kit sigue funcionando igual. Solo se pierden la paleta, la barra
|
|
|
75
169
|
|
|
76
170
|
## Limitaciones
|
|
77
171
|
|
|
78
|
-
- **Barra de estado**: al arrancar solo conoce los agentes del workspace enfocado (`agents.list` no da más); los de los demás aparecen con su siguiente cambio de estado. Un agente cuyo terminal se cierra sin pasar a `done` sigue contando hasta que se elimina su workspace o se reinicia el plugin (`orca plugin restart local.multiagent-kit`).
|
|
172
|
+
- **Barra de estado**: al arrancar solo conoce los agentes del workspace enfocado (`agents.list` no da más); los de los demás aparecen con su siguiente cambio de estado. Un agente que Orca solo identifica por su panel (sin `terminalId`) no recibe el nombre de su despacho. Un agente cuyo terminal se cierra sin pasar a `done` sigue contando hasta que se elimina su workspace o se reinicia el plugin (`orca plugin restart local.multiagent-kit`).
|
|
79
173
|
- **Detección de `omk` ausente**: es heurística. Busca durante ~15 s el mensaje de "comando no encontrado" de bash, zsh, fish, cmd y PowerShell, en inglés y español. Con otros idiomas o shells, el error se ve en el terminal pero no llega la notificación.
|
|
80
174
|
- En un workspace remoto (SSH), `omk` se ejecuta en ese host, que es donde se usa el kit en ese workspace.
|
|
175
|
+
- **Chats de Orca**: un agente que corre como chat de Orca (sin terminal; es lo que lanza Orca para los workers si así lo tienes en sus ajustes de pestañas de agente) sale en *Avisos* y *Worktrees*, pero la API de plugins no puede escribir en un chat. La tarjeta del plan del coordinador sí se contesta desde el panel, por el buzón del Run (ver [Avisos y tarjeta del plan](#avisos-y-tarjeta-del-plan)); a los demás chats se les responde y se les cambia el modelo desde su chat («Ir a su workspace»).
|
|
176
|
+
- **Tarjeta del plan**: en un terminal la lee del `Write` de Claude Code (hook `agent.tool.after`; otros agentes nombran distinto su herramienta de escritura); en un chat, del disco cuando el coordinador espera, y solo en workspaces locales. Orca aún no engancha agentes por SSH o WSL: con ellos el plan sale solo en el chat.
|
|
177
|
+
- **Cambiar el modelo**: solo Claude Code (`/model`), y solo mientras espera instrucciones: trabajando, el texto acabaría en su turno; bloqueado, en el diálogo de permiso.
|
|
81
178
|
|
|
82
179
|
DEFERRED:
|
|
83
|
-
- **Progreso del run en la barra** (`ronda 1 · 2/3 unidades`): exige leer `.work/runs/<run>/units.md`, y la API de Orca no da acceso a ficheros a los workers. Hoy el coordinador lo deja en el comentario del worktree (`orca worktree set --comment`).
|
|
180
|
+
- **Progreso del run en la barra** (`ronda 1 · 2/3 unidades`): exige leer `.work/runs/<run>/units.md`, y la API de Orca no da acceso a ficheros a los workers (el plugin solo lee `plan.json`, con Node, para los chats; ampliarlo a más ficheros del proyecto queda fuera). Hoy el coordinador lo deja en el comentario del worktree (`orca worktree set --comment`).
|
|
84
181
|
- **Instalación desde Git** (`orca plugin install FernandoBaqueroo/orca-multiagent-kit`): la ayuda de `orca plugin install` (1.4.252) no documenta instalar desde una subcarpeta del repositorio. Haría falta un repo propio para el plugin o confirmar que Orca acepta una URL `tree/<ref>/orca-plugin`.
|
|
85
|
-
- **Instalación automática** con `install.sh` / `omk install`: ahora se instala a mano. Para hacerlo automático hay que tocar el instalador, y se deja para otro PR.
|
|
86
182
|
- **Preparar worktrees nuevos** (`workspace.create.after`): ya lo hacen `orca.yaml` (`scripts.setup`, `sharedDirectories`), `.worktreeinclude` y `worker-start --setup run`, que la skill pasa siempre; un hook duplicaría ese trabajo.
|
|
87
|
-
- **
|
|
183
|
+
- **Nivel de modelo en el panel**: el rol sale del despacho y el modelo de `--model` al arrancar, pero el nivel de cada unidad solo está en `.work/runs/<run>/run.md`, que el plugin no lee (sí en la tarjeta del plan, mientras espera confirmación).
|
|
184
|
+
- **Leer el equipo del proyecto en el panel**: el plugin no lee ficheros del proyecto (salvo `plan.json`); «Ver el del proyecto» lo enseña en un terminal con `omk team`.
|
|
88
185
|
|
|
89
186
|
## Probarlo
|
|
90
187
|
|
|
91
188
|
```bash
|
|
92
189
|
orca plugin validate orca-plugin --json # manifiesto como lo carga Orca
|
|
93
|
-
orca plugin test orca-plugin --json #
|
|
190
|
+
orca plugin test orca-plugin --json # 106 pruebas: src/kit.test.ts, src/worker.test.ts y src/panel.test.tsx
|
|
191
|
+
bash tests/test_team.sh # omk team sobre una copia de templates/ORCHESTRATION.md
|
|
94
192
|
orca plugin check orca-plugin --json
|
|
95
193
|
orca plugin inspect orca-plugin --json # qué aporta y qué acceso pide
|
|
96
194
|
bash scripts/check.sh # comprobación estática del manifiesto, también en CI (sin Orca)
|
|
97
195
|
```
|
|
98
196
|
|
|
99
|
-
Las pruebas usan `orca/testing`: `mountWorker` sobre un host simulado con las capacidades del manifiesto. Cubren el hook (con y sin cabecera del kit, otros `inputKind`, el modo apagado e idempotencia), los comandos (literal enviado, workspace sin identificar, fallo de Orca notificado, id de agente hostil)
|
|
197
|
+
Las pruebas usan `orca/testing`: `mountWorker` sobre un host simulado con las capacidades del manifiesto. Cubren el hook (con y sin cabecera del kit, otros `inputKind`, el modo apagado e idempotencia), los comandos (literal enviado, workspace sin identificar, fallo de Orca notificado, id de agente hostil) la barra (eventos, siembra inicial, desactivada), los nombres (título que no se pierde, despacho antes y después del estado, hook de lanzamiento), los avisos (bloqueo una sola vez, run terminado, apagados) y las peticiones del panel (abrir workspace, aplicar equipo en base64url con equipos hostiles rechazados, repartir con cada entrada). El panel se prueba con `mount`: fichas de agentes y botón de ir, repartir con y sin texto, equipos predefinidos, casillas de proveedores, roles propios incompletos y completos, ajustes con desplegables, cada botón con su acción y un fallo del worker enseñado; y el worker rechaza cualquier acción del panel fuera de las tres. La detección de `omk` ausente se prueba con los mensajes reales de cada shell.
|
|
100
198
|
|
|
101
199
|
Para probarlo en Orca sin instalarlo: `orca plugin dev watch orca-plugin --json`. También pide aprobación, y `Ctrl-C` lo descarga.
|
|
102
200
|
|
package/orca-plugin/README.md
CHANGED
|
@@ -9,4 +9,8 @@ orca plugin inspect . --json # qué aporta y qué acceso pide
|
|
|
9
9
|
```
|
|
10
10
|
|
|
11
11
|
- `src/kit.ts`: lógica pura (detección de despachos, mensajes de "comando no encontrado", resumen de agentes).
|
|
12
|
-
- `src/
|
|
12
|
+
- `src/protocol.ts`: el contrato entre panel y worker (peticiones y eventos), declarado una vez.
|
|
13
|
+
- `src/worker.ts`: el worker que Orca carga; solo habla con Orca por su API. Oye cada hook y evento una vez y lo reparte a `src/worker/{notices,worktrees,history}.ts` (`src/worker/context.ts`).
|
|
14
|
+
- `src/panel.tsx`: el panel; las pestañas Avisos, Worktrees, Historial y la autonomía viven en `src/tabs/`.
|
|
15
|
+
- `src/plan-card.ts`: valida el `plan.json` de la skill `orca` ([formato](../skills/orca/references/plan-card.md)).
|
|
16
|
+
- `assets/logos/`: los logos de agente que usa Orca, a 16 px (ver su README).
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# Logos de agente
|
|
2
|
+
|
|
3
|
+
Los mismos que usa Orca (1.4.257) junto a cada agente: los SVG de Claude, Codex, Copilot, OpenCode,
|
|
4
|
+
Droid y Aider de su catálogo de agentes, rasterizados (lo que Orca pinta con `currentColor` va en
|
|
5
|
+
gris claro, `#D4D4D8`), y las imágenes que trae embebidas para los demás. Recortados y a 16×16 px:
|
|
6
|
+
el panel los enseña pequeños, como Orca. Las marcas son de sus dueños y solo identifican a qué
|
|
7
|
+
agente se refiere cada fila. `agent.png` es el genérico del kit.
|
|
8
|
+
|
|
9
|
+
Para añadir uno: un PNG cuadrado de 16×16 con fondo transparente, `<id del agente>.png`, y su id en
|
|
10
|
+
`AGENT_LOGOS` de `src/icons.ts`.
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"manifestVersion": 2,
|
|
3
3
|
"id": "multiagent-kit",
|
|
4
4
|
"name": "Orca Multiagent Kit",
|
|
5
|
-
"version": "0.
|
|
6
|
-
"description": "Comandos del kit en la paleta, el contrato del worker en cada despacho de
|
|
5
|
+
"version": "0.6.0",
|
|
6
|
+
"description": "Comandos del kit en la paleta; un panel con los avisos que esperan tu respuesta (plan de rondas incluido), los agentes por nombre y con su icono, los worktrees de la orquestación y su modelo, el historial de runs, el equipo de roles y la autonomía, orquestar una tarea, las acciones y los ajustes; el contrato del worker en cada despacho del kit; avisos de agentes bloqueados y de runs terminados, y los agentes activos en la barra de estado.",
|
|
7
7
|
"author": {
|
|
8
8
|
"name": "Fernando Baquero y Necro-Coder",
|
|
9
9
|
"url": "https://github.com/FernandoBaqueroo/orca-multiagent-kit"
|
|
@@ -19,14 +19,19 @@
|
|
|
19
19
|
"main": "src/worker.ts",
|
|
20
20
|
"capabilities": [
|
|
21
21
|
{ "kind": "workspace:read" },
|
|
22
|
+
{ "kind": "workspace:write" },
|
|
22
23
|
{ "kind": "terminal:send" },
|
|
23
24
|
{ "kind": "terminal:read" },
|
|
24
25
|
{ "kind": "agent:launch" },
|
|
25
26
|
{ "kind": "agent:read" },
|
|
26
27
|
{ "kind": "notifications:show" },
|
|
27
|
-
{ "kind": "settings:own" }
|
|
28
|
+
{ "kind": "settings:own" },
|
|
29
|
+
{ "kind": "storage:own" }
|
|
28
30
|
],
|
|
29
31
|
"contributes": {
|
|
32
|
+
"panels": [
|
|
33
|
+
{ "id": "kit", "title": "Multiagent Kit", "icon": "bot", "entry": "src/panel.tsx", "ui": "components" }
|
|
34
|
+
],
|
|
30
35
|
"commands": [
|
|
31
36
|
{ "id": "kit.verify", "title": "Orca Multiagent Kit: verificar instalación", "when": "workspace" },
|
|
32
37
|
{ "id": "kit.init", "title": "Orca Multiagent Kit: inicializar proyecto", "when": "workspace" },
|
|
@@ -34,7 +39,9 @@
|
|
|
34
39
|
{ "id": "agents.status", "title": "Orca Multiagent Kit: estado de los agentes" }
|
|
35
40
|
],
|
|
36
41
|
"hooks": [
|
|
37
|
-
{ "event": "agent.prompt.before", "onError": "pass" }
|
|
42
|
+
{ "event": "agent.prompt.before", "onError": "pass" },
|
|
43
|
+
{ "event": "agent.launch.before", "onError": "pass" },
|
|
44
|
+
{ "event": "agent.tool.after" }
|
|
38
45
|
],
|
|
39
46
|
"events": [
|
|
40
47
|
{ "on": "agent.status.changed" },
|
|
@@ -66,14 +73,28 @@
|
|
|
66
73
|
"type": "boolean",
|
|
67
74
|
"default": true
|
|
68
75
|
},
|
|
76
|
+
{
|
|
77
|
+
"key": "autoOrchestrate",
|
|
78
|
+
"title": "Repartir al lanzar un agente con tarea",
|
|
79
|
+
"description": "Cuando Orca arranca un agente con una tarea (al crear un worktree, en una pestaña nueva o desde una issue), le añade que pase primero por la skill orca: decide si compensa repartirla entre agentes y, si compensa, la reparte. No necesita spec-kit.",
|
|
80
|
+
"type": "boolean",
|
|
81
|
+
"default": true
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"key": "notify",
|
|
85
|
+
"title": "Avisos de agentes",
|
|
86
|
+
"description": "Notifica cuando un agente se bloquea y cuando terminan todas las unidades lanzadas de un run del kit.",
|
|
87
|
+
"type": "boolean",
|
|
88
|
+
"default": true
|
|
89
|
+
},
|
|
69
90
|
{
|
|
70
91
|
"key": "initAgent",
|
|
71
92
|
"title": "Agente para inicializar",
|
|
72
|
-
"description": "
|
|
93
|
+
"description": "El agente que lanza «inicializar proyecto» con el prompt «inicializa el proyecto» (skill kit-init).",
|
|
73
94
|
"type": "string",
|
|
74
95
|
"default": "claude",
|
|
75
|
-
"
|
|
76
|
-
"
|
|
96
|
+
"enum": ["claude", "codex", "gemini", "antigravity", "copilot", "cursor", "opencode", "amp", "droid", "grok", "kimi", "qwen-code", "aider", "goose", "cline", "kiro", "devin"],
|
|
97
|
+
"enumLabels": ["Claude Code", "Codex", "Gemini CLI", "Antigravity", "GitHub Copilot", "Cursor", "OpenCode", "Amp", "Droid", "Grok", "Kimi", "Qwen Code", "Aider", "Goose", "Cline", "Kiro", "Devin"]
|
|
77
98
|
}
|
|
78
99
|
]
|
|
79
100
|
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { assert, test } from 'orca/testing'
|
|
2
|
+
import { agentIcon } from './icons.ts'
|
|
3
|
+
|
|
4
|
+
test('cada agente conocido tiene su logo y el resto el genérico', () => {
|
|
5
|
+
assert.equal(agentIcon('claude'), 'assets/logos/claude.png')
|
|
6
|
+
assert.equal(agentIcon('codex'), 'assets/logos/codex.png')
|
|
7
|
+
assert.equal(agentIcon('antigravity'), 'assets/logos/antigravity.png')
|
|
8
|
+
assert.equal(agentIcon('aider'), 'assets/logos/aider.png')
|
|
9
|
+
assert.equal(agentIcon('zcode'), 'assets/logos/agent.png')
|
|
10
|
+
assert.equal(agentIcon(null), 'assets/logos/agent.png')
|
|
11
|
+
// Un id raro nunca sale de la carpeta de iconos.
|
|
12
|
+
assert.equal(agentIcon('../../etc/passwd'), 'assets/logos/agent.png')
|
|
13
|
+
assert.equal(agentIcon('constructor'), 'assets/logos/agent.png')
|
|
14
|
+
})
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
// Logo de cada agente en el panel: los mismos que pinta Orca junto a sus worktrees y chats
|
|
2
|
+
// (assets/logos/, ver su README). Un agente sin logo propio lleva el genérico.
|
|
3
|
+
|
|
4
|
+
const ICON_DIR = 'assets/logos'
|
|
5
|
+
|
|
6
|
+
const AGENT_LOGOS: ReadonlySet<string> = new Set([
|
|
7
|
+
'aider',
|
|
8
|
+
'amp',
|
|
9
|
+
'antigravity',
|
|
10
|
+
'claude',
|
|
11
|
+
'cline',
|
|
12
|
+
'codex',
|
|
13
|
+
'copilot',
|
|
14
|
+
'cursor',
|
|
15
|
+
'devin',
|
|
16
|
+
'droid',
|
|
17
|
+
'gemini',
|
|
18
|
+
'goose',
|
|
19
|
+
'grok',
|
|
20
|
+
'kimi',
|
|
21
|
+
'kiro',
|
|
22
|
+
'opencode',
|
|
23
|
+
'qwen-code'
|
|
24
|
+
])
|
|
25
|
+
|
|
26
|
+
/** Ruta del logo de un agente dentro del plugin; el genérico si no se sabe cuál es. */
|
|
27
|
+
export function agentIcon(agent: string | null | undefined): string {
|
|
28
|
+
const file = agent && AGENT_LOGOS.has(agent) ? agent : 'agent'
|
|
29
|
+
return `${ICON_DIR}/${file}.png`
|
|
30
|
+
}
|