@molroo-io/sdk 0.5.3 → 0.7.0

package/dist/cjs/world/{village.js → world-domain.js}

@@ -1,49 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Village = void 0;
-// INFO: @F001 Domain class wrapping village API — see plan step 3
+exports.World = void 0;
+// INFO: @F001 Domain class wrapping World API — see plan step 3
 const client_1 = require("./client");
 const world_persona_1 = require("./world-persona");
+const appraisal_1 = require("../shared/appraisal");
 // ---------------------------------------------------------------------------
-// Internal helpers (not exported)
-// ---------------------------------------------------------------------------
-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,
-    };
-}
-function fromApiAppraisal(raw) {
-    return {
-        goalRelevance: raw.goal_relevance,
-        goalCongruence: raw.goal_congruence,
-        expectedness: raw.expectedness,
-        controllability: raw.controllability,
-        agency: raw.agency,
-        normCompatibility: raw.norm_compatibility,
-        internalStandards: raw.internal_standards,
-        adjustmentPotential: raw.adjustment_potential,
-        urgency: raw.urgency,
-    };
-}
-// ---------------------------------------------------------------------------
-// Village class
+// World class (domain)
 // ---------------------------------------------------------------------------
 /**
- * Represents a village and exposes domain methods for personas, actions,
+ * Represents a world and exposes domain methods for personas, actions,
  * relationships, interactions, and events.
  *
- * Instances are obtained via {@link World.createVillage} or {@link World.getVillage}.
+ * Instances are obtained via {@link Molroo.createWorld} or {@link Molroo.getWorld}.
  */
