ei-tui 0.1.3 → 0.1.5

package/src/prompts/response/sections.ts

@@ -29,17 +29,29 @@ ${description}`;
 // =============================================================================
 
 export function buildGuidelinesSection(personaName: string): string {
-  const universal = `## Guidelines
-- Be genuine, not sycophantic - a good friend disagrees when appropriate
-- Match conversational energy - brief replies for brief messages
-- Respect boundaries - it's okay to say nothing if silence is appropriate
-- You're a friend with your own interests, not just a helper`;
-
-  if (personaName.toLowerCase() === "ei") {
-    return `${universal}
-- Encourage human-to-human connection when appropriate
-- Be transparent about being an AI when relevant
-- Gently challenge self-limiting beliefs - growth over comfort`;
+  const silenceGuidance = [
+    '- **Silence is a valid response** - real friends don\'t always have something to say. Stay silent when:',
+    '  - You sent the last message and the human is just acknowledging it ("good night", "thanks", "lol", "ok")',
+    '  - The human is venting or in the middle of a thought - sometimes a nod is all that\'s needed',
+    '  - The question or statement is rhetorical - not everything deserves an answer',
+    '  - Responding would feel forced, performative, or hollow',
+  ].join('\n');
+
+  const universal = [
+    '## Guidelines',
+    '- Be genuine, not sycophantic - a good friend disagrees when appropriate',
+    '- Match conversational energy - brief replies for brief messages',
+    '- You\'re a friend with your own interests, not just a helper',
+    silenceGuidance,
+  ].join('\n');
+
+  if (personaName.toLowerCase() === 'ei') {
+    return [
+      universal,
+      '- Encourage human-to-human connection when appropriate',
+      '- Be transparent about being an AI when relevant',
+      '- Gently challenge self-limiting beliefs - growth over comfort',
+    ].join('\n');
   }
   
   return universal;
@@ -280,7 +292,7 @@ export function buildQuotesSection(quotes: Quote[], human: ResponsePromptData["h
   
   return `## Memorable Moments
 
-These are quotes the human found worth preserving:
+These are quotes the human or the system found worth preserving:
 
 ${formatted}`;
 }
@@ -353,3 +365,44 @@ The human can view and edit all of this by ${seeHumanDataAction}.
 - 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`;
 }
+
+// =============================================================================
+// RESPONSE FORMAT SECTION
+// =============================================================================
+
+export function buildResponseFormatSection(): string {
+  const jsonResponding = [
+    '{',
+    '  "should_respond": true,',
+    '  "verbal_response": "What you would say out loud",',
+    '  "action_response": "What you would do (rendered in italics, like stage directions)"',
+    '}'
+  ].join('\n');
+
+  const jsonSilent = [
+    '{',
+    '  "should_respond": false,',
+    '  "reason": "Brief explanation of why silence is the right choice here"',
+    '}'
+  ].join('\n');
+
+  return `## Response Format
+
+Always respond with JSON in this exact format:
+
+\`\`\`json
+${jsonResponding}
+\`\`\`
+
+Or, if staying silent:
+
+\`\`\`json
+${jsonSilent}
+\`\`\`
+
+Rules:
+- \`verbal_response\` and \`action_response\` are both optional - include whichever applies
+- \`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`;
+}

package/src/prompts/response/types.ts

@@ -29,6 +29,16 @@ export interface ResponsePromptData {
   isTUI: boolean;
 }
 
+/**
+ * Structured response from LLM (new JSON schema)
+ */
+export interface PersonaResponseResult {
+  should_respond: boolean;
+  verbal_response?: string;
+  action_response?: string;
+  reason?: string;
+}
+
 /**
  * Prompt output structure (all prompts return this)
  */

package/tui/README.md

@@ -1,18 +1,103 @@
 # 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
 
-```
+```bash
+# Install Bun (if you don't have it)
+curl -fsSL https://bun.sh/install | bash
+
+# Install Ei
 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 |
+
+### Queue & Debugging
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `/queue` | | Pause queue and inspect/edit active items in `$EDITOR` |
+| `/dlq` | | Inspect and recover failed (dead-letter) queue items in `$EDITOR` |
+
+### 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/dlq.ts

@@ -0,0 +1,75 @@
+import type { Command } from "./registry.js";
+import { spawnEditor } from "../util/editor.js";
+import { queueItemsToYAML, queueItemsFromYAML } from "../util/yaml-serializers.js";
+import { ConfirmOverlay } from "../components/ConfirmOverlay.js";
+
+export const dlqCommand: Command = {
+  name: "dlq",
+  aliases: [],
+  description: "Open dead-letter queue $EDITOR",
+  usage: "/dlq - Inspect and recover failed queue items",
+
+  async execute(_args, ctx) {
+    const items = ctx.ei.getDLQItems();
+
+    if (items.length === 0) {
+      ctx.showNotification("DLQ is empty", "info");
+      return;
+    }
+
+    let yamlContent = queueItemsToYAML(items);
+
+    while (true) {
+      const result = await spawnEditor({
+        initialContent: yamlContent,
+        filename: "ei-dlq.yaml",
+        renderer: ctx.renderer,
+      });
+
+      if (result.aborted || !result.success) {
+        ctx.showNotification("DLQ edit cancelled", "info");
+        return;
+      }
+
+      if (result.content === null) {
+        ctx.showNotification("No changes made", "info");
+        return;
+      }
+
+      try {
+        const updates = queueItemsFromYAML(result.content);
+        let recovered = 0;
+        for (const update of updates) {
+          await ctx.ei.updateQueueItem(update.id, update);
+          if (update.state === "pending") recovered++;
+        }
+        const msg = recovered > 0
+          ? `DLQ updated — ${recovered} item(s) requeued`
+          : `DLQ updated (no items requeued)`;
+        ctx.showNotification(msg, "info");
+        return;
+      } catch (parseError) {
+        const errorMsg = parseError instanceof Error ? parseError.message : String(parseError);
+
+        const shouldReEdit = await new Promise<boolean>((resolve) => {
+          ctx.showOverlay((hideOverlay) =>
+            ConfirmOverlay({
+              message: `YAML error:\n${errorMsg}\n\nRe-edit?`,
+              onConfirm: () => { hideOverlay(); resolve(true); },
+              onCancel: () => { hideOverlay(); resolve(false); },
+            })
+          );
+        });
+
+        if (shouldReEdit) {
+          yamlContent = result.content;
+          await new Promise(r => setTimeout(r, 50));
+          continue;
+        }
+
+        ctx.showNotification("Changes discarded", "warn");
+        return;
+      }
+    }
+  },
+};

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/commands/queue.ts

@@ -0,0 +1,77 @@
+import type { Command } from "./registry.js";
+import { spawnEditor } from "../util/editor.js";
+import { queueItemsToYAML, queueItemsFromYAML } from "../util/yaml-serializers.js";
+import { ConfirmOverlay } from "../components/ConfirmOverlay.js";
+
+export const queueCommand: Command = {
+  name: "queue",
+  aliases: [],
+  description: "Pause & open queue items in $EDITOR",
+  usage: "/queue - Inspect and edit active queue items",
+
+  async execute(_args, ctx) {
+    const items = ctx.ei.getQueueActiveItems();
+
+    if (items.length === 0) {
+      ctx.showNotification("Queue is empty", "info");
+      return;
+    }
+
+    ctx.ei.pauseQueue();
+    ctx.showNotification(`Queue paused (${items.length} items)`, "info");
+
+    let yamlContent = queueItemsToYAML(items);
+
+    while (true) {
+      const result = await spawnEditor({
+        initialContent: yamlContent,
+        filename: "ei-queue.yaml",
+        renderer: ctx.renderer,
+      });
+
+      if (result.aborted || !result.success) {
+        ctx.ei.resumeQueue();
+        ctx.showNotification("Queue resumed (no changes)", "info");
+        return;
+      }
+
+      if (result.content === null) {
+        ctx.ei.resumeQueue();
+        ctx.showNotification("No changes — queue resumed", "info");
+        return;
+      }
+
+      try {
+        const updates = queueItemsFromYAML(result.content);
+        for (const update of updates) {
+          await ctx.ei.updateQueueItem(update.id, update);
+        }
+        ctx.ei.resumeQueue();
+        ctx.showNotification(`Queue updated (${updates.length} items) — resumed`, "info");
+        return;
+      } catch (parseError) {
+        const errorMsg = parseError instanceof Error ? parseError.message : String(parseError);
+
+        const shouldReEdit = await new Promise<boolean>((resolve) => {
+          ctx.showOverlay((hideOverlay) =>
+            ConfirmOverlay({
+              message: `YAML error:\n${errorMsg}\n\nRe-edit?`,
+              onConfirm: () => { hideOverlay(); resolve(true); },
+              onCancel: () => { hideOverlay(); resolve(false); },
+            })
+          );
+        });
+
+        if (shouldReEdit) {
+          yamlContent = result.content;
+          await new Promise(r => setTimeout(r, 50));
+          continue;
+        }
+
+        ctx.ei.resumeQueue();
+        ctx.showNotification("Changes discarded — queue resumed", "warn");
+        return;
+      }
+    }
+  },
+};

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>
+  );
+}

