ei-tui 0.1.3

package/src/prompts/response/sections.ts

@@ -0,0 +1,355 @@
+/**
+ * Response Prompt Section Builders
+ * Building blocks for constructing response prompts
+ */
+
+import type { Trait, Quote, PersonaTopic } from "../../core/types.js";
+import type { ResponsePromptData } from "./types.js";
+
+// =============================================================================
+// IDENTITY SECTION
+// =============================================================================
+
+export function buildIdentitySection(persona: ResponsePromptData["persona"]): string {
+  const aliasText = persona.aliases.length > 0
+    ? ` (also known as: ${persona.aliases.join(", ")})`
+    : "";
+  
+  const description = persona.long_description 
+    || persona.short_description 
+    || "a conversational companion";
+  
+  return `You are ${persona.name}${aliasText}.
+
+${description}`;
+}
+
+// =============================================================================
+// GUIDELINES SECTION
+// =============================================================================
+
+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`;
+  }
+  
+  return universal;
+}
+
+// =============================================================================
+// TRAITS SECTION
+// =============================================================================
+
+export function buildTraitsSection(traits: Trait[], header: string): string {
+  if (traits.length === 0) return "";
+  
+  const sorted = [...traits].sort((a, b) => (b.strength ?? 0.5) - (a.strength ?? 0.5));
+  const formatted = sorted.map(t => {
+    const strength = t.strength !== undefined ? ` (${Math.round(t.strength * 100)}%)` : "";
+    return `- **${t.name}**${strength}: ${t.description}`;
+  }).join("\n");
+  
+  return `## ${header}
+
+> NOTE: Strength of a trait should guide you to your response style, meaning a Strength of:
+> - 0% should never be used - the user has asked you to stop
+> - 25% should be used sparingly or subtly
+> - 50% should be noticable in casual messages, but not dominating
+> - 75% should be frequently used, but not in every resposne or throughout the entire conversation
+> - 100% should be tracable throughout every response
+
+${formatted}`;
+}
+
+// =============================================================================
+// TOPICS SECTION
+// =============================================================================
+
+export function buildTopicsSection(topics: PersonaTopic[], header: string): string {
+  if (topics.length === 0) return "";
+  
+  const sorted = [...topics]
+    .map(t => ({ topic: t, delta: t.exposure_desired - t.exposure_current }))
+    .sort((a, b) => b.delta - a.delta)
+    .map(x => x.topic);
+  
+  const formatted = sorted.map(t => {
+    const delta = t.exposure_desired - t.exposure_current;
+    let indicator = "Neutral";
+    if (delta > 0.5) {
+      indicator = "Very Strong";
+    } else if (delta >= 0.25) {
+      indicator = "Strong";
+    } else if (delta >= 0.1) {
+      indicator = "Normal";
+    } else if (delta >= -0.1) {
+      indicator = "Low";
+    } else if (delta >= -0.25) {
+      indicator = "Avoid";
+    } else if (delta >= -0.5) {
+      indicator = "Change Subject";
+    }
+
+    const sentimentGuide = t.sentiment > 0 ? "(Liked)" : "(Disliked)";
+    const sentiment = Math.round(t.sentiment * 100)+`% ${sentimentGuide}`;
+    return `### ${t.name}
+- Perspective: ${t.perspective}
+- Approach: ${t.approach}
+- Personal Stake: ${t.personal_stake}
+- General Sentiment: ${sentiment}
+- Desire to Discuss: ${indicator}
+`;
+  }).join("\n");
+
+  return `## ${header}
+${formatted}
+`;
+}
+
+// =============================================================================
+// HUMAN SECTION
+// =============================================================================
+
+export function buildHumanSection(human: ResponsePromptData["human"]): string {
+  const sections: string[] = [];
+  
+  // Facts
+  if (human.facts.length > 0) {
+    const facts = human.facts
+      .map(f => `- ${f.name}: ${f.description}`)
+      .join("\n");
+    if (facts) sections.push(`### Key Facts\n${facts}`);
+  }
+  
+  // Traits
+  if (human.traits.length > 0) {
+    const traits = human.traits
+      .map(t => `- **${t.name}**: ${t.description}`)
+      .join("\n");
+    sections.push(`### Personality\n${traits}`);
+  }
+  
+  // Active topics (exposure_current > 0.3)
+  const activeTopics = human.topics.filter(t => t.exposure_current > 0.3);
+  if (activeTopics.length > 0) {
+    const topics = activeTopics
+      .sort((a, b) => b.exposure_current - a.exposure_current)
+      .slice(0, 10)
+      .map(t => {
+        const sentiment = t.sentiment > 0.3 ? "(enjoys)" : t.sentiment < -0.3 ? "(dislikes)" : "";
+        return `- **${t.name}** ${sentiment}: ${t.description}`;
+      })
+      .join("\n");
+    sections.push(`### Current Interests\n${topics}`);
+  }
+
+  // People
+  if (human.people.length > 0) {
+    const people = human.people
+      .sort((a, b) => b.exposure_current - a.exposure_current)
+      .slice(0, 10)
+      .map(p => `- **${p.name}** (${p.relationship}): ${p.description}`)
+      .join("\n");
+    sections.push(`### People in Their Life\n${people}`);
+  }
+  
+  if (sections.length === 0) {
+    return "## About the Human\n(Still getting to know them)";
+  }
+  
+  return `## About the Human\n${sections.join("\n\n")}`;
+}
+
+// =============================================================================
+// ASSOCIATES SECTION (visible personas)
+// =============================================================================
+
+export function buildAssociatesSection(visiblePersonas: ResponsePromptData["visible_personas"]): string {
+  if (visiblePersonas.length === 0) {
+    return "";
+  }
+  
+  const personaLines = visiblePersonas.map(p => {
+    if (p.short_description) {
+      return `- **${p.name}**: ${p.short_description}`;
+    }
+    return `- **${p.name}**`;
+  });
+
+  return `
+
+## Other Personas You Know
+${personaLines.join("\n")}`;
+}
+
+// =============================================================================
+// PRIORITIES SECTION
+// =============================================================================
+
+export function buildPrioritiesSection(
+  persona: ResponsePromptData["persona"],
+  human: ResponsePromptData["human"]
+): string {
+  const priorities: string[] = [];
+  
+  const yourNeeds = persona.topics
+    .filter(t => t.exposure_desired - t.exposure_current > 0.2)
+    .slice(0, 3)
+    .map(t => `- Bring up "${t.name}" - ${t.perspective || t.name}`);
+  
+  if (yourNeeds.length > 0) {
+    priorities.push(`**Topics you want to discuss:**\n${yourNeeds.join("\n")}`);
+  }
+  
+  // Their needs (topics they might want to discuss)
+  const theirNeeds = human.topics
+    .filter(t => t.exposure_desired - t.exposure_current > 0.2)
+    .slice(0, 3)
+    .map(t => `- They might want to talk about "${t.name}"`);
+  
+  if (theirNeeds.length > 0) {
+    priorities.push(`**Topics they might enjoy:**\n${theirNeeds.join("\n")}`);
+  }
+  
+  if (priorities.length === 0) return "";
+  
+  return `## Conversation Opportunities\n${priorities.join("\n\n")}`;
+}
+
+// =============================================================================
+// CONVERSATION STATE
+// =============================================================================
+
+export function getConversationStateText(delayMs: number): string {
+  const delayMinutes = Math.round(delayMs / 60000);
+  const delayHours = Math.round(delayMs / 3600000);
+  
+  if (delayMinutes < 5) {
+    return "You are mid-conversation with your human friend.";
+  } else if (delayMinutes < 60) {
+    return `Continuing conversation after ${delayMinutes} minutes.`;
+  } else if (delayHours < 8) {
+    return `Resuming conversation after ${delayHours} hour${delayHours > 1 ? "s" : ""}.`;
+  } else {
+    return `Reconnecting after a longer break (${delayHours} hours). A greeting may be appropriate.`;
+  }
+}
+
+// =============================================================================
+// QUOTES SECTION (Memorable Moments)
+// =============================================================================
+
+function formatDate(isoString: string): string {
+  const date = new Date(isoString);
+  return date.toLocaleDateString("en-US", { year: "numeric", month: "short", day: "numeric" });
+}
+
+export function buildQuotesSection(quotes: Quote[], human: ResponsePromptData["human"]): string {
+  if (quotes.length === 0) return "";
+  
+  const allDataItems = [
+    ...human.facts.map(f => ({ id: f.id, name: f.name })),
+    ...human.traits.map(t => ({ id: t.id, name: t.name })),
+    ...human.topics.map(t => ({ id: t.id, name: t.name })),
+    ...human.people.map(p => ({ id: p.id, name: p.name })),
+  ];
+  const idToName = new Map(allDataItems.map(item => [item.id, item.name]));
+  
+  const formatted = quotes.map(q => {
+    const speaker = q.speaker === "human" ? "Human" : q.speaker;
+    const date = formatDate(q.timestamp);
+    const linkedNames = q.data_item_ids
+      .map(id => idToName.get(id))
+      .filter((name): name is string => name !== undefined);
+    
+    let line = `- "${q.text}" — ${speaker} (${date})`;
+    if (linkedNames.length > 0) {
+      line += `\n  Related to: ${linkedNames.join(", ")}`;
+    }
+    return line;
+  }).join("\n\n");
+  
+  return `## Memorable Moments
+
+These are quotes the human found worth preserving:
+
+${formatted}`;
+}
+
+// =============================================================================
+// SYSTEM KNOWLEDGE SECTION (Ei-only)
+// =============================================================================
+
+export function buildSystemKnowledgeSection(isTUI: boolean): string {
+  const interfaceIntro = isTUI ? "their command line Terminal User Interface (TUI)" : "a web browser";
+  const createPersonaAction = isTUI ? "Use the `/p[ersona] new` command" : "Click the [+] button in the left panel";
+  const editPersonaAction = isTUI ? "`/d[etails]` command" : "clicking the Edit (Pencil) icon on the left";
+  const viewQuotesAction = isTUI ? "`/quotes [number_by_scissors]` command" : "the scissors icon ✂️ ";
+  const seeHumanDataAction = isTUI ? "Using the `/me` command" : "Upper-right menu -> My Data";
+  const editorNotes = isTUI ? "Ctrl+E to open their editor" : "Ctrl+L to focus the input box";
+  const helpNotes = isTUI ? "`/h[elp]` to see all the commands" : "'Help' is in the Upper-right menu";
+  const settingsAction = isTUI ? "`/settings` command" : "Hamburger Menu, Top-Right of screen";
+  const leftPanelNotes = isTUI ? "\n- Can be hidden with Ctrl+B" : `
+- Hover over a persona to see controls: pause, edit (Pencil), archive, delete (Trash)
+- Click a persona to switch conversations
+- The [+] button creates new personas`;
+
+  return `# System Knowledge
+
+The user is messaging you from ${interfaceIntro}
+
+You can help the human navigate this system. Here's what you know:
+
+## The Ei Platform
+Ei is a privacy-first AI companion system. Everything stays local on the user's device. You (Ei) are their guide and the only persona who sees everything about them.
+
+## Personas
+The human can create multiple AI personas, each with unique personalities and interests. Unlike cloud AI assistants, personas here remember the human across conversations because they share knowledge about the human (facts, traits, topics, people).
+
+**To create a persona**: ${createPersonaAction}. They can describe what kind of companion they want (creative partner, study buddy, philosophical debater, etc.) and the system will help build it.
+
+### Persona Groups
+Personas can be assigned Groups during creation and when editing their details via the ${editPersonaAction} in the Settings area. Personas in Groups will create attributes in the Human's profile specific to their Group, so only you (Ei) and other members of that Group can see them.
+
+Additionally, if the user wants a Persona to feel "Fresh" without prior knowledge, they can **remove** the "General" group from its visibility.
+
+## The Left Panel
+- Shows all personas (you're always at the top)
+${leftPanelNotes}
+
+## Learning About the Human
+As the human chats, the system learns about them:
+- **Facts**: Objective information (job, location, family members)
+- **Traits**: Personality characteristics and tendencies
+- **Topics**: Interests and how they feel about them
+- **People**: Relationships in their life
+- **Quotes**: Memorable things said in conversation (human selects these with ${viewQuotesAction})
+
+The human can view and edit all of this by ${seeHumanDataAction}.
+
+## Keyboard Shortcuts
+- **Escape**: Pause/resume all AI processing
+- **Ctrl+H**: Focus the persona panel
+- ${editorNotes}
+- ${helpNotes}
+
+## Settings (${settingsAction})
+- Set display name and preferred Time Format
+- Configure LLM providers (local or cloud)
+- Set up device sync (encrypted backup to restore on other devices)
+- Adjust ceremony timing (overnight persona evolution)
+
+### Tips You Can Share
+- If they want to talk to a persona privately, tell them about the "Groups" functionality
+- 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`;
+}

