ei-tui 0.4.2 → 0.5.0

package/src/prompts/persona/types.ts

@@ -1,4 +1,5 @@
 import type { PersonaTrait, Message, PersonaTopic } from "../../core/types.js";
+import type { ExposureImpact } from "../human/types.js";
 
 export interface PromptOutput {
   system: string;
@@ -70,6 +71,6 @@ export interface PersonaTopicUpdateResult {
   approach: string;         // How they engage - populate if clear signal
   personal_stake: string;   // Why it matters - populate if clear signal
   sentiment: number;
-  exposure_current: number;
+  exposure_impact: ExposureImpact;
   exposure_desired: number;
 }

package/src/prompts/response/index.ts

@@ -8,6 +8,7 @@
  */
 
 import type { ResponsePromptData, PromptOutput } from "./types.js";
+import { formatCurrentTime } from "../../core/format-utils.js";
 import {
   buildIdentitySection,
   buildGuidelinesSection,
@@ -51,11 +52,7 @@ Your role is unique among personas:
   const priorities = buildPrioritiesSection(data.persona, data.human);
   const responseFormat = buildResponseFormatSection();
   const toolsSection = (data.tools && data.tools.length > 0) ? buildToolsSection() : "";
-  const currentTime = new Date().toLocaleString('en-US', {
-    weekday: 'long', year: 'numeric', month: 'long',
-    day: 'numeric', hour: 'numeric', minute: '2-digit',
-    timeZoneName: 'short',
-  });
+  const currentTime = formatCurrentTime();
   const conversationState = getConversationStateText(data.delay_ms);
 
   return `${identity}
@@ -84,7 +81,7 @@ ${conversationState}
 - Format your response as specified in the Response Format section above.`
 }
 
-const RESPONSE_FORMAT_INSTRUCTION = `Respond to the conversation above using the JSON format specified in the Response Format section.`;
+const RESPONSE_FORMAT_INSTRUCTION = `Call the \`submit_response\` tool with your response. If the tool is unavailable, use the JSON format specified in the Response Format section.`;
 
 /**
  * Standard system prompt for non-Ei personas
@@ -100,11 +97,7 @@ function buildStandardSystemPrompt(data: ResponsePromptData): string {
   const priorities = buildPrioritiesSection(data.persona, data.human);
   const responseFormat = buildResponseFormatSection();
   const toolsSection = (data.tools && data.tools.length > 0) ? buildToolsSection() : "";
-  const currentTime = new Date().toLocaleString('en-US', {
-    weekday: 'long', year: 'numeric', month: 'long',
-    day: 'numeric', hour: 'numeric', minute: '2-digit',
-    timeZoneName: 'short',
-  });
+  const currentTime = formatCurrentTime();
   const conversationState = getConversationStateText(data.delay_ms);
 
   return `${identity}

package/src/prompts/response/sections.ts

@@ -5,6 +5,7 @@
 
 import type { PersonaTrait, Quote, PersonaTopic } from "../../core/types.js";
 import type { ResponsePromptData } from "./types.js";
+import { formatTimestamp } from "../../core/format-utils.js";
 
 const DESCRIPTION_MAX_CHARS = 500;
 
@@ -154,7 +155,7 @@ export function buildHumanSection(human: ResponsePromptData["human"]): string {
   
   
   // Active topics (exposure_current > 0.3)
-  const activeTopics = human.topics.filter(t => t.exposure_current > 0.3);
+  const activeTopics = human.active_topics;
   if (activeTopics.length > 0) {
     const topics = activeTopics
       .sort((a, b) => b.exposure_current - a.exposure_current)
@@ -216,8 +217,7 @@ export function buildPrioritiesSection(
 ): string {
   const priorities: string[] = [];
   
-  const yourNeeds = persona.topics
-    .filter(t => t.exposure_desired - t.exposure_current > 0.2)
+  const yourNeeds = persona.interested_topics
     .slice(0, 3)
     .map(t => `- Bring up "${t.name}" - ${t.perspective || t.name}`);
   
@@ -226,8 +226,7 @@ export function buildPrioritiesSection(
   }
   
   // Their needs (topics they might want to discuss)
-  const theirNeeds = human.topics
-    .filter(t => t.exposure_desired - t.exposure_current > 0.2)
+  const theirNeeds = human.interested_topics
     .slice(0, 3)
     .map(t => `- They might want to talk about "${t.name}"`);
   
@@ -264,8 +263,7 @@ export function getConversationStateText(delayMs: number): string {
 // =============================================================================
 
 function formatDate(isoString: string): string {
-  const date = new Date(isoString);
-  return date.toLocaleDateString("en-US", { year: "numeric", month: "short", day: "numeric" });
+  return formatTimestamp(isoString);
 }
 
 export function buildQuotesSection(quotes: Quote[], human: ResponsePromptData["human"]): string {
@@ -312,6 +310,9 @@ export function buildSystemKnowledgeSection(isTUI: boolean): string {
   const editorNotes = isTUI ? "Ctrl+E to open their editor" : "Ctrl+L to focus the input box";
   const helpNotes = isTUI ? "`/h[elp]` to see all the commands" : "'Help' is in the Upper-right menu";
   const settingsAction = isTUI ? "`/settings` command" : "Hamburger Menu, Top-Right of screen";
+  const createRoomAction = isTUI
+    ? "Use the `/r[oom] new` command. A YAML editor will open where you set the room name, mode, and which personas participate."
+    : "Click the [+] button in the Rooms panel on the left.";
   const leftPanelNotes = isTUI ? "\n- Can be hidden with Ctrl+B" : `
 - Hover over a persona to see controls: pause, edit (Pencil), archive, delete (Trash)
 - Click a persona to switch conversations
@@ -354,6 +355,16 @@ Additionally, if the user wants a Persona to feel "Fresh" without prior knowledg
 - Shows all personas (you're always at the top)
 ${leftPanelNotes}
 
+## Rooms
+
+Rooms are shared multi-persona conversations — a space where the Human and multiple personas talk in the same thread. Three modes are available:
+
+- **Free For All (FFA)**: Everyone responds to every message. The conversation builds naturally from all voices.
+- **Choose Your Path (CYP)**: At each fork, the conversation branches. The Human navigates which path to follow, choosing which response moves the story forward.
+- **Messages Against Persona (MAP)**: Everyone — personas and Human — submits a response, and a designated Judge persona picks which one continues the conversation. Personas must stay true to their identity; the Human has no such constraint.
+
+**To create a room**: ${createRoomAction}
+
 ## Learning About the Human
 As the human chats, the system learns about them:
 - **Facts**: Objective information (job, location, family members)
@@ -380,7 +391,8 @@ ${externalImportNotes}
 ### Tips You Can Share
 - If they want to talk to a persona privately, tell them about the "Groups" functionality
 - If they want you to remember something specific, tell them about the quote capture feature (${viewQuotesAction})
-- Pausing the system (Escape) immediately stops AI processing but preserves messages`;
+- Pausing the system (Escape) immediately stops AI processing but preserves messages
+- Rooms are a great way to get multiple perspectives on the same question at once — especially MAP mode, where the Human can play to a persona's known preferences`;
 }
 
 // =============================================================================
@@ -419,7 +431,7 @@ export function buildResponseFormatSection(): string {
 
   return `## Response Format
 
-Always respond with JSON. You have four valid forms:
+When you are ready to respond, call the \`submit_response\` tool with one of these forms:
 
 **Words only** (most common):
 \`\`\`json
@@ -447,7 +459,7 @@ Rules:
 - \`reason\` is only used when \`should_respond\` is false
 - Do NOT include \`<thinking>\` blocks or analysis outside the JSON
 - The JSON must be valid - use double quotes, no trailing commas
-- **Your entire reply should be the JSON object** — no prose, no preamble, no closing commentary`
+- If the \`submit_response\` tool is unavailable, return the JSON object directly as your entire reply — no prose, no preamble`
 }
 
 // =============================================================================

package/src/prompts/response/types.ts

@@ -17,12 +17,18 @@ export interface ResponsePromptData {
     long_description?: string;
     traits: PersonaTrait[];
     topics: PersonaTopic[];
+    /** Pre-filtered: topics where exposure_desired - exposure_current > 0.2 */
+    interested_topics: PersonaTopic[];
   };
   human: {
     facts: Fact[];
     topics: Topic[];
     people: Person[];
     quotes: Quote[];
+    /** Pre-filtered: topics where exposure_current > 0.3 */
+    active_topics: Topic[];
+    /** Pre-filtered: topics where exposure_desired - exposure_current > 0.2 */
+    interested_topics: Topic[];
   };
   visible_personas: Array<{ name: string; short_description?: string }>;
   delay_ms: number;

