@smyslenny/agent-memory 4.0.0-alpha.1 → 4.1.0-alpha.1

package/dist/index.d.ts

@@ -38,6 +38,7 @@ interface Memory {
     source: string | null;
     agent_id: string;
     hash: string | null;
+    emotion_tag: string | null;
 }
 interface CreateMemoryInput {
     content: string;
@@ -47,6 +48,7 @@ interface CreateMemoryInput {
     source?: string;
     agent_id?: string;
     embedding_provider_id?: string | null;
+    emotion_tag?: string;
 }
 interface UpdateMemoryInput {
     content?: string;
@@ -57,6 +59,7 @@ interface UpdateMemoryInput {
     stability?: number;
     source?: string;
     embedding_provider_id?: string | null;
+    emotion_tag?: string | null;
 }
 declare function contentHash(content: string): string;
 declare function createMemory(db: Database.Database, input: CreateMemoryInput): Memory | null;
@@ -70,6 +73,7 @@ declare function listMemories(db: Database.Database, opts?: {
     min_vitality?: number;
     limit?: number;
     offset?: number;
+    emotion_tag?: string;
 }): Memory[];
 declare function recordAccess(db: Database.Database, id: string, growthFactor?: number): void;
 declare function countMemories(db: Database.Database, agent_id?: string): {
@@ -88,6 +92,7 @@ interface SyncInput {
     agent_id?: string;
     provider?: EmbeddingProvider | null;
     conservative?: boolean;
+    emotion_tag?: string;
 }
 interface SyncResult {
     action: "added" | "updated" | "merged" | "skipped";
@@ -115,6 +120,7 @@ interface RememberInput {
     agent_id?: string;
     provider?: EmbeddingProvider | null;
     conservative?: boolean;
+    emotion_tag?: string;
 }
 declare function rememberMemory(db: Database.Database, input: RememberInput): Promise<SyncResult>;
 
@@ -258,6 +264,7 @@ interface RecallInput {
     vectorLimit?: number;
     provider?: EmbeddingProvider | null;
     recordAccess?: boolean;
+    emotion_tag?: string;
 }
 declare function recallMemory(db: Database.Database, input: RecallInput): Promise<HybridRecallResponse>;
 
@@ -294,6 +301,7 @@ interface SurfaceInput {
     agent_id?: string;
     provider?: EmbeddingProvider | null;
     min_vitality?: number;
+    emotion_tag?: string;
 }
 interface SurfaceResult {
     memory: Memory;
@@ -713,13 +721,47 @@ interface BootResult {
     identityMemories: Memory[];
     bootPaths: string[];
 }
+interface WarmBootOptions {
+    agent_id?: string;
+    corePaths?: string[];
+    format?: "json" | "narrative";
+    agent_name?: string;
+}
+interface WarmBootResult extends BootResult {
+    narrative?: string;
+    layers?: {
+        identity: Memory[];
+        emotion: Memory[];
+        event: Memory[];
+        knowledge: Memory[];
+    };
+}
 /**
- * Load core identity memories at startup.
+ * Format a relative time string from an ISO date.
+ */
+declare function formatRelativeDate(isoDate: string): string;
+/**
+ * Load layered memories for warm boot.
+ */
+declare function loadWarmBootLayers(db: Database.Database, agentId: string): {
+    identity: Memory[];
+    emotion: Memory[];
+    event: Memory[];
+    knowledge: Memory[];
+};
+/**
+ * Format layered memories as narrative Markdown.
+ */
+declare function formatNarrativeBoot(layers: {
+    identity: Memory[];
+    emotion: Memory[];
+    event: Memory[];
+    knowledge: Memory[];
+}, agentName: string): string;
+/**
+ * Load core identity memories at startup (legacy JSON format).
  * Returns all P0 (identity) memories + any memories referenced by system://boot.
  */
-declare function boot(db: Database.Database, opts?: {
-    agent_id?: string;
-    corePaths?: string[];
-}): BootResult;
+declare function boot(db: Database.Database, opts?: WarmBootOptions): WarmBootResult;
 
-export { type AgentMemoryHttpServer, type ReflectInput as AppReflectInput, type ReflectProgressEvent as AppReflectProgressEvent, type AutoIngestWatcher, type AutoIngestWatcherOptions, type BootResult, type CreateMemoryInput, type DedupScoreBreakdown, type EmbeddingProvider, type EmbeddingProviderConfig, type EmbeddingProviderKind, type EmbeddingProviderOptions, type EmbeddingStatus, type EvictionCandidate, type ExportResult, type FeedbackEventInput, type FeedbackEventRecord, type FeedbackSource, type FeedbackSummary, type GovernResult, type GuardAction, type GuardInput, type GuardResult, type HttpJobStatus, type HttpServerOptions, type HybridRecallResponse, type HybridRecallResult, type IngestExtractedItem, type IngestResult, type IngestRunOptions, type MaintenanceJob, type MaintenancePhase, type MaintenanceStatus, type Memory, type MemoryType, type MergeContext, type MergePlan, type Path, type PendingEmbeddingRecord, type Priority, type RecallInput, type ReflectCheckpoint, type ReflectOptions, type ReflectProgressEvent$1 as ReflectProgressEvent, type ReflectRunResult, type ReflectRunners, type ReflectStats, type ReflectStep, type ReindexEmbeddingsResult, type ReindexInput, type ReindexProgressEvent, type ReindexSearchResult, type RememberInput, type SearchResult, type StatusResult, type StoredEmbedding, type SurfaceInput, type SurfaceIntent, type SurfaceResponse, type SurfaceResult, type SyncInput, type SyncResult, type TidyResult, type UpdateMemoryInput, type VectorSearchResult, boot, buildFtsQuery, buildMergePlan, calculateVitality, classifyIngestType, completeMaintenanceJob, computeEvictionScore, contentHash, cosineSimilarity, countMemories, createEmbeddingProvider, createHttpServer, createInitialCheckpoint, createLocalHttpEmbeddingProvider, createMaintenanceJob, createMemory, createOpenAICompatibleEmbeddingProvider, createPath, decodeVector, deleteMemory, deletePath, encodeVector, exportMemories, extractIngestItems, failMaintenanceJob, findResumableMaintenanceJob, fuseHybridResults, fusionScore, getConfiguredEmbeddingProviderId, getDecayedMemories, getEmbedding, getEmbeddingProvider, getEmbeddingProviderConfigFromEnv, getEmbeddingProviderFromEnv, getFeedbackScore, getFeedbackSummary, getMaintenanceJob, getMemory, getMemoryStatus, getPath, getPathByUri, getPathsByDomain, getPathsByMemory, getPathsByPrefix, guard, healthcheckEmbeddingProvider, ingestText, listMemories, listPendingEmbeddings, markAllEmbeddingsPending, markEmbeddingFailed, markMemoryEmbeddingPending, parseUri, priorityPrior, rankEvictionCandidates, rebuildBm25Index, recallMemories, recallMemory, recordAccess, recordFeedbackEvent, reflectMemories, reindexEmbeddings, reindexMemories, reindexMemorySearch, rememberMemory, runAutoIngestWatcher, runDecay, runGovern, runReflectOrchestrator, runTidy, searchBM25, searchByVector, slugify, splitIngestBlocks, startHttpServer, surfaceMemories, syncBatch, syncOne, tokenize, updateMaintenanceCheckpoint, updateMemory, upsertReadyEmbedding };
+export { type AgentMemoryHttpServer, type ReflectInput as AppReflectInput, type ReflectProgressEvent as AppReflectProgressEvent, type AutoIngestWatcher, type AutoIngestWatcherOptions, type BootResult, type CreateMemoryInput, type DedupScoreBreakdown, type EmbeddingProvider, type EmbeddingProviderConfig, type EmbeddingProviderKind, type EmbeddingProviderOptions, type EmbeddingStatus, type EvictionCandidate, type ExportResult, type FeedbackEventInput, type FeedbackEventRecord, type FeedbackSource, type FeedbackSummary, type GovernResult, type GuardAction, type GuardInput, type GuardResult, type HttpJobStatus, type HttpServerOptions, type HybridRecallResponse, type HybridRecallResult, type IngestExtractedItem, type IngestResult, type IngestRunOptions, type MaintenanceJob, type MaintenancePhase, type MaintenanceStatus, type Memory, type MemoryType, type MergeContext, type MergePlan, type Path, type PendingEmbeddingRecord, type Priority, type RecallInput, type ReflectCheckpoint, type ReflectOptions, type ReflectProgressEvent$1 as ReflectProgressEvent, type ReflectRunResult, type ReflectRunners, type ReflectStats, type ReflectStep, type ReindexEmbeddingsResult, type ReindexInput, type ReindexProgressEvent, type ReindexSearchResult, type RememberInput, type SearchResult, type StatusResult, type StoredEmbedding, type SurfaceInput, type SurfaceIntent, type SurfaceResponse, type SurfaceResult, type SyncInput, type SyncResult, type TidyResult, type UpdateMemoryInput, type VectorSearchResult, type WarmBootOptions, type WarmBootResult, boot, buildFtsQuery, buildMergePlan, calculateVitality, classifyIngestType, completeMaintenanceJob, computeEvictionScore, contentHash, cosineSimilarity, countMemories, createEmbeddingProvider, createHttpServer, createInitialCheckpoint, createLocalHttpEmbeddingProvider, createMaintenanceJob, createMemory, createOpenAICompatibleEmbeddingProvider, createPath, decodeVector, deleteMemory, deletePath, encodeVector, exportMemories, extractIngestItems, failMaintenanceJob, findResumableMaintenanceJob, formatNarrativeBoot, formatRelativeDate, fuseHybridResults, fusionScore, getConfiguredEmbeddingProviderId, getDecayedMemories, getEmbedding, getEmbeddingProvider, getEmbeddingProviderConfigFromEnv, getEmbeddingProviderFromEnv, getFeedbackScore, getFeedbackSummary, getMaintenanceJob, getMemory, getMemoryStatus, getPath, getPathByUri, getPathsByDomain, getPathsByMemory, getPathsByPrefix, guard, healthcheckEmbeddingProvider, ingestText, listMemories, listPendingEmbeddings, loadWarmBootLayers, markAllEmbeddingsPending, markEmbeddingFailed, markMemoryEmbeddingPending, parseUri, priorityPrior, rankEvictionCandidates, rebuildBm25Index, recallMemories, recallMemory, recordAccess, recordFeedbackEvent, reflectMemories, reindexEmbeddings, reindexMemories, reindexMemorySearch, rememberMemory, runAutoIngestWatcher, runDecay, runGovern, runReflectOrchestrator, runTidy, searchBM25, searchByVector, slugify, splitIngestBlocks, startHttpServer, surfaceMemories, syncBatch, syncOne, tokenize, updateMaintenanceCheckpoint, updateMemory, upsertReadyEmbedding };

package/dist/index.js

@@ -6,7 +6,7 @@ import { createHash as createHash2 } from "crypto";
 // src/core/db.ts
 import Database from "better-sqlite3";
 import { randomUUID } from "crypto";
-var SCHEMA_VERSION = 5;
+var SCHEMA_VERSION = 6;
 var SCHEMA_SQL = `
 -- Memory entries
 CREATE TABLE IF NOT EXISTS memories (
@@ -24,6 +24,7 @@ CREATE TABLE IF NOT EXISTS memories (
   source        TEXT,
   agent_id      TEXT NOT NULL DEFAULT 'default',
   hash          TEXT,
+  emotion_tag   TEXT,
   UNIQUE(hash, agent_id)
 );
 
@@ -199,6 +200,11 @@ function migrateDatabase(db, from, to) {
       v = 5;
       continue;
     }
+    if (v === 5) {
+      migrateV5ToV6(db);
+      v = 6;
+      continue;
+    }
     throw new Error(`Unsupported schema migration path: v${from} \u2192 v${to} (stuck at v${v})`);
   }
 }
@@ -284,6 +290,8 @@ function inferSchemaVersion(db) {
   const hasV4Embeddings = hasEmbeddings && tableHasColumn(db, "embeddings", "provider_id") && tableHasColumn(db, "embeddings", "status") && tableHasColumn(db, "embeddings", "content_hash") && tableHasColumn(db, "embeddings", "id");
   const hasMaintenanceJobs = tableExists(db, "maintenance_jobs");
   const hasFeedbackEvents = tableExists(db, "feedback_events");
+  const hasEmotionTag = tableHasColumn(db, "memories", "emotion_tag");
+  if (hasAgentScopedPaths && hasAgentScopedLinks && hasV4Embeddings && hasMaintenanceJobs && hasFeedbackEvents && hasEmotionTag) return 6;
   if (hasAgentScopedPaths && hasAgentScopedLinks && hasV4Embeddings && hasMaintenanceJobs && hasFeedbackEvents) return 5;
   if (hasAgentScopedPaths && hasAgentScopedLinks && hasV4Embeddings) return 4;
   if (hasAgentScopedPaths && hasAgentScopedLinks && hasEmbeddings) return 3;
@@ -310,6 +318,9 @@ function ensureIndexes(db) {
   if (tableExists(db, "maintenance_jobs")) {
     db.exec("CREATE INDEX IF NOT EXISTS idx_maintenance_jobs_phase_status ON maintenance_jobs(phase, status, started_at DESC);");
   }
+  if (tableHasColumn(db, "memories", "emotion_tag")) {
+    db.exec("CREATE INDEX IF NOT EXISTS idx_memories_emotion_tag ON memories(emotion_tag) WHERE emotion_tag IS NOT NULL;");
+  }
   if (tableExists(db, "feedback_events")) {
     db.exec("CREATE INDEX IF NOT EXISTS idx_feedback_events_memory ON feedback_events(memory_id, created_at DESC);");
     if (tableHasColumn(db, "feedback_events", "agent_id") && tableHasColumn(db, "feedback_events", "source")) {
@@ -443,6 +454,25 @@ function migrateV4ToV5(db) {
     throw e;
   }
 }
+function migrateV5ToV6(db) {
+  if (tableHasColumn(db, "memories", "emotion_tag")) {
+    db.prepare("INSERT OR REPLACE INTO schema_meta (key, value) VALUES ('version', ?)").run(String(6));
+    return;
+  }
+  try {
+    db.exec("BEGIN");
+    db.exec("ALTER TABLE memories ADD COLUMN emotion_tag TEXT;");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_memories_emotion_tag ON memories(emotion_tag) WHERE emotion_tag IS NOT NULL;");
+    db.prepare("INSERT OR REPLACE INTO schema_meta (key, value) VALUES ('version', ?)").run(String(6));
+    db.exec("COMMIT");
+  } catch (e) {
+    try {
+      db.exec("ROLLBACK");
+    } catch {
+    }
+    throw e;
+  }
+}
 
 // src/search/tokenizer.ts
 import { readFileSync } from "fs";
@@ -942,8 +972,8 @@ function createMemory(db, input) {
   const timestamp = now();
   db.prepare(
     `INSERT INTO memories (id, content, type, priority, emotion_val, vitality, stability,
-     access_count, created_at, updated_at, source, agent_id, hash)
-     VALUES (?, ?, ?, ?, ?, 1.0, ?, 0, ?, ?, ?, ?, ?)`
+     access_count, created_at, updated_at, source, agent_id, hash, emotion_tag)
+     VALUES (?, ?, ?, ?, ?, 1.0, ?, 0, ?, ?, ?, ?, ?, ?)`
   ).run(
     id,
     input.content,
@@ -955,7 +985,8 @@ function createMemory(db, input) {
     timestamp,
     input.source ?? null,
     agentId,
-    hash
+    hash,
+    input.emotion_tag ?? null
   );
   db.prepare("INSERT INTO memories_fts (id, content) VALUES (?, ?)").run(id, tokenizeForIndex(input.content));
   markEmbeddingDirtyIfNeeded(db, id, hash, resolveEmbeddingProviderId(input.embedding_provider_id));
@@ -999,6 +1030,10 @@ function updateMemory(db, id, input) {
     fields.push("source = ?");
     values.push(input.source);
   }
+  if (input.emotion_tag !== void 0) {
+    fields.push("emotion_tag = ?");
+    values.push(input.emotion_tag);
+  }
   fields.push("updated_at = ?");
   values.push(now());
   values.push(id);
@@ -1040,6 +1075,10 @@ function listMemories(db, opts) {
     conditions.push("vitality >= ?");
     params.push(opts.min_vitality);
   }
+  if (opts?.emotion_tag) {
+    conditions.push("emotion_tag = ?");
+    params.push(opts.emotion_tag);
+  }
   const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
   const limit = opts?.limit ?? 100;
   const offset = opts?.offset ?? 0;
@@ -1703,7 +1742,8 @@ async function syncOne(db, input) {
     agent_id: input.agent_id,
     uri: input.uri,
     provider: input.provider,
-    conservative: input.conservative
+    conservative: input.conservative,
+    emotion_tag: input.emotion_tag
   };
   const guardResult = await guard(db, memInput);
   switch (guardResult.action) {
@@ -1752,21 +1792,26 @@ async function rememberMemory(db, input) {
     source: input.source,
     agent_id: input.agent_id,
     provider: input.provider,
-    conservative: input.conservative
+    conservative: input.conservative,
+    emotion_tag: input.emotion_tag
   });
 }
 
 // src/app/recall.ts
 async function recallMemory(db, input) {
-  return recallMemories(db, input.query, {
+  const result = await recallMemories(db, input.query, {
     agent_id: input.agent_id,
-    limit: input.limit,
+    limit: input.emotion_tag ? (input.limit ?? 10) * 3 : input.limit,
     min_vitality: input.min_vitality,
     lexicalLimit: input.lexicalLimit,
     vectorLimit: input.vectorLimit,
     provider: input.provider,
     recordAccess: input.recordAccess
   });
+  if (input.emotion_tag) {
+    result.results = result.results.filter((r) => r.memory.emotion_tag === input.emotion_tag).slice(0, input.limit ?? 10);
+  }
+  return result;
 }
 
 // src/app/feedback.ts
@@ -2043,7 +2088,7 @@ async function surfaceMemories(db, input) {
       signals.set(memory.id, { memory });
     }
   }
-  const results = [...signals.values()].map((signal) => signal.memory).filter((memory) => memory.vitality >= minVitality).filter((memory) => input.types?.length ? input.types.includes(memory.type) : true).map((memory) => {
+  const results = [...signals.values()].map((signal) => signal.memory).filter((memory) => memory.vitality >= minVitality).filter((memory) => input.types?.length ? input.types.includes(memory.type) : true).filter((memory) => input.emotion_tag ? memory.emotion_tag === input.emotion_tag : true).map((memory) => {
     const signal = signals.get(memory.id) ?? { memory };
     const memoryTokens = new Set(tokenize(memory.content));
     const lexicalOverlap = overlapScore2(memoryTokens, queryTokens);
@@ -3307,8 +3352,68 @@ function runAutoIngestWatcher(options) {
 }
 
 // src/sleep/boot.ts
+function formatRelativeDate(isoDate) {
+  const diffMs = Date.now() - new Date(isoDate).getTime();
+  const diffDays = Math.floor(diffMs / 864e5);
+  if (diffDays <= 0) return "\u4ECA\u5929";
+  if (diffDays === 1) return "\u6628\u5929";
+  if (diffDays <= 7) return `${diffDays}\u5929\u524D`;
+  return isoDate.slice(0, 10);
+}
+function loadWarmBootLayers(db, agentId) {
+  const identity = listMemories(db, { agent_id: agentId, type: "identity", limit: 50 });
+  const emotion = listMemories(db, { agent_id: agentId, type: "emotion", limit: 5 });
+  const event = listMemories(db, { agent_id: agentId, type: "event", limit: 7 });
+  const knowledge = listMemories(db, {
+    agent_id: agentId,
+    type: "knowledge",
+    min_vitality: 0.5,
+    limit: 10
+  });
+  return { identity, emotion, event, knowledge };
+}
+function formatNarrativeBoot(layers, agentName) {
+  const lines = [];
+  lines.push(`# ${agentName}\u7684\u56DE\u5FC6`);
+  lines.push("");
+  if (layers.identity.length > 0) {
+    lines.push("## \u6211\u662F\u8C01");
+    for (const mem of layers.identity) {
+      lines.push(`- ${mem.content.split("\n")[0].slice(0, 200)}`);
+    }
+    lines.push("");
+  }
+  if (layers.emotion.length > 0) {
+    lines.push("## \u6700\u8FD1\u7684\u5FC3\u60C5");
+    for (const mem of layers.emotion) {
+      const tag = mem.emotion_tag;
+      const time = formatRelativeDate(mem.updated_at);
+      const tagStr = tag ? `${tag}, ${time}` : time;
+      lines.push(`- ${mem.content.split("\n")[0].slice(0, 200)} (${tagStr})`);
+    }
+    lines.push("");
+  }
+  if (layers.event.length > 0) {
+    lines.push("## \u6700\u8FD1\u53D1\u751F\u7684\u4E8B");
+    for (const mem of layers.event) {
+      const time = formatRelativeDate(mem.updated_at);
+      lines.push(`- ${mem.content.split("\n")[0].slice(0, 200)} (${time})`);
+    }
+    lines.push("");
+  }
+  if (layers.knowledge.length > 0) {
+    lines.push("## \u8FD8\u8BB0\u5F97\u7684\u77E5\u8BC6");
+    for (const mem of layers.knowledge) {
+      lines.push(`- ${mem.content.split("\n")[0].slice(0, 200)}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
 function boot(db, opts) {
   const agentId = opts?.agent_id ?? "default";
+  const format = opts?.format ?? "json";
+  const agentName = opts?.agent_name ?? "Agent";
   const corePaths = opts?.corePaths ?? [
     "core://agent",
     "core://user",
@@ -3352,10 +3457,16 @@ function boot(db, opts) {
       }
     }
   }
-  return {
+  const result = {
     identityMemories: [...memories.values()],
     bootPaths
   };
+  if (format === "narrative") {
+    const layers = loadWarmBootLayers(db, agentId);
+    result.layers = layers;
+    result.narrative = formatNarrativeBoot(layers, agentName);
+  }
+  return result;
 }
 export {
   boot,
@@ -3384,6 +3495,8 @@ export {
   extractIngestItems,
   failMaintenanceJob,
   findResumableMaintenanceJob,
+  formatNarrativeBoot,
+  formatRelativeDate,
   fuseHybridResults,
   fusionScore,
   getConfiguredEmbeddingProviderId,
@@ -3408,6 +3521,7 @@ export {
   isCountRow,
   listMemories,
   listPendingEmbeddings,
+  loadWarmBootLayers,
   markAllEmbeddingsPending,
   markEmbeddingFailed,
   markMemoryEmbeddingPending,