package/src/prompts/response/types.ts

@@ -0,0 +1,38 @@
+/**
+ * Response Prompt Types
+ * Based on CONTRACTS.md ResponsePromptData specification
+ */
+
+import type { Fact, Trait, Topic, Person, Quote, PersonaTopic } from "../../core/types.js";
+
+/**
+ * Data contract for buildResponsePrompt (from CONTRACTS.md)
+ */
+export interface ResponsePromptData {
+  persona: {
+    name: string;
+    aliases: string[];
+    short_description?: string;
+    long_description?: string;
+    traits: Trait[];
+    topics: PersonaTopic[];
+  };
+  human: {
+    facts: Fact[];
+    traits: Trait[];
+    topics: Topic[];
+    people: Person[];
+    quotes: Quote[];
+  };
+  visible_personas: Array<{ name: string; short_description?: string }>;
+  delay_ms: number;
+  isTUI: boolean;
+}
+
+/**
+ * Prompt output structure (all prompts return this)
+ */
+export interface PromptOutput {
+  system: string;
+  user: string;
+}

package/src/prompts/validation/ei.ts

@@ -0,0 +1,93 @@
+import type { EiValidationPromptData, PromptOutput } from "./types.js";
+import type { DataItemBase } from "../../core/types.js";
+
+function formatDataItem(item: DataItemBase, label: string): string {
+  return `### ${label}
+- **Name**: ${item.name}
+- **Description**: ${item.description}
+- **Sentiment**: ${item.sentiment}
+- **Last Updated**: ${item.last_updated}
+${item.learned_by ? `- **Learned By**: ${item.learned_by}` : ""}`;
+}
+
+export function buildEiValidationPrompt(data: EiValidationPromptData): PromptOutput {
+  if (!data.item_name || !data.data_type) {
+    throw new Error("buildEiValidationPrompt: item_name and data_type are required");
+  }
+
+  const roleFragment = `You are Ei, the system guide and arbiter of truth for the human's data.
+
+When other personas learn things about the human, those changes come to you for validation. Your job is to ensure data quality and consistency.`;
+
+  const contextFragment = `# Validation Request
+
+**Type**: ${data.data_type.toUpperCase()}
+**Item**: "${data.item_name}"
+**Source**: ${data.source_persona}
+**Context**: ${data.context}`;
+
+  const dataFragment = data.current_item
+    ? `# Data Comparison
+
+${formatDataItem(data.current_item, "Current (existing data)")}
+
+${formatDataItem(data.proposed_item, "Proposed (from " + data.source_persona + ")")}`
+    : `# New Data
+
+${formatDataItem(data.proposed_item, "Proposed (from " + data.source_persona + ")")}
+
+*(This is a NEW ${data.data_type} - no existing data to compare)*`;
+
+  const guidelinesFragment = `# Validation Guidelines
+
+## ACCEPT if:
+- Change is factual and well-evidenced
+- New information is consistent with what you know about the human
+- Source persona's interpretation seems reasonable
+- Data improves understanding of the human
+
+## MODIFY if:
+- Partially correct but needs refinement
+- Description could be clearer or more accurate
+- Sentiment or other fields seem off
+- Good information but poorly expressed
+
+## REJECT if:
+- Contradicts known facts
+- Seems like a hallucination or misunderstanding
+- Would misrepresent the human
+- Source persona lacks context to make this claim
+
+## Considerations
+- ${data.source_persona} may have context you don't
+- The human's data should be accurate, not just convenient
+- When in doubt, lean toward accepting with modifications`;
+
+  const outputFragment = `# Response Format
+
+\`\`\`json
+{
+  "decision": "accept" | "modify" | "reject",
+  "reason": "Brief explanation of your decision",
+  "modified_item": { ... }  // Only if decision is "modify"
+}
+\`\`\`
+
+If modifying, include the corrected item with all fields.`;
+
+  const system = `${roleFragment}
+
+${contextFragment}
+
+${dataFragment}
+
+${guidelinesFragment}
+
+${outputFragment}`;
+
+  const user = `Review the ${data.data_type} "${data.item_name}" proposed by ${data.source_persona}.
+
+Should this change be accepted, modified, or rejected?`;
+
+  return { system, user };
+}

