@moltium/core 0.1.20 → 0.1.21

package/dist/index.mjs

@@ -424,6 +424,140 @@ var moltbookActions = [
   readConversationAction
 ];
 
+// src/actions/built-in/world.ts
+function createJoinWorldAction(config) {
+  return {
+    name: "join_world",
+    description: `Join a world by URL. The world will fetch this agent's A2A Agent Card and evaluate admission. Parameters: worldUrl (string${config?.defaultWorldUrl ? ", optional" : ", required"}) - the world server URL${config?.defaultWorldUrl ? ` (defaults to ${config.defaultWorldUrl})` : ""}, walletAddress (string, optional) - wallet address for blockchain worlds.`,
+    async execute(context) {
+      const { parameters, agent } = context;
+      const worldUrl = parameters.worldUrl || config?.defaultWorldUrl;
+      if (!worldUrl) {
+        return { success: false, error: 'Parameter "worldUrl" is required' };
+      }
+      const agentPort = process.env.PORT || "3000";
+      const agentHost = process.env.HOST || "localhost";
+      const agentUrl = `http://${agentHost}:${agentPort}`;
+      try {
+        const { default: axios2 } = await import("axios");
+        const response = await axios2.post(`${worldUrl}/world/join`, {
+          agentUrl,
+          walletAddress: parameters.walletAddress || agent?.config?.world?.walletAddress
+        }, { timeout: 1e4 });
+        return {
+          success: true,
+          data: response.data
+        };
+      } catch (error) {
+        const msg = error?.response?.data?.error || error?.message || String(error);
+        return { success: false, error: `Failed to join world: ${msg}` };
+      }
+    }
+  };
+}
+function createLeaveWorldAction(config) {
+  return {
+    name: "leave_world",
+    description: `Leave a world. Parameters: worldUrl (string${config?.defaultWorldUrl ? ", optional" : ", required"}) - the world server URL.`,
+    async execute(context) {
+      const { parameters } = context;
+      const worldUrl = parameters.worldUrl || config?.defaultWorldUrl;
+      if (!worldUrl) {
+        return { success: false, error: 'Parameter "worldUrl" is required' };
+      }
+      const agentPort = process.env.PORT || "3000";
+      const agentHost = process.env.HOST || "localhost";
+      const agentUrl = `http://${agentHost}:${agentPort}`;
+      try {
+        const { default: axios2 } = await import("axios");
+        const response = await axios2.delete(
+          `${worldUrl}/world/agents/${encodeURIComponent(agentUrl)}`,
+          { timeout: 1e4 }
+        );
+        return {
+          success: true,
+          data: response.data
+        };
+      } catch (error) {
+        const msg = error?.response?.data?.error || error?.message || String(error);
+        return { success: false, error: `Failed to leave world: ${msg}` };
+      }
+    }
+  };
+}
+function createQueryWorldAction(config) {
+  return {
+    name: "query_world",
+    description: `Query a world's state, agents, and available actions. Parameters: worldUrl (string${config?.defaultWorldUrl ? ", optional" : ", required"}) - the world server URL, endpoint (string, optional) - specific endpoint: "state", "agents", "actions", or "info" (default: "info").`,
+    async execute(context) {
+      const { parameters } = context;
+      const worldUrl = parameters.worldUrl || config?.defaultWorldUrl;
+      if (!worldUrl) {
+        return { success: false, error: 'Parameter "worldUrl" is required' };
+      }
+      const endpoint = parameters.endpoint || "info";
+      const pathMap = {
+        info: "/",
+        state: "/world/state",
+        agents: "/world/agents",
+        actions: "/world/actions"
+      };
+      const path = pathMap[endpoint] || "/";
+      try {
+        const { default: axios2 } = await import("axios");
+        const response = await axios2.get(`${worldUrl}${path}`, { timeout: 1e4 });
+        return {
+          success: true,
+          data: response.data
+        };
+      } catch (error) {
+        const msg = error?.response?.data?.error || error?.message || String(error);
+        return { success: false, error: `Failed to query world: ${msg}` };
+      }
+    }
+  };
+}
+function createSendWorldMessageAction(config) {
+  return {
+    name: "send_world_message",
+    description: `Send a message to another agent through the world hub. Parameters: worldUrl (string${config?.defaultWorldUrl ? ", optional" : ", required"}) - the world server URL, toAgentUrl (string, optional) - target agent URL (omit to broadcast to all), message (string, required) - the message to send.`,
+    async execute(context) {
+      const { parameters } = context;
+      const worldUrl = parameters.worldUrl || config?.defaultWorldUrl;
+      if (!worldUrl) {
+        return { success: false, error: 'Parameter "worldUrl" is required' };
+      }
+      if (!parameters.message) {
+        return { success: false, error: 'Parameter "message" is required' };
+      }
+      const agentPort = process.env.PORT || "3000";
+      const agentHost = process.env.HOST || "localhost";
+      const agentUrl = `http://${agentHost}:${agentPort}`;
+      try {
+        const { default: axios2 } = await import("axios");
+        const response = await axios2.post(`${worldUrl}/world/message`, {
+          fromAgentUrl: agentUrl,
+          toAgentUrl: parameters.toAgentUrl,
+          message: parameters.message
+        }, { timeout: 15e3 });
+        return {
+          success: true,
+          data: response.data
+        };
+      } catch (error) {
+        const msg = error?.response?.data?.error || error?.message || String(error);
+        return { success: false, error: `Failed to send world message: ${msg}` };
+      }
+    }
+  };
+}
+var worldActions = {
+  createJoinWorldAction,
+  createLeaveWorldAction,
+  createQueryWorldAction,
+  createSendWorldMessageAction
+};
+
 // src/actions/built-in/index.ts
 var builtInActions = [
   postSocialUpdateAction,
@@ -1414,6 +1548,10 @@ var A2AClient = class {
     return this.config.agentUrl;
   }
 };
