@molroo-io/sdk 0.5.2

package/dist/esm/events/webhook.js

@@ -0,0 +1,75 @@
+import { createHmac } from 'node:crypto';
+/**
+ * Webhook-based EventAdapter for production event delivery.
+ * Sends events as POST requests with optional HMAC signing and retry.
+ */
+export class WebhookEventAdapter {
+    constructor(options) {
+        this.url = options.url;
+        this.secret = options.secret;
+        this.maxRetries = options.maxRetries ?? 2;
+        this.timeoutMs = options.timeoutMs ?? 5000;
+        this.headers = options.headers ?? {};
+    }
+    async emit(event) {
+        await this.post(event);
+    }
+    async emitBatch(events) {
+        await this.post(events);
+    }
+    async post(body) {
+        const jsonBody = JSON.stringify(body);
+        const timestamp = Math.floor(Date.now() / 1000);
+        const headers = {
+            'Content-Type': 'application/json',
+            ...this.headers,
+        };
+        if (this.secret) {
+            const signature = this.sign(timestamp, jsonBody);
+            headers['X-Molroo-Signature'] = `t=${timestamp},v1=${signature}`;
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            if (attempt > 0) {
+                await sleep(200 * Math.pow(2, attempt - 1));
+            }
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+            try {
+                const response = await fetch(this.url, {
+                    method: 'POST',
+                    headers,
+                    body: jsonBody,
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                if (response.ok)
+                    return;
+                if (response.status >= 400 && response.status < 500) {
+                    throw new Error(`Webhook rejected: ${response.status} ${response.statusText}`);
+                }
+                lastError = new Error(`Webhook failed: ${response.status} ${response.statusText}`);
+            }
+            catch (err) {
+                clearTimeout(timer);
+                if (err.name === 'AbortError') {
+                    lastError = new Error(`Webhook timeout after ${this.timeoutMs}ms`);
+                }
+                else if (err.message?.startsWith('Webhook rejected')) {
+                    throw err;
+                }
+                else {
+                    lastError = err;
+                }
+            }
+        }
+        throw lastError ?? new Error('Webhook delivery failed');
+    }
+    sign(timestamp, body) {
+        const payload = `${timestamp}.${body}`;
+        return createHmac('sha256', this.secret).update(payload).digest('hex');
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

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

@@ -0,0 +1,16 @@
+import type { LLMAdapter } from '../llm/adapter';
+import type { PersonaConfigData } from '../types';
+/**
+ * Generate a structured persona from a natural language character description.
+ *
+ * Uses LLM structured output to extract HEXACO personality traits, identity,
+ * goals, and narrative fields from free-form text.
+ *
+ * Returns a `PersonaConfigData` that can be passed directly to `MolrooPersona.create()`.
+ *
+ * @param llm - LLMAdapter instance (built-in or custom)
+ * @param description - Free-form character description (markdown accepted)
+ * @returns Persona config ready for MolrooPersona.create()
+ */
+export declare function generatePersona(llm: LLMAdapter, description: string): Promise<PersonaConfigData>;
+//# sourceMappingURL=persona.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../../src/generate/persona.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAY,MAAM,UAAU,CAAC;AAI5D;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,UAAU,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CA6B5B"}

package/dist/esm/generate/persona.js

@@ -0,0 +1,39 @@
+import { GeneratePersonaSchema } from './schema';
+import { buildSystemPrompt } from './prompt';
+/**
+ * Generate a structured persona from a natural language character description.
+ *
+ * Uses LLM structured output to extract HEXACO personality traits, identity,
+ * goals, and narrative fields from free-form text.
+ *
+ * Returns a `PersonaConfigData` that can be passed directly to `MolrooPersona.create()`.
+ *
+ * @param llm - LLMAdapter instance (built-in or custom)
+ * @param description - Free-form character description (markdown accepted)
+ * @returns Persona config ready for MolrooPersona.create()
+ */
+export async function generatePersona(llm, description) {
+    const system = buildSystemPrompt();
+    const { object: raw } = await llm.generateObject({
+        system,
+        messages: [{ role: 'user', content: description }],
+        schema: GeneratePersonaSchema,
+    });
+    const identity = {
+        name: raw.persona.identity.name,
+        role: raw.persona.identity.role,
+        speakingStyle: raw.persona.identity.speaking_style,
+        coreValues: raw.persona.identity.core_values,
+    };
+    if (raw.character_backstory) {
+        identity.description = raw.character_backstory;
+    }
+    if (raw.behavior_rules) {
+        identity.extensions = { 'Behavior Rules': raw.behavior_rules };
+    }
+    return {
+        identity,
+        personality: raw.persona.personality,
+        goals: raw.persona.goals,
+    };
+}

package/dist/esm/generate/prompt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * System prompt for generatePersona() LLM call.
+ * Based on packages/api/src/presets/guide-data.ts — embedded as static text
+ * to avoid runtime dependency on the API package.
+ */
+export declare function buildSystemPrompt(): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/esm/generate/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/generate/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,wBAAgB,iBAAiB,IAAI,MAAM,CAgB1C"}

package/dist/esm/generate/prompt.js

@@ -0,0 +1,38 @@
+/**
+ * System prompt for generatePersona() LLM call.
+ * Based on packages/api/src/presets/guide-data.ts — embedded as static text
+ * to avoid runtime dependency on the API package.
+ */
+const HEXACO_GUIDE = `Personality traits (HEXACO model, each 0.0 to 1.0):
+- O (Openness to Experience): 0.0=prefers familiar routines, practical, concrete → 1.0=highly creative, seeks novel experiences, abstract thinker
+- C (Conscientiousness): 0.0=spontaneous, impulsive, dislikes rigid schedules → 1.0=extremely organized, reliable, self-disciplined
+- E (Extraversion): 0.0=prefers solitude, reserved, finds social interaction draining → 1.0=sociable, energized by crowds, talkative, assertive
+- A (Agreeableness): 0.0=competitive, skeptical of others, blunt and critical → 1.0=warm, trusting, helpful, empathetic, avoids conflict
+- N (Emotionality): 0.0=emotionally stable, handles stress well, calm under pressure → 1.0=emotionally reactive, sensitive to stress, prone to anxiety
+- H (Honesty-Humility): 0.0=strategic with truth, values status, self-promoting → 1.0=sincere, fair, humble, avoids manipulation`;
+const GUIDELINES = `Guidelines:
+- Infer personality values from the character's described behavior, backstory, and temperament.
+- speaking_style must be specific: include tone, speech patterns, verbal habits, language level.
+- core_values: 3-5 abstract values that drive the character's decisions.
+- goals: 0-5 goals the character pursues. priority 0.0-1.0, mutable=false for core goals, true for flexible ones. An empty array is valid for goalless/apathetic characters.
+- character_backstory: background narrative that shapes the character. Expand if sparse, but don't invent contradictions. Max 4000 chars. Omit if not relevant.
+- behavior_rules: explicit behavioral constraints. Max 2000 chars. Omit if not relevant.
+- Keep all text faithful to the original description.
+- Return ONLY the JSON object. No markdown fences, no explanation.`;
+export function buildSystemPrompt() {
+    return `You are a character design assistant for an emotion simulation engine.
+Given a character description, extract structured data and return a valid JSON object.
+
+The personality values you assign will directly drive a psychological simulation model.
+These are not labels — they are numeric parameters that determine how the character:
+- Processes emotions (reactivity, stability, recovery speed)
+- Pursues goals (persistence, adaptability, reactance to control)
+- Forms relationships (trust speed, attachment style, social energy)
+- Narrates their life (redemption vs contamination arcs, agency, coherence)
+
+Be precise and intentional with each value.
+
+${HEXACO_GUIDE}
+
+${GUIDELINES}`;
+}

package/dist/esm/generate/schema.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+/**
+ * Zod schema for LLM-generated persona output.
+ * Used with LLMProvider.generate() for structured extraction.
+ */
+export declare const GeneratePersonaSchema: z.ZodObject<{
+    persona: z.ZodObject<{
+        identity: z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            core_values: z.ZodArray<z.ZodString>;
+            speaking_style: z.ZodString;
+        }, z.core.$strip>;
+        personality: z.ZodObject<{
+            O: z.ZodNumber;
+            C: z.ZodNumber;
+            E: z.ZodNumber;
+            A: z.ZodNumber;
+            N: z.ZodNumber;
+            H: z.ZodNumber;
+        }, z.core.$strip>;
+        goals: z.ZodArray<z.ZodObject<{
+            content: z.ZodString;
+            priority: z.ZodNumber;
+            mutable: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    character_backstory: z.ZodOptional<z.ZodString>;
+    behavior_rules: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GeneratePersonaSchemaOutput = z.infer<typeof GeneratePersonaSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/esm/generate/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/generate/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;iBA+ChC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/esm/generate/schema.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/**
+ * Zod schema for LLM-generated persona output.
+ * Used with LLMProvider.generate() for structured extraction.
+ */
+export const GeneratePersonaSchema = z.object({
+    persona: z.object({
+        identity: z.object({
+            name: z.string().describe('Character name'),
+            role: z
+                .string()
+                .optional()
+                .describe('One-line role or title'),
+            core_values: z
+                .array(z.string())
+                .min(3)
+                .max(5)
+                .describe('Abstract values that drive the character (3-5)'),
+            speaking_style: z
+                .string()
+                .describe('Specific speech patterns: tone, mannerisms, verbal habits, language level'),
+        }),
+        personality: z.object({
+            O: z.number().min(0).max(1).describe('Openness to Experience: 0=conventional → 1=creative'),
+            C: z.number().min(0).max(1).describe('Conscientiousness: 0=spontaneous → 1=organized'),
+            E: z.number().min(0).max(1).describe('Extraversion: 0=introverted → 1=sociable'),
+            A: z.number().min(0).max(1).describe('Agreeableness: 0=competitive → 1=cooperative'),
+            N: z.number().min(0).max(1).describe('Emotionality: 0=stable → 1=reactive'),
+            H: z.number().min(0).max(1).describe('Honesty-Humility: 0=manipulative → 1=sincere'),
+        }),
+        goals: z
+            .array(z.object({
+            content: z.string().describe('What the character wants to achieve'),
+            priority: z.number().min(0).max(1).describe('Goal importance (0-1)'),
+            mutable: z.boolean().describe('false for core identity goals, true for flexible ones'),
+        }))
+            .min(0)
+            .max(5)
+            .describe('Character goals (0-5). Empty array for goalless characters.'),
+    }),
+    character_backstory: z
+        .string()
+        .max(4000)
+        .optional()
+        .describe('Background narrative shaping worldview and behavior (max 4000 chars)'),
+    behavior_rules: z
+        .string()
+        .max(2000)
+        .optional()
+        .describe('Explicit behavior rules and constraints (max 2000 chars)'),
+});

package/dist/esm/generated/index.d.ts

@@ -0,0 +1,2 @@
+export type { paths, components, operations } from './api';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/generated/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generated/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC"}

package/dist/esm/generated/index.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @molroo-io/sdk - Thin Client SDK for molroo emotion engine
+ *
+ * ## Boundary — this is where LLM orchestration lives:
+ * - **LLM calls happen HERE** — consumer's API key, consumer's model.
+ * - **Appraisal generation happens HERE** — LLM produces appraisal, SDK sends to API.
+ * - **Memory recall happens HERE** — episodic/semantic/reflections from client stores.
+ * - **Prompt composition**: API returns persona fragment → SDK adds memory context.
+ *
+ * The API/engine never call LLM. This SDK is the bridge.
+ *
+ * @example
+ * ```typescript
+ * import { MolrooPersona } from '@molroo-io/sdk';
+ * import { createVercelAIAdapter } from '@molroo-io/sdk';
+ *
+ * const llm = createVercelAIAdapter({
+ *   provider: 'openai',
+ *   apiKey: process.env.OPENAI_API_KEY!,
+ * });
+ *
+ * const persona = await MolrooPersona.create({
+ *   baseUrl: 'https://api.molroo.io',
+ *   apiKey: 'your_api_key',
+ *   llm,
+ * }, {
+ *   config: { identity: { name: 'Sera' }, personality: { O: 0.7, C: 0.6, E: 0.8, A: 0.5, N: 0.3, H: 0.6 } },
+ * });
+ *
+ * const result = await persona.chat('Hello!');
+ * ```
+ */
+export { MolrooPersona } from './persona';
+export { MolrooApiError } from './types';
+export type { LLMAdapter, Message, GenerateTextOptions, GenerateObjectOptions, } from './llm/adapter';
+export type { LLMShorthand, LLMInput } from './llm/resolve';
+export { VercelAIAdapter, createVercelAIAdapter } from './llm/vercel-ai';
+export type { VercelAIConfig } from './llm/vercel-ai';
+export type { MemoryAdapter, RecallQuery, SemanticRecallOptions, RecallLimits, } from './memory/types';
+export { isMemoryConfig } from './memory/types';
+export type { EpisodeAdapter, EpisodeQuery, SemanticAdapter, SemanticEntry, SemanticQuery, SemanticResult, EmbeddingAdapter, MemoryConfig, Reflection, } from './memory/types';
+export { InMemoryEpisodeAdapter } from './memory/in-memory';
+export type { RecallConfig } from './memory/recall';
+export type { SemanticMemory, SearchOptions, SearchResult } from './memory/semantic';
+export { InMemorySemanticMemory } from './memory/in-memory-semantic';
+export type { EpisodeStore, SemanticStore, EmbeddingProvider } from './memory/types';
+export { InMemoryEpisodeStore } from './memory/in-memory';
+export type { EventAdapter, SDKEvent, SDKEventType, PersonaEventType } from './events/types';
+export { ConsoleEventAdapter } from './events/console';
+export type { ConsoleEventAdapterOptions } from './events/console';
+export { WebhookEventAdapter } from './events/webhook';
+export type { WebhookEventAdapterOptions } from './events/webhook';
+export { generatePersona } from './generate/persona';
+export { GeneratePersonaSchema } from './generate/schema';
+export type { GeneratePersonaSchemaOutput } from './generate/schema';
+export type { MolrooPersonaConfig, PersonaSummary, PersonaState, PersonaChatResult, } from './persona';
+export type { 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 { AppraisalVectorSchema, LLMResponseSchema, LLMResponseWithToolsSchema, } from './llm/schema';
+export type { LLMResponseOutput, LLMResponseWithToolsOutput } from './llm/schema';
+export type { LLMPrompt, LLMResponse, } from './llm/types';
+export type { ChatMessage } from './llm/types';
+export { DEFAULT_PERSONA, withDefaults } from './defaults';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -0,0 +1,49 @@
+/**
+ * @molroo-io/sdk - Thin Client SDK for molroo emotion engine
+ *
+ * ## Boundary — this is where LLM orchestration lives:
+ * - **LLM calls happen HERE** — consumer's API key, consumer's model.
+ * - **Appraisal generation happens HERE** — LLM produces appraisal, SDK sends to API.
+ * - **Memory recall happens HERE** — episodic/semantic/reflections from client stores.
+ * - **Prompt composition**: API returns persona fragment → SDK adds memory context.
+ *
+ * The API/engine never call LLM. This SDK is the bridge.
+ *
+ * @example
+ * ```typescript
+ * import { MolrooPersona } from '@molroo-io/sdk';
+ * import { createVercelAIAdapter } from '@molroo-io/sdk';
+ *
+ * const llm = createVercelAIAdapter({
+ *   provider: 'openai',
+ *   apiKey: process.env.OPENAI_API_KEY!,
+ * });
+ *
+ * const persona = await MolrooPersona.create({
+ *   baseUrl: 'https://api.molroo.io',
+ *   apiKey: 'your_api_key',
+ *   llm,
+ * }, {
+ *   config: { identity: { name: 'Sera' }, personality: { O: 0.7, C: 0.6, E: 0.8, A: 0.5, N: 0.3, H: 0.6 } },
+ * });
+ *
+ * const result = await persona.chat('Hello!');
+ * ```
+ */
+// ── Main exports ──
+export { MolrooPersona } from './persona';
+export { MolrooApiError } from './types';
+export { VercelAIAdapter, createVercelAIAdapter } from './llm/vercel-ai';
+export { isMemoryConfig } from './memory/types';
+export { InMemoryEpisodeAdapter } from './memory/in-memory';
+export { InMemorySemanticMemory } from './memory/in-memory-semantic';
+export { InMemoryEpisodeStore } from './memory/in-memory';
+export { ConsoleEventAdapter } from './events/console';
+export { WebhookEventAdapter } from './events/webhook';
+// ── Generate ──
+export { generatePersona } from './generate/persona';
+export { GeneratePersonaSchema } from './generate/schema';
+// ── LLM types & schemas ──
+export { AppraisalVectorSchema, LLMResponseSchema, LLMResponseWithToolsSchema, } from './llm/schema';
+// ── Defaults ──
+export { DEFAULT_PERSONA, withDefaults } from './defaults';

package/dist/esm/llm/adapter.d.ts

@@ -0,0 +1,61 @@
+import type { ZodSchema } from 'zod';
+/**
+ * Message format for LLM conversations.
+ * Compatible with Vercel AI SDK message format.
+ */
+export interface Message {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+/**
+ * Base options for text generation.
+ */
+export interface GenerateTextOptions {
+    model?: string;
+    system?: string;
+    messages: Message[];
+    temperature?: number;
+    maxTokens?: number;
+}
+/**
+ * Base options for object generation.
+ */
+export interface GenerateObjectOptions<T> {
+    model?: string;
+    system?: string;
+    messages: Message[];
+    schema: ZodSchema<T>;
+    temperature?: number;
+}
+/**
+ * LLM Adapter interface for molroo SDK.
+ *
+ * Abstracts LLM interactions so consumers can:
+ * - Use the built-in adapter (Vercel AI SDK: OpenAI/Anthropic/Vertex)
+ * - Bring their own LLM integration (Ollama, vLLM, custom pipeline)
+ * - Skip LLM entirely (emotion-only usage)
+ *
+ * Interface follows Vercel AI SDK conventions for familiarity.
+ */
+export interface LLMAdapter {
+    /**
+     * Generate plain text from messages.
+     *
+     * @param options - Generation options including messages and optional system prompt
+     * @returns Object containing generated text
+     */
+    generateText(options: GenerateTextOptions): Promise<{
+        text: string;
+    }>;
+    /**
+     * Generate structured object matching the provided Zod schema.
+     *
+     * @param options - Generation options including messages, system prompt, and schema
+     * @returns Object containing parsed structured output
+     */
+    generateObject<T>(options: GenerateObjectOptions<T>): Promise<{
+        object: T;
+    }>;
+}
+export type { Message as ChatMessage };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/esm/llm/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/llm/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAC9E;AAGD,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC"}

package/dist/esm/llm/adapter.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/llm/resolve.d.ts

@@ -0,0 +1,28 @@
+import type { LLMAdapter } from './adapter';
+/**
+ * Shorthand config for creating an LLM adapter without importing a separate package.
+ *
+ * @example
+ * ```typescript
+ * const persona = await MolrooPersona.create({
+ *   baseUrl, apiKey,
+ *   llm: { provider: 'openai', apiKey: '...' },
+ * }, config);
+ * ```
+ */
+export interface LLMShorthand {
+    provider: 'openai' | 'anthropic' | 'vertex' | 'openrouter';
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+    projectId?: string;
+    location?: string;
+}
+/** LLM adapter or shorthand config. */
+export type LLMInput = LLMAdapter | LLMShorthand;
+/**
+ * Resolve an LLMInput to an LLMAdapter.
+ * If a shorthand config is given, creates a VercelAIAdapter directly.
+ */
+export declare function resolveLLM(input: LLMInput): Promise<LLMAdapter>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/esm/llm/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/llm/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uCAAuC;AACvC,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAYjD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAGrE"}

package/dist/esm/llm/resolve.js

@@ -0,0 +1,17 @@
+import { createVercelAIAdapter } from './vercel-ai';
+function isShorthand(input) {
+    return (input != null &&
+        typeof input === 'object' &&
+        'provider' in input &&
+        'apiKey' in input &&
+        !('generateText' in input));
+}
+/**
+ * Resolve an LLMInput to an LLMAdapter.
+ * If a shorthand config is given, creates a VercelAIAdapter directly.
+ */
+export async function resolveLLM(input) {
+    if (!isShorthand(input))
+        return input;
+    return createVercelAIAdapter(input);
+}

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

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+/**
+ * AppraisalVector Schema — Scherer CPM 9-dimensional emotion appraisal.
+ * LLM evaluates user input from persona's perspective.
+ *
+ * Each field accepts any number from LLM output, then clamps to the valid
+ * range via .transform(). This tolerates LLM outputs outside the intended
+ * range (e.g. -3.0) without failing Zod parsing.
+ */
+export declare const AppraisalVectorSchema: z.ZodObject<{
+    goal_relevance: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    goal_congruence: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    expectedness: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    controllability: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    agency: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    norm_compatibility: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    internal_standards: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    adjustment_potential: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    urgency: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+}, z.core.$strip>;
+/**
+ * Full LLM response schema — response text + appraisal vector.
+ */
+export declare const LLMResponseSchema: z.ZodObject<{
+    response: z.ZodString;
+    appraisal: z.ZodObject<{
+        goal_relevance: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        goal_congruence: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        expectedness: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        controllability: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        agency: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        norm_compatibility: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        internal_standards: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        adjustment_potential: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        urgency: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type LLMResponseOutput = z.infer<typeof LLMResponseSchema>;
+/**
+ * Tool-use aware LLM response schema.
+ * The LLM can either produce a normal response or request a memory search.
+ * When search_memory is set, the SDK executes the search and re-invokes the LLM.
+ */
+export declare const LLMResponseWithToolsSchema: z.ZodObject<{
+    response: z.ZodString;
+    appraisal: z.ZodObject<{
+        goal_relevance: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        goal_congruence: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        expectedness: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        controllability: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        agency: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        norm_compatibility: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        internal_standards: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        adjustment_potential: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        urgency: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    }, z.core.$strip>;
+    search_memory: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LLMResponseWithToolsOutput = z.infer<typeof LLMResponseWithToolsSchema>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +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"}