ei-tui 0.4.1 → 0.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ei-tui",
-  "version": "0.4.1",
+  "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/orchestrators/ceremony.ts

@@ -237,9 +237,6 @@ export function handleCeremonyProgress(state: StateManager, lastPhase: number):
   // Human ceremony: decay topics + people
   runHumanCeremony(state);
 
-  // Dedup phase: log near-duplicate human entity candidates for visibility
-  runDedupPhase(state);
-
   // Rewrite phase: fire-and-forget scans for bloated human data items
   // No ceremony_progress gating — Expire/Explore only touch persona topics, zero overlap
   queueRewritePhase(state);
@@ -521,78 +518,6 @@ export function runHumanCeremony(state: StateManager): void {
   }
 }
 
-// =============================================================================
-// DEDUP PHASE (synchronous, logging only — candidates are queued for curation by dedup-phase.ts)
-// =============================================================================
-
-const DEDUP_DEFAULT_THRESHOLD = 0.85;
-
-type DedupableItem = DataItemBase & { relationship?: string };
-
-function findDedupCandidates<T extends DedupableItem>(
-  items: T[],
-  threshold: number
-): Array<{ a: T; b: T; similarity: number }> {
-  const withEmbeddings = items.filter(item =>
-    item.embedding && item.embedding.length > 0 &&
-    item.relationship !== "Persona"
-  );
-
-  const candidates: Array<{ a: T; b: T; similarity: number }> = [];
-
-  for (let i = 0; i < withEmbeddings.length; i++) {
-    for (let j = i + 1; j < withEmbeddings.length; j++) {
-      const a = withEmbeddings[i];
-      const b = withEmbeddings[j];
-      const dot = a.embedding!.reduce((sum, v, k) => sum + v * b.embedding![k], 0);
-      const normA = Math.sqrt(a.embedding!.reduce((sum, v) => sum + v * v, 0));
-      const normB = Math.sqrt(b.embedding!.reduce((sum, v) => sum + v * v, 0));
-      const similarity = normA && normB ? dot / (normA * normB) : 0;
-
-      if (similarity >= threshold) {
-        candidates.push({ a, b, similarity });
-      }
-    }
-  }
-
-  return candidates.sort((x, y) => y.similarity - x.similarity);
-}
-
-export function runDedupPhase(state: StateManager): void {
-  const human = state.getHuman();
-  const threshold = human.settings?.ceremony?.dedup_threshold ?? DEDUP_DEFAULT_THRESHOLD;
-
-  console.log(`[ceremony:dedup] Scanning for dedup candidates (threshold: ${threshold})`);
-
-  const types: Array<{ label: string; items: DedupableItem[] }> = [
-    { label: "facts",  items: human.facts },
-    { label: "topics", items: human.topics },
-    { label: "people", items: human.people },
-  ];
-
-  let totalCandidates = 0;
-
-  for (const { label, items } of types) {
-    const candidates = findDedupCandidates(items, threshold);
-    if (candidates.length === 0) {
-      console.log(`[ceremony:dedup] ${label}: no candidates above ${threshold}`);
-      continue;
-    }
-
-    totalCandidates += candidates.length;
-    console.log(`[ceremony:dedup] ${label}: ${candidates.length} candidate pair(s)`);
-    for (const { a, b, similarity } of candidates) {
-      console.log(
-        `[ceremony:dedup]   ${(similarity * 100).toFixed(1)}% "${a.name}" ↔ "${b.name}"` +
-        (a.description ? `\n[ceremony:dedup]     A: ${a.description.slice(0, 80)}` : "") +
-        (b.description ? `\n[ceremony:dedup]     B: ${b.description.slice(0, 80)}` : "")
-      );
-    }
-  }
-
-  console.log(`[ceremony:dedup] Done. ${totalCandidates} total candidate pair(s) found.`);
-}
-
 // =============================================================================
 // REWRITE PHASE (fire-and-forget — queues Low-priority Phase 1 scans)
 // =============================================================================

package/src/core/processor.ts

