@molroo-io/sdk 0.8.3 → 0.9.0

package/dist/cjs/errors.d.ts

@@ -1,2 +1,2 @@
-export { MolrooApiError } from './shared/errors';
+export { MolrooApiError, MolrooErrorCode } from './shared/errors';
 //# sourceMappingURL=errors.d.ts.map

package/dist/cjs/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/cjs/errors.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MolrooApiError = void 0;
+exports.MolrooErrorCode = exports.MolrooApiError = void 0;
 var errors_1 = require("./shared/errors");
 Object.defineProperty(exports, "MolrooApiError", { enumerable: true, get: function () { return errors_1.MolrooApiError; } });
+Object.defineProperty(exports, "MolrooErrorCode", { enumerable: true, get: function () { return errors_1.MolrooErrorCode; } });

package/dist/cjs/index.d.ts

@@ -30,14 +30,16 @@
  */
 export { Molroo } from './world/world';
 export type { MolrooOptions, PersonaOptions } from './world/world';
-export { MolrooApiError, WorldApiError } from './shared/errors';
+export { MolrooApiError, WorldApiError, MolrooErrorCode } from './shared/errors';
 export { NEUTRAL_APPRAISAL, toWireAppraisal, fromWireAppraisal } from './shared/appraisal';
 export type { Appraisal } from './shared/appraisal';
 export type { LLMAdapter, Message, GenerateTextOptions, GenerateObjectOptions, } from './llm/adapter';
 export type { LLMInput } from './llm/resolve';
 export type { MemoryAdapter, RecallQuery, SemanticRecallOptions, RecallLimits, Reflection, } from './memory/types';
 export type { PersonaSummary, PersonaState, PersonaChatResult, } from './persona';
-export type { AppraisalMode, EventAppraisal, InterlocutorContext, PerceiveOptions, PerceiveEvent, PerceiveContext, } from './types';
+export { Conversation } from './persona/conversation';
+export type { ConversationOptions } from './persona/conversation';
+export type { AppraisalMode, EventAppraisal, InterlocutorContext, RelationshipContext, PerceiveOptions, PerceiveEvent, PerceiveContext, } from './types';
 export type { AgentResponse, VAD, Velocity, AppraisalVector, State, SoulStage, CatastropheState, MetacogState, AffectDynamicsState, InterpersonalState, RegulationState, RegulationStrategy, RegulationPhase, ActiveRegulation, RegulationRecord, EffectivenessRecord, NeedState, Episode, SocialUpdate, ReflectionPrompt, } from './types';
 export type { PersonaSnapshot, PersonaConfigData, PersonalityTraits, Identity, Goal, MotivationContext, } from './types';
 export type { ApiResponse, ApiErrorResponse, PersonaDynamicState, } from './types';

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EACV,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,YAAY,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,UAAU,GACX,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,aAAa,EACb,GAAG,EACH,QAAQ,EACR,eAAe,EACf,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,OAAO,EACP,YAAY,EACZ,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACJ,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGjF,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EACV,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,YAAY,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,UAAU,GACX,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,YAAY,EACV,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,aAAa,EACb,GAAG,EACH,QAAQ,EACR,eAAe,EACf,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,OAAO,EACP,YAAY,EACZ,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACJ,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/cjs/index.js

@@ -30,18 +30,22 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withDefaults = exports.DEFAULT_PERSONA = exports.EMOTION_LABELS = exports.fromWireAppraisal = exports.toWireAppraisal = exports.NEUTRAL_APPRAISAL = exports.WorldApiError = exports.MolrooApiError = exports.Molroo = void 0;
+exports.withDefaults = exports.DEFAULT_PERSONA = exports.EMOTION_LABELS = exports.Conversation = exports.fromWireAppraisal = exports.toWireAppraisal = exports.NEUTRAL_APPRAISAL = exports.MolrooErrorCode = exports.WorldApiError = exports.MolrooApiError = exports.Molroo = void 0;
 // ── Main exports ──
 var world_1 = require("./world/world");
 Object.defineProperty(exports, "Molroo", { enumerable: true, get: function () { return world_1.Molroo; } });
 var errors_1 = require("./shared/errors");
 Object.defineProperty(exports, "MolrooApiError", { enumerable: true, get: function () { return errors_1.MolrooApiError; } });
 Object.defineProperty(exports, "WorldApiError", { enumerable: true, get: function () { return errors_1.WorldApiError; } });
