@molroo-io/sdk 0.6.2 → 0.7.1

package/dist/esm/memory/types.d.ts

@@ -1,209 +1,74 @@
 import type { Episode, VAD } from '../types';
 export type { Episode, VAD };
 /**
- * Single-interface memory adapter for the SDK.
+ * Memory adapter for advanced memory features.
  *
- * Duck-type compatible with `@molroo-io/persona`'s `MemoryAdapter`.
- * Implementations (SqliteMemoryAdapter, SupabaseMemoryAdapter, etc.) provide
- * a single object that handles episode storage, recall, and optionally
- * semantic/vector search internally.
+ * For simple use cases, manage conversation history externally using
+ * the `updatedHistory` returned from `chat()`.
+ *
+ * For advanced features (semantic search, reflections, emotion-aware storage),
+ * implement this interface.
  *
  * @example
  * ```typescript
- * import { MolrooPersona } from '@molroo-io/sdk';
+ * class MyPostgresAdapter implements MemoryAdapter {
+ *   async saveEpisode(episode: Episode): Promise<void> {
+ *     await db.query('INSERT INTO episodes ...', [episode]);
+ *   }
+ *
+ *   async recall(query: RecallQuery): Promise<Episode[]> {
+ *     return db.query('SELECT * FROM episodes WHERE ...', [query.sourceEntity]);
+ *   }
  *
- * const persona = await MolrooPersona.create({
- *   baseUrl: 'https://api.molroo.io',
- *   apiKey: 'key',
- *   llm,
- *   memory: myMemoryAdapter,
- * });
+ *   // Optional: semantic search with vector DB
+ *   async semanticRecall(query: string, options?: SemanticRecallOptions): Promise<Episode[]> {
+ *     const embedding = await openai.embed(query);
+ *     return vectorDB.search(embedding, options?.topK ?? 5);
+ *   }
+ * }
  * ```
  */
 export interface MemoryAdapter {
-    /** Save an episode returned by the API's AgentResponse. */
+    /** Save an episode with emotion metadata. */
     saveEpisode(episode: Episode): Promise<void>;
-    /**
-     * Recall relevant episodes by structured query.
-     * Accepts both SDK `RecallQuery` and `EpisodeQuery` shapes.
-     */
+    /** Recall episodes by structured query (filters). */
     recall(query: RecallQuery): Promise<Episode[]>;
-    /** Save a reflection generated by LLM. Optional — omit for episode-only storage. */
+    /** Semantic similarity search (optional). Requires vector DB. */
+    semanticRecall?(query: string, options?: SemanticRecallOptions): Promise<Episode[]>;
+    /** Save a reflection (optional). */
     saveReflection?(reflection: Reflection): Promise<void>;
-    /** Retrieve reflections for a source entity. Optional. */
+    /** Get reflections for a source (optional). */
     getReflections?(sourceEntity?: string): Promise<Reflection[]>;
-    /**
-     * Vector/semantic similarity search. Optional.
-     * When provided, the adapter handles embedding internally — no separate
-     * EmbeddingAdapter needed.
-     */
-    semanticRecall?(query: string, options?: SemanticRecallOptions): Promise<Episode[]>;
-    /** Retrieve episodes by IDs. Optional — used for hydrating search results. */
+    /** Retrieve episodes by IDs (optional). */
     getByIds?(ids: string[]): Promise<Episode[]>;
 }
-/**
- * Query for recalling episodes from a MemoryAdapter.
- *
- * Compatible with both persona engine's `RecallQuery` (`context` field)
- * and the SDK's `EpisodeQuery` (`contextContains` field).
- */
+/** Query for recalling episodes. */
 export interface RecallQuery {
     /** Filter by source entity name. */
     sourceEntity?: string;
-    /** Search keyword or vector query text (persona engine compatibility). */
+    /** Search keyword or context text. */
     context?: string;
-    /** Max episodes to return. Default: implementation-specific. */
+    /** Max episodes to return. */
     limit?: number;
-    /** Minimum importance score to include. */
+    /** Minimum importance score (0-1). */
     minImportance?: number;
     /** Epoch ms range [from, to]. */
     timeRange?: [number, number];
-    /** Filter by episode type. Single string or array (OR match). */
+    /** Filter by episode type. */
     type?: string | string[];
     /** Valence range [min, max]. */
     valenceRange?: [number, number];
 }
 /** Options for semantic/vector recall. */
 export interface SemanticRecallOptions {
-    /** Number of results to return. Default: 5. */
+    /** Number of results. Default: 5. */
     topK?: number;
-    /** Minimum similarity score to include. */
+    /** Minimum similarity score (0-1). */
     minScore?: number;
-    /** Additional structured filters. */
-    filter?: Partial<RecallQuery>;
-}
-/** Recall limit configuration, extracted for reuse. */
-export interface RecallLimits {
-    /** Max episodic memories per recall. Default: 5. */
-    episodicLimit?: number;
-    /** Max semantic results per recall. Default: 3. */
-    semanticLimit?: number;
-    /** Max reflections per recall. Default: 3. */
-    reflectionLimit?: number;
-    /** Minimum importance threshold. Default: 0. */
+    /** Minimum importance threshold. */
     minImportance?: number;
 }
