@molroo-io/sdk 0.6.2 → 0.7.1

package/dist/cjs/world/world-persona.js

@@ -11,22 +11,7 @@ exports.WorldPersona = void 0;
  * 제공하되, 내부적으로 World API 엔드포인트를 사용한다.
  */
 const client_1 = require("./client");
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-function toApiAppraisal(v) {
-    return {
-        goal_relevance: v.goalRelevance,
-        goal_congruence: v.goalCongruence,
-        expectedness: v.expectedness,
-        controllability: v.controllability,
-        agency: v.agency,
-        norm_compatibility: v.normCompatibility,
-        internal_standards: v.internalStandards,
-        adjustment_potential: v.adjustmentPotential,
-        urgency: v.urgency,
-    };
-}
+const appraisal_1 = require("../shared/appraisal");
 class WorldPersona {
     /** @internal — use World.persona() instead. */
     constructor(client, worldId, personaId, options) {
@@ -62,7 +47,10 @@ class WorldPersona {
     /** Get current emotion/mood/somatic state. */
     async getState() {
         const detail = await this.getDetail();
-        return detail.state ?? { emotion: { vad: { V: 0, A: 0.5, D: 0 } } };
+        return detail.state ?? {
+            emotion: { vad: { V: 0, A: 0.5, D: 0 }, label: 'calm', secondary_label: null, intensity: 0 },
+            somatic: [],
+        };
     }
     /** Get speaking style from persona config (identity.speakingStyle). */
     async getSpeakingStyle() {
@@ -91,7 +79,7 @@ class WorldPersona {
                 action_name: action || undefined,
                 action_label: action || undefined,
                 stimulus_description: options?.stimulusDescription,
-                appraisal_vector: options?.appraisal ? toApiAppraisal(options.appraisal) : undefined,
+                appraisal_vector: options?.appraisal ? (0, appraisal_1.toWireAppraisal)(options.appraisal) : undefined,
                 actor_id: options?.actor,
                 actor_type: options?.actorType,
             },

package/dist/cjs/world/world.d.ts

@@ -4,7 +4,7 @@ import { MolrooPersona } from '../persona';
 import type { PersonaSummary } from '../persona';
 import type { PersonaConfigData } from '../types';
 import type { LLMInput } from '../llm/resolve';
-import type { MemoryAdapter, MemoryConfig, RecallLimits } from '../memory/types';
+import type { MemoryAdapter, RecallLimits } from '../memory/types';
 import type { EventAdapter } from '../events/types';
 import type { WorldData, CreateWorldOptions, PaginationOptions } from './types';
 export interface MolrooOptions {
@@ -15,7 +15,7 @@ export interface MolrooOptions {
 export interface PersonaOptions {
     llm?: LLMInput;
     engineLlm?: LLMInput;
-    memory?: MemoryAdapter | MemoryConfig;
+    memory?: MemoryAdapter;
     recall?: RecallLimits;
     events?: EventAdapter;
 }
@@ -44,7 +44,30 @@ export declare class Molroo {
     private readonly _apiKey;
     constructor(options: MolrooOptions);
     /**
-     * Create a new persona and return a connected {@link MolrooPersona} instance.
+     * Create a new persona from a natural language description.
+     * Uses LLM to generate HEXACO personality configuration.
+     *
+     * @example
+     * ```typescript
+     * const sera = await molroo.createPersona(
+     *   'A kind and curious barista who remembers customer names',
+     *   { llm: openaiAdapter }
+     * );
+     * ```
+     */
+    createPersona(description: string, options: PersonaOptions & {
+        llm: LLMInput;
+    }): Promise<MolrooPersona>;
+    /**
+     * Create a new persona with explicit configuration.
+     *
+     * @example
+     * ```typescript
+     * const sera = await molroo.createPersona(
+     *   { identity: { name: 'Sera' }, personality: { O: 0.8, C: 0.6, E: 0.7, A: 0.5, N: 0.3, H: 0.6 } },
+     *   { llm: openaiAdapter }
+     * );
+     * ```
      */
     createPersona(personaConfig: PersonaConfigData, options?: PersonaOptions): Promise<MolrooPersona>;
     /**
@@ -52,8 +75,8 @@ export declare class Molroo {
      */
     connectPersona(personaId: string, options?: PersonaOptions): Promise<MolrooPersona>;
     /**
-     * Generate a persona from a natural-language description, create it on the API,
-     * and return a connected {@link MolrooPersona} instance.
+     * Generate a persona from a natural-language description.
+     * @deprecated Use `createPersona(description, options)` instead.
      */
     generatePersona(description: string, options: PersonaOptions & {
         llm: LLMInput;

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

@@ -1 +1 @@
-{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../../src/world/world.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAiCjB,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACtC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAQD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,MAAM;IACjB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,aAAa;IAalC;;OAEG;IACG,aAAa,CACjB,aAAa,EAAE,iBAAiB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC;IAOzB;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC;IAOzB;;;OAGG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GAAG;QAAE,GAAG,EAAE,QAAQ,CAAA;KAAE,GAC1C,OAAO,CAAC,aAAa,CAAC;IAOzB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAWlF;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAwB9D;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAmB1C;;;OAGG;IACG,UAAU,CACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CA6B/D"}
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../../src/world/world.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAiCjB,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAQD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,MAAM;IACjB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,aAAa;IAalC;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GAAG;QAAE,GAAG,EAAE,QAAQ,CAAA;KAAE,GAC1C,OAAO,CAAC,aAAa,CAAC;IAEzB;;;;;;;;;;OAUG;IACG,aAAa,CACjB,aAAa,EAAE,iBAAiB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC;IAuBzB;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC;IAOzB;;;OAGG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GAAG;QAAE,GAAG,EAAE,QAAQ,CAAA;KAAE,GAC1C,OAAO,CAAC,aAAa,CAAC;IAIzB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAWlF;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAwB9D;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAmB1C;;;OAGG;IACG,UAAU,CACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CA6B/D"}

package/dist/cjs/world/world.js

@@ -52,14 +52,16 @@ class Molroo {
             apiKey: this._apiKey,
         });
     }
-    // ---------------------------------------------------------------------------
-    // Persona
-    // ---------------------------------------------------------------------------
-    /**
-     * Create a new persona and return a connected {@link MolrooPersona} instance.
-     */
-    async createPersona(personaConfig, options) {
-        return persona_1.MolrooPersona.create({ baseUrl: this._baseUrl, apiKey: this._apiKey, ...options }, personaConfig);
+    async createPersona(input, options) {
+        if (typeof input === 'string') {
+            // Description path - requires llm
+            if (!options?.llm) {
+                throw new Error('LLM adapter is required when using description string');
+            }
+            return persona_1.MolrooPersona.create({ baseUrl: this._baseUrl, apiKey: this._apiKey, ...options, llm: options.llm }, input);
+        }
+        // Config path
+        return persona_1.MolrooPersona.create({ baseUrl: this._baseUrl, apiKey: this._apiKey, ...options }, input);
     }
     /**
      * Connect to an existing persona by ID.
@@ -68,11 +70,11 @@ class Molroo {
         return persona_1.MolrooPersona.connect({ baseUrl: this._baseUrl, apiKey: this._apiKey, ...options }, personaId);
     }
     /**
-     * Generate a persona from a natural-language description, create it on the API,
-     * and return a connected {@link MolrooPersona} instance.
+     * Generate a persona from a natural-language description.
+     * @deprecated Use `createPersona(description, options)` instead.
      */
     async generatePersona(description, options) {
-        return persona_1.MolrooPersona.generate({ baseUrl: this._baseUrl, apiKey: this._apiKey, ...options }, description);
+        return this.createPersona(description, options);
     }
     /**
      * List all personas for the authenticated tenant.

package/dist/esm/api-client.d.ts

@@ -1,4 +1,5 @@
 import type { paths } from './generated/api';
+import { unwrap } from './shared/client-factory';
 /**
  * Create a typed openapi-fetch client for the molroo API.
  *
@@ -8,16 +9,5 @@ import type { paths } from './generated/api';
  */
 export declare function createApiClient(baseUrl: string, apiKey: string): import("openapi-fetch").Client<paths, `${string}/${string}`>;
 export type ApiClient = ReturnType<typeof createApiClient>;
-/**
- * Unwrap the `{ result: T }` envelope from API responses.
- *
- * Many API endpoints return `ResultWrapper` (typed as `{ result?: unknown }`)
- * in the OpenAPI spec. This helper extracts the `result` field and casts it
- * to the expected type.
- *
- * For endpoints with properly-typed response schemas, use `data.result` directly.
- */
-export declare function unwrap<T>(data: {
-    result?: unknown;
-} | undefined): T;
+export { unwrap };
 //# sourceMappingURL=api-client.d.ts.map

package/dist/esm/api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/api-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAwB7C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gEAU9D;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,CAAC,CAEnE"}
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAqB,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gEAE9D;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/esm/api-client.js

@@ -1,21 +1,5 @@
-import createClient from 'openapi-fetch';
 import { MolrooApiError } from './errors';
-/**
- * Middleware: throw MolrooApiError on non-OK responses.
- *
- * Reads the error body `{ error: { code, message } }` and converts it
- * into a typed MolrooApiError before openapi-fetch processes the response.
- */
-const errorMiddleware = {
-    async onResponse({ response }) {
-        if (!response.ok) {
-            const body = await response.clone().json().catch(() => ({}));
-            const err = body;
-            throw new MolrooApiError(err.error?.message ?? `API error ${response.status}`, err.error?.code ?? 'UNKNOWN', response.status);
-        }
-        // Return undefined to let openapi-fetch handle the response unchanged
-    },
-};
+import { createTypedClient, unwrap } from './shared/client-factory';
 /**
  * Create a typed openapi-fetch client for the molroo API.
  *
@@ -24,25 +8,6 @@ const errorMiddleware = {
  * @returns A fully-typed openapi-fetch client instance.
  */
 export function createApiClient(baseUrl, apiKey) {
-    const client = createClient({
-        baseUrl: baseUrl.replace(/\/$/, ''),
-        headers: {
-            'Content-Type': 'application/json',
-            'X-API-Key': apiKey,
-        },
-    });
-    client.use(errorMiddleware);
-    return client;
-}
-/**
- * Unwrap the `{ result: T }` envelope from API responses.
- *
- * Many API endpoints return `ResultWrapper` (typed as `{ result?: unknown }`)
- * in the OpenAPI spec. This helper extracts the `result` field and casts it
- * to the expected type.
- *
- * For endpoints with properly-typed response schemas, use `data.result` directly.
- */
-export function unwrap(data) {
-    return (data?.result ?? {});
+    return createTypedClient({ baseUrl, apiKey, ErrorClass: MolrooApiError });
 }
+export { unwrap };

package/dist/esm/errors.d.ts

@@ -1,17 +1,2 @@
-/**
- * Error thrown when the molroo API returns a non-OK response.
- *
- * Contains the API error code and HTTP status for programmatic handling.
- */
-export declare class MolrooApiError extends Error {
-    /** Machine-readable error code (e.g., 'ENTITY_NOT_FOUND', 'UNAUTHORIZED'). */
-    code: string;
-    /** HTTP status code. */
-    status: number;
-    constructor(message: string, 
-    /** Machine-readable error code (e.g., 'ENTITY_NOT_FOUND', 'UNAUTHORIZED'). */
-    code: string, 
-    /** HTTP status code. */
-    status: number);
-}
+export { MolrooApiError } from './shared/errors';
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAGrC,8EAA8E;IACvE,IAAI,EAAE,MAAM;IACnB,wBAAwB;IACjB,MAAM,EAAE,MAAM;gBAJrB,OAAO,EAAE,MAAM;IACf,8EAA8E;IACvE,IAAI,EAAE,MAAM;IACnB,wBAAwB;IACjB,MAAM,EAAE,MAAM;CAKxB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/esm/errors.js

@@ -1,17 +1 @@
-/**
- * Error thrown when the molroo API returns a non-OK response.
- *
- * Contains the API error code and HTTP status for programmatic handling.
- */
-export class MolrooApiError extends Error {
-    constructor(message, 
-    /** Machine-readable error code (e.g., 'ENTITY_NOT_FOUND', 'UNAUTHORIZED'). */
-    code, 
-    /** HTTP status code. */
-    status) {
-        super(message);
-        this.code = code;
-        this.status = status;
-        this.name = 'MolrooApiError';
-    }
-}
+export { MolrooApiError } from './shared/errors';

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

@@ -1,28 +1,21 @@
 /**
- * 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.
+ * Event adapter interface for emitting persona-scoped events.
+ * Consumers can implement this to react to emotion changes, memory events, etc.
  */
-/** 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(). */
+    /** Optional batch emit for efficiency. Falls back to individual emit() if not provided. */
     emitBatch?(events: SDKEvent[]): Promise<void>;
 }
+/** Base event shape. */
+export interface SDKEvent {
+    type: string;
+    personaId?: string;
+    timestamp: number;
+    payload?: Record<string, unknown>;
+}
+/** Event type categories. */
+export type SDKEventType = 'emotion_changed' | 'memory_consolidated' | 'reflection_generated' | PersonaEventType;
+/** Persona-specific event types. */
+export type PersonaEventType = 'chat' | 'perceive' | 'emotion_update' | 'state_change' | 'memory_created' | 'reflection_created';
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/events/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,2FAA2F;IAC3F,SAAS,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,wBAAwB;AACxB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,6BAA6B;AAC7B,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,GAAG,gBAAgB,CAAC;AAEjH,oCAAoC;AACpC,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,UAAU,GACV,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,oBAAoB,CAAC"}

package/dist/esm/events/types.js

@@ -1,12 +1 @@
-/**
- * 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.
- */
 export {};

package/dist/esm/index.d.ts

@@ -1,68 +1,46 @@
 /**
  * @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.
+ * ## Quick Start
  *
- * 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';
+ * import { Molroo } from '@molroo-io/sdk';
+ * import { createOpenAI } from '@ai-sdk/openai';
+ *
+ * const molroo = new Molroo({ apiKey: 'mk_live_...' });
+ *
+ * const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY! });
  *
- * const llm = createVercelAIAdapter({
- *   provider: 'openai',
- *   apiKey: process.env.OPENAI_API_KEY!,
- * });
+ * // Create persona from description
+ * const sera = await molroo.createPersona(
+ *   'A kind and curious barista named Sera',
+ *   { llm: openai }
+ * );
  *
- * 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 sera.chat('Hello!');
+ * ```
+ *
+ * ## Advanced: World Simulation
  *
- * const result = await persona.chat('Hello!');
+ * ```typescript
+ * const world = await molroo.createWorld({ name: 'Cafe' });
+ * const sera = await molroo.createPersona('Barista Sera', { llm: openai });
+ * await world.addPersona({ personaConfigId: sera.id, config: {...} });
  * ```
  */
 export { Molroo } from './world/world';
 export type { MolrooOptions, PersonaOptions } from './world/world';
-export { MolrooPersona } from './persona';
-export { MolrooApiError } from './types';
+export { MolrooApiError, WorldApiError } from './shared/errors';
+export { NEUTRAL_APPRAISAL, toWireAppraisal, fromWireAppraisal } from './shared/appraisal';
+export type { Appraisal } from './shared/appraisal';
 export type { LLMAdapter, Message, GenerateTextOptions, GenerateObjectOptions, } from './llm/adapter';
-export type { 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 { 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 { 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

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

package/dist/esm/index.js

@@ -1,50 +1,37 @@
 /**
  * @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.
+ * ## Quick Start
  *
- * The API/engine never call LLM. This SDK is the bridge.
+ * ```typescript
+ * import { Molroo } from '@molroo-io/sdk';
+ * import { createOpenAI } from '@ai-sdk/openai';
+ *
+ * const molroo = new Molroo({ apiKey: 'mk_live_...' });
+ *
+ * const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY! });
+ *
+ * // Create persona from description
+ * const sera = await molroo.createPersona(
+ *   'A kind and curious barista named Sera',
+ *   { llm: openai }
+ * );
+ *
+ * const result = await sera.chat('Hello!');
+ * ```
+ *
+ * ## Advanced: World Simulation
  *
- * @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!');
+ * const world = await molroo.createWorld({ name: 'Cafe' });
+ * const sera = await molroo.createPersona('Barista Sera', { llm: openai });
+ * await world.addPersona({ personaConfigId: sera.id, config: {...} });
  * ```
  */
 // ── Main exports ──
 export { Molroo } from './world/world';
-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';
+export { MolrooApiError, WorldApiError } from './shared/errors';
+// ── Shared utilities ──
+export { NEUTRAL_APPRAISAL, toWireAppraisal, fromWireAppraisal } from './shared/appraisal';
 // ── Defaults ──
 export { DEFAULT_PERSONA, withDefaults } from './defaults';

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

@@ -1,28 +1,10 @@
 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;
+import type { LanguageModel } from 'ai';
+/** LLM adapter or Vercel AI SDK provider instance. */
+export type LLMInput = LLMAdapter | LanguageModel;
 /**
  * Resolve an LLMInput to an LLMAdapter.
- * If a shorthand config is given, creates a VercelAIAdapter directly.
+ * If a Vercel AI SDK provider is given, wraps it in VercelAIAdapter.
  */
 export declare function resolveLLM(input: LLMInput): Promise<LLMAdapter>;
 //# sourceMappingURL=resolve.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/llm/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;AAelD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBrE"}

package/dist/esm/llm/resolve.js

@@ -1,17 +1,29 @@
-import { createVercelAIAdapter } from './vercel-ai';
-function isShorthand(input) {
+import { VercelAIAdapter } from './vercel-ai';
+/**
+ * Check if input is a Vercel AI SDK provider instance.
+ * Provider instances have a `doGenerate` method.
+ */
+function isVercelProvider(input) {
     return (input != null &&
         typeof input === 'object' &&
-        'provider' in input &&
-        'apiKey' in input &&
-        !('generateText' in input));
+        'doGenerate' in input &&
+        typeof input.doGenerate === 'function');
 }
 /**
  * Resolve an LLMInput to an LLMAdapter.
- * If a shorthand config is given, creates a VercelAIAdapter directly.
+ * If a Vercel AI SDK provider is given, wraps it in VercelAIAdapter.
  */
 export async function resolveLLM(input) {
-    if (!isShorthand(input))
+    // Check if it's an adapter first
+    if (input != null &&
+        typeof input === 'object' &&
+        'generateText' in input &&
+        'generateObject' in input) {
         return input;
-    return createVercelAIAdapter(input);
+    }
+    // Vercel AI SDK provider instance - wrap it
+    if (isVercelProvider(input)) {
+        return new VercelAIAdapter({ provider: input });
+    }
+    throw new Error('Invalid LLM input. Expected LLMAdapter or Vercel AI SDK provider instance.');
 }