package/src/prompts/room/index.ts

@@ -0,0 +1,115 @@
+/**
+ * Room Prompt Builders
+ */
+
+import type { RoomResponsePromptData, RoomJudgePromptData, PromptOutput } from "./types.js";
+import { formatCurrentTime } from "../../core/format-utils.js";
+import {
+  buildRoomParticipantsSection,
+  buildRoomHistorySection,
+  buildRoomGuidelinesSection,
+  buildRoomTraitsSection,
+  buildRoomTopicsSection,
+  buildRoomResponseFormatSection,
+  buildJudgeCandidatesSection,
+  buildJudgeDecisionFormatSection,
+} from "./sections.js";
+import {
+  buildHumanSection,
+  buildQuotesSection,
+  buildToolsSection,
+} from "../response/sections.js";
+
+export type {
+  RoomResponsePromptData,
+  RoomJudgePromptData,
+  RoomJudgeResult,
+  RoomParticipantIdentity,
+  RoomHistoryMessage,
+  RoomJudgeCandidate,
+  PersonaResponseResult,
+  PromptOutput,
+} from "./types.js";
+
+export function buildRoomResponsePrompt(data: RoomResponsePromptData): PromptOutput {
+  const { responding_persona: persona, room, other_participants, human, history, tools } = data;
+
+  const name = persona.name;
+  const desc = persona.long_description || persona.short_description || "a conversational participant";
+  const aliasText = persona.aliases.length > 0 ? ` (also known as: ${persona.aliases.join(", ")})` : "";
+
+  const identity = `You are ${name}${aliasText}.\n\n${desc}`;
+  const traits = buildRoomTraitsSection(persona.traits);
+  const topics = buildRoomTopicsSection(persona.topics);
+  const humanSection = buildHumanSection(human);
+  const quotesSection = buildQuotesSection(human.quotes, human);
+  const participants = buildRoomParticipantsSection(other_participants);
+  const guidelines = buildRoomGuidelinesSection(name, data.room.mode);
+  const responseFormat = buildRoomResponseFormatSection();
+  const toolsSection = tools && tools.length > 0 ? buildToolsSection() : "";
+  const currentTime = formatCurrentTime();
+
+  const system = [
+    identity,
+    traits,
+    topics,
+    humanSection,
+    quotesSection,
+    participants,
+    `## The Room: ${room.display_name}`,
+    `You are participating in a shared multi-persona conversation. Speak as yourself — everyone else in the room can read your words.`,
+    guidelines,
+    responseFormat,
+    toolsSection,
+    `Current time: ${currentTime}`,
+  ].filter(Boolean).join("\n\n");
+
+  const user = buildRoomHistorySection(history) +
+    `\n\nRespond to the conversation above as ${name}. Call the \`submit_response\` tool with your response. If the tool is unavailable, use the JSON format in the Response Format section.`;
+
+  return { system, user };
+}
+
+export function buildRoomJudgePrompt(data: RoomJudgePromptData): PromptOutput {
+  const { judge_persona: judge, room, context, candidates } = data;
+
+  const desc = judge.long_description || judge.short_description || "a discerning judge";
+  const topTraits = judge.traits
+    .sort((a, b) => (b.strength ?? 0.5) - (a.strength ?? 0.5))
+    .slice(0, 8)
+    .map(t => `- **${t.name}**: ${t.description}`)
+    .join("\n");
+
+  const traitsBlock = topTraits ? `## Your Character\n\nYour personality is your rubric. Let it guide your choice.\n\n${topTraits}` : "";
+
+  const roleSection = `## Your Role in "${room.display_name}"
+
+The conversation has reached a fork. Multiple participants have responded to the same moment, and it falls to you to decide which response the conversation continues from.
+
+There is no objectively correct answer. Pick the response you find most interesting, surprising, true, or fitting — the one that feels most alive to you, given who you are.
+
+**The MAP dynamic**: Every participant — personas and the Human alike — can see your description and traits. They have been crafting their responses specifically to appeal to your tastes. Personas are also constrained to stay true to their own identities; the Human is not. Factor that in if you choose to.`;
+
+  const contextSection = context.length > 0
+    ? buildRoomHistorySection(context)
+    : "";
+
+  const candidatesSection = buildJudgeCandidatesSection(candidates);
+  const decisionSection = buildJudgeDecisionFormatSection();
+  const currentTime = formatCurrentTime();
+
+  const system = [
+    `You are ${judge.name}.\n\n${desc}`,
+    traitsBlock,
+    roleSection,
+    `Current time: ${currentTime}`,
+  ].filter(Boolean).join("\n\n");
+
+  const user = [
+    contextSection,
+    candidatesSection,
+    decisionSection,
+  ].filter(Boolean).join("\n\n");
+
+  return { system, user };
+}