-/**
- * Type guard: returns true if the memory config is a `MemoryConfig` (split adapters),
- * false if it's a `MemoryAdapter` (single adapter).
- *
- * Discriminates by checking for `saveEpisode` — present on MemoryAdapter, absent on MemoryConfig.
- */
-export declare function isMemoryConfig(m: MemoryAdapter | MemoryConfig): m is MemoryConfig;
-/**
- * EpisodeAdapter — RDB-backed structured episode storage.
- *
- * Required adapter for the split `MemoryConfig` approach. Handles saving and
- * recalling episodic memories (conversation episodes + reflections).
- *
- * Implementations: InMemoryEpisodeAdapter (built-in), or consumer-provided
- * (SQLite, PostgreSQL, Supabase, etc.).
- */
-export interface EpisodeAdapter {
-    /** Save an episode returned by the API's AgentResponse. */
-    saveEpisode(episode: Episode): Promise<void>;
-    /** Recall relevant episodes by structured query (time-ordered). */
-    recall(query: EpisodeQuery): Promise<Episode[]>;
-    /** Retrieve episodes by IDs — used for hydrating SemanticStore results. */
-    getByIds?(ids: string[]): Promise<Episode[]>;
-    /** Save a reflection generated by LLM. */
-    saveReflection(reflection: Reflection): Promise<void>;
-    /** Retrieve reflections for a source entity. */
-    getReflections(sourceEntity?: string, limit?: number): Promise<Reflection[]>;
-}
-/** Structured query for episodic recall (RDB-style filtering). */
-export interface EpisodeQuery {
-    /** Filter by source entity name. */
-    sourceEntity?: string;
-    /** LIKE search on episode context (not semantic). */
-    contextContains?: string;
-    /** Filter by episode type. Single string or array (OR match). */
-    type?: string | string[];
-    /** Max episodes to return. Default: 10. */
-    limit?: number;
-    /** Minimum importance score to include. */
-    minImportance?: number;
-    /** Epoch ms range [from, to]. */
-    timeRange?: [number, number];
-    /** Valence range [min, max]. */
-    valenceRange?: [number, number];
-}
-/**
- * SemanticAdapter — Vector DB-backed semantic search.
- *
- * Optional adapter for similarity-based memory recall.
- * Requires an EmbeddingAdapter to be configured alongside.
- *
- * Implementations: consumer-provided (Pinecone, pgvector, ChromaDB, etc.).
- */
-export interface SemanticAdapter {
-    /** Index a semantic entry (episode or reflection embedding). */
-    index(entry: SemanticEntry): Promise<void>;
-    /** Search for semantically similar entries. */
-    search(query: SemanticQuery): Promise<SemanticResult[]>;
-}
-/** Entry to index in the vector store. */
-export interface SemanticEntry {
-    id: string;
-    embedding: number[];
-    metadata: {
-        type: 'episode' | 'reflection';
-        sourceEntity?: string;
-        timestamp: number;
-        importance?: number;
-        /** Episode type tag (e.g. 'chat_message', 'attack', 'gift'). */
-        episodeType?: string;
-    };
-}
-/** Query for semantic similarity search. */
-export interface SemanticQuery {
-    embedding: number[];
-    /** Number of results to return. Default: 5. */
-    topK?: number;
-    filter?: {
-        type?: 'episode' | 'reflection';
-        sourceEntity?: string;
-        minImportance?: number;
-        /** Filter by episode type tag. */
-        episodeType?: string;
-    };
-}
-/** Result from semantic similarity search. */
-export interface SemanticResult {
-    id: string;
-    score: number;
-    metadata: SemanticEntry['metadata'];
-}
-/**
- * EmbeddingAdapter — generates vector embeddings from text.
- *
- * Required when using SemanticAdapter. Consumer provides their own
- * embedding model (OpenAI, Cohere, local, etc.).
- */
-export interface EmbeddingAdapter {
-    /** Generate an embedding vector from text. */
-    embed(text: string): Promise<number[]>;
-    /** Dimensionality of the embedding vectors. */
-    readonly dimension: number;
-}
-/**
- * MemoryConfig — split-adapter configuration for the SDK memory system.
- *
- * At minimum, provide an `episodes` adapter. Optionally add `semantic`
- * + `embedding` for similarity-based recall.
- *
- * For simpler setup, pass a single `MemoryAdapter` instead of `MemoryConfig`.
- */
-export interface MemoryConfig {
-    /** Required: structured episode storage (RDB-backed). */
-    episodes: EpisodeAdapter;
-    /** Optional: vector similarity search. Requires `embedding` to be set. */
-    semantic?: SemanticAdapter;
-    /** Optional: embedding adapter. Required when `semantic` is set. */
-    embedding?: EmbeddingAdapter;
-    /** Optional: recall tuning parameters. */
-    recall?: RecallLimits;
-}
+/** Reflection data structure. */
 export interface Reflection {
     id: string;
     timestamp: number;
@@ -212,20 +77,15 @@ export interface Reflection {
     trigger: string;
     emotionSnapshot: VAD;
 }
-/** @deprecated Use EpisodeAdapter */
-export type EpisodeStore = EpisodeAdapter;
-/** @deprecated Use SemanticAdapter */
-export type SemanticStore = SemanticAdapter;
-/** @deprecated Use EmbeddingAdapter */
-export type EmbeddingProvider = EmbeddingAdapter;
-export interface EpisodePatch {
-    importance?: number;
-    intensity?: number;
-    emotionSnapshot?: VAD;
-}
-export interface CountQuery {
-    sourceEntity?: string;
-    context?: string;
-    timeRange?: [number, number];
+/** Recall limit configuration. */
+export interface RecallLimits {
+    /** Max episodic memories. Default: 5. */
+    episodicLimit?: number;
+    /** Max semantic results. Default: 3. */
+    semanticLimit?: number;
+    /** Max reflections. Default: 3. */
+    reflectionLimit?: number;
+    /** Minimum importance threshold. Default: 0. */
+    minImportance?: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/esm/memory/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/memory/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE7C,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAE/C,iEAAiE;IACjE,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpF,oCAAoC;IACpC,cAAc,CAAC,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,+CAA+C;IAC/C,cAAc,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE9D,2CAA2C;IAC3C,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC9C;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,gCAAgC;IAChC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,GAAG,CAAC;CACtB;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/esm/memory/types.js

@@ -1,9 +1 @@
-/**
- * Type guard: returns true if the memory config is a `MemoryConfig` (split adapters),
- * false if it's a `MemoryAdapter` (single adapter).
- *
- * Discriminates by checking for `saveEpisode` — present on MemoryAdapter, absent on MemoryConfig.
- */
-export function isMemoryConfig(m) {
-    return !('saveEpisode' in m);
-}
+export {};

package/dist/esm/persona/chat-orchestrator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Chat orchestration: 3 modes (combined / split / tool-use).
+ *
+ * Extracted from MolrooPersona to reduce god-object complexity.
+ * All external dependencies are injected via ChatOrchestratorDeps.
+ */
+import type { LLMAdapter, Message } from '../llm/adapter';
+import type { AgentResponse, InterlocutorContext, PerceiveOptions } from '../types';
+import type { RecallLimits } from '../memory/types';
+import type { MemoryAdapter } from '../memory/types';
+import type { EventAdapter } from '../events/types';
+type PromptContextResult = {
+    systemPrompt: string;
+    personaPrompt: Record<string, unknown>;
+    tools?: Array<Record<string, unknown>>;
+};
+export interface ChatOrchestratorDeps {
+    personaId: string;
+    llm: LLMAdapter;
+    engineLlm: LLMAdapter | null;
+    memoryAdapter: MemoryAdapter | null;
+    memoryRecallConfig: RecallLimits | undefined;
+    events: EventAdapter | null;
+    getPromptContext: (consumerSuffix?: string, sourceEntity?: string) => Promise<PromptContextResult>;
+    perceive: (message: string, options?: PerceiveOptions) => Promise<AgentResponse>;
+    searchMemory: (query: string) => Promise<Array<Record<string, unknown>>>;
+}
+export interface ChatOptions {
+    from?: string | InterlocutorContext;
+    history?: Message[];
+    consumerSuffix?: string;
+    onToolCall?: (call: {
+        name: string;
+        args: Record<string, unknown>;
+        result: unknown;
+    }) => void;
+}
+export interface ChatResult {
+    text: string;
+    response: AgentResponse;
+    /** Updated conversation history including this turn. Manage externally for simple mode. */
+    updatedHistory: Message[];
+}
+export declare function chat(deps: ChatOrchestratorDeps, message: string, options?: ChatOptions): Promise<ChatResult>;
+export {};
+//# sourceMappingURL=chat-orchestrator.d.ts.map

package/dist/esm/persona/chat-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/persona/chat-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EACV,aAAa,EAGb,mBAAmB,EACnB,eAAe,EAChB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA+BpD,KAAK,mBAAmB,GAAG;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,kBAAkB,EAAE,YAAY,GAAG,SAAS,CAAC;IAC7C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnG,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACjF,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/F;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,2FAA2F;IAC3F,cAAc,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAmJlH"}

package/dist/esm/persona/chat-orchestrator.js

@@ -0,0 +1,204 @@
+import { recallMemories, buildMemoryBlock } from '../memory/recall';
+import { NEUTRAL_APPRAISAL } from '../shared/appraisal';
+import { postChat } from './memory-pipeline';
+/** Clamp appraisal values to engine-valid ranges after LLM generation. */
+function clampAppraisal(a) {
+    const c = (v, lo, hi) => Math.max(lo, Math.min(hi, v));
+    return {
+        goal_relevance: c(a.goal_relevance, -1, 1),
+        goal_congruence: c(a.goal_congruence, -1, 1),
+        expectedness: c(a.expectedness, 0, 1),
+        controllability: c(a.controllability, 0, 1),
+        agency: c(a.agency, -1, 1),
+        norm_compatibility: c(a.norm_compatibility, -1, 1),
+        internal_standards: c(a.internal_standards ?? 0, -1, 1),
+        adjustment_potential: c(a.adjustment_potential ?? 0.5, 0, 1),
+        urgency: c(a.urgency ?? 0.5, 0, 1),
+    };
+}
+/** Build a system prompt section describing the interlocutor. */
+function buildInterlocutorBlock(ctx) {
+    const parts = [`## About ${ctx.name}`];
+    if (ctx.description)
+        parts.push(ctx.description);
+    if (ctx.extensions) {
+        for (const [title, content] of Object.entries(ctx.extensions)) {
+            parts.push(`### ${title}`);
+            parts.push(content);
+        }
+    }
+    return parts.join('\n');
+}
+export async function chat(deps, message, options) {
+    const fromOption = options?.from ?? 'user';
+    const from = typeof fromOption === 'string' ? fromOption : fromOption.name;
+    const interlocutor = typeof fromOption === 'object' ? fromOption : null;
+    // 1. Fetch server-assembled system prompt
+    const ctx = await deps.getPromptContext(options?.consumerSuffix, from);
+    let systemPrompt = ctx.systemPrompt;
+    const hasTools = (ctx.tools?.length ?? 0) > 0;
+    // 2. Build messages (external history + user message)
+    const messages = [];
+    if (options?.history) {
+        messages.push(...options.history.map(h => ({ role: h.role, content: h.content })));
+    }
+    messages.push({ role: 'user', content: message });
+    // 3. Advanced memory recall (only if MemoryAdapter provided)
+    let memoryBlock = '';
+    let recalledEpisodes = [];
+    if (deps.memoryAdapter) {
+        const recalled = await recallMemories(message, deps.memoryAdapter, deps.memoryRecallConfig, from, deps.personaId);
+        recalledEpisodes = recalled.episodic;
+        if (interlocutor) {
+            systemPrompt += '\n\n' + buildInterlocutorBlock(interlocutor);
+        }
+        memoryBlock = buildMemoryBlock(recalled.episodic, recalled.semantic, recalled.reflections);
+        if (memoryBlock) {
+            systemPrompt += '\n\n' + memoryBlock;
+        }
+    }
+    else if (interlocutor) {
+        systemPrompt += '\n\n' + buildInterlocutorBlock(interlocutor);
+    }
+    let responseText;
+    let appraisal;
+    let earlyPerceiveResponse;
+    // Split mode: engineLlm handles appraisal, primary llm handles response text
+    if (deps.engineLlm && deps.engineLlm !== deps.llm) {
+        const { AppraisalVectorSchema } = await import('../llm/schema');
+        const appraisalInstruction = [
+            '',
+            '## Appraisal Task',
+            "Evaluate how RECEIVING the user's message affects this persona emotionally.",
+            'The event you are appraising is the message itself arriving — not the described situation.',
+            "When the user shares their own experience (e.g. loss, success), appraise through the persona's relational goals: caring about the speaker makes their suffering relevant and incongruent.",
+            "Rate each dimension from the persona's subjective perspective.",
+            'An insult should produce negative goal_congruence and norm_compatibility.',
+            'A compliment should produce positive values. Neutral small talk should be near zero.',
+        ].join('\n');
+        const appraisalMessages = messages.length <= 5 ? messages : messages.slice(-5);
+        const { object: appraisalResult } = await deps.engineLlm.generateObject({
+            system: systemPrompt + appraisalInstruction,
+            messages: appraisalMessages,
+            schema: AppraisalVectorSchema,
+        });
+        appraisal = clampAppraisal(appraisalResult);
+        earlyPerceiveResponse = await deps.perceive(message, {
+            from,
+            appraisal,
+            priorEpisodes: recalledEpisodes.length > 0 ? recalledEpisodes : undefined,
+            skipMemory: true,
+        });
+        let updatedPrompt = systemPrompt;
+        try {
+            const updatedCtx = await deps.getPromptContext(options?.consumerSuffix, from);
+            updatedPrompt = updatedCtx.systemPrompt;
+            if (interlocutor) {
+                updatedPrompt += '\n\n' + buildInterlocutorBlock(interlocutor);
+            }
+            if (memoryBlock) {
+                updatedPrompt += '\n\n' + memoryBlock;
+            }
+        }
+        catch {
+            // Use original prompt if updated fetch fails
+        }
+        const { text } = await deps.llm.generateText({
+            system: updatedPrompt,
+            messages,
+        });
+        responseText = text;
+    }
+    else if (hasTools) {
+        const result = await generateWithToolLoop(deps, systemPrompt, messages, options?.onToolCall);
+        responseText = result.text;
+        appraisal = clampAppraisal(result.appraisal);
+    }
+    else {
+        const { LLMResponseSchema } = await import('../llm/schema');
+        const { object: llmResult } = await deps.llm.generateObject({
+            system: systemPrompt,
+            messages,
+            schema: LLMResponseSchema,
+        });
+        responseText = llmResult.response;
+        appraisal = clampAppraisal(llmResult.appraisal ?? { ...NEUTRAL_APPRAISAL });
+    }
+    // 4. Send to API for emotion processing (skip if already done in split mode)
+    let response;
+    if (earlyPerceiveResponse) {
+        response = earlyPerceiveResponse;
+    }
+    else {
+        response = await deps.perceive(responseText, {
+            from,
+            appraisal: appraisal,
+            priorEpisodes: recalledEpisodes.length > 0 ? recalledEpisodes : undefined,
+            skipMemory: true,
+        });
+    }
+    response.text = responseText;
+    // 5. Advanced memory pipeline (fire-and-forget, only if adapter exists)
+    if (deps.memoryAdapter) {
+        const pipelineDeps = {
+            personaId: deps.personaId,
+            memoryAdapter: deps.memoryAdapter,
+            events: deps.events,
+            llm: deps.llm,
+            engineLlm: deps.engineLlm,
+        };
+        postChat(pipelineDeps, response);
+    }
+    // 6. Return updated history for external management
+    const updatedHistory = [
+        ...messages,
+        { role: 'assistant', content: responseText }
+    ];
+    return { text: responseText, response, updatedHistory };
+}
+async function generateWithToolLoop(deps, system, messages, onToolCall) {
+    const MAX_TOOL_ITERATIONS = 3;
+    const { LLMResponseWithToolsSchema, LLMResponseSchema } = await import('../llm/schema');
+    let currentSystem = system;
+    for (let iteration = 0; iteration < MAX_TOOL_ITERATIONS; iteration++) {
+        const { object: llmResult } = await deps.llm.generateObject({
+            system: currentSystem,
+            messages,
+            schema: LLMResponseWithToolsSchema,
+        });
+        if (!llmResult.search_memory) {
+            const text = llmResult.response;
+            const appraisal = llmResult.appraisal ?? { ...NEUTRAL_APPRAISAL };
+            return { text, appraisal };
+        }
+        const query = llmResult.search_memory;
+        let episodes = [];
+        try {
+            episodes = await deps.searchMemory(query);
+        }
+        catch {
+            // Memory search failed — continue without results
+        }
+        if (onToolCall) {
+            onToolCall({ name: 'search_memory', args: { query }, result: episodes });
+        }
+        const resultBlock = episodes.length > 0
+            ? `\n\n## Memory Search Results (query: "${query}")\n${episodes.map(ep => {
+                const ts = ep.timestamp ? new Date(ep.timestamp).toISOString() : 'unknown';
+                const source = ep.sourceEntity ?? 'unknown';
+                const context = ep.context ?? 'no context';
+                return `- [${ts}] ${source}: ${context}`;
+            }).join('\n')}`
+            : `\n\n## Memory Search Results (query: "${query}")\nNo matching memories found.`;
+        currentSystem = currentSystem + resultBlock;
+    }
+    const { object: finalResult } = await deps.llm.generateObject({
+        system: currentSystem,
+        messages,
+        schema: LLMResponseSchema,
+    });
+    return {
+        text: finalResult.response,
+        appraisal: finalResult.appraisal ?? { ...NEUTRAL_APPRAISAL },
+    };
+}

package/dist/esm/persona/event-emitter.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Stateless event mapper: AgentResponse → SDK events.
+ */
+import type { EventAdapter } from '../events/types';
+import type { AgentResponse } from '../types';
+export declare function emitResponseEvents(events: EventAdapter, personaId: string, response: AgentResponse, now: number): Promise<void>;
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/esm/persona/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../../src/persona/event-emitter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/esm/persona/event-emitter.js

@@ -0,0 +1,50 @@
+export async function emitResponseEvents(events, personaId, response, now) {
+    const batch = [];
+    if (response.emotion) {
+        batch.push({
+            type: 'emotion_changed',
+            personaId,
+            timestamp: now,
+            payload: {
+                vad: response.emotion.vad,
+                primary: response.emotion.discrete.primary,
+                intensity: response.emotion.discrete.intensity,
+            },
+        });
+    }
+    if (response.socialUpdates?.length) {
+        batch.push({
+            type: 'relationship_changed',
+            personaId,
+            timestamp: now,
+            payload: { updates: response.socialUpdates },
+        });
+    }
+    if (response.memoryEpisode) {
+        batch.push({
+            type: 'memory_consolidated',
+            personaId,
+            timestamp: now,
+            payload: { episodeId: response.memoryEpisode.id },
+        });
+    }
+    if (response.stageTransition) {
+        batch.push({ type: 'stage_transition', personaId, timestamp: now, payload: {} });
+    }
+    if (response.maskExposure) {
+        batch.push({ type: 'mask_exposure', personaId, timestamp: now, payload: response.maskExposure });
+    }
+    if (response.goalChanges) {
+        batch.push({ type: 'goal_changed', personaId, timestamp: now, payload: response.goalChanges });
+    }
+    if (batch.length === 0)
+        return;
+    if (events.emitBatch) {
+        await events.emitBatch(batch);
+    }
+    else {
+        for (const event of batch) {
+            await events.emit(event);
+        }
+    }
+}

package/dist/esm/persona/memory-pipeline.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Memory pipeline: episode saving and reflection generation.
+ *
+ * Extracted from MolrooPersona to eliminate duplicated save logic
+ * between postPerceivePipeline and postChat pipelines.
+ */
+import type { LLMAdapter } from '../llm/adapter';
+import type { MemoryAdapter } from '../memory/types';
+import type { EventAdapter } from '../events/types';
+import type { AgentResponse } from '../types';
+export interface MemoryPipelineDeps {
+    personaId: string;
+    memoryAdapter: MemoryAdapter | null;
+    events: EventAdapter | null;
+    llm: LLMAdapter | null;
+    engineLlm: LLMAdapter | null;
+}
+/**
+ * Post-perceive pipeline: save episode + emit events (no reflection).
+ */
+export declare function postPerceive(deps: MemoryPipelineDeps, response: AgentResponse): void;
+/**
+ * Post-chat pipeline: save episode + reflection + emit events.
+ */
+export declare function postChat(deps: MemoryPipelineDeps, response: AgentResponse): void;
+//# sourceMappingURL=memory-pipeline.d.ts.map

package/dist/esm/persona/memory-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-pipeline.d.ts","sourceRoot":"","sources":["../../../src/persona/memory-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,UAAU,CAAC;AAGrE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;CAC9B;AA+CD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAQpF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAehF"}