@molroo-io/sdk 0.9.0 → 0.10.0

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

@@ -1,6 +1,6 @@
-import { recallMemories, buildMemoryBlock } from '../memory/recall';
-import { NEUTRAL_APPRAISAL } from '../shared/appraisal';
-import { postChat } from './memory-pipeline';
+import { recallMemories, buildMemoryBlock } from '../memory/recall.js';
+import { NEUTRAL_APPRAISAL } from '../shared/appraisal.js';
+import { postChat } from './memory-pipeline.js';
 /** 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));
@@ -41,43 +41,17 @@ function buildDirectAppraisalInstruction() {
         'A compliment should produce positive values. Neutral small talk should be near zero.',
     ].join('\n');
 }
-function buildEventAppraisalInstruction() {
-    return [
-        '',
-        '## Event Classification Task',
-        "Classify the user's message into the ontology event format before emotion is computed.",
-        '',
-        '### Step 1: interaction_type (required)',
-        'Determine the conversation mode: chat (small talk), inform (sharing info/news), humor (jokes/playfulness), express (emotional/relational event), goodbye (farewell/parting).',
-        '',
-        '### Step 2: event_type (only when interaction_type is "express")',
-        'If the message contains a relationship event, classify it: praise, criticism, support, rejection, apology, request, betrayal, or neglect.',
-        'Omit event_type for chat, inform, humor, or goodbye — these do not carry relationship events.',
-        '',
-        '### Step 3: agent_role, target_role, relationship, intensity',
-        'agent_role: who performed the action. target_role: who is affected by or receives the action.',
-        'Example: "you did great" → interaction=express, event=praise, agent=user, target=self.',
-        'Example: "nice weather" → interaction=chat, no event_type, agent=user, target=self.',
-        'Example: "my friend betrayed me" → interaction=express, event=betrayal, agent=other, target=user.',
-    ].join('\n');
-}
-/** Convert an EventAppraisal to the ontologyEvent shape for API. */
-function toOntologyEvent(event) {
-    return {
-        interaction_type: event.interaction_type,
-        ...(event.event_type ? { event_type: event.event_type } : {}),
-        agent_role: event.agent_role,
-        target_role: event.target_role,
-        relationship: event.relationship,
-        intensity: event.intensity,
-    };
-}
 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);
+    const ctx = await deps.getPromptContext({
+        consumerSuffix: options?.consumerSuffix,
+        sourceEntity: from,
+        consumerRules: options?.consumerRules,
+        consumerExamples: options?.consumerExamples,
+    });
     let systemPrompt = ctx.systemPrompt;
     const hasTools = (ctx.tools?.length ?? 0) > 0;
     // 2. Build messages (external history + user message)
@@ -105,39 +79,31 @@ export async function chat(deps, message, options) {
     }
     let responseText;
     let appraisal;
