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.
Files changed (70) hide show
  1. package/CHANGELOG.md +45 -1
  2. package/README.md +13 -7
  3. package/VERSION +1 -1
  4. package/bin/omk.js +47 -4
  5. package/bin/orca.js +170 -0
  6. package/bin/sea.js +95 -0
  7. package/bin/setup.js +326 -0
  8. package/bin/team.js +353 -0
  9. package/core/AGENTS.md +1 -1
  10. package/docs/EJECUTABLE.md +70 -0
  11. package/docs/PLUGIN-ORCA.md +126 -28
  12. package/orca-plugin/README.md +5 -1
  13. package/orca-plugin/assets/logos/README.md +10 -0
  14. package/orca-plugin/assets/logos/agent.png +0 -0
  15. package/orca-plugin/assets/logos/aider.png +0 -0
  16. package/orca-plugin/assets/logos/amp.png +0 -0
  17. package/orca-plugin/assets/logos/antigravity.png +0 -0
  18. package/orca-plugin/assets/logos/claude.png +0 -0
  19. package/orca-plugin/assets/logos/cline.png +0 -0
  20. package/orca-plugin/assets/logos/codex.png +0 -0
  21. package/orca-plugin/assets/logos/copilot.png +0 -0
  22. package/orca-plugin/assets/logos/cursor.png +0 -0
  23. package/orca-plugin/assets/logos/devin.png +0 -0
  24. package/orca-plugin/assets/logos/droid.png +0 -0
  25. package/orca-plugin/assets/logos/gemini.png +0 -0
  26. package/orca-plugin/assets/logos/goose.png +0 -0
  27. package/orca-plugin/assets/logos/grok.png +0 -0
  28. package/orca-plugin/assets/logos/kimi.png +0 -0
  29. package/orca-plugin/assets/logos/kiro.png +0 -0
  30. package/orca-plugin/assets/logos/opencode.png +0 -0
  31. package/orca-plugin/assets/logos/qwen-code.png +0 -0
  32. package/orca-plugin/orca-plugin.json +28 -7
  33. package/orca-plugin/src/icons.test.ts +14 -0
  34. package/orca-plugin/src/icons.ts +30 -0
  35. package/orca-plugin/src/kit.test.ts +456 -9
  36. package/orca-plugin/src/kit.ts +639 -16
  37. package/orca-plugin/src/models.test.ts +28 -0
  38. package/orca-plugin/src/models.ts +29 -0
  39. package/orca-plugin/src/node.d.ts +40 -0
  40. package/orca-plugin/src/panel-state.ts +28 -0
  41. package/orca-plugin/src/panel.test.tsx +298 -0
  42. package/orca-plugin/src/panel.tsx +609 -0
  43. package/orca-plugin/src/plan-card.test.ts +99 -0
  44. package/orca-plugin/src/plan-card.ts +107 -0
  45. package/orca-plugin/src/protocol.ts +179 -0
  46. package/orca-plugin/src/tabs/autonomy.tsx +70 -0
  47. package/orca-plugin/src/tabs/history.test.tsx +78 -0
  48. package/orca-plugin/src/tabs/history.tsx +118 -0
  49. package/orca-plugin/src/tabs/notices.test.tsx +183 -0
  50. package/orca-plugin/src/tabs/notices.tsx +274 -0
  51. package/orca-plugin/src/tabs/worktrees.test.tsx +130 -0
  52. package/orca-plugin/src/tabs/worktrees.tsx +138 -0
  53. package/orca-plugin/src/ui/agent-icon.tsx +13 -0
  54. package/orca-plugin/src/worker/context.test.ts +32 -0
  55. package/orca-plugin/src/worker/context.ts +92 -0
  56. package/orca-plugin/src/worker/history.test.ts +149 -0
  57. package/orca-plugin/src/worker/history.ts +181 -0
  58. package/orca-plugin/src/worker/notices.test.ts +356 -0
  59. package/orca-plugin/src/worker/notices.ts +291 -0
  60. package/orca-plugin/src/worker/system.test.ts +58 -0
  61. package/orca-plugin/src/worker/system.ts +122 -0
  62. package/orca-plugin/src/worker/worktrees.test.ts +177 -0
  63. package/orca-plugin/src/worker/worktrees.ts +188 -0
  64. package/orca-plugin/src/worker.test.ts +297 -15
  65. package/orca-plugin/src/worker.ts +353 -32
  66. package/package.json +3 -2
  67. package/skills/orca/SKILL.md +1 -0
  68. package/skills/orca/references/engine-orca.md +1 -0
  69. package/skills/orca/references/olimpo.md +1 -0
  70. package/skills/orca/references/plan-card.md +45 -0
@@ -39,6 +39,26 @@ export function withContractHint(
39
39
  return `${prompt.trimEnd()}\n\n${CONTRACT_HINT}`
40
40
  }
41
41
 
