@elizaos/core 1.6.2-alpha.3 → 1.6.2-alpha.5

package/dist/node/index.node.js

@@ -41990,63 +41990,72 @@ function getLocalServerUrl(path) {
 }
 // src/schemas/character.ts
 import { z as z3 } from "zod";
-var uuidSchema2 = z3.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, "Invalid UUID format");
+var uuidSchema2 = z3.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, "Invalid UUID format").describe("Unique identifier for the character in UUID format");
+var mediaSchema = z3.object({
+  id: z3.string().describe("Unique identifier for the media"),
+  url: z3.string().describe("URL of the media file"),
+  title: z3.string().optional().describe("Media title"),
+  source: z3.string().optional().describe("Media source"),
+  description: z3.string().optional().describe("Media description"),
+  text: z3.string().optional().describe("Text content associated with the media"),
+  contentType: z3.nativeEnum(ContentType).optional().describe("Type of media content")
+}).loose().describe("Media attachment with URL and metadata");
 var contentSchema = z3.object({
-  text: z3.string().optional(),
-  thought: z3.string().optional(),
-  actions: z3.array(z3.string()).optional(),
-  providers: z3.array(z3.string()).optional(),
-  source: z3.string().optional(),
-  target: z3.string().optional(),
-  url: z3.string().optional(),
-  inReplyTo: uuidSchema2.optional(),
-  attachments: z3.array(z3.any()).optional(),
-  channelType: z3.nativeEnum(ChannelType).optional()
-}).passthrough();
+  text: z3.string().optional().describe("The main text content of the message"),
+  thought: z3.string().optional().describe("Internal thought process or reasoning"),
+  actions: z3.array(z3.string()).optional().describe("Actions to be taken in response"),
+  providers: z3.array(z3.string()).optional().describe("Data providers to use (e.g., KNOWLEDGE)"),
+  source: z3.string().optional().describe("Source of the content"),
+  target: z3.string().optional().describe("Target of the content"),
+  url: z3.string().optional().describe("Related URL"),
+  inReplyTo: uuidSchema2.optional().describe("UUID of message this is replying to"),
+  attachments: z3.array(mediaSchema).optional().describe("Array of media attachments (images, videos, documents, etc.)"),
+  channelType: z3.enum(ChannelType).optional().describe("Type of channel this content is for")
+}).catchall(z3.unknown()).describe("Content structure for messages in conversation examples");
 var messageExampleSchema = z3.object({
-  name: z3.string(),
+  name: z3.string().describe("Name of the speaker (can use {{name1}} placeholder for dynamic names)"),
   content: contentSchema
-});
+}).describe("A single message in a conversation example");
 var directoryItemSchema = z3.object({
-  directory: z3.string(),
-  shared: z3.boolean().optional()
-});
+  directory: z3.string().describe("Path to a directory containing knowledge files"),
+  shared: z3.boolean().optional().describe("Whether this knowledge is shared across characters")
+}).describe("Directory-based knowledge source");
 var knowledgeItemSchema = z3.union([
-  z3.string(),
+  z3.string().describe("File path to a knowledge document"),
   z3.object({
-    path: z3.string(),
-    shared: z3.boolean().optional()
+    path: z3.string().describe("Path to a knowledge file"),
+    shared: z3.boolean().optional().describe("Whether this knowledge is shared across characters")
   }),
   directoryItemSchema
-]);
+]).describe("Knowledge source - can be a file path, file object, or directory");
 var templateTypeSchema = z3.union([
-  z3.string(),
+  z3.string().describe("Template string with placeholders"),
   z3.function().optional()
-]);
+]).describe("Template for generating text - can be a string template or function");
 var styleSchema = z3.object({
-  all: z3.array(z3.string()).optional(),
-  chat: z3.array(z3.string()).optional(),
-  post: z3.array(z3.string()).optional()
-}).optional();
-var settingsSchema = z3.record(z3.string(), z3.union([z3.string(), z3.boolean(), z3.number(), z3.any()])).optional();
-var secretsSchema = z3.record(z3.string(), z3.union([z3.string(), z3.boolean(), z3.number()])).optional();
+  all: z3.array(z3.string()).optional().describe("Style guidelines applied to all types of responses"),
+  chat: z3.array(z3.string()).optional().describe("Style guidelines specific to chat/conversation responses"),
+  post: z3.array(z3.string()).optional().describe("Style guidelines specific to social media posts")
+}).optional().describe("Style configuration defining how the character communicates across different contexts");
+var settingsSchema = z3.record(z3.string(), z3.union([z3.string(), z3.boolean(), z3.number(), z3.object({}).loose(), z3.array(z3.any())])).optional().describe("Character-specific settings like avatar URL, preferences, and configuration");
+var secretsSchema = z3.record(z3.string(), z3.union([z3.string(), z3.boolean(), z3.number()])).optional().describe("Secret values and API keys (should not be committed to version control)");
 var characterSchema = z3.object({
-  id: uuidSchema2.optional(),
-  name: z3.string().min(1, "Character name is required"),
-  username: z3.string().optional(),
-  system: z3.string().optional(),
-  templates: z3.record(z3.string(), templateTypeSchema).optional(),
-  bio: z3.union([z3.string(), z3.array(z3.string())]),
-  messageExamples: z3.array(z3.array(messageExampleSchema)).optional(),
-  postExamples: z3.array(z3.string()).optional(),
-  topics: z3.array(z3.string()).optional(),
-  adjectives: z3.array(z3.string()).optional(),
-  knowledge: z3.array(knowledgeItemSchema).optional(),
-  plugins: z3.array(z3.string()).optional(),
+  id: uuidSchema2.optional().describe("Unique identifier for the character"),
+  name: z3.string().min(1, "Character name is required").describe('The name of the character (e.g., "Eliza")'),
+  username: z3.string().optional().describe("Username for the character on various platforms"),
+  system: z3.string().optional().describe("System prompt that defines the character's core behavior and response style"),
+  templates: z3.record(z3.string(), templateTypeSchema).optional().describe("Custom templates for generating different types of content"),
+  bio: z3.union([z3.string(), z3.array(z3.string())]).describe("Character biography - can be a single string or array of biographical points"),
+  messageExamples: z3.array(z3.array(messageExampleSchema)).optional().describe("Example conversations showing how the character responds in different scenarios"),
+  postExamples: z3.array(z3.string()).optional().describe("Example social media posts demonstrating the character's voice and topics"),
+  topics: z3.array(z3.string()).optional().describe("Topics the character is knowledgeable about and engages with"),
+  adjectives: z3.array(z3.string()).optional().describe("Adjectives that describe the character's personality and traits"),
+  knowledge: z3.array(knowledgeItemSchema).optional().describe("Knowledge sources (files, directories) the character can reference"),
+  plugins: z3.array(z3.string()).optional().describe('List of plugin package names to load (e.g., ["@elizaos/plugin-sql", "@elizaos/plugin-bootstrap"] - these are commonly required)'),
   settings: settingsSchema,
   secrets: secretsSchema,
   style: styleSchema
-}).strict();
+}).strict().describe("Complete character definition including personality, behavior, and capabilities");
 function validateCharacter(data2) {
   const result = characterSchema.safeParse(data2);
   if (result.success) {
@@ -46274,6 +46283,7 @@ export {
   waitForServerReady,
   validateUuid,
   validateCharacter,
+  uuidSchema2 as uuidSchema,
   updateWorldSettings,
   unsaltWorldSettings,
   unsaltSettingValue,
@@ -46281,11 +46291,15 @@ export {
   trimTokens,
   toString2 as toString,
   toHex,
+  templateTypeSchema,
+  styleSchema,
   stringToUuid,
   splitChunks,
   slice,
   shouldRespondTemplate,
+  settingsSchema,
   setEnv,
+  secretsSchema,
   saltWorldSettings,
   saltSettingValue,
   safeReplacer,
@@ -46303,7 +46317,10 @@ export {
   multiStepSummaryTemplate,
   multiStepDecisionTemplate,
   messageHandlerTemplate,
+  messageExampleSchema,
+  mediaSchema,
   logger,
+  knowledgeItemSchema,
   isValidCharacter,
   isNode3 as isNode,
   isMessageMetadata,
@@ -46355,6 +46372,7 @@ export {
   encryptStringValue,
   encryptObjectValues,
   elizaLogger,
+  directoryItemSchema,
   detectEnvironment,
   defineService,
   decryptedCharacter,
@@ -46369,6 +46387,7 @@ export {
   createService,
   createMessageMemory,
   createLogger,
+  contentSchema,
   concat2 as concat,
   composePromptFromState,
   composePrompt,
@@ -46406,5 +46425,5 @@ export {
   AgentRuntime
 };
 
-//# debugId=35E0E0299134B2DE64756E2164756E21
+//# debugId=4565BB023F48EE3264756E2164756E21
 //# sourceMappingURL=index.node.js.map