ei-tui 1.4.0 → 1.4.1

package/package.json

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

package/src/core/heartbeat-manager.ts

@@ -2,6 +2,7 @@ import {
   LLMRequestType,
   LLMPriority,
   LLMNextStep,
+  ContextStatus,
   type HumanEntity,
   type Message,
 } from "./types.js";
@@ -13,6 +14,7 @@ import {
   type HeartbeatCheckPromptData,
   type EiHeartbeatPromptData,
   type EiHeartbeatItem,
+  type TemporalAnchor,
 } from "../prompts/index.js";
 import { filterMessagesForContext } from "./context-utils.js";
 import { filterHumanDataByVisibility } from "./prompt-context-builder.js";
@@ -35,6 +37,43 @@ export function getOneshotModel(sm: StateManager): string | undefined {
   return human.settings?.oneshot_model || human.settings?.default_model;
 }
 
+// =============================================================================
+// TEMPORAL ANCHOR HELPERS
+// =============================================================================
+
+function buildTemporalAnchorsFromHistory(
+  history: Message[],
+  contextWindowMs: number,
+  contextBoundary: string | undefined
+): { temporalAnchors: TemporalAnchor[]; prunedHistory: Message[] } {
+  const windowStartMs = Date.now() - contextWindowMs;
+  const contextBoundaryMs = contextBoundary ? new Date(contextBoundary).getTime() : 0;
+
+  const temporalAnchors: TemporalAnchor[] = [];
+  const prunedHistory: Message[] = [];
+
+  for (const m of history) {
+    if (
+      m.context_status === ContextStatus.Always &&
+      (new Date(m.timestamp).getTime() < windowStartMs ||
+        (contextBoundaryMs > 0 && new Date(m.timestamp).getTime() < contextBoundaryMs))
+    ) {
+      temporalAnchors.push({
+        id: m.id,
+        role: m.role === "human" ? "human" : "system",
+        content: m.content,
+        silence_reason: m.silence_reason,
+        timestamp: m.timestamp,
+        _synthesis: m._synthesis,
+      });
+    } else {
+      prunedHistory.push(m);
+    }
+  }
+
+  return { temporalAnchors, prunedHistory };
+}
+
 // =============================================================================
 // TRAILING MESSAGE COUNT (heartbeat spam prevention)
 // =============================================================================