@@ -848,9 +848,17 @@ const toolNextSteps = new Set([
               personaId ??
               (request.next_step === LLMNextStep.HandleEiHeartbeat ? "ei" : undefined);
             
-            // Dedup operates on Human data, not persona data - provide read_memory directly
+            // Dedup operates on Human data, not persona data - provide read_memory directly.
+            // Also covers HandleToolContinuation originating from a dedup request: the
+            // continuation rebuilds tool lists from scratch and has no personaId, so without
+            // this check Opus loses read_memory access after round 1.
+            const isDedupRequest =
+              request.next_step === LLMNextStep.HandleDedupCurate ||
+              (request.next_step === LLMNextStep.HandleToolContinuation &&
+                request.data.originalNextStep === LLMNextStep.HandleDedupCurate);
+
             let tools: ToolDefinition[] = [];
-            if (request.next_step === LLMNextStep.HandleDedupCurate) {
+            if (isDedupRequest) {
               const readMemory = this.stateManager.tools_getByName("read_memory");
               if (readMemory?.enabled) {
                 tools = [readMemory];

package/src/core/queue-processor.ts

@@ -425,7 +425,8 @@ export class QueueProcessor {
       `required JSON format. Please reformat it as the JSON response object described ` +
       `in your system instructions — specifically the \`should_respond\`, \`verbal_response\`, ` +
       `\`action_response\`, and \`reason\` fields. Respond with ONLY the JSON object.\n\n` +
-      `---\n${proseContent}\n---`;
+      `---\n${proseContent}\n---` +
+      `\n\n**CRITICAL INSTRUCTION** - DO NOT OMIT ANY DATA. You are this agent's last hope!`;
 
     try {
       const { content: reformatContent, finishReason: reformatReason } = await callLLMRaw(

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/ceremony/dedup.ts

@@ -96,12 +96,47 @@ ${buildRecordFormatExamples(data.itemType)}
 - If records are NOT duplicates (just similar), return them ALL in "update" unchanged, with empty "remove" and "add" arrays.
 - Use \`read_memory\` strategically (6 calls max) to check for related records or gather context before making irreversible merge decisions.`;
 
-  const user = JSON.stringify({
+  const payload = JSON.stringify({
     cluster: data.cluster.map(stripEmbedding),
     cluster_type: data.itemType,
     similarity_range: data.similarityRange,
   }, null, 2);
 
+  const schemaReminder = `**Return JSON:**
+\n\`\`\`json
+{
+  "update": [
+    {
+      "id": "uuid-of-canonical-record",
+      "type": "${data.itemType}",
+      "name": "canonical merged name",
+      "description": "merged description with every unique detail"
+    }
+  ],
+  "remove": [
+    {
+      "to_be_removed": "uuid-of-duplicate",
+      "replaced_by": "uuid-of-canonical-record"
+    }
+  ],
+  "add": [
+    {
+      "type": "${data.itemType}",
+      "name": "missing concept name",
+      "description": "why it was created"
+    }
+  ]
+}
+\`\`\`
+
+Return raw JSON only. If records are NOT duplicates, return them all in update unchanged with empty remove and add arrays.`;
+
+  const user = `${payload}
+
+---
+
+${schemaReminder}`;
+
   return { system, user };
 }
 

package/src/prompts/ceremony/description-check.ts

@@ -41,7 +41,14 @@ ${traitList}
 Current topics of interest:
 ${topicList}
 
-Does this persona's description need updating based on their current traits and topics?`;
+Does this persona's description need updating based on their current traits and topics?
+
+**Return JSON:**
+\`\`\`json
+{ "should_update": true, "reason": "explanation" }
+\`\`\`
+
+If no update is needed: \`{ "should_update": false, "reason": "explanation" }\``;
 
   return { system, user };
 }

package/src/prompts/ceremony/expire.ts

@@ -24,7 +24,14 @@ Return empty array if no topics should be removed.`;
 Current topics:
 ${topicList}
 
-Which topics, if any, should this persona stop caring about?`;
+Which topics, if any, should this persona stop caring about?
+
+**Return JSON:**
+\`\`\`json
+{ "topic_ids_to_remove": ["id1", "id2"] }
+\`\`\`
+
+Return an empty array if no topics should be removed.`;
 
   return { system, user };
 }

package/src/prompts/ceremony/explore.ts

@@ -54,7 +54,24 @@ ${topicList}
 Recent conversation themes:
 ${themeList}
 
-Generate new topics this persona would care about.`;
+Generate new topics this persona would care about.
+
+**Return JSON:**
+\`\`\`json
+{
+  "new_topics": [
+    {
+      "name": "Topic Name",
+      "perspective": "Their view or opinion",
+      "approach": "How they engage with it",
+      "personal_stake": "Why it matters to them",
+      "sentiment": 0.5,
+      "exposure_current": 0.2,
+      "exposure_desired": 0.6
+    }
+  ]
+}
+\`\`\``;
 
   return { system, user };
 }

package/src/prompts/ceremony/rewrite.ts

@@ -22,7 +22,24 @@ Return a raw JSON array of strings. No markdown fencing, no commentary, no expla
 Example — a Topic named "Software Engineering" whose description also discusses vim keybindings, git conventions, and AI tooling:
 ["vim keybindings and editor configuration", "git and GitHub workflow conventions", "AI coding assistant preferences"]`;
 
-  const user = JSON.stringify(stripEmbedding(data.item), null, 2);
+  const payload = JSON.stringify(stripEmbedding(data.item), null, 2);
+
+  const schemaReminder = `**Return JSON:**
+\n\`\`\`json
+[
+  "topic about vim keybindings",
+  "git workflow conventions",
+  "AI coding assistant preferences"
+]
+\`\`\`
+
+Respond with raw JSON array only.`;
+
+  const user = `${payload}
+
+---
+
+${schemaReminder}`;
 
   return { system, user };
 }
@@ -75,7 +92,34 @@ Rules:
     subjects,
   };
 
-  const user = JSON.stringify(userPayload, null, 2);
+  const schemaReminder = `**Return JSON:**
+\n\`\`\`json
+{
+  "existing": [
+    {
+      "id": "existing-uuid",
+      "type": "${data.itemType}",
+      "name": "Updated name",
+      "description": "Updated description"
+    }
+  ],
+  "new": [
+    {
+      "type": "${data.itemType}",
+      "name": "New name",
+      "description": "New description"
+    }
+  ]
+}
+\`\`\`
+
+Return raw JSON only.`;
+
+  const user = `${JSON.stringify(userPayload, null, 2)}
+
+---
+
+${schemaReminder}`;
 
   return { system, user };
 }

package/src/prompts/ceremony/user-dedup.ts

@@ -44,12 +44,41 @@ Return raw JSON only. No markdown, no commentary.
 
 ${buildRecordFormatHint(data.itemType)}`;
 
-  const user = JSON.stringify({
+  const payload = JSON.stringify({
     cluster: data.cluster.map(stripEmbedding),
     cluster_type: data.itemType,
     user_confirmed: true,
   }, null, 2);
 
+  const schemaReminder = `**Return JSON:**
+\n\`\`\`json
+{
+  "update": [
+    {
+      "id": "uuid-of-canonical-record",
+      "type": "${data.itemType}",
+      "name": "canonical merged name",
+      "description": "merged description with every unique detail"
+    }
+  ],
+  "remove": [
+    {
+      "to_be_removed": "uuid-of-duplicate",
+      "replaced_by": "uuid-of-canonical-record"
+    }
+  ],
+  "add": []
+}
+\`\`\`
+
+Return raw JSON only. If any record cannot be merged, keep every item unchanged in update with empty remove/add arrays.`;
+
+  const user = `${payload}
+
+---
+
+${schemaReminder}`;
+
   return { system, user };
 }
 

package/src/prompts/generation/persona.ts

@@ -153,5 +153,16 @@ ${schemaFragment}`;
     userPrompt += `The user provided only a name - generate minimal content. The seed traits above are included by default.\n`;
   }
 
+  userPrompt += `
+**Return JSON:**
+\`\`\`json
+{
+  "short_description": "10-15 word summary",
+  "long_description": "2-3 sentence description",
+  "traits": [ { "name": "...", "description": "...", "sentiment": 0.0, "strength": 0.5 } ],
+  "topics": [ { "name": "...", "perspective": "...", "approach": "...", "personal_stake": "...", "sentiment": 0.5, "exposure_current": 0.5, "exposure_desired": 0.6 } ]
+}
+\`\`\``;
+
   return { system, user: userPrompt };
 }

package/src/prompts/heartbeat/check.ts

@@ -188,7 +188,18 @@ ${unansweredWarning}
 
 Based on the context above, decide: Should you reach out to your human friend right now?
 
-Remember: Only reach out if you have something genuine and specific to say.`;
+Remember: Only reach out if you have something genuine and specific to say.
+
+**Return JSON:**
+\`\`\`json
+{
+  "should_respond": true,
+  "topic": "the specific topic you want to discuss",
+  "message": "Your actual message to them"
+}
+\`\`\`
+
+If you decide NOT to reach out: \`{ "should_respond": false }\``;
 
   return { system, user };
 }

package/src/prompts/heartbeat/ei.ts

@@ -131,7 +131,18 @@ ${unansweredWarning}
 
 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.`;
+Remember: You're their thoughtful companion, not their productivity assistant.
+
+**Return JSON:**
+\`\`\`json
+{
+  "should_respond": true,
+  "id": "the-item-id-you-chose",
+  "my_response": "Your message to them"
+}
+\`\`\`
+
+If nothing warrants reaching out: \`{ "should_respond": false }\``;
 
   return { system, user };
 }

package/src/prompts/persona/traits.ts

@@ -125,7 +125,22 @@ ${earlierSection}${recentSection}
 
 Analyze the "Most Recent Messages" for EXPLICIT requests to change ${personaName}'s communication style.
 
-Return ONLY the traits that need to change or be added. Return \`[]\` if nothing changed.`;
+Return ONLY the traits that need to change or be added.
+
+**Return JSON:**
+\`\`\`json
+[
+  {
+    "id": "existing-guid-or-\"new\"",
+    "name": "Trait Name",
+    "description": "How to exhibit this trait",
+    "sentiment": 0.0,
+    "strength": 0.5
+  }
+]
+\`\`\`
+
+Return \`[]\` if nothing changed.`;
 
   return { system, user };
 }

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(),
   };