ei-tui 0.9.2 → 0.9.4

package/src/core/prompt-context-builder.ts

@@ -47,24 +47,48 @@ function capTopicsAndPeople<T extends { id: string }, P extends { id: string }>(
 // EMBEDDING-BASED RELEVANCE SELECTION
 // =============================================================================
 
+const RECENT_MESSAGES_FOR_CONTEXT = 5;
+
+async function buildQueryVectors(queries: string[]): Promise<number[][]> {
+  const embeddingService = getEmbeddingService();
+  return Promise.all(queries.map(q => embeddingService.embed(q)));
+}
+
+function unionTopK<T extends { id: string }>(
+  candidates: T[],
+  queryVectors: number[][],
+  limit: number
+): T[] {
+  const best = new Map<string, { item: T; similarity: number }>();
+  for (const qv of queryVectors) {
+    for (const { item, similarity } of findTopK(qv, candidates, limit)) {
+      const existing = best.get(item.id);
+      if (!existing || similarity > existing.similarity) {
+        best.set(item.id, { item, similarity });
+      }
+    }
+  }
+  return Array.from(best.values())
+    .filter(({ similarity }) => similarity >= SIMILARITY_THRESHOLD)
+    .sort((a, b) => b.similarity - a.similarity)
+    .slice(0, limit)
+    .map(({ item }) => item);
+}
+
 async function selectRelevantItems<T extends { id: string; embedding?: number[] }>(
   items: T[],
   limit: number,
-  currentMessage?: string
+  queries: string[]
 ): Promise<T[]> {
   if (items.length === 0) return [];
 
   const withEmbeddings = items.filter((i) => i.embedding?.length);
+  const activeQueries = queries.filter(Boolean);
 
-  if (currentMessage && withEmbeddings.length > 0) {
+  if (activeQueries.length > 0 && withEmbeddings.length > 0) {
     try {
-      const embeddingService = getEmbeddingService();
-      const queryVector = await embeddingService.embed(currentMessage);
-      const results = findTopK(queryVector, withEmbeddings, limit);
-      const relevant = results
-        .filter(({ similarity }) => similarity >= SIMILARITY_THRESHOLD)
-        .map(({ item }) => item);
-
+      const queryVectors = await buildQueryVectors(activeQueries);
+      const relevant = unionTopK(withEmbeddings, queryVectors, limit);
       if (relevant.length > 0) return relevant;
     } catch (err) {
       console.warn("[filterHumanDataByVisibility] Embedding search failed:", err);
@@ -80,19 +104,15 @@ async function selectRelevantItems<T extends { id: string; embedding?: number[]
     .slice(0, limit);
 }
 
-async function selectRelevantQuotes(quotes: Quote[], currentMessage?: string): Promise<Quote[]> {
+async function selectRelevantQuotes(quotes: Quote[], queries: string[]): Promise<Quote[]> {
   if (quotes.length === 0) return [];
   const withEmbeddings = quotes.filter((q) => q.embedding?.length);
+  const activeQueries = queries.filter(Boolean);
 
-  if (currentMessage && withEmbeddings.length > 0) {
+  if (activeQueries.length > 0 && withEmbeddings.length > 0) {
     try {
-      const embeddingService = getEmbeddingService();
-      const queryVector = await embeddingService.embed(currentMessage);
-      const results = findTopK(queryVector, withEmbeddings, QUOTE_LIMIT);
-      const relevant = results
-        .filter(({ similarity }) => similarity >= SIMILARITY_THRESHOLD)
-        .map(({ item }) => item);
-
+      const queryVectors = await buildQueryVectors(activeQueries);
+      const relevant = unionTopK(withEmbeddings, queryVectors, QUOTE_LIMIT);
       if (relevant.length > 0) return relevant;
     } catch (err) {
       console.warn("[filterHumanDataByVisibility] Embedding search failed:", err);
@@ -110,16 +130,16 @@ async function selectRelevantQuotes(quotes: Quote[], currentMessage?: string): P
 export async function filterHumanDataByVisibility(
   human: HumanEntity,
   persona: PersonaEntity,
-  currentMessage?: string
+  queries: string[]
 ): Promise<ResponsePromptData["human"]> {
   const DEFAULT_GROUP = "General";
 
   if (persona.id === "ei") {
     const [facts, rawTopics, rawPeople, quotes] = await Promise.all([
-      selectRelevantItems(human.facts, DATA_ITEM_LIMIT, currentMessage),
-      selectRelevantItems(human.topics, DATA_ITEM_LIMIT, currentMessage),
-      selectRelevantItems(human.people, DATA_ITEM_LIMIT, currentMessage),
-      selectRelevantQuotes(human.quotes ?? [], currentMessage),
+      selectRelevantItems(human.facts, DATA_ITEM_LIMIT, queries),
+      selectRelevantItems(human.topics, DATA_ITEM_LIMIT, queries),
+      selectRelevantItems(human.people, DATA_ITEM_LIMIT, queries),
+      selectRelevantQuotes(human.quotes ?? [], queries),
     ]);
     const { topics, people } = capTopicsAndPeople(rawTopics, rawPeople);
     const humanName =
@@ -157,10 +177,10 @@ export async function filterHumanDataByVisibility(
   });
 
   const [facts, rawTopics, rawPeople, quotes] = await Promise.all([
-    selectRelevantItems(filterByGroup(human.facts), DATA_ITEM_LIMIT, currentMessage),
-    selectRelevantItems(filterByGroup(human.topics), DATA_ITEM_LIMIT, currentMessage),
-    selectRelevantItems(filterByGroup(human.people), DATA_ITEM_LIMIT, currentMessage),
-    selectRelevantQuotes(groupFilteredQuotes, currentMessage),
+    selectRelevantItems(filterByGroup(human.facts), DATA_ITEM_LIMIT, queries),
+    selectRelevantItems(filterByGroup(human.topics), DATA_ITEM_LIMIT, queries),
+    selectRelevantItems(filterByGroup(human.people), DATA_ITEM_LIMIT, queries),
+    selectRelevantQuotes(groupFilteredQuotes, queries),
   ]);
   const { topics, people } = capTopicsAndPeople(rawTopics, rawPeople);
 
@@ -233,14 +253,25 @@ export async function buildResponsePromptData(
   tools?: import("./types.js").ToolDefinition[]
 ): Promise<ResponsePromptData> {
   const human = sm.getHuman();
-  const filteredHuman = await filterHumanDataByVisibility(human, persona, currentMessage);
-  const visiblePersonas = getVisiblePersonas(sm, persona);
   const messages = sm.messages_get(persona.id);
   const previousMessage = messages.length >= 2 ? messages[messages.length - 2] : null;
   const delayMs = previousMessage
     ? Date.now() - new Date(previousMessage.timestamp).getTime()
     : 0;
 
+  const recentMessageContents = messages
+    .slice(-RECENT_MESSAGES_FOR_CONTEXT - 1, -1)
+    .map(m => getMessageContent(m))
+    .filter(Boolean);
+
+  const queries = [
+    ...(currentMessage ? [currentMessage] : []),
+    ...recentMessageContents,
+  ];
+
+  const filteredHuman = await filterHumanDataByVisibility(human, persona, queries);
+  const visiblePersonas = getVisiblePersonas(sm, persona);
+
   const alwaysMessages = sm.messages_getAlways(persona.id);
   const temporalAnchors = alwaysMessages.map(m => ({
     role: m.role === "human" ? "human" as const : "system" as const,
@@ -260,6 +291,7 @@ export async function buildResponsePromptData(
       topics: persona.topics,
       interested_topics: persona.topics.filter(t => t.exposure_desired - t.exposure_current > 0.2),
       include_message_timestamps: persona.include_message_timestamps,
+      pending_update: persona.pending_update,
     },
     human: filteredHuman,
     visible_personas: visiblePersonas,
@@ -287,10 +319,10 @@ export async function buildRoomResponsePromptData(
 
   let sourceMessages: RoomMessage[];
   if (room.mode === RoomMode.FreeForAll) {
-    const contextWindowHours = room.context_window_hours
-      ?? human.settings?.default_context_window_hours
-      ?? 8;
-    const windowCutoff = new Date(Date.now() - contextWindowHours * 60 * 60 * 1000).toISOString();
+    const contextWindowMs = room.context_window_ms
+      ?? human.settings?.default_context_window_ms
+      ?? 28800000;
+    const windowCutoff = new Date(Date.now() - contextWindowMs).toISOString();
     const boundaryMs = room.context_boundary ? new Date(room.context_boundary).getTime() : 0;
     sourceMessages = allSourceMessages.filter(m => {
       const msgMs = new Date(m.timestamp).getTime();
@@ -303,8 +335,8 @@ export async function buildRoomResponsePromptData(
     const byCount = allSourceMessages.slice(-MIN_ROOM_MESSAGES);
     if (byCount.length > sourceMessages.length) sourceMessages = byCount;
   } else {
-    const contextWindowHours = human.settings?.default_context_window_hours ?? 8;
-    const windowCutoff = new Date(Date.now() - contextWindowHours * 60 * 60 * 1000).toISOString();
+    const contextWindowMs = human.settings?.default_context_window_ms ?? 28800000;
+    const windowCutoff = new Date(Date.now() - contextWindowMs).toISOString();
     const byTime = allSourceMessages.filter(m => m.timestamp >= windowCutoff);
     const byCount = allSourceMessages.slice(-MIN_ROOM_MESSAGES);
     sourceMessages = byTime.length >= byCount.length ? byTime : byCount;
@@ -313,7 +345,7 @@ export async function buildRoomResponsePromptData(
   const lastMessage = sourceMessages[sourceMessages.length - 1];
   const currentMessage = lastMessage ? getMessageContent(lastMessage) : undefined;
 
-  const filteredHuman = await filterHumanDataByVisibility(human, respondingPersona, currentMessage);
+  const filteredHuman = await filterHumanDataByVisibility(human, respondingPersona, currentMessage ? [currentMessage] : []);
 
   const history = normalizeRoomMessages(sourceMessages, sm);
 

package/src/core/state/personas.ts

@@ -1,21 +1,5 @@
 import type { PersonaEntity, Message, ContextStatus } from "../types.js";
 
-// TODO(v1.0.0): Remove LegacyMessage migration — verbal_response/action_response no longer written
-type LegacyMessage = Message & { verbal_response?: string; action_response?: string };
-
-function migrateMessage(msg: Message): Message {
-  if (msg.content) return msg;
-  if (msg.silence_reason) return msg;
-  const legacy = msg as LegacyMessage;
-  const hasLegacy = 'verbal_response' in legacy || 'action_response' in legacy;
-  if (!hasLegacy) return msg;
-  const parts: string[] = [];
-  if (legacy.action_response) parts.push(`_${legacy.action_response}_`);
-  if (legacy.verbal_response) parts.push(legacy.verbal_response);
-  const { verbal_response: _vr, action_response: _ar, ...rest } = legacy;
-  return parts.length > 0 ? { ...rest, content: parts.join('\n\n') } : rest as Message;
-}
-
 export interface PersonaData {
   entity: PersonaEntity;
   messages: Message[];
@@ -29,7 +13,7 @@ export class PersonaState {
     this.personas = new Map(
       Object.entries(personas).map(([id, data]) => [
         id,
-        { entity: data.entity, messages: data.messages.map(migrateMessage) },
+        { entity: data.entity, messages: data.messages },
       ])
     );
   }

package/src/core/state-manager.ts

@@ -69,76 +69,10 @@ export class StateManager {
     this.migrateMessageFlags();
     this.migrateInterestedPersonas();
     this.migrateProviderModel();
-    this.migratePersonaMessageContent();
-    this.migrateRoomMessageContent();
     this.migrateThemes();
     this.migrateFfaParentIds();
   }
 
-  private migratePersonaMessageContent(): void {
-    // TODO(v1.0.0): Remove legacy persona message migration — verbal_response/action_response no longer written
-    const rawPersonas = (this.personaState as unknown as { personas: Map<string, { messages: Message[] }> }).personas;
-    let migratedCount = 0;
-    for (const [, data] of rawPersonas) {
-      const messages = data.messages;
-      for (const msg of messages) {
-        const legacy = msg as Message & { verbal_response?: string; action_response?: string };
-        if (!('verbal_response' in legacy || 'action_response' in legacy)) continue;
-        if (msg.content) {
-          delete (legacy as any).verbal_response;
-          delete (legacy as any).action_response;
-          migratedCount++;
-          continue;
-        }
-        if (msg.silence_reason) {
-          delete (legacy as any).verbal_response;
-          delete (legacy as any).action_response;
-          migratedCount++;
-          continue;
-        }
-        const parts: string[] = [];
-        if (legacy.action_response) parts.push(`_${legacy.action_response}_`);
-        if (legacy.verbal_response) parts.push(legacy.verbal_response);
-        if (parts.length > 0) (msg as any).content = parts.join('\n\n');
-        delete (legacy as any).verbal_response;
-        delete (legacy as any).action_response;
-        migratedCount++;
-      }
-    }
-    if (migratedCount > 0) {
-      this.scheduleSave();
-      console.log(`[StateManager] Migrated ${migratedCount} persona messages to unified content field`);
-    }
-  }
-
-  private migrateRoomMessageContent(): void {
-    const rooms = this.roomState.getAll(true);
-    let migratedCount = 0;
-
-    for (const room of rooms) {
-      for (const msg of room.messages) {
-        if (msg.content) continue;
-        if (msg.silence_reason) continue;
-        // TODO(v1.0.0): Remove legacy room message migration — verbal_response/action_response no longer written
-        const legacy = msg as RoomMessage & { verbal_response?: string; action_response?: string };
-        const hasLegacy = 'verbal_response' in legacy || 'action_response' in legacy;
-        if (!hasLegacy) continue;
-        const parts: string[] = [];
-        if (legacy.action_response) parts.push(`_${legacy.action_response}_`);
-        if (legacy.verbal_response) parts.push(legacy.verbal_response);
-        if (parts.length > 0) msg.content = parts.join('\n\n');
-        delete (msg as any).verbal_response;
-        delete (msg as any).action_response;
-        migratedCount++;
-      }
-    }
-
-    if (migratedCount > 0) {
-      this.scheduleSave();
-      console.log(`[StateManager] Migrated ${migratedCount} room messages to unified content field`);
-    }
-  }
-
   /**
    * Migration: learned_by used to store display names; now stores persona IDs.
    * On load, attempt to resolve display names -> IDs using current persona map.

package/src/core/types/entities.ts

@@ -103,12 +103,11 @@ export interface HumanSettings {
   default_model?: string;           // Will store ModelConfig.id GUID post-migration
   oneshot_model?: string;           // Model for AI-assist (wand) requests; falls back to default_model. Will store ModelConfig.id GUID post-migration.
   rewrite_model?: string;           // Model for rewrite ceremony step; must be capable (Sonnet/Opus class). Unset = rewrite disabled. Will store ModelConfig.id GUID post-migration.
-  people_migration_complete?: boolean; // Set to true when all Person records have identifiers. Ceremony migration step short-circuits when true.
   queue_paused?: boolean;
   skip_quote_delete_confirm?: boolean;
   name_display?: string;
   default_heartbeat_ms?: number;
-  default_context_window_hours?: number;
+  default_context_window_ms?: number;
   message_min_count?: number;
   message_max_age_days?: number;
   accounts?: ProviderAccount[];
@@ -150,7 +149,7 @@ export interface PersonaEntity {
   archived_at?: string;
   is_static: boolean;
   heartbeat_delay_ms?: number;
-  context_window_hours?: number;
+  context_window_ms?: 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;

package/src/core/types/enums.ts

@@ -26,7 +26,6 @@ export enum LLMPriority {
 export enum LLMNextStep {
   HandlePersonaResponse = "handlePersonaResponse",
   HandlePersonaGeneration = "handlePersonaGeneration",
-  HandlePersonaDescriptions = "handlePersonaDescriptions",
   HandleFactFind = "handleFactFind",
   HandleHumanTopicScan = "handleHumanTopicScan",
   HandleHumanPersonScan = "handleHumanPersonScan",
@@ -51,7 +50,6 @@ export enum LLMNextStep {
   HandleRoomResponse = "handleRoomResponse",
   HandleRoomJudge = "handleRoomJudge",
   HandlePersonaPreview = "handlePersonaPreview",
-  HandlePersonIdentifierMigration = "handlePersonIdentifierMigration",
   HandleTopicValidate = "handleTopicValidate",
   HandleReflectionCritic = "handleReflectionCritic",
 }

package/src/core/types/rooms.ts

@@ -35,7 +35,7 @@ export interface RoomEntity {
   created_at: string;
   last_updated: string;
   capture_used?: boolean;
-  context_window_hours?: number;  // FFA only; falls back to human.settings.default_context_window_hours
+  context_window_ms?: number;  // FFA only; falls back to human.settings.default_context_window_ms
   context_boundary?: string;      // FFA only; ISO timestamp; same semantics as persona context_boundary
   messages: RoomMessage[];
 }

package/src/integrations/claude-code/importer.ts

@@ -262,7 +262,7 @@ export async function importClaudeCodeSessions(
 
     const context: ExtractionContext = {
       personaId: persona.id,
-      personaDisplayName: persona.display_name,
+      channelDisplayName: persona.display_name,
       messages_context: contextMsgs,
       messages_analyze: toAnalyze,
       sources: [`claudecode:${getMachineId()}:${targetSession.id}`],

package/src/integrations/cursor/importer.ts

@@ -221,7 +221,7 @@ export async function importCursorSessions(
 
     const context: ExtractionContext = {
       personaId: persona.id,
-      personaDisplayName: persona.display_name,
+      channelDisplayName: persona.display_name,
       messages_context: contextMsgs,
       messages_analyze: toAnalyze,
       sources: [`cursor:${getMachineId()}:${targetSession.id}`],

package/src/integrations/opencode/importer.ts

@@ -245,7 +245,7 @@ export async function importOpenCodeSessions(
 
       const context: ExtractionContext = {
         personaId: persona.id,
-        personaDisplayName: persona.display_name,
+        channelDisplayName: persona.display_name,
         messages_context: contextMsgs,
         messages_analyze: toAnalyze,
         sources: [`opencode:${getMachineId()}:${targetSession.id}`],

package/src/prompts/ceremony/index.ts

@@ -1,17 +1,7 @@
-export { buildPersonaExpirePrompt } from "./expire.js";
-export { buildPersonaExplorePrompt } from "./explore.js";
-export { buildDescriptionCheckPrompt } from "./description-check.js";
 export { buildRewriteScanPrompt, buildRewritePrompt } from "./rewrite.js";
 export { buildDedupPrompt, buildValidatePrompt } from "./dedup.js";
 export { buildUserDedupPrompt } from "./user-dedup.js";
-export { buildPersonMigrationPrompt, type PersonMigrationPromptData } from "./person-migration.js";
 export type {
-  PersonaExpirePromptData,
-  PersonaExpireResult,
-  PersonaExplorePromptData,
-  PersonaExploreResult,
-  DescriptionCheckPromptData,
-  DescriptionCheckResult,
   RewriteItemType,
   RewriteScanPromptData,
   RewriteScanResult,

package/src/prompts/ceremony/types.ts

@@ -1,45 +1,4 @@
-import type { PersonaTrait, PersonaTopic, DataItemBase } from "../../core/types.js";
-
-export interface PersonaExpirePromptData {
-  persona_name: string;
-  topics: PersonaTopic[];
-}
-
-export interface PersonaExpireResult {
-  topic_ids_to_remove: string[];
-}
-
-export interface PersonaExplorePromptData {
-  persona_name: string;
-  traits: PersonaTrait[];
-  remaining_topics: PersonaTopic[];
-  recent_conversation_themes: string[];
-}
-
-export interface PersonaExploreResult {
-  new_topics: Array<{
-    name: string;
-    perspective: string;
-    approach: string;
-    personal_stake: string;
-    sentiment: number;
-    exposure_current: number;
-    exposure_desired: number;
-  }>;
-}
-
-export interface DescriptionCheckPromptData {
-  persona_name: string;
-  current_short_description?: string;
-  current_long_description?: string;
-  traits: PersonaTrait[];
-  topics: PersonaTopic[];
-}
-
-export interface DescriptionCheckResult {
-  should_update: boolean;
-  reason?: string;
-}
+import type { DataItemBase } from "../../core/types.js";
 
 // =============================================================================
 // REWRITE (Item Reorganization)

package/src/prompts/generation/index.ts

@@ -1,5 +1,4 @@
 export { buildPersonaGenerationPrompt } from "./persona.js";
-export { buildPersonaDescriptionsPrompt } from "./descriptions.js";
 export { buildPersonaFromPersonPrompt } from "./from-person.js";
 export {
   DEFAULT_SEED_TRAITS,
@@ -11,7 +10,5 @@ export type {
   PersonaGenerationPromptData,
   PersonaGenerationResult,
   PersonaFromPersonPromptData,
-  PersonaDescriptionsPromptData,
-  PersonaDescriptionsResult,
   PromptOutput,
 } from "./types.js";

package/src/prompts/generation/types.ts

@@ -1,5 +1,3 @@
-import type { PersonaTrait, PersonaTopic } from "../../core/types.js";
-
 export interface PromptOutput {
   system: string;
   user: string;
@@ -45,16 +43,3 @@ export interface PersonaFromPersonPromptData {
   existing_trait_names?: string[];
   existing_topic_names?: string[];
 }
-
-export interface PersonaDescriptionsPromptData {
-  name: string;
-  aliases: string[];
-  traits: PersonaTrait[];
-  topics: PersonaTopic[];
-}
-
-export interface PersonaDescriptionsResult {
-  short_description: string;
-  long_description: string;
-  no_change?: boolean;
-}

package/src/prompts/heartbeat/check.ts

@@ -74,7 +74,6 @@ function getLastPersonaMessage(history: Message[]): Message | undefined {
  * - Getting recent message history
  */
 export function buildHeartbeatCheckPrompt(data: HeartbeatCheckPromptData): PromptOutput {
-  console.log(`[HeartbeatCheck ${data.persona.name}] Building prompt - topics: ${data.human.topics.length}, people: ${data.human.people.length}, inactive_days: ${data.inactive_days}, history: ${data.recent_history.length} messages`);
   if (!data.persona?.name) {
     throw new Error("buildHeartbeatCheckPrompt: persona.name is required");
   }
@@ -124,11 +123,24 @@ ${formatPeopleWithGaps(data.human.people)}`;
 
 **Quality over quantity** - Only reach out if you have something real to say.`;
 
-  const pendingUpdateFragment = data.persona.has_pending_update
-    ? `## Pending Identity Changes
-
-Based on recent conversations, there are proposed updates to your identity waiting for review. The user has been notified and can review them. You may bring this up if it feels right — or not. It's yours to decide.`
-    : '';
+  const pendingUpdateFragment = data.persona.pending_update ? (() => {
+    const p = data.persona.pending_update!;
+    const descPart = p.long_description || p.short_description
+      ? `### Proposed Description\n${p.long_description || p.short_description}`
+      : "";
+    const traitsPart = p.traits.length > 0
+      ? `### Proposed Traits\n${p.traits.map(t => `- **${t.name}**: ${t.description}`).join("\n")}`
+      : "";
+    const topicsPart = p.topics.length > 0
+      ? `### Proposed Interests\n${p.topics.map(t => `- **${t.name}**: ${t.perspective}`).join("\n")}`
+      : "";
+    const parts = [descPart, traitsPart, topicsPart].filter(Boolean).join("\n\n");
+    return `## Pending Identity Changes
+
+Your human is reviewing proposed updates to your identity. These are waiting for their response — you may want to bring it up, or not. It's yours to decide.
+
+${parts}`;
+  })() : '';
 
   const outputFragment = `## Response Format
 

package/src/prompts/heartbeat/types.ts

@@ -4,6 +4,7 @@
  */
 
 import type { PersonaTrait, Topic, Person, Message, PersonaTopic } from "../../core/types.js";
+import type { PersonaEntity } from "../../core/types/entities.js";
 
 /**
  * Common prompt output structure
@@ -21,7 +22,7 @@ export interface HeartbeatCheckPromptData {
     name: string;
     traits: PersonaTrait[];
     topics: PersonaTopic[];
-    has_pending_update: boolean;
+    pending_update?: PersonaEntity["pending_update"];
   };
   human: {
     topics: Topic[];     // Filtered, sorted by engagement gap

package/src/prompts/human/index.ts

@@ -1,4 +1,3 @@
-export { buildHumanFactScanPrompt } from "./fact-scan.js";
 export { buildFactFindPrompt } from "./fact-find.js";
 export { buildHumanTopicScanPrompt } from "./topic-scan.js";
 export { buildHumanPersonScanPrompt } from "./person-scan.js";
@@ -16,7 +15,6 @@ export type {
   PromptOutput,
   ParticipantContext,
   PersonaEntitySnapshot,
-  FactScanPromptData,
   TopicScanPromptData,
   PersonScanPromptData,
   FactFindPromptData,

package/src/prompts/human/person-update.ts

@@ -1,4 +1,4 @@
-import type { PromptOutput, ParticipantContext, PersonaEntitySnapshot } from "./types.js";
+import type { PromptOutput, ParticipantContext } from "./types.js";
 import type { Person, Message } from "../../core/types.js";
 import { formatMessagesAsPlaceholders } from "../message-utils.js";
 
@@ -12,7 +12,6 @@ export interface PersonUpdatePromptData {
   persona_name: string;
   participant_context?: ParticipantContext;
   known_identifier_types?: string[];
-  persona_entity?: PersonaEntitySnapshot;
 }
 
 function participantContextSection(ctx: ParticipantContext | undefined): string {
@@ -121,38 +120,22 @@ Detail you add should:
 **ABSOLUTELY VITAL**: Do **NOT** embellish. Record only what the user actually said or demonstrated.`;
 
   } else if (isEiPersona) {
-    const entityRef = data.persona_entity
-      ? `## This Persona's Defined Identity (for reference)
-
-The following is ${personName}'s current self-definition — their traits, topics, and long description as set in the Persona editor. Use this as a **baseline**, not a ceiling.
-
-**Long description:**
-${data.persona_entity.long_description}
-
-**Traits:**
-${data.persona_entity.traits.map(t => `- **${t.name}**: ${t.description}`).join('\n')}
-
-**Topics:**
-${data.persona_entity.topics.map(t => `- **${t.name}**: ${t.perspective}`).join('\n')}
-
-`
-      : '';
-
-    descriptionSection = `${entityRef}This record is the HUMAN USER's **observed experience** of ${personName} over time — not the Persona's own definition. Think of it as field notes from someone who has been talking with this Persona across many conversations.
+    descriptionSection = `This record is the HUMAN USER's **observed experience** of ${personName} over time. Think of it as field notes from someone who has been talking with this Persona across many conversations.
 
 ## Your job: add, never truncate
 
 The description is allowed to grow. **Never remove or summarize away existing content.**
 
 Add anything from the Most Recent Messages that:
-- Extends or nuances what's already known (new behaviors, new opinions, recurring themes)
-- Agrees with or contradicts the Persona's defined identity — both are worth capturing
-- Reveals how the HUMAN USER experiences or relates to this Persona specifically
+- Records a specific thing ${personName} said, did, or demonstrated in this conversation
+- Captures how the HUMAN USER experienced or related to ${personName} in this specific exchange
+- Notes behavior that stands out — expected or surprising — based on what the existing log already shows
 
 **Do NOT:**
 - Synthesize the existing description down to fewer sentences
 - Replace specific observations with vague summaries
 - Discard detail to "keep it brief" — brevity is wrong here
+- Add anything that isn't directly observed in the Most Recent Messages
 
 If the new messages add nothing meaningful, return \`{}\`. Otherwise, return the **full updated description** — existing content preserved, new observations woven in.`;
 

package/src/prompts/human/types.ts

@@ -25,10 +25,6 @@ interface BaseScanPromptData {
   persona_name: string;
 }
 
-export interface FactScanPromptData extends BaseScanPromptData {}
-
-export interface TraitScanPromptData extends BaseScanPromptData {}
-
 export interface TopicScanPromptData extends BaseScanPromptData {
   participant_context?: ParticipantContext;
 }
@@ -78,18 +74,6 @@ export interface TopicMatchPromptData {
   }>;
 }
 
-export interface PersonMatchPromptData {
-  candidate_name: string;
-  candidate_description: string;
-  candidate_relationship: string;
-  existing_people: Array<{
-    id: string;
-    name: string;
-    description: string;
-    relationship?: string;
-  }>;
-}
-
 export interface FactScanResult {
   facts: FactScanCandidate[];
 }