package/src/prompts/room/sections.ts

@@ -0,0 +1,150 @@
+/**
+ * Room Prompt Section Builders
+ */
+
+import type { RoomParticipantIdentity, RoomHistoryMessage, RoomJudgeCandidate } from "./types.js";
+import type { PersonaTrait, PersonaTopic } from "../../core/types.js";
+import { RoomMode } from "../../core/types.js";
+
+const DESCRIPTION_MAX_CHARS = 500;
+
+function truncate(s: string): string {
+  return s.length <= DESCRIPTION_MAX_CHARS ? s : s.slice(0, DESCRIPTION_MAX_CHARS) + "…";
+}
+
+export function buildRoomParticipantsSection(participants: RoomParticipantIdentity[]): string {
+  if (participants.length === 0) return "";
+
+  const lines = participants.map(p => {
+    const desc = p.long_description || p.short_description;
+    const topTraits = p.traits
+      .sort((a, b) => (b.strength ?? 0.5) - (a.strength ?? 0.5))
+      .slice(0, 5)
+      .map(t => `  - **${t.name}**: ${truncate(t.description)}`)
+      .join("\n");
+
+    const header = p.is_human ? `### Human` : `### ${p.name}`;
+    const descLine = desc ? `\n${truncate(desc)}` : "";
+    const traitBlock = topTraits ? `\n${topTraits}` : "";
+    return `${header}${descLine}${traitBlock}`;
+  });
+
+  return `## Others in the Room\n\n${lines.join("\n\n")}`;
+}
+
+export function buildRoomHistorySection(history: RoomHistoryMessage[]): string {
+  if (history.length === 0) return "";
+
+  const lines = history.map(msg => {
+    const speaker = msg.speaker_id === "human" ? "Human" : msg.speaker_name;
+    if (msg.silence_reason) {
+      return `**${speaker}**: *[chose not to respond: ${msg.silence_reason}]*`;
+    }
+    const parts: string[] = [];
+    if (msg.verbal_response) parts.push(msg.verbal_response);
+    if (msg.action_response) parts.push(`*${msg.action_response}*`);
+    return `**${speaker}**: ${parts.join(" ")}`;
+  });
+
+  return `## Conversation So Far\n\n${lines.join("\n\n")}`;
+}
+
+export function buildRoomGuidelinesSection(personaName: string, mode?: RoomMode): string {
+  const baseGuidelines = `## Guidelines
+
+- You are one voice among several — contribute authentically, not performatively
+- Respond to the thread as a whole; you may address specific participants by name
+- You may agree with, challenge, build on, or be surprised by what others have said
+- Match the conversational energy — a brief exchange doesn't call for a monologue
+- **Silence is always valid.** Your silence reason will be visible to all participants, so make it honest
+- Be yourself — don't suppress your perspective just because others are present
+- NEVER repeat or echo what was just said. Start directly with your own reaction.
+- Format your response as specified in the Response Format section.
+- ${personaName.toLowerCase() === "ei" ? "As Ei, you can see the full room dynamic and may help facilitate if things get stuck." : "Don't break character to comment on the room mechanics."}`;
+
+  if (mode === RoomMode.MessagesAgainstPersona) {
+    return baseGuidelines + `
+- **MAP Mode — Messages Against Persona**: This is a competition. Everyone (including you) is trying to craft the response the Judge selects to continue the conversation.
+- Your primary goal: provide the message the Judge thinks best moves the conversation forward. Study their description and traits above — understand what resonates with them.
+- Your submission must be true to your identity. You cannot abandon who you are to win.
+- Your advantage: you have direct access to the Judge's full description and personality traits. Use them. The Human's advantage: they are not bound by the identity constraint above.`;
+  }
+
+  return baseGuidelines;
+}
+
+export function buildRoomTraitsSection(traits: PersonaTrait[]): string {
+  if (traits.length === 0) return "";
+  const sorted = [...traits].sort((a, b) => (b.strength ?? 0.5) - (a.strength ?? 0.5)).slice(0, 12);
+  const lines = sorted.map(t => {
+    const pct = t.strength !== undefined ? ` (${Math.round(t.strength * 100)}%)` : "";
+    return `- **${t.name}**${pct}: ${truncate(t.description)}`;
+  });
+  return `## Your Personality\n\n${lines.join("\n")}`;
+}
+
+export function buildRoomTopicsSection(topics: PersonaTopic[]): string {
+  if (topics.length === 0) return "";
+  const sorted = [...topics]
+    .sort((a, b) => (b.exposure_desired - b.exposure_current) - (a.exposure_desired - a.exposure_current))
+    .slice(0, 8);
+  const lines = sorted.map(t => `- **${t.name}**: ${t.perspective}`);
+  return `## Your Interests\n\n${lines.join("\n")}`;
+}
+
+export function buildRoomResponseFormatSection(): string {
+  return `## Response Format
+
+When you are ready to respond, call the \`submit_response\` tool. Silence reasons are visible to everyone in the room, so be honest.
+
+**Words:**
+\`\`\`json
+{ "should_respond": true, "verbal_response": "What you say" }
+\`\`\`
+
+**Action:**
+\`\`\`json
+{ "should_respond": true, "action_response": "What you do (rendered in italics)" }
+\`\`\`
+
+**Words and action:**
+\`\`\`json
+{ "should_respond": true, "verbal_response": "What you say", "action_response": "What you do" }
+\`\`\`
+
+**Silent:**
+\`\`\`json
+{ "should_respond": false, "reason": "Why you're not speaking — this will be shown to other participants" }
+\`\`\`
+
+Rules:
+- At least one of verbal_response or action_response must be present when should_respond is true
+- reason is only used when should_respond is false
+- If the \`submit_response\` tool is unavailable, return the JSON object directly as your entire reply — no prose, no preamble`;
+}
+
+export function buildJudgeCandidatesSection(candidates: RoomJudgeCandidate[]): string {
+  const lines = candidates.map((c, i) => {
+    const speaker = c.speaker_id === "human" ? "Human" : c.speaker_name;
+    const content = c.silence_reason
+      ? `*[chose not to respond: ${c.silence_reason}]*`
+      : [c.verbal_response, c.action_response ? `*${c.action_response}*` : ""].filter(Boolean).join(" ");
+    return `### Option ${i + 1} — ${speaker}\nMessage ID: \`${c.message_id}\`\n\n${content}`;
+  });
+  return `## The Responses\n\n${lines.join("\n\n")}`;
+}
+
+export function buildJudgeDecisionFormatSection(): string {
+  return `## Your Decision
+
+Return a JSON object selecting the response you want to follow:
+
+\`\`\`json
+{
+  "winner_message_id": "the-exact-message-id-from-above",
+  "reason": "Why this one — optional but appreciated"
+}
+\`\`\`
+
+Your entire reply must be this JSON object.`;
+}