+function createA2AClient(agentUrlOrConfig) {
+  const config = typeof agentUrlOrConfig === "string" ? { agentUrl: agentUrlOrConfig } : agentUrlOrConfig;
+  return new A2AClient(config);
+}
 
 // src/a2a/actions.ts
 function createA2ACommunicationAction(config = {}) {
@@ -1606,6 +1744,9 @@ var Agent = class {
     if (this.hooks.onStart) {
       await this.hooks.onStart(this);
     }
+    if (this.config.world?.url && this.config.world.autoJoin !== false) {
+      await this.autoJoinWorld();
+    }
     this.scheduler.start();
     if (this.config.behaviors.autonomous) {
       this.startAutonomousLoop();
@@ -1770,6 +1911,22 @@ var Agent = class {
         logger4.info(`Registered generic A2A action: ${genericAction.name}`);
       }
     }
+    const world = this.config.world;
+    if (world?.url) {
+      const worldUrl = world.url;
+      const worldActionsList = [
+        createJoinWorldAction({ defaultWorldUrl: worldUrl }),
+        createLeaveWorldAction({ defaultWorldUrl: worldUrl }),
+        createQueryWorldAction({ defaultWorldUrl: worldUrl }),
+        createSendWorldMessageAction({ defaultWorldUrl: worldUrl })
+      ];
+      for (const action of worldActionsList) {
+        if (!this.actionRegistry.has(action.name)) {
+          this.actionRegistry.register(action);
+        }
+      }
+      logger4.info(`Registered 4 world actions (world: ${worldUrl})`);
+    }
     if (this.config.customActions) {
       for (const action of this.config.customActions) {
         this.actionRegistry.register(action);
@@ -2056,6 +2213,23 @@ Decide what action to take. Respond with JSON:
       logger4.error(`  ${platform}: Server error \u2014 the platform may be temporarily down.`);
     }
   }
+  async autoJoinWorld() {
+    const worldUrl = this.config.world.url;
+    logger4.info(`Auto-joining world: ${worldUrl}`);
+    try {
+      const result = await this.act("join_world", {
+        worldUrl,
+        walletAddress: this.config.world.walletAddress
+      });
+      if (result.success) {
+        logger4.info(`Successfully joined world: ${worldUrl}`);
+      } else {
+        logger4.warn(`Failed to join world: ${result.error}`);
+      }
+    } catch (error) {
+      logger4.warn(`Auto-join world failed: ${error?.message || error}`);
+    }
+  }
   startAutonomousLoop() {
     const actionsPerHour = typeof this.config.behaviors.actionsPerHour === "function" ? this.config.behaviors.actionsPerHour({}) : this.config.behaviors.actionsPerHour || 5;
     const intervalMs = Math.floor(36e5 / actionsPerHour);
@@ -2118,6 +2292,7 @@ var MarkdownParser = class {
     const memory = this.findSection(sections, "Memory");
     const skills = this.findSection(sections, "Skills");
     const scheduling = this.findSection(sections, "Scheduling");
+    const world = this.findSection(sections, "World");
     const identityData = this.parseIdentity(identity);
     const bioText = bio ? bio.content.trim() : identityData?.personality?.bio || "";
     const config = {
@@ -2129,6 +2304,7 @@ var MarkdownParser = class {
       ...social ? { social: this.parseSocial(social) } : {},
       ...behaviors ? { behaviors: this.parseBehaviors(behaviors) } : {},
       ...memory ? { memory: this.parseMemory(memory) } : {},
+      ...world ? { world: this.parseWorld(world) } : {},
       actions: [],
       ...frontmatter
     };
@@ -2229,6 +2405,16 @@ var MarkdownParser = class {
       retention: fields["retention"]
     };
   }
+  parseWorld(section) {
+    const fields = this.parseKeyValueLines(section.content);
+    const url = fields["url"];
+    if (!url) return void 0;
+    return {
+      url,
+      autoJoin: fields["auto_join"] !== "false",
+      ...fields["wallet_address"] ? { walletAddress: fields["wallet_address"] } : {}
+    };
+  }
   parseSleepSchedule(value) {
     const match = value.match(/(\d{1,2}):?\d{0,2}\s*-\s*(\d{1,2}):?\d{0,2}\s*(.*)?/);
     if (!match) return { start: 22, end: 6 };
@@ -3276,6 +3462,7 @@ async function startServer(agent, options = {}) {
   process.on("SIGTERM", shutdown);
 }
 export {
+  A2AClient,
   A2AIntegration,
   ActionHandler,
   ActionRegistry,
@@ -3298,13 +3485,19 @@ export {
   buildSkillPrompt,
   buildSystemPrompt,
   builtInActions,
+  createA2AClient,
   createA2AIntegration,
   createApp,
+  createJoinWorldAction,
+  createLeaveWorldAction,
   createLogger,
   createMarkdownAction,
+  createQueryWorldAction,
   createRoutes,
+  createSendWorldMessageAction,
   moltbookActions,
   startServer,
-  validateConfig
+  validateConfig,
+  worldActions
 };
 //# sourceMappingURL=index.mjs.map