42
+ export const ORCHESTRATE_HINT =
43
+ '[Orca Multiagent Kit] Antes de empezar, aplica la skill orca (~/.agents/skills/orca/SKILL.md) a esta ' +
44
+ 'tarea: decide si compensa repartirla entre agentes y, si compensa, repártela. La entrada es este prompt ' +
45
+ '(adaptador de chat): no hace falta spec-kit. Si no compensa, hazla tú directamente.'
46
+
47
+ // Prompts que ya pasan por la skill orca (Repartir del panel, un despacho, el propio aviso) o que
48
+ // son de kit-init: no se les añade nada. «orca-cli» u «orchestration» no cuentan como la skill orca.
49
+ const ALREADY_ROUTED = /skill\s+`?orca`?(?![\w-])|kit-init|^inicializa el proyecto$|\[Orca Multiagent Kit\] Antes de empezar/im
50
+
51
+ /**
52
+ * Devuelve el prompt de arranque con la indicación de pasar por la skill orca, o `null` si no
53
+ * hay que tocarlo: solo prompts con los que Orca arranca un agente (crear un worktree con tarea,
54
+ * una pestaña nueva, una issue), nunca lo que escribe una persona ni los despachos.
55
+ */
56
+ export function withOrchestrateHint(prompt: string, inputKind: string, enabled: boolean): string | null {
57
+ if (!enabled || inputKind !== 'launch' || prompt.trim() === '') return null
58
+ if (isKitDispatch(prompt) || ALREADY_ROUTED.test(prompt.trim())) return null
59
+ return `${prompt.trimEnd()}\n\n${ORCHESTRATE_HINT}`
60
+ }
61
+
42
62
  // Mensajes de "comando no encontrado" de bash, zsh, fish, cmd y PowerShell (inglés y español).
43
63
  const MISSING_COMMAND =
44
64
  /command not found|not recognized|unknown command|no se reconoce|orden no encontrada|no se encontr[oó] la orden/i
@@ -69,7 +89,8 @@ export async function pollUntil(
69
89
  }
70
90
 
71
91
  export const INSTALL_HINT =
72
- 'Instálalo con `npm install -g orca-multiagent-kit` (o `./install.sh` desde el zip) y vuelve a lanzar el comando.'
92
+ 'Instálalo con `npm install -g orca-multiagent-kit` o con el ejecutable de la última release (lo deja en el PATH), ' +
93
+ 'reinicia Orca y vuelve a lanzar el comando.'
73
94
 
74
95
  export type FocusedWorkspace = { branch: string; displayName: string }
75
96
  export type WorkspaceEntry = { id: string; name: string; branch: string | null }
