@molroo-io/sdk 0.6.2 → 0.7.1

package/dist/esm/shared/appraisal.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared appraisal conversion utilities.
+ *
+ * The World SDK uses camelCase AppraisalVector (now called Appraisal),
+ * while the API wire format uses snake_case. These helpers convert between them.
+ */
+import type { AppraisalVector as WireAppraisal } from '../types';
+/** camelCase appraisal shape used by World SDK. */
+export interface Appraisal {
+    goalRelevance: number;
+    goalCongruence: number;
+    expectedness: number;
+    controllability: number;
+    agency: number;
+    normCompatibility: number;
+    internalStandards: number;
+    adjustmentPotential: number;
+    urgency: number;
+}
+/** Convert camelCase Appraisal → snake_case wire format. */
+export declare function toWireAppraisal(v: Appraisal): WireAppraisal;
+/** Convert snake_case wire format → camelCase Appraisal. */
+export declare function fromWireAppraisal(raw: Record<string, number>): Appraisal;
+/** Neutral appraisal vector (all dimensions at baseline). */
+export declare const NEUTRAL_APPRAISAL: WireAppraisal;
+//# sourceMappingURL=appraisal.d.ts.map

package/dist/esm/shared/appraisal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appraisal.d.ts","sourceRoot":"","sources":["../../../src/shared/appraisal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,IAAI,aAAa,EAAE,MAAM,UAAU,CAAC;AAEjE,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,GAAG,aAAa,CAY3D;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAYxE;AAED,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,EAAE,aAU9B,CAAC"}

package/dist/esm/shared/appraisal.js

@@ -0,0 +1,40 @@
+/** Convert camelCase Appraisal → snake_case wire format. */
+export function toWireAppraisal(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,
+    };
+}
+/** Convert snake_case wire format → camelCase Appraisal. */
+export function fromWireAppraisal(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,
+    };
+}
+/** Neutral appraisal vector (all dimensions at baseline). */
+export const NEUTRAL_APPRAISAL = Object.freeze({
+    goal_relevance: 0,
+    goal_congruence: 0,
+    expectedness: 0.5,
+    controllability: 0.5,
+    agency: 0,
+    norm_compatibility: 0,
+    internal_standards: 0,
+    adjustment_potential: 0.5,
+    urgency: 0.5,
+});

package/dist/esm/shared/client-factory.d.ts

@@ -0,0 +1,23 @@
+import type { MolrooApiError } from './errors';
+type ErrorConstructor = new (message: string, code: string, status: number) => MolrooApiError;
+/**
+ * Create a typed openapi-fetch client with error middleware.
+ *
+ * @param opts.baseUrl - API base URL (trailing slash is stripped).
+ * @param opts.apiKey - API key for authentication.
+ * @param opts.ErrorClass - Error class to throw on non-OK responses.
+ */
+export declare function createTypedClient<Paths extends {}>(opts: {
+    baseUrl: string;
+    apiKey: string;
+    ErrorClass: ErrorConstructor;
+}): import("openapi-fetch").Client<Paths, `${string}/${string}`>;
+/**
+ * Unwrap the `{ result: T }` envelope from API responses.
+ * Returns an empty object cast to T when result is undefined.
+ */
+export declare function unwrap<T>(data: {
+    result?: unknown;
+} | undefined): T;
+export {};
+//# sourceMappingURL=client-factory.d.ts.map

package/dist/esm/shared/client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.d.ts","sourceRoot":"","sources":["../../../src/shared/client-factory.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,KAAK,gBAAgB,GAAG,KAAK,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,cAAc,CAAC;AAE9F;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,EAAE,EAAE,IAAI,EAAE;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,gBAAgB,CAAC;CAC9B,gEAwBA;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,CAAC,CAEnE"}

package/dist/esm/shared/client-factory.js

