ei-tui 0.4.2 → 0.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ei-tui",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "author": "Flare576",
   "repository": {
     "type": "git",

package/src/cli/README.md

@@ -10,6 +10,8 @@ ei people -n 5 "query string"  # Return up to 5 people
 ei topics -n 5 "query string"  # Return up to 5 topics
 ei quotes -n 5 "query string"  # Return up to 5 quotes
 ei --persona "Beta" "query string"    # Filter results to what Beta has learned
+ei --recent                            # Most recently mentioned items (no query needed)
+ei --persona "Beta" --recent           # Most recently mentioned items Beta has learned
 ei --id <id>                   # Look up a specific entity by ID
 echo <id> | ei --id            # Look up entity by ID from stdin
 ei --install                   # Register Ei with OpenCode, Claude Code, and Cursor
@@ -110,8 +112,7 @@ conversations (facts, people, topics, quotes).
   than only code.
 
 **How to use:**
-1. Call `ei_search` (server `user-ei`) with a natural-language query; optionally filter by
-   `type` (facts, people, topics, quotes) or `persona` display_name.
+1. Call `ei_search` (server `user-ei`) with a natural-language query (or omit query and use `recent: true` to browse); optionally filter by `type` (facts, people, topics, quotes) or `persona` display_name.
 2. If you need full detail for a result, call `ei_lookup` with the entity `id` from step 1.
 
 Prefer querying Ei before asking the user for context they may have already shared.
@@ -123,11 +124,12 @@ The installed tool gives OpenCode agents access to all four data types with prop
 
 | Arg | Type | Description |
 |-----|------|-------------|
-| `query` | string (required) | Search text, or entity ID when `lookup=true` |
+| `query` | string (optional) | Search text, or entity ID when `lookup=true`. Omit to browse by recency. |
 | `persona` | string (optional) | Persona display_name to filter results — only returns entities that persona has extracted |
 | `type` | enum (optional) | `facts` \| `people` \| `topics` \| `quotes` — omit for balanced results |
 | `limit` | number (optional) | Max results, default 10 |
 | `lookup` | boolean (optional) | If true, fetch single entity by ID |
+| `recent` | boolean (optional) | If true, sort by most recently mentioned. Can be combined with `persona` or `query`. |
 
 ## Output Shapes
 

package/src/cli/mcp.ts

@@ -16,9 +16,9 @@ export function createMcpServer(): McpServer {
     "ei_search",
     {
       description:
-        "Search the user's Ei knowledge base — a persistent memory store built from conversations. Returns facts, people, topics of interest, and quotes. Results include entity IDs that can be passed back to ei_lookup for full detail.",
+        "Search the user's Ei knowledge base — a persistent memory store built from conversations. Returns facts, people, topics of interest, and quotes. Results include entity IDs that can be passed back to ei_lookup for full detail. Omit query to browse by recency (use with recent=true or persona filter).",
       inputSchema: {
-        query: z.string().describe("Search text. Supports natural language."),
+        query: z.string().optional().describe("Search text. Supports natural language. Omit to browse without semantic filtering — useful with recent=true or persona filter."),
         type: z
           .enum(["facts", "people", "topics", "quotes"])
           .optional()
@@ -42,7 +42,8 @@ export function createMcpServer(): McpServer {
           .describe("If true, sort by most recently mentioned."),
       },
     },
-    async ({ query, type, persona, limit, recent }) => {
+    async ({ query: rawQuery, type, persona, limit, recent }) => {
+      const query = rawQuery ?? "";
       const options = { recent: recent ?? false };
       const effectiveLimit = limit ?? 10;
 

package/src/cli.ts

@@ -84,8 +84,8 @@ function buildOpenCodeToolContent(): string {
     '    "Results include entity IDs that can be passed back with lookup=true to get full detail.",',
     '  ].join(" "),',
     '  args: {',
-    '    query: tool.schema.string().describe(',
-    '      "Search text, or an entity ID when lookup=true. Supports natural language."',
+    '    query: tool.schema.string().optional().describe(',
+    '      "Search text, or an entity ID when lookup=true. Supports natural language. Omit to browse by recency."',
     '    ),',
     '    type: tool.schema',
     '      .enum(["facts", "people", "topics", "quotes"])',
@@ -112,16 +112,23 @@ function buildOpenCodeToolContent(): string {
     '      .describe(',
     '        "If true, treat query as an entity ID and return that single entity in full detail."',
     '      ),',
+    '    recent: tool.schema',
+    '      .boolean()',
+    '      .optional()',
+    '      .describe(',
+    '        "If true, sort by most recently mentioned. Can be combined with persona or query."',
+    '      ),',
     '  },',
     '  async execute(args) {',
     '    const cmd: string[] = ["ei"];',
     '    if (args.lookup) {',
-    '      cmd.push("--id", args.query);',
+    '      cmd.push("--id", args.query ?? "");',
     '    } else {',
     '      if (args.type) cmd.push(args.type);',
     '      if (args.persona) cmd.push("--persona", args.persona);',
+    '      if (args.recent) cmd.push("--recent");',
     '      if (args.limit && args.limit !== 10) cmd.push("-n", String(args.limit));',
-    '      cmd.push(args.query);',
+    '      if (args.query) cmd.push(args.query);',
     '    }',
     '    return Bun.$`${cmd}`.text();',
     '  },',
@@ -312,18 +319,10 @@ async function main(): Promise<void> {
 
   const query = parsed.positionals.join(" ").trim();
   const limit = parsed.values.number ? parseInt(parsed.values.number, 10) : 10;
-  const recent = parsed.values.recent === true;
+  // Default to recent mode when no query — allows `ei --persona Foo` and `ei` with no args
+  const recent = parsed.values.recent === true || !query;
   const personaName = parsed.values.persona?.trim();
 
-  if (!query && !recent) {
-    if (targetType) {
-      console.error(`Search text required. Usage: ei ${targetType} "search text"`);
-    } else {
-      console.error(`Search text required. Usage: ei "search text"`);
-    }
-    process.exit(1);
-  }
-
   if (isNaN(limit) || limit < 1) {
     console.error("--number must be a positive integer");
     process.exit(1);

package/src/core/format-utils.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared timestamp formatter for all LLM-facing date/time strings.
+ * Consistent format across system prompt, quotes, and message history
+ * so models can trivially compute time deltas.
+ */
+const TIMESTAMP_FORMAT: Intl.DateTimeFormatOptions = {
+  weekday: 'short',
+  year: 'numeric',
+  month: 'short',
+  day: 'numeric',
+  hour: '2-digit',
+  minute: '2-digit',
+  hour12: false,
+  timeZoneName: 'short',
+};
+
+export function formatTimestamp(isoString: string): string {
+  return new Date(isoString).toLocaleString('en-US', TIMESTAMP_FORMAT);
+}
+
+export function formatCurrentTime(): string {
+  return formatTimestamp(new Date().toISOString());
+}

package/src/core/message-manager.ts

@@ -7,6 +7,7 @@ import {
   type ContextStatus,
   type LLMRequest,
 } from "./types.js";
+import { formatTimestamp } from "./format-utils.js";
 import { StateManager } from "./state-manager.js";
 import { QueueProcessor } from "./queue-processor.js";
 import {
@@ -282,9 +283,10 @@ export function fetchMessagesForLLM(
   return filteredHistory.reduce<import("./types.js").ChatMessage[]>((acc, m) => {
     const content = buildChatMessageContent(m);
     if (content.length > 0) {
+      const finalContent = persona.include_message_timestamps ? `[${formatTimestamp(m.timestamp)}] ${content}` : content;
       acc.push({
         role: m.role === "human" ? "user" : "assistant",
-        content,
+        content: finalContent,
       });
     }
     return acc;

package/src/core/types/entities.ts

@@ -123,6 +123,7 @@ export interface PersonaEntity {
   is_static: boolean;
   heartbeat_delay_ms?: number;
   context_window_hours?: number;
+  include_message_timestamps?: boolean; // Prepend ISO timestamp to each message sent to the LLM
   context_boundary?: string;  // ISO timestamp - messages before this excluded from LLM context
   last_updated: string;
   last_activity: string;

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}
@@ -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;
 
@@ -264,8 +265,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 {

package/tui/src/util/yaml-serializers.ts

@@ -57,6 +57,7 @@ interface EditablePersonaData {
   is_paused?: boolean;
   pause_until?: string;
   is_static?: boolean;
+  include_message_timestamps?: boolean;
   tools?: Record<string, Record<string, boolean>>;
 }
 
@@ -288,6 +289,7 @@ export function personaToYAML(persona: PersonaEntity, allGroups?: string[], allT
     is_paused: persona.is_paused || undefined,
     pause_until: persona.pause_until,
     is_static: persona.is_static || undefined,
+    include_message_timestamps: persona.include_message_timestamps || undefined,
     tools: toolsMap,
   };
   
@@ -391,6 +393,7 @@ export function personaFromYAML(yamlContent: string, original: PersonaEntity, al
     is_paused: data.is_paused ?? false,
     pause_until: data.pause_until,
     is_static: data.is_static ?? false,
+    include_message_timestamps: data.include_message_timestamps ?? false,
     tools: resolvePersonaToolsFromMap(data.tools, allTools ?? [], allProviders ?? []),
     last_updated: new Date().toISOString(),
   };