@molroo-io/sdk 0.8.4 → 0.9.1

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

@@ -0,0 +1,84 @@
+import type { Message } from '../llm/adapter';
+import type { InterlocutorContext } from '../types';
+import type { MolrooPersona, PersonaChatResult } from '../persona';
+/** Options for creating a {@link Conversation} session. */
+export interface ConversationOptions {
+    /** Maximum number of messages to retain in history. Oldest messages are trimmed first. Default: unlimited. */
+    maxMessages?: number;
+    /** Default source entity for all messages in this conversation. */
+    from?: string | InterlocutorContext;
+    /** 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.
+ *
+ * Instead of manually passing `history` to every `chat()` call,
+ * create a Conversation and use `send()` — history is managed automatically.
+ *
+ * @example
+ * ```typescript
+ * const conv = persona.conversation({ maxMessages: 30 });
+ *
+ * const r1 = await conv.send('Hello!');
+ * console.log(r1.text);  // persona's response
+ *
+ * const r2 = await conv.send('Tell me more');
+ * // r2 includes full conversation context automatically
+ *
+ * console.log(conv.messages.length); // 4 (2 user + 2 assistant)
+ * conv.clear(); // reset history
+ * ```
+ */
+export declare class Conversation {
+    private _history;
+    private readonly _persona;
+    private readonly _options;
+    constructor(persona: MolrooPersona, options?: ConversationOptions);
+    /**
+     * Send a message and get a response. History is updated automatically.
+     *
+     * @param message - User message to send.
+     * @param options - Per-message overrides (from, consumerSuffix, onToolCall).
+     * @returns Chat result with text, emotion data, and updated history.
+     */
+    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>;
+            result: unknown;
+        }) => void;
+    }): Promise<PersonaChatResult>;
+    /** Read-only view of the conversation history. */
+    get messages(): readonly Message[];
+    /** Number of messages in the conversation. */
+    get length(): number;
+    /** Clear all conversation history. */
+    clear(): void;
+    /** Trim history to maxMessages if configured. */
+    private trimHistory;
+}
+//# sourceMappingURL=conversation.d.ts.map

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

@@ -0,0 +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,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/cjs/persona/conversation.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Conversation = void 0;
+/**
+ * Auto-managed conversation session that tracks message history.
+ *
+ * Instead of manually passing `history` to every `chat()` call,
+ * create a Conversation and use `send()` — history is managed automatically.
+ *
+ * @example
+ * ```typescript
+ * const conv = persona.conversation({ maxMessages: 30 });
+ *
+ * const r1 = await conv.send('Hello!');
+ * console.log(r1.text);  // persona's response
+ *
+ * const r2 = await conv.send('Tell me more');
+ * // r2 includes full conversation context automatically
+ *
+ * console.log(conv.messages.length); // 4 (2 user + 2 assistant)
+ * conv.clear(); // reset history
+ * ```
+ */
+class Conversation {
+    constructor(persona, options) {
+        this._history = [];
+        this._persona = persona;
+        this._options = options ?? {};
+    }
+    /**
+     * Send a message and get a response. History is updated automatically.
+     *
+     * @param message - User message to send.
+     * @param options - Per-message overrides (from, consumerSuffix, onToolCall).
+     * @returns Chat result with text, emotion data, and updated history.
+     */
+    async send(message, options) {
+        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,
+        });
+        // Append this turn to history
+        this._history.push({ role: 'user', content: message });
+        this._history.push({ role: 'assistant', content: result.text });
+        this.trimHistory();
+        return result;
+    }
+    /** Read-only view of the conversation history. */
+    get messages() {
+        return this._history;
+    }
+    /** Number of messages in the conversation. */
+    get length() {
+        return this._history.length;
+    }
+    /** Clear all conversation history. */
+    clear() {
+        this._history = [];
+    }
+    /** Trim history to maxMessages if configured. */
+    trimHistory() {
+        if (this._options.maxMessages && this._history.length > this._options.maxMessages) {
+            // Trim from the front, keep the most recent messages
+            this._history = this._history.slice(-this._options.maxMessages);
+        }
+    }
+}
+exports.Conversation = Conversation;

package/dist/cjs/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/cjs/persona/memory-pipeline.js

@@ -3,12 +3,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.postPerceive = postPerceive;
 exports.postChat = postChat;
 const event_emitter_1 = require("./event-emitter");
+/** 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). */
@@ -48,7 +68,9 @@ function postPerceive(deps, response) {
         return;
     saveEpisode(deps, response);
     if (deps.events) {
-        (0, event_emitter_1.emitResponseEvents)(deps.events, deps.personaId, response, Date.now()).catch(() => { });
+        (0, event_emitter_1.emitResponseEvents)(deps.events, deps.personaId, response, Date.now()).catch((err) => {
+            handlePipelineError(deps, 'event_emit', err);
+        });
     }
 }
 /**
@@ -61,9 +83,13 @@ 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) {
-        (0, event_emitter_1.emitResponseEvents)(deps.events, deps.personaId, response, now).catch(() => { });
+        (0, event_emitter_1.emitResponseEvents)(deps.events, deps.personaId, response, now).catch((err) => {
+            handlePipelineError(deps, 'event_emit', err);
+        });
     }
 }