@molroo-io/sdk 0.7.2 → 0.8.2

package/dist/esm/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/esm/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/esm/expression/index.js

@@ -0,0 +1,17 @@
+/**
+ * @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 {};

package/dist/esm/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/esm/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/esm/index.js

@@ -33,5 +33,7 @@ export { Molroo } from './world/world';
 export { MolrooApiError, WorldApiError } from './shared/errors';
 // ── Shared utilities ──
 export { NEUTRAL_APPRAISAL, toWireAppraisal, fromWireAppraisal } from './shared/appraisal';
+// ── Emotion labels (synced with engine/core) ──
+export { EMOTION_LABELS } from './emotion';
 // ── Defaults ──
 export { DEFAULT_PERSONA, withDefaults } from './defaults';

package/dist/esm/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/esm/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/esm/llm/schema.js

@@ -1,4 +1,14 @@
 import { z } from '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));
 /**
@@ -47,6 +57,17 @@ export const AppraisalVectorSchema = 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)),
 });
+export const EventAppraisalSchema = z.object({
+    interaction_type: z.enum(INTERACTION_TYPES).describe('Conversation mode: chat (small talk), inform (sharing info/news), humor (jokes), express (emotional/relational event), goodbye (farewell).'),
+    event_type: 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: z.enum(AGENT_ROLES).describe('Primary role responsible for the event from the persona perspective: user, self, or other.'),
+    target_role: z.enum(TARGET_ROLES).describe('Who is affected by or receives the event: self (persona), user (conversation partner), or other (third party).'),
+    relationship: z.enum(RELATIONSHIP_TYPES).describe('Relationship context for this event: friend, romantic, authority, or stranger.'),
+    intensity: 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.
  */
@@ -54,6 +75,15 @@ export const LLMResponseSchema = z.object({
     response: z.string().describe('Response message from persona to user'),
     appraisal: AppraisalVectorSchema.describe("Scherer 9-dimensional emotion appraisal of user input from persona's perspective"),
 });
