@molroo-io/sdk 0.7.2 → 0.8.2

package/dist/cjs/emotion.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Canonical emotion labels — mirrors engine/core EMOTION_LABELS.
+ * Kept in sync via sdk/__tests__/emotion-labels-sync.test.ts.
+ */
+export declare const EMOTION_LABELS: readonly ["joy", "excitement", "contentment", "love", "pride", "gratitude", "amusement", "relief", "anger", "fear", "sadness", "anxiety", "disgust", "shame", "guilt", "surprise", "trust", "calm", "numbness"];
+export type EmotionLabel = (typeof EMOTION_LABELS)[number];
+//# sourceMappingURL=emotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emotion.d.ts","sourceRoot":"","sources":["../../src/emotion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc,iNAOjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/cjs/emotion.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMOTION_LABELS = void 0;
+/**
+ * Canonical emotion labels — mirrors engine/core EMOTION_LABELS.
+ * Kept in sync via sdk/__tests__/emotion-labels-sync.test.ts.
+ */
+exports.EMOTION_LABELS = [
+    // Positive (8)
+    'joy', 'excitement', 'contentment', 'love', 'pride', 'gratitude', 'amusement', 'relief',
+    // Negative (7)
+    'anger', 'fear', 'sadness', 'anxiety', 'disgust', 'shame', 'guilt',
+    // Neutral / Mixed (4)
+    'surprise', 'trust', 'calm', 'numbness',
+];

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

