ei-tui 0.6.6 → 0.6.7

package/package.json

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

package/src/cli/README.md

@@ -72,9 +72,11 @@ ei "What are the user's current preferences, active projects, and workflow?"
 
 Ei is a persistent knowledge base built from the user's conversations — facts, preferences,
 people, topics, personas. Use it when the user references past work, mentions how they like things done,
-or asks "how did we do X." Use `ei --persona "Beta" "walruses"` to scope results to what a specific
-persona has learned. Use `ei personas "name"` to find personas by name. Query again mid-session when
-they correct you or reference something from a previous session.
+asks "how did we do X," or needs to look up a person by any name, handle, or account (GitHub username,
+Discord handle, email, nickname, etc.) — people results include an `identifiers` array covering all
+known accounts and aliases for that person. Use `ei --persona "Beta" "walruses"` to scope results to
+what a specific persona has learned. Use `ei personas "name"` to find personas by name. Query again
+mid-session when they correct you or reference something from a previous session.
 ```
 
 ### Claude Code
@@ -87,9 +89,11 @@ natural-language query about the user's preferences, active projects, and workfl
 A `persona` filter is available to scope results to what a specific persona has learned.
 Use `type: "personas"` to search for personas by name.
 
-Use Ei when the user references past decisions, mentions people or preferences, or asks
-"how did we do X." Query again when they correct you or reference something from a previous
-session.
+Use Ei when the user references past decisions, mentions people or preferences, asks
+"how did we do X," or needs to look up a person by any name, handle, or account — people
+results include an `identifiers` array (GitHub username, Discord handle, email, nickname, etc.)
+covering all known accounts and aliases. Query again when they correct you or reference
+something from a previous session.
 ```
 
 ### Cursor
@@ -111,6 +115,9 @@ conversations (facts, people, topics, quotes, personas).
   doesn't have that context.
 - You need the user's preferences, contacts, or project conventions (e.g. who to ask for
   access, how something was fixed).
+- You need to look up a person by any name, handle, or account — people results include an
+  `identifiers` array (GitHub username, Discord handle, email, nickname, etc.) covering all
+  known accounts and aliases for that person.
 - The question is about the user personally (people, workflow, prior discussions) rather
   than only code.
 
@@ -138,7 +145,9 @@ The installed tool gives OpenCode agents access to all five data types with prop
 
 All search commands return arrays. Each result includes a `type` field.
 
-**Fact / Person / Topic**: `{ type, id, name, description, sentiment, ...type-specific fields }`
+**Fact / Topic**: `{ type, id, name, description, sentiment, ...type-specific fields }`
+
+**Person**: `{ type, id, name, description, relationship, sentiment, identifiers[] }` — `identifiers` contains all known accounts and aliases (e.g. `{ type: "GitHub", value: "flare576" }`)
 
 **Quote**: `{ type, id, text, speaker, timestamp, linked_items[] }`
 

package/src/cli/commands/people.ts

@@ -21,5 +21,6 @@ export async function execute(query: string, limit: number, options: { recent?:
     description: person.description,
     relationship: person.relationship,
     sentiment: person.sentiment,
+    identifiers: person.identifiers ?? [],
   }));
 }

package/src/cli/mcp.ts

@@ -16,7 +16,7 @@ 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. Omit query to browse by recency (use with recent=true or persona filter).",
+        "Search the user's Ei knowledge base — a persistent memory store built from conversations. Returns facts, people, topics of interest, and quotes. People results include an identifiers array (e.g. GitHub username, Discord handle, email, nickname) — query by any name or handle to find what Ei knows about that person. 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().optional().describe("Search text. Supports natural language. Omit to browse without semantic filtering — useful with recent=true or persona filter."),
         type: z

package/src/cli/retrieval.ts

@@ -1,6 +1,6 @@
 import type { StorageState, Quote, Fact, Person, Topic } from "../core/types";
 import type { PersonaEntity } from "../core/types/entities.js";
-import type { PersonaTrait, PersonaTopic } from "../core/types/data-items.js";
+import type { PersonaTrait, PersonaTopic, PersonIdentifier } from "../core/types/data-items.js";
 import { decodeAllEmbeddings } from "../storage/embeddings";
 import { crossFind } from "../core/utils/index.ts";
 import { join } from "path";