+Object.defineProperty(exports, "MolrooErrorCode", { enumerable: true, get: function () { return errors_1.MolrooErrorCode; } });
 // ── Shared utilities ──
 var appraisal_1 = require("./shared/appraisal");
 Object.defineProperty(exports, "NEUTRAL_APPRAISAL", { enumerable: true, get: function () { return appraisal_1.NEUTRAL_APPRAISAL; } });
 Object.defineProperty(exports, "toWireAppraisal", { enumerable: true, get: function () { return appraisal_1.toWireAppraisal; } });
 Object.defineProperty(exports, "fromWireAppraisal", { enumerable: true, get: function () { return appraisal_1.fromWireAppraisal; } });
+// ── Conversation ──
+var conversation_1 = require("./persona/conversation");
+Object.defineProperty(exports, "Conversation", { enumerable: true, get: function () { return conversation_1.Conversation; } });
 // ── Emotion labels (synced with engine/core) ──
 var emotion_1 = require("./emotion");
 Object.defineProperty(exports, "EMOTION_LABELS", { enumerable: true, get: function () { return emotion_1.EMOTION_LABELS; } });

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

@@ -0,0 +1,63 @@
+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;
+    /** App-specific context appended to every system prompt in this conversation. */
+    consumerSuffix?: 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;
+        consumerSuffix?: 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,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"}

package/dist/cjs/persona/conversation.js

@@ -0,0 +1,70 @@
+"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,
+            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.d.ts

@@ -2,7 +2,9 @@ import type { LLMAdapter, Message } from './llm/adapter';
 import { type LLMInput } from './llm/resolve';
 import type { MemoryAdapter, RecallLimits } from './memory/types';
 import type { EventAdapter } from './events/types';
-import type { AgentResponse, AppraisalMode, AppraisalVector, InterlocutorContext, PersonaSnapshot, PersonaConfigData, PerceiveOptions } from './types';
+import type { AgentResponse, AppraisalMode, AppraisalVector, InterlocutorContext, RelationshipContext, PersonaSnapshot, PersonaConfigData, PerceiveOptions } from './types';
+import type { StyleProfile } from './expression';
+import { Conversation, type ConversationOptions } from './persona/conversation';
 /** Configuration for connecting to a standalone persona instance. */
 export interface MolrooPersonaConfig {
     /** Base URL of the molroo API. Defaults to 'https://api.molroo.io'. */
@@ -102,7 +104,9 @@ export declare class MolrooPersona {
         llm?: LLMAdapter;
         engineLlm?: LLMAdapter;
     });
+    /** Unique persona instance ID. */
     get id(): string;
