@milpa/comal 0.2.0 → 0.2.2

package/src/plugins.mjs

@@ -33,6 +33,7 @@ export class PluginRuntime {
   #services = new Map();
   #queue = Promise.resolve();
   #closing = false;
+  #serviceWatchers = new Set();
   // notify(notice): el host encola avisos de plugins (plugin-notices.mjs); sin él, ctx.notify responde unavailable.
   constructor({ cwd, house, services = {}, configPath, onEvent = () => {}, notify }) {
     Object.assign(this, { cwd, house, onEvent, notify });
@@ -41,7 +42,16 @@ export class PluginRuntime {
   }
   async #notify(notice) { if (typeof this.notify !== 'function') return { status: 'unavailable' }; try { return await this.notify(notice); } catch (error) { return { status: 'failed', error: String(error.message).slice(0, 200) }; } }
   #exclusive(task) { const next = this.#queue.catch(() => {}).then(task); this.#queue = next; return next; }
-  async #event(event) { try { await this.onEvent({ type: 'plugin_status', ...event }); } catch {} }
+  async #event(event) { try { await this.onEvent({ type: 'plugin_status', ...event }); } catch {} this.#servicesChanged(); }
+  #servicesChanged() { for (const listener of [...this.#serviceWatchers]) try { listener(); } catch {} }
+  /**
+   * Lectura del HOST de un servicio publicado (ctx.provide), p. ej. para un panel de la TUI.
+   * Devuelve { owner, value } o null; el host debe comprobar el dueño y tratar los datos
+   * como no confiables. No concede nada al plugin ni al modelo.
+   */
+  service(name) { const entry = this.#services.get(name); return entry ? Object.freeze({ owner: entry.owner, value: entry.value }) : null; }
+  /** Avisa (sin argumentos) cuando cambia el estado de los plugins o sus servicios. Devuelve la baja. */
+  watchServices(listener) { if (typeof listener !== 'function') throw new TypeError('watchServices requires a function.'); this.#serviceWatchers.add(listener); return () => this.#serviceWatchers.delete(listener); }
   #definition(definition) {
     if (!definition || !idPattern.test(definition.id) || definition.id.length > 24 || typeof definition.version !== 'string' || !definition.version || typeof definition.activate !== 'function') throw new Error('Manifiesto de plugin inválido: requiere id, version y activate.');
     const names = list => { if (!Array.isArray(list) || list.length > 32 || list.some(name => typeof name !== 'string' || !name || name.length > 128) || new Set(list).size !== list.length) throw new Error('requires/provides de plugin inválidos.'); return [...list]; };
@@ -309,6 +319,7 @@ export class PluginRuntime {
       this.house.registry.replace(scopes.flatMap(scope => [...scope.operations.keys()]), []);
       for (const scope of scopes) { this.#known.get(scope.id).state = 'disabled'; try { await this.#retire(scope); } catch (error) { errors.push(error); } }
       for (const [name, service] of this.#services) if (service.owner !== 'host') this.#services.delete(name);
+      this.#servicesChanged(); this.#serviceWatchers.clear();
       if (errors.length) throw new AggregateError(errors, 'Falló limpieza de plugins.');
     });
   }

package/src/private-fs.mjs

@@ -5,21 +5,27 @@ import path from 'node:path';
 
 const fail=message=>Object.assign(new Error(message),{code:'PRIVATE_STATE_UNSAFE'});
 let broker,starting,sequence=0;
+// PowerShell puede tardar en arrancar (antivirus, runners en frío): su arranque tiene su propio plazo.
+const STARTUP_MS=60000,REQUEST_MS=15000;
 async function windowsBroker(){
  if(broker)return broker;if(starting)return starting;
  starting=(async()=>{
   const script=await readFile(new URL('./windows-private.ps1',import.meta.url),'utf8'),program=path.join(process.env.SystemRoot||'C:\\Windows','System32','WindowsPowerShell','v1.0','powershell.exe');
   const child=spawn(program,['-NoLogo','-NoProfile','-NonInteractive','-ExecutionPolicy','Bypass','-EncodedCommand',Buffer.from(script,'utf16le').toString('base64')],{stdio:['pipe','pipe','pipe'],windowsHide:true});
-  const pending=new Map(),lines=createInterface({input:child.stdout});let diagnostic='';
+  const pending=new Map(),lines=createInterface({input:child.stdout});let diagnostic='',ready;
+  const readiness=new Promise((resolve,reject)=>{ready={resolve,reject};});
+  const startup=setTimeout(()=>{ready.reject(fail('Windows ACL helper did not start within its deadline. '+diagnostic.slice(0,300)));child.kill();},STARTUP_MS);
   const references=active=>{const method=active?'ref':'unref';child[method]();for(const stream of[child.stdin,child.stdout,child.stderr])stream[method]?.();};
   child.stderr.on('data',data=>{if(diagnostic.length<2000)diagnostic+=data;});child.stdin.on('error',()=>{});
-  const stopped=()=>{for(const job of pending.values()){clearTimeout(job.timer);job.reject(fail('Windows private-state inspection stopped. '+diagnostic.slice(0,300)));}pending.clear();if(broker?.child===child)broker=undefined;};
+  const stopped=()=>{clearTimeout(startup);ready.reject(fail('Windows private-state inspection stopped. '+diagnostic.slice(0,300)));for(const job of pending.values()){clearTimeout(job.timer);job.reject(fail('Windows private-state inspection stopped. '+diagnostic.slice(0,300)));}pending.clear();if(broker?.child===child)broker=undefined;};
   child.on('error',stopped);child.on('close',stopped);
-  lines.on('line',line=>{let result;try{result=JSON.parse(line);}catch{stopped();child.kill();return;}const job=pending.get(result.id);if(!job)return;clearTimeout(job.timer);pending.delete(result.id);if(!pending.size)references(false);result.ok?job.resolve():job.reject(fail(result.error||'Windows private-state ACL does not verify.'));});
+  lines.on('line',line=>{let result;try{result=JSON.parse(line);}catch{stopped();child.kill();return;}if(result?.ready===true){clearTimeout(startup);ready.resolve();return;}const job=pending.get(result.id);if(!job)return;clearTimeout(job.timer);pending.delete(result.id);if(!pending.size)references(false);result.ok?job.resolve():job.reject(fail(result.error||'Windows private-state ACL does not verify.'));});
   const result={child,request:(action,file)=>new Promise((resolve,reject)=>{
-   const id=++sequence;references(true);const timer=setTimeout(()=>{pending.delete(id);reject(fail('Windows ACL inspection exceeded its deadline.'));if(!pending.size)references(false);},15000);pending.set(id,{resolve,reject,timer});
+   const id=++sequence;references(true);const timer=setTimeout(()=>{pending.delete(id);reject(fail('Windows ACL inspection exceeded its deadline.'));if(!pending.size)references(false);},REQUEST_MS);pending.set(id,{resolve,reject,timer});
    child.stdin.write(JSON.stringify({id,action,path:path.resolve(file)})+'\n',error=>{if(error){clearTimeout(timer);pending.delete(id);reject(fail('Windows ACL inspection could not be sent.'));if(!pending.size)references(false);}});
-  })};references(false);broker=result;return result;
+  })};
+  try{await readiness;}catch(error){if(broker?.child===child)broker=undefined;throw error;}
+  references(false);broker=result;return result;
  })();try{return await starting;}finally{starting=undefined;}
 }
 export async function ensurePrivateDirectory(directory){

package/src/read-only-check.mjs

@@ -33,10 +33,13 @@ export function readOnlyBashCheck(command) {
 // Rechecking still goes through the live contract, guard and permission judge.
 const CHROME_LAB_READS = new Set(['Status', 'Deployment', 'Targets', 'ReadDOM', 'Assert', 'Contexts', 'Console', 'WorkerDiagnostics'].map(name => `plugin__chrome-lab__${name}`));
 export const chromeLabObservation = operation => CHROME_LAB_READS.has(operation);
-// open-relay: lecturas del canal admin (sin mutación). Las acciones de la fase 2
-// (Reply, Ack, ApprovePlan, RejectPlan) no son observaciones: pasan por la tarjeta.
-const OPEN_RELAY_READS = new Set(['Status', 'Swarms', 'Swarm', 'Task', 'Inbox', 'Message', 'Plans', 'Plan', 'Jobs', 'Job', 'JobLogs', 'Receipt', 'Events', 'Dossier'].map(name => `plugin__open-relay__${name}`));
+// open-relay: lecturas del canal admin (sin mutación). Las acciones (Reply, Ack,
+// ApprovePlan, RejectPlan y Decide, que registra ADR) no son observaciones: pasan por la tarjeta.
+const OPEN_RELAY_READS = new Set(['Status', 'Swarms', 'Swarm', 'Task', 'Inbox', 'Message', 'Plans', 'Plan', 'Jobs', 'Job', 'JobLogs', 'Receipt', 'Events', 'Dossier', 'Decisions', 'Decision'].map(name => `plugin__open-relay__${name}`));
 export const openRelayObservation = operation => OPEN_RELAY_READS.has(operation);
+// omarchy: catálogo, clasificación, lecturas revisadas y guía. Change y SystemChange no son observaciones.
+const OMARCHY_READS = new Set(['Status', 'Commands', 'Classify', 'Read', 'Guide'].map(name => `plugin__omarchy__${name}`));
+export const omarchyObservation = operation => OMARCHY_READS.has(operation);
 export const readOnlyWorkCheck = (operation, args) => ['Read', 'Glob', 'Grep', 'ListDirectory', 'FileInfo', 'ChromeVerify','SourceVerify'].includes(operation) || operation==='GitInspect'&&Boolean(args)&&Object.keys(args).length===0 || CHROME_LAB_READS.has(operation) || (operation === 'Bash' && Boolean(readOnlyBashCheck(args?.command)));
 export const RUNTIME_CHECK_IDS = Object.freeze(['target_id','pageId','page_id','context_id','contextId']);
 export const runtimeBoundReadCheck = (operation, args) => readOnlyWorkCheck(operation,args) && (RUNTIME_CHECK_IDS.some(key => Object.hasOwn(args || {},key)) || operation==='plugin__chrome-lab__WorkerDiagnostics'&&Object.hasOwn(args||{},'connection_id')&&Object.hasOwn(args||{},'browser_endpoint_id'));

package/src/source-ownership.mjs

@@ -22,8 +22,11 @@ export class SourceOwnership {
   }
   contains(file){const r=path.relative(this.directory,file);return r===''||r!=='..'&&!r.startsWith('..'+path.sep)&&!path.isAbsolute(r);}
   async prepareDirectory(){
+    await mkdir(path.dirname(this.directory),{recursive:true,mode:0o700});
+    // El HOME puede llegar por un enlace del sistema (macOS: /tmp, /var → /private/…).
+    // Se resuelve el antecesor del registro; el padre (~/.comal) sigue sin poder ser enlace.
+    if(!this.canonical){const grand=await realpath(path.dirname(path.dirname(this.directory)));this.directory=path.join(grand,path.basename(path.dirname(this.directory)),path.basename(this.directory));this.canonical=true;}
     const parent=path.dirname(this.directory);
-    await mkdir(parent,{recursive:true,mode:0o700});
     if(await realpath(parent)!==parent)throw fail('Native source lock registry has a noncanonical parent.');
     try{await ensurePrivateDirectory(this.directory);}catch(error){if(error.code==='PRIVATE_STATE_UNSAFE')throw fail('Native source lock registry is not private.');throw error;}
     const info=await lstat(this.directory);

package/src/swarm-view.mjs

@@ -0,0 +1,53 @@
+// Fase 4 de open-relay: el host lleva al panel /swarm de la TUI la foto que el plugin
+// publica con ctx.provide('open-relay.swarm-view'). Sin turnos del modelo ni herramientas:
+// el plugin avisa (su vigilancia de events.wait vio un cambio), el host copia la foto como
+// datos planos y la pantalla la vuelve a limpiar al pintarla. Sólo se acepta el servicio si
+// su dueño es el plugin open-relay. Si el plugin no está, está apagado o falló, la vista lo
+// dice para que el panel explique por qué y cómo configurarlo.
+import { SWARM_VIEW_SERVICE } from './plugins/open-relay/panel.mjs';
+export { SWARM_VIEW_SERVICE };
+export const SWARM_VIEW_PLUGIN = 'open-relay';
+const MAX_BYTES = 512 * 1024;
+
+function plain(view) {
+  if (!view || typeof view !== 'object' || Array.isArray(view)) return null;
+  let text; try { text = JSON.stringify(view); } catch { return null; }
+  if (typeof text !== 'string' || Buffer.byteLength(text) > MAX_BYTES) return null;
+  return JSON.parse(text);
+}
+
+/** Por qué no hay foto, según el estado del plugin en el runtime. */
+export function swarmViewUnavailable(status, plugin = SWARM_VIEW_PLUGIN) {
+  const item = status?.plugins?.find(entry => entry.id === plugin);
+  if (!item) return { available: false, reason: 'not_configured' };
+  const reason = { disabled: 'disabled', pending_trust: 'pending_trust', failed: 'failed', loading: 'loading', registered: 'disabled', active: 'no_service' }[item.state] || 'disabled';
+  return { available: false, reason, ...(item.error ? { error: String(item.error).slice(0, 600) } : {}) };
+}
+
+/**
+ * Conecta el servicio con onView(view). Devuelve { refresh, close }. onView recibe
+ * { available:true, ...foto } o { available:false, reason, error? }.
+ */
+export function connectSwarmView({ plugins, onView, plugin = SWARM_VIEW_PLUGIN }) {
+  let bound, unsubscribe = null, closed = false, last = null;
+  const emit = view => { if (closed) return; const key = JSON.stringify(view); if (key === last) return; last = key; try { onView(view); } catch {} };
+  const bind = () => {
+    if (closed) return;
+    const service = plugins.service(SWARM_VIEW_SERVICE), value = service?.owner === plugin ? service.value : null;
+    if (value && value === bound) return;
+    try { unsubscribe?.(); } catch {}
+    unsubscribe = null; bound = value;
+    if (!value || typeof value.subscribe !== 'function' || typeof value.snapshot !== 'function') { emit(swarmViewUnavailable(plugins.status(), plugin)); return; }
+    const deliver = view => { if (closed || bound !== value) return; const copy = plain(view); emit(copy ? { ...copy, available: true } : { available: false, reason: 'invalid' }); };
+    try { unsubscribe = value.subscribe(deliver); deliver(value.snapshot()); }
+    catch (error) { emit({ available: false, reason: 'failed', error: String(error?.message || error).slice(0, 600) }); }
+  };
+  const stop = plugins.watchServices(bind);
+  bind();
+  return {
+    refresh: bind,
+    /** La foto actual, sin esperar al próximo aviso (p. ej. /swarm fuera de la TUI). */
+    current() { const service = plugins.service(SWARM_VIEW_SERVICE); if (service?.owner !== plugin) return swarmViewUnavailable(plugins.status(), plugin); try { const copy = plain(service.value.snapshot()); return copy ? { ...copy, available: true } : { available: false, reason: 'invalid' }; } catch (error) { return { available: false, reason: 'failed', error: String(error?.message || error).slice(0, 600) }; } },
+    close() { closed = true; stop(); try { unsubscribe?.(); } catch {} unsubscribe = null; },
+  };
+}

package/src/tui/connection-transition.mjs

@@ -14,6 +14,16 @@ const MESSAGES = Object.freeze({
   uncertain: 'Connection change could not be confirmed. Check the active connection before trying again.',
 });
 
+// Next step shown with a failed change. Built from the classified reason only,
+// never from the upstream error text.
+export const CONNECTION_REASON_HINTS = Object.freeze({
+  authentication: 'Sign in or check the configured credential environment variable.',
+  timeout: 'The model server timed out.',
+  unavailable: 'The model server could not be reached.',
+  unsupported: 'The active model does not support this setting.',
+  unknown: 'The change could not be verified.',
+});
+
 function label(value) {
   if (typeof value !== 'string') return '';
   // Never render terminal escapes or URL credentials/query strings in a status.

package/src/tui/controller.mjs

@@ -11,9 +11,9 @@ import { Composer } from './composer.mjs';
 import { isRemoteCommand } from '../remote-commands.mjs';
 import { randomUUID } from 'node:crypto';
 import { connectionOptions } from './connection-options.mjs';
-import { ConnectionTransitions, connectionAction, connectionFailureReason } from './connection-transition.mjs';
+import { ConnectionTransitions, connectionAction, connectionFailureReason, CONNECTION_REASON_HINTS } from './connection-transition.mjs';
 
-const IMMEDIATE = new Set(['raw', 'cloud', 'remote-control', 'rc', 'help', 'copy', 'select', 'status', 'context', 'tools', 'house', 'state', 'audit', 'board', 'tasks', 'work', 'operations', 'plugins', 'sessions', 'resume', 'clear', 'model', 'models', 'effort', 'capabilities', 'login', 'logout', 'permissions', 'autonomy', 'rename', 'table', 'queue', 'agents', 'mcp','list-agents','inbox','providers','provider','config','max-tokens','context-window', 'exit', 'quit']);
+const IMMEDIATE = new Set(['raw', 'cloud', 'remote-control', 'rc', 'help', 'copy', 'select', 'status', 'context', 'tools', 'house', 'state', 'audit', 'board', 'tasks', 'work', 'swarm', 'operations', 'plugins', 'sessions', 'resume', 'clear', 'model', 'models', 'effort', 'capabilities', 'login', 'logout', 'permissions', 'autonomy', 'rename', 'table', 'queue', 'agents', 'mcp','list-agents','inbox','providers','provider','config','max-tokens','context-window', 'exit', 'quit']);
 
 export class InteractiveController {
   constructor(ui, backend) { this.ui = ui; this.backend = backend; this.closed = false; this.switching = false; this.draftTimer = null; this.pendingDraft = null; }
@@ -27,6 +27,9 @@ export class InteractiveController {
     return this.ui.finished;
   }
   modalOverlay() { return this.ui.hasModalOverlay?.() ?? Boolean(this.ui.overlay); }
+  // Despertar por avisos/mensajes entre sesiones: el panel /swarm (sólo lectura) no lo bloquea;
+  // el resto de superposiciones modales sí, como siempre. El turno se pinta detrás del panel.
+  wakeBlocked() { return this.modalOverlay() && this.ui.overlay?.kind !== 'swarm'; }
   refreshDiscovery() { const context = this.backend.discovery?.(); if (context) this.ui.setDiscovery?.(context); }
   attachSession(session) {
     this.session = session; this.ui.loadSession(session); this.ui.updateMetadata(this.backend.metadata());
@@ -55,7 +58,7 @@ export class InteractiveController {
     if (this.queue.items.length || this.queue.interrupted.length) this.ui.notice(t("The recovered queue is paused. Check F4 before resuming; interrupted messages were not resent."));
   }
   kickPeers(){
-    if(this.peerProcessing || this.ui.busy || this.runner.processing || this.queue.paused || this.queue.items.length || this.modalOverlay() || this.ui.selecting || this.ui.editingQueue || this.switching || this.closed)return;
+    if(this.peerProcessing || this.ui.busy || this.runner.processing || this.queue.paused || this.queue.items.length || this.wakeBlocked() || this.ui.selecting || this.ui.editingQueue || this.switching || this.closed)return;
     this.peerProcessing=(async()=>{
       if(!await this.backend.hasPeerMessages() || this.closed)return;
       this.ui.setBusy(true);
@@ -191,6 +194,14 @@ export class InteractiveController {
     }
     if(command==='work'&&(arg.trim()==='recover'||arg.trim().startsWith('review '))){await this.requireIdle();const output=await this.backend.control(command,arg);if(output)this.showOutput(command,arg,output);return;}
     if (['board', 'tasks', 'work'].includes(command)) { this.ui.showBoard(JSON.parse(await this.backend.control('board', ''))); return; }
+    // Panel /swarm: sólo presentación; los datos llegan solos del plugin open-relay (ctx.provide).
+    if (command === 'swarm') {
+      const value = arg.trim();
+      if (!value) { this.ui.toggleSwarm(); return; }
+      const strip = /^strip(?:\s+(on|off))?$/.exec(value);
+      if (!strip) throw new Error(t('Use /swarm or /swarm strip [on|off].'));
+      this.ui.setSwarmStrip(strip[1] ? strip[1] === 'on' : undefined); return;
+    }
     if(connectionAction(`/${command} ${arg}`)){await this.requireIdle();return this.connectionControl(command,arg);}
     if (['cloud', 'model', 'effort', 'provider', 'login', 'logout'].includes(command) && (arg.trim() || ['login', 'logout'].includes(command))) await this.requireIdle();
     if (['max-tokens', 'context-window'].includes(command) && arg.trim() || command === 'config' && /^(?:set|save)\b/.test(arg.trim())) await this.requireIdle();
@@ -228,13 +239,13 @@ export class InteractiveController {
     this.connections.admit(id,requested);const attempt=this.connections.start(id);this.switching=true;this.syncConnectionStatus();
     let failure;
     try{
-      const output=await this.backend.control(command,argument);if(output)this.ui.notice(output);
+      const output=await this.backend.control(command,argument);if(output)this.showOutput(command,argument,output);
       this.connections.complete(id,attempt,{outcome:'applied',active:this.backend.metadata()});
       try{await this.backend.refreshConnections?.();}catch{}
     }catch(error){
       const reason=connectionFailureReason(error);this.connections.complete(id,attempt,{outcome:reason==='cancelled'?'cancelled':'failed',active:this.backend.metadata(),unchanged:before===this.connectionIdentity() && ['model','provider','effort'].includes(command),error});failure=error;
     }finally{this.switching=false;this.ui.updateMetadata(this.backend.metadata());this.refreshDiscovery();this.syncConnectionStatus();this.runner.kick();}
-    if(failure){const state=this.connections.get(id);this.ui.notice(t(state.message),true);await this.recoverConnection(id,requested);}
+    if(failure){const state=this.connections.get(id);this.ui.notice(this.connectionFailureText(state,requested),true);await this.recoverConnection(id,requested);}
   }
   scheduleConnectionRecovery(id,action){
     const runner=this.runner;
@@ -244,16 +255,28 @@ export class InteractiveController {
       if(this.runner===runner)setImmediate(()=>this.recoverConnection(id,action).catch(()=>{}));
     });
   }
+  // Login provider behind a /provider or /login target, if the session knows it.
+  connectionLoginProvider(action){
+    if(action.command==='login')return action.argument.split(/\s+/)[0];
+    if(action.command!=='provider')return null;
+    const discovery=this.backend.discovery?.() || {},profile=discovery.profiles?.find(p=>p.name===action.argument);
+    return profile?.authProvider || (discovery.authProviders?.some(p=>p.id===action.argument)?action.argument:null);
+  }
+  // One line: what was tried, that nothing changed, and the next step.
+  connectionFailureText(state,action){
+    const login=state.reason==='authentication'?this.connectionLoginProvider(action):null;
+    const hint=login?t('Sign in first with /login {v0}.',{v0:login}):CONNECTION_REASON_HINTS[state.reason]?t(CONNECTION_REASON_HINTS[state.reason]):'';
+    return `/${action.command} ${state.target}: ${t(state.message)}${hint?' '+hint:''}`;
+  }
   async recoverConnection(id,action){
     if(this.closed || this.ui.busy || this.runner.processing || this.modalOverlay() || this.ui.permission)return;
     const state=this.connections.get(id);if(state?.state!=='failed')return;
     const items=[{id:'keep',label:t('Keep the active connection'),description:t('Return to your draft without changing the connection.')}];
     if(state.retryable)items.push({id:'retry',label:t('Retry this selection'),description:`/${action.command} ${state.target}`});
-    const discovery=this.backend.discovery?.() || {},profile=discovery.profiles?.find(p=>p.name===action.argument);
-    const loginProvider=profile?.authProvider || (discovery.authProviders?.some(p=>p.id===action.argument)?action.argument:null);
-    if(state.reason==='authentication' && action.command==='provider' && loginProvider)items.push({id:'login',label:t('Sign in to the selected provider'),description:loginProvider});
+    const loginProvider=action.command==='provider'?this.connectionLoginProvider(action):null;
+    if(state.reason==='authentication' && loginProvider)items.push({id:'login',label:t('Sign in to the selected provider'),description:loginProvider});
     items.push({id:'choose',label:t('Choose another connection'),description:t('Open the provider and workspace profile selector.')});
-    const reason={authentication:'Sign in or check the configured credential environment variable.',timeout:'The model server timed out.',unavailable:'The model server could not be reached.',unsupported:'The active model does not support this setting.',unknown:'The change could not be verified.'}[state.reason];
+    const reason=CONNECTION_REASON_HINTS[state.reason];
     const choice=await this.ui.setupChoice({title:t(state.confirmedUnchanged?'Connection change not applied':'Connection status needs review'),description:t(state.message)+(reason?'\n\n'+t(reason):''),items});
     if(this.closed)return;
     if(choice==='retry' && this.connections.canRetry(id))await this.submit(`/${action.command} ${action.argument}`);

package/src/tui/discovery.mjs

@@ -16,7 +16,7 @@ const COMMANDS = [
   ['compact', '', "Derive ledger state without an LLM"], ['context', '', "Check the context budget"],
   ['state', '', "Request and current job status"], ['audit', '', "Verify ledger integrity"],
   ['board', '', "Open the task board"], ['work', 'resume|recover|review', "Continue work, recover Chrome or review a native failure locally"],
-  ['tasks', '', "Open the task board"], ['model', 'ID', "Check or change the model"],
+  ['tasks', '', "Open the task board"], ['swarm', '[strip [on|off]]', "Open the open-relay swarm panel"], ['model', 'ID', "Check or change the model"],
   ['models', '', "Choose a model from the current provider"],
   ['effort', "LEVEL", "Check or change the effort announced by the model"],
   ['capabilities', '[refresh]', "Support and provenance of capabilities"],
@@ -84,7 +84,7 @@ const COMMAND_KEYWORDS = Object.freeze({
   operations: "contracts effects tools catalog catalog contratos efectos herramientas catálogo catalogo",
   sessions: "sessions history resume recover sesiones historial retomar recuperar", resume: "sessions history resume recover continue sesiones historial retomar recuperar continuar",
   compact: "memory projection projection derive summary context memoria proyección proyeccion derivar resumen contexto",
-  board: "kanban pending tasks progress kanban pendientes tareas progreso", work: "kanban checkpoint continue resume kanban checkpoint continuar retomar",
+  board: "kanban pending tasks progress kanban pendientes tareas progreso", swarm: "open-relay relay swarm kanban agents questions plans enjambre agentes preguntas planes", work: "kanban checkpoint continue resume kanban checkpoint continuar retomar",
   effort: 'esfuerzo razonamiento pensar thinking', capabilities: "capabilities vision vision video images images support capacidades visión vision video imágenes imagenes soporte",
   permissions: "modes security permissions authorize plan automatic automatic modos seguridad permisos autorizar plan automático automatico",
   goal: "goal autonomous autonomous continue persistent objetivo autónomo autonomo continuar persistente", queue: "queue messages pending pause reorder cola mensajes pendientes pausar reordenar",
@@ -136,6 +136,7 @@ function argumentItems(command, args, context) {
     if (command === 'work') return named(['resume', 'recover', 'review'], t("Continue work, recover Chrome or review a native failure locally"));
     if (command === 'goal') return named(['status', 'pause', 'resume', 'clear'], t("Target control; you can also write a condition"));
     if (command === 'queue') return named(['pause', 'resume', 'clear', 'edit'], t("Action on the queue"));
+    if (command === 'swarm') return named(['strip'], t("Toggle the compact swarm summary next to the conversation"));
     if (command === 'mcp') return named(['status', 'list', 'config', 'reload', 'reconnect', 'add', 'remove'], t("Action on MCP servers"));
     if (command === 'plugins') return named(['status', 'list', 'available', 'add', 'config', 'enable', 'disable', 'reload', 'run', 'allow', 'trust', 'untrust', 'remove'], t("Action on plugins"));
     if (command === 'chrome-workflow') return named(['auto', 'raw'], 'Saved per project; applies to the entry of this session');
@@ -147,7 +148,7 @@ function argumentItems(command, args, context) {
     if(command==='agents' && ['status','wait','stop','resume','background'].includes(first))return entries(context.agents,'id');
     if (command === 'mcp' && ['reconnect', 'remove'].includes(first)) return entries(context.mcpServers);
     if (command === 'plugins' && ['enable', 'disable', 'reload', 'run', 'config', 'allow', 'untrust', 'remove'].includes(first)) return entries(context.plugins, 'id');
-    if (command === 'plugins' && first === 'add') return named(['chrome-lab', 'open-relay'], 'Plugin bundled with Comal');
+    if (command === 'plugins' && first === 'add') return named(['chrome-lab', 'open-relay', 'omarchy'], 'Plugin bundled with Comal');
     if (command === 'inbox' && first === 'release') return named(['all'], t("Release held messages; does not change hold mode"));
     if (command === 'queue' && first === 'edit') return named((context.queue?.items || []).map((_, index) => String(index + 1)), t("Edit this pending message"));
     if (command === 'login' && first === 'status') return entries(context.authProviders || ['codex', 'kimi', 'minimax', 'grok', 'ollama'], 'id');

package/src/tui/screen.mjs

@@ -10,11 +10,12 @@ import { brandingWelcome, brandingStatus, brandMotionEnabled, BRAND_FRAME_INTERV
 import { commandCatalog, commandSuggestions, applySuggestion, contextualTip } from './discovery.mjs';
 import { inboundBlockFromRow, inboundBlockFromEvent, inboundLines } from './inbound-blocks.mjs';
 import { presentResultBlock, presentToolBlock, presentPermission } from './present.mjs';
+import { normalizeSwarmView, swarmPanelLines, swarmStripLines, swarmActions } from './swarm-panel.mjs';
 
 const SPINNER = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
 const MOUSE_ON = '\x1b[?1000h\x1b[?1006h';
 const MOUSE_OFF = '\x1b[?1000l\x1b[?1006l';
-const HELP = "# Comal · keyboard\n\n| Action | Key |\n| --- | --- |\n| Discover commands and tools | F6 |\n| Complete command or argument | / and Tab; ↑/↓ chooses; Esc closes |\n| Send / enqueue | Enter (suggestions only complete) |\n| New line | Alt+Enter or Ctrl+J |\n| Switch mode | Shift+Tab |\n| Edit with $VISUAL/$EDITOR | Ctrl+G |\n| Work board | F3 or /board |\n| Continue from checkpoint | /work resume |\n| Sessions / resume | F2 or Ctrl+S |\n| Message queue | F4 or Ctrl+Q |\n| Expand tool results | Ctrl+O |\n| Scroll history | Mouse wheel / PgUp / PgDn |\n| Select text with mouse | F5 or /select; F5 or Esc returns |\n| Copy last full response | Alt+C or /copy |\n| Go to end | Ctrl+End |\n| Composer history | ↑/↓ on first/last line |\n| Start / end of line | Home / End or Ctrl+A / Ctrl+E |\n| Delete word / start / end | Ctrl+W / Ctrl+U / Ctrl+K |\n| Cancel turn / pause goal | Ctrl+C or Esc while working |\n| Exit | Ctrl+D with empty composer or /exit |\n\nYou can keep typing during streaming. Sent messages run in order when the current turn ends. F4 lets you pause, edit, remove, and reorder the queue.\n\n/context shows the context budget. /compact derives state without LLM and waits its turn if there is active work. /state shows request and state; /audit verifies the ledger. The original history is preserved.\n/house shows execution receipts and interrupted operations; /operations shows contracts and declared effects. Execution success does not certify the human goal.\n/plugins shows plugins, dependencies, and operations; enable/disable/reload wait their turn and only the user can change their lifecycle.\n/model ID and /effort LEVEL change the next call; during work they stay queued. /models lists models and /capabilities shows support, provenance, and levels. E indicates effort; Ctx shows the effective window (k/M tokens); ~ indicates a configured limit, ? unknown/fallback capability. /context shows exact values, reserve, and source. /login PROVIDER authenticates; /logout PROVIDER removes credentials from Comal.\n\n**Help keeps the composer active.** You can type while viewing it; PgUp/PgDn scrolls it and Esc/F1 closes it. Sending returns to the conversation. The wheel scrolls the conversation; the arrows edit the draft. F5 releases the mouse and freezes the view: drag to select and use your terminal's copy action (usually Ctrl+Shift+C). Work continues and the view updates when you return. /copy preserves Markdown and code blocks, without the screen line wrapping. Multi-line paste is not sent automatically.";
+const HELP = "# Comal · keyboard\n\n| Action | Key |\n| --- | --- |\n| Discover commands and tools | F6 |\n| Complete command or argument | / and Tab; ↑/↓ chooses; Esc closes |\n| Send / enqueue | Enter (suggestions only complete) |\n| New line | Alt+Enter or Ctrl+J |\n| Switch mode | Shift+Tab |\n| Edit with $VISUAL/$EDITOR | Ctrl+G |\n| Work board | F3 or /board |\n| Swarm panel (open-relay) | /swarm · /swarm strip |\n| Continue from checkpoint | /work resume |\n| Sessions / resume | F2 or Ctrl+S |\n| Message queue | F4 or Ctrl+Q |\n| Expand tool results | Ctrl+O |\n| Scroll history | Mouse wheel / PgUp / PgDn |\n| Select text with mouse | F5 or /select; F5 or Esc returns |\n| Copy last full response | Alt+C or /copy |\n| Go to end | Ctrl+End |\n| Composer history | ↑/↓ on first/last line |\n| Start / end of line | Home / End or Ctrl+A / Ctrl+E |\n| Delete word / start / end | Ctrl+W / Ctrl+U / Ctrl+K |\n| Cancel turn / pause goal | Ctrl+C or Esc while working |\n| Exit | Ctrl+D with empty composer or /exit |\n\nYou can keep typing during streaming. Sent messages run in order when the current turn ends. F4 lets you pause, edit, remove, and reorder the queue.\n\n/context shows the context budget. /compact derives state without LLM and waits its turn if there is active work. /state shows request and state; /audit verifies the ledger. The original history is preserved.\n/house shows execution receipts and interrupted operations; /operations shows contracts and declared effects. Execution success does not certify the human goal.\n/plugins shows plugins, dependencies, and operations; enable/disable/reload wait their turn and only the user can change their lifecycle.\n/model ID and /effort LEVEL change the next call; during work they stay queued. /models lists models and /capabilities shows support, provenance, and levels. E indicates effort; Ctx shows the effective window (k/M tokens); ~ indicates a configured limit, ? unknown/fallback capability. /context shows exact values, reserve, and source. /login PROVIDER authenticates; /logout PROVIDER removes credentials from Comal.\n\n**Help keeps the composer active.** You can type while viewing it; PgUp/PgDn scrolls it and Esc/F1 closes it. Sending returns to the conversation. The wheel scrolls the conversation; the arrows edit the draft. F5 releases the mouse and freezes the view: drag to select and use your terminal's copy action (usually Ctrl+Shift+C). Work continues and the view updates when you return. /copy preserves Markdown and code blocks, without the screen line wrapping. Multi-line paste is not sent automatically.";
 
 export class TerminalScreen {
   constructor({ input = process.stdin, output = process.stdout, metadata = {}, clipboard = copyText, env = process.env } = {}) {
@@ -403,6 +404,18 @@ export class TerminalScreen {
     try { this.composer.insert(text); this.draftChanged(); } catch (e) { this.notice(e.message, true); }
   }
   showBoard(board = this.work) { this.work = board; this.overlay = { kind: 'board', scroll: 0 }; this.schedule(); }
+  // Panel /swarm (open-relay, fase 4): la foto llega del host (plugin → ctx.provide → host),
+  // sin turnos del modelo. Se limpia al entrar y se vuelve a pintar sola si está a la vista.
+  setSwarmView(view) { this.swarmView = normalizeSwarmView(view); if (this.overlay?.kind === 'swarm' || this.swarmStrip) this.schedule(); }
+  toggleSwarm() { if (this.overlay?.kind === 'swarm') { this.closeOverlay(); return; } this.overlay = { kind: 'swarm', scroll: 0, swarm: 0, index: 0, follow: true }; this.schedule(); }
+  setSwarmStrip(value = !this.swarmStrip) { this.swarmStrip = Boolean(value); this.notice(this.swarmStrip ? t('Swarm strip on: a compact summary next to the conversation (terminals 110+ columns wide). /swarm strip turns it off.') : t('Swarm strip off.')); }
+  // Enter en el panel: prepara el pedido en el composer (no lo envía). El humano lo envía y
+  // las acciones siguen en sus tarjetas; Esc recupera el borrador anterior.
+  prepareSwarmRequest() {
+    const action = swarmActions(this.swarmView, this.overlay.swarm)[this.overlay.index]; if (!action) return;
+    if (!this.preparedDraft) this.preparedDraft = { ...this.composer.snapshot(), sessionId: this.metadata.sessionId };
+    this.composer.setText(action.request); this.closeOverlay(); this.draftChanged();
+  }
   setSelection(value = !this.selecting) {
     if (this.closed || this.suspended || this.permission) return;
     this.selecting = value; clearTimeout(this.renderTimer); this.renderTimer = null;
@@ -422,7 +435,7 @@ export class TerminalScreen {
     if (this.setup) { if (this.setup.kind === 'choice') this.setup.index = Math.max(0, Math.min(this.setupItems().length - 1, this.setup.index + event.delta)); this.schedule(); return; }
     const lines = event.delta * 3;
     if (this.permission) this.permission.scroll = Math.max(0, this.permission.scroll + lines);
-    else if (['help', 'board'].includes(this.overlay?.kind)) this.overlay.scroll = Math.max(0, this.overlay.scroll + lines);
+    else if (['help', 'board', 'swarm'].includes(this.overlay?.kind)) this.overlay.scroll = Math.max(0, this.overlay.scroll + lines);
     else if (this.overlay?.kind === 'sessions' || this.overlay?.kind === 'queue') {
       const length = this.overlay.kind === 'sessions' ? this.filteredSessions().length : this.queue.items.length;
       this.overlay.index = Math.max(0, Math.min(Math.max(0, length - 1), this.overlay.index + event.delta));
@@ -487,6 +500,15 @@ export class TerminalScreen {
     if (this.hasModalOverlay()) {
       if (name === 'escape') { this.closeOverlay(); return; }
       if (['help', 'board'].includes(this.overlay.kind)) { if (name === 'pageup' || name === 'up') this.overlay.scroll = Math.max(0, this.overlay.scroll - 5); if (name === 'pagedown' || name === 'down') this.overlay.scroll += 5; this.schedule(); return; }
+      if (this.overlay.kind === 'swarm') {
+        const swarms = this.swarmView?.available ? this.swarmView.swarms.length : 0, actions = swarmActions(this.swarmView, this.overlay.swarm).length;
+        if (name === 'up' || name === 'down') { this.overlay.index = Math.max(0, Math.min(Math.max(0, actions - 1), this.overlay.index + (name === 'up' ? -1 : 1))); this.overlay.follow = true; }
+        else if (name === 'pageup') this.overlay.scroll = Math.max(0, this.overlay.scroll - 5);
+        else if (name === 'pagedown') this.overlay.scroll += 5;
+        else if ((name === 'tab' || name === 'right' || name === 'left') && swarms > 1) { this.overlay.swarm = (this.overlay.swarm + (name === 'left' || key.shift ? swarms - 1 : 1)) % swarms; this.overlay.index = 0; this.overlay.scroll = 0; this.overlay.follow = true; }
+        else if (name === 'return' && actions) { this.prepareSwarmRequest(); return; }
+        this.schedule(); return;
+      }
       if (this.overlay.kind === 'sessions') {
         const filtered = this.filteredSessions();
         if (name === 'up') this.overlay.index = Math.max(0, this.overlay.index - 1);
@@ -612,6 +634,7 @@ export class TerminalScreen {
         return (selected ? tone.accent : String)(clip(line, columns));
       }), ...(!items.length ? [tone.muted(t("  No matches. Change section with Tab."))] : [])];
     }
+    if (this.overlay?.kind === 'swarm' && !this.permission) return swarmPanelLines(this.swarmView, this.overlay, columns, height, { busy: this.busy });
     if (this.overlay?.kind === 'board' && !this.permission) {
       const board = this.work, lines = [tone.accent(t("  Work · plan v{v0}", {v0: board?.plan?.version || 0})), ...wrap(safeText(board?.plan?.objective || t("No plan. Ask for a task with steps and checks.")), columns - 4).map(line => '  ' + line), tone.muted(t("  /work resume continues · wheel/PgUp/PgDn scrolls · Esc returns")), ''];
       const labels = { pending: t("PENDING"), in_progress: t("IN PROGRESS"), blocked: t("BLOCKED"), done: t("DONE · checks recorded"), needs_verification: t("TO VERIFY") };
@@ -686,6 +709,7 @@ export class TerminalScreen {
       const side = [tone.accent(t(" Queue · {v0}{v1}", {v0: this.queue.items.length, v1: this.queue.paused ? t(" paused") : ''})), tone.muted(t(" F4 manage")), ''];
       if (this.queue.running) side.push(tone.muted(t(" Running")), ...wrap(safeText(this.queue.running.text), sideWidth - 2).slice(0, 2).map(line => ' ' + line), '');
       this.queue.items.slice(0, 6).forEach((item, i) => side.push(tone.accent(` ${i + 1}. `) + clip(safeText(item.text).replace(/\n/g, ' ↵ '), sideWidth - 5), ''));
+      if (this.swarmStrip) side.push(...swarmStripLines(this.swarmView, sideWidth));
       body = body.map((line, i) => pad(line, bodyWidth) + tone.muted(' │') + clip(side[i] || '', sideWidth));
     }
     const elapsed = this.startedAt ? ((Date.now() - this.startedAt) / 1000).toFixed(1) : '0.0';