orca-multiagent-kit 1.5.0 → 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.
Files changed (66) hide show
  1. package/CHANGELOG.md +30 -1
  2. package/README.md +2 -1
  3. package/VERSION +1 -1
  4. package/bin/omk.js +7 -0
  5. package/bin/team.js +353 -0
  6. package/core/AGENTS.md +1 -1
  7. package/docs/PLUGIN-ORCA.md +107 -18
  8. package/orca-plugin/README.md +5 -1
  9. package/orca-plugin/assets/logos/README.md +10 -0
  10. package/orca-plugin/assets/logos/agent.png +0 -0
  11. package/orca-plugin/assets/logos/aider.png +0 -0
  12. package/orca-plugin/assets/logos/amp.png +0 -0
  13. package/orca-plugin/assets/logos/antigravity.png +0 -0
  14. package/orca-plugin/assets/logos/claude.png +0 -0
  15. package/orca-plugin/assets/logos/cline.png +0 -0
  16. package/orca-plugin/assets/logos/codex.png +0 -0
  17. package/orca-plugin/assets/logos/copilot.png +0 -0
  18. package/orca-plugin/assets/logos/cursor.png +0 -0
  19. package/orca-plugin/assets/logos/devin.png +0 -0
  20. package/orca-plugin/assets/logos/droid.png +0 -0
  21. package/orca-plugin/assets/logos/gemini.png +0 -0
  22. package/orca-plugin/assets/logos/goose.png +0 -0
  23. package/orca-plugin/assets/logos/grok.png +0 -0
  24. package/orca-plugin/assets/logos/kimi.png +0 -0
  25. package/orca-plugin/assets/logos/kiro.png +0 -0
  26. package/orca-plugin/assets/logos/opencode.png +0 -0
  27. package/orca-plugin/assets/logos/qwen-code.png +0 -0
  28. package/orca-plugin/orca-plugin.json +25 -7
  29. package/orca-plugin/src/icons.test.ts +14 -0
  30. package/orca-plugin/src/icons.ts +30 -0
  31. package/orca-plugin/src/kit.test.ts +456 -9
  32. package/orca-plugin/src/kit.ts +626 -21
  33. package/orca-plugin/src/models.test.ts +28 -0
  34. package/orca-plugin/src/models.ts +29 -0
  35. package/orca-plugin/src/node.d.ts +40 -0
  36. package/orca-plugin/src/panel-state.ts +28 -0
  37. package/orca-plugin/src/panel.test.tsx +228 -30
  38. package/orca-plugin/src/panel.tsx +482 -78
  39. package/orca-plugin/src/plan-card.test.ts +99 -0
  40. package/orca-plugin/src/plan-card.ts +107 -0
  41. package/orca-plugin/src/protocol.ts +166 -5
  42. package/orca-plugin/src/tabs/autonomy.tsx +70 -0
  43. package/orca-plugin/src/tabs/history.test.tsx +78 -0
  44. package/orca-plugin/src/tabs/history.tsx +118 -0
  45. package/orca-plugin/src/tabs/notices.test.tsx +183 -0
  46. package/orca-plugin/src/tabs/notices.tsx +274 -0
  47. package/orca-plugin/src/tabs/worktrees.test.tsx +130 -0
  48. package/orca-plugin/src/tabs/worktrees.tsx +138 -0
  49. package/orca-plugin/src/ui/agent-icon.tsx +13 -0
  50. package/orca-plugin/src/worker/context.test.ts +32 -0
  51. package/orca-plugin/src/worker/context.ts +92 -0
  52. package/orca-plugin/src/worker/history.test.ts +149 -0
  53. package/orca-plugin/src/worker/history.ts +181 -0
  54. package/orca-plugin/src/worker/notices.test.ts +356 -0
  55. package/orca-plugin/src/worker/notices.ts +291 -0
  56. package/orca-plugin/src/worker/system.test.ts +58 -0
  57. package/orca-plugin/src/worker/system.ts +122 -0
  58. package/orca-plugin/src/worker/worktrees.test.ts +177 -0
  59. package/orca-plugin/src/worker/worktrees.ts +188 -0
  60. package/orca-plugin/src/worker.test.ts +265 -22
  61. package/orca-plugin/src/worker.ts +318 -34
  62. package/package.json +2 -2
  63. package/skills/orca/SKILL.md +1 -0
  64. package/skills/orca/references/engine-orca.md +1 -0
  65. package/skills/orca/references/olimpo.md +1 -0
  66. package/skills/orca/references/plan-card.md +45 -0
