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/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,48 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y e
|
|
|
5
5
|
|
|
6
6
|
## [Unreleased]
|
|
7
7
|
|
|
8
|
+
## [1.6.0] - 2026-11-12
|
|
9
|
+
|
|
10
|
+
### Añadido
|
|
11
|
+
- **`omk team`**: enseña y cambia el equipo de roles del proyecto en `ORCHESTRATION.md` §1 (proveedores activos, revisión cruzada, un proveedor fijo por rol de Olimpo y roles propios del proyecto) sin tocar lo escrito a mano. `--data` recibe el equipo entero en base64url (lo usa el panel). Pruebas en `tests/test_team.sh`.
|
|
12
|
+
- **Plugin v0.5.0**: orquestación sin spec-kit. Todo agente que Orca arranca con una tarea (crear un worktree con tarea, pestaña nueva, issue) pasa primero por la skill `orca`, que decide si compensa repartir (ajuste *Repartir al lanzar un agente con tarea*, activado por defecto).
|
|
13
|
+
- Panel del plugin en pestañas *Agentes*, *Repartir*, *Equipo* y *Kit*.
|
|
14
|
+
- *Agentes*: cada agente con nombre (`U2 · Ariadna — Pagos` en los despachos del kit, el título de Orca o el agente que es), agrupados por run o workspace, los bloqueados primero; cada uno con su ficha (agente, unidad, rol y nivel, run, workspace, rama, carpeta, terminal o chat, último turno, desde cuándo) y un botón para ir a su workspace.
|
|
15
|
+
- *Repartir*: lanza el coordinador con la skill `orca` desde lo que escribes, un plan del repo o spec-kit; las dos primeras no necesitan spec-kit.
|
|
16
|
+
- *Equipo*: equipos predefinidos (Solo Claude, Claude + Codex revisor, Codex + Claude revisor) o personalizado; proveedores con casillas, un proveedor por rol de Olimpo y roles propios (nombre, qué hace, nivel, revisión, guardarraíl, proveedor). «Aplicar al proyecto» ejecuta `omk team set --data`.
|
|
17
|
+
- Los agentes (inicializar, coordinador, proveedores) se eligen de una lista con el catálogo de Orca, no se escriben.
|
|
18
|
+
- Avisos (ajuste *Avisos de agentes*) cuando un agente se bloquea y cuando terminan todas las unidades lanzadas de un run. El tooltip de la barra nombra a los agentes.
|
|
19
|
+
- **Plugin v0.6.0**: pestañas *Avisos*, *Worktrees* e *Historial*, iconos de agente y autonomía.
|
|
20
|
+
- *Avisos*: la tarjeta del plan de rondas del coordinador, en colores, con «Sí, lánzalo» y «Pedir cambio», que se escriben en su terminal; y los agentes bloqueados o esperando, con las últimas líneas de su terminal y una caja para responderles. La skill `orca` escribe el plan en `.work/runs/<run>/plan.json` (`references/plan-card.md`) y el plugin lo lee del hook `agent.tool.after`.
|
|
21
|
+
- Con el coordinador como chat de Orca (sin terminal), la tarjeta también sale y se contesta: el plugin lee `plan.json` del disco cuando el coordinador espera, y manda la respuesta por el buzón del Run de Orca (`orcaRun` en la tarjeta, `orca orchestration send` sin shell). La skill solo acepta esas respuestas para la confirmación 1.
|
|
22
|
+
- *Worktrees*: los worktrees de la orquestación por run, con sus agentes, estado y modelo (de `--model`), y «Cambiar modelo» (`/model`) para un Claude Code que espera.
|
|
23
|
+
- *Historial*: despachos, bloqueos, finales de unidad, runs terminados y lo que haces desde el panel; las 200 últimas entradas, guardadas en el plugin.
|
|
24
|
+
- El logo de cada agente, los mismos que usa Orca y a su tamaño (16 px), delante de cada agente y cada worktree; uno genérico para los que no tienen.
|
|
25
|
+
- Autonomía: en *Equipo*, la del proyecto (`ORCHESTRATION.md` §0); en *Repartir*, otra solo para ese run.
|
|
26
|
+
- **`omk team set --autonomy manual|semi|auto`**: cambia la línea `- Nivel:` de `ORCHESTRATION.md` §0; `omk team` la enseña.
|
|
27
|
+
|
|
28
|
+
### Corregido
|
|
29
|
+
- Plugin: el resultado de cada acción salía como «Consejo» (Orca pinta así un aviso sin título). Ahora dice «Hecho» o «No se pudo» y se puede cerrar.
|
|
30
|
+
- Plugin: los agentes salían «sin título» en el panel y en la barra. Cada cambio de estado sin título borraba el que ya se conocía; no se usaban ni el agente (`agents.list`, hook `agent.launch.before`, panel de los chats de Orca) ni el despacho del kit; y el workspace de los eventos (`<repo>::<ruta>`) no casaba con el de `workspace.list` (`identity:…`).
|
|
31
|
+
|
|
32
|
+
### Cambiado
|
|
33
|
+
- El plugin pide `workspace:write` (abrir el workspace de un agente) y observa el hook `agent.launch.before`; hay que volver a aprobarlo (`omk plugin install`).
|
|
34
|
+
- La v0.6.0 del plugin pide además `storage:own` (historial) y observa `agent.tool.after` (tarjeta del plan): otra aprobación.
|
|
35
|
+
|
|
36
|
+
## [1.5.0] - 2026-11-11
|
|
37
|
+
|
|
38
|
+
Orca listo de una vez: `omk setup`, un ejecutable sin Node y el plugin configurable desde un panel. Detalle en [`docs/EJECUTABLE.md`](docs/EJECUTABLE.md).
|
|
39
|
+
|
|
40
|
+
### Añadido
|
|
41
|
+
- **`omk setup`**: instala el kit, abre Orca si hace falta, enciende los plugins, instala (o actualiza, o aprueba) el plugin del kit y abre su panel. Enseña lo que pide el plugin y pregunta antes de aprobarlo; `--yes` lo aprueba de antemano, `--dry-run` simula, `--no-plugin` solo instala el kit.
|
|
42
|
+
- **`omk plugin install|status|uninstall`**: el plugin de Orca sin copiar comandos de `orca plugin`. No toca una versión instalada desde otra carpeta ni reactiva un plugin que desactivaste.
|
|
43
|
+
- **Ejecutable autónomo** (`omk-windows-x64.exe`, `omk-macos-arm64`, `omk-linux-x64`, Node SEA): con doble clic hace `omk setup`, se copia al `PATH` del usuario (en Windows, en el registro, conservando las variables sin expandir) y extrae el kit a una carpeta estable. `scripts/build-exe.js` lo construye; la release lo adjunta con su `.sha256`.
|
|
44
|
+
- **Panel *Multiagent Kit*** en el plugin (v0.2.0): verificar, inicializar y actualizar con un botón, los tres ajustes del plugin (los mismos de *Settings → Plugins*) y los agentes activos.
|
|
45
|
+
- Pruebas: `tests/test_orca.sh` (contra un doble del CLI de Orca), `tests/test_exe.sh` y las del panel; la CI construye y prueba el ejecutable en Linux, macOS y Windows.
|
|
46
|
+
|
|
47
|
+
### Cambiado
|
|
48
|
+
- La notificación «omk no está instalado» del plugin menciona el ejecutable y que hay que reiniciar Orca.
|
|
49
|
+
|
|
8
50
|
## [1.4.1] - 2026-11-11
|
|
9
51
|
|
|
10
52
|
### Corregido
|
|
@@ -128,7 +170,9 @@ Primera versión de **Orca Multiagent Kit**. Une CSR (Claude Session Rules, de [
|
|
|
128
170
|
### Eliminado
|
|
129
171
|
- Copias duplicadas de reglas y skills `csr-*` dentro de cada agente, y el plugin `claude-session-rules` de Antigravity.
|
|
130
172
|
|
|
131
|
-
[Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.
|
|
173
|
+
[Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.6.0...HEAD
|
|
174
|
+
[1.6.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.5.0...v1.6.0
|
|
175
|
+
[1.5.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.1...v1.5.0
|
|
132
176
|
[1.4.1]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.0...v1.4.1
|
|
133
177
|
[1.4.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.3.0...v1.4.0
|
|
134
178
|
[1.3.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.2.0...v1.3.0
|
package/README.md
CHANGED
|
@@ -66,7 +66,9 @@ npx orca-multiagent-kit install
|
|
|
66
66
|
<a id="instalar"></a>
|
|
67
67
|
## <img src="assets/icons/download.svg" width="22" height="22" alt=""> Instalar
|
|
68
68
|
|
|
69
|
-
|
|
69
|
+
Cinco formas. Todas instalan lo mismo, hacen backup de lo que tocan y se deshacen con `omk restore`.
|
|
70
|
+
|
|
71
|
+
**0. Ejecutable, para Orca** (sin Node): descarga el de tu sistema desde la [última release](https://github.com/FernandoBaqueroo/orca-multiagent-kit/releases/latest) (`omk-windows-x64.exe`, `omk-macos-arm64`, `omk-linux-x64`) y ábrelo. Prepara Orca entero: instala el kit, enciende los plugins, instala el plugin del kit (te enseña lo que pide y te pregunta antes de aprobarlo), abre su panel y deja `omk` en el PATH. Con el kit ya instalado por npm, lo mismo es `omk setup`. Detalle: [`docs/EJECUTABLE.md`](docs/EJECUTABLE.md).
|
|
70
72
|
|
|
71
73
|
**1. npx** (Node ≥ 18, sin instalar nada global)
|
|
72
74
|
```bash
|
|
@@ -102,7 +104,10 @@ Requisitos: macOS, Linux, WSL o Git Bash, con bash ≥ 3.2.
|
|
|
102
104
|
|
|
103
105
|
| Comando | Qué hace |
|
|
104
106
|
|:--|:--|
|
|
107
|
+
| `omk setup [--yes] [--dry-run]` | Prepara Orca entero: kit, plugins encendidos, plugin del kit y su panel |
|
|
105
108
|
| `omk install [--agents a,b] [--dry-run]` | Instala o migra la fuente única para los agentes detectados |
|
|
109
|
+
| `omk plugin install\|status\|uninstall` | El plugin de Orca del kit; `install` pide tu aprobación (o `--yes`) |
|
|
110
|
+
| `omk team` · `omk team set …` | Enseña o cambia el equipo de roles del proyecto (`ORCHESTRATION.md` §1): proveedores, revisión cruzada y proveedor por rol |
|
|
106
111
|
| `omk init [ruta]` | Prepara un proyecto (por defecto, la carpeta actual) |
|
|
107
112
|
| `omk verify` | Comprueba enlaces, imports y que no queden copias divergentes |
|
|
108
113
|
| `omk adopt <carpeta-skill>` | Comparte una skill externa (p. ej. impeccable) con todos los agentes |
|
|
@@ -147,7 +152,7 @@ Solo tienes que conocer dos frases. El resto lo deciden los agentes.
|
|
|
147
152
|
|
|
148
153
|
Convive con skills externas como **impeccable**, **supabase**, **spec-kit** y las de la app **Orca**: cada una manda en su terreno, y la puerta de validez y las prohibiciones se aplican siempre.
|
|
149
154
|
|
|
150
|
-
**Plugin de Orca** (opcional, Orca ≥ 1.4.248): `omk verify`, «inicializa el proyecto» y `omk update` en la paleta de comandos, el contrato del worker añadido a cada despacho de orquestación del kit y los agentes activos en la barra de estado.
|
|
155
|
+
**Plugin de Orca** (opcional, Orca ≥ 1.4.248): `omk verify`, «inicializa el proyecto» y `omk update` en la paleta de comandos y en un panel lateral, *Multiagent Kit*, que además enseña los agentes con nombre y su ficha (unidad, rol, rama, estado…), configura el equipo de roles (también roles propios), reparte una tarea entre agentes (sin necesidad de spec-kit) y cambia los ajustes del plugin (los mismos de *Settings → Plugins*); el contrato del worker añadido a cada despacho de orquestación del kit, avisos de agentes bloqueados y de runs terminados, y los agentes activos en la barra de estado. Se instala con `omk plugin install` (o `omk setup`). Detalle, permisos que pide y cómo desactivarlo: [`docs/PLUGIN-ORCA.md`](docs/PLUGIN-ORCA.md).
|
|
151
156
|
|
|
152
157
|
<a id="flujo"></a>
|
|
153
158
|
## <img src="assets/icons/flow.svg" width="22" height="22" alt=""> Flujo de trabajo
|
|
@@ -184,22 +189,22 @@ flowchart LR
|
|
|
184
189
|
|
|
185
190
|
```text
|
|
186
191
|
orca-multiagent-kit/
|
|
187
|
-
├── bin/
|
|
192
|
+
├── bin/ CLI omk (npm / npx / ejecutable), sin dependencias: omk · setup · orca · sea
|
|
188
193
|
├── core/AGENTS.md núcleo siempre cargado (~80 líneas)
|
|
189
194
|
├── rules/ 00-router … 95-multi-agent + lang/ (17 lenguajes)
|
|
190
195
|
├── skills/ kit-init · orca · speckit-orca-implement · csr-*
|
|
191
196
|
├── speckit-extension/ extensión de spec-kit (hook before_implement)
|
|
192
197
|
├── templates/ AGENTS.md · CLAUDE.md · STACK.md · ORCHESTRATION.md · orca.yaml · .worktreeinclude · models.md
|
|
193
198
|
├── output-styles/ csr-minimal (Claude Code)
|
|
194
|
-
├── orca-plugin/ plugin de Orca: comandos del kit, contrato del worker, barra de estado
|
|
199
|
+
├── orca-plugin/ plugin de Orca: comandos y panel del kit, contrato del worker, barra de estado
|
|
195
200
|
├── install.sh instala · migra · verifica · restaura · adopta
|
|
196
201
|
├── GUIA.html guía visual del flujo
|
|
197
202
|
├── site/ web interactiva (GitHub Pages)
|
|
198
203
|
├── docs/MANUAL.md manual completo
|
|
199
204
|
├── AI_INSTALL.md instrucciones para que una IA lo instale
|
|
200
|
-
├── tests/ pruebas del instalador
|
|
201
|
-
├── scripts/ check.sh · build-release.sh · get.sh · banner.py
|
|
202
|
-
└── .github/ CI (Linux + macOS), releases con zip, web, plantillas
|
|
205
|
+
├── tests/ pruebas del instalador, del CLI, de omk setup (doble de Orca) y del ejecutable
|
|
206
|
+
├── scripts/ check.sh · build-release.sh · build-exe.js · get.sh · banner.py
|
|
207
|
+
└── .github/ CI (Linux + macOS; ejecutable también en Windows), releases con zip y ejecutables, web, plantillas
|
|
203
208
|
```
|
|
204
209
|
|
|
205
210
|
<a id="documentacion"></a>
|
|
@@ -213,6 +218,7 @@ orca-multiagent-kit/
|
|
|
213
218
|
| [`AI_INSTALL.md`](AI_INSTALL.md) | Una IA que tiene que instalar o integrar el kit |
|
|
214
219
|
| [`docs/OLIMPO.md`](docs/OLIMPO.md) | Roles, niveles de modelo, recurso por unidad y ciclo de vida de los worktrees |
|
|
215
220
|
| [`docs/PLUGIN-ORCA.md`](docs/PLUGIN-ORCA.md) | Quien usa Orca y quiere el kit integrado en la app |
|
|
221
|
+
| [`docs/EJECUTABLE.md`](docs/EJECUTABLE.md) | Quien quiere preparar Orca de una vez (`omk setup` o el ejecutable), o construir el ejecutable |
|
|
216
222
|
| [`CHANGELOG.md`](CHANGELOG.md) | Historial de versiones ([SemVer](https://semver.org/lang/es/)) |
|
|
217
223
|
|
|
218
224
|
<a id="contribuir"></a>
|
package/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.6.0
|
package/bin/omk.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
// omk — CLI de Orca Multiagent Kit. Sin dependencias: envuelve install.sh con comandos cortos.
|
|
2
|
+
// omk — CLI de Orca Multiagent Kit. Sin dependencias: envuelve install.sh con comandos cortos y prepara Orca.
|
|
3
3
|
'use strict';
|
|
4
4
|
|
|
5
5
|
const { spawn, spawnSync } = require('node:child_process');
|
|
@@ -11,6 +11,9 @@ const KIT = path.resolve(__dirname, '..');
|
|
|
11
11
|
const VERSION = fs.readFileSync(path.join(KIT, 'VERSION'), 'utf8').trim();
|
|
12
12
|
const REPO = 'orca-multiagent-kit';
|
|
13
13
|
const AGENTS_HOME = process.env.AGENT_KIT_HOME || path.join(os.homedir(), '.agents');
|
|
14
|
+
const RELEASES = 'https://github.com/FernandoBaqueroo/orca-multiagent-kit/releases/latest';
|
|
15
|
+
// Ejecutable autónomo (Node SEA, bin/sea.js)
|
|
16
|
+
const STANDALONE = require('./orca').isSea;
|
|
14
17
|
|
|
15
18
|
const color = process.stdout.isTTY && !process.env.NO_COLOR;
|
|
16
19
|
const lime = (s) => (color ? `\x1b[38;5;154m${s}\x1b[0m` : s);
|
|
@@ -24,9 +27,12 @@ ${bold('Uso')}
|
|
|
24
27
|
omk <comando> [opciones]
|
|
25
28
|
|
|
26
29
|
${bold('Comandos')}
|
|
30
|
+
${lime('setup')} [--yes] [--dry-run] Prepara Orca entero: kit, plugins, plugin del kit y su panel
|
|
27
31
|
${lime('install')} [--agents a,b] [--dry-run] Instala o migra la fuente única en ~/.agents
|
|
28
32
|
${lime('init')} [ruta] Prepara un proyecto (por defecto, la carpeta actual)
|
|
29
33
|
${lime('verify')} Comprueba enlaces, imports y copias divergentes
|
|
34
|
+
${lime('plugin')} install|status|uninstall El plugin de Orca del kit (install pide tu aprobación)
|
|
35
|
+
${lime('team')} [set …] Enseña o cambia el equipo de roles y la autonomía de ORCHESTRATION.md
|
|
30
36
|
${lime('adopt')} <carpeta-skill> Comparte una skill externa con todos los agentes
|
|
31
37
|
${lime('backups')} Lista las copias de seguridad
|
|
32
38
|
${lime('restore')} <fecha> Deshace una instalación (fecha de "omk backups")
|
|
@@ -38,9 +44,11 @@ ${bold('Comandos')}
|
|
|
38
44
|
${bold('Agentes')} claude · antigravity · codex · copilot · cursor · devin (opcional)
|
|
39
45
|
|
|
40
46
|
${bold('Ejemplos')}
|
|
47
|
+
omk setup ${dim('todo de una vez; pregunta antes de aprobar el plugin')}
|
|
41
48
|
npx orca-multiagent-kit install --dry-run
|
|
42
49
|
omk install
|
|
43
50
|
omk init ~/Dev/mi-app
|
|
51
|
+
omk team set --provider claude --provider codex --role casandra=codex
|
|
44
52
|
omk adopt ~/.gemini/config/plugins/user-workflows/skills/impeccable
|
|
45
53
|
`;
|
|
46
54
|
|
|
@@ -68,15 +76,30 @@ function findBash() {
|
|
|
68
76
|
die('Windows necesita Git Bash. Instala Git for Windows, define OMK_BASH con la ruta de su bash.exe, o ejecuta omk dentro de WSL (instala en el $HOME de WSL).');
|
|
69
77
|
}
|
|
70
78
|
|
|
71
|
-
|
|
79
|
+
/** Ejecuta install.sh dibujando su salida; resuelve con su código de salida. */
|
|
80
|
+
function installer(args) {
|
|
72
81
|
const child = spawn(findBash(), [path.join(KIT, 'install.sh'), ...args], {
|
|
73
82
|
stdio: ['inherit', 'pipe', 'pipe'],
|
|
74
83
|
env: { ...process.env, OMK_CLI: '1', OMK_EVENTS: '1' },
|
|
75
84
|
});
|
|
76
85
|
child.on('error', (e) => die(e.message));
|
|
77
86
|
// Ctrl+C: deja la terminal limpia (sin el spinner a medias)
|
|
78
|
-
|
|
79
|
-
|
|
87
|
+
const onInterrupt = () => { process.stdout.write('\r\x1b[2K'); child.kill('SIGINT'); process.exit(130); };
|
|
88
|
+
process.on('SIGINT', onInterrupt);
|
|
89
|
+
return require('./ui').render(child).finally(() => process.off('SIGINT', onInterrupt));
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
function runInstaller(args) {
|
|
93
|
+
installer(args).then((code) => process.exit(code));
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
// Un fallo inesperado de setup/plugin se cuenta y sale con error; nunca se queda a medias en silencio.
|
|
97
|
+
function finish(promise) {
|
|
98
|
+
const { pauseIfAsked } = require('./setup');
|
|
99
|
+
promise
|
|
100
|
+
.catch((e) => { process.stderr.write(`omk: ${e.message}\n`); return 1; })
|
|
101
|
+
.then(pauseIfAsked)
|
|
102
|
+
.then((code) => process.exit(code));
|
|
80
103
|
}
|
|
81
104
|
|
|
82
105
|
function listBackups() {
|
|
@@ -88,6 +111,19 @@ function listBackups() {
|
|
|
88
111
|
const [cmd = 'help', ...rest] = process.argv.slice(2);
|
|
89
112
|
|
|
90
113
|
switch (cmd) {
|
|
114
|
+
case 'setup':
|
|
115
|
+
finish(require('./setup').setup({ kit: KIT, args: rest, installer, standalone: STANDALONE }));
|
|
116
|
+
break;
|
|
117
|
+
|
|
118
|
+
case 'plugin':
|
|
119
|
+
finish(require('./setup').plugin({ kit: KIT, args: rest }));
|
|
120
|
+
break;
|
|
121
|
+
|
|
122
|
+
case 'team':
|
|
123
|
+
// exitCode y no exit(): deja terminar de escribir la salida cuando va a una tubería.
|
|
124
|
+
process.exitCode = require('./team').main(rest);
|
|
125
|
+
break;
|
|
126
|
+
|
|
91
127
|
case 'install':
|
|
92
128
|
case 'i':
|
|
93
129
|
runInstaller(rest);
|
|
@@ -124,6 +160,13 @@ switch (cmd) {
|
|
|
124
160
|
break;
|
|
125
161
|
|
|
126
162
|
case 'update': {
|
|
163
|
+
if (STANDALONE) {
|
|
164
|
+
// El ejecutable no se actualiza solo: la versión nueva es otro binario que se descarga.
|
|
165
|
+
console.log(`${lime('›')} Este omk es el ejecutable autónomo v${VERSION}. La última versión está en ${RELEASES}`);
|
|
166
|
+
console.log(dim(' Descárgala y ejecútala (o «omk setup» con ella). Reaplicando ahora la instalación de esta versión…'));
|
|
167
|
+
runInstaller(rest.filter((a) => a !== '--force'));
|
|
168
|
+
break;
|
|
169
|
+
}
|
|
127
170
|
const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
|
|
128
171
|
const sh = { encoding: 'utf8', shell: process.platform === 'win32' };
|
|
129
172
|
const latest = (spawnSync(npm, ['view', REPO, 'version'], sh).stdout || '').trim();
|
package/bin/orca.js
ADDED
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
// Integración de omk con la app Orca: localizar su CLI, encender los plugins e instalar el del kit.
|
|
2
|
+
// Solo habla con Orca por su CLI (`orca … --json`): nunca escribe en sus ficheros.
|
|
3
|
+
'use strict';
|
|
4
|
+
|
|
5
|
+
const { spawnSync } = require('node:child_process');
|
|
6
|
+
const fs = require('node:fs');
|
|
7
|
+
const os = require('node:os');
|
|
8
|
+
const path = require('node:path');
|
|
9
|
+
|
|
10
|
+
const PLUGIN_ID = 'multiagent-kit';
|
|
11
|
+
const PANEL_ID = 'kit';
|
|
12
|
+
// `orca plugin install|update|enable` salen con 3 cuando falta la aprobación del usuario.
|
|
13
|
+
const APPROVAL_EXIT = 3;
|
|
14
|
+
const FINGERPRINT = /^ap1-[0-9a-f]{8,128}$/;
|
|
15
|
+
const TIMEOUT_MS = 120000;
|
|
16
|
+
// `orca open` espera a que arranque la app.
|
|
17
|
+
const OPEN_TIMEOUT_MS = 180000;
|
|
18
|
+
|
|
19
|
+
/** [mayor, menor, parche] de la primera versión x.y.z del texto, o null. */
|
|
20
|
+
function parseVersion(text) {
|
|
21
|
+
const m = /(\d+)\.(\d+)\.(\d+)/.exec(String(text || ''));
|
|
22
|
+
return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** Si `version` cumple un requisito `>=x.y.z` (el único formato de engines.orca). */
|
|
26
|
+
function satisfies(version, range) {
|
|
27
|
+
const have = parseVersion(version);
|
|
28
|
+
const need = parseVersion(range);
|
|
29
|
+
if (!have || !need) return false;
|
|
30
|
+
for (let i = 0; i < 3; i += 1) if (have[i] !== need[i]) return have[i] > need[i];
|
|
31
|
+
return true;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** Rutas donde suele estar el CLI de Orca cuando no está en el PATH. */
|
|
35
|
+
function knownOrcaPaths(platform = process.platform, env = process.env, home = os.homedir()) {
|
|
36
|
+
if (platform === 'win32') {
|
|
37
|
+
return env.LOCALAPPDATA ? [path.join(env.LOCALAPPDATA, 'Programs', 'orca', 'resources', 'bin', 'orca.exe')] : [];
|
|
38
|
+
}
|
|
39
|
+
if (platform === 'darwin') {
|
|
40
|
+
return ['/Applications/Orca.app', path.join(home, 'Applications', 'Orca.app')].map((app) =>
|
|
41
|
+
path.join(app, 'Contents', 'Resources', 'bin', 'orca'));
|
|
42
|
+
}
|
|
43
|
+
return [];
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// Si corre como ejecutable autónomo (Node SEA): ahí process.execPath es omk, no Node.
|
|
47
|
+
// node:sea no existe en Node 18, que sigue soportado.
|
|
48
|
+
const isSea = (() => { try { return require('node:sea').isSea(); } catch { return false; } })();
|
|
49
|
+
|
|
50
|
+
// Un .js se ejecuta con Node: así OMK_ORCA puede apuntar a un CLI envuelto o a un doble de pruebas.
|
|
51
|
+
function commandFor(file) {
|
|
52
|
+
if (!/\.m?js$/i.test(file)) return { file, prefix: [] };
|
|
53
|
+
return { file: isSea ? 'node' : process.execPath, prefix: [file] };
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
function probe(cmd) {
|
|
57
|
+
const r = spawnSync(cmd.file, [...cmd.prefix, '--version'], { encoding: 'utf8', timeout: 15000, windowsHide: true });
|
|
58
|
+
if (r.error || r.status !== 0) return null;
|
|
59
|
+
const version = parseVersion(r.stdout);
|
|
60
|
+
return version ? version.join('.') : null;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* El CLI de Orca y su versión, o null. OMK_ORCA manda: si apunta a algo que no funciona no se busca
|
|
65
|
+
* otro, para no acabar hablando con una instalación de Orca que no es la que se pidió.
|
|
66
|
+
*/
|
|
67
|
+
function findOrca(env = process.env) {
|
|
68
|
+
const candidates = env.OMK_ORCA ? [env.OMK_ORCA] : ['orca', ...knownOrcaPaths(process.platform, env)];
|
|
69
|
+
for (const file of candidates) {
|
|
70
|
+
if (file !== 'orca' && !fs.existsSync(file)) continue;
|
|
71
|
+
const cmd = commandFor(file);
|
|
72
|
+
const version = probe(cmd);
|
|
73
|
+
if (version) return { ...cmd, path: file, version };
|
|
74
|
+
}
|
|
75
|
+
return null;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
// Lo que llega de Orca (nombres, descripciones, errores) se imprime en el terminal del usuario:
|
|
79
|
+
// sin caracteres de control, para que no pueda mover el cursor ni cambiar colores.
|
|
80
|
+
const clean = (text) => String(text == null ? '' : text).replace(/[\u0000-\u001f\u007f-\u009f]/g, '');
|
|
81
|
+
|
|
82
|
+
/** Ejecuta `orca <args> --json`. Nunca pasa por una shell: los argumentos van tal cual. */
|
|
83
|
+
function runOrca(orca, args, timeout = TIMEOUT_MS) {
|
|
84
|
+
const r = spawnSync(orca.file, [...orca.prefix, ...args, '--json'], {
|
|
85
|
+
encoding: 'utf8', timeout, windowsHide: true, maxBuffer: 16 * 1024 * 1024,
|
|
86
|
+
});
|
|
87
|
+
if (r.error) return { code: 1, json: null, problem: r.error.message };
|
|
88
|
+
let json = null;
|
|
89
|
+
try { json = JSON.parse(r.stdout); } catch { json = null; }
|
|
90
|
+
// Una línea: los mensajes de Orca pueden ocupar varias y se enseñan junto a un ✗.
|
|
91
|
+
const problem = json && json.ok === false && json.error
|
|
92
|
+
? clean(`${json.error.code}: ${String(json.error.message).split('\n')[0]}`)
|
|
93
|
+
: json ? null : clean((r.stderr || r.stdout || '').trim().split('\n')[0]) || `orca salió con ${r.status}`;
|
|
94
|
+
return { code: r.status === null ? 1 : r.status, json, problem };
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
const samePath = (a, b) => {
|
|
98
|
+
if (!a || !b) return false;
|
|
99
|
+
const norm = (p) => path.resolve(p).replace(/[\\/]+$/, '');
|
|
100
|
+
return process.platform === 'win32' ? norm(a).toLowerCase() === norm(b).toLowerCase() : norm(a) === norm(b);
|
|
101
|
+
};
|
|
102
|
+
|
|
103
|
+
/** El plugin del kit tal como lo lista `orca plugin list --json`, o null. */
|
|
104
|
+
function findInstalled(listJson) {
|
|
105
|
+
const plugins = (listJson && listJson.result && listJson.result.plugins) || [];
|
|
106
|
+
const found = plugins.find((p) => typeof p.pluginKey === 'string' && p.pluginKey.endsWith(`.${PLUGIN_ID}`));
|
|
107
|
+
return found ? { ...found, pluginKey: clean(found.pluginKey), version: clean(found.version), status: clean(found.status) } : null;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* Qué hacer con el plugin:
|
|
112
|
+
* - `install`: no está.
|
|
113
|
+
* - `update`: hay otra versión instalada desde esta misma carpeta (`orca plugin update` la vuelve a copiar).
|
|
114
|
+
* - `foreign`: hay otra versión instalada desde otro sitio; no se toca sin que lo pida el usuario.
|
|
115
|
+
* - `enable`: está esta versión, pero espera aprobación.
|
|
116
|
+
* - `disabled`: está esta versión y el usuario la desactivó; se respeta.
|
|
117
|
+
* - `current`: está esta versión y activa.
|
|
118
|
+
*/
|
|
119
|
+
function planPlugin(installed, dir, version) {
|
|
120
|
+
if (!installed) return 'install';
|
|
121
|
+
if (installed.version !== version) {
|
|
122
|
+
const source = installed.source || {};
|
|
123
|
+
return source.kind === 'local-path' && samePath(source.path || source.reference, dir) ? 'update' : 'foreign';
|
|
124
|
+
}
|
|
125
|
+
if (installed.status === 'pending' || installed.needsReconsent) return 'enable';
|
|
126
|
+
if (installed.status === 'disabled') return 'disabled';
|
|
127
|
+
return 'current';
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/** Lo que Orca concedería, en líneas legibles, a partir de `error.data` de approval_required. */
|
|
131
|
+
function describeGrants(data) {
|
|
132
|
+
const grants = (data && data.grants) || {};
|
|
133
|
+
const lines = [];
|
|
134
|
+
if (grants.executionDescription) lines.push(grants.executionDescription);
|
|
135
|
+
for (const c of grants.capabilities || []) lines.push(`${c.kind}: ${c.description}`);
|
|
136
|
+
const adds = (grants.contributions || []).map((c) => c.name).filter(Boolean);
|
|
137
|
+
if (adds.length) lines.push(`Añade: ${adds.join(', ')}`);
|
|
138
|
+
return lines.map(clean);
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/** La huella que hay que pasar a --approve, o null si Orca no la dio o no tiene el formato esperado. */
|
|
142
|
+
function approvalFingerprint(result) {
|
|
143
|
+
const data = result.json && result.json.error && result.json.error.data;
|
|
144
|
+
const fp = data && data.approvalFingerprint;
|
|
145
|
+
return typeof fp === 'string' && FINGERPRINT.test(fp) ? fp : null;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* Ejecuta un comando de Orca que puede pedir aprobación. Si la pide, enseña lo que concede y
|
|
150
|
+
* repite con --approve solo si `confirm(grants)` responde que sí.
|
|
151
|
+
*/
|
|
152
|
+
async function withApproval(orca, args, confirm) {
|
|
153
|
+
const first = runOrca(orca, args);
|
|
154
|
+
if (first.code !== APPROVAL_EXIT) return { ...first, approved: false };
|
|
155
|
+
const fp = approvalFingerprint(first);
|
|
156
|
+
if (!fp) return { ...first, code: 1, problem: 'Orca pidió aprobación sin una huella válida; no apruebo nada' };
|
|
157
|
+
const data = first.json.error.data;
|
|
158
|
+
if (!(await confirm(describeGrants(data), data))) return { code: APPROVAL_EXIT, json: first.json, problem: 'aprobación rechazada', declined: true };
|
|
159
|
+
return { ...runOrca(orca, [...args, '--approve', fp]), approved: true };
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
function readManifest(dir) {
|
|
163
|
+
return JSON.parse(fs.readFileSync(path.join(dir, 'orca-plugin.json'), 'utf8'));
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
module.exports = {
|
|
167
|
+
PLUGIN_ID, PANEL_ID, APPROVAL_EXIT, OPEN_TIMEOUT_MS, isSea,
|
|
168
|
+
clean, samePath, parseVersion, satisfies, knownOrcaPaths, findOrca, runOrca, findInstalled, planPlugin,
|
|
169
|
+
describeGrants, approvalFingerprint, withApproval, readManifest,
|
|
170
|
+
};
|
package/bin/sea.js
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
// Punto de entrada del ejecutable autónomo (Node SEA, scripts/build-exe.js): extrae el kit que lleva
|
|
2
|
+
// dentro a una carpeta estable y ejecuta omk desde ahí. Sin argumentos (doble clic) hace `omk setup`.
|
|
3
|
+
'use strict';
|
|
4
|
+
|
|
5
|
+
const crypto = require('node:crypto');
|
|
6
|
+
const fs = require('node:fs');
|
|
7
|
+
const os = require('node:os');
|
|
8
|
+
const path = require('node:path');
|
|
9
|
+
const zlib = require('node:zlib');
|
|
10
|
+
const { createRequire } = require('node:module');
|
|
11
|
+
const sea = require('node:sea');
|
|
12
|
+
|
|
13
|
+
const ASSET = 'kit.json.gz';
|
|
14
|
+
const STAMP = '.omk-build';
|
|
15
|
+
// Marca de una extracción a medias: solo se borra una carpeta .new que la tenga.
|
|
16
|
+
const PARTIAL = '.omk-partial';
|
|
17
|
+
|
|
18
|
+
/** Carpeta del kit extraído: OMK_HOME, o la de usuario de cada sistema. */
|
|
19
|
+
function kitHome(env = process.env, platform = process.platform, home = os.homedir()) {
|
|
20
|
+
if (env.OMK_HOME) return path.resolve(env.OMK_HOME);
|
|
21
|
+
if (platform === 'win32') return path.join(env.LOCALAPPDATA || path.join(home, 'AppData', 'Local'), 'Programs', 'orca-multiagent-kit', 'kit');
|
|
22
|
+
return path.join(home, '.local', 'share', 'orca-multiagent-kit');
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
const isKitCopy = (dir) => fs.existsSync(path.join(dir, 'VERSION')) && fs.existsSync(path.join(dir, 'install.sh'));
|
|
26
|
+
|
|
27
|
+
// Las rutas vienen del propio ejecutable, pero se comprueban igual: ninguna sale de la carpeta destino.
|
|
28
|
+
function safeJoin(base, rel) {
|
|
29
|
+
const target = path.resolve(base, rel);
|
|
30
|
+
if (path.isAbsolute(rel) || !target.startsWith(base + path.sep)) throw new Error(`ruta no válida en el kit embebido: ${rel}`);
|
|
31
|
+
return target;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
function removeOwned(dir, marker) {
|
|
35
|
+
if (!fs.existsSync(dir)) return;
|
|
36
|
+
if (!fs.existsSync(path.join(dir, marker)) && !isKitCopy(dir)) throw new Error(`${dir} existe y no es una copia del kit: no la toco`);
|
|
37
|
+
fs.rmSync(dir, { recursive: true, force: true });
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** Extrae el kit embebido en `dest` si no está ya esta misma build. Devuelve `dest`. */
|
|
41
|
+
function extractKit(dest) {
|
|
42
|
+
const archive = Buffer.from(sea.getAsset(ASSET));
|
|
43
|
+
const build = crypto.createHash('sha256').update(archive).digest('hex');
|
|
44
|
+
try {
|
|
45
|
+
if (fs.readFileSync(path.join(dest, STAMP), 'utf8').trim() === build) return dest;
|
|
46
|
+
} catch {
|
|
47
|
+
// Sin sello: primera vez, o una copia que no salió de este ejecutable. Se extrae.
|
|
48
|
+
}
|
|
49
|
+
if (fs.existsSync(dest) && !isKitCopy(dest)) {
|
|
50
|
+
throw new Error(`${dest} existe y no es una copia del kit: no la toco. Define OMK_HOME con otra carpeta.`);
|
|
51
|
+
}
|
|
52
|
+
const { files } = JSON.parse(zlib.gunzipSync(archive).toString('utf8'));
|
|
53
|
+
const fresh = `${dest}.new`;
|
|
54
|
+
removeOwned(fresh, PARTIAL);
|
|
55
|
+
fs.mkdirSync(fresh, { recursive: true });
|
|
56
|
+
fs.writeFileSync(path.join(fresh, PARTIAL), '');
|
|
57
|
+
for (const [rel, mode, data] of files) {
|
|
58
|
+
const target = safeJoin(fresh, rel);
|
|
59
|
+
fs.mkdirSync(path.dirname(target), { recursive: true });
|
|
60
|
+
fs.writeFileSync(target, Buffer.from(data, 'base64'), { mode });
|
|
61
|
+
}
|
|
62
|
+
fs.writeFileSync(path.join(fresh, STAMP), build + '\n');
|
|
63
|
+
fs.rmSync(path.join(fresh, PARTIAL));
|
|
64
|
+
// Cambio casi atómico: la copia anterior solo se borra cuando la nueva ya está en su sitio.
|
|
65
|
+
const old = `${dest}.old`;
|
|
66
|
+
removeOwned(old, STAMP);
|
|
67
|
+
if (fs.existsSync(dest)) fs.renameSync(dest, old);
|
|
68
|
+
fs.renameSync(fresh, dest);
|
|
69
|
+
fs.rmSync(old, { recursive: true, force: true });
|
|
70
|
+
return dest;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
function main() {
|
|
74
|
+
// El ejecutable recibe [ejecutable, ejecutable, ...args]: omk.js lee desde el tercero.
|
|
75
|
+
if (process.argv.length <= 2) {
|
|
76
|
+
process.argv.push('setup');
|
|
77
|
+
process.env.OMK_PAUSE = '1';
|
|
78
|
+
}
|
|
79
|
+
let kit;
|
|
80
|
+
try {
|
|
81
|
+
kit = extractKit(kitHome());
|
|
82
|
+
} catch (error) {
|
|
83
|
+
process.stderr.write(`omk: no pude preparar el kit: ${error.message}\n`);
|
|
84
|
+
process.exitCode = 1;
|
|
85
|
+
// Abierto con doble clic, la ventana se cerraría antes de poder leer el error.
|
|
86
|
+
if (process.env.OMK_PAUSE === '1' && process.stdin.isTTY) {
|
|
87
|
+
process.stdout.write('\nPulsa Enter para cerrar ');
|
|
88
|
+
process.stdin.once('data', () => process.exit(1));
|
|
89
|
+
}
|
|
90
|
+
return;
|
|
91
|
+
}
|
|
92
|
+
createRequire(path.join(kit, 'bin', 'omk.js'))('./omk.js');
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
main();
|