@@ -0,0 +1,41 @@
+/**
+ * Shared client factory for creating typed openapi-fetch clients.
+ *
+ * Both the Persona SDK and World SDK delegate to this module,
+ * eliminating duplicated error middleware and unwrap logic.
+ */
+import createClient from 'openapi-fetch';
+/**
+ * Create a typed openapi-fetch client with error middleware.
+ *
+ * @param opts.baseUrl - API base URL (trailing slash is stripped).
+ * @param opts.apiKey - API key for authentication.
+ * @param opts.ErrorClass - Error class to throw on non-OK responses.
+ */
+export function createTypedClient(opts) {
+    const errorMiddleware = {
+        async onResponse({ response }) {
+            if (!response.ok) {
+                const body = await response.clone().json().catch(() => ({}));
+                const err = body;
+                throw new opts.ErrorClass(err.error?.message ?? `API error ${response.status}`, err.error?.code ?? 'UNKNOWN', response.status);
+            }
+        },
+    };
+    const client = createClient({
+        baseUrl: opts.baseUrl.replace(/\/$/, ''),
+        headers: {
+            'Content-Type': 'application/json',
+            'X-API-Key': opts.apiKey,
+        },
+    });
+    client.use(errorMiddleware);
+    return client;
+}
+/**
+ * Unwrap the `{ result: T }` envelope from API responses.
+ * Returns an empty object cast to T when result is undefined.
+ */
+export function unwrap(data) {
+    return (data?.result ?? {});
+}

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