+    /** @deprecated Use {@link id} instead. */
     get personaId(): string;
     /**
      * Create a new persona from a natural language description.
@@ -166,6 +170,23 @@ export declare class MolrooPersona {
         events?: EventAdapter;
         appraisalMode?: AppraisalMode;
     }, description: string): Promise<MolrooPersona>;
+    /**
+     * Connect to an existing persona by ID.
+     *
+     * @param config - Connection configuration (apiKey required).
+     * @param personaId - The persona instance ID to connect to.
+     * @returns A connected MolrooPersona instance.
+     *
+     * @deprecated Use {@link Molroo.connectPersona} instead.
+     *
+     * @example
+     * ```typescript
+     * const sera = await MolrooPersona.connect(
+     *   { apiKey: 'mk_...', llm: openaiAdapter },
+     *   'persona_abc123'
+     * );
+     * ```
+     */
     static connect(config: {
         baseUrl?: string;
         apiKey: string;
@@ -176,6 +197,12 @@ export declare class MolrooPersona {
         events?: EventAdapter;
         appraisalMode?: AppraisalMode;
     }, personaId: string): Promise<MolrooPersona>;
+    /**
+     * List all personas for the authenticated tenant.
+     *
+     * @param config - API connection config.
+     * @returns Paginated list of persona summaries.
+     */
     static listPersonas(config: {
         baseUrl?: string;
         apiKey: string;
@@ -183,10 +210,95 @@ export declare class MolrooPersona {
         personas: PersonaSummary[];
         nextCursor?: string;
     }>;
+    /**
+     * Send a stimulus to the persona's emotion engine and get the updated emotional response.
+     * This is the low-level API — for common cases, prefer {@link hear}, {@link experience}, or {@link chat}.
+     *
+     * @param message - The stimulus text (user message, event description, etc.).
+     * @param options - Appraisal, source, relationship context, and other options.
+     * @returns Emotion engine response with VAD, discrete emotion, and side effects.
+     */
     perceive(message: string, options?: PerceiveOptions): Promise<AgentResponse>;
+    /**
+     * Send a custom event with a required appraisal vector.
+     *
+     * @param type - Custom event type (e.g., 'gift_received', 'argument').
+     * @param description - Human-readable event description.
+     * @param options - Must include a pre-computed appraisal vector.
+     * @returns Emotion engine response.
+     */
     event(type: string, description: string, options: Omit<PerceiveOptions, 'type'> & {
         appraisal: AppraisalVector;
     }): Promise<AgentResponse>;
+    /**
+     * Perceive a chat message from another entity. Simplest wrapper over {@link perceive}.
+     *
+     * @param message - The incoming message text.
+     * @param from - Who sent the message (name string or structured context).
+     * @returns Emotion engine response.
+     *
+     * @example
+     * ```typescript
+     * const response = await persona.hear('How are you?', 'Alice');
+     * ```
+     */
+    hear(message: string, from?: string | InterlocutorContext): Promise<AgentResponse>;
+    /**
+     * Perceive an environmental or narrative event with a pre-computed appraisal.
+     *
+     * @param description - What happened (e.g., 'The sun set over the ocean').
+     * @param appraisal - 9-dimensional Scherer CPM appraisal vector.
+     * @returns Emotion engine response.
+     *
+     * @example
+     * ```typescript
+     * const response = await persona.experience('Received a surprise gift', {
+     *   goal_relevance: 0.8, goal_congruence: 0.9, expectedness: 0.2,
+     *   controllability: 0.5, agency: 0.3, norm_compatibility: 0.8,
+     *   internal_standards: 0.7, adjustment_potential: 0.6, urgency: 0.3,
+     * });
+     * ```
+     */
+    experience(description: string, appraisal: AppraisalVector): Promise<AgentResponse>;
+    /**
+     * Perceive a social interaction with relationship context for trust/intimacy computation.
+     *
+     * @param message - The interaction message.
+     * @param from - Who the interaction is from.
+     * @param relationship - Current relationship state (closeness, trust, familiarity).
+     * @returns Emotion engine response including socialUpdates.
+     *
+     * @example
+     * ```typescript
+     * const response = await persona.socialize('I missed you!', 'Bob', {
+     *   closeness: 0.7, trust: 0.8, familiarity: 0.9, type: 'friend',
+     * });
+     * console.log(response.socialUpdates); // trust/intimacy deltas
+     * ```
+     */
+    socialize(message: string, from: string | InterlocutorContext, relationship: RelationshipContext): Promise<AgentResponse>;
+    /**
+     * Send a message and get an LLM-generated response with emotion processing.
+     * This is the primary method for conversational interactions.
+     *
+     * The system prompt is assembled server-side via {@link getPromptContext} and includes:
+     * identity, behavioral instructions, current psychological state, expression style,
+     * and consumerSuffix. Do NOT duplicate these in consumerSuffix.
+     *
+     * @param message - User message to respond to.
+     * @param options - Conversation history, source entity, and app-specific suffix.
+     * @returns LLM response text, emotion data, and updated conversation history.
+     *
+     * @example
+     * ```typescript
+     * const result = await persona.chat('Tell me about yourself', {
+     *   from: 'Alice',
+     *   history: previousMessages,
+     * });
+     * console.log(result.text);            // LLM response
+     * console.log(result.response.emotion); // updated VAD
+     * ```
+     */
     chat(message: string, options?: {
         from?: string | InterlocutorContext;
         history?: Message[];
@@ -197,20 +309,50 @@ export declare class MolrooPersona {
             result: unknown;
         }) => void;
     }): Promise<PersonaChatResult>;
+    /**
+     * Advance persona simulation time. Triggers idle decay, body budget recovery,
+     * need regression, and timeline advancement.
+     *
+     * @param seconds - Number of seconds to advance (must be >= 1).
+     * @returns Any pending internal events generated by threshold checks.
+     */
     tick(seconds: number): Promise<{
         pendingEvents?: unknown[];
     }>;
+    /**
+     * Override the persona's current emotion to a specific VAD point.
+     * Useful for testing or narrative-driven emotion control.
+     *
+     * @param vad - Partial VAD values to set (V: valence, A: arousal, D: dominance).
+     */
     setEmotion(vad: Partial<{
         V: number;
         A: number;
         D: number;
     }>): Promise<void>;
+    /**
+     * Append text to the next system prompt. One-shot: cleared after the next
+     * `getPromptContext()` / `chat()` call.
+     */
+    annotate(text: string): Promise<void>;
+    /**
+     * Force the next response text. The persona will use this exact text
+     * instead of generating via LLM on the next `chat()` call.
+     */
+    setNextResponse(text: string): Promise<void>;
     /**
      * Set StyleProfile extracted from a text corpus.
      * Once set, expression constraints (promptText) are automatically
      * included in getPromptContext() and modulated by current emotion.
      */
-    setStyleProfile(profile: Record<string, unknown>): Promise<void>;
+    /**
+     * Set a StyleProfile for expression-aware prompt generation.
+     * Once set, expression constraints are automatically included in
+     * {@link getPromptContext} and modulated by current emotion.
+     *
+     * @param profile - StyleProfile object (lexical, structural, register features, etc.).
+     */
+    setStyleProfile(profile: StyleProfile): Promise<void>;
     /**
      * Extract a StyleProfile from a text corpus and save it to this persona.
      * Delegates extraction to the API server (keeps expression logic server-side).
@@ -223,19 +365,72 @@ export declare class MolrooPersona {
         timestamps?: number[];
         otherMessages?: string[];
     }): Promise<Record<string, unknown>>;
+    /**
+     * Get the persona's current emotional and psychological state.
+     *
+     * @returns Current emotion (VAD + discrete), mood, somatic sensations, and narrative.
+     */
     getState(): Promise<PersonaState>;
+    /**
+     * Get a full snapshot of the persona (config + engine state).
+     * Useful for backup, migration, or debugging.
+     *
+     * @returns Full persona snapshot including config and internal state.
+     */
     getSnapshot(): Promise<PersonaSnapshot>;
+    /**
+     * Restore a persona from a snapshot. Overwrites current state entirely.
+     *
+     * @param snapshot - Full persona snapshot to restore.
+     */
     putSnapshot(snapshot: PersonaSnapshot): Promise<void>;
+    /**
+     * Partially update persona configuration (identity, personality, goals, etc.).
+     *
+     * @param updates - Fields to update. Only provided fields are changed.
+     */
     patch(updates: {
         config?: PersonaConfigData;
     }): Promise<void>;
+    /**
+     * Soft-delete this persona. Can be restored within retention period via {@link restore}.
+     */
     destroy(): Promise<void>;
+    /** Restore a soft-deleted persona. */
     restore(): Promise<void>;
+    /**
+     * Fetch the server-assembled system prompt for this persona.
+     * Includes identity, behavioral instructions, psychological state,
+     * expression style (if StyleProfile set), and consumerSuffix.
+     *
+     * Called internally by {@link chat}. Use directly when building custom LLM pipelines.
+     *
+     * @param consumerSuffix - App-specific context appended to the system prompt.
+     *   Do NOT include identity, personality, or emotion — these are already in the prompt.
+     * @param sourceEntity - Name of the conversation partner (for interlocutor-aware prompts).
+     * @returns System prompt string and structured persona prompt data.
+     */
     getPromptContext(consumerSuffix?: string, sourceEntity?: string): Promise<{
         systemPrompt: string;
         personaPrompt: Record<string, unknown>;
         tools?: Array<Record<string, unknown>>;
     }>;
+    /**
+     * Create a conversation session that auto-manages message history.
+     * Each `.send()` call automatically appends to the history.
+     *
+     * @param options - Max messages or custom chat options.
+     * @returns A new Conversation instance bound to this persona.
+     *
+     * @example
+     * ```typescript
+     * const conv = persona.conversation({ maxMessages: 20 });
+     * const r1 = await conv.send('Hello!');
+     * const r2 = await conv.send('Tell me more');  // history auto-managed
+     * console.log(conv.messages);                  // full conversation
+     * ```
+     */
+    conversation(options?: ConversationOptions): Conversation;
     private get memoryPipelineDeps();
     private requireLLM;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/persona.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/persona.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,eAAe,EAEhB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAUhF,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,oEAAoE;IACpE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,OAAO,EAAE;QACP,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACzC,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KACvE,CAAC;IACF,sDAAsD;IACtD,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACpD,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,EAAE,aAAa,CAAC;IACxB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2FAA2F;IAC3F,cAAc,EAAE,OAAO,EAAE,CAAC;CAC3B;AAID;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,kBAAkB,CAA2B;IACrD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAgB;gBAEzB,MAAM,EAAE,mBAAmB,GAAG;QAAE,GAAG,CAAC,EAAE,UAAU,CAAC;QAAC,SAAS,CAAC,EAAE,UAAU,CAAA;KAAE;IActF,kCAAkC;IAClC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,0CAA0C;IAC1C,IAAI,SAAS,IAAI,MAAM,CAEtB;IAID;;;;;;;;;;;OAWG;WACU,MAAM,CACjB,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,QAAQ,CAAC;QACd,SAAS,CAAC,EAAE,QAAQ,CAAC;QACrB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B,EACD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC;IAEzB;;;;;;;;;;OAUG;WACU,MAAM,CACjB,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,QAAQ,CAAC;QACf,SAAS,CAAC,EAAE,QAAQ,CAAC;QACrB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B,EACD,aAAa,EAAE,iBAAiB,GAC/B,OAAO,CAAC,aAAa,CAAC;IAmCzB;;;OAGG;mBACkB,gBAAgB;IA6BrC;;;OAGG;WACU,QAAQ,CACnB,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,QAAQ,CAAC;QACd,SAAS,CAAC,EAAE,QAAQ,CAAC;QACrB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B,EACD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC;IAIzB;;;;;;;;;;;;;;;;OAgBG;WACU,OAAO,CAClB,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,QAAQ,CAAC;QACf,SAAS,CAAC,EAAE,QAAQ,CAAC;QACrB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B,EACD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC;IAczB;;;;;OAKG;WACU,YAAY,CAAC,MAAM,EAAE;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAShE;;;;;;;OAOG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IA2ClF;;;;;;;OAOG;IACG,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG;QAAE,SAAS,EAAE,eAAe,CAAA;KAAE,GACtE,OAAO,CAAC,aAAa,CAAC;IAIzB;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIxF;;;;;;;;;;;;;;;OAeG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAIzF;;;;;;;;;;;;;;;OAeG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAClC,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,aAAa,CAAC;IAIzB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;QACpC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;QACpB,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;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAQnE;;;;;OAKG;IACG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlF;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD;;;;OAIG;IACH;;;;;;OAMG;IACG,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D;;;;;;;OAOG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC5D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAWnC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAOvC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAO7C;;;;OAIG;IACG,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D;;;;OAIG;IACG,KAAK,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASnE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,sCAAsC;IAChC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B;;;;;;;;;;;OAWG;IACG,gBAAgB,CACpB,cAAc,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;IAapH;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY;IAMzD,OAAO,KAAK,kBAAkB,GAQ7B;IAED,OAAO,CAAC,UAAU;CAUnB"}