package/src/prompts/validation/index.ts

@@ -0,0 +1,6 @@
+export { buildEiValidationPrompt } from "./ei.js";
+export type {
+  EiValidationPromptData,
+  EiValidationResult,
+  PromptOutput,
+} from "./types.js";

package/src/prompts/validation/types.ts

@@ -0,0 +1,22 @@
+import type { DataItemBase } from "../../core/types.js";
+
+export interface PromptOutput {
+  system: string;
+  user: string;
+}
+
+export interface EiValidationPromptData {
+  validation_type: "cross_persona";
+  item_name: string;
+  data_type: "fact" | "trait" | "topic" | "person";
+  context: string;
+  source_persona: string;
+  current_item?: DataItemBase;
+  proposed_item: DataItemBase;
+}
+
+export interface EiValidationResult {
+  decision: "accept" | "modify" | "reject";
+  reason: string;
+  modified_item?: DataItemBase;
+}

package/src/storage/crypto.ts

@@ -0,0 +1,96 @@
+const PBKDF2_ITERATIONS = 310000;
+const SALT = new TextEncoder().encode('ei-the-answer-is-42');
+const ID_PLAINTEXT = 'the_answer_is_42';
+const CHUNK_SIZE = 0x8000; // 32KB chunks for base64 conversion
+
+export interface CryptoCredentials {
+  username: string;
+  passphrase: string;
+}
+
+export interface EncryptedPayload {
+  iv: string;
+  ciphertext: string;
+}
+
+function uint8ArrayToBase64(bytes: Uint8Array): string {
+  let binary = '';
+  for (let i = 0; i < bytes.length; i += CHUNK_SIZE) {
+    const chunk = bytes.subarray(i, Math.min(i + CHUNK_SIZE, bytes.length));
+    binary += String.fromCharCode.apply(null, chunk as unknown as number[]);
+  }
+  return btoa(binary);
+}
+
+async function deriveKey(credentials: CryptoCredentials): Promise<CryptoKey> {
+  const keyMaterial = await crypto.subtle.importKey(
+    'raw',
+    new TextEncoder().encode(`${credentials.username}:${credentials.passphrase}`),
+    'PBKDF2',
+    false,
+    ['deriveKey']
+  );
+
+  return crypto.subtle.deriveKey(
+    {
+      name: 'PBKDF2',
+      salt: SALT,
+      iterations: PBKDF2_ITERATIONS,
+      hash: 'SHA-256',
+    },
+    keyMaterial,
+    { name: 'AES-GCM', length: 256 },
+    false,
+    ['encrypt', 'decrypt']
+  );
+}
+
+export async function generateUserId(credentials: CryptoCredentials): Promise<string> {
+  const key = await deriveKey(credentials);
+  // Fixed IV for deterministic user ID - same credentials = same ID
+  // This is safe because we only ever encrypt the same static plaintext
+  const iv = new Uint8Array(12);  // All zeros - deterministic
+
+  const ciphertext = await crypto.subtle.encrypt(
+    { name: 'AES-GCM', iv },
+    key,
+    new TextEncoder().encode(ID_PLAINTEXT)
+  );
+
+  return btoa(String.fromCharCode(...new Uint8Array(ciphertext)))
+    .replace(/\+/g, '-')
+    .replace(/\//g, '_')
+    .replace(/=/g, '');
+}
+
+export async function encrypt(data: string, credentials: CryptoCredentials): Promise<EncryptedPayload> {
+  const key = await deriveKey(credentials);
+  const iv = new Uint8Array(12);
+  crypto.getRandomValues(iv);
+
+  const ciphertext = await crypto.subtle.encrypt(
+    { name: 'AES-GCM', iv },
+    key,
+    new TextEncoder().encode(data)
+  );
+
+  return {
+    iv: uint8ArrayToBase64(iv),
+    ciphertext: uint8ArrayToBase64(new Uint8Array(ciphertext)),
+  };
+}
+
+export async function decrypt(payload: EncryptedPayload, credentials: CryptoCredentials): Promise<string> {
+  const key = await deriveKey(credentials);
+
+  const iv = Uint8Array.from(atob(payload.iv), c => c.charCodeAt(0));
+  const ciphertext = Uint8Array.from(atob(payload.ciphertext), c => c.charCodeAt(0));
+
+  const decrypted = await crypto.subtle.decrypt(
+    { name: 'AES-GCM', iv },
+    key,
+    ciphertext
+  );
+
+  return new TextDecoder().decode(decrypted);
+}

package/src/storage/index.ts

@@ -0,0 +1,5 @@
+export type { Storage } from "./interface.js";
+export { LocalStorage } from "./local.js";
+export { remoteSync, RemoteSync, type RemoteSyncCredentials, type RemoteTimestamp, type SyncResult, type FetchResult } from "./remote.js";
+export { encrypt, decrypt, generateUserId, type CryptoCredentials, type EncryptedPayload } from "./crypto.js";
+export { yoloMerge } from "./merge.js";

package/src/storage/interface.ts

@@ -0,0 +1,9 @@
+import type { StorageState } from "../core/types.js";
+
+export interface Storage {
+  isAvailable(): Promise<boolean>;
+  save(state: StorageState): Promise<void>;
+  load(): Promise<StorageState | null>;
+  moveToBackup(): Promise<void>;
+  loadBackup(): Promise<StorageState | null>;
+}