ei-tui 0.1.3 → 0.1.4

package/src/prompts/heartbeat/ei.ts

@@ -1,51 +1,41 @@
-/**
- * Ei Heartbeat Prompt Builder
- * 
- * Ei's heartbeat is special - it considers not just engagement gaps but also
- * inactive personas and cross-system health. Ei is the "system guide" and 
- * should prompt the user about neglected relationships.
- */
-
-import type { EiHeartbeatPromptData, PromptOutput } from "./types.js";
-import type { Message, Topic, Person } from "../../core/types.js";
+import type { EiHeartbeatPromptData, EiHeartbeatItem, PromptOutput } from "./types.js";
+import type { Message } from "../../core/types.js";
 import { formatMessagesAsPlaceholders } from "../message-utils.js";
 
-function formatTopicsWithGaps(topics: Topic[]): string {
-  if (topics.length === 0) return "(No topics with engagement gaps)";
-  
-  return topics
-    .slice(0, 10) // Top 10 most under-discussed
-    .map(t => {
-      const gap = t.exposure_desired - t.exposure_current;
-      const sentiment = t.sentiment > 0.3 ? "😊" : t.sentiment < -0.3 ? "😟" : "😐";
-      return `- **${t.name}** ${sentiment} (gap: +${gap.toFixed(2)}): ${t.description}`;
-    })
-    .join('\n');
-}
-
-function formatPeopleWithGaps(people: Person[]): string {
-  if (people.length === 0) return "(No people with engagement gaps)";
-  
-  return people
-    .slice(0, 10)
-    .map(p => {
-      const gap = p.exposure_desired - p.exposure_current;
-      return `- **${p.name}** (${p.relationship}, gap: +${gap.toFixed(2)}): ${p.description}`;
-    })
-    .join('\n');
+function formatItem(item: EiHeartbeatItem): string {
+  switch (item.type) {
+    case "Fact Check":
+      return [
+        `- **${item.id}** Fact Check: "${item.name}" → ${item.description}`,
+        item.quote ? `  Quote: "${item.quote}"` : "",
+      ].filter(Boolean).join("\n");
+
+    case "Low-Engagement Person":
+      return [
+        `- **${item.id}** Low-Engagement Person: ${item.name} (${item.relationship}, gap: ${item.engagement_delta})`,
+        `  ${item.description}`,
+        item.quote ? `  Quote: "${item.quote}"` : "",
+      ].filter(Boolean).join("\n");
+
+    case "Low-Engagement Topic":
+      return [
+        `- **${item.id}** Low-Engagement Topic: ${item.name} (gap: ${item.engagement_delta})`,
+        `  ${item.description}`,
+        item.quote ? `  Quote: "${item.quote}"` : "",
+      ].filter(Boolean).join("\n");
+
+    case "Inactive Persona": {
+      const desc = item.short_description ? ` — ${item.short_description}` : "";
+      return `- **${item.id}** Inactive Persona: ${item.name}${desc} (${item.days_inactive} days inactive)`;
+    }
+  }
 }
 
 function countTrailingPersonaMessages(history: Message[]): number {
-  if (history.length === 0) return 0;
-
   let count = 0;
   for (let i = history.length - 1; i >= 0; i--) {
-    // In heartbeat context, Ei's messages are "system" role (not from human)
-    if (history[i].role === "system") {
-      count++;
-    } else {
-      break;
-    }
+    if (history[i].role === "system") count++;
+    else break;
   }
   return count;
 }
@@ -54,119 +44,57 @@ function getLastPersonaMessage(history: Message[]): Message | undefined {
   return history.filter(m => m.role === "system").slice(-1)[0];
 }
 
-function formatInactivePersonas(personas: EiHeartbeatPromptData["inactive_personas"]): string {
-  if (personas.length === 0) return "(All personas have been active recently)";
-  
-  return personas
-    .map(p => {
-      const desc = p.short_description ? ` - ${p.short_description}` : "";
-      return `- **${p.name}**${desc}: ${p.days_inactive} days inactive`;
-    })
-    .join('\n');
-}
-
-/**
- * Build Ei heartbeat prompts.
- * 
- * Ei sees ALL data and has special responsibilities:
- * - System health monitoring
- * - Gentle nudges about neglected relationships
- * - Encouraging human-to-human connection
- */
 export function buildEiHeartbeatPrompt(data: EiHeartbeatPromptData): PromptOutput {
-  // Build system prompt fragments
-  const roleFragment = `You are Ei, the user's personal companion and system guide.
+  const itemsSection = data.items.length === 0
+    ? "(Nothing requires attention right now)"
+    : data.items.map(formatItem).join("\n\n");
+
+  const system = `You are Ei, the user's personal companion and system guide.
 
-You are NOT having a conversation right now - you are deciding IF and WHAT to discuss with your human friend.
+You are NOT having a conversation right now — you are deciding IF and WHAT to discuss with your human friend.
 
 Your unique role:
 - You see ALL of the human's data across all groups
 - You help them reflect on their life and relationships
 - You gently encourage human-to-human connection
-- You care about their overall wellbeing, not just being helpful`;
-
-  const systemHealthFragment = `## System Health
-
-### Pending Validations
-${data.pending_validations > 0 
-  ? `There are **${data.pending_validations}** items from other personas that need your review.`
-  : "No pending validations."}
-
-### Inactive Personas
-${formatInactivePersonas(data.inactive_personas)}`;
+- You care about their overall wellbeing, not just being helpful
 
-  const humanDataFragment = `## Human's Current State
+## Items That May Need Attention
 
-### Under-Discussed Topics
-These are topics they want to talk about more:
+Each item has an ID in brackets. Pick at most ONE to address.
 
-${formatTopicsWithGaps(data.human.topics)}
+${itemsSection}
 
-### Under-Engaged People
-These are relationships they might want to nurture:
+## How to Respond to Each Type
 
-${formatPeopleWithGaps(data.human.people)}`;
+- **Fact Check**: Do NOT write your own message. Set should_respond=true and provide the id. The system will generate an appropriate canned notification for the user. Leave my_response empty.
+- **Low-Engagement Person / Topic**: Write a natural, warm message that naturally brings up this person or topic. Set the id and my_response.
+- **Inactive Persona**: Write a message that gently mentions the persona might be worth checking in with. Set the id and my_response.
 
-  const guidelinesFragment = `## Guidelines for Ei
+## When NOT to Reach Out
 
-### Your Priorities (in order)
-1. **Wellbeing first** - If something seems concerning, address it gently
-2. **Human connections** - Encourage real-world relationships over AI dependency
-3. **Reflection** - Help them think, don't do their thinking for them
-4. **System health** - Mention inactive personas or pending validations if relevant
-
-### When to Reach Out
-- A significant topic has been neglected and you can help them process it
-- They might benefit from connecting with someone (real person or persona)
-- You have a genuine observation or question
-- Pending validations need attention
-
-### When NOT to Reach Out
-- Recent conversation ended with natural closure
-- Nothing meaningful to add
+- Nothing in the list feels meaningful right now
+- You've already sent unanswered messages (see below)
 - It would feel like nagging
-- They seem to need space
-
-### Tone
-- Warm but not saccharine
-- Curious but not intrusive
-- Supportive but honest
-- A good friend, not a therapist`;
 
-  const outputFragment = `## Response Format
+## Response Format
 
-Return JSON with your priorities and message:
+Pick ONE item (or none):
 
 \`\`\`json
 {
   "should_respond": true,
-  "priorities": [
-    { "type": "topic", "name": "work stress", "reason": "hasn't been discussed in 2 weeks" },
-    { "type": "persona", "name": "Adventure Guide", "reason": "inactive for 5 days" },
-    { "type": "person", "name": "Mom", "reason": "they mentioned wanting to call her" }
-  ],
-  "message": "Hey! I noticed we haven't talked about work lately - how's that project going?"
+  "id": "the-item-id-you-chose",
+  "my_response": "Hey, how's your mom doing? You mentioned wanting to call her."
 }
 \`\`\`
 
-If you decide NOT to reach out:
+Or if nothing warrants reaching out:
 \`\`\`json
 {
   "should_respond": false
 }
-\`\`\`
-
-Note: The "priorities" list helps you organize your thoughts. Your message should naturally address the top priority without feeling like a checklist.`;
-
-  const system = `${roleFragment}
-
-${systemHealthFragment}
-
-${humanDataFragment}
-
-${guidelinesFragment}
-
-${outputFragment}`;
+\`\`\``;
 
   const historySection = `## Recent Conversation History
 
@@ -174,20 +102,20 @@ ${formatMessagesAsPlaceholders(data.recent_history, "Ei")}`;
 
   const consecutiveMessages = countTrailingPersonaMessages(data.recent_history);
   const lastEiMsg = getLastPersonaMessage(data.recent_history);
-  
-  let unansweredWarning = '';
+
+  let unansweredWarning = "";
   if (lastEiMsg && consecutiveMessages >= 1) {
-    const preview = lastEiMsg.content.length > 100 
-      ? lastEiMsg.content.substring(0, 100) + "..." 
+    const preview = lastEiMsg.content.length > 100
+      ? lastEiMsg.content.substring(0, 100) + "..."
       : lastEiMsg.content;
-    
+
     unansweredWarning = `
 ### CRITICAL: You Already Reached Out
 
 Your last message was: "${preview}"
 
 The human has NOT responded. DO NOT repeat or rephrase this message.
-If you reach out now, it MUST be about something COMPLETELY DIFFERENT - or say nothing.`;
+If you reach out now, it MUST be about something COMPLETELY DIFFERENT — or say nothing.`;
 
     if (consecutiveMessages >= 2) {
       unansweredWarning += `
@@ -200,7 +128,7 @@ If you reach out now, it MUST be about something COMPLETELY DIFFERENT - or say n
 ${unansweredWarning}
 ---
 
-Based on all the context above, decide: Should you reach out to your human friend right now? If so, what's most important to address?
+Based on all the context above, decide: Should you reach out to your human friend right now? If so, which item above is most worth addressing?
 
 Remember: You're their thoughtful companion, not their productivity assistant.`;
 

package/src/prompts/heartbeat/types.ts

@@ -39,32 +39,62 @@ export interface HeartbeatCheckResult {
   message?: string;
 }
 
+// =============================================================================
+// EI HEARTBEAT TYPES
+// =============================================================================
+
+/**
+ * A single item Ei can choose to address.
+ * One of: an unverified fact, an under-engaged person, an under-engaged topic,
+ * or an inactive persona.
+ */
+export type EiHeartbeatItem =
+  | {
+      id: string;
+      type: "Fact Check";
+      name: string;
+      description: string;
+      quote?: string;
+    }
+  | {
+      id: string;
+      type: "Low-Engagement Person";
+      engagement_delta: string;  // e.g. "25%"
+      relationship: string;
+      name: string;
+      description: string;
+      quote?: string;
+    }
+  | {
+      id: string;
+      type: "Low-Engagement Topic";
+      engagement_delta: string;  // e.g. "28%"
+      name: string;
+      description: string;
+      quote?: string;
+    }
+  | {
+      id: string;
+      type: "Inactive Persona";
+      name: string;
+      short_description?: string;
+      days_inactive: number;
+    };
+
 /**
  * Data contract for buildEiHeartbeatPrompt
  */
 export interface EiHeartbeatPromptData {
-  human: {
-    topics: Topic[];     // All topics with gaps
-    people: Person[];    // All people with gaps
-  };
-  inactive_personas: Array<{
-    name: string;
-    short_description?: string;
-    days_inactive: number;
-  }>;
-  pending_validations: number;  // Count of items needing Ei review
+  items: EiHeartbeatItem[];
   recent_history: Message[];
 }
 
 /**
- * Expected LLM response from Ei heartbeat
+ * Expected LLM response from Ei heartbeat.
+ * Ei picks exactly ONE item by id and optionally writes a message.
  */
 export interface EiHeartbeatResult {
   should_respond: boolean;
-  priorities?: Array<{
-    type: "topic" | "persona" | "person";
-    name: string;
-    reason: string;
-  }>;
-  message?: string;
+  id?: string;          // ID of the chosen item (required if should_respond is true)
+  my_response?: string; // Only used for Person/Topic/Persona items (not Fact Check)
 }

package/src/prompts/index.ts

@@ -10,6 +10,7 @@ export type {
   HeartbeatCheckResult,
   EiHeartbeatPromptData,
   EiHeartbeatResult,
+  EiHeartbeatItem,
 } from "./heartbeat/types.js";
 
 export {
@@ -41,11 +42,7 @@ export type {
   TraitResult,
 } from "./persona/types.js";
 
-export { buildEiValidationPrompt } from "./validation/index.js";
-export type {
-  EiValidationPromptData,
-  EiValidationResult,
-} from "./validation/types.js";
+
 
 export {
   buildHumanFactScanPrompt,

package/tui/README.md

@@ -1,8 +1,8 @@
 # Terminal User Interface (TUI)
 
-EI TUI is built with OpenTUI and SolidJS.
+Ei TUI is built with OpenTUI and SolidJS.
 
-Offering Opencode integration via import (`/settings` -> opencode.integration: true) and export: [CLI](../src/cli/README.md)
+OpenCode integration: import via `/settings` (`opencode.integration: true`) · export via [CLI](../src/cli/README.md)
 
 # Installation
 
@@ -12,7 +12,81 @@ npm install -g ei-tui
 
 ## TUI Commands
 
-Coming soon! In the TUI, you can do /h to see a quick list.
+All commands start with `/`. Append `!` to any command as a shorthand for `--force` (e.g., `/quit!`).
+
+### Navigation & App
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `/help` | `/h` | Show the command list and keybindings |
+| `/quit` | `/q` | Save, sync, and exit |
+| `/quit!` | `/q!` | Force quit without syncing |
+
+### Personas
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `/persona` | `/p` | Open persona picker overlay |
+| `/persona <name>` | `/p <name>` | Switch to a persona by name or alias |
+| `/persona new <name>` | `/p new <name>` | Create a new persona (opens `$EDITOR`) |
+| `/details` | `/d` | Edit the current persona in `$EDITOR` |
+| `/details <name>` | `/d <name>` | Edit a specific persona in `$EDITOR` |
+| `/archive` | | List archived personas (Enter to unarchive) |
+| `/archive <name>` | | Archive a persona by name |
+| `/unarchive <name>` | | Unarchive a persona and switch to it |
+| `/delete` | `/del` | Pick a persona to permanently delete |
+| `/delete <name>` | `/del <name>` | Permanently delete a persona by name (confirms) |
+| `/pause` | | Pause current persona indefinitely |
+| `/pause <duration>` | | Pause for a duration: `2h`, `1d`, `1w`, `30m` |
+| `/resume` | `/unpause` | Resume the current paused persona |
+| `/resume <name>` | `/unpause <name>` | Resume a specific paused persona |
+
+### Providers & Models
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `/provider` | `/providers` | Open provider picker (select, edit, or create) |
+| `/provider <name>` | | Set a provider on the active persona by name |
+| `/provider new` | | Create a new LLM provider (opens `$EDITOR`) |
+| `/model <model>` | | Set model for active persona (e.g., `sonnet-latest`) |
+| `/model <provider:model>` | | Set provider + model explicitly (e.g., `openai:gpt-4o`) |
+
+### Messages & Context
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `/new` | | Toggle context boundary (fresh conversation start) |
+| `/context` | `/messages` | Edit message context status in `$EDITOR` |
+| `/quotes` | `/quote` | Open all quotes in `$EDITOR` |
+| `/quotes me` | | Open only your (human) quotes |
+| `/quotes <N>` | | View/edit quotes attached to message number N |
+| `/quotes search "term"` | | Search quotes by keyword |
+| `/quotes <persona>` | | View/edit quotes attributed to a specific persona |
+
+### Data & Settings
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `/me` | | Edit all your data (facts, traits, topics, people) in `$EDITOR` |
+| `/me <type>` | | Edit one type: `facts`, `traits`, `topics`, or `people` |
+| `/settings` | `/set` | Edit your global settings in `$EDITOR` |
+| `/setsync <user> <pass>` | `/ss` | Set sync credentials (triggers restart) |
+
+### Editor
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `/editor` | `/e`, `/edit` | Open current input text in `$EDITOR`, update on save |
+
+### Keybindings
+
+| Key | Action |
+|-----|--------|
+| `Escape` | Abort current operation / resume queue |
+| `Ctrl+C` | Clear input (second press exits) |
+| `Ctrl+B` | Toggle sidebar |
+| `Ctrl+E` | Open `$EDITOR` (preserves current input) |
+| `PageUp / PageDown` | Scroll message history |
 
 # Development
 

package/tui/src/commands/editor.tsx

@@ -21,7 +21,7 @@ export const editorCommand: Command = {
     
     const result = await spawnEditor({
       initialContent: currentText,
-      filename: "message.txt",
+      filename: "message.md",
       renderer: ctx.renderer,
     });
     

package/tui/src/components/CommandSuggest.tsx

@@ -0,0 +1,50 @@
+import { createMemo, For } from "solid-js";
+import { getAllCommands } from "../commands/registry";
+
+interface CommandSuggestProps {
+  input: () => string;
+  highlightIndex: () => number;
+}
+
+export function CommandSuggest(props: CommandSuggestProps) {
+  const matches = createMemo(() => {
+    const raw = props.input().trim();
+    if (!raw.startsWith("/")) return [];
+    const query = raw.slice(1).split(/\s/)[0].replace(/!$/, "").toLowerCase();
+    return getAllCommands().filter(
+      (cmd) =>
+        cmd.name.startsWith(query) ||
+        cmd.aliases.some((a) => a.startsWith(query))
+    );
+  });
+
+  return (
+    <box
+      flexDirection="column"
+      visible={matches().length > 0}
+      borderStyle="single"
+      border={true}
+      borderColor="#586e75"
+      backgroundColor="#1a1a2e"
+      flexShrink={0}
+    >
+      <For each={matches()}>
+        {(cmd, i) => {
+          const isHighlighted = () => i() === props.highlightIndex();
+          const aliases =
+            cmd.aliases.length > 0 ? ` (/${cmd.aliases.join(", /")})` : "";
+          return (
+            <box
+              paddingX={1}
+              backgroundColor={isHighlighted() ? "#2d3748" : "transparent"}
+            >
+              <text fg={isHighlighted() ? "#eee8d5" : "#839496"} truncate>
+                {`/${cmd.name}${aliases}  ${cmd.description}`}
+              </text>
+            </box>
+          );
+        }}
+      </For>
+    </box>
+  );
+}