@molroo-io/sdk 0.5.2

package/dist/cjs/events/console.d.ts

@@ -0,0 +1,25 @@
+import type { EventAdapter, SDKEvent } from './types';
+export interface ConsoleEventAdapterOptions {
+    /** Prefix for log lines. Default: '[molroo]'. */
+    prefix?: string;
+    /** Only emit these event types. Empty = all. */
+    filter?: string[];
+    /** Output format. Default: 'human'. */
+    format?: 'human' | 'json';
+    /** Custom logger function. Default: console.log. */
+    logger?: (message: string) => void;
+}
+/**
+ * Console-based EventAdapter for development/debugging.
+ * Logs events to console (or a custom logger function).
+ */
+export declare class ConsoleEventAdapter implements EventAdapter {
+    private prefix;
+    private filter;
+    private format;
+    private logger;
+    constructor(options?: ConsoleEventAdapterOptions);
+    emit(event: SDKEvent): Promise<void>;
+    emitBatch(events: SDKEvent[]): Promise<void>;
+}
+//# sourceMappingURL=console.d.ts.map

package/dist/cjs/events/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/events/console.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,0BAA0B;IACzC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,oDAAoD;IACpD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAA4B;gBAE9B,OAAO,CAAC,EAAE,0BAA0B;IAO1C,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAapC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKnD"}

package/dist/cjs/events/console.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleEventAdapter = void 0;
+/**
+ * Console-based EventAdapter for development/debugging.
+ * Logs events to console (or a custom logger function).
+ */
+class ConsoleEventAdapter {
+    constructor(options) {
+        this.prefix = options?.prefix ?? '[molroo]';
+        this.filter = new Set(options?.filter ?? []);
+        this.format = options?.format ?? 'human';
+        this.logger = options?.logger ?? console.log;
+    }
+    async emit(event) {
+        if (this.filter.size > 0 && !this.filter.has(event.type)) {
+            return;
+        }
+        if (this.format === 'json') {
+            this.logger(`${this.prefix} ${JSON.stringify(event)}`);
+        }
+        else {
+            const time = new Date(event.timestamp).toISOString();
+            this.logger(`${this.prefix} ${time} ${event.type}: ${summarize(event.payload)}`);
+        }
+    }
+    async emitBatch(events) {
+        for (const event of events) {
+            await this.emit(event);
+        }
+    }
+}
+exports.ConsoleEventAdapter = ConsoleEventAdapter;
+function summarize(payload) {
+    const keys = Object.keys(payload);
+    if (keys.length === 0)
+        return '{}';
+    if (keys.length <= 3)
+        return JSON.stringify(payload);
+    return `{${keys.slice(0, 3).join(', ')} + ${keys.length - 3} more}`;
+}