@@ -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 panel lateral con acciones y ajustes, 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,13 +11,89 @@ 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: título y estado | Lo que ha ido contando la barra de estado |
15
- | **Panel *Multiagent Kit*** (barra lateral derecha, icono de robot) | Botones de verificar, inicializar y actualizar; los tres ajustes del plugin; los agentes activos | Panel de componentes (`src/panel.tsx`) que pide las acciones al worker (`kit.run`, solo esas tres) y lee y escribe los ajustes con `settings` |
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) |
16
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` |
17
- | **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 |
18
26
 
19
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.
20
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.
96
+
21
97
  ### Por qué el contrato del worker
22
98
 
23
99
  Con el motor Orca, la skill `orca` copia en el despacho solo parte del contrato (entorno §1.4, alcance §2, verificación §4 e informe §5), porque Orca ya le explica al worker cómo preguntar y cómo cerrar con `worker_done`. El hook añade una línea que remite al fichero completo, para que el worker tenga también el arranque y la implementación. Para eso:
@@ -33,15 +109,21 @@ Es un plugin `trusted-worker`: Orca ejecuta `src/worker.ts` en un proceso Node a
33
109
 
34
110
  | Capacidad | Para qué | Si no la concedes |
35
111
  |---|---|---|
36
- | `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 |
37
- | `terminal:send` | Abrir un terminal con `omk verify` / `omk update` (`terminal.create`) | No hay comandos de verificar ni actualizar |
38
- | `terminal:read` | Leer la salida de **ese** terminal para detectar que `omk` no existe y avisar | El fallo se ve en el terminal, pero no llega la notificación |
39
- | `agent:launch` | Lanzar el agente de «inicializar proyecto» (`agent.launch`) | No hay comando de inicializar |
40
- | `agent:read` | Contar agentes por estado para la barra (`agents.list`, `agent.status.changed`) | La barra se queda en `MAW` |
41
- | `notifications:show` | Avisos accionables (sin `omk`, sin workspace, fallos de Orca) | Los avisos solo quedan en `orca plugin logs` |
42
- | `settings:own` | Leer los tres ajustes del plugin, y cambiarlos desde el panel | Se usan los valores por defecto y el panel no puede guardarlos |
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 |
121
+
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).
123
+
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`).
43
125
 
44
- Lo que **no** hace: no envía al terminal texto que venga de un usuario, de un agente o de un fichero (los dos comandos son literales fijos). El id de agente del ajuste se valida (`^[a-z0-9][a-z0-9-]{0,39}$`) antes de pasarlo a `agent.launch`. No usa red, secretos ni almacenamiento, no lee ficheros del proyecto y no importa módulos de Node (`fs`, `child_process`…): todo pasa por la API de Orca y sus capacidades.
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.
45
127
 
46
128
  ## Instalar
47
129
 
@@ -70,9 +152,11 @@ Dos sitios, los mismos valores (cambiar uno cambia el otro, y el worker se enter
70
152
 
71
153
  | Ajuste | Por defecto | Valores |
72
154
  |---|---|---|
155
+ | Repartir al lanzar un agente con tarea | Activado | sí / no |
73
156
  | Contrato del worker en los despachos | Solo despachos del kit | Solo del kit · Todos · Desactivado |
74
157
  | Agentes en la barra de estado | Activado | sí / no |
75
- | Agente para inicializar | `claude` | Id de agente de Orca (`claude`, `codex`…) |
158
+ | Avisos de agentes | Activado | sí / no |
159
+ | Agente para inicializar | Claude Code | Lista de agentes del catálogo de Orca |
76
160
 
77
161
  ## Desactivar o quitar
78
162
 
@@ -85,27 +169,32 @@ Sin plugin, el kit sigue funcionando igual. Solo se pierden la paleta, la barra
85
169
 
86
170
  ## Limitaciones
87
171
 
88
- - **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`).
89
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.
90
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.
91
178
 
92
179
  DEFERRED:
93
- - **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`).
94
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`.
95
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.
96
- - **Rol y modelo en la barra de estado**: la barra cuenta agentes por estado, pero no sabe qué rol de Olimpo ni qué nivel de modelo tiene cada uno; eso está en `.work/runs/<run>/run.md`, que el plugin no puede leer.
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`.
97
185
 
98
186
  ## Probarlo
99
187
 
100
188
  ```bash
101
189
  orca plugin validate orca-plugin --json # manifiesto como lo carga Orca
102
- orca plugin test orca-plugin --json # 48 pruebas: src/kit.test.ts, src/worker.test.ts y src/panel.test.tsx
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
103
192
  orca plugin check orca-plugin --json
104
193
  orca plugin inspect orca-plugin --json # qué aporta y qué acceso pide
105
194
  bash scripts/check.sh # comprobación estática del manifiesto, también en CI (sin Orca)
106
195
  ```
107
196
 
108
- 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) y la barra (eventos, siembra inicial, desactivada). El panel se prueba con `mount`: ajustes leídos y guardados, id de agente no válido rechazado, cada botón con su acción, un fallo del worker enseñado y los agentes que envía el worker; 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.
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.
109
198
 
110
199
  Para probarlo en Orca sin instalarlo: `orca plugin dev watch orca-plugin --json`. También pide aprobación, y `Ctrl-C` lo descarga.
111
200
 
@@ -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/worker.ts`: el worker que Orca carga; solo habla con Orca por su API.
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
@@ -2,8 +2,8 @@
2
2
  "manifestVersion": 2,
3
3
  "id": "multiagent-kit",
4
4
  "name": "Orca Multiagent Kit",
5
- "version": "0.2.0",
6
- "description": "Comandos del kit en la paleta, un panel con las acciones y los ajustes, el contrato del worker en cada despacho de orquestación del kit y los agentes activos en la barra de estado.",
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,12 +19,14 @@
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": {
30
32
  "panels": [
@@ -37,7 +39,9 @@
37
39
  { "id": "agents.status", "title": "Orca Multiagent Kit: estado de los agentes" }
38
40
  ],
39
41
  "hooks": [
40
- { "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" }
41
45
  ],
42
46
  "events": [
43
47
  { "on": "agent.status.changed" },
@@ -69,14 +73,28 @@
69
73
  "type": "boolean",
70
74
  "default": true
71
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
+ },
72
90
  {
73
91
  "key": "initAgent",
74
92
  "title": "Agente para inicializar",
75
- "description": "Id del agente que lanza «inicializar proyecto» con el prompt «inicializa el proyecto» (skill kit-init), por ejemplo claude o codex.",
93
+ "description": "El agente que lanza «inicializar proyecto» con el prompt «inicializa el proyecto» (skill kit-init).",
76
94
  "type": "string",
77
95
  "default": "claude",
78
- "maxLength": 40,
79
- "placeholder": "claude"
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"]
80
98
  }
81
99
  ]
82
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
+ }