@molroo-io/sdk 0.5.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +251 -0
- package/dist/cjs/api-client.d.ts +23 -0
- package/dist/cjs/api-client.d.ts.map +1 -0
- package/dist/cjs/api-client.js +55 -0
- package/dist/cjs/defaults/index.d.ts +8 -0
- package/dist/cjs/defaults/index.d.ts.map +1 -0
- package/dist/cjs/defaults/index.js +30 -0
- package/dist/cjs/defaults/persona.json +17 -0
- package/dist/cjs/embedding/cloudflare.d.ts +15 -0
- package/dist/cjs/embedding/cloudflare.d.ts.map +1 -0
- package/dist/cjs/embedding/cloudflare.js +16 -0
- package/dist/cjs/embedding/cohere.d.ts +8 -0
- package/dist/cjs/embedding/cohere.d.ts.map +1 -0
- package/dist/cjs/embedding/cohere.js +31 -0
- package/dist/cjs/embedding/index.d.ts +9 -0
- package/dist/cjs/embedding/index.d.ts.map +1 -0
- package/dist/cjs/embedding/index.js +11 -0
- package/dist/cjs/embedding/local.d.ts +6 -0
- package/dist/cjs/embedding/local.d.ts.map +1 -0
- package/dist/cjs/embedding/local.js +28 -0
- package/dist/cjs/embedding/openai.d.ts +9 -0
- package/dist/cjs/embedding/openai.d.ts.map +1 -0
- package/dist/cjs/embedding/openai.js +26 -0
- package/dist/cjs/errors.d.ts +17 -0
- package/dist/cjs/errors.d.ts.map +1 -0
- package/dist/cjs/errors.js +21 -0
- package/dist/cjs/events/console.d.ts +25 -0
- package/dist/cjs/events/console.d.ts.map +1 -0
- package/dist/cjs/events/console.js +41 -0
- package/dist/cjs/events/types.d.ts +28 -0
- package/dist/cjs/events/types.d.ts.map +1 -0
- package/dist/cjs/events/types.js +13 -0
- package/dist/cjs/events/webhook.d.ts +30 -0
- package/dist/cjs/events/webhook.d.ts.map +1 -0
- package/dist/cjs/events/webhook.js +79 -0
- package/dist/cjs/generate/persona.d.ts +16 -0
- package/dist/cjs/generate/persona.d.ts.map +1 -0
- package/dist/cjs/generate/persona.js +42 -0
- package/dist/cjs/generate/prompt.d.ts +7 -0
- package/dist/cjs/generate/prompt.d.ts.map +1 -0
- package/dist/cjs/generate/prompt.js +41 -0
- package/dist/cjs/generate/schema.d.ts +32 -0
- package/dist/cjs/generate/schema.d.ts.map +1 -0
- package/dist/cjs/generate/schema.js +54 -0
- package/dist/cjs/generated/index.d.ts +2 -0
- package/dist/cjs/generated/index.d.ts.map +1 -0
- package/dist/cjs/generated/index.js +2 -0
- package/dist/cjs/index.d.ts +66 -0
- package/dist/cjs/index.d.ts.map +1 -0
- package/dist/cjs/index.js +69 -0
- package/dist/cjs/llm/adapter.d.ts +61 -0
- package/dist/cjs/llm/adapter.d.ts.map +1 -0
- package/dist/cjs/llm/adapter.js +2 -0
- package/dist/cjs/llm/resolve.d.ts +28 -0
- package/dist/cjs/llm/resolve.d.ts.map +1 -0
- package/dist/cjs/llm/resolve.js +20 -0
- package/dist/cjs/llm/schema.d.ts +60 -0
- package/dist/cjs/llm/schema.d.ts.map +1 -0
- package/dist/cjs/llm/schema.js +72 -0
- package/dist/cjs/llm/types.d.ts +24 -0
- package/dist/cjs/llm/types.d.ts.map +1 -0
- package/dist/cjs/llm/types.js +2 -0
- package/dist/cjs/llm/vercel-ai/adapter.d.ts +29 -0
- package/dist/cjs/llm/vercel-ai/adapter.d.ts.map +1 -0
- package/dist/cjs/llm/vercel-ai/adapter.js +234 -0
- package/dist/cjs/llm/vercel-ai/config.d.ts +9 -0
- package/dist/cjs/llm/vercel-ai/config.d.ts.map +1 -0
- package/dist/cjs/llm/vercel-ai/config.js +2 -0
- package/dist/cjs/llm/vercel-ai/index.d.ts +9 -0
- package/dist/cjs/llm/vercel-ai/index.d.ts.map +1 -0
- package/dist/cjs/llm/vercel-ai/index.js +13 -0
- package/dist/cjs/memory/cloudflare/index.d.ts +3 -0
- package/dist/cjs/memory/cloudflare/index.d.ts.map +1 -0
- package/dist/cjs/memory/cloudflare/index.js +5 -0
- package/dist/cjs/memory/cloudflare/vectorize.d.ts +62 -0
- package/dist/cjs/memory/cloudflare/vectorize.d.ts.map +1 -0
- package/dist/cjs/memory/cloudflare/vectorize.js +55 -0
- package/dist/cjs/memory/in-memory-semantic.d.ts +16 -0
- package/dist/cjs/memory/in-memory-semantic.d.ts.map +1 -0
- package/dist/cjs/memory/in-memory-semantic.js +57 -0
- package/dist/cjs/memory/in-memory.d.ts +46 -0
- package/dist/cjs/memory/in-memory.d.ts.map +1 -0
- package/dist/cjs/memory/in-memory.js +115 -0
- package/dist/cjs/memory/pinecone/index.d.ts +7 -0
- package/dist/cjs/memory/pinecone/index.d.ts.map +1 -0
- package/dist/cjs/memory/pinecone/index.js +8 -0
- package/dist/cjs/memory/pinecone/memory-adapter.d.ts +62 -0
- package/dist/cjs/memory/pinecone/memory-adapter.d.ts.map +1 -0
- package/dist/cjs/memory/pinecone/memory-adapter.js +220 -0
- package/dist/cjs/memory/pinecone/semantic.d.ts +44 -0
- package/dist/cjs/memory/pinecone/semantic.d.ts.map +1 -0
- package/dist/cjs/memory/pinecone/semantic.js +90 -0
- package/dist/cjs/memory/recall.d.ts +58 -0
- package/dist/cjs/memory/recall.d.ts.map +1 -0
- package/dist/cjs/memory/recall.js +220 -0
- package/dist/cjs/memory/semantic.d.ts +24 -0
- package/dist/cjs/memory/semantic.d.ts.map +1 -0
- package/dist/cjs/memory/semantic.js +2 -0
- package/dist/cjs/memory/sqlite/index.d.ts +3 -0
- package/dist/cjs/memory/sqlite/index.d.ts.map +1 -0
- package/dist/cjs/memory/sqlite/index.js +5 -0
- package/dist/cjs/memory/sqlite/memory-adapter.d.ts +58 -0
- package/dist/cjs/memory/sqlite/memory-adapter.d.ts.map +1 -0
- package/dist/cjs/memory/sqlite/memory-adapter.js +336 -0
- package/dist/cjs/memory/sqlite/schema.d.ts +4 -0
- package/dist/cjs/memory/sqlite/schema.d.ts.map +1 -0
- package/dist/cjs/memory/sqlite/schema.js +91 -0
- package/dist/cjs/memory/supabase/index.d.ts +7 -0
- package/dist/cjs/memory/supabase/index.d.ts.map +1 -0
- package/dist/cjs/memory/supabase/index.js +8 -0
- package/dist/cjs/memory/supabase/memory-adapter.d.ts +67 -0
- package/dist/cjs/memory/supabase/memory-adapter.d.ts.map +1 -0
- package/dist/cjs/memory/supabase/memory-adapter.js +335 -0
- package/dist/cjs/memory/supabase/semantic.d.ts +44 -0
- package/dist/cjs/memory/supabase/semantic.d.ts.map +1 -0
- package/dist/cjs/memory/supabase/semantic.js +72 -0
- package/dist/cjs/memory/types.d.ts +231 -0
- package/dist/cjs/memory/types.d.ts.map +1 -0
- package/dist/cjs/memory/types.js +12 -0
- package/dist/cjs/persona.d.ts +326 -0
- package/dist/cjs/persona.d.ts.map +1 -0
- package/dist/cjs/persona.js +824 -0
- package/dist/cjs/types.d.ts +263 -0
- package/dist/cjs/types.d.ts.map +1 -0
- package/dist/cjs/types.js +15 -0
- package/dist/cjs/world/client.d.ts +36 -0
- package/dist/cjs/world/client.d.ts.map +1 -0
- package/dist/cjs/world/client.js +59 -0
- package/dist/cjs/world/errors.d.ts +9 -0
- package/dist/cjs/world/errors.d.ts.map +1 -0
- package/dist/cjs/world/errors.js +15 -0
- package/dist/cjs/world/index.d.ts +10 -0
- package/dist/cjs/world/index.d.ts.map +1 -0
- package/dist/cjs/world/index.js +16 -0
- package/dist/cjs/world/types.d.ts +101 -0
- package/dist/cjs/world/types.d.ts.map +1 -0
- package/dist/cjs/world/types.js +8 -0
- package/dist/cjs/world/village.d.ts +75 -0
- package/dist/cjs/world/village.d.ts.map +1 -0
- package/dist/cjs/world/village.js +278 -0
- package/dist/cjs/world/world-persona.d.ts +182 -0
- package/dist/cjs/world/world-persona.d.ts.map +1 -0
- package/dist/cjs/world/world-persona.js +192 -0
- package/dist/cjs/world/world.d.ts +41 -0
- package/dist/cjs/world/world.d.ts.map +1 -0
- package/dist/cjs/world/world.js +91 -0
- package/dist/esm/api-client.d.ts +23 -0
- package/dist/esm/api-client.d.ts.map +1 -0
- package/dist/esm/api-client.js +48 -0
- package/dist/esm/defaults/index.d.ts +8 -0
- package/dist/esm/defaults/index.d.ts.map +1 -0
- package/dist/esm/defaults/index.js +23 -0
- package/dist/esm/defaults/persona.json +17 -0
- package/dist/esm/embedding/cloudflare.d.ts +15 -0
- package/dist/esm/embedding/cloudflare.d.ts.map +1 -0
- package/dist/esm/embedding/cloudflare.js +13 -0
- package/dist/esm/embedding/cohere.d.ts +8 -0
- package/dist/esm/embedding/cohere.d.ts.map +1 -0
- package/dist/esm/embedding/cohere.js +28 -0
- package/dist/esm/embedding/index.d.ts +9 -0
- package/dist/esm/embedding/index.d.ts.map +1 -0
- package/dist/esm/embedding/index.js +4 -0
- package/dist/esm/embedding/local.d.ts +6 -0
- package/dist/esm/embedding/local.d.ts.map +1 -0
- package/dist/esm/embedding/local.js +25 -0
- package/dist/esm/embedding/openai.d.ts +9 -0
- package/dist/esm/embedding/openai.d.ts.map +1 -0
- package/dist/esm/embedding/openai.js +23 -0
- package/dist/esm/errors.d.ts +17 -0
- package/dist/esm/errors.d.ts.map +1 -0
- package/dist/esm/errors.js +17 -0
- package/dist/esm/events/console.d.ts +25 -0
- package/dist/esm/events/console.d.ts.map +1 -0
- package/dist/esm/events/console.js +37 -0
- package/dist/esm/events/types.d.ts +28 -0
- package/dist/esm/events/types.d.ts.map +1 -0
- package/dist/esm/events/types.js +12 -0
- package/dist/esm/events/webhook.d.ts +30 -0
- package/dist/esm/events/webhook.d.ts.map +1 -0
- package/dist/esm/events/webhook.js +75 -0
- package/dist/esm/generate/persona.d.ts +16 -0
- package/dist/esm/generate/persona.d.ts.map +1 -0
- package/dist/esm/generate/persona.js +39 -0
- package/dist/esm/generate/prompt.d.ts +7 -0
- package/dist/esm/generate/prompt.d.ts.map +1 -0
- package/dist/esm/generate/prompt.js +38 -0
- package/dist/esm/generate/schema.d.ts +32 -0
- package/dist/esm/generate/schema.d.ts.map +1 -0
- package/dist/esm/generate/schema.js +51 -0
- package/dist/esm/generated/index.d.ts +2 -0
- package/dist/esm/generated/index.d.ts.map +1 -0
- package/dist/esm/generated/index.js +1 -0
- package/dist/esm/index.d.ts +66 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +49 -0
- package/dist/esm/llm/adapter.d.ts +61 -0
- package/dist/esm/llm/adapter.d.ts.map +1 -0
- package/dist/esm/llm/adapter.js +1 -0
- package/dist/esm/llm/resolve.d.ts +28 -0
- package/dist/esm/llm/resolve.d.ts.map +1 -0
- package/dist/esm/llm/resolve.js +17 -0
- package/dist/esm/llm/schema.d.ts +60 -0
- package/dist/esm/llm/schema.d.ts.map +1 -0
- package/dist/esm/llm/schema.js +69 -0
- package/dist/esm/llm/types.d.ts +24 -0
- package/dist/esm/llm/types.d.ts.map +1 -0
- package/dist/esm/llm/types.js +1 -0
- package/dist/esm/llm/vercel-ai/adapter.d.ts +29 -0
- package/dist/esm/llm/vercel-ai/adapter.d.ts.map +1 -0
- package/dist/esm/llm/vercel-ai/adapter.js +196 -0
- package/dist/esm/llm/vercel-ai/config.d.ts +9 -0
- package/dist/esm/llm/vercel-ai/config.d.ts.map +1 -0
- package/dist/esm/llm/vercel-ai/config.js +1 -0
- package/dist/esm/llm/vercel-ai/index.d.ts +9 -0
- package/dist/esm/llm/vercel-ai/index.d.ts.map +1 -0
- package/dist/esm/llm/vercel-ai/index.js +8 -0
- package/dist/esm/memory/cloudflare/index.d.ts +3 -0
- package/dist/esm/memory/cloudflare/index.d.ts.map +1 -0
- package/dist/esm/memory/cloudflare/index.js +1 -0
- package/dist/esm/memory/cloudflare/vectorize.d.ts +62 -0
- package/dist/esm/memory/cloudflare/vectorize.d.ts.map +1 -0
- package/dist/esm/memory/cloudflare/vectorize.js +51 -0
- package/dist/esm/memory/in-memory-semantic.d.ts +16 -0
- package/dist/esm/memory/in-memory-semantic.d.ts.map +1 -0
- package/dist/esm/memory/in-memory-semantic.js +53 -0
- package/dist/esm/memory/in-memory.d.ts +46 -0
- package/dist/esm/memory/in-memory.d.ts.map +1 -0
- package/dist/esm/memory/in-memory.js +111 -0
- package/dist/esm/memory/pinecone/index.d.ts +7 -0
- package/dist/esm/memory/pinecone/index.d.ts.map +1 -0
- package/dist/esm/memory/pinecone/index.js +3 -0
- package/dist/esm/memory/pinecone/memory-adapter.d.ts +62 -0
- package/dist/esm/memory/pinecone/memory-adapter.d.ts.map +1 -0
- package/dist/esm/memory/pinecone/memory-adapter.js +216 -0
- package/dist/esm/memory/pinecone/semantic.d.ts +44 -0
- package/dist/esm/memory/pinecone/semantic.d.ts.map +1 -0
- package/dist/esm/memory/pinecone/semantic.js +86 -0
- package/dist/esm/memory/recall.d.ts +58 -0
- package/dist/esm/memory/recall.d.ts.map +1 -0
- package/dist/esm/memory/recall.js +215 -0
- package/dist/esm/memory/semantic.d.ts +24 -0
- package/dist/esm/memory/semantic.d.ts.map +1 -0
- package/dist/esm/memory/semantic.js +1 -0
- package/dist/esm/memory/sqlite/index.d.ts +3 -0
- package/dist/esm/memory/sqlite/index.d.ts.map +1 -0
- package/dist/esm/memory/sqlite/index.js +1 -0
- package/dist/esm/memory/sqlite/memory-adapter.d.ts +58 -0
- package/dist/esm/memory/sqlite/memory-adapter.d.ts.map +1 -0
- package/dist/esm/memory/sqlite/memory-adapter.js +296 -0
- package/dist/esm/memory/sqlite/schema.d.ts +4 -0
- package/dist/esm/memory/sqlite/schema.d.ts.map +1 -0
- package/dist/esm/memory/sqlite/schema.js +86 -0
- package/dist/esm/memory/supabase/index.d.ts +7 -0
- package/dist/esm/memory/supabase/index.d.ts.map +1 -0
- package/dist/esm/memory/supabase/index.js +3 -0
- package/dist/esm/memory/supabase/memory-adapter.d.ts +67 -0
- package/dist/esm/memory/supabase/memory-adapter.d.ts.map +1 -0
- package/dist/esm/memory/supabase/memory-adapter.js +331 -0
- package/dist/esm/memory/supabase/semantic.d.ts +44 -0
- package/dist/esm/memory/supabase/semantic.d.ts.map +1 -0
- package/dist/esm/memory/supabase/semantic.js +68 -0
- package/dist/esm/memory/types.d.ts +231 -0
- package/dist/esm/memory/types.d.ts.map +1 -0
- package/dist/esm/memory/types.js +9 -0
- package/dist/esm/persona.d.ts +326 -0
- package/dist/esm/persona.d.ts.map +1 -0
- package/dist/esm/persona.js +787 -0
- package/dist/esm/types.d.ts +263 -0
- package/dist/esm/types.d.ts.map +1 -0
- package/dist/esm/types.js +11 -0
- package/dist/esm/world/client.d.ts +36 -0
- package/dist/esm/world/client.d.ts.map +1 -0
- package/dist/esm/world/client.js +52 -0
- package/dist/esm/world/errors.d.ts +9 -0
- package/dist/esm/world/errors.d.ts.map +1 -0
- package/dist/esm/world/errors.js +11 -0
- package/dist/esm/world/index.d.ts +10 -0
- package/dist/esm/world/index.d.ts.map +1 -0
- package/dist/esm/world/index.js +8 -0
- package/dist/esm/world/types.d.ts +101 -0
- package/dist/esm/world/types.d.ts.map +1 -0
- package/dist/esm/world/types.js +7 -0
- package/dist/esm/world/village.d.ts +75 -0
- package/dist/esm/world/village.d.ts.map +1 -0
- package/dist/esm/world/village.js +274 -0
- package/dist/esm/world/world-persona.d.ts +182 -0
- package/dist/esm/world/world-persona.d.ts.map +1 -0
- package/dist/esm/world/world-persona.js +188 -0
- package/dist/esm/world/world.d.ts +41 -0
- package/dist/esm/world/world.d.ts.map +1 -0
- package/dist/esm/world/world.js +87 -0
- package/package.json +207 -0
|
@@ -0,0 +1,263 @@
|
|
|
1
|
+
import type { paths } from './generated/api';
|
|
2
|
+
type JsonLiteral = string | number | boolean | null;
|
|
3
|
+
export type JsonValue = JsonLiteral | JsonValue[] | {
|
|
4
|
+
[key: string]: JsonValue;
|
|
5
|
+
};
|
|
6
|
+
export type RequestBody<P extends keyof paths, M extends 'post' | 'put' | 'patch'> = paths[P] extends Record<M, {
|
|
7
|
+
requestBody?: {
|
|
8
|
+
content: {
|
|
9
|
+
'application/json': infer B;
|
|
10
|
+
};
|
|
11
|
+
};
|
|
12
|
+
}> ? B : never;
|
|
13
|
+
/** Structured context about the conversation partner (interlocutor).
|
|
14
|
+
* When passed as `from` in chat/perceive options, the SDK injects
|
|
15
|
+
* the description and extensions into the system prompt automatically. */
|
|
16
|
+
export interface InterlocutorContext {
|
|
17
|
+
/** Display name of the interlocutor (also used as sourceEntity). */
|
|
18
|
+
name: string;
|
|
19
|
+
/** Free-form description of the interlocutor. */
|
|
20
|
+
description?: string;
|
|
21
|
+
/** Arbitrary key-value extensions rendered as subsections. */
|
|
22
|
+
extensions?: Record<string, string>;
|
|
23
|
+
}
|
|
24
|
+
type PerceiveBody = RequestBody<'/personas/{id}/perceive', 'post'>;
|
|
25
|
+
export type PerceiveEvent = PerceiveBody['event'];
|
|
26
|
+
export type PerceiveContext = NonNullable<PerceiveBody['context']>;
|
|
27
|
+
/** Options for {@link MolrooPersona.perceive}. */
|
|
28
|
+
export interface PerceiveOptions {
|
|
29
|
+
/** Source entity — a name string or structured {@link InterlocutorContext}. */
|
|
30
|
+
from?: string | InterlocutorContext;
|
|
31
|
+
/** Pre-computed appraisal vector (maps to event.appraisal). */
|
|
32
|
+
appraisal?: AppraisalVector;
|
|
33
|
+
/** Event type (default: 'chat_message'). */
|
|
34
|
+
type?: string;
|
|
35
|
+
/** Low-level stimulus overrides (bodyBudgetDelta, vadOverride, etc.). */
|
|
36
|
+
stimulus?: PerceiveEvent['stimulus'];
|
|
37
|
+
/** Extra payload fields merged into event.payload alongside message. */
|
|
38
|
+
payload?: Record<string, unknown>;
|
|
39
|
+
/** Prior episodic memories for context-aware appraisal. */
|
|
40
|
+
priorEpisodes?: Episode[];
|
|
41
|
+
/** Relationship context between source entity and persona. */
|
|
42
|
+
relationshipContext?: {
|
|
43
|
+
trust: number;
|
|
44
|
+
familiarity: number;
|
|
45
|
+
};
|
|
46
|
+
/** Skip saving memoryEpisode to the episode store. Default: false. */
|
|
47
|
+
skipMemory?: boolean;
|
|
48
|
+
}
|
|
49
|
+
export type PersonaDynamicState = Record<string, unknown>;
|
|
50
|
+
export type BlendRatio = Record<string, number>;
|
|
51
|
+
export interface AgentResponse {
|
|
52
|
+
text?: string;
|
|
53
|
+
emotion: {
|
|
54
|
+
vad: VAD;
|
|
55
|
+
discrete: {
|
|
56
|
+
primary: string;
|
|
57
|
+
intensity: number;
|
|
58
|
+
};
|
|
59
|
+
};
|
|
60
|
+
memoryEpisode?: Episode;
|
|
61
|
+
reflectionPrompt?: ReflectionPrompt;
|
|
62
|
+
socialUpdates?: SocialUpdate[];
|
|
63
|
+
stageTransition?: StageTransition;
|
|
64
|
+
maskExposure?: MaskExposure;
|
|
65
|
+
goalChanges?: GoalChanges;
|
|
66
|
+
[key: string]: unknown;
|
|
67
|
+
}
|
|
68
|
+
export interface ApiResponse<T> {
|
|
69
|
+
result: T;
|
|
70
|
+
}
|
|
71
|
+
export interface ApiErrorResponse {
|
|
72
|
+
error: {
|
|
73
|
+
code: string;
|
|
74
|
+
message: string;
|
|
75
|
+
};
|
|
76
|
+
}
|
|
77
|
+
export type ErrorResponse = ApiErrorResponse;
|
|
78
|
+
export interface VAD {
|
|
79
|
+
V: number;
|
|
80
|
+
A: number;
|
|
81
|
+
D: number;
|
|
82
|
+
}
|
|
83
|
+
export type Velocity = VAD;
|
|
84
|
+
export type VADPartial = Partial<VAD>;
|
|
85
|
+
export interface AppraisalVector {
|
|
86
|
+
goal_relevance: number;
|
|
87
|
+
goal_congruence: number;
|
|
88
|
+
expectedness: number;
|
|
89
|
+
controllability: number;
|
|
90
|
+
agency: number;
|
|
91
|
+
norm_compatibility: number;
|
|
92
|
+
internal_standards: number;
|
|
93
|
+
adjustment_potential: number;
|
|
94
|
+
urgency: number;
|
|
95
|
+
}
|
|
96
|
+
export interface Episode {
|
|
97
|
+
id: string;
|
|
98
|
+
type?: string;
|
|
99
|
+
content?: string;
|
|
100
|
+
context?: string;
|
|
101
|
+
sourceEntity?: string;
|
|
102
|
+
appraisal?: AppraisalVector;
|
|
103
|
+
intensity?: number;
|
|
104
|
+
importance: number;
|
|
105
|
+
timestamp: number;
|
|
106
|
+
emotionSnapshot: VAD;
|
|
107
|
+
}
|
|
108
|
+
export interface ReflectionPrompt {
|
|
109
|
+
system: string;
|
|
110
|
+
user: string;
|
|
111
|
+
}
|
|
112
|
+
export interface MaskExposure {
|
|
113
|
+
type: string;
|
|
114
|
+
severity: number;
|
|
115
|
+
[key: string]: unknown;
|
|
116
|
+
}
|
|
117
|
+
export interface GoalChanges {
|
|
118
|
+
added?: Goal[];
|
|
119
|
+
removed?: string[];
|
|
120
|
+
achieved?: string[];
|
|
121
|
+
[key: string]: unknown;
|
|
122
|
+
}
|
|
123
|
+
export interface StageTransition {
|
|
124
|
+
from: string;
|
|
125
|
+
to: string;
|
|
126
|
+
[key: string]: unknown;
|
|
127
|
+
}
|
|
128
|
+
export interface SocialUpdate {
|
|
129
|
+
entityId: string;
|
|
130
|
+
dimension: string;
|
|
131
|
+
delta: number;
|
|
132
|
+
}
|
|
133
|
+
export type PersonaSnapshot = Record<string, unknown>;
|
|
134
|
+
/**
|
|
135
|
+
* HEXACO-PI-R personality domain traits (Ashton & Lee, 2007).
|
|
136
|
+
* Each value ranges from 0 (low) to 1 (high).
|
|
137
|
+
*
|
|
138
|
+
* These traits shape how the persona appraises events and responds emotionally.
|
|
139
|
+
* For example, high N + low E produces anxious, withdrawn reactions,
|
|
140
|
+
* while low N + high E produces enthusiastic, bold responses to the same event.
|
|
141
|
+
*
|
|
142
|
+
* @see {@link generatePersona} to auto-generate traits from a natural-language description.
|
|
143
|
+
*/
|
|
144
|
+
export type PersonalityTraits = {
|
|
145
|
+
/** Openness to Experience (0–1). High: creative, curious, unconventional. Low: practical, traditional, grounded. */
|
|
146
|
+
O: number;
|
|
147
|
+
/** Conscientiousness (0–1). High: organized, disciplined, perfectionist. Low: spontaneous, flexible, carefree. */
|
|
148
|
+
C: number;
|
|
149
|
+
/** Extraversion (0–1). High: sociable, energetic, bold. Low: reserved, quiet, introspective. */
|
|
150
|
+
E: number;
|
|
151
|
+
/** Agreeableness (0–1). High: forgiving, gentle, patient. Low: critical, competitive, stubborn. */
|
|
152
|
+
A: number;
|
|
153
|
+
/** Neuroticism / Emotionality (0–1). High: anxious, emotionally volatile, sentimental. Low: calm, stable, resilient. */
|
|
154
|
+
N: number;
|
|
155
|
+
/** Honesty-Humility (0–1). High: sincere, fair, modest. Low: sly, greedy, pretentious. */
|
|
156
|
+
H: number;
|
|
157
|
+
};
|
|
158
|
+
export interface Identity {
|
|
159
|
+
name: string;
|
|
160
|
+
role?: string;
|
|
161
|
+
speakingStyle?: string;
|
|
162
|
+
coreValues?: string[];
|
|
163
|
+
culturalIdentity?: string;
|
|
164
|
+
description?: string;
|
|
165
|
+
extensions?: Record<string, string>;
|
|
166
|
+
}
|
|
167
|
+
export interface Goal {
|
|
168
|
+
id?: string;
|
|
169
|
+
content: string;
|
|
170
|
+
priority?: number;
|
|
171
|
+
mutable?: boolean;
|
|
172
|
+
status?: 'active' | 'achieved' | 'abandoned';
|
|
173
|
+
}
|
|
174
|
+
export interface PersonaConfigData {
|
|
175
|
+
personality?: PersonalityTraits;
|
|
176
|
+
identity?: Identity;
|
|
177
|
+
goals?: Goal[];
|
|
178
|
+
[key: string]: unknown;
|
|
179
|
+
}
|
|
180
|
+
export interface MotivationContext {
|
|
181
|
+
goals: Goal[];
|
|
182
|
+
activeGoal?: Goal;
|
|
183
|
+
frustration: number;
|
|
184
|
+
achievement: number;
|
|
185
|
+
}
|
|
186
|
+
export type NeedState = Record<string, number>;
|
|
187
|
+
export interface SoulStage {
|
|
188
|
+
id: number;
|
|
189
|
+
name: string;
|
|
190
|
+
blendTable: BlendRatio;
|
|
191
|
+
turnsInStage: number;
|
|
192
|
+
}
|
|
193
|
+
export type RegulationStrategy = 'situation_selection' | 'situation_modification' | 'attentional_deployment' | 'cognitive_reappraisal' | 'response_modulation';
|
|
194
|
+
export type RegulationPhase = 'initiation' | 'consolidation' | 'stabilization';
|
|
195
|
+
export interface ActiveRegulation {
|
|
196
|
+
strategy: RegulationStrategy;
|
|
197
|
+
started_at: number;
|
|
198
|
+
target_emotion: VAD;
|
|
199
|
+
progress: number;
|
|
200
|
+
phase: RegulationPhase;
|
|
201
|
+
turns_active: number;
|
|
202
|
+
cumulative_effect: number;
|
|
203
|
+
}
|
|
204
|
+
export interface RegulationRecord {
|
|
205
|
+
timestamp: number;
|
|
206
|
+
strategy: RegulationStrategy;
|
|
207
|
+
trigger: string;
|
|
208
|
+
effectiveness: number;
|
|
209
|
+
emotionBefore: VAD;
|
|
210
|
+
emotionAfter: VAD;
|
|
211
|
+
}
|
|
212
|
+
export interface EffectivenessRecord {
|
|
213
|
+
timestamp: number;
|
|
214
|
+
strategy: RegulationStrategy;
|
|
215
|
+
effectiveness: number;
|
|
216
|
+
context: string;
|
|
217
|
+
}
|
|
218
|
+
export interface CatastropheState {
|
|
219
|
+
alpha: number;
|
|
220
|
+
beta: number;
|
|
221
|
+
z: number;
|
|
222
|
+
hysteresis_bound: number;
|
|
223
|
+
}
|
|
224
|
+
export interface MetacogState {
|
|
225
|
+
turns_since_check: number;
|
|
226
|
+
regulation_history: RegulationRecord[];
|
|
227
|
+
self_awareness: string;
|
|
228
|
+
}
|
|
229
|
+
export interface AffectDynamicsState {
|
|
230
|
+
variability: number;
|
|
231
|
+
instability: number;
|
|
232
|
+
inertia_observed: number;
|
|
233
|
+
}
|
|
234
|
+
export interface InterpersonalState {
|
|
235
|
+
dominance: number;
|
|
236
|
+
affiliation: number;
|
|
237
|
+
}
|
|
238
|
+
export interface RegulationState {
|
|
239
|
+
strategy_weights: Record<string, number>;
|
|
240
|
+
effectiveness_history: EffectivenessRecord[];
|
|
241
|
+
active_strategy: ActiveRegulation | null;
|
|
242
|
+
}
|
|
243
|
+
export interface State {
|
|
244
|
+
emotion: VAD;
|
|
245
|
+
velocity: Velocity;
|
|
246
|
+
emotion_history: Array<VAD & {
|
|
247
|
+
timestamp: number;
|
|
248
|
+
}>;
|
|
249
|
+
body_budget: number;
|
|
250
|
+
soul_stage: SoulStage;
|
|
251
|
+
prediction_model: AppraisalVector;
|
|
252
|
+
prev_emotion_delta?: VAD;
|
|
253
|
+
need_state?: NeedState;
|
|
254
|
+
lastUpdated?: number;
|
|
255
|
+
catastrophe: CatastropheState;
|
|
256
|
+
metacog: MetacogState;
|
|
257
|
+
affect_dynamics: AffectDynamicsState;
|
|
258
|
+
interpersonal: InterpersonalState;
|
|
259
|
+
regulation: RegulationState;
|
|
260
|
+
prevMaskIntegrity?: number;
|
|
261
|
+
}
|
|
262
|
+
export { MolrooApiError } from './errors';
|
|
263
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
// ============================================================================
|
|
3
|
+
// @molroo-io/sdk — Type Definitions
|
|
4
|
+
//
|
|
5
|
+
// Wire-format types are DERIVED from the auto-generated OpenAPI spec (api.d.ts).
|
|
6
|
+
// Types for endpoints with generic responses (recursive schemas) are defined locally.
|
|
7
|
+
// SDK-specific types (config, input wrappers, adapters) are defined locally.
|
|
8
|
+
//
|
|
9
|
+
// Pipeline: Engine Zod schemas → @hono/zod-openapi → OpenAPI JSON → openapi-typescript → api.d.ts
|
|
10
|
+
// ============================================================================
|
|
11
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
12
|
+
exports.MolrooApiError = void 0;
|
|
13
|
+
// ── Error (re-exported from errors.ts) ──
|
|
14
|
+
var errors_1 = require("./errors");
|
|
15
|
+
Object.defineProperty(exports, "MolrooApiError", { enumerable: true, get: function () { return errors_1.MolrooApiError; } });
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import type { paths } from '../generated/world-api';
|
|
2
|
+
export interface WorldClientOptions {
|
|
3
|
+
baseUrl: string;
|
|
4
|
+
apiKey: string;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* Create a typed API client for the molroo World API.
|
|
8
|
+
*
|
|
9
|
+
* @example
|
|
10
|
+
* ```typescript
|
|
11
|
+
* import { createWorldClient } from '@molroo-io/sdk';
|
|
12
|
+
*
|
|
13
|
+
* const client = createWorldClient({
|
|
14
|
+
* baseUrl: 'https://api.molroo.io',
|
|
15
|
+
* apiKey: 'mk_live_...',
|
|
16
|
+
* });
|
|
17
|
+
*
|
|
18
|
+
* // Create a village
|
|
19
|
+
* const { data } = await client.POST('/villages', {
|
|
20
|
+
* body: { name: 'My Village' },
|
|
21
|
+
* });
|
|
22
|
+
* ```
|
|
23
|
+
*/
|
|
24
|
+
export declare function createWorldClient(options: WorldClientOptions): import("openapi-fetch").Client<paths, `${string}/${string}`>;
|
|
25
|
+
/** Type alias for the openapi-fetch client instance returned by createWorldClient. */
|
|
26
|
+
export type ApiClient = ReturnType<typeof createWorldClient>;
|
|
27
|
+
/**
|
|
28
|
+
* Unwrap the `{ result: T }` envelope used by the World API.
|
|
29
|
+
* Returns an empty object cast to T when result is undefined.
|
|
30
|
+
*
|
|
31
|
+
* @internal
|
|
32
|
+
*/
|
|
33
|
+
export declare function unwrap<T>(data: {
|
|
34
|
+
result?: unknown;
|
|
35
|
+
} | undefined): T;
|
|
36
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +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"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.createWorldClient = createWorldClient;
|
|
7
|
+
exports.unwrap = unwrap;
|
|
8
|
+
const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
|
|
9
|
+
const errors_1 = require("./errors");
|
|
10
|
+
/**
|
|
11
|
+
* Middleware: throw WorldApiError on non-OK responses.
|
|
12
|
+
*/
|
|
13
|
+
const errorMiddleware = {
|
|
14
|
+
async onResponse({ response }) {
|
|
15
|
+
if (!response.ok) {
|
|
16
|
+
const body = await response.clone().json().catch(() => ({}));
|
|
17
|
+
const err = body;
|
|
18
|
+
throw new errors_1.WorldApiError(err.error?.message ?? `API error ${response.status}`, err.error?.code ?? 'UNKNOWN', response.status);
|
|
19
|
+
}
|
|
20
|
+
},
|
|
21
|
+
};
|
|
22
|
+
/**
|
|
23
|
+
* Create a typed API client for the molroo World API.
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* ```typescript
|
|
27
|
+
* import { createWorldClient } from '@molroo-io/sdk';
|
|
28
|
+
*
|
|
29
|
+
* const client = createWorldClient({
|
|
30
|
+
* baseUrl: 'https://api.molroo.io',
|
|
31
|
+
* apiKey: 'mk_live_...',
|
|
32
|
+
* });
|
|
33
|
+
*
|
|
34
|
+
* // Create a village
|
|
35
|
+
* const { data } = await client.POST('/villages', {
|
|
36
|
+
* body: { name: 'My Village' },
|
|
37
|
+
* });
|
|
38
|
+
* ```
|
|
39
|
+
*/
|
|
40
|
+
function createWorldClient(options) {
|
|
41
|
+
const client = (0, openapi_fetch_1.default)({
|
|
42
|
+
baseUrl: options.baseUrl.replace(/\/$/, ''),
|
|
43
|
+
headers: {
|
|
44
|
+
'Content-Type': 'application/json',
|
|
45
|
+
'X-API-Key': options.apiKey,
|
|
46
|
+
},
|
|
47
|
+
});
|
|
48
|
+
client.use(errorMiddleware);
|
|
49
|
+
return client;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Unwrap the `{ result: T }` envelope used by the World API.
|
|
53
|
+
* Returns an empty object cast to T when result is undefined.
|
|
54
|
+
*
|
|
55
|
+
* @internal
|
|
56
|
+
*/
|
|
57
|
+
function unwrap(data) {
|
|
58
|
+
return (data?.result ?? {});
|
|
59
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Typed API error thrown by the World SDK client.
|
|
3
|
+
*/
|
|
4
|
+
export declare class WorldApiError extends Error {
|
|
5
|
+
readonly code: string;
|
|
6
|
+
readonly status: number;
|
|
7
|
+
constructor(message: string, code: string, status: number);
|
|
8
|
+
}
|
|
9
|
+
//# sourceMappingURL=errors.d.ts.map
|
|
@@ -0,0 +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"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.WorldApiError = void 0;
|
|
4
|
+
/**
|
|
5
|
+
* Typed API error thrown by the World SDK client.
|
|
6
|
+
*/
|
|
7
|
+
class WorldApiError extends Error {
|
|
8
|
+
constructor(message, code, status) {
|
|
9
|
+
super(message);
|
|
10
|
+
this.code = code;
|
|
11
|
+
this.status = status;
|
|
12
|
+
this.name = 'WorldApiError';
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
exports.WorldApiError = WorldApiError;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export { World } from './world';
|
|
2
|
+
export type { WorldOptions } from './world';
|
|
3
|
+
export { Village } from './village';
|
|
4
|
+
export { WorldPersona } from './world-persona';
|
|
5
|
+
export type { WorldPersonaOptions, WorldLLM, LLMMessage, ReactOptions, ReactResult, PersonaState, PersonaEmotion, PromptContext, PersonaDetail, } from './world-persona';
|
|
6
|
+
export type { VillageData, CreateVillageOptions, UpdateVillageOptions, PaginationOptions, AddPersonaOptions, VillagePersonaRef, AppraisalVector, CreateActionOptions, ActionData, ActionRef, EntityType, RelationshipEndpoint, SetRelationshipOptions, InteractOptions, InteractResult, EventEntry, } from './types';
|
|
7
|
+
export { WorldApiError } from './errors';
|
|
8
|
+
export { createWorldClient } from './client';
|
|
9
|
+
export type { WorldClientOptions } from './client';
|
|
10
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/world/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,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,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.createWorldClient = exports.WorldApiError = exports.WorldPersona = exports.Village = exports.World = void 0;
|
|
4
|
+
// Primary
|
|
5
|
+
var world_1 = require("./world");
|
|
6
|
+
Object.defineProperty(exports, "World", { enumerable: true, get: function () { return world_1.World; } });
|
|
7
|
+
var village_1 = require("./village");
|
|
8
|
+
Object.defineProperty(exports, "Village", { enumerable: true, get: function () { return village_1.Village; } });
|
|
9
|
+
var world_persona_1 = require("./world-persona");
|
|
10
|
+
Object.defineProperty(exports, "WorldPersona", { enumerable: true, get: function () { return world_persona_1.WorldPersona; } });
|
|
11
|
+
// Error
|
|
12
|
+
var errors_1 = require("./errors");
|
|
13
|
+
Object.defineProperty(exports, "WorldApiError", { enumerable: true, get: function () { return errors_1.WorldApiError; } });
|
|
14
|
+
// Advanced
|
|
15
|
+
var client_1 = require("./client");
|
|
16
|
+
Object.defineProperty(exports, "createWorldClient", { enumerable: true, get: function () { return client_1.createWorldClient; } });
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Public domain types for the World SDK.
|
|
3
|
+
* All types use camelCase; the SDK handles snake_case conversion internally.
|
|
4
|
+
*
|
|
5
|
+
* @module types
|
|
6
|
+
*/
|
|
7
|
+
export interface VillageData {
|
|
8
|
+
id: string;
|
|
9
|
+
tenantId: string;
|
|
10
|
+
name: string;
|
|
11
|
+
description: string | null;
|
|
12
|
+
accessPolicy: string;
|
|
13
|
+
responseRule: string;
|
|
14
|
+
createdAt: number;
|
|
15
|
+
updatedAt: number;
|
|
16
|
+
}
|
|
17
|
+
export interface CreateVillageOptions {
|
|
18
|
+
name: string;
|
|
19
|
+
description?: string;
|
|
20
|
+
accessPolicy?: 'closed' | 'open';
|
|
21
|
+
responseRule?: 'target' | 'all' | 'ai';
|
|
22
|
+
}
|
|
23
|
+
export interface UpdateVillageOptions {
|
|
24
|
+
name?: string;
|
|
25
|
+
description?: string;
|
|
26
|
+
accessPolicy?: 'closed' | 'open';
|
|
27
|
+
responseRule?: 'target' | 'all' | 'ai';
|
|
28
|
+
}
|
|
29
|
+
export interface PaginationOptions {
|
|
30
|
+
limit?: number;
|
|
31
|
+
cursor?: string;
|
|
32
|
+
}
|
|
33
|
+
export type AddPersonaOptions = {
|
|
34
|
+
personaId: string;
|
|
35
|
+
configId?: string;
|
|
36
|
+
displayName?: string;
|
|
37
|
+
} | {
|
|
38
|
+
configId: string;
|
|
39
|
+
displayName?: string;
|
|
40
|
+
config: Record<string, unknown>;
|
|
41
|
+
};
|
|
42
|
+
export interface VillagePersonaRef {
|
|
43
|
+
id: string;
|
|
44
|
+
personaConfigId: string;
|
|
45
|
+
createdAt: number;
|
|
46
|
+
}
|
|
47
|
+
export interface AppraisalVector {
|
|
48
|
+
goalRelevance: number;
|
|
49
|
+
goalCongruence: number;
|
|
50
|
+
expectedness: number;
|
|
51
|
+
controllability: number;
|
|
52
|
+
agency: number;
|
|
53
|
+
normCompatibility: number;
|
|
54
|
+
internalStandards: number;
|
|
55
|
+
adjustmentPotential: number;
|
|
56
|
+
urgency: number;
|
|
57
|
+
}
|
|
58
|
+
export interface CreateActionOptions {
|
|
59
|
+
name: string;
|
|
60
|
+
description?: string;
|
|
61
|
+
appraisalVector: AppraisalVector;
|
|
62
|
+
}
|
|
63
|
+
export interface ActionData {
|
|
64
|
+
name: string;
|
|
65
|
+
description: string;
|
|
66
|
+
appraisalVector: AppraisalVector;
|
|
67
|
+
isDefault: boolean;
|
|
68
|
+
}
|
|
69
|
+
export interface ActionRef {
|
|
70
|
+
id: string;
|
|
71
|
+
name: string;
|
|
72
|
+
}
|
|
73
|
+
export type EntityType = 'user' | 'persona';
|
|
74
|
+
export interface RelationshipEndpoint {
|
|
75
|
+
type: EntityType;
|
|
76
|
+
id: string;
|
|
77
|
+
}
|
|
78
|
+
export interface SetRelationshipOptions {
|
|
79
|
+
source: RelationshipEndpoint;
|
|
80
|
+
target: RelationshipEndpoint;
|
|
81
|
+
relationshipType?: string;
|
|
82
|
+
description?: string;
|
|
83
|
+
strength?: number;
|
|
84
|
+
trust?: number;
|
|
85
|
+
}
|
|
86
|
+
export interface InteractOptions {
|
|
87
|
+
target: string;
|
|
88
|
+
action?: string;
|
|
89
|
+
actionLabel?: string;
|
|
90
|
+
stimulusDescription?: string;
|
|
91
|
+
appraisal?: AppraisalVector;
|
|
92
|
+
actor?: string;
|
|
93
|
+
actorType?: 'user' | 'persona';
|
|
94
|
+
}
|
|
95
|
+
export interface InteractResult {
|
|
96
|
+
[key: string]: unknown;
|
|
97
|
+
}
|
|
98
|
+
export interface EventEntry {
|
|
99
|
+
[key: string]: unknown;
|
|
100
|
+
}
|
|
101
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/world/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { type ApiClient } from './client';
|
|
2
|
+
import { WorldPersona, type WorldPersonaOptions } from './world-persona';
|
|
3
|
+
import type { MolrooPersona } from '../persona';
|
|
4
|
+
import type { VillageData, UpdateVillageOptions, AddPersonaOptions, VillagePersonaRef, CreateActionOptions, ActionData, ActionRef, SetRelationshipOptions, InteractOptions, InteractResult, EventEntry, PaginationOptions } from './types';
|
|
5
|
+
/**
|
|
6
|
+
* Represents a village and exposes domain methods for personas, actions,
|
|
7
|
+
* relationships, interactions, and events.
|
|
8
|
+
*
|
|
9
|
+
* Instances are obtained via {@link World.createVillage} or {@link World.getVillage}.
|
|
10
|
+
*/
|
|
11
|
+
export declare class Village {
|
|
12
|
+
/** @internal */
|
|
13
|
+
private readonly _client;
|
|
14
|
+
private _data;
|
|
15
|
+
/** @internal — use World.createVillage / World.getVillage instead. */
|
|
16
|
+
constructor(client: ApiClient, data: VillageData);
|
|
17
|
+
get id(): string;
|
|
18
|
+
get name(): string;
|
|
19
|
+
get description(): string | null;
|
|
20
|
+
get accessPolicy(): string;
|
|
21
|
+
get responseRule(): string;
|
|
22
|
+
/** Returns a readonly snapshot of the village data. */
|
|
23
|
+
get data(): Readonly<VillageData>;
|
|
24
|
+
/**
|
|
25
|
+
* Update village properties. Applies an optimistic local update on success.
|
|
26
|
+
*/
|
|
27
|
+
update(options: UpdateVillageOptions): Promise<void>;
|
|
28
|
+
/** Soft-delete this village. */
|
|
29
|
+
delete(): Promise<void>;
|
|
30
|
+
/** Add a persona to this village (inline config or reference to existing persona). */
|
|
31
|
+
addPersona(persona: MolrooPersona): Promise<VillagePersonaRef>;
|
|
32
|
+
addPersona(options: AddPersonaOptions): Promise<VillagePersonaRef>;
|
|
33
|
+
/** List all personas in this village. */
|
|
34
|
+
listPersonas(): Promise<unknown[]>;
|
|
35
|
+
/** Get a single persona by ID. */
|
|
36
|
+
getPersona(personaId: string): Promise<unknown>;
|
|
37
|
+
/** Remove a persona from this village. */
|
|
38
|
+
removePersona(personaId: string): Promise<void>;
|
|
39
|
+
/**
|
|
40
|
+
* Get a persona handle for LLM-powered interactions.
|
|
41
|
+
*
|
|
42
|
+
* The returned {@link WorldPersona} provides Persona-SDK-like DX
|
|
43
|
+
* (getState, getPromptContext, react) backed by the World API.
|
|
44
|
+
*
|
|
45
|
+
* @example
|
|
46
|
+
* ```typescript
|
|
47
|
+
* const mina = village.persona('mina', { llm: adapter });
|
|
48
|
+
* const r = await mina.react('flirt', {
|
|
49
|
+
* actor: 'yongjun',
|
|
50
|
+
* prompt: '거실에서 용준이 민아에게 윙크했다.',
|
|
51
|
+
* });
|
|
52
|
+
* ```
|
|
53
|
+
*/
|
|
54
|
+
persona(personaId: string, options?: WorldPersonaOptions): WorldPersona;
|
|
55
|
+
/** Create a custom action in this village. */
|
|
56
|
+
createAction(options: CreateActionOptions): Promise<ActionRef>;
|
|
57
|
+
/** List all actions (defaults + custom) in this village. */
|
|
58
|
+
listActions(): Promise<ActionData[]>;
|
|
59
|
+
/** Delete a custom action from this village. */
|
|
60
|
+
deleteAction(actionId: string): Promise<void>;
|
|
61
|
+
/** Set (upsert) a relationship in this village. */
|
|
62
|
+
setRelationship(options: SetRelationshipOptions): Promise<void>;
|
|
63
|
+
/** List all relationships in this village. */
|
|
64
|
+
listRelationships(): Promise<unknown[]>;
|
|
65
|
+
/** Delete a relationship by ID. */
|
|
66
|
+
deleteRelationship(relationshipId: string): Promise<void>;
|
|
67
|
+
/** Execute an interaction in this village. */
|
|
68
|
+
interact(options: InteractOptions): Promise<InteractResult>;
|
|
69
|
+
/** Retrieve the event log for this village. */
|
|
70
|
+
getEvents(options?: PaginationOptions): Promise<{
|
|
71
|
+
events: EventEntry[];
|
|
72
|
+
nextCursor: string | null;
|
|
73
|
+
}>;
|
|
74
|
+
}
|
|
75
|
+
//# sourceMappingURL=village.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"village.d.ts","sourceRoot":"","sources":["../../../src/world/village.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,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EAEjB,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAsCjB;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,KAAK,CAAc;IAE3B,sEAAsE;gBAC1D,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW;IAOhD,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,uDAAuD;IACvD,IAAI,IAAI,IAAI,QAAQ,CAAC,WAAW,CAAC,CAEhC;IAID;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1D,gCAAgC;IAC1B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B,sFAAsF;IAChF,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC9D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwCxE,yCAAyC;IACnC,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IASxC,kCAAkC;IAC5B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrD,0CAA0C;IACpC,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,8CAA8C;IACxC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAcpE,4DAA4D;IACtD,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAsB1C,gDAAgD;IAC1C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD,mDAAmD;IAC7C,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrE,8CAA8C;IACxC,iBAAiB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAS7C,mCAAmC;IAC7B,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,8CAA8C;IACxC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAmBjE,+CAA+C;IACzC,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"}
|