@@ -0,0 +1,21 @@
+/**
+ * Unified error hierarchy for the molroo SDK.
+ *
+ * `instanceof MolrooApiError` catches ALL API errors (persona + world).
+ * `instanceof WorldApiError` catches world-only errors.
+ */
+export declare class MolrooApiError extends Error {
+    /** Machine-readable error code (e.g., 'ENTITY_NOT_FOUND', 'UNAUTHORIZED'). */
+    readonly code: string;
+    /** HTTP status code. */
+    readonly status: number;
+    constructor(message: string, 
+    /** Machine-readable error code (e.g., 'ENTITY_NOT_FOUND', 'UNAUTHORIZED'). */
+    code: string, 
+    /** HTTP status code. */
+    status: number);
+}
+export declare class WorldApiError extends MolrooApiError {
+    constructor(message: string, code: string, status: number);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,cAAe,SAAQ,KAAK;IAGrC,8EAA8E;aAC9D,IAAI,EAAE,MAAM;IAC5B,wBAAwB;aACR,MAAM,EAAE,MAAM;gBAJ9B,OAAO,EAAE,MAAM;IACf,8EAA8E;IAC9D,IAAI,EAAE,MAAM;IAC5B,wBAAwB;IACR,MAAM,EAAE,MAAM;CAKjC;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI1D"}

package/dist/esm/shared/errors.js

@@ -0,0 +1,24 @@
+/**
+ * Unified error hierarchy for the molroo SDK.
+ *
+ * `instanceof MolrooApiError` catches ALL API errors (persona + world).
+ * `instanceof WorldApiError` catches world-only errors.
+ */
+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 class WorldApiError extends MolrooApiError {
+    constructor(message, code, status) {
+        super(message, code, status);
+        this.name = 'WorldApiError';
+    }
+}

package/dist/esm/world/client.d.ts

@@ -1,4 +1,5 @@
 import type { paths } from '../generated/world-api';
+import { unwrap } from '../shared/client-factory';
 export interface WorldClientOptions {
     baseUrl: string;
     apiKey: string;
@@ -24,13 +25,5 @@ export interface WorldClientOptions {
 export declare function createWorldClient(options: WorldClientOptions): import("openapi-fetch").Client<paths, `${string}/${string}`>;
 /** Type alias for the openapi-fetch client instance returned by createWorldClient. */
 export type ApiClient = ReturnType<typeof createWorldClient>;
-/**
- * Unwrap the `{ result: T }` envelope used by the World API.
- * Returns an empty object cast to T when result is undefined.
- *
- * @internal
- */
-export declare function unwrap<T>(data: {
-    result?: unknown;
-} | undefined): T;
+export { unwrap };
 //# sourceMappingURL=client.d.ts.map

package/dist/esm/world/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/world/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAoBpD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,gEAW5D;AAED,sFAAsF;AACtF,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,CAAC,CAEnE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/world/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAqB,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,gEAM5D;AAED,sFAAsF;AACtF,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/esm/world/client.js

@@ -1,17 +1,5 @@
-import createClient from 'openapi-fetch';
 import { WorldApiError } from './errors';
-/**
- * Middleware: throw WorldApiError on non-OK responses.
- */
-const errorMiddleware = {
-    async onResponse({ response }) {
-        if (!response.ok) {
-            const body = await response.clone().json().catch(() => ({}));
-            const err = body;
-            throw new WorldApiError(err.error?.message ?? `API error ${response.status}`, err.error?.code ?? 'UNKNOWN', response.status);
-        }
-    },
-};
+import { createTypedClient, unwrap } from '../shared/client-factory';
 /**
  * Create a typed API client for the molroo World API.
  *
@@ -31,22 +19,10 @@ const errorMiddleware = {
  * ```
  */
 export function createWorldClient(options) {
-    const client = createClient({
-        baseUrl: options.baseUrl.replace(/\/$/, ''),
-        headers: {
-            'Content-Type': 'application/json',
-            'X-API-Key': options.apiKey,
-        },
+    return createTypedClient({
+        baseUrl: options.baseUrl,
+        apiKey: options.apiKey,
+        ErrorClass: WorldApiError,
     });
-    client.use(errorMiddleware);
-    return client;
-}
-/**
- * Unwrap the `{ result: T }` envelope used by the World API.
- * Returns an empty object cast to T when result is undefined.
- *
- * @internal
- */
-export function unwrap(data) {
-    return (data?.result ?? {});
 }
+export { unwrap };

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

@@ -1,9 +1,2 @@
-/**
- * Typed API error thrown by the World SDK client.
- */
-export declare class WorldApiError extends Error {
-    readonly code: string;
-    readonly status: number;
-    constructor(message: string, code: string, status: number);
-}
+export { WorldApiError } from '../shared/errors';
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/world/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;gBAF9B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAKjC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/world/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/world/errors.js

@@ -1,11 +1 @@
-/**
- * Typed API error thrown by the World SDK client.
- */
-export class WorldApiError extends Error {
-    constructor(message, code, status) {
-        super(message);
-        this.code = code;
-        this.status = status;
-        this.name = 'WorldApiError';
-    }
-}
+export { WorldApiError } from '../shared/errors';

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

@@ -2,8 +2,8 @@ export { Molroo } from './world';
 export type { MolrooOptions, PersonaOptions } from './world';
 export { World } from './world-domain';
 export { WorldPersona } from './world-persona';
-export type { WorldPersonaOptions, WorldLLM, LLMMessage, ReactOptions, ReactResult, PersonaState, PersonaEmotion, PromptContext, PersonaDetail, } from './world-persona';
-export type { WorldData, CreateWorldOptions, UpdateWorldOptions, PaginationOptions, AddPersonaOptions, WorldPersonaRef, AppraisalVector, CreateActionOptions, ActionData, ActionRef, EntityType, RelationshipEndpoint, SetRelationshipOptions, InteractOptions, InteractResult, EventEntry, } from './types';
+export type { WorldPersonaOptions, WorldLLM, LLMMessage, ReactOptions, ReactResult, WorldPersonaState, PersonaState, PersonaEmotion, PromptContext, PersonaDetail, } from './world-persona';
+export type { WorldData, CreateWorldOptions, UpdateWorldOptions, PaginationOptions, AddPersonaOptions, WorldPersonaRef, Appraisal, AppraisalVector, CreateActionOptions, ActionData, ActionRef, EntityType, RelationshipEndpoint, SetRelationshipOptions, InteractOptions, InteractResult, EventEntry, } from './types';
 export { WorldApiError } from './errors';
 export { createWorldClient } from './client';
 export type { WorldClientOptions } from './client';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/world/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EACV,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/world/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EACV,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

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

@@ -44,7 +44,7 @@ export interface WorldPersonaRef {
     personaConfigId: string;
     createdAt: number;
 }
-export interface AppraisalVector {
+export interface Appraisal {
     goalRelevance: number;
     goalCongruence: number;
     expectedness: number;
@@ -55,15 +55,17 @@ export interface AppraisalVector {
     adjustmentPotential: number;
     urgency: number;
 }
+/** @deprecated Use {@link Appraisal} instead. */
+export type AppraisalVector = Appraisal;
 export interface CreateActionOptions {
     name: string;
     description?: string;
-    appraisalVector: AppraisalVector;
+    appraisalVector: Appraisal;
 }
 export interface ActionData {
     name: string;
     description: string;
-    appraisalVector: AppraisalVector;
+    appraisalVector: Appraisal;
     isDefault: boolean;
 }
 export interface ActionRef {
@@ -88,12 +90,37 @@ export interface InteractOptions {
     action?: string;
     actionLabel?: string;
     stimulusDescription?: string;
-    appraisal?: AppraisalVector;
+    appraisal?: Appraisal;
     actor?: string;
     actorType?: 'user' | 'persona';
 }
 export interface InteractResult {
-    [key: string]: unknown;
+    action: string;
+    target: string;
+    emotion: {
+        vad: {
+            V: number;
+            A: number;
+            D: number;
+        };
+        delta?: {
+            V: number;
+            A: number;
+            D: number;
+        };
+        label: string;
+        secondary_label: string | null;
+        intensity: number;
+    };
+    mood?: {
+        vad: {
+            V: number;
+            A: number;
+            D: number;
+        };
+        label: string;
+    };
+    somatic: string[];
 }
 export interface EventEntry {
     [key: string]: unknown;

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

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

package/dist/esm/world/world-domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world-domain.d.ts","sourceRoot":"","sources":["../../../src/world/world-domain.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAEf,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAsCjB;;;;;GAKG;AACH,qBAAa,KAAK;IAChB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,KAAK,CAAY;IAEzB,oEAAoE;gBACxD,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS;IAO9C,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,qDAAqD;IACrD,IAAI,IAAI,IAAI,QAAQ,CAAC,SAAS,CAAC,CAE9B;IAID;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxD,8BAA8B;IACxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B,oFAAoF;IAC9E,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAC5D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAwCtE,uCAAuC;IACjC,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IASxC,kCAAkC;IAC5B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrD,wCAAwC;IAClC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY;IAMvE,4CAA4C;IACtC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAcpE,0DAA0D;IACpD,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAsB1C,8CAA8C;IACxC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD,iDAAiD;IAC3C,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrE,4CAA4C;IACtC,iBAAiB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAS7C,mCAAmC;IAC7B,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,4CAA4C;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAmBjE,6CAA6C;IACvC,SAAS,CACb,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAiBhE"}
+{"version":3,"file":"world-domain.d.ts","sourceRoot":"","sources":["../../../src/world/world-domain.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAMjB;;;;;GAKG;AACH,qBAAa,KAAK;IAChB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,KAAK,CAAY;IAEzB,oEAAoE;gBACxD,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS;IAO9C,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,qDAAqD;IACrD,IAAI,IAAI,IAAI,QAAQ,CAAC,SAAS,CAAC,CAE9B;IAID;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxD,8BAA8B;IACxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B,oFAAoF;IAC9E,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAC5D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAwCtE,uCAAuC;IACjC,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IASxC,kCAAkC;IAC5B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrD,wCAAwC;IAClC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY;IAMvE,4CAA4C;IACtC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAcpE,0DAA0D;IACpD,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAsB1C,8CAA8C;IACxC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD,iDAAiD;IAC3C,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrE,4CAA4C;IACtC,iBAAiB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAS7C,mCAAmC;IAC7B,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,4CAA4C;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAmBjE,6CAA6C;IACvC,SAAS,CACb,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAiBhE"}

package/dist/esm/world/world-domain.js

@@ -1,35 +1,7 @@
 // INFO: @F001 Domain class wrapping World API — see plan step 3
 import { unwrap } from './client';
 import { WorldPersona } from './world-persona';
-// ---------------------------------------------------------------------------
-// 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,
-    };
-}
+import { toWireAppraisal, fromWireAppraisal } from '../shared/appraisal';
 // ---------------------------------------------------------------------------
 // World class (domain)
 // ---------------------------------------------------------------------------
@@ -180,7 +152,7 @@ export class World {
             body: {
                 name: options.name,
                 description: options.description,
-                appraisal_vector: toApiAppraisal(options.appraisalVector),
+                appraisal_vector: toWireAppraisal(options.appraisalVector),
             },
         });
         const raw = unwrap(data);
@@ -195,7 +167,7 @@ export class World {
         return (raw.actions ?? []).map((a) => ({
             name: a.name,
             description: a.description,
-            appraisalVector: fromApiAppraisal(a.appraisal_vector),
+            appraisalVector: fromWireAppraisal(a.appraisal_vector),
             isDefault: a.is_default,
         }));
     }
@@ -246,7 +218,7 @@ export class World {
                 action_name: options.action,
                 action_label: options.actionLabel,
                 stimulus_description: options.stimulusDescription,
-                appraisal_vector: options.appraisal ? toApiAppraisal(options.appraisal) : undefined,
+                appraisal_vector: options.appraisal ? toWireAppraisal(options.appraisal) : undefined,
                 actor_id: options.actor,
                 actor_type: options.actorType,
             },

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

@@ -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';
@@ -24,18 +24,16 @@ export interface PersonaEmotion {
         A: number;
         D: number;
     };
-    discrete?: {
-        primary: string;
-        secondary?: string;
-        intensity: number;
-    };
     delta?: {
         V: number;
         A: number;
         D: number;
     };
+    label: string;
+    secondary_label: string | null;
+    intensity: number;
 }
-export interface PersonaState {
+export interface WorldPersonaState {
     emotion: PersonaEmotion;
     mood?: {
         vad: {
@@ -43,9 +41,12 @@ export interface PersonaState {
             A: number;
             D: number;
         };
+        label: string;
     };
     somatic?: string[];
 }
+/** @deprecated Use {@link WorldPersonaState} instead. */
+export type PersonaState = WorldPersonaState;
 export interface PromptContext {
     systemPrompt: string;
     promptContext: Record<string, string>;
@@ -67,7 +68,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'). */
@@ -90,8 +91,9 @@ export interface ReactResult<T = string> {
             A: number;
             D: number;
         };
+        label: string;
     };
-    somatic?: string[];
+    somatic: string[];
     /** LLM-generated narrative — typed T if schema provided, string otherwise. */
     narrative: T;
 }
@@ -111,7 +113,7 @@ export declare class WorldPersona {
     /** 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,9 +125,11 @@ export declare class WorldPersona {
     interact(action: string, options?: {
         actor?: string;
         actorType?: 'user' | 'persona';
-        appraisal?: AppraisalVector;
+        appraisal?: Appraisal;
         stimulusDescription?: string;
     }): Promise<{
+        action: string;
+        target: string;
         emotion: PersonaEmotion;
         mood?: {
             vad: {
@@ -133,8 +137,9 @@ export declare class WorldPersona {
                 A: number;
                 D: number;
             };
+            label: string;
         };
-        somatic?: string[];
+        somatic: string[];
     }>;
     /**
      * Advance persona simulation time by the specified number of seconds.

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

@@ -1 +1 @@
-{"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,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAwBjD,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,YAAY;IAC3B,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,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,YAAY,GAAG,IAAI,CAAC;CAC5B;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,YAAY,CAAC;IAKvC,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,eAAe,CAAC;QAC5B,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"}
+{"version":3,"file":"world-persona.d.ts","sourceRoot":"","sources":["../../../src/world/world-persona.ts"],"names":[],"mappings":"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"}

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

@@ -8,22 +8,7 @@
  * 제공하되, 내부적으로 World API 엔드포인트를 사용한다.
  */
 import { unwrap } from './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,
-    };
-}
+import { toWireAppraisal } from '../shared/appraisal';
 export class WorldPersona {
     /** @internal — use World.persona() instead. */
     constructor(client, worldId, personaId, options) {
@@ -59,7 +44,10 @@ export 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() {
@@ -88,7 +76,7 @@ export 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 ? toWireAppraisal(options.appraisal) : undefined,
                 actor_id: options?.actor,
                 actor_type: options?.actorType,
             },