@@ -0,0 +1,103 @@
+/**
+ * @molroo-io/sdk/expression — StyleProfile type definitions
+ *
+ * Style extraction is now handled server-side via the API.
+ * Use `persona.extractStyleProfile(corpus)` to extract and save a StyleProfile.
+ *
+ * Types inlined from @molroo-io/expression (private package).
+ * These must stay in sync with lib/expression/src/types/index.ts.
+ *
+ * Usage:
+ * ```typescript
+ * import type { StyleProfile } from '@molroo-io/sdk/expression';
+ *
+ * const profile = await persona.extractStyleProfile(chatCorpus);
+ * ```
+ */
+export interface ExtractionOptions {
+    /** Timestamps for turn grouping (same length as messages) */
+    timestamps?: number[];
+    /** Messages from other participants (for TF-IDF signature detection) */
+    otherMessages?: string[];
+}
+export interface LexicalFeatures {
+    /** Type-Token Ratio: unique_words / total_words */
+    vocabRichness: number;
+    /** Yule's K characteristic: 10^4 * (M2 - M1) / M1^2 */
+    yuleK: number;
+    /** Words appearing only once / total words */
+    hapaxRatio: number;
+    /** Average word length in characters */
+    avgWordLength: number;
+    /** Function word (particles, conjunctions) frequency distribution */
+    functionWordDist: Record<string, number>;
+}
+export interface StructuralFeatures {
+    /** Average message length in characters */
+    avgMessageLength: number;
+    /** Standard deviation of message length */
+    messageLengthStd: number;
+    /** Ratio of turns with multiple messages */
+    multiMessageRatio: number;
+    /** Average number of messages per turn */
+    avgMessagesPerTurn: number;
+    /** Ratio of messages ending with ? */
+    questionRatio: number;
+}
+export interface PunctuationFeatures {
+    /** Period usage style */
+    periodStyle: 'none' | 'single' | 'double' | 'triple';
+    /** Emoji count per message (mean) */
+    emojiFrequency: number;
+    /** Top N most-used emoji */
+    emojiSet: string[];
+    /** Laugh expression patterns (e.g. ㅋㅋ, ㅎㅎ, ㅋㅋㅋㅋ) */
+    laughStyle: string[];
+    /** Laugh expressions per message (mean) */
+    laughFrequency: number;
+    /** Exclamation mark usage rate */
+    exclamationRate: number;
+    /** Ellipsis (...) usage rate */
+    ellipsisRate: number;
+}
+export interface RegisterFeatures {
+    /** 0 (casual/banmal) ~ 1 (formal/jondaenmal) */
+    formalityScore: number;
+    /** Honorific patterns used */
+    honorificPatterns: string[];
+    /** How the person addresses the interlocutor */
+    addressTerms: string[];
+}
+export interface IdiosyncraticFeatures {
+    /** Filler words (아, 음, 근데, etc.) */
+    fillerWords: string[];
+    /** Contraction patterns (ㄱㅊ, ㅇㅇ, ㄴㄴ, etc.) */
+    contractions: string[];
+    /** Statistically significant personal expressions */
+    signaturePatterns: string[];
+    /** Sentence ending pattern distribution */
+    sentenceEnders: Record<string, number>;
+}
+export interface ResponsePatterns {
+    /** Ratio of conversation initiations */
+    initiationRatio: number;
+    /** Topic change style description */
+    topicChangeStyle: string;
+}
+export interface StatisticalSignature {
+    /** Character n-gram frequency distribution (n=2,3) */
+    charNgramDist: Record<string, number>;
+    /** Word n-gram frequency distribution (n=2) */
+    wordNgramDist: Record<string, number>;
+}
+/** Complete individual expression fingerprint */
+export interface StyleProfile {
+    lexical: LexicalFeatures;
+    structural: StructuralFeatures;
+    punctuation: PunctuationFeatures;
+    register: RegisterFeatures;
+    idiosyncratic: IdiosyncraticFeatures;
+    response: ResponsePatterns;
+    signature: StatisticalSignature;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/expression/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAID,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrD,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gDAAgD;IAChD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,EAAE,mBAAmB,CAAC;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,aAAa,EAAE,qBAAqB,CAAC;IACrC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,oBAAoB,CAAC;CACjC"}

package/dist/cjs/expression/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @molroo-io/sdk/expression — StyleProfile type definitions
+ *
+ * Style extraction is now handled server-side via the API.
+ * Use `persona.extractStyleProfile(corpus)` to extract and save a StyleProfile.
+ *
+ * Types inlined from @molroo-io/expression (private package).
+ * These must stay in sync with lib/expression/src/types/index.ts.
+ *
+ * Usage:
+ * ```typescript
+ * import type { StyleProfile } from '@molroo-io/sdk/expression';
+ *
+ * const profile = await persona.extractStyleProfile(chatCorpus);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/index.d.ts

@@ -37,10 +37,12 @@ export type { LLMAdapter, Message, GenerateTextOptions, GenerateObjectOptions, }
 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 { InterlocutorContext, PerceiveOptions, PerceiveEvent, PerceiveContext, } from './types';
+export type { AppraisalMode, EventAppraisal, InterlocutorContext, 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';
 export type { LLMPrompt, LLMResponse, } from './llm/types';
+export { EMOTION_LABELS } from './emotion';
+export type { EmotionLabel } from './emotion';
 export { DEFAULT_PERSONA, withDefaults } from './defaults';
 //# sourceMappingURL=index.d.ts.map

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,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,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,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"}

package/dist/cjs/index.js

@@ -30,7 +30,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withDefaults = exports.DEFAULT_PERSONA = exports.fromWireAppraisal = exports.toWireAppraisal = exports.NEUTRAL_APPRAISAL = exports.WorldApiError = exports.MolrooApiError = exports.Molroo = void 0;
+exports.withDefaults = exports.DEFAULT_PERSONA = exports.EMOTION_LABELS = exports.fromWireAppraisal = exports.toWireAppraisal = exports.NEUTRAL_APPRAISAL = 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; } });
@@ -42,6 +42,9 @@ 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; } });
+// ── 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; } });
 // ── Defaults ──
 var defaults_1 = require("./defaults");
 Object.defineProperty(exports, "DEFAULT_PERSONA", { enumerable: true, get: function () { return defaults_1.DEFAULT_PERSONA; } });

package/dist/cjs/llm/schema.d.ts

@@ -18,6 +18,43 @@ export declare const AppraisalVectorSchema: z.ZodObject<{
     adjustment_potential: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
     urgency: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
 }, z.core.$strip>;
+export declare const EventAppraisalSchema: z.ZodObject<{
+    interaction_type: z.ZodEnum<{
+        chat: "chat";
+        inform: "inform";
+        humor: "humor";
+        express: "express";
+        goodbye: "goodbye";
+    }>;
+    event_type: z.ZodOptional<z.ZodEnum<{
+        praise: "praise";
+        criticism: "criticism";
+        support: "support";
+        rejection: "rejection";
+        apology: "apology";
+        request: "request";
+        betrayal: "betrayal";
+        neglect: "neglect";
+    }>>;
+    agent_role: z.ZodEnum<{
+        user: "user";
+        self: "self";
+        other: "other";
+    }>;
+    target_role: z.ZodEnum<{
+        user: "user";
+        self: "self";
+        other: "other";
+    }>;
+    relationship: z.ZodEnum<{
+        friend: "friend";
+        romantic: "romantic";
+        authority: "authority";
+        stranger: "stranger";
+    }>;
+    intensity: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+}, z.core.$strip>;
+export type EventAppraisalOutput = z.infer<typeof EventAppraisalSchema>;
 /**
  * Full LLM response schema — response text + appraisal vector.
  */
@@ -36,6 +73,44 @@ export declare const LLMResponseSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type LLMResponseOutput = z.infer<typeof LLMResponseSchema>;
+export declare const LLMEventResponseSchema: z.ZodObject<{
+    response: z.ZodString;
+    interaction_type: z.ZodEnum<{
+        chat: "chat";
+        inform: "inform";
+        humor: "humor";
+        express: "express";
+        goodbye: "goodbye";
+    }>;
+    event_type: z.ZodOptional<z.ZodEnum<{
+        praise: "praise";
+        criticism: "criticism";
+        support: "support";
+        rejection: "rejection";
+        apology: "apology";
+        request: "request";
+        betrayal: "betrayal";
+        neglect: "neglect";
+    }>>;
+    agent_role: z.ZodEnum<{
+        user: "user";
+        self: "self";
+        other: "other";
+    }>;
+    target_role: z.ZodEnum<{
+        user: "user";
+        self: "self";
+        other: "other";
+    }>;
+    relationship: z.ZodEnum<{
+        friend: "friend";
+        romantic: "romantic";
+        authority: "authority";
+        stranger: "stranger";
+    }>;
+    intensity: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+}, z.core.$strip>;
+export type LLMEventResponseOutput = z.infer<typeof LLMEventResponseSchema>;
 /**
  * Tool-use aware LLM response schema.
  * The LLM can either produce a normal response or request a memory search.
@@ -57,4 +132,43 @@ export declare const LLMResponseWithToolsSchema: z.ZodObject<{
     search_memory: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type LLMResponseWithToolsOutput = z.infer<typeof LLMResponseWithToolsSchema>;
+export declare const LLMEventResponseWithToolsSchema: z.ZodObject<{
+    response: z.ZodString;
+    interaction_type: z.ZodEnum<{
+        chat: "chat";
+        inform: "inform";
+        humor: "humor";
+        express: "express";
+        goodbye: "goodbye";
+    }>;
+    event_type: z.ZodOptional<z.ZodEnum<{
+        praise: "praise";
+        criticism: "criticism";
+        support: "support";
+        rejection: "rejection";
+        apology: "apology";
+        request: "request";
+        betrayal: "betrayal";
+        neglect: "neglect";
+    }>>;
+    agent_role: z.ZodEnum<{
+        user: "user";
+        self: "self";
+        other: "other";
+    }>;
+    target_role: z.ZodEnum<{
+        user: "user";
+        self: "self";
+        other: "other";
+    }>;
+    relationship: z.ZodEnum<{
+        friend: "friend";
+        romantic: "romantic";
+        authority: "authority";
+        stranger: "stranger";
+    }>;
+    intensity: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    search_memory: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LLMEventResponseWithToolsOutput = z.infer<typeof LLMEventResponseWithToolsSchema>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/cjs/llm/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/llm/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAuDhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAK5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;iBAarC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/llm/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAuDhC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoB/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAK5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQjC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;iBAarC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgB1C,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/cjs/llm/schema.js

@@ -1,7 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LLMResponseWithToolsSchema = exports.LLMResponseSchema = exports.AppraisalVectorSchema = void 0;
+exports.LLMEventResponseWithToolsSchema = exports.LLMResponseWithToolsSchema = exports.LLMEventResponseSchema = exports.LLMResponseSchema = exports.EventAppraisalSchema = exports.AppraisalVectorSchema = void 0;
 const zod_1 = require("zod");
+// Ontology constants inlined from @molroo-io/core (private package).
+// These must stay in sync with engine/core/src/modules/ontology/types.ts.
+const INTERACTION_TYPES = ['chat', 'inform', 'humor', 'express', 'goodbye'];
+const EVENT_TYPES = [
+    'praise', 'criticism', 'support', 'rejection',
+    'apology', 'request', 'betrayal', 'neglect',
+];
+const AGENT_ROLES = ['user', 'self', 'other'];
+const TARGET_ROLES = ['user', 'self', 'other'];
+const RELATIONSHIP_TYPES = ['friend', 'romantic', 'authority', 'stranger'];
 /** Clamp a number to [lo, hi]. */
 const clamp = (v, lo, hi) => Math.max(lo, Math.min(hi, v));
 /**
@@ -50,6 +60,17 @@ exports.AppraisalVectorSchema = zod_1.z.object({
         .describe('How much time pressure or immediate action is needed? 0: settled/past event/no rush, 0.5: moderate, 1: immediate action required/acute emergency. For past losses: low. For active threats: high. Use 0-1 range.')
         .transform((v) => clamp(v, 0, 1)),
 });
+exports.EventAppraisalSchema = zod_1.z.object({
+    interaction_type: zod_1.z.enum(INTERACTION_TYPES).describe('Conversation mode: chat (small talk), inform (sharing info/news), humor (jokes), express (emotional/relational event), goodbye (farewell).'),
+    event_type: zod_1.z.enum(EVENT_TYPES).optional().describe('Relationship event type. Required when interaction_type is "express". Omit for chat/inform/humor/goodbye. One of: praise, criticism, support, rejection, apology, request, betrayal, neglect.'),
+    agent_role: zod_1.z.enum(AGENT_ROLES).describe('Primary role responsible for the event from the persona perspective: user, self, or other.'),
+    target_role: zod_1.z.enum(TARGET_ROLES).describe('Who is affected by or receives the event: self (persona), user (conversation partner), or other (third party).'),
+    relationship: zod_1.z.enum(RELATIONSHIP_TYPES).describe('Relationship context for this event: friend, romantic, authority, or stranger.'),
+    intensity: zod_1.z
+        .number()
+        .describe('Impact strength from 0 to 1.5. Use 1.0 for a normal event and >1.0 for unusually strong events.')
+        .transform((v) => clamp(v, 0, 1.5)),
+});
 /**
  * Full LLM response schema — response text + appraisal vector.
  */
@@ -57,6 +78,15 @@ exports.LLMResponseSchema = zod_1.z.object({
     response: zod_1.z.string().describe('Response message from persona to user'),
     appraisal: exports.AppraisalVectorSchema.describe("Scherer 9-dimensional emotion appraisal of user input from persona's perspective"),
 });
+exports.LLMEventResponseSchema = zod_1.z.object({
+    response: zod_1.z.string().describe('Response message from persona to user'),
+    interaction_type: exports.EventAppraisalSchema.shape.interaction_type,
+    event_type: exports.EventAppraisalSchema.shape.event_type,
+    agent_role: exports.EventAppraisalSchema.shape.agent_role,
+    target_role: exports.EventAppraisalSchema.shape.target_role,
+    relationship: exports.EventAppraisalSchema.shape.relationship,
+    intensity: exports.EventAppraisalSchema.shape.intensity,
+});
 /**
  * Tool-use aware LLM response schema.
  * The LLM can either produce a normal response or request a memory search.
@@ -70,3 +100,16 @@ exports.LLMResponseWithToolsSchema = zod_1.z.object({
         .optional()
         .describe('If you need to recall a specific memory before responding, set this to your search query. Leave empty/omit when you can respond without searching.'),
 });
+exports.LLMEventResponseWithToolsSchema = zod_1.z.object({
+    response: zod_1.z.string().describe('Response message from persona to user. Set to empty string "" if you need to search memory first.'),
+    interaction_type: exports.EventAppraisalSchema.shape.interaction_type,
+    event_type: exports.EventAppraisalSchema.shape.event_type,
+    agent_role: exports.EventAppraisalSchema.shape.agent_role,
+    target_role: exports.EventAppraisalSchema.shape.target_role,
+    relationship: exports.EventAppraisalSchema.shape.relationship,
+    intensity: exports.EventAppraisalSchema.shape.intensity,
+    search_memory: zod_1.z
+        .string()
+        .optional()
+        .describe('If you need to recall a specific memory before responding, set this to your search query. Leave empty/omit when you can respond without searching.'),
+});

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

@@ -5,7 +5,7 @@
  * All external dependencies are injected via ChatOrchestratorDeps.
  */
 import type { LLMAdapter, Message } from '../llm/adapter';
-import type { AgentResponse, InterlocutorContext, PerceiveOptions } from '../types';
+import type { AgentResponse, AppraisalMode, InterlocutorContext, PerceiveOptions } from '../types';
 import type { RecallLimits } from '../memory/types';
 import type { MemoryAdapter } from '../memory/types';
 import type { EventAdapter } from '../events/types';
@@ -21,6 +21,7 @@ export interface ChatOrchestratorDeps {
     memoryAdapter: MemoryAdapter | null;
     memoryRecallConfig: RecallLimits | undefined;
     events: EventAdapter | null;
+    appraisalMode: AppraisalMode;
     getPromptContext: (consumerSuffix?: string, sourceEntity?: string) => Promise<PromptContextResult>;
     perceive: (message: string, options?: PerceiveOptions) => Promise<AgentResponse>;
     searchMemory: (query: string) => Promise<Array<Record<string, unknown>>>;

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

@@ -1 +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"}
+{"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,EACb,aAAa,EAIb,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;AA6EpD,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,aAAa,EAAE,aAAa,CAAC;IAC7B,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,CAiKlH"}