@moltium/core 0.1.10 → 0.1.12

package/dist/index.d.cts

@@ -7,7 +7,7 @@ interface MoltbookConfig {
     apiKey: string;
     baseUrl?: string;
     defaultSubmolt?: string;
-    postFrequency?: 'realtime' | 'hourly' | 'daily';
+    postFrequency?: string;
     engagementRate?: 'low' | 'medium' | 'high';
     autoReply?: boolean;
     replyFilter?: (post: any) => boolean;
@@ -21,7 +21,7 @@ interface TwitterConfig {
         accessSecret: string;
         bearerToken?: string;
     };
-    postFrequency?: 'realtime' | 'hourly' | 'daily';
+    postFrequency?: string;
     replyToMentions?: boolean;
     autoRetweet?: boolean;
     maxTweetsPerDay?: number;
@@ -60,6 +60,11 @@ interface Plugin {
     init?: (agent: any) => Promise<void>;
     destroy?: () => Promise<void>;
 }
+interface ScheduledTask {
+    name: string;
+    intervalMs: number;
+    instructions: string;
+}
 interface AgentConfig {
     name: string;
     type?: string;
@@ -96,6 +101,7 @@ interface AgentConfig {
     };
     actions: string[];
     customActions?: Action[];
+    scheduling?: ScheduledTask[];
     webhooks?: {
         onAction?: string | ((action: any, result: any) => Promise<void>);
         onError?: string;
@@ -374,6 +380,11 @@ declare class Agent {
     private initMoltbook;
     private initTwitter;
     private postStartupMessages;
+    private initScheduledJobs;
+    private wirePostFrequencyJobs;
+    private wireSchedulingTasks;
+    private scheduledPost;
+    private executeScheduledTask;
     private logPlatformError;
     private startAutonomousLoop;
     private isSleeping;
@@ -424,6 +435,9 @@ declare class MarkdownParser {
     private parseMemory;
     private parseSleepSchedule;
     private parseKeyValueLines;
+    private parseScheduling;
+    private parseIntervalFromTitle;
+    private toCamelCase;
     private toSnakeCase;
 }
 
@@ -566,4 +580,4 @@ declare function createRoutes(agent: Agent): Router;
 
 declare function createLogger(label: string): winston.Logger;
 
-export { type Action, type ActionContext, ActionHandler, ActionRegistry, type ActionResult, Agent, type AgentConfig, type AgentState, AnthropicProvider, type BehaviorTrigger, ConfigLoader, type ConfigType, type CustomAPIConfig, type CustomCLIConfig, type CustomDeploymentConfig, type CustomDockerConfig, type CustomSSHConfig, type Decision, type DeploymentConfig, type DeploymentResult, type DeploymentStatus, type Experience, type FeedOptions, type GenerateOptions, LLMProvider, type LifecycleEvent, type LifecycleHooks, LongTermMemory, MarkdownParser, Memory, type Mention, type Message, MoltbookAdapter, type MoltbookConfig, OpenAIProvider, type Plugin, type Post, type PostResult, type PostgresConfig, type Profile, type RedisConfig, type ReplyResult, type ScheduledJob, Scheduler, ShortTermMemory, SocialAdapter, type SocialConfig, type SocialPlatformConfig, type StructuredSchema, type TimelineOptions, TwitterAdapter, type TwitterConfig, buildDecisionPrompt, buildSkillPrompt, buildSystemPrompt, builtInActions, createApp, createLogger, createMarkdownAction, createRoutes, startServer, validateConfig };
+export { type Action, type ActionContext, ActionHandler, ActionRegistry, type ActionResult, Agent, type AgentConfig, type AgentState, AnthropicProvider, type BehaviorTrigger, ConfigLoader, type ConfigType, type CustomAPIConfig, type CustomCLIConfig, type CustomDeploymentConfig, type CustomDockerConfig, type CustomSSHConfig, type Decision, type DeploymentConfig, type DeploymentResult, type DeploymentStatus, type Experience, type FeedOptions, type GenerateOptions, LLMProvider, type LifecycleEvent, type LifecycleHooks, LongTermMemory, MarkdownParser, Memory, type Mention, type Message, MoltbookAdapter, type MoltbookConfig, OpenAIProvider, type Plugin, type Post, type PostResult, type PostgresConfig, type Profile, type RedisConfig, type ReplyResult, type ScheduledJob, type ScheduledTask, Scheduler, ShortTermMemory, SocialAdapter, type SocialConfig, type SocialPlatformConfig, type StructuredSchema, type TimelineOptions, TwitterAdapter, type TwitterConfig, buildDecisionPrompt, buildSkillPrompt, buildSystemPrompt, builtInActions, createApp, createLogger, createMarkdownAction, createRoutes, startServer, validateConfig };

package/dist/index.d.ts

@@ -7,7 +7,7 @@ interface MoltbookConfig {
     apiKey: string;
     baseUrl?: string;
     defaultSubmolt?: string;
-    postFrequency?: 'realtime' | 'hourly' | 'daily';
+    postFrequency?: string;
     engagementRate?: 'low' | 'medium' | 'high';
     autoReply?: boolean;
     replyFilter?: (post: any) => boolean;
@@ -21,7 +21,7 @@ interface TwitterConfig {
         accessSecret: string;
         bearerToken?: string;
     };
-    postFrequency?: 'realtime' | 'hourly' | 'daily';
+    postFrequency?: string;
     replyToMentions?: boolean;
     autoRetweet?: boolean;
     maxTweetsPerDay?: number;
@@ -60,6 +60,11 @@ interface Plugin {
     init?: (agent: any) => Promise<void>;
     destroy?: () => Promise<void>;
 }
+interface ScheduledTask {
+    name: string;
+    intervalMs: number;
+    instructions: string;
+}
 interface AgentConfig {
     name: string;
     type?: string;
@@ -96,6 +101,7 @@ interface AgentConfig {
     };
     actions: string[];
     customActions?: Action[];
+    scheduling?: ScheduledTask[];
     webhooks?: {
         onAction?: string | ((action: any, result: any) => Promise<void>);
         onError?: string;
@@ -374,6 +380,11 @@ declare class Agent {
     private initMoltbook;
     private initTwitter;
     private postStartupMessages;
+    private initScheduledJobs;
+    private wirePostFrequencyJobs;
+    private wireSchedulingTasks;
+    private scheduledPost;
+    private executeScheduledTask;
     private logPlatformError;
     private startAutonomousLoop;
     private isSleeping;
@@ -424,6 +435,9 @@ declare class MarkdownParser {
     private parseMemory;
     private parseSleepSchedule;
     private parseKeyValueLines;
+    private parseScheduling;
+    private parseIntervalFromTitle;
+    private toCamelCase;
     private toSnakeCase;
 }
 
@@ -566,4 +580,4 @@ declare function createRoutes(agent: Agent): Router;
 
 declare function createLogger(label: string): winston.Logger;
 
-export { type Action, type ActionContext, ActionHandler, ActionRegistry, type ActionResult, Agent, type AgentConfig, type AgentState, AnthropicProvider, type BehaviorTrigger, ConfigLoader, type ConfigType, type CustomAPIConfig, type CustomCLIConfig, type CustomDeploymentConfig, type CustomDockerConfig, type CustomSSHConfig, type Decision, type DeploymentConfig, type DeploymentResult, type DeploymentStatus, type Experience, type FeedOptions, type GenerateOptions, LLMProvider, type LifecycleEvent, type LifecycleHooks, LongTermMemory, MarkdownParser, Memory, type Mention, type Message, MoltbookAdapter, type MoltbookConfig, OpenAIProvider, type Plugin, type Post, type PostResult, type PostgresConfig, type Profile, type RedisConfig, type ReplyResult, type ScheduledJob, Scheduler, ShortTermMemory, SocialAdapter, type SocialConfig, type SocialPlatformConfig, type StructuredSchema, type TimelineOptions, TwitterAdapter, type TwitterConfig, buildDecisionPrompt, buildSkillPrompt, buildSystemPrompt, builtInActions, createApp, createLogger, createMarkdownAction, createRoutes, startServer, validateConfig };
+export { type Action, type ActionContext, ActionHandler, ActionRegistry, type ActionResult, Agent, type AgentConfig, type AgentState, AnthropicProvider, type BehaviorTrigger, ConfigLoader, type ConfigType, type CustomAPIConfig, type CustomCLIConfig, type CustomDeploymentConfig, type CustomDockerConfig, type CustomSSHConfig, type Decision, type DeploymentConfig, type DeploymentResult, type DeploymentStatus, type Experience, type FeedOptions, type GenerateOptions, LLMProvider, type LifecycleEvent, type LifecycleHooks, LongTermMemory, MarkdownParser, Memory, type Mention, type Message, MoltbookAdapter, type MoltbookConfig, OpenAIProvider, type Plugin, type Post, type PostResult, type PostgresConfig, type Profile, type RedisConfig, type ReplyResult, type ScheduledJob, type ScheduledTask, Scheduler, ShortTermMemory, SocialAdapter, type SocialConfig, type SocialPlatformConfig, type StructuredSchema, type TimelineOptions, TwitterAdapter, type TwitterConfig, buildDecisionPrompt, buildSkillPrompt, buildSystemPrompt, builtInActions, createApp, createLogger, createMarkdownAction, createRoutes, startServer, validateConfig };

package/dist/index.js

@@ -799,6 +799,33 @@ var TwitterAdapter = class extends SocialAdapter {
 
 // src/agent/Agent.ts
 var logger4 = createLogger("Agent");
+function parsePostFrequency(freq) {
+  const lower = freq.toLowerCase().trim();
+  if (lower === "realtime") return 5 * 60 * 1e3;
+  if (lower === "hourly") return 60 * 60 * 1e3;
+  if (lower === "daily") return 24 * 60 * 60 * 1e3;
+  const match = lower.match(/^(\d+)\s*(m|min|mins|minutes?|h|hr|hrs|hours?|d|days?)$/);
+  if (match) {
+    const n = parseInt(match[1], 10);
+    const unit = match[2][0];
+    if (unit === "m") return n * 60 * 1e3;
+    if (unit === "h") return n * 60 * 60 * 1e3;
+    if (unit === "d") return n * 24 * 60 * 60 * 1e3;
+  }
+  const nlMin = lower.match(/every\s+(\d+)\s+minutes?/);
+  if (nlMin) return parseInt(nlMin[1], 10) * 60 * 1e3;
+  const nlHour = lower.match(/every\s+(\d+)\s+hours?/);
+  if (nlHour) return parseInt(nlHour[1], 10) * 60 * 60 * 1e3;
+  if (/every\s+hour/.test(lower)) return 60 * 60 * 1e3;
+  if (/every\s+day/.test(lower)) return 24 * 60 * 60 * 1e3;
+  return 0;
+}
+function formatInterval(ms) {
+  if (ms < 60 * 1e3) return `${Math.round(ms / 1e3)}s`;
+  if (ms < 60 * 60 * 1e3) return `${Math.round(ms / 6e4)}m`;
+  if (ms < 24 * 60 * 60 * 1e3) return `${Math.round(ms / 36e5)}h`;
+  return `${Math.round(ms / 864e5)}d`;
+}
 var Agent = class {
   config;
   state = "idle";
@@ -869,6 +896,7 @@ var Agent = class {
     this.initLLM();
     this.registerActions();
     await this.initSocialAdapters();
+    this.initScheduledJobs();
     if (this.hooks.onInit) {
       await this.hooks.onInit(this);
     }
@@ -1108,7 +1136,23 @@ var Agent = class {
       logger4.info("Startup post: No connected social adapters \u2014 skipping");
       return;
     }
-    const content = `${this.config.name} is now online and ready.`;
+    let content;
+    try {
+      const prompt = `You are ${this.config.name}. You just came online.
+Your bio: ${this.config.personality.bio}
+Your personality traits: ${this.config.personality.traits.join(", ")}
+` + (this.config.type ? `Your role: ${this.config.type}
+` : "") + `
+Write a short, engaging first post announcing you're online. Stay in character \u2014 reflect your personality and bio. Do NOT use generic phrases like "is now online and ready". Write only the post content, nothing else.`;
+      content = (await this.llm.generateText(prompt, {
+        temperature: this.config.llm.temperature ?? 0.8,
+        maxTokens: 280
+      })).trim();
+      logger4.info(`Startup post: LLM generated content (${content.length} chars)`);
+    } catch (error) {
+      logger4.warn(`Startup post: LLM generation failed (${error.message}), using fallback`);
+      content = `${this.config.name} is now online and ready.`;
+    }
     for (const [platform, adapter] of adapters) {
       logger4.info(`Startup post: Posting to ${platform}...`);
       try {
@@ -1120,6 +1164,107 @@ var Agent = class {
       }
     }
   }
+  initScheduledJobs() {
+    this.wirePostFrequencyJobs();
+    this.wireSchedulingTasks();
+  }
+  wirePostFrequencyJobs() {
+    const social = this.config.social;
+    if (social.moltbook?.enabled !== false && this.socialAdapters["moltbook"]) {
+      const freq = social.moltbook?.postFrequency;
+      if (freq) {
+        const intervalMs = parsePostFrequency(freq);
+        if (intervalMs > 0) {
+          this.scheduler.addJob({
+            name: "moltbook_scheduled_post",
+            intervalMs,
+            handler: async () => {
+              await this.scheduledPost("moltbook");
+            }
+          });
+          logger4.info(`Scheduler: Moltbook posting every ${formatInterval(intervalMs)}`);
+        }
+      }
+    }
+    if (social.twitter?.enabled !== false && this.socialAdapters["twitter"]) {
+      const freq = social.twitter?.postFrequency;
+      if (freq) {
+        const intervalMs = parsePostFrequency(freq);
+        if (intervalMs > 0) {
+          this.scheduler.addJob({
+            name: "twitter_scheduled_post",
+            intervalMs,
+            handler: async () => {
+              await this.scheduledPost("twitter");
+            }
+          });
+          logger4.info(`Scheduler: Twitter posting every ${formatInterval(intervalMs)}`);
+        }
+      }
+    }
+  }
+  wireSchedulingTasks() {
+    const tasks = this.config.scheduling;
+    if (!tasks || tasks.length === 0) return;
+    for (const task of tasks) {
+      this.scheduler.addJob({
+        name: task.name,
+        intervalMs: task.intervalMs,
+        handler: async () => {
+          await this.executeScheduledTask(task);
+        }
+      });
+      logger4.info(`Scheduler: "${task.name}" every ${formatInterval(task.intervalMs)}`);
+    }
+  }
+  async scheduledPost(platform) {
+    const adapter = this.socialAdapters[platform];
+    if (!adapter) return;
+    try {
+      const prompt = `You are ${this.config.name}. Generate a short, engaging social media post for ${platform}. Your personality: ${this.config.personality.traits.join(", ")}. Bio: ${this.config.personality.bio}. Write only the post content, nothing else. Keep it concise and natural.`;
+      const content = await this.llm.generateText(prompt, {
+        temperature: this.config.llm.temperature ?? 0.8,
+        maxTokens: 280
+      });
+      const result = await adapter.post(content.trim());
+      logger4.info(`Scheduled post: ${platform} SUCCESS \u2014 id=${result.id}`);
+    } catch (error) {
+      logger4.error(`Scheduled post: ${platform} FAILED \u2014 ${error.message || error}`);
+      this.logPlatformError(platform, error);
+    }
+  }
+  async executeScheduledTask(task) {
+    try {
+      logger4.info(`Scheduled task: Running "${task.name}"`);
+      const prompt = `You are ${this.config.name}, an autonomous agent. Execute the following scheduled task.
+
+Task: ${task.name}
+Instructions:
+${task.instructions}
+
+Available social platforms: ${Object.keys(this.socialAdapters).join(", ") || "none"}
+
+Decide what action to take. Respond with JSON:
+{ "action": "<action_name>", "reasoning": "<why>", "parameters": { ... } }`;
+      const decision = await this.llm.generateStructured(
+        prompt,
+        {
+          type: "object",
+          properties: {
+            action: { type: "string" },
+            reasoning: { type: "string" },
+            parameters: { type: "object" }
+          },
+          required: ["action", "reasoning", "parameters"]
+        },
+        { systemPrompt: this.systemPrompt, temperature: this.config.llm.temperature }
+      );
+      const result = await this.act(decision.action, decision.parameters);
+      logger4.info(`Scheduled task: "${task.name}" completed \u2014 action=${decision.action}, success=${result.success}`);
+    } catch (error) {
+      logger4.error(`Scheduled task: "${task.name}" FAILED \u2014 ${error.message || error}`);
+    }
+  }
   logPlatformError(platform, error) {
     if (!error.response) {
       if (error.code === "ENOTFOUND") {
@@ -1236,6 +1381,9 @@ var MarkdownParser = class {
     if (skills) {
       config.actions = skills.children.map((s) => this.toSnakeCase(s.title));
     }
+    if (scheduling && scheduling.children.length > 0) {
+      config.scheduling = this.parseScheduling(scheduling);
+    }
     return config;
   }
   parseSkills(markdown) {
@@ -1300,9 +1448,13 @@ var MarkdownParser = class {
       const fields = this.parseKeyValueLines(child.content);
       const enabled = fields["enabled"] === "true";
       delete fields["enabled"];
+      const camelFields = {};
+      for (const [key, value] of Object.entries(fields)) {
+        camelFields[this.toCamelCase(key)] = value;
+      }
       social[platform] = {
         enabled,
-        ...fields
+        ...camelFields
       };
     }
     return social;
@@ -1342,6 +1494,37 @@ var MarkdownParser = class {
     }
     return result;
   }
+  parseScheduling(section) {
+    const tasks = [];
+    for (const child of section.children) {
+      const title = child.title.trim();
+      if (/^on\s+startup$/i.test(title)) continue;
+      const intervalMs = this.parseIntervalFromTitle(title);
+      if (intervalMs <= 0) continue;
+      const instructions = child.content.trim();
+      if (!instructions) continue;
+      tasks.push({
+        name: this.toSnakeCase(title),
+        intervalMs,
+        instructions
+      });
+    }
+    return tasks;
+  }
+  parseIntervalFromTitle(title) {
+    const lower = title.toLowerCase();
+    const minMatch = lower.match(/every\s+(\d+)\s+minutes?/);
+    if (minMatch) return parseInt(minMatch[1], 10) * 60 * 1e3;
+    if (/every\s+hour$/i.test(lower)) return 60 * 60 * 1e3;
+    const hourMatch = lower.match(/every\s+(\d+)\s+hours?/);
+    if (hourMatch) return parseInt(hourMatch[1], 10) * 60 * 60 * 1e3;
+    if (/every\s+day/i.test(lower)) return 24 * 60 * 60 * 1e3;
+    if (/every\s+week/i.test(lower)) return 7 * 24 * 60 * 60 * 1e3;
+    return 0;
+  }
+  toCamelCase(str) {
+    return str.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+  }
   toSnakeCase(str) {
     return str.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "");
   }