@moltium/core 0.1.9 → 0.1.11

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);
     }
@@ -1014,10 +1042,10 @@ var Agent = class {
     const configMoltbook = social.moltbook;
     const apiKey = configMoltbook?.apiKey || envKey || "";
     const isPlaceholder = !apiKey || apiKey === "your-moltbook-key-here";
-    const explicitlyDisabled = configMoltbook && configMoltbook.enabled === false;
+    const explicitlyDisabled = configMoltbook && configMoltbook.enabled === false && !envKey;
     const shouldConnect = !isPlaceholder && !explicitlyDisabled;
     if (explicitlyDisabled) {
-      logger4.info("Moltbook: Disabled in config (enabled: false) \u2014 skipping");
+      logger4.info("Moltbook: Disabled in config and no MOLTBOOK_API_KEY in env \u2014 skipping");
       return;
     }
     if (isPlaceholder) {
@@ -1067,9 +1095,9 @@ var Agent = class {
     const accessSecret = creds?.accessSecret || envAccessSecret || "";
     const hasKey = apiKey && apiKey !== "your-twitter-api-key";
     const hasAllCreds = hasKey && apiSecret && accessToken && accessSecret;
-    const explicitlyDisabled = configTwitter && configTwitter.enabled === false;
+    const explicitlyDisabled = configTwitter && configTwitter.enabled === false && !envApiKey;
     if (explicitlyDisabled) {
-      logger4.info("Twitter: Disabled in config (enabled: false) \u2014 skipping");
+      logger4.info("Twitter: Disabled in config and no TWITTER_API_KEY in env \u2014 skipping");
       return;
     }
     if (!hasKey) {
@@ -1120,6 +1148,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 +1365,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 +1432,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 +1478,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, "");
   }