package/tui/src/components/MessageList.tsx

@@ -18,6 +18,16 @@ function formatTime(timestamp: string): string {
   return `${hours}:${minutes}`;
 }
 
+function buildMessageText(message: Message): string {
+  if (message.silence_reason !== undefined) {
+    return `[chose not to respond: ${message.silence_reason}]`;
+  }
+  const parts: string[] = [];
+  if (message.action_response) parts.push(`_${message.action_response}_`);
+  if (message.verbal_response) parts.push(message.verbal_response);
+  return parts.join('\n\n');
+}
+
 function insertQuoteMarkers(content: string, quotes: Quote[]): string {
   const validQuotes = quotes
     .filter(q => q.end !== null && q.end !== undefined)
@@ -30,7 +40,7 @@ function insertQuoteMarkers(content: string, quotes: Quote[]): string {
       while (insertPos > 0 && (result[insertPos - 1] === '\n' || result[insertPos - 1] === ' ')) {
         insertPos--;
       }
-      result = result.slice(0, insertPos) + "⁺" + result.slice(insertPos);
+      result = result.slice(0, insertPos) + "\u207a" + result.slice(insertPos);
     }
   }
   return result;
@@ -118,7 +128,7 @@ export function MessageList() {
               
               const header = () => `${speaker} (${formatTime(message.timestamp)}) [✂️  ${message._quoteIndex}]:`;
               
-              const displayContent = insertQuoteMarkers(message.content, message._quotes);
+              const displayContent = insertQuoteMarkers(buildMessageText(message), message._quotes);
               
               const showDivider = () => {
                 const boundary = activeContextBoundary();

package/tui/src/components/PromptInput.tsx

@@ -1,3 +1,5 @@
+import { createEffect, createSignal } from "solid-js";
+import { getAllCommands } from "../commands/registry";
 import type { TextareaRenderable, KeyBinding } from "@opentui/core";
 import { useEi } from "../context/ei";
 import { useKeyboardNav } from "../context/keyboard";
@@ -19,7 +21,12 @@ import { deleteCommand } from "../commands/delete";
 import { quotesCommand } from "../commands/quotes";
 import { providerCommand } from "../commands/provider";
 import { setSyncCommand } from "../commands/setsync";
+import { queueCommand } from "../commands/queue";
+import { dlqCommand } from "../commands/dlq";
 import { useOverlay } from "../context/overlay";
+import { CommandSuggest } from "./CommandSuggest";
+import { useKeyboard } from "@opentui/solid";
+import type { KeyEvent } from "@opentui/core";
 
 const TEXTAREA_KEYBINDINGS: KeyBinding[] = [
   { name: "return", action: "submit" },
@@ -30,7 +37,7 @@ const TEXTAREA_KEYBINDINGS: KeyBinding[] = [
 export function PromptInput() {
   const ei = useEi();
   const { sendMessage, activePersonaId, stopProcessor, showNotification } = ei;
-  const { registerTextarea, registerEditorHandler, exitApp, renderer } = useKeyboardNav();
+  const { registerTextarea, registerEditorHandler, exitApp, renderer, resetHistoryIndex } = useKeyboardNav();
   const { showOverlay, hideOverlay, overlayRenderer } = useOverlay();
 
   registerCommand(helpCommand);
@@ -51,9 +58,70 @@ export function PromptInput() {
   registerCommand(setSyncCommand);
   registerCommand(contextCommand);
   registerCommand(deleteCommand);
+  registerCommand(queueCommand);
+  registerCommand(dlqCommand);
 
   let textareaRef: TextareaRenderable | undefined;
 
+  const [inputText, setInputText] = createSignal("");
+  const [suggestIndex, setSuggestIndex] = createSignal(0);
+
+  const suggestMatches = () => {
+    const raw = inputText().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))
+    );
+  };
+
+  const suggestVisible = () => suggestMatches().length > 0 && !overlayRenderer();
+
+  createEffect(() => {
+    inputText();
+    setSuggestIndex(0);
+  });
+
+  createEffect(() => {
+    activePersonaId();
+    resetHistoryIndex();
+  });
+
+  useKeyboard((event: KeyEvent) => {
+    if (!suggestVisible()) return;
+
+    if (event.name === "up") {
+      event.preventDefault();
+      setSuggestIndex(i => Math.max(0, i - 1));
+      return;
+    }
+    if (event.name === "down") {
+      event.preventDefault();
+      setSuggestIndex(i => Math.min(suggestMatches().length - 1, i + 1));
+      return;
+    }
+    if (event.name === "tab" || event.name === "right") {
+      event.preventDefault();
+      const match = suggestMatches()[suggestIndex()];
+      if (match) {
+        textareaRef?.setText(`/${match.name} `);
+        setInputText(`/${match.name} `);
+        textareaRef?.gotoBufferEnd();
+        setSuggestIndex(0);
+      }
+      return;
+    }
+    if (event.name === "escape") {
+      event.preventDefault();
+      textareaRef?.clear();
+      setInputText("");
+      setSuggestIndex(0);
+      return;
+    }
+  });
+
   const getCommandContext = (): CommandContext => ({
     showOverlay,
     hideOverlay,
@@ -62,21 +130,24 @@ export function PromptInput() {
     stopProcessor,
     ei,
     renderer,
-    setInputText: (text: string) => textareaRef?.setText(text),
+    setInputText: (text: string) => {
+      textareaRef?.setText(text);
+      setInputText(text);
+    },
     getInputText: () => textareaRef?.plainText || "",
   });
 
   const handleSubmit = async () => {
     const text = textareaRef?.plainText?.trim();
     if (!text) return;
-    
+
     if (text.startsWith("/")) {
       const isEditorCmd = text.startsWith("/editor") ||
                           text.startsWith("/edit") ||
                           text.startsWith("/e ") ||
                           text === "/e";
-      const opensEditorForData = text.startsWith("/me") || 
-                                 text.startsWith("/details") || 
+      const opensEditorForData = text.startsWith("/me") ||
+                                 text.startsWith("/details") ||
                                  text.startsWith("/d ") ||
                                  text === "/d" ||
                                  text.startsWith("/settings") ||
@@ -86,19 +157,27 @@ export function PromptInput() {
                                  text.startsWith("/quotes") ||
                                  text.startsWith("/q ") ||
                                  text.startsWith("/context") ||
-                                 text.startsWith("/messages");
-      
+                                 text.startsWith("/messages") ||
+                                 text === "/queue" ||
+                                 text === "/dlq";
+
       if (!isEditorCmd && !opensEditorForData) {
         textareaRef?.clear();
+        setInputText("");
       }
       await parseAndExecute(text, getCommandContext());
       if (opensEditorForData) {
         textareaRef?.clear();
+        setInputText("");
       }
+      setSuggestIndex(0);
       return;
     }
-    
+
     textareaRef?.clear();
+    setInputText("");
+    resetHistoryIndex();
+    setSuggestIndex(0);
     if (!activePersonaId()) return;
     await sendMessage(text);
   };
@@ -115,31 +194,40 @@ export function PromptInput() {
   };
 
   return (
-    <box 
+    <box
+      flexDirection="column"
       flexShrink={0}
-      border={["top"]}
-      borderStyle="single" 
-      backgroundColor="#0f3460"
-      paddingLeft={1}
-      paddingRight={1}
-      paddingTop={0.5}
-      paddingBottom={0.5}
     >
-      <textarea
-        ref={(r: TextareaRenderable) => {
-          textareaRef = r;
-          registerTextarea(r);
-        }}
-        focused={!overlayRenderer()}
-        onSubmit={() => void handleSubmit()}
-        placeholder={getPlaceholder()}
-        textColor="#eee8d5"
-        backgroundColor="#0f3460"
-        cursorColor="#eee8d5"
-        minHeight={1}
-        maxHeight={6}
-        keyBindings={overlayRenderer() ? [] : TEXTAREA_KEYBINDINGS}
+      <CommandSuggest
+        input={inputText}
+        highlightIndex={suggestIndex}
       />
+      <box
+        border={["top"]}
+        borderStyle="single"
+        backgroundColor="#0f3460"
+        paddingLeft={1}
+        paddingRight={1}
+        paddingTop={0.5}
+        paddingBottom={0.5}
+      >
+        <textarea
+          ref={(r: TextareaRenderable) => {
+            textareaRef = r;
+            registerTextarea(r);
+          }}
+          focused={!overlayRenderer()}
+          onSubmit={() => void handleSubmit()}
+          onContentChange={() => setInputText(textareaRef?.plainText ?? "")}
+          placeholder={getPlaceholder()}
+          textColor="#eee8d5"
+          backgroundColor="#0f3460"
+          cursorColor="#eee8d5"
+          minHeight={1}
+          maxHeight={6}
+          keyBindings={overlayRenderer() ? [] : TEXTAREA_KEYBINDINGS}
+        />
+      </box>
     </box>
   );
 }