+export const LLMEventResponseSchema = z.object({
+    response: z.string().describe('Response message from persona to user'),
+    interaction_type: EventAppraisalSchema.shape.interaction_type,
+    event_type: EventAppraisalSchema.shape.event_type,
+    agent_role: EventAppraisalSchema.shape.agent_role,
+    target_role: EventAppraisalSchema.shape.target_role,
+    relationship: EventAppraisalSchema.shape.relationship,
+    intensity: EventAppraisalSchema.shape.intensity,
+});
 /**
  * Tool-use aware LLM response schema.
  * The LLM can either produce a normal response or request a memory search.
@@ -67,3 +97,16 @@ export const LLMResponseWithToolsSchema = 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.'),
 });
+export const LLMEventResponseWithToolsSchema = z.object({
+    response: z.string().describe('Response message from persona to user. Set to empty string "" if you need to search memory first.'),
+    interaction_type: EventAppraisalSchema.shape.interaction_type,
+    event_type: EventAppraisalSchema.shape.event_type,
+    agent_role: EventAppraisalSchema.shape.agent_role,
+    target_role: EventAppraisalSchema.shape.target_role,
+    relationship: EventAppraisalSchema.shape.relationship,
+    intensity: EventAppraisalSchema.shape.intensity,
+    search_memory: 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/esm/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/esm/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"}

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

@@ -29,6 +29,49 @@ function buildInterlocutorBlock(ctx) {
     }
     return parts.join('\n');
 }
+function buildDirectAppraisalInstruction() {
+    return [
+        '',
+        '## Appraisal Task',
+        "Evaluate how RECEIVING the user's message affects this persona emotionally.",
+        'The event you are appraising is the message itself arriving, not the described situation.',
+        "When the user shares their own experience, appraise through the persona's relational goals.",
+        "Rate each dimension from the persona's subjective perspective.",
+        'An insult should produce negative goal_congruence and norm_compatibility.',
+        'A compliment should produce positive values. Neutral small talk should be near zero.',
+    ].join('\n');
+}
+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;
@@ -62,30 +105,33 @@ 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 { AppraisalVectorSchema } = await import('../llm/schema');
-        const appraisalInstruction = [
-            '',
-            '## Appraisal Task',
-            "Evaluate how RECEIVING the user's message affects this persona emotionally.",
-            'The event you are appraising is the message itself arriving — not the described situation.',
-            "When the user shares their own experience (e.g. loss, success), appraise through the persona's relational goals: caring about the speaker makes their suffering relevant and incongruent.",
-            "Rate each dimension from the persona's subjective perspective.",
-            'An insult should produce negative goal_congruence and norm_compatibility.',
-            'A compliment should produce positive values. Neutral small talk should be near zero.',
-        ].join('\n');
         const appraisalMessages = messages.length <= 5 ? messages : messages.slice(-5);
-        const { object: appraisalResult } = await deps.engineLlm.generateObject({
-            system: systemPrompt + appraisalInstruction,
-            messages: appraisalMessages,
-            schema: AppraisalVectorSchema,
-        });
-        appraisal = clampAppraisal(appraisalResult);
+        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);
+        }
         earlyPerceiveResponse = await deps.perceive(message, {
             from,
-            appraisal,
+            ...(appraisal ? { appraisal } : {}),
+            ...(ontologyEvent ? { ontologyEvent } : {}),
             priorEpisodes: recalledEpisodes.length > 0 ? recalledEpisodes : undefined,
             skipMemory: true,
         });
@@ -112,17 +158,30 @@ export async function chat(deps, message, options) {
     else if (hasTools) {
         const result = await generateWithToolLoop(deps, systemPrompt, messages, options?.onToolCall);
         responseText = result.text;
-        appraisal = clampAppraisal(result.appraisal);
+        appraisal = result.appraisal;
+        ontologyEvent = result.ontologyEvent;
     }
     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 });
+        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 });
+        }
     }
     // 4. Send to API for emotion processing (skip if already done in split mode)
     let response;
@@ -132,7 +191,8 @@ export async function chat(deps, message, options) {
     else {
         response = await deps.perceive(responseText, {
             from,
-            appraisal: appraisal,
+            ...(appraisal ? { appraisal } : {}),
+            ...(ontologyEvent ? { ontologyEvent } : {}),
             priorEpisodes: recalledEpisodes.length > 0 ? recalledEpisodes : undefined,
             skipMemory: true,
         });
@@ -158,18 +218,53 @@ export async function chat(deps, message, options) {
 }
 async function generateWithToolLoop(deps, system, messages, onToolCall) {
     const MAX_TOOL_ITERATIONS = 3;
-    const { LLMResponseWithToolsSchema, LLMResponseSchema } = await import('../llm/schema');
+    const { LLMEventResponseSchema, LLMEventResponseWithToolsSchema, LLMResponseSchema, LLMResponseWithToolsSchema, } = await import('../llm/schema');
     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;
+            let episodes = [];
+            try {
+                episodes = await deps.searchMemory(query);
+            }
+            catch {
+                // Memory search failed — continue without results
+            }
+            if (onToolCall) {
+                onToolCall({ name: 'search_memory', args: { query }, result: episodes });
+            }
+            const resultBlock = episodes.length > 0
+                ? `\n\n## Memory Search Results (query: "${query}")\n${episodes.map(ep => {
+                    const ts = ep.timestamp ? new Date(ep.timestamp).toISOString() : 'unknown';
+                    const source = ep.sourceEntity ?? 'unknown';
+                    const context = ep.context ?? 'no context';
+                    return `- [${ts}] ${source}: ${context}`;
+                }).join('\n')}`
+                : `\n\n## Memory Search Results (query: "${query}")\nNo matching memories found.`;
+            currentSystem = currentSystem + resultBlock;
+            continue;
+        }
         const { object: llmResult } = await deps.llm.generateObject({
             system: currentSystem,
             messages,
             schema: LLMResponseWithToolsSchema,
         });
         if (!llmResult.search_memory) {
-            const text = llmResult.response;
-            const appraisal = llmResult.appraisal ?? { ...NEUTRAL_APPRAISAL };
-            return { text, appraisal };
+            return {
+                text: llmResult.response,
+                appraisal: clampAppraisal(llmResult.appraisal ?? { ...NEUTRAL_APPRAISAL }),
+            };
         }
         const query = llmResult.search_memory;
         let episodes = [];
@@ -192,6 +287,17 @@ async function generateWithToolLoop(deps, system, messages, onToolCall) {
             : `\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,
@@ -199,6 +305,6 @@ async function generateWithToolLoop(deps, system, messages, onToolCall) {
     });
     return {
         text: finalResult.response,
-        appraisal: finalResult.appraisal ?? { ...NEUTRAL_APPRAISAL },
+        appraisal: clampAppraisal(finalResult.appraisal ?? { ...NEUTRAL_APPRAISAL }),
     };
 }