-class Village {
-    /** @internal — use World.createVillage / World.getVillage instead. */
+class World {
+    /** @internal — use Molroo.createWorld / Molroo.getWorld instead. */
     constructor(client, data) {
         this._client = client;
         this._data = { ...data };
@@ -64,16 +36,16 @@ class Village {
     get responseRule() {
         return this._data.responseRule;
     }
-    /** Returns a readonly snapshot of the village data. */
+    /** Returns a readonly snapshot of the world data. */
     get data() {
         return this._data;
     }
-    // -- Village CRUD ---------------------------------------------------------
+    // -- World CRUD ---------------------------------------------------------
     /**
-     * Update village properties. Applies an optimistic local update on success.
+     * Update world properties. Applies an optimistic local update on success.
      */
     async update(options) {
-        await this._client.PATCH('/villages/{id}', {
+        await this._client.PATCH('/worlds/{id}', {
             params: { path: { id: this.id } },
             body: {
                 name: options.name,
@@ -92,9 +64,9 @@ class Village {
         if (options.responseRule !== undefined)
             this._data.responseRule = options.responseRule;
     }
-    /** Soft-delete this village. */
+    /** Soft-delete this world. */
     async delete() {
-        await this._client.DELETE('/villages/{id}', {
+        await this._client.DELETE('/worlds/{id}', {
             params: { path: { id: this.id } },
         });
     }
@@ -124,7 +96,7 @@ class Village {
                 };
             }
         }
-        const { data } = await this._client.POST('/villages/{id}/personas', {
+        const { data } = await this._client.POST('/worlds/{id}/personas', {
             params: { path: { id: this.id } },
             body: body,
         });
@@ -135,9 +107,9 @@ class Village {
             createdAt: raw.created_at,
         };
     }
-    /** List all personas in this village. */
+    /** List all personas in this world. */
     async listPersonas() {
-        const { data } = await this._client.GET('/villages/{id}/personas', {
+        const { data } = await this._client.GET('/worlds/{id}/personas', {
             params: { path: { id: this.id } },
         });
         const raw = (0, client_1.unwrap)(data);
@@ -145,14 +117,14 @@ class Village {
     }
     /** Get a single persona by ID. */
     async getPersona(personaId) {
-        const { data } = await this._client.GET('/villages/{id}/personas/{pid}', {
+        const { data } = await this._client.GET('/worlds/{id}/personas/{pid}', {
             params: { path: { id: this.id, pid: personaId } },
         });
         return (0, client_1.unwrap)(data);
     }
-    /** Remove a persona from this village. */
+    /** Remove a persona from this world. */
     async removePersona(personaId) {
-        await this._client.DELETE('/villages/{id}/personas/{pid}', {
+        await this._client.DELETE('/worlds/{id}/personas/{pid}', {
             params: { path: { id: this.id, pid: personaId } },
         });
     }
@@ -165,7 +137,7 @@ class Village {
      *
      * @example
      * ```typescript
-     * const mina = village.persona('mina', { llm: adapter });
+     * const mina = world.persona('mina', { llm: adapter });
      * const r = await mina.react('flirt', {
      *   actor: 'yongjun',
      *   prompt: '거실에서 용준이 민아에게 윙크했다.',
@@ -176,42 +148,42 @@ class Village {
         return new world_persona_1.WorldPersona(this._client, this.id, personaId, options);
     }
     // -- Actions --------------------------------------------------------------
-    /** Create a custom action in this village. */
+    /** Create a custom action in this world. */
     async createAction(options) {
-        const { data } = await this._client.POST('/villages/{id}/actions', {
+        const { data } = await this._client.POST('/worlds/{id}/actions', {
             params: { path: { id: this.id } },
             body: {
                 name: options.name,
                 description: options.description,
-                appraisal_vector: toApiAppraisal(options.appraisalVector),
+                appraisal_vector: (0, appraisal_1.toWireAppraisal)(options.appraisalVector),
             },
         });
         const raw = (0, client_1.unwrap)(data);
         return { id: raw.id, name: raw.name };
     }
-    /** List all actions (defaults + custom) in this village. */
+    /** List all actions (defaults + custom) in this world. */
     async listActions() {
-        const { data } = await this._client.GET('/villages/{id}/actions', {
+        const { data } = await this._client.GET('/worlds/{id}/actions', {
             params: { path: { id: this.id } },
         });
         const raw = (0, client_1.unwrap)(data);
         return (raw.actions ?? []).map((a) => ({
             name: a.name,
             description: a.description,
-            appraisalVector: fromApiAppraisal(a.appraisal_vector),
+            appraisalVector: (0, appraisal_1.fromWireAppraisal)(a.appraisal_vector),
             isDefault: a.is_default,
         }));
     }
-    /** Delete a custom action from this village. */
+    /** Delete a custom action from this world. */
     async deleteAction(actionId) {
-        await this._client.DELETE('/villages/{id}/actions/{aid}', {
+        await this._client.DELETE('/worlds/{id}/actions/{aid}', {
             params: { path: { id: this.id, aid: actionId } },
         });
     }
     // -- Relationships --------------------------------------------------------
-    /** Set (upsert) a relationship in this village. */
+    /** Set (upsert) a relationship in this world. */
     async setRelationship(options) {
-        await this._client.PUT('/villages/{id}/relationships', {
+        await this._client.PUT('/worlds/{id}/relationships', {
             params: { path: { id: this.id } },
             body: {
                 source_type: options.source.type,
@@ -225,9 +197,9 @@ class Village {
             },
         });
     }
-    /** List all relationships in this village. */
+    /** List all relationships in this world. */
     async listRelationships() {
-        const { data } = await this._client.GET('/villages/{id}/relationships', {
+        const { data } = await this._client.GET('/worlds/{id}/relationships', {
             params: { path: { id: this.id } },
         });
         const raw = (0, client_1.unwrap)(data);
@@ -235,21 +207,21 @@ class Village {
     }
     /** Delete a relationship by ID. */
     async deleteRelationship(relationshipId) {
-        await this._client.DELETE('/villages/{id}/relationships/{rid}', {
+        await this._client.DELETE('/worlds/{id}/relationships/{rid}', {
             params: { path: { id: this.id, rid: relationshipId } },
         });
     }
     // -- Interaction ----------------------------------------------------------
-    /** Execute an interaction in this village. */
+    /** Execute an interaction in this world. */
     async interact(options) {
-        const { data } = await this._client.POST('/villages/{id}/interact', {
+        const { data } = await this._client.POST('/worlds/{id}/interact', {
             params: { path: { id: this.id } },
             body: {
                 target_persona_id: options.target,
                 action_name: options.action,
                 action_label: options.actionLabel,
                 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,
             },
@@ -257,9 +229,9 @@ class Village {
         return (0, client_1.unwrap)(data);
     }
     // -- Events ---------------------------------------------------------------
-    /** Retrieve the event log for this village. */
+    /** Retrieve the event log for this world. */
     async getEvents(options) {
-        const { data } = await this._client.GET('/villages/{id}/events', {
+        const { data } = await this._client.GET('/worlds/{id}/events', {
             params: {
                 path: { id: this.id },
                 query: {
@@ -275,4 +247,4 @@ class Village {
         };
     }
 }
-exports.Village = Village;
+exports.World = World;

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

@@ -1,5 +1,5 @@
 /**
- * WorldPersona — a persona handle within a village.
+ * WorldPersona — a persona handle within a world.
  *
  * "누가 말하는가? 페르소나가 말한다."
  *
@@ -8,7 +8,7 @@
  * 제공하되, 내부적으로 World API 엔드포인트를 사용한다.
  */
 import { type ApiClient } from './client';
-import type { AppraisalVector } from './types';
+import type { Appraisal } from './types';
 import type { LLMAdapter } from '../llm/adapter';
 export type LLMMessage = {
     role: 'user' | 'assistant' | 'system';
@@ -35,7 +35,7 @@ export interface PersonaEmotion {
         D: number;
     };
 }
-export interface PersonaState {
+export interface WorldPersonaState {
     emotion: PersonaEmotion;
     mood?: {
         vad: {
@@ -46,6 +46,8 @@ export interface PersonaState {
     };
     somatic?: string[];
 }
+/** @deprecated Use {@link WorldPersonaState} instead. */
+export type PersonaState = WorldPersonaState;
 export interface PromptContext {
     systemPrompt: string;
     promptContext: Record<string, string>;
@@ -67,7 +69,7 @@ export interface PersonaDetail {
         goals?: unknown[];
         [key: string]: unknown;
     };
-    state: PersonaState | null;
+    state: WorldPersonaState | null;
 }
 export interface ReactOptions {
     /** Who is performing the action (e.g. 'yongjun'). */
@@ -100,18 +102,18 @@ export interface WorldPersonaOptions {
 }
 export declare class WorldPersona {
     private readonly _client;
-    private readonly _villageId;
+    private readonly _worldId;
     private readonly _personaId;
     private readonly _llm?;
     /** Cached persona detail (config + state). Invalidated on interact(). */
     private _detailCache;
-    /** @internal — use Village.persona() instead. */
-    constructor(client: ApiClient, villageId: string, personaId: string, options?: WorldPersonaOptions);
+    /** @internal — use World.persona() instead. */
+    constructor(client: ApiClient, worldId: string, personaId: string, options?: WorldPersonaOptions);
     get id(): string;
     /** Fetch full persona detail (config + state). Cached per-instance. */
     getDetail(): Promise<PersonaDetail>;
     /** Get current emotion/mood/somatic state. */
-    getState(): Promise<PersonaState>;
+    getState(): Promise<WorldPersonaState>;
     /** Get speaking style from persona config (identity.speakingStyle). */
     getSpeakingStyle(): Promise<string | undefined>;
     /** Get LLM system prompt assembled from all persona subsystems + world context. */
@@ -123,7 +125,7 @@ export declare class WorldPersona {
     interact(action: string, options?: {
         actor?: string;
         actorType?: 'user' | 'persona';
-        appraisal?: AppraisalVector;
+        appraisal?: Appraisal;
         stimulusDescription?: string;
     }): Promise<{
         emotion: PersonaEmotion;
@@ -155,7 +157,7 @@ export declare class WorldPersona {
      *
      * @example
      * ```typescript
-     * const mina = village.persona('mina', { llm: adapter });
+     * const mina = world.persona('mina', { llm: adapter });
      *
      * // Plain text reaction
      * const r1 = await mina.react('flirt', {

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

@@ -1 +1 @@
-{"version":3,"file":"world-persona.d.ts","sourceRoot":"","sources":["../../../src/world/world-persona.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"world-persona.d.ts","sourceRoot":"","sources":["../../../src/world/world-persona.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAOjD,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAMlC,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE;YACT,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CAAC;QACF,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACjC;AAMD,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM;IACrC,+CAA+C;IAC/C,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,SAAS,EAAE,CAAC,CAAC;CACd;AAMD,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAa;IAEnC,yEAAyE;IACzE,OAAO,CAAC,YAAY,CAA8B;IAElD,+CAA+C;gBAE7C,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,mBAAmB;IAQ/B,IAAI,EAAE,IAAI,MAAM,CAEf;IAID,uEAAuE;IACjE,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IA6BzC,8CAA8C;IACxC,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAK5C,uEAAuE;IACjE,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKrD,mFAAmF;IAC7E,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAcrE;;;OAGG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,GACA,OAAO,CAAC;QACT,OAAO,EAAE,cAAc,CAAC;QACxB,IAAI,CAAC,EAAE;YAAE,GAAG,EAAE;gBAAE,CAAC,EAAE,MAAM,CAAC;gBAAC,CAAC,EAAE,MAAM,CAAC;gBAAC,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC;QACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IA2BF;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAgBnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,KAAK,CAAC,CAAC,GAAG,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CA+C3B"}

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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorldPersona = void 0;
 /**
- * WorldPersona — a persona handle within a village.
+ * WorldPersona — a persona handle within a world.
  *
  * "누가 말하는가? 페르소나가 말한다."
  *
@@ -11,29 +11,14 @@ 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 Village.persona() instead. */
-    constructor(client, villageId, personaId, options) {
+    /** @internal — use World.persona() instead. */
+    constructor(client, worldId, personaId, options) {
         /** Cached persona detail (config + state). Invalidated on interact(). */
         this._detailCache = null;
         this._client = client;
-        this._villageId = villageId;
+        this._worldId = worldId;
         this._personaId = personaId;
         this._llm = options?.llm;
     }
@@ -45,8 +30,8 @@ class WorldPersona {
     async getDetail() {
         if (this._detailCache)
             return this._detailCache;
-        const { data } = await this._client.GET('/villages/{id}/personas/{pid}', {
-            params: { path: { id: this._villageId, pid: this._personaId } },
+        const { data } = await this._client.GET('/worlds/{id}/personas/{pid}', {
+            params: { path: { id: this._worldId, pid: this._personaId } },
         });
         const raw = (0, client_1.unwrap)(data);
         const config = typeof raw.config === 'string' ? JSON.parse(raw.config) : raw.config;
@@ -71,8 +56,8 @@ class WorldPersona {
     }
     /** Get LLM system prompt assembled from all persona subsystems + world context. */
     async getPromptContext(sourceEntity) {
-        const { data } = await this._client.POST('/villages/{id}/personas/{pid}/prompt-context', {
-            params: { path: { id: this._villageId, pid: this._personaId } },
+        const { data } = await this._client.POST('/worlds/{id}/personas/{pid}/prompt-context', {
+            params: { path: { id: this._worldId, pid: this._personaId } },
             body: sourceEntity ? { sourceEntity } : {},
         });
         return (0, client_1.unwrap)(data);
@@ -84,14 +69,14 @@ class WorldPersona {
      */
     async interact(action, options) {
         this._detailCache = null; // invalidate
-        const { data } = await this._client.POST('/villages/{id}/interact', {
-            params: { path: { id: this._villageId } },
+        const { data } = await this._client.POST('/worlds/{id}/interact', {
+            params: { path: { id: this._worldId } },
             body: {
                 target_persona_id: this._personaId,
                 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,
             },
@@ -110,8 +95,8 @@ class WorldPersona {
      */
     async tick(seconds) {
         this._detailCache = null; // invalidate — state changes after tick
-        const { data } = await this._client.POST('/villages/{id}/personas/{pid}/tick', {
-            params: { path: { id: this._villageId, pid: this._personaId } },
+        const { data } = await this._client.POST('/worlds/{id}/personas/{pid}/tick', {
+            params: { path: { id: this._worldId, pid: this._personaId } },
             body: { seconds },
         });
         return (0, client_1.unwrap)(data);
@@ -125,7 +110,7 @@ class WorldPersona {
      *
      * @example
      * ```typescript
-     * const mina = village.persona('mina', { llm: adapter });
+     * const mina = world.persona('mina', { llm: adapter });
      *
      * // Plain text reaction
      * const r1 = await mina.react('flirt', {
@@ -149,7 +134,7 @@ class WorldPersona {
      */
     async react(action, options) {
         if (!this._llm) {
-            throw new Error('WorldPersona.react() requires an LLM adapter. Pass { llm } to village.persona().');
+            throw new Error('WorldPersona.react() requires an LLM adapter. Pass { llm } to world.persona().');
         }
         // 1. Interact — emotion engine processes the action
         const interactResult = await this.interact(action, {

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

@@ -1,40 +1,107 @@
 import { type ApiClient } from './client';
-import { Village } from './village';
-import type { VillageData, CreateVillageOptions, PaginationOptions } from './types';
-export interface WorldOptions {
+import { World } from './world-domain';
+import { MolrooPersona } from '../persona';
+import type { PersonaSummary } from '../persona';
+import type { PersonaConfigData } from '../types';
+import type { LLMInput } from '../llm/resolve';
+import type { MemoryAdapter, RecallLimits } from '../memory/types';
+import type { EventAdapter } from '../events/types';
+import type { WorldData, CreateWorldOptions, PaginationOptions } from './types';
+export interface MolrooOptions {
     apiKey: string;
     baseUrl?: string;
 }
+/** Per-persona options passed when creating/connecting personas via the Molroo client. */
+export interface PersonaOptions {
+    llm?: LLMInput;
+    engineLlm?: LLMInput;
+    memory?: MemoryAdapter;
+    recall?: RecallLimits;
+    events?: EventAdapter;
+}
 /**
- * Entry point for the World SDK.
+ * Unified entry point for the molroo SDK.
  *
  * @example
  * ```typescript
- * import { World } from '@molroo-io/sdk';
+ * import { Molroo } from '@molroo-io/sdk/world';
+ *
+ * const molroo = new Molroo({ apiKey: 'mk_live_...' });
  *
- * const world = new World({ apiKey: 'mk_live_...' });
- * const village = await world.createVillage({ name: 'My Village' });
- * const result = await village.interact({ target: 'sera', action: 'greet' });
+ * // Persona
+ * const sera = await molroo.createPersona({ identity: { name: 'Sera' }, ... }, { llm });
+ * await sera.chat('Hello!');
+ *
+ * // World
+ * const world = await molroo.createWorld({ name: 'Cafe' });
+ * await world.addPersona({ personaConfigId: sera.id, config: {...} });
  * ```
  */
-export declare class World {
+export declare class Molroo {
     /** @internal — exposed for advanced use only. */
     readonly _client: ApiClient;
-    constructor(options: WorldOptions);
+    private readonly _baseUrl;
+    private readonly _apiKey;
+    constructor(options: MolrooOptions);
+    /**
+     * 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>;
+    /**
+     * Connect to an existing persona by ID.
+     */
+    connectPersona(personaId: string, options?: PersonaOptions): Promise<MolrooPersona>;
+    /**
+     * Generate a persona from a natural-language description.
+     * @deprecated Use `createPersona(description, options)` instead.
+     */
+    generatePersona(description: string, options: PersonaOptions & {
+        llm: LLMInput;
+    }): Promise<MolrooPersona>;
+    /**
+     * List all personas for the authenticated tenant.
+     */
+    listPersonas(): Promise<{
+        personas: PersonaSummary[];
+        nextCursor?: string;
+    }>;
     /**
-     * Create a new village and return a {@link Village} instance.
+     * Create a new world and return a {@link World} instance.
      */
-    createVillage(options: CreateVillageOptions): Promise<Village>;
+    createWorld(options: CreateWorldOptions): Promise<World>;
     /**
-     * Fetch an existing village by ID and return a {@link Village} instance.
+     * Fetch an existing world by ID and return a {@link World} instance.
      */
-    getVillage(id: string): Promise<Village>;
+    getWorld(id: string): Promise<World>;
     /**
-     * List villages. Returns raw data objects (not Village instances) for
+     * List worlds. Returns raw data objects (not World instances) for
      * efficiency when only metadata is needed.
      */
-    listVillages(options?: PaginationOptions): Promise<{
-        villages: VillageData[];
+    listWorlds(options?: PaginationOptions): Promise<{
+        worlds: WorldData[];
         nextCursor: string | null;
     }>;
 }

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,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAiCjB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD;;;;;;;;;;;GAWG;AACH,qBAAa,KAAK;IAChB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;gBAEhB,OAAO,EAAE,YAAY;IAOjC;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBpE;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB9C;;;OAGG;IACG,YAAY,CAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CA6BnE"}
+{"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"}