Function room

engine/src/cli.ts:190–287

* `kild room ` — the room demo. Opens a room of predefined participants * (`--participants orchestrator,worker,reviewer`; default `orchestrator,worker`), * posts the goal to the first one, and streams every message. With `--worktree * ` the whole room shares one `kild/ ` tree (pa

(goal: string)

  const known = (await loadProjects()).map((p) => p.name);
  throw new Error(
    `unknown project: ${values.project} — not registered, and ${asPath} is not a directory.` +
      (known.length ? ` Registered: ${known.join(', ')}.` : '') +
      ' Pass a path, or register it with `kild project add <name> <path>`.',
  );
}

/** `kild persona <ls|show>` — the reusable persona definitions the project ships. */
async function persona(action: string | undefined, args: string[]): Promise<void> {
  const projectPath = await resolveProjectFlag();
  if (action === 'ls') {
    const personas = await listPersonas(projectPath);
    if (json) return void console.log(JSON.stringify(personas, null, 2));
    for (const p of personas) console.log(p.name);
  } else if (action === 'show') {
    const [name] = args;
    if (!name) throw new Error('usage: kild persona show <name>');
    const found = (await listPersonas(projectPath)).find((p) => p.name === name);
    if (!found) throw new Error(`no such persona: ${name}`);
    if (json) console.log(JSON.stringify(found, null, 2));
    else if (found.systemPrompt) console.log(found.systemPrompt);
    else console.error(`(persona '${name}' uses pi's default prompt)`);
  } else {
    throw new Error('usage: kild persona <ls|show>');
  }
}

async function engineRunning(): Promise<boolean> {
  return fetch(`${ENGINE}/api/health`)
    .then((r) => r.ok)
    .catch(() => false);
}

async function run(prompt: string): Promise<void> {
  if (!prompt) throw new Error('usage: kild run <prompt…>');
  // If the engine is up, run THROUGH it so the session shows up in UI clients;
  // otherwise run the agent in-process so the CLI works standalone.
  return (await engineRunning()) ? runViaEngine(prompt) : runViaAgent(prompt);
}

/** `kild agents` — list live agents. */
async function agentsList(): Promise<void> {
  const agents = await listAgents();
  if (json) return void console.log(JSON.stringify(agents, null, 2));
  if (agents.length === 0) return void console.error('no live agents');
  for (const a of agents) {
    console.log(`${a.id}\t${a.persona ?? GENERAL_PERSONA}${a.model ? ` (${a.model})` : ''}`);
  }
}

/**
 * `kild new <goal>` — opens a kild of agents (`--agents a,b,c`, each a
 * persona from the project's own personas; with none, one `general` agent), sends the goal
 * to the agents named by `--to`, and streams every message. With
 * `--worktree <name>` the whole kild shares one `kild/<name>` tree (agents attach to it).
 * You can keep typing to send more messages to the same recipients.
 * The run ends when the kild does: an agent stops it with its `stop` tool
 * after the final report, or Ctrl-C is the kill switch — it stops the kild