-    let ontologyEvent;
     let earlyPerceiveResponse;
     // Split mode: engineLlm handles appraisal, primary llm handles response text
     if (deps.engineLlm && deps.engineLlm !== deps.llm) {
         const appraisalMessages = messages.length <= 5 ? messages : messages.slice(-5);
-        if (deps.appraisalMode === 'event') {
-            const { EventAppraisalSchema } = await import('../llm/schema');
-            const { object: appraisalResult } = await deps.engineLlm.generateObject({
-                system: systemPrompt + buildEventAppraisalInstruction(),
-                messages: appraisalMessages,
-                schema: EventAppraisalSchema,
-            });
-            ontologyEvent = toOntologyEvent(appraisalResult);
-        }
-        else {
-            const { AppraisalVectorSchema } = await import('../llm/schema');
-            const { object: appraisalResult } = await deps.engineLlm.generateObject({
-                system: systemPrompt + buildDirectAppraisalInstruction(),
-                messages: appraisalMessages,
-                schema: AppraisalVectorSchema,
-            });
-            appraisal = clampAppraisal(appraisalResult);
-        }
+        const { AppraisalVectorSchema } = await import('../llm/schema.js');
+        const { object: appraisalResult } = await deps.engineLlm.generateObject({
+            system: systemPrompt + buildDirectAppraisalInstruction(),
+            messages: appraisalMessages,
+            schema: AppraisalVectorSchema,
+        });
+        appraisal = clampAppraisal(appraisalResult);
         earlyPerceiveResponse = await deps.perceive(message, {
             from,
-            ...(appraisal ? { appraisal } : {}),
-            ...(ontologyEvent ? { ontologyEvent } : {}),
+            appraisal,
             priorEpisodes: recalledEpisodes.length > 0 ? recalledEpisodes : undefined,
             skipMemory: true,
         });
         let updatedPrompt = systemPrompt;
         try {
-            const updatedCtx = await deps.getPromptContext(options?.consumerSuffix, from);
+            const updatedCtx = await deps.getPromptContext({
+                consumerSuffix: options?.consumerSuffix,
+                sourceEntity: from,
+                consumerRules: options?.consumerRules,
+                consumerExamples: options?.consumerExamples,
+            });
             updatedPrompt = updatedCtx.systemPrompt;
             if (interlocutor) {
                 updatedPrompt += '\n\n' + buildInterlocutorBlock(interlocutor);
@@ -159,29 +125,16 @@ export async function chat(deps, message, options) {
         const result = await generateWithToolLoop(deps, systemPrompt, messages, options?.onToolCall);
         responseText = result.text;
         appraisal = result.appraisal;
-        ontologyEvent = result.ontologyEvent;
     }
     else {
-        if (deps.appraisalMode === 'event') {
-            const { LLMEventResponseSchema } = await import('../llm/schema');
-            const { object: llmResult } = await deps.llm.generateObject({
-                system: systemPrompt + buildEventAppraisalInstruction(),
-                messages,
-                schema: LLMEventResponseSchema,
-            });
-            responseText = llmResult.response;
-            ontologyEvent = toOntologyEvent(llmResult);
-        }
-        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 });
-        }
+        const { LLMResponseSchema } = await import('../llm/schema.js');
+        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;
@@ -192,7 +145,6 @@ export async function chat(deps, message, options) {
         response = await deps.perceive(responseText, {
             from,
             ...(appraisal ? { appraisal } : {}),
-            ...(ontologyEvent ? { ontologyEvent } : {}),
             priorEpisodes: recalledEpisodes.length > 0 ? recalledEpisodes : undefined,
             skipMemory: true,
         });
@@ -218,30 +170,9 @@ export async function chat(deps, message, options) {
 }
 async function generateWithToolLoop(deps, system, messages, onToolCall) {
     const MAX_TOOL_ITERATIONS = 3;
-    const { LLMEventResponseSchema, LLMEventResponseWithToolsSchema, LLMResponseSchema, LLMResponseWithToolsSchema, } = await import('../llm/schema');
+    const { LLMResponseSchema, LLMResponseWithToolsSchema, } = await import('../llm/schema.js');
     let currentSystem = system;
     for (let iteration = 0; iteration < MAX_TOOL_ITERATIONS; iteration++) {
-        if (deps.appraisalMode === 'event') {
-            const { object: llmResult } = await deps.llm.generateObject({
-                system: currentSystem + buildEventAppraisalInstruction(),
-                messages,
-                schema: LLMEventResponseWithToolsSchema,
-            });
-            if (!llmResult.search_memory) {
-                return {
-                    text: llmResult.response,
-                    ontologyEvent: toOntologyEvent(llmResult),
-                };
-            }
-            const query = llmResult.search_memory;
-            const episodes = [];
-            if (onToolCall) {
-                onToolCall({ name: 'search_memory', args: { query }, result: episodes });
-            }
-            const resultBlock = `\n\n## Memory Search Results (query: "${query}")\nNo matching memories found.`;
-            currentSystem = currentSystem + resultBlock;
-            continue;
-        }
         const { object: llmResult } = await deps.llm.generateObject({
             system: currentSystem,
             messages,
@@ -261,17 +192,6 @@ async function generateWithToolLoop(deps, system, messages, onToolCall) {
         const resultBlock = `\n\n## Memory Search Results (query: "${query}")\nNo matching memories found.`;
         currentSystem = currentSystem + resultBlock;
     }
-    if (deps.appraisalMode === 'event') {
-        const { object: finalResult } = await deps.llm.generateObject({
-            system: currentSystem + buildEventAppraisalInstruction(),
-            messages,
-            schema: LLMEventResponseSchema,
-        });
-        return {
-            text: finalResult.response,
-            ontologyEvent: toOntologyEvent(finalResult),
-        };
-    }
     const { object: finalResult } = await deps.llm.generateObject({
         system: currentSystem,
         messages,

package/dist/esm/persona/conversation.d.ts

@@ -7,8 +7,18 @@ export interface ConversationOptions {
     maxMessages?: number;
     /** Default source entity for all messages in this conversation. */
     from?: string | InterlocutorContext;
-    /** App-specific context appended to every system prompt in this conversation. */
+    /** Free-form app-specific context appended to every system prompt in this conversation. */
     consumerSuffix?: string;
+    /**
+     * Behavioral constraints and absolute rules applied to every message in this conversation.
+     * Examples: "Never break character", "Always respond in Korean".
+     */
+    consumerRules?: string;
+    /**
+     * Few-shot example messages for style/behavior reference, applied to every message in this conversation.
+     * Helps the LLM match a specific tone or response format.
+     */
+    consumerExamples?: string;
 }
 /**
  * Auto-managed conversation session that tracks message history.
@@ -44,7 +54,18 @@ export declare class Conversation {
      */
     send(message: string, options?: {
         from?: string | InterlocutorContext;
+        /** Free-form app-specific context appended to the system prompt for this message only. */
         consumerSuffix?: string;
+        /**
+         * Behavioral constraints and absolute rules for this message only.
+         * Overrides the session-level `consumerRules` when provided.
+         */
+        consumerRules?: string;
+        /**
+         * Few-shot example messages for style/behavior reference for this message only.
+         * Overrides the session-level `consumerExamples` when provided.
+         */
+        consumerExamples?: string;
         onToolCall?: (call: {
             name: string;
             args: Record<string, unknown>;

package/dist/esm/persona/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../src/persona/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,8GAA8G;IAC9G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAKjE;;;;;;OAMG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;QACpC,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAAC,MAAM,EAAE,OAAO,CAAA;SAAE,KAAK,IAAI,CAAC;KAC/F,GACA,OAAO,CAAC,iBAAiB,CAAC;IAgB7B,kDAAkD;IAClD,IAAI,QAAQ,IAAI,SAAS,OAAO,EAAE,CAEjC;IAED,8CAA8C;IAC9C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sCAAsC;IACtC,KAAK,IAAI,IAAI;IAIb,iDAAiD;IACjD,OAAO,CAAC,WAAW;CAMpB"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../src/persona/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,8GAA8G;IAC9G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpC,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAKjE;;;;;;OAMG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;QACpC,0FAA0F;QAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;WAGG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAAC,MAAM,EAAE,OAAO,CAAA;SAAE,KAAK,IAAI,CAAC;KAC/F,GACA,OAAO,CAAC,iBAAiB,CAAC;IAkB7B,kDAAkD;IAClD,IAAI,QAAQ,IAAI,SAAS,OAAO,EAAE,CAEjC;IAED,8CAA8C;IAC9C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sCAAsC;IACtC,KAAK,IAAI,IAAI;IAIb,iDAAiD;IACjD,OAAO,CAAC,WAAW;CAMpB"}

package/dist/esm/persona/conversation.js

@@ -35,6 +35,8 @@ export class Conversation {
         const result = await this._persona.chat(message, {
             from: options?.from ?? this._options.from,
             consumerSuffix: options?.consumerSuffix ?? this._options.consumerSuffix,
+            consumerRules: options?.consumerRules ?? this._options.consumerRules,
+            consumerExamples: options?.consumerExamples ?? this._options.consumerExamples,
             history: this._history,
             onToolCall: options?.onToolCall,
         });

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

@@ -1 +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"}
+{"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;AAyBrE,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;AAiDD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAUpF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAmBhF"}

package/dist/esm/persona/memory-pipeline.js

@@ -1,10 +1,30 @@
-import { emitResponseEvents } from './event-emitter';
+import { emitResponseEvents } from './event-emitter.js';
+/** Emit pipeline error or log warning if no EventAdapter. */
+function handlePipelineError(deps, stage, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (deps.events) {
+        deps.events.emit({
+            type: 'pipeline_error',
+            personaId: deps.personaId,
+            timestamp: Date.now(),
+            payload: { stage, error: message },
+        }).catch(() => {
+            // Last resort: log to console if event emit itself fails
+            console.warn(`[molroo-sdk] Pipeline error (${stage}):`, message);
+        });
+    }
+    else {
+        console.warn(`[molroo-sdk] Pipeline error (${stage}):`, message);
+    }
+}
 /** Save episode (shared between perceive and chat pipelines). */
 function saveEpisode(deps, response) {
     if (!response.memoryEpisode)
         return;
     if (deps.memoryAdapter) {
-        deps.memoryAdapter.saveEpisode(response.memoryEpisode).catch(() => { });
+        deps.memoryAdapter.saveEpisode(response.memoryEpisode).catch((err) => {
+            handlePipelineError(deps, 'save_episode', err);
+        });
     }
 }
 /** Handle reflection generation (LLM call + save). */
@@ -44,7 +64,9 @@ export function postPerceive(deps, response) {
         return;
     saveEpisode(deps, response);
     if (deps.events) {
-        emitResponseEvents(deps.events, deps.personaId, response, Date.now()).catch(() => { });
+        emitResponseEvents(deps.events, deps.personaId, response, Date.now()).catch((err) => {
+            handlePipelineError(deps, 'event_emit', err);
+        });
     }
 }
 /**
@@ -57,9 +79,13 @@ export function postChat(deps, response) {
     const hasLlm = deps.engineLlm || deps.llm;
     const hasMemory = deps.memoryAdapter;
     if (hasLlm && hasMemory && response.reflectionPrompt) {
-        handleReflection(deps, response.reflectionPrompt, response.emotion.vad).catch(() => { });
+        handleReflection(deps, response.reflectionPrompt, response.emotion.vad).catch((err) => {
+            handlePipelineError(deps, 'reflection', err);
+        });
     }
     if (deps.events) {
-        emitResponseEvents(deps.events, deps.personaId, response, now).catch(() => { });
+        emitResponseEvents(deps.events, deps.personaId, response, now).catch((err) => {
+            handlePipelineError(deps, 'event_emit', err);
+        });
     }
 }