@@ -84,20 +105,181 @@ export function resolveFocusedWorkspaceId(
84
105
  workspaces: readonly WorkspaceEntry[]
85
106
  ): string | null {
86
107
  if (!focused) return null
108
+ // Orca da la rama unas veces como `main` y otras como `refs/heads/main`.
109
+ const branch = (name: string | null) => (name ?? '').replace(/^refs\/heads\//, '')
87
110
  const matches = workspaces.filter(
88
- (w) => w.name === focused.displayName && (w.branch ?? '') === focused.branch
111
+ (w) => w.name === focused.displayName && branch(w.branch) === branch(focused.branch)
89
112
  )
90
113
  return matches.length === 1 ? (matches[0]?.id ?? null) : null
91
114
  }
92
115
 
116
+ /** Acciones del kit que lanzan la paleta y el panel. */
117
+ export type KitAction = 'verify' | 'update' | 'init'
118
+
119
+ export const KIT_ACTIONS: readonly KitAction[] = ['verify', 'update', 'init']
120
+
121
+ export function isKitAction(value: unknown): value is KitAction {
122
+ return KIT_ACTIONS.some((action) => action === value)
123
+ }
124
+
93
125
  const AGENT_ID = /^[a-z0-9][a-z0-9-]{0,39}$/
94
126
 
95
127
  export function isValidAgentId(value: unknown): value is string {
96
128
  return typeof value === 'string' && AGENT_ID.test(value)
97
129
  }
98
130
 
131
+ /**
132
+ * Agentes del catálogo de Orca que ofrecen los desplegables del panel: ids que acepta
133
+ * `agent.launch` (los de `orca agent launch --agent`). Orca tiene más; estos son los habituales.
134
+ */
135
+ export const KNOWN_AGENTS: readonly { id: string; label: string }[] = [
136
+ { id: 'claude', label: 'Claude Code' },
137
+ { id: 'codex', label: 'Codex' },
138
+ { id: 'gemini', label: 'Gemini CLI' },
139
+ { id: 'antigravity', label: 'Antigravity' },
140
+ { id: 'copilot', label: 'GitHub Copilot' },
141
+ { id: 'cursor', label: 'Cursor' },
142
+ { id: 'opencode', label: 'OpenCode' },
143
+ { id: 'amp', label: 'Amp' },
144
+ { id: 'droid', label: 'Droid' },
145
+ { id: 'grok', label: 'Grok' },
146
+ { id: 'kimi', label: 'Kimi' },
147
+ { id: 'qwen-code', label: 'Qwen Code' },
148
+ { id: 'aider', label: 'Aider' },
149
+ { id: 'goose', label: 'Goose' },
150
+ { id: 'cline', label: 'Cline' },
151
+ { id: 'kiro', label: 'Kiro' },
152
+ { id: 'devin', label: 'Devin' }
153
+ ]
154
+
155
+ export function agentLabel(id: string): string {
156
+ return KNOWN_AGENTS.find((agent) => agent.id === id)?.label ?? id
157
+ }
158
+
159
+ /** Opciones de un desplegable de agentes: el catálogo y, si no están en él, los valores actuales. */
160
+ export function agentOptions(current: readonly string[] = []): { value: string; label: string }[] {
161
+ const options = KNOWN_AGENTS.map(({ id, label }) => ({ value: id, label }))
162
+ for (const id of current) {
163
+ if (isValidAgentId(id) && !options.some((option) => option.value === id)) options.push({ value: id, label: id })
164
+ }
165
+ return options
166
+ }
167
+
99
168
  export type AgentState = 'working' | 'blocked' | 'waiting' | 'done'
100
- export type TrackedAgent = { workspaceId: string | null; title: string | null; state: AgentState }
169
+
170
+ /** Lo que el despacho de la skill `orca` dice de su unidad: cabecera UNIT/RUN y línea ROL. */
171
+ export type UnitInfo = { unit: string; title: string | null; run: string; role: string | null }
172
+
173
+ /** Un agente tal como lo sigue el worker: lo que cuenta Orca más lo aprendido de sus hooks. */
174
+ export type TrackedAgent = {
175
+ workspaceId: string | null
176
+ /** El título que da Orca, si da alguno. */
177
+ title: string | null
178
+ state: AgentState
179
+ /** Id del agente (claude, codex…), de `agents.list` o de los hooks. */
180
+ agent?: string | null
181
+ unit?: UnitInfo | null
182
+ /** Desde cuándo está en este estado, en ms desde epoch. */
183
+ since?: number | null
184
+ /** Su terminal; `null` en un chat de Orca. */
185
+ terminalId?: string | null
186
+ /** Cómo acabó el último turno del agente principal, si Orca lo dice. */
187
+ outcome?: string | null
188
+ /** Cuándo llegó el último evento suyo. */
189
+ updatedAt?: number | null
190
+ }
191
+
192
+ const LABEL_MAX = 80
193
+ const UNIT_HEADER = /^[ \t]*UNIT:[ \t]*(U\d+)\b([^\n]*)/m
194
+ const RUN_VALUE = /\bRUN:[ \t]*(\S+)/
195
+ // «ROL: Ariadna · código sensible · nivel alto — …»: el nombre del rol abre la línea.
196
+ const ROLE_LINE = /^[ \t]*ROL:[ \t]*(\p{L}[\p{L}\p{M}-]*)/mu
197
+
198
+ /**
199
+ * Texto apto para una etiqueta: una línea, sin caracteres de control ni de formato (el título
200
+ * de un terminal y los despachos los escribe un agente) y acotado. `null` si no queda nada.
201
+ */
202
+ export function cleanLabel(text: string, max = LABEL_MAX): string | null {
203
+ const clean = text.replace(/[\p{Cc}\p{Cf}]+/gu, ' ').replace(/\s+/g, ' ').trim()
204
+ if (clean === '') return null
205
+ return clean.length > max ? `${clean.slice(0, max - 1).trimEnd()}…` : clean
206
+ }
207
+
208
+ /** La unidad de un despacho de la skill `orca` (skills/orca/SKILL.md §5), o `null` si no lo es. */
209
+ export function parseDispatch(prompt: string): UnitInfo | null {
210
+ const header = UNIT_HEADER.exec(prompt)
211
+ if (!header) return null
212
+ const [, unit = '', rest = ''] = header
213
+ const runInHeader = RUN_VALUE.exec(rest)
214
+ const run = cleanLabel((runInHeader ?? RUN_VALUE.exec(prompt))?.[1] ?? '', 60)
215
+ if (run === null) return null
216
+ const title = runInHeader ? rest.slice(0, runInHeader.index) : rest
217
+ const role = ROLE_LINE.exec(prompt)?.[1]
218
+ return {
219
+ unit,
220
+ title: cleanLabel(title.replace(/^\s*[—–-]\s*/, '')),
221
+ run,
222
+ role: role === undefined ? null : cleanLabel(role, 30)
223
+ }
224
+ }
225
+
226
+ /** Una ruta comparable entre las formas que usa Orca (`C:\x`, `C:/x/`). */
227
+ export function normalizePath(path: string): string {
228
+ const slashes = path.replace(/\\/g, '/').replace(/\/+$/, '')
229
+ return /^[a-z]:\//i.test(slashes) ? slashes.toLowerCase() : slashes
230
+ }
231
+
232
+ export type WorkspaceInfo = { name: string; path: string; branch: string | null; kind: string | null }
233
+
234
+ /** Los workspaces de `workspace.list`: sus datos por id y el id por ruta. */
235
+ export type WorkspaceIndex = { byId: Map<string, WorkspaceInfo>; byPath: Map<string, string> }
236
+
237
+ export function indexWorkspaces(
238
+ workspaces: readonly { id: string; name: string; path: string; branch?: string | null; kind?: string | null }[]
239
+ ): WorkspaceIndex {
240
+ const index: WorkspaceIndex = { byId: new Map(), byPath: new Map() }
241
+ for (const { id, name, path, branch = null, kind = null } of workspaces) {
242
+ index.byId.set(id, {
243
+ name: cleanLabel(name, 60) ?? id,
244
+ path,
245
+ branch: branch ? branch.replace(/^refs\/heads\//, '') : null,
246
+ kind
247
+ })
248
+ index.byPath.set(normalizePath(path), id)
249
+ }
250
+ return index
251
+ }
252
+
253
+ /**
254
+ * El id con el que `workspace.list` conoce un workspace. Los eventos de agentes lo dan a veces
255
+ * como `<repo>::<ruta>` y la lista como `identity:…`: entonces se cruzan por la ruta. Sin
256
+ * coincidencia, el id tal cual.
257
+ */
258
+ export function canonicalWorkspaceId(id: string, index: WorkspaceIndex): string {
259
+ if (index.byId.has(id)) return id
260
+ const separator = id.indexOf('::')
261
+ if (separator === -1) return id
262
+ return index.byPath.get(normalizePath(id.slice(separator + 2))) ?? id
263
+ }
264
+
265
+ // Los chats de agente de Orca no tienen terminal; su panel se llama
266
+ // «structured-agent-session-<agente>_<sesión>:…». Si Orca cambia el formato, no se reconoce y ya.
267
+ const STRUCTURED_SESSION = /^structured-agent-session-([a-z0-9][a-z0-9-]*?)_/
268
+
269
+ /** El agente de un chat de Orca, sacado de su panel, o `null`. */
270
+ export function agentFromPaneKey(paneKey: string): string | null {
271
+ return STRUCTURED_SESSION.exec(paneKey)?.[1] ?? null
272
+ }
273
+
274
+ /** El nombre de un agente: su unidad del kit, el título de Orca o, como mínimo, qué agente es. */
275
+ export function agentName(agent: TrackedAgent): string {
276
+ const { unit } = agent
277
+ if (unit) {
278
+ const head = unit.role ? `${unit.unit} · ${unit.role}` : unit.unit
279
+ return unit.title ? `${head} — ${unit.title}` : head
280
+ }
281
+ return agent.title ?? agent.agent ?? 'agente sin título'
282
+ }
101
283
 
102
284
  export type AgentSummary = {
103
285
  text: string
@@ -105,13 +287,112 @@ export type AgentSummary = {
105
287
  tooltip: string
106
288
  }
107
289
 
108
- const STATE_LABEL: Record<Exclude<AgentState, 'done'>, [string, string]> = {
290
+ export type AgentLine = {
291
+ /** Clave del agente en el worker: el panel la devuelve para abrir su workspace. */
292
+ id: string
293
+ title: string
294
+ /** Id del agente (claude, codex…), para su icono; `null` si no se sabe. */
295
+ agent?: string | null
296
+ state: string
297
+ blocked: boolean
298
+ /** Qué agente es y en qué workspace, lo que se sepa: «codex · palolo». */
299
+ detail: string
300
+ since: number | null
301
+ canOpen: boolean
302
+ /** Todo lo que se sabe del agente, para su ficha en el panel. */
303
+ facts: { label: string; value: string }[]
304
+ }
305
+
306
+ /** Agentes de un mismo run del kit o, fuera del kit, de un mismo workspace. */
307
+ export type AgentGroup = { title: string; agents: AgentLine[] }
308
+
309
+ type ActiveState = Exclude<AgentState, 'done'>
310
+
311
+ const STATE_LABEL: Record<ActiveState, [string, string]> = {
109
312
  working: ['trabajando', 'trabajando'],
110
313
  blocked: ['bloqueado', 'bloqueados'],
111
314
  waiting: ['esperando', 'esperando']
112
315
  }
113
316
 
114
- export function summarizeAgents(agents: Iterable<TrackedAgent>): AgentSummary {
317
+ // Primero lo que necesita a la persona.
318
+ const STATE_RANK: Record<ActiveState, number> = { blocked: 0, waiting: 1, working: 2 }
319
+
320
+ const TOOLTIP_AGENTS = 6
321
+
322
+ const OUTCOME_LABEL: Record<string, string> = {
323
+ success: 'terminó bien',
324
+ failure: 'falló',
325
+ cancellation: 'cancelado',
326
+ superseded: 'sustituido',
327
+ interruption: 'interrumpido',
328
+ unconfirmed: 'sin confirmar'
329
+ }
330
+
331
+ /** La ficha de un agente: solo lo que se sabe, en el orden en que se lee. */
332
+ function agentFacts(agent: TrackedAgent, title: string, workspace: WorkspaceInfo | null): AgentLine['facts'] {
333
+ const { unit } = agent
334
+ const level = unit?.role ? TEAM_ROLES.find(({ name }) => name === unit.role)?.level : undefined
335
+ const facts: [string, string | null | undefined][] = [
336
+ ['Agente', agent.agent ? agentLabel(agent.agent) : null],
337
+ ['Unidad', unit ? (unit.title ? `${unit.unit} — ${unit.title}` : unit.unit) : null],
338
+ ['Rol', unit?.role ? (level ? `${unit.role} · nivel ${level}` : unit.role) : null],
339
+ ['Run', unit?.run],
340
+ ['Título en Orca', agent.title && agent.title !== title ? agent.title : null],
341
+ ['Workspace', workspace?.name],
342
+ ['Rama', workspace?.branch],
343
+ ['Carpeta', workspace?.path],
344
+ ['Dónde corre', agent.terminalId ? `terminal ${agent.terminalId}` : agent.terminalId === null ? 'chat de Orca' : null],
345
+ ['Último turno', agent.outcome ? (OUTCOME_LABEL[agent.outcome] ?? agent.outcome) : null]
346
+ ]
347
+ return facts.flatMap(([label, value]) => (value ? [{ label, value }] : []))
348
+ }
349
+
350
+ /** Los agentes activos por run o workspace; los grupos y sus agentes, primero los bloqueados. */
351
+ export function groupAgents(
352
+ agents: Iterable<readonly [string, TrackedAgent]>,
353
+ workspaces: ReadonlyMap<string, WorkspaceInfo>
354
+ ): AgentGroup[] {
355
+ const rows: { group: string; rank: number; line: AgentLine }[] = []
356
+ for (const [id, agent] of agents) {
357
+ if (agent.state === 'done') continue
358
+ const info = agent.workspaceId ? (workspaces.get(agent.workspaceId) ?? null) : null
359
+ const workspace = info?.name ?? null
360
+ const title = agentName(agent)
361
+ const detail = [agent.agent === title ? null : agent.agent, workspace]
362
+ .filter((part): part is string => Boolean(part))
363
+ .join(' · ')
364
+ rows.push({
365
+ group: agent.unit
366
+ ? `RUN ${agent.unit.run}`
367
+ : (workspace ?? (agent.workspaceId ? 'Workspace sin nombre' : 'Sin workspace')),
368
+ rank: STATE_RANK[agent.state],
369
+ line: {
370
+ id,
371
+ title,
372
+ agent: agent.agent ?? null,
373
+ state: STATE_LABEL[agent.state][0],
374
+ blocked: agent.state === 'blocked',
375
+ detail,
376
+ since: agent.since ?? null,
377
+ canOpen: agent.workspaceId !== null,
378
+ facts: agentFacts(agent, title, info)
379
+ }
380
+ })
381
+ }
382
+ rows.sort((a, b) => a.rank - b.rank || a.line.title.localeCompare(b.line.title, 'es'))
383
+ const groups = new Map<string, AgentLine[]>()
384
+ for (const { group, line } of rows) {
385
+ const lines = groups.get(group)
386
+ if (lines) lines.push(line)
387
+ else groups.set(group, [line])
388
+ }
389
+ return [...groups].map(([title, lines]) => ({ title, agents: lines }))
390
+ }
391
+
392
+ export function summarizeAgents(
393
+ agents: Iterable<TrackedAgent>,
394
+ groups: readonly AgentGroup[] = []
395
+ ): AgentSummary {
115
396
  const counts = { working: 0, blocked: 0, waiting: 0 }
116
397
  for (const agent of agents) {
117
398
  if (agent.state !== 'done') counts[agent.state] += 1
@@ -120,22 +401,364 @@ export function summarizeAgents(agents: Iterable<TrackedAgent>): AgentSummary {
120
401
  .filter((state) => counts[state] > 0)
121
402
  .map((state) => `${counts[state]} ${STATE_LABEL[state][counts[state] === 1 ? 0 : 1]}`)
122
403
  const tone = counts.blocked > 0 ? 'warning' : counts.working > 0 ? 'accent' : 'neutral'
404
+ if (parts.length === 0) {
405
+ return { text: 'MAW', tone, tooltip: 'Orca Multiagent Kit: ningún agente activo' }
406
+ }
407
+ const named = groups.flatMap((group) => group.agents).map(({ title, state }) => `${title}: ${state}`)
408
+ const more = named.length > TOOLTIP_AGENTS ? [`… y ${named.length - TOOLTIP_AGENTS} más`] : []
123
409
  return {
124
- text: parts.length > 0 ? `MAW · ${parts.join(' · ')}` : 'MAW',
410
+ text: `MAW · ${parts.join(' · ')}`,
125
411
  tone,
126
- tooltip:
127
- parts.length > 0
128
- ? `Orca Multiagent Kit: ${parts.join(', ')} en todos los workspaces`
129
- : 'Orca Multiagent Kit: ningún agente activo'
412
+ tooltip: [
413
+ `Orca Multiagent Kit: ${parts.join(', ')} en todos los workspaces`,
414
+ ...named.slice(0, TOOLTIP_AGENTS),
415
+ ...more
416
+ ].join('\n')
130
417
  }
131
418
  }
132
419
 
133
420
  /** Una línea por agente activo, para el comando «estado de los agentes». */
134
- export function describeAgents(agents: Iterable<TrackedAgent>): string {
135
- const lines: string[] = []
136
- for (const agent of agents) {
137
- if (agent.state === 'done') continue
138
- lines.push(`- ${agent.title ?? 'agente sin título'}: ${STATE_LABEL[agent.state][0]}`)
139
- }
421
+ export function describeAgents(groups: readonly AgentGroup[]): string {
422
+ const lines = groups.flatMap(({ agents }) =>
423
+ agents.map(({ title, state, detail }) => `- ${title}: ${state}${detail ? ` (${detail})` : ''}`)
424
+ )
140
425
  return lines.length > 0 ? lines.join('\n') : 'Ningún agente activo.'
141
426
  }
427
+
428
+ export type Notice = { title: string; body: string }
429
+
430
+ /** El aviso de un agente que acaba de bloquearse, o `null` si ya lo estaba o no lo está. */
431
+ export function blockedNotice(
432
+ previous: AgentState | undefined,
433
+ agent: TrackedAgent,
434
+ workspace: string | null
435
+ ): Notice | null {
436
+ if (agent.state !== 'blocked' || previous === 'blocked') return null
437
+ return {
438
+ title: `${agentName(agent)}: bloqueado`,
439
+ body: workspace ? `En ${workspace}. Necesita tu respuesta en Orca.` : 'Necesita tu respuesta en Orca.'
440
+ }
441
+ }
442
+
443
+ /** Por run del kit: las unidades que siguen activas y las que ya terminaron en esta tanda. */
444
+ export type RunProgress = Map<string, { active: Set<string>; finished: number }>
445
+
446
+ /**
447
+ * Anota el estado de una unidad. Si con ella terminan todas las lanzadas del run, devuelve el
448
+ * aviso y la tanda vuelve a cero: la ronda siguiente avisa otra vez.
449
+ */
450
+ export function trackRun(runs: RunProgress, run: string, id: string, state: AgentState): Notice | null {
451
+ const progress = runs.get(run)
452
+ if (state !== 'done') {
453
+ if (progress) progress.active.add(id)
454
+ else runs.set(run, { active: new Set([id]), finished: 0 })
455
+ return null
456
+ }
457
+ if (!progress?.active.delete(id)) return null
458
+ progress.finished += 1
459
+ if (progress.active.size > 0) return null
460
+ runs.delete(run)
461
+ const { finished } = progress
462
+ return {
463
+ title: `RUN ${run}: unidades terminadas`,
464
+ body:
465
+ `${finished === 1 ? 'La unidad lanzada ha' : `Las ${finished} unidades lanzadas han`} terminado. ` +
466
+ 'Vuelve al coordinador para revisar e integrar.'
467
+ }
468
+ }
469
+
470
+ /** Olvida una unidad sin avisar: su workspace ya no existe. */
471
+ export function forgetRunUnit(runs: RunProgress, id: string): void {
472
+ for (const [run, progress] of runs) {
473
+ progress.active.delete(id)
474
+ if (progress.active.size === 0) runs.delete(run)
475
+ }
476
+ }
477
+
478
+ /** Roles de Olimpo que se fijan a un proveedor (skills/orca/references/olimpo.md); Hefesto es el coordinador. */
479
+ export const TEAM_ROLES = [
480
+ { id: 'dedalo', name: 'Dédalo', work: 'arquitectura', level: 'alto' },
481
+ { id: 'casandra', name: 'Casandra', work: 'seguridad', level: 'alto' },
482
+ { id: 'temis', name: 'Temis', work: 'normativa', level: 'alto' },
483
+ { id: 'ariadna', name: 'Ariadna', work: 'código sensible', level: 'alto' },
484
+ { id: 'persefone', name: 'Perséfone', work: 'datos', level: 'medio' },
485
+ { id: 'proteo', name: 'Proteo', work: 'implementación', level: 'medio' },
486
+ { id: 'narciso', name: 'Narciso', work: 'interfaz', level: 'medio' },
487
+ { id: 'icaro', name: 'Ícaro', work: 'integraciones', level: 'medio' },
488
+ { id: 'argos', name: 'Argos', work: 'verificación', level: 'medio' },
489
+ { id: 'atlas', name: 'Atlas', work: 'plataforma', level: 'medio' },
490
+ { id: 'clio', name: 'Clío', work: 'mecánico', level: 'bajo' }
491
+ ] as const
492
+
493
+ export type RoleId = (typeof TEAM_ROLES)[number]['id']
494
+
495
+ /** Qué unidades revisa otro proveedor: `ORCHESTRATION.md` §1 «Revisión cruzada». */
496
+ export type CrossReview = 'sensibles' | 'todas' | 'nunca'
497
+
498
+ export const CROSS_REVIEW: readonly CrossReview[] = ['sensibles', 'todas', 'nunca']
499
+
500
+ export type RoleLevel = 'alto' | 'medio' | 'bajo'
501
+
502
+ export const ROLE_LEVELS: readonly RoleLevel[] = ['alto', 'medio', 'bajo']
503
+
504
+ /** Quién revisa lo que hace un rol propio (columna «Revisión» de `olimpo.md`). */
505
+ export type CustomReview = 'propia' | 'cross' | 'argos' | 'casandra'
506
+
507
+ export const CUSTOM_REVIEWS: readonly { id: CustomReview; label: string }[] = [
508
+ { id: 'propia', label: 'Propia' },
509
+ { id: 'cross', label: 'Cruzada (otro proveedor)' },
510
+ { id: 'argos', label: 'Argos (verificación)' },
511
+ { id: 'casandra', label: 'Casandra (seguridad)' }
512
+ ]
513
+
514
+ /** Un rol propio del proyecto: va a la tabla «Roles propios del proyecto» de `ORCHESTRATION.md` §1. */
515
+ export type CustomRole = {
516
+ name: string
517
+ work: string
518
+ level: RoleLevel
519
+ review: CustomReview
520
+ guard: string
521
+ /** Proveedor fijado, o `null` para que lo elija el coordinador. */
522
+ provider: string | null
523
+ }
524
+
525
+ export const CUSTOM_ROLES_MAX = 10
526
+ export const ROLE_WORK_MAX = 80
527
+ export const ROLE_GUARD_MAX = 120
528
+ const ROLE_NAME = /^\p{L}[\p{L}\p{M}\p{N} -]{0,29}$/u
529
+ const RESERVED_ROLE_NAMES = ['Hefesto', ...TEAM_ROLES.map(({ name }) => name)].map((name) => name.toLocaleLowerCase('es'))
530
+
531
+ /** Si `name` vale como nombre de un rol nuevo: letras, números, espacios y guiones, y que no exista ya. */
532
+ export function isValidRoleName(name: string, others: readonly string[] = []): boolean {
533
+ const key = name.trim().toLocaleLowerCase('es')
534
+ return (
535
+ ROLE_NAME.test(name.trim()) &&
536
+ !RESERVED_ROLE_NAMES.includes(key) &&
537
+ !others.some((other) => other.trim().toLocaleLowerCase('es') === key)
538
+ )
539
+ }
540
+
541
+ /** Texto libre para una celda de tabla Markdown: una línea, sin `|`, `<` ni `>`, acotado. */
542
+ export function cellText(text: string, max: number): string | null {
543
+ return cleanLabel(text.replace(/[|<>]/g, ' '), max)
544
+ }
545
+
546
+ function parseCustomRole(value: unknown, providers: readonly string[], others: readonly string[]): CustomRole | null {
547
+ if (typeof value !== 'object' || value === null) return null
548
+ const { name, work, level, review, guard, provider } = value as Record<string, unknown>
549
+ if (typeof name !== 'string' || !isValidRoleName(name, others)) return null
550
+ const cleanWork = typeof work === 'string' ? cellText(work, ROLE_WORK_MAX) : null
551
+ const cleanGuard = typeof guard === 'string' ? (cellText(guard, ROLE_GUARD_MAX) ?? '') : null
552
+ const roleLevel = ROLE_LEVELS.find((candidate) => candidate === level)
553
+ const roleReview = CUSTOM_REVIEWS.find((candidate) => candidate.id === review)?.id
554
+ if (!cleanWork || cleanGuard === null || !roleLevel || !roleReview) return null
555
+ if (provider !== null && (!isValidAgentId(provider) || !providers.includes(provider))) return null
556
+ return { name: name.trim(), work: cleanWork, level: roleLevel, review: roleReview, guard: cleanGuard, provider }
557
+ }
558
+
559
+ export type Team = {
560
+ /** Quién coordina (Hefesto) al orquestar desde el panel. No va a ORCHESTRATION.md. */
561
+ coordinator: string
562
+ providers: string[]
563
+ cross: CrossReview
564
+ /** Proveedor fijado por rol; un rol ausente lo elige el coordinador. */
565
+ roles: Partial<Record<RoleId, string>>
566
+ custom: CustomRole[]
567
+ }
568
+
569
+ export type TeamPreset = 'claude' | 'claude-codex' | 'codex-claude'
570
+
571
+ const everyRole = (provider: string, overrides: Partial<Record<RoleId, string>>) =>
572
+ Object.fromEntries(TEAM_ROLES.map(({ id }) => [id, overrides[id] ?? provider])) as Record<RoleId, string>
573
+
574
+ export const TEAM_PRESETS: Readonly<Record<TeamPreset, { label: string; team: Team }>> = {
575
+ claude: {
576
+ label: 'Solo Claude',
577
+ team: { coordinator: 'claude', providers: ['claude'], cross: 'sensibles', roles: {}, custom: [] }
578
+ },
579
+ 'claude-codex': {
580
+ label: 'Claude + Codex revisor',
581
+ team: {
582
+ coordinator: 'claude',
583
+ providers: ['claude', 'codex'],
584
+ cross: 'sensibles',
585
+ roles: everyRole('claude', { casandra: 'codex' }),
586
+ custom: []
587
+ }
588
+ },
589
+ 'codex-claude': {
590
+ label: 'Codex + Claude revisor',
591
+ team: {
592
+ coordinator: 'codex',
593
+ providers: ['codex', 'claude'],
594
+ cross: 'sensibles',
595
+ roles: everyRole('codex', { casandra: 'claude' }),
596
+ custom: []
597
+ }
598
+ }
599
+ }
600
+
601
+ export function isRoleId(value: unknown): value is RoleId {
602
+ return TEAM_ROLES.some(({ id }) => id === value)
603
+ }
604
+
605
+ const MAX_PROVIDERS = 8
606
+
607
+ /**
608
+ * Un equipo que llega del panel, validado entero: ids de agente, revisión cruzada conocida,
609
+ * cada rol con un proveedor activo y roles propios bien formados. `null` ante cualquier otra cosa.
610
+ */
611
+ export function parseTeam(value: unknown): Team | null {
612
+ if (typeof value !== 'object' || value === null) return null
613
+ const { coordinator, providers, cross, roles, custom } = value as Record<string, unknown>
614
+ if (!isValidAgentId(coordinator)) return null
615
+ if (!Array.isArray(providers) || providers.length === 0 || providers.length > MAX_PROVIDERS) return null
616
+ if (!providers.every(isValidAgentId) || new Set(providers).size !== providers.length) return null
617
+ const crossReview = CROSS_REVIEW.find((mode) => mode === cross)
618
+ if (!crossReview) return null
619
+ if (typeof roles !== 'object' || roles === null || Array.isArray(roles)) return null
620
+ const fixed: Partial<Record<RoleId, string>> = {}
621
+ for (const [role, provider] of Object.entries(roles)) {
622
+ if (!isRoleId(role) || !isValidAgentId(provider) || !providers.includes(provider)) return null
623
+ fixed[role] = provider
624
+ }
625
+ if (!Array.isArray(custom) || custom.length > CUSTOM_ROLES_MAX) return null
626
+ const own: CustomRole[] = []
627
+ for (const role of custom) {
628
+ const parsed = parseCustomRole(role, providers, own.map(({ name }) => name))
629
+ if (!parsed) return null
630
+ own.push(parsed)
631
+ }
632
+ return { coordinator, providers: [...providers], cross: crossReview, roles: fixed, custom: own }
633
+ }
634
+
635
+ /** El equipo tal como se edita en el panel. */
636
+ export type TeamDraft = Team & { preset: TeamPreset | 'custom' }
637
+
638
+ export function draftFromPreset(id: TeamPreset): TeamDraft {
639
+ const { team } = TEAM_PRESETS[id]
640
+ return { ...team, preset: id, providers: [...team.providers], roles: { ...team.roles }, custom: [] }
641
+ }
642
+
643
+ /**
644
+ * Un borrador guardado por una versión anterior del panel (proveedores como texto, sin roles
645
+ * propios) o dañado, convertido al formato de ahora. Lo que no se entiende vuelve a «Solo Claude».
646
+ */
647
+ export function normalizeDraft(value: unknown): TeamDraft {
648
+ const base = draftFromPreset('claude')
649
+ if (typeof value !== 'object' || value === null) return base
650
+ const old = value as Record<string, unknown>
651
+ const providers = (
652
+ Array.isArray(old.providers) ? old.providers : typeof old.providers === 'string' ? old.providers.split(/[\s,]+/) : []
653
+ ).filter(isValidAgentId)
654
+ const active = providers.length > 0 ? [...new Set(providers)] : base.providers
655
+ const roles = typeof old.roles === 'object' && old.roles !== null ? Object.entries(old.roles) : []
656
+ const draft: TeamDraft = {
657
+ ...base,
658
+ preset: 'custom',
659
+ coordinator: isValidAgentId(old.coordinator) ? old.coordinator : base.coordinator,
660
+ providers: active,
661
+ cross: CROSS_REVIEW.find((mode) => mode === old.cross) ?? base.cross,
662
+ roles: Object.fromEntries(
663
+ roles.filter(([role, provider]) => isRoleId(role) && typeof provider === 'string' && active.includes(provider))
664
+ ),
665
+ custom: Array.isArray(old.custom) ? (old.custom as CustomRole[]) : []
666
+ }
667
+ return teamFromDraft(draft) ? draft : base
668
+ }
669
+
670
+ export function emptyCustomRole(): CustomRole {
671
+ return { name: '', work: '', level: 'medio', review: 'propia', guard: '', provider: null }
672
+ }
673
+
674
+ /**
675
+ * El equipo de un borrador, o `null` si no es válido. Un rol cuyo proveedor ya no está entre
676
+ * los activos vuelve a «lo elige el coordinador».
677
+ */
678
+ export function teamFromDraft(draft: TeamDraft): Team | null {
679
+ const { providers } = draft
680
+ const roles = Object.fromEntries(
681
+ Object.entries(draft.roles).filter(([, provider]) => provider !== undefined && providers.includes(provider))
682
+ )
683
+ const custom = draft.custom.map((role) => ({
684
+ ...role,
685
+ provider: role.provider !== null && providers.includes(role.provider) ? role.provider : null
686
+ }))
687
+ return parseTeam({ coordinator: draft.coordinator, providers, cross: draft.cross, roles, custom })
688
+ }
689
+
690
+ /** El equipo en JSON y base64url: llega al terminal sin un solo carácter que un shell interprete. */
691
+ export function encodeTeam(team: Team): string {
692
+ const { providers, cross, roles, custom } = team
693
+ const bytes = new TextEncoder().encode(JSON.stringify({ v: 1, providers, cross, roles, custom }))
694
+ let binary = ''
695
+ for (const byte of bytes) binary += String.fromCharCode(byte)
696
+ return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')
697
+ }
698
+
699
+ // cmd.exe corta las órdenes de más de 8191 caracteres.
700
+ export const TEAM_COMMAND_MAX = 7000
701
+
702
+ /**
703
+ * La orden que deja el equipo en `ORCHESTRATION.md` §1 del proyecto, o `null` si no cabe en un
704
+ * terminal. Solo lleva base64url de un equipo que `parseTeam` ya validó; `omk team` lo valida otra vez.
705
+ */
706
+ export function teamCommand(team: Team): string | null {
707
+ const command = `omk team set --data ${encodeTeam(team)}`
708
+ return command.length > TEAM_COMMAND_MAX ? null : command
709
+ }
710
+
711
+ /** Cuántas confirmaciones pide la skill `orca` antes de seguir sola (`ORCHESTRATION.md` §0). */
712
+ export type Autonomy = 'manual' | 'semi' | 'auto'
713
+
714
+ export const AUTONOMY_LEVELS: readonly { id: Autonomy; label: string; hint: string }[] = [
715
+ { id: 'manual', label: 'Manual', hint: 'Confirmas el plan, cada ronda, cada merge y la limpieza.' },
716
+ { id: 'semi', label: 'Semi', hint: 'Confirmas el plan, el merge final y la limpieza.' },
717
+ { id: 'auto', label: 'Auto', hint: 'Solo confirmas el merge final y la limpieza; el plan se enseña sin esperar.' }
718
+ ]
719
+
720
+ export function isAutonomy(value: unknown): value is Autonomy {
721
+ return AUTONOMY_LEVELS.some(({ id }) => id === value)
722
+ }
723
+
724
+ /** La orden que deja el nivel en `ORCHESTRATION.md` §0: un literal por nivel, nada más. */
725
+ export function autonomyCommand(level: Autonomy): string {
726
+ return `omk team set --autonomy ${level}`
727
+ }
728
+
729
+ export const TASK_MAX = 4000
730
+
731
+ /** De dónde sale el trabajo que se reparte. spec-kit es una opción, nunca un requisito. */
732
+ export type TaskSource = 'chat' | 'plan' | 'speckit'
733
+
734
+ export const TASK_SOURCES: readonly { id: TaskSource; label: string }[] = [
735
+ { id: 'chat', label: 'Lo que escribo aquí' },
736
+ { id: 'plan', label: 'Un plan del repo (planes/*.md)' },
737
+ { id: 'speckit', label: 'Tareas de spec-kit (specs/…/tasks.md)' }
738
+ ]
739
+
740
+ const SOURCE_PROMPT: Record<TaskSource, string> = {
741
+ chat: 'Usa la skill orca para repartir esta tarea entre agentes. La entrada es este texto (adaptador de chat): no hace falta spec-kit.',
742
+ plan: 'Usa la skill orca para repartir entre agentes el plan del repo (planes/*.md o .plans/*.md, adaptador plan-file): no hace falta spec-kit.',
743
+ speckit: 'Usa la skill orca para repartir entre agentes las tareas de spec-kit (specs/<feature>/tasks.md, adaptador speckit).'
744
+ }
745
+
746
+ /**
747
+ * El prompt para que el coordinador orqueste, o `null` si no vale. Con «lo que escribo aquí» la
748
+ * tarea es obligatoria; con un plan o spec-kit es una indicación opcional (qué plan, qué feature).
749
+ * Un nivel de autonomía cambia el de `ORCHESTRATION.md` solo para ese run; sin él, manda el fichero.
750
+ */
751
+ export function orchestratePrompt(task: unknown, source: unknown = 'chat', autonomy: unknown = null): string | null {
752
+ if (typeof task !== 'string') return null
753
+ const from = TASK_SOURCES.find(({ id }) => id === source)?.id
754
+ if (!from) return null
755
+ if (autonomy !== null && autonomy !== undefined && !isAutonomy(autonomy)) return null
756
+ // Saltos de línea y tabuladores sí; el resto de caracteres de control, no.
757
+ const clean = task.replace(/\r\n?/g, '\n').replace(/[^\P{Cc}\n\t]/gu, ' ').trim()
758
+ if (clean.length > TASK_MAX || (from === 'chat' && clean === '')) return null
759
+ const head = isAutonomy(autonomy)
760
+ ? `${SOURCE_PROMPT[from]} Autonomía de este run: ${autonomy} (manda sobre ORCHESTRATION.md §0 solo en este run).`
761
+ : SOURCE_PROMPT[from]
762
+ if (clean === '') return head
763
+ return `${head}\n\n${from === 'chat' ? clean : `Indicaciones: ${clean}`}`
764
+ }