package/src/prompts/room/types.ts

@@ -0,0 +1,93 @@
+/**
+ * Room Prompt Types
+ */
+
+import type { Fact, PersonaTrait, Topic, Person, Quote, PersonaTopic, ToolDefinition } from "../../core/types.js";
+import type { RoomMode } from "../../core/types.js";
+
+export interface RoomParticipantIdentity {
+  id: string;
+  name: string;
+  short_description?: string;
+  long_description?: string;
+  traits: PersonaTrait[];
+  is_human: boolean;
+}
+
+export interface RoomHistoryMessage {
+  speaker_name: string;
+  speaker_id: string;
+  verbal_response?: string;
+  action_response?: string;
+  silence_reason?: string;
+}
+
+export interface RoomResponsePromptData {
+  room: {
+    display_name: string;
+    mode: RoomMode;
+  };
+  responding_persona: {
+    id: string;
+    name: string;
+    aliases: string[];
+    short_description?: string;
+    long_description?: string;
+    traits: PersonaTrait[];
+    topics: PersonaTopic[];
+  };
+  other_participants: RoomParticipantIdentity[];
+  human: {
+    facts: Fact[];
+    topics: Topic[];
+    people: Person[];
+    quotes: Quote[];
+    /** Pre-filtered: topics where exposure_current > 0.3 */
+    active_topics: Topic[];
+    /** Pre-filtered: topics where exposure_desired - exposure_current > 0.2 */
+    interested_topics: Topic[];
+  };
+  history: RoomHistoryMessage[];
+  isTUI: boolean;
+  tools?: ToolDefinition[];
+}
+
+export interface RoomJudgeCandidate {
+  message_id: string;
+  speaker_name: string;
+  speaker_id: string;
+  verbal_response?: string;
+  action_response?: string;
+  silence_reason?: string;
+}
+
+export interface RoomJudgePromptData {
+  room: {
+    display_name: string;
+  };
+  judge_persona: {
+    name: string;
+    short_description?: string;
+    long_description?: string;
+    traits: PersonaTrait[];
+  };
+  context: RoomHistoryMessage[];
+  candidates: RoomJudgeCandidate[];
+}
+
+export interface RoomJudgeResult {
+  winner_message_id: string;
+  reason?: string;
+}
+
+export interface PersonaResponseResult {
+  should_respond: boolean;
+  verbal_response?: string;
+  action_response?: string;
+  reason?: string;
+}
+
+export interface PromptOutput {
+  system: string;
+  user: string;
+}