package/dist/cjs/events/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Event Adapter interface for molroo SDK.
+ *
+ * Abstracts event emission so consumers can:
+ * - Log emotion changes, relationship updates, stage transitions
+ * - Send webhooks, push notifications, analytics events
+ * - Build reactive UIs that respond to persona state changes
+ *
+ * Events are derived from API response data (AgentResponse fields).
+ * Implementations are provided by the consumer — SDK only defines the interface.
+ */
+/** Persona-scoped event types — emitted from persona state changes. */
+export type PersonaEventType = 'emotion_changed' | 'relationship_changed' | 'memory_consolidated' | 'reflection_generated' | 'stage_transition' | 'mask_exposure' | 'goal_changed';
+export type SDKEventType = PersonaEventType;
+export interface SDKEvent {
+    type: SDKEventType;
+    /** Present for persona-scoped events. Absent for world-scoped events. */
+    personaId?: string;
+    timestamp: number;
+    payload: Record<string, unknown>;
+}
+export interface EventAdapter {
+    /** Emit a single event. */
+    emit(event: SDKEvent): Promise<void>;
+    /** Emit multiple events in batch. Optional — falls back to sequential emit(). */
+    emitBatch?(events: SDKEvent[]): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/events/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,kBAAkB,GAClB,eAAe,GACf,cAAc,CAAC;AAEnB,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,iFAAiF;IACjF,SAAS,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C"}

package/dist/cjs/events/types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Event Adapter interface for molroo SDK.
+ *
+ * Abstracts event emission so consumers can:
+ * - Log emotion changes, relationship updates, stage transitions
+ * - Send webhooks, push notifications, analytics events
+ * - Build reactive UIs that respond to persona state changes
+ *
+ * Events are derived from API response data (AgentResponse fields).
+ * Implementations are provided by the consumer — SDK only defines the interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/events/webhook.d.ts

@@ -0,0 +1,30 @@
+import type { EventAdapter, SDKEvent } from './types';
+export interface WebhookEventAdapterOptions {
+    /** Webhook endpoint URL. */
+    url: string;
+    /** HMAC secret for signing payloads. Optional. */
+    secret?: string;
+    /** Max retry attempts on server errors. Default: 2. */
+    maxRetries?: number;
+    /** Request timeout in ms. Default: 5000. */
+    timeoutMs?: number;
+    /** Additional HTTP headers. */
+    headers?: Record<string, string>;
+}
+/**
+ * Webhook-based EventAdapter for production event delivery.
+ * Sends events as POST requests with optional HMAC signing and retry.
+ */
+export declare class WebhookEventAdapter implements EventAdapter {
+    private url;
+    private secret?;
+    private maxRetries;
+    private timeoutMs;
+    private headers;
+    constructor(options: WebhookEventAdapterOptions);
+    emit(event: SDKEvent): Promise<void>;
+    emitBatch(events: SDKEvent[]): Promise<void>;
+    private post;
+    private sign;
+}
+//# sourceMappingURL=webhook.d.ts.map

package/dist/cjs/events/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/events/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGtD,MAAM,WAAW,0BAA0B;IACzC,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,EAAE,0BAA0B;IAQzC,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAIpC,IAAI;IAwDlB,OAAO,CAAC,IAAI;CAIb"}

package/dist/cjs/events/webhook.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookEventAdapter = void 0;
+const node_crypto_1 = require("node:crypto");
+/**
+ * Webhook-based EventAdapter for production event delivery.
+ * Sends events as POST requests with optional HMAC signing and retry.
+ */
+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 (0, node_crypto_1.createHmac)('sha256', this.secret).update(payload).digest('hex');
+    }
+}
+exports.WebhookEventAdapter = WebhookEventAdapter;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

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

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePersona = generatePersona;
+const schema_1 = require("./schema");
+const prompt_1 = require("./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()
+ */
+async function generatePersona(llm, description) {
+    const system = (0, prompt_1.buildSystemPrompt)();
+    const { object: raw } = await llm.generateObject({
+        system,
+        messages: [{ role: 'user', content: description }],
+        schema: schema_1.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/cjs/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/cjs/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/cjs/generate/prompt.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSystemPrompt = buildSystemPrompt;
+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.`;
+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/cjs/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/cjs/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/cjs/generate/schema.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneratePersonaSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Zod schema for LLM-generated persona output.
+ * Used with LLMProvider.generate() for structured extraction.
+ */
+exports.GeneratePersonaSchema = zod_1.z.object({
+    persona: zod_1.z.object({
+        identity: zod_1.z.object({
+            name: zod_1.z.string().describe('Character name'),
+            role: zod_1.z
+                .string()
+                .optional()
+                .describe('One-line role or title'),
+            core_values: zod_1.z
+                .array(zod_1.z.string())
+                .min(3)
+                .max(5)
+                .describe('Abstract values that drive the character (3-5)'),
+            speaking_style: zod_1.z
+                .string()
+                .describe('Specific speech patterns: tone, mannerisms, verbal habits, language level'),
+        }),
+        personality: zod_1.z.object({
+            O: zod_1.z.number().min(0).max(1).describe('Openness to Experience: 0=conventional → 1=creative'),
+            C: zod_1.z.number().min(0).max(1).describe('Conscientiousness: 0=spontaneous → 1=organized'),
+            E: zod_1.z.number().min(0).max(1).describe('Extraversion: 0=introverted → 1=sociable'),
+            A: zod_1.z.number().min(0).max(1).describe('Agreeableness: 0=competitive → 1=cooperative'),
+            N: zod_1.z.number().min(0).max(1).describe('Emotionality: 0=stable → 1=reactive'),
+            H: zod_1.z.number().min(0).max(1).describe('Honesty-Humility: 0=manipulative → 1=sincere'),
+        }),
+        goals: zod_1.z
+            .array(zod_1.z.object({
+            content: zod_1.z.string().describe('What the character wants to achieve'),
+            priority: zod_1.z.number().min(0).max(1).describe('Goal importance (0-1)'),
+            mutable: zod_1.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: zod_1.z
+        .string()
+        .max(4000)
+        .optional()
+        .describe('Background narrative shaping worldview and behavior (max 4000 chars)'),
+    behavior_rules: zod_1.z
+        .string()
+        .max(2000)
+        .optional()
+        .describe('Explicit behavior rules and constraints (max 2000 chars)'),
+});

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

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

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * @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!');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withDefaults = exports.DEFAULT_PERSONA = exports.LLMResponseWithToolsSchema = exports.LLMResponseSchema = exports.AppraisalVectorSchema = exports.GeneratePersonaSchema = exports.generatePersona = exports.WebhookEventAdapter = exports.ConsoleEventAdapter = exports.InMemoryEpisodeStore = exports.InMemorySemanticMemory = exports.InMemoryEpisodeAdapter = exports.isMemoryConfig = exports.createVercelAIAdapter = exports.VercelAIAdapter = exports.MolrooApiError = exports.MolrooPersona = void 0;
+// ── Main exports ──
+var persona_1 = require("./persona");
+Object.defineProperty(exports, "MolrooPersona", { enumerable: true, get: function () { return persona_1.MolrooPersona; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "MolrooApiError", { enumerable: true, get: function () { return types_1.MolrooApiError; } });
+var vercel_ai_1 = require("./llm/vercel-ai");
+Object.defineProperty(exports, "VercelAIAdapter", { enumerable: true, get: function () { return vercel_ai_1.VercelAIAdapter; } });
+Object.defineProperty(exports, "createVercelAIAdapter", { enumerable: true, get: function () { return vercel_ai_1.createVercelAIAdapter; } });
+var types_2 = require("./memory/types");
+Object.defineProperty(exports, "isMemoryConfig", { enumerable: true, get: function () { return types_2.isMemoryConfig; } });
+var in_memory_1 = require("./memory/in-memory");
+Object.defineProperty(exports, "InMemoryEpisodeAdapter", { enumerable: true, get: function () { return in_memory_1.InMemoryEpisodeAdapter; } });
+var in_memory_semantic_1 = require("./memory/in-memory-semantic");
+Object.defineProperty(exports, "InMemorySemanticMemory", { enumerable: true, get: function () { return in_memory_semantic_1.InMemorySemanticMemory; } });
+var in_memory_2 = require("./memory/in-memory");
+Object.defineProperty(exports, "InMemoryEpisodeStore", { enumerable: true, get: function () { return in_memory_2.InMemoryEpisodeStore; } });
+var console_1 = require("./events/console");
+Object.defineProperty(exports, "ConsoleEventAdapter", { enumerable: true, get: function () { return console_1.ConsoleEventAdapter; } });
+var webhook_1 = require("./events/webhook");
+Object.defineProperty(exports, "WebhookEventAdapter", { enumerable: true, get: function () { return webhook_1.WebhookEventAdapter; } });
+// ── Generate ──
+var persona_2 = require("./generate/persona");
+Object.defineProperty(exports, "generatePersona", { enumerable: true, get: function () { return persona_2.generatePersona; } });
+var schema_1 = require("./generate/schema");
+Object.defineProperty(exports, "GeneratePersonaSchema", { enumerable: true, get: function () { return schema_1.GeneratePersonaSchema; } });
+// ── LLM types & schemas ──
+var schema_2 = require("./llm/schema");
+Object.defineProperty(exports, "AppraisalVectorSchema", { enumerable: true, get: function () { return schema_2.AppraisalVectorSchema; } });
+Object.defineProperty(exports, "LLMResponseSchema", { enumerable: true, get: function () { return schema_2.LLMResponseSchema; } });
+Object.defineProperty(exports, "LLMResponseWithToolsSchema", { enumerable: true, get: function () { return schema_2.LLMResponseWithToolsSchema; } });
+// ── Defaults ──
+var defaults_1 = require("./defaults");
+Object.defineProperty(exports, "DEFAULT_PERSONA", { enumerable: true, get: function () { return defaults_1.DEFAULT_PERSONA; } });
+Object.defineProperty(exports, "withDefaults", { enumerable: true, get: function () { return defaults_1.withDefaults; } });