@@ -102,6 +102,7 @@ export interface PersonResult {
   description: string;
   relationship: string;
   sentiment: number;
+  identifiers: PersonIdentifier[];
 }
 
 export interface TopicResult {
@@ -182,6 +183,7 @@ function mapPerson(person: Person): PersonResult {
     description: person.description,
     relationship: person.relationship,
     sentiment: person.sentiment,
+    identifiers: person.identifiers ?? [],
   };
 }
 

package/src/core/handlers/human-matching.ts

@@ -14,7 +14,7 @@ import { calculateExposureCurrent } from "../utils/exposure.js";
 
 
 import { resolveMessageWindow, getMessageText, normalizeRoomMessages } from "./utils.js";
-import { sanitizeEiPersonaIdentifiers } from "../utils/identifier-utils.js";
+import { sanitizeEiPersonaIdentifiers, normalizeIdentifierType } from "../utils/identifier-utils.js";
 
 export function handleTopicMatch(response: LLMResponse, state: StateManager): void {
   const result = response.parsed as ItemMatchResult | undefined;
@@ -284,7 +284,7 @@ export async function handlePersonUpdate(response: LLMResponse, state: StateMana
   if (isNewItem) {
     const llmIdentifiers: PersonIdentifier[] = sanitizeEiPersonaIdentifiers(
       (result.identifiers ?? []).map(i => ({
-        type: i.type,
+        type: normalizeIdentifierType(i.type, state),
         value: i.value,
         ...(i.is_primary ? { is_primary: i.is_primary } : {}),
       })),
@@ -293,7 +293,7 @@ export async function handlePersonUpdate(response: LLMResponse, state: StateMana
     const allCandidateIds = [...llmIdentifiers, ...candidateIdentifiers];
     if (allCandidateIds.length === 0) {
       const hasSpace = candidateName.includes(' ');
-      allCandidateIds.push({ type: hasSpace ? "full_name" : "nickname", value: candidateName, is_primary: true });
+      allCandidateIds.push({ type: hasSpace ? "Full Name" : "Nickname", value: candidateName, is_primary: true });
     }
     const deduped: PersonIdentifier[] = [];
     for (const id of allCandidateIds) {
@@ -304,7 +304,13 @@ export async function handlePersonUpdate(response: LLMResponse, state: StateMana
     resolvedIdentifiers = deduped;
   } else {
     const base = [...(existingPerson?.identifiers ?? [])];
-    const sanitizedToAdd = sanitizeEiPersonaIdentifiers(result.identifiers_to_add ?? [], state);
+    const sanitizedToAdd = sanitizeEiPersonaIdentifiers(
+      (result.identifiers_to_add ?? []).map(i => ({
+        ...i,
+        type: normalizeIdentifierType(i.type, state),
+      })),
+      state
+    );
     for (const id of sanitizedToAdd) {
       if (!base.some(e => e.value === id.value)) {
         base.push({ type: id.type, value: id.value, ...(id.is_primary ? { is_primary: id.is_primary } : {}) });

package/src/core/orchestrators/human-extraction.ts

@@ -281,6 +281,7 @@ export function queueDirectTopicUpdate(
         isNewItem: false,
         existingItemId: topic.id,
         analyze_from_timestamp: getAnalyzeFromTimestamp(chunk),
+        extraction_model: extractionModel,
       },
     });
   }
@@ -425,14 +426,11 @@ export function queueTopicUpdate(
       user: prompt.user,
       next_step: LLMNextStep.HandleTopicUpdate,
       data: {
-        personaId: context.personaId,
-        personaDisplayName: context.personaDisplayName,
-        roomId: context.roomId,
+        ...context,
         isNewItem,
         existingItemId: existingItem?.id,
         candidateName: isNewItem ? context.candidateName : undefined,
         candidateDescription: isNewItem ? context.candidateDescription : undefined,
-        candidateCategory: context.candidateCategory,
         analyze_from_timestamp: getAnalyzeFromTimestamp(chunk),
       },
     });
@@ -469,13 +467,25 @@ export function queueEventSummary(
 
   const allMessages = state.messages_get(personaId);
   const extractionModel = options?.extraction_model;
+  const gapMs = gapHours * 60 * 60 * 1000;
+  const now = Date.now();
   let totalChunks = 0;
 
-  state.messages_markExtracted(personaId, sorted.map(m => m.id), "e");
-
-  for (const windowMessages of windows) {
+  for (let i = 0; i < windows.length; i++) {
+    const windowMessages = windows[i];
     if (windowMessages.length === 0) continue;
 
+    const isLastWindow = i === windows.length - 1;
+    if (isLastWindow) {
+      const lastMsgTime = new Date(windowMessages[windowMessages.length - 1].timestamp).getTime();
+      if (now - lastMsgTime < gapMs) {
+        console.log(`[queueEventSummary] Skipping open window for ${persona.display_name} — last message < ${gapHours}h ago`);
+        continue;
+      }
+    }
+
+    state.messages_markExtracted(personaId, windowMessages.map(m => m.id), "e");
+
     const windowStartTime = new Date(windowMessages[0].timestamp).getTime();
     const messages_context = allMessages.filter(
       m => m.e === true && new Date(m.timestamp).getTime() < windowStartTime
@@ -599,6 +609,7 @@ export function queuePersonUpdate(
         candidateRelationship: context.candidateRelationship,
         candidateIdentifiers: isNewItem ? candidateIdentifiers : undefined,
         analyze_from_timestamp: getAnalyzeFromTimestamp(chunk),
+        extraction_model: context.extraction_model,
       },
     });
   }
@@ -653,6 +664,7 @@ export async function queueTopicValidate(
     data: {
       entity_type: "topic",
       entity_ids: [existingTopic.id, newTopic.id],
+      extraction_model: extractionModel,
     },
   });
 }

package/src/core/persona-manager.ts

@@ -20,6 +20,9 @@ export async function getPersonaList(sm: StateManager): Promise<PersonaSummary[]
     unread_count: sm.messages_countUnread(entity.id),
     last_activity: entity.last_activity,
     context_boundary: entity.context_boundary,
+    avatar_emoji: entity.avatar_emoji,
+    avatar_image: entity.avatar_image,
+    preferred_theme: entity.preferred_theme,
   }));
 }
 