@@ -59,7 +98,9 @@ export async function queueEiHeartbeat(
   sm: StateManager,
   human: HumanEntity,
   history: Message[],
-  isTUI: boolean
+  isTUI: boolean,
+  contextWindowMs: number,
+  contextBoundary: string | undefined
 ): Promise<void> {
   const now = Date.now();
   const engagementGapThreshold = 0.2;
@@ -195,11 +236,17 @@ export async function queueEiHeartbeat(
     return;
   }
 
-  const recentHistory = history.slice(-10);
+  const { temporalAnchors, prunedHistory } = buildTemporalAnchorsFromHistory(
+    history,
+    contextWindowMs,
+    contextBoundary
+  );
+  const recentHistory = prunedHistory.slice(-10);
   const promptData: EiHeartbeatPromptData = {
     items,
     recent_history: recentHistory,
     system_messages: recentHistory.filter(m => m.role === "system"),
+    temporal_anchors: temporalAnchors,
   };
 
   const prompt = buildEiHeartbeatPrompt(promptData);
@@ -231,7 +278,7 @@ export async function queueHeartbeatCheck(sm: StateManager, personaId: string, i
    const contextHistory = filterMessagesForContext(history, persona.context_boundary, contextWindowMs);
 
   if (personaId === "ei") {
-    await queueEiHeartbeat(sm, human, contextHistory, isTUI);
+    await queueEiHeartbeat(sm, human, contextHistory, isTUI, contextWindowMs, persona.context_boundary);
     return;
   }
 
@@ -249,6 +296,12 @@ export async function queueHeartbeatCheck(sm: StateManager, personaId: string, i
         b.exposure_desired - b.exposure_current - (a.exposure_desired - a.exposure_current)
     );
 
+  const { temporalAnchors, prunedHistory } = buildTemporalAnchorsFromHistory(
+    contextHistory,
+    contextWindowMs,
+    persona.context_boundary
+  );
+
   const promptData: HeartbeatCheckPromptData = {
     persona: {
       name: persona.display_name,
@@ -260,7 +313,8 @@ export async function queueHeartbeatCheck(sm: StateManager, personaId: string, i
       topics: sortByEngagementGap(filteredHuman.topics).slice(0, 5),
       people: sortByEngagementGap(filteredHuman.people).slice(0, 5),
     },
-    recent_history: contextHistory.slice(-10),
+    recent_history: prunedHistory.slice(-10),
+    temporal_anchors: temporalAnchors,
     inactive_days: inactiveDays,
   };
 

package/src/prompts/heartbeat/check.ts

@@ -10,6 +10,7 @@ import { type Message, type Topic, type Person } from "../../core/types.js";
 import { formatMessagesAsPlaceholders, getMessageDisplayText } from "../message-utils.js";
 import { getMessageContent } from "../../core/handlers/utils.js";
 import { partitionTraits } from "../trait-utils.js";
+import { buildTemporalAnchorsSection } from "../response/sections.js";
 function formatTopicsWithGaps(topics: Topic[]): string {
   if (topics.length === 0) return "(No topics with engagement gaps)";
   
@@ -115,12 +116,13 @@ ${formatPeopleWithGaps(data.human.people)}`;
 **Reasons TO reach out:**
 - It's been several days and you have something meaningful to discuss
 - There's a topic with a large engagement gap that you can naturally bring up
-- Something in your recent conversation was left hanging
+- A Temporal Anchor shows something unresolved — you can reference it naturally ("Hey, how did that interview go?")
 - You have genuine interest in checking in (not just "being helpful")
 
 **Reasons NOT to reach out:**
-- Recent conversation ended naturally with closure
+- Recent conversation ended naturally with closure ("talk soon", "gotta run", "later")
 - Less than 24 hours have passed (unless something urgent)
+- A Temporal Anchor describes a worry or question that the recent history already answers — check before using it as a reason to reach out
 - You can't think of something specific and genuine to say
 - It would feel forced or performative
 
@@ -164,9 +166,12 @@ If you decide NOT to reach out:
 }
 \`\`\``;
 
+  const temporalAnchorsFragment = buildTemporalAnchorsSection(data.temporal_anchors, "your human");
+
   const system = [
     roleFragment,
     contextFragment,
+    temporalAnchorsFragment,
     opportunitiesFragment,
     guidelinesFragment,
     pendingUpdateFragment,

package/src/prompts/heartbeat/ei.ts

@@ -1,6 +1,7 @@
 import type { EiHeartbeatPromptData, EiHeartbeatItem, PromptOutput } from "./types.js";
 import type { Message } from "../../core/types.js";
 import { formatMessagesAsPlaceholders, getMessageDisplayText } from "../message-utils.js";
+import { buildTemporalAnchorsSection } from "../response/sections.js";
 
 function formatItem(item: EiHeartbeatItem): string {
   switch (item.type) {
@@ -70,7 +71,7 @@ export function buildEiHeartbeatPrompt(data: EiHeartbeatPromptData): PromptOutpu
     ? "(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.
+  const roleFragment = `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.
 
@@ -78,32 +79,36 @@ 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
+- You care about their overall wellbeing, not just being helpful`;
 
-## Items That May Need Attention
+  const itemsFragment = `## Items That May Need Attention
 
-Each item has an ID in brackets. Pick at most ONE to address.
+Each item has an ID in brackets. Pick at most ONE to address. Temporal Anchors (below) are also valid — you don't need to pick from this list if an anchor feels more meaningful.
 
-${itemsSection}
+${itemsSection}`;
 
-## How to Respond to Each Type
+  const temporalAnchorsFragment = buildTemporalAnchorsSection(data.temporal_anchors, "your human");
+
+  const howToRespondFragment = `## How to Respond to Each Type
 
 - **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.
 - **Persona Reflection Alert**: The nightly review proposed identity changes for this persona. Mention it naturally — the user can talk to the persona and then use the command shown in the status bar to review the changes. Set the id and my_response.
 - **Self Reflection Alert**: The nightly review proposed changes to *your own* identity. Mention it naturally — you've grown and the system noticed. The user can review your proposed changes using the command shown in the status bar. Set the id and my_response.
+- **Temporal Anchor**: If a pinned memory feels meaningful and unresolved, reference it naturally. Omit id — just set should_respond=true and my_response.`;
 
-## When NOT to Reach Out
+  const whenNotFragment = `## When NOT to Reach Out
 
-- Nothing in the list feels meaningful right now
+- Nothing in the list or the Temporal Anchors feels meaningful right now
 - You've already sent unanswered messages (see below)
-- It would feel like nagging
+- It would feel like nagging`;
 
-## Response Format
+  const outputFragment = `## Response Format
 
-Call the \`submit_ei_heartbeat\` tool with your decision. Pick ONE item (or none). If the tool is unavailable, return JSON:
+Call the \`submit_ei_heartbeat\` tool with your decision. If the tool is unavailable, return JSON:
 
+For an item from the list:
 \`\`\`json
 {
   "should_respond": true,
@@ -112,13 +117,30 @@ Call the \`submit_ei_heartbeat\` tool with your decision. Pick ONE item (or none
 }
 \`\`\`
 
-Or if nothing warrants reaching out:
+For a Temporal Anchor (no id needed):
+\`\`\`json
+{
+  "should_respond": true,
+  "my_response": "Hey, I've been thinking about you — how did that interview go?"
+}
+\`\`\`
+
+If nothing warrants reaching out:
 \`\`\`json
 {
   "should_respond": false
 }
 \`\`\``;
 
+  const system = [
+    roleFragment,
+    itemsFragment,
+    temporalAnchorsFragment,
+    howToRespondFragment,
+    whenNotFragment,
+    outputFragment,
+  ].filter(Boolean).join("\n\n");
+
   const historySection = `## Recent Conversation History
 
 ${formatMessagesAsPlaceholders(data.recent_history, "Ei")}`;

package/src/prompts/heartbeat/index.ts

@@ -13,3 +13,4 @@ export type {
   EiHeartbeatResult,
   PromptOutput,
 } from "./types.js";
+export type { TemporalAnchor } from "../response/types.js";

package/src/prompts/heartbeat/types.ts

@@ -5,6 +5,7 @@
 
 import type { PersonaTrait, Topic, Person, Message, PersonaTopic } from "../../core/types.js";
 import type { PersonaEntity } from "../../core/types/entities.js";
+import type { TemporalAnchor } from "../response/types.js";
 
 /**
  * Common prompt output structure
@@ -28,8 +29,9 @@ export interface HeartbeatCheckPromptData {
     topics: Topic[];     // Filtered, sorted by engagement gap
     people: Person[];    // Filtered, sorted by engagement gap
   };
-  recent_history: Message[];  // Last N messages for context
-  inactive_days: number;      // Days since last activity
+  recent_history: Message[];        // Last N messages for context (Always-within-window only)
+  temporal_anchors: TemporalAnchor[]; // Always messages that fell outside the context window
+  inactive_days: number;            // Days since last activity
 }
 
 /**
@@ -107,7 +109,8 @@ export type EiHeartbeatItem =
 export interface EiHeartbeatPromptData {
   items: EiHeartbeatItem[];
   recent_history: Message[];
-  system_messages: Message[];  // Pre-filtered system messages from recent_history
+  system_messages: Message[];
+  temporal_anchors: TemporalAnchor[];
 }
 
 /**

package/src/prompts/index.ts

@@ -1,5 +1,5 @@
 export { buildResponsePrompt } from "./response/index.js";
-export type { ResponsePromptData, PromptOutput } from "./response/types.js";
+export type { ResponsePromptData, PromptOutput, TemporalAnchor } from "./response/types.js";
 
 export {
   buildHeartbeatCheckPrompt,