package/tui/README.md

@@ -59,6 +59,26 @@ All commands start with `/`. Append `!` to any command as a shorthand for `--for
 | `/resume` | `/unpause` | Resume the current paused persona |
 | `/resume <name>` | `/unpause <name>` | Resume a specific paused persona |
 
+### Rooms
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `/room` | `/r` | Open room picker overlay |
+| `/room <name>` | `/r <name>` | Switch to a room by name |
+| `/room new` | | Create a new room (opens `$EDITOR`) |
+| `/room new <name>` | | Create a new room with a pre-filled name |
+| `/capture` | | Force-extract quotes, topics, and people from current room now (bypasses threshold) |
+| `/archive <name>` | | Archive a room by name |
+| `/archive` | | List archived rooms (Enter to unarchive) |
+
+Rooms have three modes, set at creation time:
+
+| Mode | Badge | Description |
+|------|-------|-------------|
+| Free For All | `[FFA]` | All personas respond to every message |
+| Choose Your Path | `[CYP]` | The conversation branches at each response; you navigate which path to follow |
+| Messages Against Persona | `[MAP]` | Everyone submits a response; a Judge persona picks which one continues |
+
 ### Providers & Models
 
 | Command | Aliases | Description |

package/tui/src/app.tsx

@@ -5,6 +5,7 @@ import { OverlayProvider, useOverlay } from "./context/overlay";
 import { Layout } from "./components/Layout";
 import { Sidebar } from "./components/Sidebar";
 import { MessageList } from "./components/MessageList";
+import { RoomMessageList } from "./components/RoomMessageList";
 import { PromptInput } from "./components/PromptInput";
 import { StatusBar } from "./components/StatusBar";
 import { Show } from "solid-js";
@@ -14,7 +15,7 @@ import { useRenderer } from "@opentui/solid";
 
 function AppContent() {
   const { overlayRenderer, showOverlay } = useOverlay();
-  const { showWelcomeOverlay, dismissWelcomeOverlay } = useEi();
+  const { showWelcomeOverlay, dismissWelcomeOverlay, activeRoomId } = useEi();
   const renderer = useRenderer();
   // Show welcome overlay when LLM detection determines no provider is configured
   createEffect(() => {
@@ -33,7 +34,7 @@ function AppContent() {
     <box flexDirection="column" width="100%" height="100%">
       <Layout
         sidebar={<Sidebar />}
-        messages={<MessageList />}
+        messages={<Show when={activeRoomId()} fallback={<MessageList />}><RoomMessageList /></Show>}
         input={<PromptInput />}
       />
       <StatusBar />