package/src/core/state-manager.ts

@@ -18,6 +18,7 @@ import type {
   RoomCreationInput,
 } from "./types.js";
 import { BUILT_IN_FACT_NAMES } from './constants/built-in-facts.js';
+import type { ThemeDefinition } from './types/entities.js';
 import type { Storage } from "../storage/interface.js";
 import {
   HumanState,
@@ -68,6 +69,7 @@ export class StateManager {
     this.migrateInterestedPersonas();
     this.migrateProviderModel();
     this.migrateRoomMessageContent();
+    this.migrateThemes();
   }
 
   private migrateRoomMessageContent(): void {
@@ -566,6 +568,14 @@ export class StateManager {
     this.persistenceState.scheduleSave(this.buildStorageState());
   }
 
+  private migrateThemes(): void {
+    const human = this.humanState.get();
+    if (!human.settings) return;
+    if (human.settings.custom_themes !== undefined) return;
+    human.settings.custom_themes = [];
+    this.humanState.set(human);
+  }
+
   getHuman(): HumanEntity {
     return this.humanState.get();
   }
@@ -575,6 +585,44 @@ export class StateManager {
     this.scheduleSave();
   }
 
+  human_theme_getActive(): string | undefined {
+    return this.getHuman().settings?.active_theme;
+  }
+
+  human_theme_setActive(id: string | undefined): void {
+    const human = this.getHuman();
+    human.settings ??= {};
+    human.settings.active_theme = id;
+    this.setHuman(human);
+  }
+
+  human_theme_getAll(): ThemeDefinition[] {
+    return this.getHuman().settings?.custom_themes ?? [];
+  }
+
+  human_theme_upsert(theme: ThemeDefinition): void {
+    const human = this.getHuman();
+    human.settings ??= {};
+    human.settings.custom_themes ??= [];
+    const idx = human.settings.custom_themes.findIndex(t => t.id === theme.id);
+    if (idx >= 0) {
+      human.settings.custom_themes[idx] = theme;
+    } else {
+      human.settings.custom_themes.push(theme);
+    }
+    this.setHuman(human);
+  }
+
+  human_theme_remove(id: string): boolean {
+    const human = this.getHuman();
+    const themes = human.settings?.custom_themes ?? [];
+    const idx = themes.findIndex(t => t.id === id);
+    if (idx < 0) return false;
+    themes.splice(idx, 1);
+    this.setHuman(human);
+    return true;
+  }
+
   human_fact_upsert(fact: Fact): void {
     this.humanState.fact_upsert(fact);
     this.scheduleSave();

package/src/core/tools/builtin/read-memory.ts

@@ -57,7 +57,7 @@ export function createReadMemoryExecutor(searchHumanData: SearchHumanData, getPe
       const output: Record<string, unknown[]> = {};
       if (results.facts.length > 0) output.facts = results.facts.map(f => ({ name: f.name, description: f.description }));
       if (results.topics.length > 0) output.topics = results.topics.map(t => ({ name: t.name, description: t.description }));
-      if (results.people.length > 0) output.people = results.people.map(p => ({ name: p.name, relationship: p.relationship, description: p.description }));
+      if (results.people.length > 0) output.people = results.people.map(p => ({ name: p.name, relationship: p.relationship, description: p.description, identifiers: p.identifiers ?? [] }));
       if (results.quotes.length > 0) output.quotes = results.quotes.map(q => ({ text: q.text, speaker: q.speaker }));
 
       if (Object.keys(output).length === 0) {

package/src/core/types/entities.ts

@@ -91,6 +91,14 @@ export interface ProviderAccount {
   created_at: string;              // ISO timestamp
 }
 
+export interface ThemeDefinition {
+  id: string;
+  name: string;
+  base?: string;
+  encoded: string;
+  created_at: string;
+}
+
 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.
@@ -111,6 +119,8 @@ export interface HumanSettings {
   backup?: BackupConfig;
   claudeCode?: import("../../integrations/claude-code/types.js").ClaudeCodeSettings;
   cursor?: import("../../integrations/cursor/types.js").CursorSettings;
+  active_theme?: string;
+  custom_themes?: ThemeDefinition[];
 }
 
 export interface HumanEntity {
@@ -152,6 +162,9 @@ export interface PersonaEntity {
   tools?: string[];              // IDs of ToolDefinitions this persona can use. Empty/absent = no tool access.
   reflection_last_asked?: string;   // ISO timestamp. Set ONLY when Persona explicitly surfaces identity drift (mentioned_reflection: true).
   description_embedding?: number[]; // Embedding of long_description (short_description fallback). Excludes traits. See embedding-service.ts:getPersonaDescriptionText.
+  avatar_emoji?: string;            // Single emoji character used as avatar in place of initials.
+  avatar_image?: string;            // Base64-encoded 64×64 image used as avatar (takes priority over avatar_emoji).
+  preferred_theme?: string;         // Theme ID (built-in name or ThemeDefinition.id). Applied to chat panel when this persona is active.
 }
 
 export interface PersonaCreationInput {

package/src/core/types/integrations.ts

@@ -56,6 +56,9 @@ export interface PersonaSummary {
   unread_count: number;
   last_activity?: string;
   context_boundary?: string;
+  avatar_emoji?: string;
+  avatar_image?: string;
+  preferred_theme?: string;
 }
 
 export interface MessageQueryOptions {

package/src/core/utils/identifier-utils.ts

@@ -1,8 +1,32 @@
 import type { PersonIdentifier } from "../types/data-items.js";
 import type { StateManager } from "../state-manager.js";
+import { BUILT_IN_IDENTIFIER_TYPES } from "../constants/built-in-identifier-types.js";
 
 export const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 
+function toNormalizedKey(s: string): string {
+  return s.replace(/[^a-z0-9]/gi, '').toLowerCase();
+}
+
+// Fuzzy-matches LLM-provided type against built-in + in-use types (strip non-alphanumeric, lowercase).
+// "nickname" -> "Nickname", "full_name" -> "Full Name", "EMAIL" -> "Email", "Slack RNP" -> "Slack RNP" (custom, no match)
+export function normalizeIdentifierType(llmType: string, state: StateManager): string {
+  const inUseTypes = state.getHuman().people.flatMap(p =>
+    (p.identifiers ?? []).map(i => i.type)
+  );
+
+  const canonicalMap = new Map<string, string>();
+  for (const t of [...BUILT_IN_IDENTIFIER_TYPES, ...inUseTypes]) {
+    const key = toNormalizedKey(t);
+    if (!canonicalMap.has(key)) {
+      canonicalMap.set(key, t);
+    }
+  }
+
+  const normalized = toNormalizedKey(llmType);
+  return canonicalMap.get(normalized) ?? llmType;
+}
+
 export function sanitizeEiPersonaIdentifiers(
   identifiers: PersonIdentifier[],
   state: StateManager

package/src/core/utils/theme-codec.ts

@@ -0,0 +1,78 @@
+import type { ThemeDefinition } from "../types/entities.js";
+
+const VERSION = "v1";
+const PREFIX = `ei-theme:${VERSION}:`;
+const TOKEN_COUNT = 37;
+const HEX_LENGTH = 6;
+
+export const THEME_TOKEN_ORDER: readonly string[] = [
+  "bg-primary", "bg-secondary", "bg-tertiary",
+  "border", "border-light",
+  "text-primary", "text-secondary", "text-muted",
+  "accent", "accent-hover",
+  "success", "success-hover",
+  "warning", "warning-text",
+  "danger",
+  "status-thinking", "status-ready", "status-unread", "status-paused",
+  "room-cyp", "room-ffa", "room-map",
+  "archive-bg-start", "archive-bg-end", "archive-border",
+  "ai-assist-start", "ai-assist-end",
+  "code-bg", "code-bg-controls", "code-border",
+  "code-text", "code-text-muted",
+  "code-accent", "code-string", "code-error", "code-success", "code-special",
+] as const;
+
+export const BUILT_IN_THEME_NAMES: readonly string[] = [
+  "default", "dark", "coder", "depressing", "cotton-candy",
+  "crimuh", "spoopy", "lovey-dovey", "lucky",
+] as const;
+
+export type ThemeTokenMap = Record<string, string>;
+
+export function encodeTheme(tokens: ThemeTokenMap): string {
+  const hex = THEME_TOKEN_ORDER.map((key) => {
+    const value = tokens[`--ei-${key}`] ?? tokens[key] ?? "000000";
+    return value.replace(/^#/, "").toLowerCase().padEnd(HEX_LENGTH, "0").slice(0, HEX_LENGTH);
+  }).join("");
+  return PREFIX + btoa(hex);
+}
+
+export function decodeTheme(encoded: string): ThemeTokenMap | null {
+  if (!encoded.startsWith(PREFIX)) return null;
+  try {
+    const hex = atob(encoded.slice(PREFIX.length));
+    if (hex.length !== TOKEN_COUNT * HEX_LENGTH) return null;
+    const tokens: ThemeTokenMap = {};
+    for (let i = 0; i < TOKEN_COUNT; i++) {
+      const key = THEME_TOKEN_ORDER[i];
+      tokens[`--ei-${key}`] = `#${hex.slice(i * HEX_LENGTH, (i + 1) * HEX_LENGTH)}`;
+    }
+    return tokens;
+  } catch {
+    return null;
+  }
+}
+
+export function themeToStyleString(tokens: ThemeTokenMap): string {
+  return Object.entries(tokens)
+    .map(([k, v]) => `  ${k}: ${v};`)
+    .join("\n");
+}
+
+export function isBuiltInTheme(id: string): boolean {
+  return (BUILT_IN_THEME_NAMES as readonly string[]).includes(id);
+}
+
+export function makeThemeDefinition(
+  name: string,
+  tokens: ThemeTokenMap,
+  base?: string,
+): ThemeDefinition {
+  return {
+    id: crypto.randomUUID(),
+    name,
+    base,
+    encoded: encodeTheme(tokens),
+    created_at: new Date().toISOString(),
+  };
+}